Skip to main content
All CollectionsConnected Apps and IntegrationsSuiteFiles
Karbon Merge Fields for Templates in SuiteFiles
Karbon Merge Fields for Templates in SuiteFiles

Insert these merge fields into your file or email templates to populate your templates with your organization data from Karbon.

Erin Jamison avatar
Written by Erin Jamison
Updated over a year ago

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

Did this answer your question?