Insert these merge fields into your file or email templates to populate your templates with your organization data from Karbon.
Index:
Date fields
Any template can use the following date fields to populate dates whether SuiteFiles is connected to Karbon or not:
Date Field | Value |
[DATE:TODAY]
[DATE:TODAYTEXT]
[DATE:FULLTODAYTEXT]
[DATE:YEAR]
| Today's date formatted DD/MM/YYYY (e.g. 21/04/2023)
Today's date formatted DD MMM YYYY (e.g. 21 Apr 2023)
Today's date formatted DD MMMM YYYY (e.g. 21 April 2023)
The current year formatted YYYY (e.g. 2023)
|
Organization fields
When working with document and email templates in SuiteFiles you can add merge fields to them that will pull information about the organization from Karbon and display in the finished file or email. The field syntax to use and their corresponding data in Karbon are:
Field Name | Karbon Value |
[CLIENT:NAME]
[CLIENT:OWNER]
[CLIENT:LEGALNAME]
[CLIENT:TAXCOUNTRYCODE]
[CLIENT:VATREGISTERED]
[CLIENT:REVENUEMODEL]
[CLIENT:NZBUSINESSNUMBER] [CLIENT:GSTNUMBER]
[CLIENT:IRDNUMBER]
[CLIENT:WEBSITE]
[CLIENT:EMAIL]
[CLIENT:PHONE]
[CLIENT:MOBILEPHONE]
[CLIENT:OFFICEPHONE]
[CLIENT:FAXPHONE]
[CLIENT:HOMEPHONE]
[CLIENT:OTHERPHONE]
| ORG NAME
ORG OWNER
LEGAL NAME
TAX COUNTRY CODE
VAT REGISTERED
REVENUE MODEL
NZ BUSINESS NUMBER
GST NUMBER
IRD NUMBER
ORG WEBSITE
ORG EMAIL
ORG PHONE
ORG MOBILE PHONE
ORG OFFICE PHONE
ORG FAX NUMBER
ORG HOME PHONE
ORG OTHER PHONE
|
Address Fields
The following receives the physical address of the organization:
[CLIENT:ADDRESS]
[CLIENT:CITY]
[CLIENT:REGION]
[CLIENT:POSTCODE]
[CLIENT:COUNTRY]
The following receive the postal address of the organization:
[CLIENT:POSTALADDRESS]
[CLIENT:POSTALCITY]
[CLIENT:POSTALREGION]
[CLIENT:POSTALPOSTCODE]
[CLIENT:POSTALCOUNTRY]
The following receive the legal address of the organization:
[CLIENT:LEGALADDRESS]
[CLIENT:LEGALCITY]
[CLIENT:LEGALREGION]
[CLIENT:LEGALPOSTCODE]
[CLIENT:LEGALCOUNTRY]
The following receive the home address of the organization:
[CLIENT:HOMEADDRESS]
[CLIENT:HOMECITY]
[CLIENT:HOMEREGION]
[CLIENT:HOMEPOSTCODE]
[CLIENT:HOMECOUNTRY]
The following receives the postal address of the organization first but if the postal address does not exist, then it defaults to the physical address:
[ADDRESS:POSTAL_OR_PHYSICAL]
[CITY:POSTAL_OR_PHYSICAL]
[REGION:POSTAL_OR_PHYSICAL]
[POSTCODE:POSTAL_OR_PHYSICAL]
[COUNTRY:POSTAL_OR_PHYSICAL]
Registration Numbers
New Zealand
If the Accounting Details Country in Karbon is New Zealand, use the following merge fields to fetch the accounting information:
Field Name | Karbon Value |
[CLIENT:NZBUSINESSNUMBER]
[CLIENT:GSTNUMBER]
[CLIENT:IRDNUMBER]
| NZ BUSINESS NUMBER
GST NUMBER
IRD NUMBER
|
South Africa
If the Accounting Details Country in Karbon is South Africa, use the following merge fields to fetch the accounting information:
Field Name | Karbon Value |
[CLIENT:REGISTRATIONNUMBER]
[CLIENT:INCOMETAXNUMBER]
[CLIENT:PAYENUMBER]
[CLIENT:DOLUIFNUMBER]
[CLIENT:SDLNUMBER]
[CLIENT:DOLWORKMANCOMPENSATION]
[CLIENT:VATNUMBER]
| REGISTRATION NUMBER
INCOME TAX NUMBER
PAYE NUMBER
DOL UIF NUMBER
SDL NUMBER DOL
WORKMAN COMPENSATION
VAT NUMBER
|
United States
If the Accounting Details Country in Karbon is United States, use the following merge fields to fetch the accounting information:
Field Name | Karbon Value |
[CLIENT:TAXID]
[CLIENT:SSN]
| TAX ID
SOCIAL SECURITY NUMBER (SSN)
|
Canada
If the Accounting Details Country in Karbon is Canada, use the following merge fields to fetch the accounting information:
Field Name | Karbon Value |
[CLIENT:BUSINESSNUMBER]
[CLIENT:SIN]
| BUSINESS NUMBER
SOCIAL INSURANCE NUMBER (SIN)
|
Australia
If the Accounting Details Country in Karbon is Australia, use the following merge fields to fetch the accounting information:
Field Name | Karbon Value |
[CLIENT:ABN]
[CLIENT:ACN]
[CLIENT:TFN
| AUSTRALIAN BUSINESS NUMBER (ABN) AUSTRALIAN COMPANY NUMBER (ACN) TAX FILE NUMBER (TFN) |
Business Values
Business Values allow you to pull through your own business details onto your SuiteFiles Templates. To enter these values, an Administrator can click their user name in the top right corner of SuiteFiles Web, click Admin settings, then select Prepopulation. Click the blue Edit Values button to update the Values. Once done, click Save Business Values. The Merge Field when entered into your template must be in CAPS, the Field Name can include a space.
Field Name | Value |
[BUSINESS:WEBSITE]
[BUSINESS:BUILDING]
[BUSINESS:STREET]
[BUSINESS:CITY]
[BUSINESS:POSTCODE]
[BUSINESS:COMPANYNUMBER]
[BUSINESS:MANAGINGDIRECTOR]
| WEBSITE
BUILDING
STREET
CITY
POSTCODE
COMPANY NAME
MANAGING DIRECTOR
|