Skip to main content

Full integration capabilities of Exchequer

An overview of the data fields imported from Exchequer into the CRM as part of the Exchequer integration.

Written by Jason

Important: This reference is provided as a guide and may not reflect every field imported for your specific configuration. Certain import sections, such as User Defined Fields, Price Lists, and Discount matrices, may not be fully represented here. Additionally, as the integration is updated over time, this document may become out of date. If you notice any missing fields, inaccuracies, or discrepancies between this document and the data in your system, please raise this with our support team so that we can review and update this article accordingly.

Sales Ledgers

CRM Field (Friendly Name)

Exchequer Source

Description

Account Code

acCode

Unique identifier to link the CRM customer record back to Exchequer

Company Name

acCompany

Displays the customer's company name in the CRM

Address Line 1

acAddress.Street1

Stores the first line of the customer's billing address

Address Line 2

acAddress.Street2

Stores the second line of the billing address

Town

acAddress.Town

Stores the town/city of the billing address

County

acAddress.County

Stores the county/region of the billing address

Country

acAddress.Country.cdName (v8+) or acAddress.PostCode (older)

Stores the country for the billing address

Country Code

acAddress.Country.cdCode2 (v8+ only)

ISO country code for international address standardisation

Address Line 5

acAddress.PostCode (v8+ only)

Additional address line available in newer Exchequer versions

Postcode

acPostCode

Postal/zip code for the customer

Telephone

acPhone

Primary phone number for the customer

Fax

acFax

Fax number for the customer

Email

acEmailAddr

Email address for the customer account

Default Warehouse

acLocation

Sets the default warehouse/location for this customer's orders

Invoice To

acInvoiceTo

Identifies which account invoices should be addressed to

On Stop

Derived from acAccStatus (status 2 = on hold)

Flags accounts that are on hold to prevent new orders

Closed

Derived from acAccStatus (status 3 = closed)

Flags accounts that have been closed in Exchequer

Balance

acHistory.acBalance

Current outstanding balance for the customer

Currency Code

ssCurrency(acCurrency).scSymbol

The currency symbol associated with the customer

Credit Limit

acCreditLimit

Maximum credit allowed for this customer

Overall Discount

acDiscount

The overall discount percentage applied to the customer

Price List

acDiscountBand

The price band (A–H) assigned to the customer

Compound Overall Discount

Hardcoded to -1

Priority flag ensuring this only applies when no other pricing overrides exist

Tax Code

acVATCode

The default VAT code (E/Z/A/D) for the customer

VAT Registration Code

acVATRegNo

Customer's VAT registration number for tax compliance

Settlement Discount

acDefSettleDisc

Default settlement discount percentage

Settlement Days

acDefSettleDays

Number of days within which settlement discount applies

Department Code

acDepartment

Default department code assigned to the customer

Cost Centre Code

acCostCentre

Default cost centre code assigned to the customer

GL Code

acSalesGL

The general ledger code associated with sales for this customer


Purchase Ledger

CRM Field (Friendly Name)

Exchequer Source

Description

Supplier Code

acCode

Unique identifier linking the CRM supplier record to Exchequer

Company Name

acCompany

Displays the supplier's company name

Address Line 1

acAddress.Street1

Stores the first line of the supplier's address

Address Line 2

acAddress.Street2

Stores the second line of the supplier's address

Town

acAddress.Town

Stores the town/city of the supplier's address

County

acAddress.County

Stores the county/region of the supplier's address

Country

acAddress.PostCode

Stores the country (mapped from the address postcode field in older versions)

Postcode

acPostCode

Postal/zip code for the supplier

Telephone

acPhone

Primary phone number for the supplier

Fax

acFax

Fax number for the supplier

Email

acEmailAddr

Email address for the supplier account

Closed

Derived from acAccStatus (status 3 = closed)

Flags suppliers that have been closed in Exchequer

Balance

acHistory.acBalance

Current outstanding balance owed to the supplier

Currency Code

ssCurrency(acCurrency).scSymbol

Currency symbol associated with the supplier

Product Items

CRM Field (Friendly Name)

Exchequer Source

Description

Product Reference

stCode

Unique product identifier from the stock record

Alternative Reference

stAltCode

Secondary/alternative product code

Product Description

stDesc(1)

Primary description of the product

Product Category

stParentCode

The parent group code, used as the product category

