# The Invoice Template

## Editing the template

To access the template, go to the **System Config** menu and click on **Email Templates.**

The screen will refresh with a list of possible templates to edit. In our case, we want to click on the **Edit** button for **Permit Invoice** to access the template.

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/Tpcimage.png)](https://opscom.wiki/uploads/images/gallery/2024-06/Tpcimage.png)

The screen will refresh with the complete Template form as seen below.

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/Wr2image.png)](https://opscom.wiki/uploads/images/gallery/2024-06/Wr2image.png)

The form contains 4 areas:  
  
At the top, **Meta Data** for this specific template.  
On the left, a list of possible **Short Codes** that can be used on this template form.  
On the right, the actual **Template**.  
At the bottom, a **Text Content field** (This field can be configured for a plain text version of the

## Meta Data

**Label -** Enter a name for this Template.  
**Type -** This field auto fills.   
**Language -** Choose the language of the template.  
**Layout -** Choose default layout.  
**Subject -** This text will appear as the Email Subject. Note that the use of short code is permitted in this field. In this case, we are calling up the account name for the company being invoiced.

## Short Code List  


<span class="legacy-color-text-default">The template allows the use of special tokens, or short codes, to pull information from the database to appear on the invoice when sent.  
These include:</span>

<span class="legacy-color-text-default">**<span class="badge click-copy">\[</span><span class="badge click-copy">invoice account="number"\]</span>** The account number for the company.  
**<span class="badge click-copy">\[invoice account="name"\]</span>** The account name for the company.  
**<span class="badge click-copy">\[invoice account="fulladdress"\]</span>**<span data-colorid="rterxjuhci"> The full address for the company.</span>  
</span>**<span class="badge click-copy legacy-color-text-default">\[invoice account="invoice\_comments"\]</span>**<span class="legacy-color-text-default"> The invoice comment value that is editable for companies only. Any line breaks will be preserved.  
</span>**<span class="badge click-copy legacy-color-text-default">\[invoice show="invoiceno"\]</span>** Invoice Number.  
**<span class="badge click-copy legacy-color-text-default">\[invoice show="duedate"\]</span>**<span class="legacy-color-text-default"> </span><span class="legacy-color-text-default">Invoice due date.  
</span>**<span class="badge click-copy legacy-color-text-default">\[invoice show="billdate"\]</span>**<span class="legacy-color-text-default"> </span><span class="legacy-color-text-default">Invoice bill date.  
</span>**<span class="badge click-copy legacy-color-text-default">\[invoice show="subtotal"\]</span><span class="legacy-color-text-default"> </span>**<span class="legacy-color-text-default">Subtotal of all items before tax.  
</span>**<span class="badge click-copy legacy-color-text-default">\[invoice show="taxtotal"\]</span>**<span class="legacy-color-text-default"> </span><span class="legacy-color-text-default">Total amount of tax.  
</span>**<span class="badge click-copy legacy-color-text-default">\[invoice show="amounttotal"\]</span>**<span class="legacy-color-text-default"> </span><span class="legacy-color-text-default">The total sum amount for all outstanding permits for this invoice.  
</span>**<span class="badge click-copy legacy-color-text-default">\[invoice show="counttotal"\]</span>**<span class="legacy-color-text-default"> </span><span class="legacy-color-text-default">The total number of permits for the selected sales window.  
</span>**<span class="badge click-copy legacy-color-text-default">\[invoice show="details"\]</span>**<span class="legacy-color-text-default"> </span><span class="legacy-color-text-default">The list of permits, cost and who has the permit.  
  
</span>

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/Yosimage.png)](https://opscom.wiki/uploads/images/gallery/2024-06/Yosimage.png)

<span class="legacy-color-text-default">  
</span>

<span class="legacy-color-text-default">These tokens can be placed anywhere on the template and will pull data from the system, similar to a mail merge functionality.  
  
For example, in the **Bill To:** area, the system will retrieve the **Full Address of the Company** as well as the **Company Account Number** using these two short code tokens:  
**<span class="badge click-copy">\[invoice account="fulladdress"\]</span>**<span data-colorid="vue4k7mrbj"> The full address for the company.  
**<span class="badge click-copy">\[</span><span class="badge click-copy">invoice account="number"\]</span>** The account number for the company.</span></span>

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/54gimage.png)](https://opscom.wiki/uploads/images/gallery/2024-06/54gimage.png)

<span class="legacy-color-text-default"><span data-colorid="bjj6i4g3nf">  
</span></span>

## <span class="legacy-color-text-default"><span data-colorid="y8mzp1helo">The Template</span></span>

<span class="legacy-color-text-default"><span data-colorid="sq21corqza">There are a number of areas on the template that can be edited by the admin. To add branding to the template there are two areas that will be of concern.  
  
**The Company Logo Field:**  
This is where you would place your company logo. Using a .JPEG or .PNG file format is recommended. </span></span>

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/L35image.png)](https://opscom.wiki/uploads/images/gallery/2024-06/L35image.png)

<span class="legacy-color-text-default"><span data-colorid="hg235a233q">**Your Company Address:**  
Enter your company address here.</span></span>

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/eqBimage.png)](https://opscom.wiki/uploads/images/gallery/2024-06/eqBimage.png)

<span class="legacy-color-text-default"><span data-colorid="gzfgxacea5">**Invoice Identification:**  
</span></span><span data-colorid="jt8341smay">In this section use short code to pull in the **Invoice Number, Billing Date, and Due Date**.</span>

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/uoVimage.png)](https://opscom.wiki/uploads/images/gallery/2024-06/uoVimage.png)

**<span class="legacy-color-text-default"><span data-colorid="jem9hq3l03">Invoice Details:</span></span>**

<span class="legacy-color-text-default"><span data-colorid="sx1cc226ly">The short code **<span class="badge click-copy legacy-color-text-default">\[invoice show="details"\] </span>**<span class="badge click-copy legacy-color-text-default">pulls in the list of permits that will appear on the Invoice. (See a sample of the Invoice below)  
  
These include:</span></span></span>

<span class="legacy-color-text-default"><span data-colorid="zbxyeezt3b"><span class="badge click-copy legacy-color-text-default">Parker's Name  
Item type being Paid for (Permit, Access card, etc.)  
Item number (Permit Number)  
Sales Window  
Lot Name  
Quantity  
Cost  
</span></span></span>

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/19Nimage.png)](https://opscom.wiki/uploads/images/gallery/2024-06/19Nimage.png)

<span class="legacy-color-text-default"><span data-colorid="zbxyeezt3b"><span class="badge click-copy legacy-color-text-default">  
</span></span></span>

<span class="legacy-color-text-default"><span data-colorid="mxea081e6o">**Payment Information** (Billing Cost)**:** </span></span>In this section use short code to pull in the billing information such as **Subtotal, Calculated Taxes, and Total Billing Amount.

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/4xEimage.png)](https://opscom.wiki/uploads/images/gallery/2024-06/4xEimage.png)

<span class="legacy-color-text-default"><span data-colorid="vu5ogl5uow">You may also wish to add comments to the invoice. Comments can be added in the company configuration. </span></span>

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/SInimage.png)](https://opscom.wiki/uploads/images/gallery/2024-06/SInimage.png)

<span class="legacy-color-text-default"><span data-colorid="bpiaf01uli">**The Email with PDF attached:**  
Here is a sample of what the resulting email would look like. There is also a .PDF version of this invoice attached to the email.  
  
</span></span>

[![image.png](https://opscom.wiki/uploads/images/gallery/2024-06/scaled-1680-/UANimage.png)](https://opscom.wiki/uploads/images/gallery/2024-06/UANimage.png)

<span class="legacy-color-text-default"><span data-colorid="bpiaf01uli">  
</span></span>