Saasu allows you to customise your sales, purchases, and statements by using themes and templates.
Template – PDF
Table of Contents
Where: View > Templates > and click on the Template Name to edit it.
With the PDF templates you can save, print, or email these to customers and suppliers. PDF templates use an underlying theme to determine the core layout elements of the page and then allows you to include your own custom information within in the layout provided by the theme.
In the PDF template you can set defaults for various areas that make up your invoices and statements, upload and select a logo for the template, add notes and provide information such as payment details.
You can have different PDF templates for different trading names, individualised for particular customers or even customised for different times of the year (eg. Christmas or End of Financial year). There is no limit to the number of templates you can have.
Sender Details
The text you enter into this section will appear in the top right corner of the invoice opposite the logo. Again, you can enter any information you want into this area, but it is best suited for your business address, phone number, website and email contact information. If you add more than 10 lines of information it will start to push the address and invoice content down the page.
Remittance Details
The text you enter into this section will appear immediately below the list of items in your invoice. Although most suited to remittance information, you could include any information that you like in this area. Remittance information is the information your customers require to make a payment. This may be payment information, PayPal, Ebay, Bank Direct deposit, Credit Card payment options.
Payment Options
Enter the payment methods you accept. As an example:
[ ] Mail cheque payable to Saasu to Level 1, 111 Elizabeth Street, Sydney NSW 2000, Australia
[ ] Direct Deposit: Westpac A/C: Saasu Pty Ltd, Branch:032-044, A/C#:379215
Kindly include your invoice number or company name in your payment description.
[ ] Credit CardCard Holder: ___________________________ Signature: ___________________________
Card Number: _ _ _ _ | _ _ _ _ | _ _ _ _ | _ _ _ _ Expiry: _ _ / _ _
PayPal
PayPal lets you receive or pay money and all you need is an email address and a bank account. PayPal is much like a bank. PayPal accounts in Saasu are set up as an Asset account and the option to set it to a bank account is selected. Go to View > Accounts to create your account called "Asset: PayPal"
PayPal merchant accounts allow you to get links that you can put in your Saasu invoices, website pages or blogs. this makes it easy or an additional option for your customers to pay you by credit card, PayPal funds or even direct debit.
Before adding PayPal as a Payment option you may need to Setup your Paypal account. Then use then try these sample code snippets that can be used in Templates (HTML mode only) or Themes in Saasu:
Send Money…
When clicked you customer is sending you an amount of money they nominate
1 | <a href="https://www.paypal.com/au/cgi-bin/webscr?cmd=_send-money&nav=1.1">Pay via PayPal</a> |
Pay Now Link
When clicked you customer is Paying the Invoice in full or the amount outstanding via PayPal
Note that in the URL you will see URL accepted code that replaces keyboard characters as follows:
- %40 = “@”
- %2e = “.”
- %20 = ” ” (space)
As an example the email address “pay@saasu.com” appears as “pay%40saasu%2ecom”
Example: Pay for a specific Item
1 | <a href='https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=PAY%40SAASU%2eCOM&lc=AU&item_name=ITEMDESCRIPTION&item_number=ITEMCODE&amount={BalanceDue}¤cy_code=USD&button_subtype=services&no_note=0&bn=PP%2dBuyNowBF%3abtn_buynowCC_LG%2egif%3aNonHostedGuest'>Pay balance owing using PayPal in USD's</a> |
In this example the variables you modify are:
- PAY%40SAASU%2eCOM
- ITEMDESCRIPTION
- ITEMCODE
- USD
- Pay balance owing using PayPal in USD’s
Example: Pay balance of an invoice/order
1 | <a href='https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=PAY%40SAASU%2eCOM&lc=AU&item_name=Inv{InvoiceNumber}%20for%20{Summary}&amount={BalanceDue}¤cy_code=USD&button_subtype=services&no_note=0&bn=PP%2dBuyNowBF%3abtn_buynowCC_LG%2egif%3aNonHostedGuest'>Pay balance owing using PayPal in USD's</a> |
In this example the variables you modify are:
- PAY%40SAASU%2eCOM
- {InvoiceNumber}%20{Summary}
- USD
- Pay balance owing using PayPal in USD’s
BPay (Australia)
BPAY is a payment process used in Australia. Businesses wanting to be able to receive BPAY payments will need to contact your financial institution to apply. As part of the sign up process, you will be provided with a BPAY Biller Code and the BPAY Operations Manual. You can then provide these in your Saasu Invoices so your customers can pay you. Below we provide some ways to help you do this.
How you provide a reference number to your customers is quite important as it may impact reconciliations and other workflow. Generally speaking unique numbers of each payment help you assign the payment to the correct transaction but require your customer to enter a new unique reference number each time they pay you. Alternately a static number is easy for your customers and reduces their input/entry risk but it may add to your reconciliation burden. Saasu can only support static CRN’s as we don’t yet support CRN generation. You can create a static CRN for each customer using BPays CRN tools.
You can create a BPay reference number as follows:
- Use the BPay software to work out your clients CRN number. A single digit number. Let’s say 7
- Go to View > Templates. Open your template by clicking on it and navigate to the Payment area.
- Add this text (note that the template can be set to Text or HTML):
BillerCode: [supplied by your bank]
Cust Ref#: {BillingContact.ContactID}{InvoiceNumber}7
Footer Text
This is the information that appears in the footer area of each page. You may choose to include your address details or any other relevant information that you feel would be useful in this location. Examples include business registration numbers, terms of trade, general Disclaimers or Privacy Statements, Product Disclosure Statement link and Terms and Conditions.
Logo Image
You can upload multiple images to use as logo:
| Maximum file size | 100KB. |
| File Type | JPG, GIF and PNG |
| File Width (No Sender Details) |
960px |
| File Width (With Sender Details) |
640px |
TIP: Saasu doesn’t auto-size images to ensure print quality isn’t compromised.
The quality of the image you upload will directly result in higher quality PDF’s in Saasu but your PDF file size you are sending out will also be larger. So there is a trade off between quality and file size. Generally the market likes to receive PDF files for invoices at < 100k. 20k to 50k is ideal and can still achieve good quality.
For the best quality result we recommend using images with a resolution of at least 150dpi. Bear in mind higher resolution images will result in PDF generation taking longer each time.
You might sometimes need to try different formats from the above list for your templates. So in case if one format is not displaying properly or if you have trouble viewing the PDF invoice, you could try converting the image into another one from above. This usually resolves any rendering issues that were preventing you from viewing the PDF invoice. It is important that the image stays within the recommended size for viewing with or without sender details.
Add your logo
- Go to View > Templates > open you template you wish to add a logo to by clicking on it.
- Use the Upload link next to your logo drop down box to browse and upload your logo from your computer.
- Click Preview to see how it looks. Saasu will load a sample PDF in Adobe Reader or in a Tab in your browser.
- If you’re happy with the result click Save in the templates add/edit screen to save your changes otherwise upload another image and try again.
Change the logo
Go to View > Templates to open the template, and upload new logo or use one that you’ve uploaded before.
Resize my logo
Use online image resizer tool, or if you want more control, use image editing program. The free one such as Paint.NET for Windows should do the job.
Using merge fields
You can include key information relating to an individual invoice in your remittance section template. If you include any of the following “merge fields” in the remittance section template text they will be replaced with the appropriate information when viewing, printing or emailing a PDF invoice.
Embedding Barcodes
If you have a an online barcode generation service that fits your preferred style and that you have a license for you can easily embed barcodes in Saasu. Some are free and some charge for commercial use. As an example using BarcodesInc.com you would add this code in to your HTML Invoice Template in Saasu. It would generate a bar code for the {ClientID} merge field you had saved in Saasu as an example. If you get get clever with the themes for your Saasu template you could in theory have barcode by line item at the Saasu Ihem level to create a barcode for a picking slip.
<img src=”http://www.barcodesinc.com/generator/image.php?code={ClientID}&style=197&type=C128B&width=200&height=50&xres=1&font=3″ alt=”" title=”barcodes inc” />
Creating a tear-off
A tear-off is often used when people make payments by cheque or credit card and you would like them to send this information back to you so you can match the received cheque against their invoice or process the credit card payment using the handwritten information.
— Remittance Advice – Please retain the above portion for your records —
Embedding a Google Map
Note: You may require a Google Maps license from Google to do this in certain circumstances. If so contact Devnet for more information.
Builds a google map from the Contacts address on-the-fly by inserting the address using merge fields that represent the search field you would normally use in Google maps. Licenses from Google may be required to do this for your file.
1 2 3 4 5 6 7 | <div class="hide-{ShippingContact.IsSpecified} delivery-details"> <strong>Shipping Destination</strong> <!--<img class="gmap" src="http://maps.google.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&maptype=roadmap&sensor=false&size=960x512&markers=color:blue|label:D|Brooklyn+Bridge+New+York+NY&zoom=13"/>--> <img class="gmap show-{BillingContact.ShippingAddress.IsSpecified}" src="http://maps.google.com/maps/api/staticmap?center={BillingContact.ShippingAddress.Street}+{BillingContact.ShippingAddress.City}+{BillingContact.ShippingAddress.State} +{BillingContact.ShippingAddress.PostOrZipCode}+{BillingContact.ShippingAddress.Country}&maptype=roadmap&sensor=false&size=960x512&markers=color:red|label:D|{BillingContact.ShippingAddress.Street}+{BillingContact.ShippingAddress.City}+{BillingContact.ShippingAddress.State} +{BillingContact.ShippingAddress.PostOrZipCode}+{BillingContact.ShippingAddress.Country}&zoom=15" /> <img class="gmap hide-{BillingContact.ShippingAddress.IsSpecified}" src="http://maps.google.com/maps/api/staticmap?center={BillingContact.MailingAddress.Street}+{BillingContact.MailingAddress.City}+{BillingContact.MailingAddress.State} +{BillingContact.MailingAddress.PostOrZipCode}+{BillingContact.MailingAddress.Country}&maptype=roadmap&sensor=false&size=960x512&markers=color:red|label:D|{BillingContact.MailingAddress.Street}+{BillingContact.MailingAddress.City}+{BillingContact.MailingAddress.State} +{BillingContact.MailingAddress.PostOrZipCode}+{BillingContact.MailingAddress.Country}&zoom=15" /> </div> |
CSS required for the above DIV Containers:
1 2 | .delivery-details { page-break-before: always;}
.gmap {padding: 30px; margin-left: 100px;} |
PDF File Specifications
| Variable | Location | mm | inches | points* | |
|---|---|---|---|---|---|
| Page Size | A4 | 210 x 297 | 8.27 x 11.69 | ||
| Margin | Top | 10mm | 0.394 | 28pt | |
| Right | 10mm | 0.394 | 28pt | ||
| Bottom | 5mm | 0.197 | 14pt | ||
| Left | 26mm | 1.024 | 56pt | ||
| * Points = 1/72nd of 1 Inch # DPI = Pixels / Inches |
|||||
Template – Email
Where: View > Templates > Email tab
Saasu provides you with the ability to email invoices, purchases and statements directly to customers and suppliers from within Saasu, without additional email software or plug-ins.
The email template handles the information that is included in the body of the email, whereas the PDF template handles the information contained with invoice, purchase or statement that is attached to the email.
In the email template you can use merge fields to include customer information such as name, company or other information contained within the contact data.
Using Email Templates
- Use ‘,’ to separate multiple addresses, e.g. accounts@acme.com,sales@acme.com.
- Make it a default template to have the email form pre-filled for you automatically with these values when you email your invoice, statement or payslip.
Test your email
Test you email looks good in common email applications such as Outlook, Thunderbird, Gmail, Hotmail and Yahoo mail. This will let you experience it from your customer perspective.
Preventing email being sent to spam
A few simple things will help prevent your email being treated as spam in most cases. We obviously can’t control this happening. It will happen in some cases.
- Add an SPF record for Saasu to your Domain Name DNS entry
- Have customers add you to their friends list in their email applications and/or servers.
- Don’t include too many links in your email
- Make sure your subject and content avoids too many spam like words. Multiple uses of FREE, CHEAP etc
- Make sure links included are to reputable destinations
- Having the sender email address the same as the sender name can help. e.g. the email address service@saasu.com has the name Saasu Service on our emails.
BCC your emails to a mailbox you own
Setup a mailbox for your business that can act as a repository containing a copy of all the email you send out. e.g. transactions@sample.com
What not to use Email templates for
- Marketing by sending quotes/invoices soliciting business that has not already had a customer opt-in to buy a product or service from you.
- Any other use other than the intent to deliver an invoice to a contact for the purposes of finalising a pre-agreed transaction.
Does Saasu keep a copy for me?
You can always print/view a copy of an invoice or statement from within Saasu but we don’t provide email storage at this stage. We suggest you BCC everything you send out to your contacts.
Do merge fields work in Email templates?
Yes. You can use merge fields such as {BillingContact.FirstName} to personalise your emails.
Can I use a different template when emailing a contact
At present this is only available in Automated Transactions to allow different templates to be used for different groups of contacts you send to. In a later release we will allow you to choose an email template when you go to send a manually created transaction but at present this only uses the Default template.
Themes
Themes allow a high degree of customisation of the design and layout and form the base for the PDF template. As themes are created using HTML and CSS you will need to be comfortable with using this code in order to get the best result. Alternatively you can use your web designer to assist in creating themes that match your brand.
WHERE: View > Templates > Edit and Create your own theme (link below Theme picklist)
You can use Saasu themes to add some design elements to your Saasu templates. Your template has specific information for a document while the theme refers to the layout, colours, fonts, and other design elements that can be applied to more than one template.
Themes in Saasu allow you to add useful design features to one or more of your templates. Themes are designed to give Saasu customers with programming skills (HTML or CSS) the flexibility to help their business customers with specific PDF and email documentation needs in Saasu. Their requirements may include:
- Design elements such as colours, fonts, and images.
- Information blocks such as warranty or product information.
- Logistics information such as barcodes, delivery maps, and other devices.
- Translation to other languages.
Themes do not provide a way for customers with no programming experience to change the look and feel of their templates. If you haven’t used HTML and CSS programming code before, it’s probably best not to attempt this as we don’t provide HTML/CSS programming support. This is due to the intensity of having to teach people programming before we can even suggest how to work with using the Themesfeature in Saasu. Don’t worry, though, as we will provide a similar feature as a built-in option for our customers who don’t have these skills or access to them.
Themes let you to control far more design elements in a document, including where your logo displays, and the colour and type of font you use. You can even embed things like maps, images, links, and buttons.
Edit Themes
- Select View > Templates > Choose a template you want to design or edit a theme for – The Template will load in edit mode.
- Click Edit and create your own theme.
- Saasu will display some default themes that we have set up. You can open one similar to what you need and duplicate it using the Duplicate button.
- Edit the CSS and HTML code for the theme.
- You can use the Preview button to check your progress. The preview will display as a PDF so you can be sure the design work you are doing matches what your customers will see.
NOTE: When you edit a Sale or Purchase theme, two formats will display when you preview your changes – An Item style view and a Service style view.
Theme versions
You may need different version of a theme for different situations. You may need to customise words, like the invoice title for example.
Generally this involves duplicating the theme you want to change, making the changes, and setting up the template to use the theme that you change. Some HTML knowledge is required to do this. Otherwise, it could be frustrating to get it working. Here are the steps:
- Open the template you want to edit.
- Click Edit and create your own theme below the Theme picklist.
- Pick the theme you want to edit.
- Duplicate the theme.
- Make your changes. For example, if you just want to change the title, find the text {InvoiceType.PrintDescription} and replace it with the word that you want to use.
- Click Preview to see your changes.
- Click Save once you’re happy with these.
- Go back to the template list screen and open the template you want to change.
- Change the theme to the new one you just created and click Save.
Merge Fields
Merge fields allow you to include transaction-specific information in the parts of the invoice template that can be edited. As with many standard mail merge systems, you simply include the field with parentheses around it, ensuring the text has the correct case.
Sales and Purchases
| Merge Field | Merge Value/Text |
|---|---|
| {BalanceDue} | Balance outstanding. |
| {BillingContact.FirstName}, etc | See Contact Merge Fieldssection below for full list. Prefix with “BillingContact.”. E.g. {BillingContact.FirstName}, {BillingContact.LastName}, {BillingContact.ContactID}, {BillingContact.MobilePhone}, {BillingContact.MailingAddress.Street}, etc |
| {BillingContact.IsSpecified} | Returns “true” if billing contact is specified or “false” otherwise. |
| {Ccy.Code} | The currency code for this transaction. E.g. USD, EUR, GBP, AUD, SGD, NZD, etc. |
| {Ccy.Symbol} | |
| {Ccy.Name} | |
| {Date} | The invoice date. |
| {Due} | The invoice due date. |
| {HasDiscounts} | Returns “true” if current invoice has discounts applied. |
| {InvoiceNumber.Label} | For order and invoice: Invoice # For quote: Quote # |
| {InvoiceNumber} | |
| {InvoiceType.PrintDescription} | Zone-sensitive invoice type description. E.g. Invoice, Tax Invoice, Adjustment Note, Credit Note, etc. |
| {IsInvoice} | Returns “true” if current status is invoice or “false” otherwise. |
| {IsOrder} | Returns “true” if current status is order or “false” otherwise. |
| {IsPurchase} | Returns “true” is current invoice is a purchase invoice or “false” otherwise. |
| {IsQuote} | Returns “true” if current status is quote or “false” otherwise. |
| {IsSale} | Returns “true” is current invoice is a sale invoice or “false” otherwise. |
| {Notes.Internal} | |
| {Notes.Pdf} | |
| {PurchaseOrderNumber.Label} | Displays “PO #” |
| {PurchaseOrderNumber} | |
| {ShippingContact.FirstName}, etc | See Contact Merge Fieldssection below for full list. Prefix with “ShippingContact.”. |
| {ShippingContact.IsSpecified} | Returns “true” if shipping contact is specified or “false” otherwise. |
| {Summary} | |
| {TotalExcTax} | Invoice total excluding tax. |
| {TotalIncTax} | Invoice total including tax. |
| {TotalPayment} | Total payment applied to this invoice. |
| {TotalTax} | Total tax in the invoice. |
| {HasAmountOwed} | Any outstanding amount for the invoice? |
The following merge fields should only be used in the line item section of the theme. They MUST be enclosed within the following comment tags:
1 2 3 4 5 6 7 8 9 10 11 | <!-- Begin Service Invoice Line Items --> <!-- Begin Service Invoice Line Item --> --- Line item merge fields could only be used here --- <!-- End Service Invoice Line Item --> <!-- End Service Invoice Line Items --> <!-- Begin Item Invoice Line Items --> <!-- Begin Item Invoice Line Item --> --- Line item merge fields could only be used here --- <!-- End Item Invoice Line Item --> <!-- End Item Invoice Line Items --> |
Also note that ALL the comment tags above MUST exist in the sale and purchase theme. Otherwise, your theme will only work with either a service invoice or an item invoice, but not both. See the existing theme for sample implementation.
Item Invoice Line Items
| Merge Field | Merge Value/Text |
|---|---|
| {LineItem.Quantity} | |
| {LineItem.Item.Code} | |
| {LineItem.Item.SupplierItemCode} | |
| {LineItem.Item.Description} | |
| {LineItem.TaxCode} | |
| {LineItem.TaxCode.Description} | |
| {LineItem.TaxRate} | |
| {LineItem.UnitPriceExcTax} | |
| {LineItem.UnitPriceIncTax} | |
| {LineItem.PercentageDiscount} | |
| {LineItem.Tax} | |
| {LineItem.TotalExcTax} | |
| {LineItem.TotalIncTax} |
Service Invoice Line Items
| Merge Field | Merge Value/Text |
|---|---|
| {LineItem.Description} | |
| {LineItem.TaxCode} | |
| {LineItem.TaxCode.Description} | |
| {LineItem.TaxRate} | |
| {LineItem.Tax} | |
| {LineItem.TotalExcTax} | |
| {LineItem.TotalIncTax} |
Date Merge Fields
You can now display dates using merge fields that can calculate. They do their calculations based on Transaction Date.
Some examples are:
- {Date+0D}
- {Date+7D}
- {Date+2W}
- {Date+1M}
Use Calculating Date Merge Fields in:
- Description and Summary fields in Sales or Purchases.
- Also use them in your Templates and Themes.
This is very useful if you bill for fixed time periods. e.g. If we have an Automated Sale invoice on the 10th of each month that will be recurring we can set up an Automated Sale with the Summary field set to “For {Date+0D} to {Date+1M}” then it will display as “For 10Jan12 to 10Feb12″.
Remittances and Receipts
NOTE: For remittance and receipt templates, add ‘BillingContact’ to the beginning of contact related merge fields. For example, to display the full name of the billing contact, use {BillingContact.FullName}.
| Merge Field | Merge Value/Text |
|---|---|
| {Ccy.Code} | Currency code of the payment currency. |
| {PaymentAmount} | The total payment amount. |
| {DatePaid} | |
| {DateCleared} | |
| {Reference} | |
| {Summary} |
Remittance and Receipt Line Items
| Merge Field | Merge Value/Text |
|---|---|
| {LineItem.IssuedDate} | The invoice date. |
| {LineItem.InvoiceNumber} | For remittance, this is the invoice number issued to you by the supplier. For receipt, this is the invoice number issued by you to the customer. |
| {LineItem.PurchaseOrderNumber} | For remittance, this is the purchase order number issued by you to the supplier. For receipt, this is the purchase order number issued to you by the customer. |
| {LineItem.Amount} | The total amount of an invoice. |
| {LineItem.Paid} | The total amount paid for an invoice. |
| {LineItem.Outstanding} | The total amount outstanding for an invoice. |
Contacts
NOTE: For invoice templates, add ‘BillingContact’ or ‘ShippingContact’ to the beginning of the merge field. For example, to display the full name of the billing contact, use {BillingContact.FullName}.
| Merge Field | Merge Value/Text |
|---|---|
| {Title} | |
| {FirstName} | |
| {Initial} | |
| {LastName} | |
| {FullName} | |
| {Company.Name} | |
| {Company.BusinessNumber} | |
| {Company.Website} | |
| {PositionTitle} | |
| {Email} | |
| {Website} | |
| {TwitterID} | |
| {SkypeID} | |
| {MainPhone} | |
| {HomePhone} | |
| {MobilePhone} | |
| {OtherPhone} | |
| {Fax} | |
| {MailingAddress.IsSpecified} | |
| {MailingAddress.Street} | |
| {MailingAddress.City} | |
| {MailingAddress.State} | |
| {MailingAddress.PostOrZipCode} | |
| {MailingAddress.Country} | |
| {ShippingAddress.IsSpecified} | |
| {ShippingAddress.Street} | |
| {ShippingAddress.City} | |
| {ShippingAddress.State} | |
| {ShippingAddress.PostOrZipCode} | |
| {ShippingAddress.Country} | |
| {ContactID} | |
| {ContactManager.Title} | |
| {ContactManager.FirstName} | |
| {ContactManager.Initial} | |
| {ContactManager.LastName} | |
| {ContactManager.FullName} | |
| {ContactManager.ContactID} | |
| {CustomField1} | |
| {CustomField2} | |
| {AcceptDirectDeposit} | Returns “true” or “false” |
| {DirectDeposit.AccountName} | |
| {DirectDeposit.BranchOrRouteNumber} | |
| {DirectDeposit.AccountNumber} | |
| {AcceptCheque} | Returns “true” or “false” |
| {Cheque.PayableTo} |
Statements
| Merge Field | Merge Value/Text |
|---|---|
| {Contact.FirstName}, etc | See the Contact Merge Fieldssection for a full list. Prefix with “Contact.”. E.g. {Contact.FirstName}, {Contact.LastName}, {Contact.ContactID}, {Contact.MobilePhone}, {Contact.MailingAddress.Street}, etc. |
| {PeriodFrom} | Statement start date. |
| {PeriodTo} | Statement end date. |
| {Balance} | Running balance as at statement end date. |
| {Total.Invoice} | Total of all invoices included in the statement. This amount includes tax. |
| {Total.Tax} | Total tax in the statement. |
| {Total.Payment} |
The following merge fields should only be used in the line item section of the theme.
Please see the existing payslip theme for sample implementation.
| Merge Field | Merge Value/Text |
|---|---|
| {LineItem.Date} | |
| {LineItem.DueDate} | |
| {LineItem.DueDate.IsSpecified} | |
| {LineItem.Summary} | |
| {LineItem.InvoiceNumber} | |
| {LineItem.PONumber} | |
| {LineItem.InvoiceAmount} | |
| {LineItem.PaymentAmount} | |
| {LineItem.PaymentReference} | Reference for payment. For invoices, this will always be blank. |
| {LineItem.Amount} | The line item amount. Show the invoice amount if the current line is an invoice, or payment amount multiplied by -1 for payment. |
| {LineItem.Tax} | Tax amount for current invoice. |
| {LineItem.Balance} | Running balance, current line. |
| {LineItem.ShipToFirstName} | |
| {LineItem.ShipToLastName} | |
| {LineItem.ShipToCompany} | |
| {LineItem.ShippingContact} | |
| {LineItem.IsOpeningBalance} | |
| {LineItem.IsInvoice} | |
| {LineItem.IsPayment} |
Payslips
| Merge Field | Merge Value/Text |
|---|---|
| {PayDate} | |
| {Employee.FirstName} | |
| {Employee.LastName} | |
| {Employee.FullName} | |
| {Employee.MailingAddress} | |
| {PayPeriod.From} | |
| {PayPeriod.To} | |
| {AnnualGrossPay} | |
| {EmploymentType} | |
| {PayRateMethod} | |
| {PayFrequency} | |
| {RegisteredAgreement} | |
| {EmployeeClassification} | |
| {DirectDeposit.AccountName} | |
| {DirectDeposit.BranchOrRouteNumber} | |
| {DirectDeposit.AccountNumber} | |
| {GrossPay.ThisPeriod} | |
| {GrossPay.Ytd} | |
| {NetPayBanked.ThisPeriod} | |
| {NetPayBanked.Ytd} | |
| {Notes.Pdf} | |
| {Notes.Internal} |
The following merge fields should only be used in the line item section of the theme.
They MUST be enclosed within the following comment tags:
1 2 3 4 5 | <!-- Begin Wages And Salaries Pay Item -->...<!-- End Wages And Salaries Pay Item --> <!-- Begin Deductions Pay Item -->...<!-- End Deductions Pay Item --> <!-- Begin PAYG Witholding Pay Item -->...<!-- End PAYG Witholding Pay Item --> <!-- Begin Employer Contributions Pay Item -->...<!-- End Employer Contributions Pay Item --> <!-- Begin Entitlements Pay Item -->...<!-- End Entitlements Pay Item --> |
Please see the existing payslip theme for sample implementation.
| Merge Field | Merge Value/Text |
|---|---|
| {LineItem.PayItem.Name} | |
| {LineItem.PayItem.Name.CssClass} | Pay item name, in css friendly format. E.g. If pay item name is “Base Salary”, the css class name generated is “base-salary”. |
| {LineItem.PayItem.Notes} | |
| {LineItem.Hours} | |
| {LineItem.Rate} | |
| {LineItem.Amount} | |
| {LineItem.Ytd} | Financial year-to-date amount, from 1 Jul to 30 Jun. Other financial year ends will be supported in the future. |
Common Merge Fields
The following are merge fields that could be used across all Templates and Themes.
| Merge Field | Merge Value/Text |
|---|---|
| {Saasu.BaseUrl} | Returns the BaseUrl for Saasu Web App, which is: https://secure.saasu.com/a/ |
| {Today} | Today’s date. |
| {T} | Same as {Today} |
| {CTName} | Consumption tax name for your Zone, e.g. GST, VAT, Sales Tax. |
| {ZoneUid} | Internal tax zone uid. |
| {ZoneName} | Tax zone name |
| {CTRate} | Consumption tax rate. |
| {BIType} | Zone specific contact business identifier type. E.g. For Australia, it’s ABN. |
| {Logo.IsSpecified} | |
| {Logo.Url} | Full url for the selected logo. |
| {Image.Url} | Url for the image folder holding all of the uploaded logos. |
| {IsSpecified({MergeFieldToCheck})} |
Usage example: {IsSpecified({InvoiceNumber})} This will check whether {InvoiceNumber} contains any values or not and returns “true” or “false” accordingly. |
Using Sales and Purchase Merge Fields
For example, if you were to include the text,
Remittance advice for invoice number {InvoiceNumber} dated {Date}. The amount outstanding is {BalanceDue} {Ccy.Code}.
Then this would appear on the PDF,
Remittance advice for invoice number 001 dated 01-Jul-02. The amount outstanding is 100 AUD.
Referencing Image Files
You can upload and reference image files in Saasu to add images to your documents. Follow these steps:
- Select View > Templates > Open the template you wish to add images to.
- Use the Uploadlink beside your logo file to load one or more images into your Saasu file.
- When you have finished uploading these files, change this back to your standard logo image before saving.
- In your HTML code template (or in your theme code), use the following merge field: {Image.Url} followed by your image name. For example:
1
<img src="{Image.Url}MySecondImage.jpg" alt="" /> - Click Preview to check that your image file is displaying.
Merge Fields Rules
- Case sensitive – {Date} is not the same as {date}.
- Merge fields don’t always match the field caption in the screens. Only use the merge fields listed in the tables above.