Discount Matrix Code

stCode

Links product to discount matrix calculations

Allow Overall Discount

Hardcoded to 1

Enables overall discount to be applied to this product

Unit of Sale

stUnitOfSale

Description of the unit the product is sold in

Default Warehouse

stLocation

Default stock location/warehouse for the product

Bin Location

stBinLocation

Specific bin location within the warehouse

Cost Centre

stCostCentre

Cost centre associated with this product

Department

stDepartment

Department associated with this product

Sell Price

stSalesBands(band).stPrice (configured RRP band)

Selling price converted to home currency

Cost Price

stCostPrice or stReorder.stReorderPrice (configurable)

Cost price for margin and profitability calculations

Sell Price Decimals

SystemSetup.ssSalesDecimals

Number of decimal places for sell prices

Cost Price Decimals

SystemSetup.ssCostDecimals

Number of decimal places for cost prices

Pack/Unit

Derived from stock converter

Unit description used for pricing calculations

VAT Code

stVATCode

Default VAT code for the product

Extended Description

stDesc(2) through stDesc(6)

Additional descriptive text for the product

Barcode

stBarCode

Product barcode for scanning/identification

Quantity Type

Derived from stock converter

Whether quantity is decimal or factor-based

Quantity Factor

Derived from stock converter

Conversion factor for quantity calculations

Quantity Decimals

SystemSetup.ssQtyDecimals

Number of decimal places for quantities

Allow Split

Derived (true if decimals > 0 or factor > 1)

Whether the product can be sold in partial quantities

Stocked

Derived from stType (0=Group excluded, 2=Description only)

Whether the product is a physical stocked item

Obsolete

Derived from stType (4=Discontinued)

Flags discontinued products

Purchase Currency

Derived from stReorder.stReorderCur or stCostPriceCur

Currency the product is purchased in

Purchase Cost

stCostPrice or stReorder.stReorderPrice (in purchase currency)

Cost price in the supplier's currency

Purchase Cost Decimals

Derived

Decimal places for the purchase cost

Unit Weight

stIntrastat.stSSDSalesUnitWeight (if Intrastat enabled)

Product weight for shipping/Intrastat reporting

Unit Weight Decimals

Hardcoded to 2

Decimal precision for weight

Unit Weight Description

Hardcoded to "kg"

Weight unit label


Product Categories

CRM Field (Friendly Name)

Exchequer Source

Desciption

Category Code

stCode (where stType = 0, i.e. Group)

Unique identifier for the product category

Category Description

stDesc(1)

Human-readable name of the category

Parent Category

stParentCode

Establishes the category hierarchy


Invoices (Sales Invoices)

CRM Field (Friendly Name)

Exchequer Source

Description

Account Code

thAcCode (or from matched SOR)

Links invoice lines to the correct customer

Quote Reference

thLongYourRef (from matched SOR)

Links the invoice back to the originating CRM quote

Order Number

thOurRef (from matched SOR)

Links the invoice to the sales order

Customer Reference

thYourRef (or from matched SOR)

The customer's own purchase order reference

Delivery Reference

Parsed from line descriptions (SDN prefix)

Tracks which delivery note relates to the invoice line

Invoice Document

thOurRef

The unique Exchequer transaction reference for the invoice

Invoice Line

tlLineNo

Line number within the invoice

Invoice Number

thOurRef

Invoice number displayed to users

Product Reference

tlStockCode

Links the line to a product in the CRM

Product Description

tlDescr

Description of the product on this line

GL Code

tlGLCode

General ledger code for the invoice line

Department Code

tlDepartment

Department associated with the invoice line

Order Quantity

tlQty

Quantity ordered

Quantity Type

Derived from stock converter

Whether quantity is decimal or factor-based

Quantity Decimals

SystemSetup.ssQtyDecimals

Decimal places for quantity display

Quantity Factor

Derived from stock converter

Conversion factor for the quantity

Delivered Quantity

Same as tlQty

Quantity delivered (set equal to order qty for invoices)

Invoice Quantity

Same as tlQty

Quantity invoiced

Unit Price

tlNetValue

Net price per unit on the line

Sell Price Decimals

SystemSetup.ssSalesDecimals

Decimal places for selling prices

Cost Price

tlCost

Cost price for margin/profitability analysis

Cost Decimals

Derived from stock converter

Decimal places for cost price

