|
Order Importer Field
|
Sage Field
|
Description
|
Data Type
|
Size
|
Required
|
CustomerID
|
ACCOUNT_REF
|
Used as a unique identifier to identify individual customer accounts
|
text
|
8
|
Yes
|
CompanyName
|
NAME
|
The customers company name
|
text
|
60
|
No
|
ContactName
|
CONTACT_NAME
|
The customers contact name
|
text
|
30
|
No
|
Address1
|
ADDRESS_1
|
Customer Address Details
|
text
|
60
|
No
|
Address2
|
ADDRESS_2
|
Customer Address Details
|
text
|
60
|
No
|
Town
|
ADDRESS_3
|
Customer Address Details
|
text
|
60
|
No
|
County
|
ADDRESS_4
|
Customer Address Details
|
text
|
60
|
No
|
PostCode
|
ADDRESS_5
|
Customer Address Details
|
text
|
60
|
No
|
CountryCode
|
COUNTRY_CODE*
|
Country code for the customer's country of origin
|
text
|
2
|
No
|
Telephone
|
TELEPHONE
|
Customers telephone number
|
text
|
30
|
No
|
Fax
|
FAX
|
Customers fax number
|
text
|
30
|
No
|
EmailAddress
|
E_MAIL*
|
Customers email address
|
text
|
255
|
No
|
VatNumber
|
VAT_REG_NUMBER*
|
Customers V.A.T. registration number
|
text
|
30
|
No
|
SageAccount**
|
ACCOUNT_REF
|
Sage Customer Account Number
|
text
|
8
|
No
|
Currency***
|
CURRENCY
|
Customers Currency
|
number
|
N/A
|
No
|
TermsAgreed
|
TERMS_AGREED_FLAG
|
Terms Agreed
|
true / false
|
N/A
|
No
|
Discount
|
N/A
|
Percentage of discount to apply all the customers orders
|
number
|
N/A
|
No
|
* Only used when creating a new customer in Sage, these fields are not used on Invoices or Sales Orders
** The SageAccount if supplied will override the CustomerID value and be used by Order Importer to find existing customers in Sage, if not supplied the CustomerID will be used for this.
*** The value passed in for the Currency must be the numeric number shown in the leftmost column of the Sage currencies list.
|
|
Order Importer Field
|
Sage Field
|
Description
|
Data Type
|
Size
|
Required
|
OrderID*
|
CUST_ORDER_NUMBER
|
Used as a unique identifier to identify individual orders
|
numeric
|
N/A
|
Yes
|
CustomerID
|
ACCOUNT_REF
|
Used to identify the customer the order is associated with
|
text
|
8
|
Yes
|
DelCompanyName
|
DELIVERY_NAME
|
Delivery Address Company Name
|
text
|
60
|
No
|
DelContactName
|
DELIVERY_NAME (only if DelCompanyName is empty)
|
Delivery Address Contact Name
|
text
|
60
|
No
|
DelAddress1
|
DEL_ADDRESS_1
|
Delivery Address Details
|
text
|
60
|
No
|
DelAddress2
|
DEL_ADDRESS_2
|
Delivery Address Details
|
text
|
60
|
No
|
DelTown
|
DEL_ADDRESS_3
|
Delivery Address Details
|
text
|
60
|
No
|
DelCounty
|
DEL_ADDRESS_4
|
Delivery Address Details
|
text
|
60
|
No
|
DelPostCode
|
DEL_ADDRESS_5
|
Delivery Address Details
|
text
|
60
|
No
|
DelCountry
|
NOTES_1
|
Delivery Address Details
|
text
|
60
|
No
|
OrderDate
|
ORDER_DATE
|
The date the order was received
|
date
|
N/A
|
No
|
Carriage
|
CARR_NET
|
Shipping costs
|
numeric
|
N/A
|
No
|
CarriageTaxCode
|
CARR_TAX_CODE
|
Tax code to apply to shipping costs
|
numeric
|
N/A
|
No
|
CcNumber**
|
NOTES_2
|
Credit card: number
|
text
|
60
|
No
|
CcCardType**
|
Credit card: type (visa, mastercard)
|
text
|
No
|
CcNameOnCard**
|
Credit card: name on card
|
text
|
No
|
CcIssueNo**
|
NOTES_3
|
Credit card: Issue Number
|
text
|
60
|
No
|
CcAuthCode**
|
Credit card: Authentication/Security code
|
text
|
No
|
CcValidFrom**
|
Credit card: From date
|
text
|
No
|
CcValidTo**
|
Credit card: To date
|
text
|
No
|
ContactName***
|
CONTACT_NAME
|
Contact name of customer
|
text
|
30
|
No
|
Address1
|
ADDRESS_1
|
Customer address details
|
text
|
60
|
No
|
Address2
|
ADDRESS_2
|
Customer address details
|
text
|
60
|
No
|
Town
|
ADDRESS_3
|
Customer address details
|
text
|
60
|
No
|
County
|
ADDRESS_4
|
Customer address details
|
text
|
60
|
No
|
PostCode
|
ADDRESS_5
|
Customer address details
|
text
|
60
|
No
|
CompanyName***
|
NAME
|
Customers company name
|
text
|
60
|
No
|
Telephone
|
CUST_TEL_NUMBER
|
Customer telephone number
|
text
|
30
|
No
|
Taxable
|
N/A
|
Used to control whether tax (V.A.T.) applies to an order
|
true / false
|
N/A
|
No
|
OrderTakenBy
|
TAKEN_BY
|
Name of person that took the order
|
text
|
60
|
No
|
GlobalNominalCode
|
GLOBAL_NOM_CODE
|
Global Nominal Code
|
text
|
4
|
No
|
CarriageNominalCode
|
CARR_NOM_CODE
|
Carriage Nominal Code
|
text
|
4
|
No
|
BankAccount
|
BANK_CODE
|
Use to specify a bank account
|
text
|
4
|
No
|
InvoiceSOPType
|
On an Invoice
INVOICE_TYPE_CODE
(On an SOP)
ORDER_TYPE
|
Used to specify the Invoice/Order Item Type.
Product Invoice
Sales Order
Service Invoice
Product Credit Note
Service Credit Note
Product Invoice Proforma
Product Invoice Quotation
Service Invoice Proforma
Service Invoice Quotation
Sales Order Quotation
Sales Order Proforma
|
numeric or text
|
N/A
|
No
|
DespatchDate****
|
DESPATCH_DATE
|
Use to specify a Despatch Date on a sales order
|
date
|
N/A
|
No
|
InsertAs*****
|
N/A
|
Use to specify whether to save the order to Sage as an Invoice, Sales Order or Purchase Order, valid values are:
Invoice
SOP
POP
|
text
|
N/A
|
No
|
PaymentRef
|
PAYMENT_REF
|
Use to specify a payment reference
|
text
|
30
|
No
|
PaymentType
|
PAYMENT_TYPE
|
Use to specify a payment type
|
numeric
|
N/A
|
No
|
GlobalTaxCode
|
GLOBAL_TAX_CODE
|
Use to specify a global tax code
|
text
|
2
|
No
|
SageSupplierAcc+
|
PURCHASE_REF (Product only)
|
Use to specify the sage supplier account ref used by all products within the order that get added to sage.
|
|
8
|
|
Courier
|
COURIER
|
Use to specify a carrier.
|
numeric
|
N/A
|
No
|
ConsignmentNo
|
CONSIGNMENT_REF
|
Use to specify the carrier Consignment/tracking number.
|
text
|
30
|
No
|
CarriageDeptNumber
|
CARR_DEPT_NUMBER
|
Use to specify a Carriage department.
|
numeric
|
3
|
No
|
GlobalDeptNumber
|
GLOBAL_DEPT_NUMBER
|
Use to specify a Global department
|
numeric
|
3
|
No
|
Discount
|
N/A
|
Percentage of discount to apply all items in the order
|
numeric
|
N/A
|
No
|
DiscountAmount******
|
N/A
|
Literal value of discount to apply all items in the order
|
numeric
|
N/A
|
No
|
* If Sage is left handling the creation of order numbers the OrderID from your data is saved in the Sage field “CUST_ORDER_NUMBER”, if you have selected “Use MY Own Order Numbers” in the job wizard then OrderID from your data is also used as the order number by Sage.
** These fields are stored in the NOTES_2 and NOTES_3 Sage fields because there is no place else to store this information, the data is stored in the following format:
NOTES_2: CcNameOnCard, CcNumber, CcCardType
NOTES_3: CcIssueNo, CcAuthCode, CcValidFrom, CcValidTo
*** If Company name is defined this is saved to the Sage NAME field, if no company name is defined then the contact name is saved to the Sage NAME field.
**** Valid use for Sales Orders only, Despatch Date will be ignored when saving as an Invoice.
***** If the InsertAs field is not defined for any orders within the import data the setting defined in Order Importer will be used, the InsertAs field in your import data if defined overrides the setting defined in Order Importer.
****** The Discount field will take priority if both the Discount & DiscountAmount fields are defined.
+ These fields are only used when a product is added to sage.
|
|
Order Importer Field
|
Sage Field
|
Description
|
Data Type
|
Size
|
Required
|
OrderID*
|
INVOICE_NUMBER
|
Value used to link the item to its parent order
|
numeric
|
N/A
|
Yes
|
ProductCode
|
STOCK_CODE
|
The part number of the product
|
text
|
30
|
Yes
|
Description
|
DESCRIPTION
|
A description of the product
|
text
|
60
|
Depends***
|
Details
|
TEXT
|
A long description used on service items (ItemType=2)
|
text
|
N/A
|
No
|
Quantity
|
QTY_ORDER
|
The amount of units ordered
|
numeric
|
N/A
|
Yes
|
Price
|
UNIT_PRICE
|
The unit price of the product
|
numeric
|
N/A
|
Depends***
|
TaxCode**
|
TAX_CODE
|
The sage tax code to use, T1, T2 etc
|
numeric
|
N/A
|
No
|
Comment1
|
COMMENT_1
|
A comment about the ordered item
|
text
|
60
|
No
|
Comment2
|
COMMENT_2
|
A comment about the ordered item
|
text
|
60
|
No
|
ItemType
|
ITEM_TYPE
|
0=Stock Item
1=Non-Stock
2=Service Item
|
numeric
|
N/A
|
No
|
Weight
|
UNIT_WEIGHT
|
Items unit weight
|
numeric
|
N/A
|
No
|
Location
|
LOCATION
|
Location
|
text
|
16
|
No
|
NominalCode
|
NOMINAL_CODE
|
Product nominal code
|
text
|
4
|
No
|
DeptNumber+
|
DEPT_NUMBER
|
Department Number
|
numeric
|
N/A
|
No
|
Category+
|
STOCK_CAT
|
Category
|
numeric
|
N/A
|
No
|
SageSupplierAcc+
|
PURCHASE_REF
|
Supplier Account Ref
|
text
|
8
|
No
|
Discount
|
DISCOUNT_RATE, ADD_DISC_RATE
|
Percentage of discount to apply to the item
|
numeric
|
N/A
|
No
|
DiscountAmount****
|
DISCOUNT_AMOUNT
|
Literal value of discount to the item
|
numeric
|
N/A
|
No
|
BarCode
|
PRODUCT_BARCODE
|
Product Bar Code
|
text
|
60
|
No
|
TaxAmount
|
TAX_AMOUNT
|
The tax value for the line item
|
numeric
|
N/A
|
No
|
ExternalOrderReference
|
EXT_ORDER_REF
|
External Reference for SOP to INV Link
|
text
|
30
|
No
|
JobReference
|
JOB_REFERENCE
|
Job Reference
|
text
|
20
|
No
|
* Will only be used within Sage If Sage is not handling the creation of order numbers due to you having selected “Use MY Own Order Numbers” in the job wizard.
** The TaxCode value is ignored if the parent orders taxable field is set to false.
*** Fields that have their required status listed as "Depends" are technically required but can be omitted for your import data in if certain conditions are met, for example if you have Order Importer configured to get missing product data from sage you can omit the Description and/or Price fields from the import data.
The Discount field will take priority if both the Discount & DiscountAmount fields are defined.
+These fields are only used when a product is added to sage.
|