Advanced Shipping Notice / Invoice
Description
This document details our STD output file for Advanced Shipping Notice/Invoice.
These can also be described as Shipping Notice/Advice and acronyms such as ASN, INV.
This document is flexible to the needs of the customer, if you require additional fields or field changes, please contact your Datapel Project Manager.
Detail Steps
tREMOTE Trans Header
Sales Order header information (One Header per file)
TAG NAME | TAG EXAMPLE | Description | Details | Size | Type |
NewDataSet | - | Required SCHEMA formatting for a Sale Order | Tag should be closed at end of file data | - | - |
tREMOTETransHeader | - | - | - | - | - |
DTD | EdifactV1 | Document Type | - | 50 | NVARCHAR |
RevisionNumber | 2 | Revision number if provided in incoming order | - | - | - |
GSIN | 000932784000123459 | Unique Shipment Number | Supplier GS1 number expanded to 9 places,Unique sale ID expanded to 7 places plus check digit. | 17 | LONG |
CurrencyCode | AUD | Currency Code of Order | - | 3 | NVARCHAR |
StoreCode | SYD | Location Ship From Code | Required but can be blank. Assigned as default location from WMS configuration | 50 | NVARCHAR |
PostingDate | 2009-04-29T10:12:20+ | DateTime of Transaction | Order Date. Suggested format YYYY-MM-DDTHH:MM:SS+ where T and + are separators and terminators | - | INT |
TransID | 164101 | Invoice Number | WMS Allocates an invoice number prior to shipping. | 8 | NVARCHAR |
TransDate | 2009-04-29T10:12:20+ | DateTime of Transaction | Order Creation Date | - | DateTime |
DueDate | 2009-04-29T10:12:20+ | DateTime Customer requires Despatch or Delivery | Promised Date - for matching against original order requested delivery date, sometimes supplier will change this if they cannot supply - 1/1/3000 = cannot supply order in full. | - | DateTime |
Salesperson | Long | Salesperson ID | Last name of Salesperson. If “DEFAULT”, substituted with default Salesperson | 52 | NVARCHAR |
CustomerID | 2 | Customer ID | MYOB CARD RECORD ID | - | INT |
CardIdentification | CUS0000001 | MYOB Card Identification or MYOB Tax ID | Card Identification of Billing Customer. | 16 | NVARCHAR |
SHIPCustomerID | 2 | Customer ID | Ship MYOB CARD RECORD ID | - | INT |
SHIPCardIdentification | CUS0000001 | MYOB Card Identification or MYOB Tax ID | Card Identification of Receiving Customer. | - | INT |
SaleType | D | D = Delivery Notice or ASN I = Invoice | D = Delivery Notice or ASN I = Invoice | 1 | NVARCHAR |
Special2 | 2000 | Customers Purchase Order No. | Original PO number (if in response to POA or SOC it will also contain -1 -2 -3 suffix) | 50 | NVARCHAR |
Notes | - | - | “Comment” field in Sale Order | 255 | NVARCHAR |
SaleNote | - | WMS Field Sale Notes | - | 2500 | NVARCHAR |
ShipNote | - | - | “Ship Note” field in WMS Sale Order | 200 | NVARCHAR |
Priority | - | Maps to WMS Order Priority HIGH, HOLD, LOW or as a number (0-3) | - | 1 | INT |
ShippingMethod | - | - | “Name of Method” or “Default” will use customer default shipping method | 255 | NVARCHAR |
ConNote | - | ConNote - Consignment Number | in most cases will be blank for this document as order has not shipped. | 50 | NVARCHAR |
OrderWeight | 15.85 | Total Order Weight (KG) | Two options are available, calculation based on per item weight that is held in a custom field in WMS or the Order weight field in the WMS | 20 | INT |
OrderQuantity | 15.23 | Total Order Quantity (Units) | Sum of Order Units | 20 | INT |
CubicVolume | .532 |
| Two options are available, calculation based on per item cubic m2 that is held in a custom field in WMS or the Order cubic in the WMS | 20 | INT |
TotalCartons | 15 | - | Unpalletized Box Total | 20 | INT |
TotalPallets | 1 | - | Pallets in shipment | 20 | INT |
ShippingCost | 0.00 | Ship Cost to customer | Generally 0.00 - customisations may be requested | - | DBL |
Sent2HostDateTime | 2008-04-30T17:02:11 | Optional DateTime of XML Emit | Used for logging | - | INT |
ReferralSource | - | ReferralSource - mapped to MYOB/WMS referral source descriptions | - | 32 | NVARCHAR |
UDF1 | a1b2text | Custom Data Field | - | 200 | NVARCHAR |
UDF2 | a1b2text | Custom Data Field | - | 200 | NVARCHAR |
UDF3 | a1b2text | Custom Data Field | - | 200 | NVARCHAR |
OriginalTransID | 164101 | - | Internal ref maps to SAL_EDItransid - will link all related PO documents together | 50 | NVARCHAR |
OriginalSaleType | S | T = Transfer S = Sale | - | 1 | NVARCHAR |
OrderResponseCode | 5 | Can be tailored to customer needs | STD response is Edifact when DTD is edifact | 50 | NVARCHAR |
/tREMOTETransHeader | - | - | - | - | - |
tREMOTETransSaleLines
Sale Order line information (multiple allowed)
TAG NAME | TAG Example | Description | Detail | Size | Type |
tREMOTETransSaleLines | - | - | Require SCHEMA formatting for each sale line | - | - |
SKU | 320 | Product Number | Required. | 50 | NVARCHAR |
Barcode | 93781385965 | Product Barcode | Barcode (normally CF1,CF2,CF3 or UDF1) as specified in MYOB | - | - |
SellUoM | EA | Selling Unit of Item | generally EA, CTN, CT, Box ETC | 5 | NVARCHAR |
SaleQty | 1 | Quantity Sold | Required (unless SaleUnitQty is populated). as Quantity Sold (eg. Piece) - 0 for Cancelled Lines - New Qty For Amended Lines | - | INT |
SaleUnitQty | 1 | Unit Sold | Required (unless SaleQty is populated. as Unit Sold (eg. Box) - 0 For Cancelled Lines - New QTY for Amended Lines | - | INT |
BOSaleQty | 14 | Quantity Backordered | not delivered amount per line | - | INT |
BOSaleUnitQty | 2.355 | Units Backordered | not delivered amount per line | - | INT |
SaleUnitAmountIncTax | 9.95 | Sale Unit Price | Required if . as per Agreed Unit Sale Price Inc Tax - field takes presidence over if populated | - | Float |
SaleUnitAmountExcTax | 9.95 | Sale Unit Price | Required if is Blank or NULL. as per Agreed Unit Sale Price Excl Tax | - | Float |
SaleTaxCode | N-T | Tax Code | if N or NULL then, sets exact Tax Code on sale | 3 | NVARCHAR |
SaleTaxRate | 10.00 | Tax Rate (in Percent value e.g 10.00%) | Ignored if match is found. if N and VAT<\TaxCode> <> existing Tax Code in MYOB or BOTH NULL then(10.00 for GST, 0 for N-T)(Auto calculates unit price = SaleUnitAmountIncTax / (1+(SaleTaxRate/100)) ) | - | Float |
SaleTaxUnitAmount | 0.90 | Tax Amount | If > 0, automatically changes Tax to GST for line item | - | Float |
SKUDescription | Clown Dots | Product Description | If blank allocates default item description | 255 | NVARCHAR |
DeliveryDate | 2013-08-09T00:00:00+ | Format will be YYYY-MM-DDT00:00:00+ | If provided this is the Expected delivery date of the line of the sale line (Calculation method = Look at date requested per line if available else check promised date, If promised date > Line date then Promised Date else Line Date.) | 20 | NVARCHAR |
BOSupplyETA | 2013-09-01T00:00:00+ | Format will be YYYY-MM-DDT00:00:00+ | If provided is the expected delivery date for the backordered items. (Calculation Method = If Backorder found then check Stock Item next ETA found in BST_UDF6 (format checked if isdate preferred format is YYYY-MM-DD) if > Today plus 14 days (Can be set by Supplier) then BST_UDF6 else Today Plus 14 Days. | 20 | NVARCHAR |
LineNote | May We have Blue Please | Additional Product Description | - | 200 | NVARCHAR |
JobCode | JobCode | Job Code (Must already be in the Job Code List to apply/ no new additions) | - | 50 | NVARCHAR |
JobNote | JobCodeNote | Additional Text Field | For Multi Store delivery orders and distribution centres this will contain the store Number | 250 | NVARCHAR |
SaleUnitDiscount | 25.50 | Discount - This is the discount percentage. | - | - | Float |
CurrencyCode | A | Set to A | - | - | - |
SaleLineNo | 1 | - | - | - | INT |
LineWeight | 4.25 | Combined weight of QTY of item on sale line | calculation of a custom field | 20 | INT |
LineCube | .026 | Combined Cubic m2 of QTY on Sale Line | calculation of a custom field | 20 | INT |
LineResponseCode | 5 | Can be tailored to customer needs | STD response is Edifact when DTD is edifact | 50 | NVARCHAR |
/tREMOTETransSaleLines | - | End Sale Line | - | - | - |
tREMOTETransBatch
Sale Line Batch/Box/SSCC Information (Multiple Lines per sale line)
TAG NAME | TAG Example | Description | Details | Size | Type |
tREMOTETransBatch | - | – | Schema Format Node | - | - |
SSCC | - | Unique Carton serial Number | Supplier GS1 number expanded to 7 places,Unique sale ID expanded to 7 places, box ID (numeric) expanded to five places plus check digit. | 20 | INT |
PalletSSCC | - | Unique Pallet Serial Number | Supplier GS1 number expanded to 7 places,Unique sale ID expanded to 7 places, Pallet ID (numeric) expanded to two places plus "000" plus check digit. | 20 | INT |
Batch | 54dt6y54f1g232f1g | The batch or serial number placed in the box | - | 200 | NVARCHAR |
PalletNumber | 01 | The pallet Identification Number | Numeric Only - 0 when Pallet not in use | 2 | INT |
BoxNumber | 001 | The box identification Number | Numeric only | 3 | INT |
BoxLabel | sd9854fAS | The box identification String | can be numerical or String when numerical can be used in SSCC otherwise we use count up 1+. | 200 | NVARCHAR |
BatchQty | 5 | Base Qty in Box | - | - | INT |
BatchUnitQty | 0.005 | Qty field / Item Sell UoM | example shown is where sell UoM is set to 1000 | - | Float |
PKGType | CTN | Package Type | Normally a fixed type CTN for non SSCC required customers or when box packing in use then CTN for palletized CTN (ID 1001,1002,2001 etc)and PLT for Full Pallets (1000,2000,3000 etc) | 20 | NVARCHAR |
/tREMOTETransBatch | - | - | Schema Node End | - | - |
tREMOTETransCustomer
Sale Order Customer / Shipping Information (One Node Per file)
TAG NAME | TAG Example | Description | Details | Size | Type |
tREMOTETransCustomer | - | – | Schema Format Node | - | - |
ShipToName | gtp test | SHIP TO Customer Name | Company or Last Name of Customer | - | - |
ShipToAddress1 | 174 Hampden Road | SHIP TO Address Line 1 | - | - | - |
ShipToAddress2 |
| Address Line 2 | - | - | - |
ShipToSuburb | NEDLANDS | SHIP TO Suburb | - | - | - |
ShipToPostCode | 6009 | SHIP TO Post Code | - | - | - |
FaxNo | - | Fax | - | - | - |
PhoneNo1 | 1300 856 533 1300 856 533 | Phone Contact | Optional | - | - |
PhoneNo2 | - | Phone Contact | - | - | - |
EmailAddress | Email Address | - | - | - | |
/tREMOTETransCustomer | - | - | Schema Node End | - | - |
Important Use TransCustomer to manually allocate shipping address. Primary billing information is assigned by CardIdentification in TransSaleHeader |
Related Information
XML Text Encoding Rules
Preferred encoding UTF-8:
The fields in the xml file should not use cdata and should not contain any of the following characters without encoding ~ < > & TAB CR LF ( ascii 10 / 13)
Special Characters
Characters used in programming should be encoded as below.
~ - ~tl~
< - ~lt~
”>” - ~gt~
& - ~am~
Chr(9) - ~09~
Chr(10) - ~10~
Chr(13) - ~13~
' Single quotes do not require any encoding.