Cost Value

Calculated from cost × qty

Total cost value for the line

Warehouse Code

tlLocation

Warehouse the stock was dispatched from

Currency Decimals

Hardcoded to 2

Decimal places for currency values

Base Currency Decimals

Hardcoded to 2

Decimal places for base currency values

Line Value (Net)

entLineTotal(True, 0)

Net total value of the invoice line

Line Value (Gross)

Net + tlVATAmount

Gross total including VAT

Base Value (Net)

Converted via entConvertAmountWithRates

Net value in base/home currency

Base Value (Gross)

Converted via entConvertAmountWithRates

Gross value in base/home currency

Invoice Date

thTransDate

Date the invoice was raised

Order Date

thTransDate (from matched SOR)

Date the original order was placed

Due Date

tlLineDate or thDueDate

Payment due date

Expire Date

tlUserField3 (if Service Contracts enabled)

Contract expiry date

Contract

tlUserField4 (if Service Contracts enabled)

Service contract reference

Ledger Account

thAcCode

The Exchequer account code on the transaction header

Currency Code

ssCurrency(tlCurrency).scSymbol

Currency symbol for the invoice line

Delivery Date

tlLineDate

Date of delivery for the line

Analysis Code 1

tlAnalysisCode

Analysis code for reporting/categorisation

Job Code

tlJobCode

Links the line to a job costing record

User Field 1

tlUserField1

Custom user-defined field from the transaction line

User Field 2

tlUserField2

Custom user-defined field from the transaction line

User Field 3

tlUserField3

Custom user-defined field from the transaction line

User Field 4

tlUserField4

Custom user-defined field from the transaction line

Extended Description

tlDescr (from extended description lines)

Additional descriptive text for the invoice line


Sales Credits

CRM Field (Friendly Name)

Exchequer Source

Description

GL Code

tlGLCode

General ledger code for the credit line

Department Code

tlDepartment

Department associated with the credit line

Credit Document

thOurRef

Unique Exchequer reference for the credit note

Credit Line

tlLineNo

Line number within the credit note

Invoice Number

thOurRef + "-" suffix

Links the credit to the original invoice

Order Number

thYourRef

Customer's reference / your ref on the credit

Product Reference

tlStockCode

Links the line to a product in the CRM

Product Description

tlDescr

Description of the credited product

Warehouse Code

tlLocation

Warehouse the credit relates to

Order Quantity

tlQty

Quantity being credited

Quantity Type

Derived from stock converter

Decimal or factor-based quantity

Quantity Decimals

SystemSetup.ssQtyDecimals

Decimal places for quantities

Quantity Factor

Derived from stock converter

Conversion factor

Delivered Quantity

Same as tlQty

Delivery quantity (mirrors order qty)

Invoice Quantity

Same as tlQty

Invoiced quantity for the credit

Unit Price

tlNetValue (negated)

Net price per unit (negated for credit)

Sell Price Decimals

SystemSetup.ssSalesDecimals

Decimal places for selling prices

Cost Price

tlCost (negated)

Cost price for the credited line

Cost Decimals

Derived from stock converter

Decimal places for cost

Cost Value

Calculated from cost × qty

Total cost value of the credit line

Line Value (Net)

entLineTotal(True, 0) (negated)

Net value of the credit line

Line Value (Gross)

Net + tlVATAmount (negated)

Gross value including VAT

Base Value (Net)

Converted via entConvertAmountWithRates

Net value in home currency

Base Value (Gross)

Converted via entConvertAmountWithRates

Gross value in home currency

Invoice Date

thTransDate

Date the credit was raised

Due Date

tlLineDate or thDueDate

Payment due date for the credit

Expire Date

tlUserField3 (if Service Contracts enabled)

Contract expiry date

Contract

tlUserField4 (if Service Contracts enabled)

Service contract reference

Account Code

thAcCode (or from matched SOR)

Links the credit to the correct customer

Ledger Account

thAcCode

Exchequer account code on the header

Currency Code

ssCurrency(tlCurrency).scSymbol

Currency symbol for the credit line

Customer Reference

thLongYourRef

Customer's PO reference

Quote Reference

thLongYourRef (from matched SOR)

Originating quote reference

Delivery Date

tlLineDate

Delivery date on the line

Analysis Code 1

tlAnalysisCode

Analysis code for reporting

Job Code

tlJobCode

Links the credit to a job costing record

Extended Description

tlDescr (from extended description lines)

Additional text for the credit line


Payments

CRM Field (Friendly Name)

Exchequer Source

Description

Invoice Number

thOurRef

Identifies which invoice the payment status relates to

Payment Due Date

thDueDate

The date by which payment is expected

Paid Flag

Derived from thTotals(4) (0 = Paid, else Unpaid)

Indicates whether the invoice has been fully paid


General Ledger

CRM Field (Friendly Name)

Exchequer Source

Description

GL Code

glCode

Unique general ledger account code

Description

glName

Human-readable name of the GL account

GL Type

glType (e.g. BalanceSheet, ProfitLoss, Control, Heading, CarryForward)

Classifies the type of GL account

Parent GL Code

glParent

Establishes hierarchy between GL accounts

Obsolete

glInactive

Flags inactive/obsolete GL accounts


Departments

CRM Field (Friendly Name)

Exchequer Source

Description

Department Code

cdCode

Unique department identifier

Description

cdName

Human-readable department name

Obsolete

cdInactive

Flags inactive/obsolete departments


Cost Centres

CRM Field (Friendly Name)

Exchequer Source

Description

Cost Centre Code

cdCode

Unique cost centre identifier

Description

cdName

Human-readable cost centre name

Obsolete

cdInactive

Flags inactive/obsolete cost centres


Warehouses

CRM Field (Friendly Name)

Exchequer Source

Description

Warehouse Code

loCode

Unique location/warehouse identifier

Warehouse Name

loName

Human-readable warehouse name

A default "Not Set" warehouse is always created, and if locations are disabled in Exchequer a "Total Stock" entry is added instead. WarehouseImportItem.vb:46-107


Jobs (Job Costing)

CRM Field (Friendly Name)

Exchequer Source

Description

Job Code

jrCode

Unique job identifier

Description

jrDesc

Human-readable job description

Parent Job Code

jrParent

Links to a parent job for hierarchy

Alternative Code

jrAltCode

Secondary/alternative job reference

Contact

jrContact

Contact person associated with the job

Manager

jrManager

Manager responsible for the job

Completed

jrCompleted

Whether the job has been completed

Start Date

jrStartDate

Planned or actual start date

End Date

jrEndDate

Planned or actual end date

Revised End Date

jrRevisedEndDate

Updated end date if the job has been rescheduled

Job Type

jrType

Numeric job type classification

Job Type Code

jrJobType

Code referencing the job type definition

Charge Type

jrChargeType

How the job is charged (e.g. fixed, time & materials)

SOR Number

jrSORNumber

Links the job to a Sales Order

Quoted Price

jrQuotePrice

The quoted price for the job

Quoted Currency

jrQuotePriceCurr (converted to symbol)

Currency for the quoted price

QS Code

jrQSCode

Quantity Surveyor / quote stage code

Status

jrStatus

Current status of the job

Customer Code

jrAcCode (if found as Customer)

Links the job to a sales ledger customer

Supplier Code

jrAcCode (if found as Supplier)

Links the job to a purchase ledger supplier

User Defined Fields 1–10

jrUserField1 through jrUserField10

Custom user-defined fields for flexible data capture


Division Contacts and Delivery Locations

When new divisions are created in the CRM from Exchequer, a contact record and a default delivery location are also imported.

Division Contacts

CRM Field (Friendly Name)

Exchequer Source

Description

Title

Parsed from acContact

Contact's title (Mr, Mrs, etc.)

Forename

Parsed from acContact

Contact's first name

Surname

Parsed from acContact

Contact's last name

Salutation

acContact (full name)

Full name used for correspondence

Email

acEmailAddr

Contact's email address

Role Code

From integration settings

Assigns the contact a role within the division

Division Delivery Locations

CRM Field (Friendly Name)

Exchequer Source

Description

Address Line 1

acDelAddress.Street1

First line of the delivery address

Address Line 2

acDelAddress.Street2

Second line of the delivery address

Town

acDelAddress.Town

Town/city of the delivery address

County

acDelAddress.County

County/region of the delivery address

Address Line 5

acDelAddress.PostCode

Additional address line

Postcode

acDeliveryPostCode

Postal/zip code for the delivery address

Country

acDelAddress.Country.cdName (if available)

Country for the delivery address

Did this answer your question?