Border Express offers a number of solutions allowing customers to electronically despatch
and label their freight. Implementing one or more of these solutions, customers are
guaranteed to be able to electronically despatch their freight through all areas of their
business. Consignments and labels can be generated in a customer’s warehouse, a
customer’s office environment, or even at a specified third party.
Border Express has the capability to receive files from our customers that can be directly
imported into our freight management system.
Our system facilitates consignment creation via either SFTP or API connection. The
specifications in this document relate to SFTP connection only. If you are interested instead
in an API integration for consignment creation, please contact Border Express integrations
team. Other API functionality such as tracking, POD retrieval, pickup bookings, and price
estimation are also available and can be used in conjunction with an SFTP consignment
integration. Please see our API documentation here for details. If the SFTP method will be
used you will be required to produce your own label which must include a BEX route code and
meet the other specifications outlined in this guide.
Our file format preference is XML however, if another file format is a requirement, please
discuss this with the Border Express Integrations team.
The file name needs to include your account code and the timestamp of the file generation.
An example of an accepted file name format is:
ACC01_202212324000123.xml
The table below provides details of the data fields we require in the manifest file. Please note
that fields that are marked as ‘Tag Required’ are not optional and the tag must be provided in
the file regardless of whether the field contains a value. Fields marked as ‘Value Required’
must contain valid data in that field for every manifest.
For enquiries, please contact the Border Express eBusiness Team:
\n\n\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"25479341","collectionId":"f5948eb0-2b04-47dc-85cd-ae15d3cf9f85","publishedId":"2s93z5AkQm","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2023-12-06T06:13:16.000Z"},"item":[{"name":"XML Field Specifications","item":[{"name":"Consignment Data Fields","item":[],"id":"082c0732-e27d-4b3c-bddb-57c34bb07493","description":"","_postman_id":"082c0732-e27d-4b3c-bddb-57c34bb07493"},{"name":"Consignment Note Load Details","item":[],"id":"ef32d2b0-58a4-4c77-a274-dee9f2658183","description":"","_postman_id":"ef32d2b0-58a4-4c77-a274-dee9f2658183"},{"name":"Logistic Unit Data Fields","item":[],"id":"d2db9363-4dd4-4839-a8ed-d94d8b84beed","description":"","_postman_id":"d2db9363-4dd4-4839-a8ed-d94d8b84beed"},{"name":"Dangerous Goods Details","item":[],"id":"fbe8a153-3efc-4ed1-b820-0c528514d100","description":"Email: integrations@borderexpress.com.au
\n
Phone: 1300 330 290
Please note, if the consignment does not contain Dangerous Goods, do not include the tags below.\n
\nIf the consignment contains Dangerous Goods, all of the tags below are required.
Consignment Prefix and Range: This is to ensure a unique consignment number and will be provided by Bex. Please use the assigned prefix in both testing and production.
\nPaperwork and labels: Must be provided to Border Express during the testing process for approval.
\n\n","_postman_id":"75a624e3-3ec0-41de-a1e9-544601f33494"},{"name":"Sample XML","item":[],"id":"b17ace9c-69c8-4b65-88ed-f3698f5f41b2","description":"NOTE:
\n
If you are providing a file spec where the data is not in the order as below you are also required to provide a field mapping with:
1. Order Number in File
2. Your data Field Name
3. Border Express Data Field
XML Files are not to contain the following prohibited characters as specified by the
International XML standard:
& < > ‘ “
\nFor more information, please refer to http://www.w3schools.com/xml/xml_syntax.asp
\n<Consignment>\n <ConsignmentNumber>AAAA000001</ConsignmentNumber>\n <ConsignmentDate>2022-12-31</ConsignmentDate>\n <SenderCode>ACC01</SenderCode>\n <SenderName>Example Company Name</SenderName>\n <SenderStreetAddress1>Unit 1 / 123 Test Street</SenderStreetAddress1>\n <SenderStreetAddress2>Extra address details</SenderStreetAddress2>\n <SenderSuburb>Melbourne</SenderSuburb>\n <SenderState>VIC</SenderState>\n <SenderPostcode>3000</SenderPostcode>\n <SenderReference>SENDREF1234</SenderReference>\n <SenderContact>John Smith</SenderContact>\n <SenderPhone>03 1234 1234</SenderPhone>\n <ReceiverReference>RECREF1234</ReceiverReference>\n <Pickup>Yes</Pickup>\n <Delivery>Yes</Delivery>\n <DangerousGoods>Yes</DangerousGoods>\n <ReceiverCode>REC01</ReceiverCode>\n <ReceiverName>Receiver Company Name</ReceiverName>\n <ReceiverStreetAddress1>321 Test Street</ReceiverStreetAddress1>\n <ReceiverStreetAddress2>Example Shopping Centre</ReceiverStreetAddress2>\n <ReceiverSuburb>Sydney</ReceiverSuburb>\n <ReceiverState>NSW</ReceiverState>\n <ReceiverPostcode>2000</ReceiverPostcode>\n <ReceiverContact>Bob Jones</ReceiverContact>\n <ReceiverPhone>02 1234 1234</ReceiverPhone>\n <Comments>Please ring the bell</Comments>\n <ChepPalletsTransferredToReceiver>3</ChepPalletsTransferredToReceiver>\n <LoscamPalletsTransferredToReceiver></LoscamPalletsTransferredToReceiver>\n <ChepPalletsTransferredToBorderExpress></ChepPalletsTransferredToBorderExpress>\n <LoscamPalletsTransferredToBorderExpress></LoscamPalletsTransferredToBorderExpress>\n <TransferDocketCHEP>CHEP1234</TransferDocketCHEP>\n <TransferDocketLOSCAM></TransferDocketLOSCAM>\n <ChargeTo>ACC01</ChargeTo>\n <DeliveryWindowDate></DeliveryWindowDate>\n <DeliveryWindowEndDate></DeliveryWindowEndDate>\n <ExpectedCost></ExpectedCost>\n <TotalWeight>600.00</TotalWeight>\n <TotalLineItems>3</TotalLineItems>\n <TotalUnits>3</TotalUnits>\n <FoodStuffs>No</FoodStuffs>\n <CarrierService>BEP</CarrierService>\n <LoadDetails>\n <NumberOfUnits>1</NumberOfUnits>\n <LogisticUnit>Pallet</LogisticUnit>\n <Weight>200</Weight>\n <Cubic>1.152</Cubic>\n <ItemReference>INV123456</ItemReference>\n <Length>1.20</Length>\n <Width>1.20</Width>\n <Height>0.80</Height>\n </LoadDetails>\n <LoadDetails>\n <NumberOfUnits>1</NumberOfUnits>\n <LogisticUnit>Pallet</LogisticUnit>\n <Weight>200</Weight>\n <Cubic>1.152</Cubic>\n <ItemReference>INV123456</ItemReference>\n <Length>1.20</Length>\n <Width>1.20</Width>\n <Height>0.80</Height>\n </LoadDetails>\n <LoadDetails>\n <NumberOfUnits>1</NumberOfUnits>\n <LogisticUnit>Pallet</LogisticUnit>\n <Weight>200</Weight>\n <Cubic>1.152</Cubic>\n <ItemReference>INV123456</ItemReference>\n <Length>1.20</Length>\n <Width>1.20</Width>\n <Height>0.80</Height>\n </LoadDetails>\n <LogisticUnitDetails>\n <Barcode>AAAABX00000000000001</Barcode>\n <Barcode>AAAABX00000000000002</Barcode>\n <Barcode>AAAABX00000000000003</Barcode>\n </LogisticUnitDetails>\n <DangerousGoodsDetails>\n <ShippingName>Lithium Ion Batteries</ShippingName>\n <Class>9</Class>\n <SubRisk></SubRisk>\n <UNNUMBER>3480</UNNUMBER>\n <PackagingGroup></PackagingGroup>\n <TypeOfPackage>Carton</TypeOfPackage>\n <NoOfPackages>10</NoOfPackages>\n <AggregateQuantity>5</AggregateQuantity>\n <DGContactName>Bob Jones</DGContactName>\n <DGContactPhone>02 1234 1234</DGContactPhone>\n </DangerousGoodsDetails>\n</Consignment>\n\nCode-128
Logistic Unit Barcodes must be supplied in the Code-128 symbology. All non-GS1 customers must use Code-128. Code-128 covers all numbers, letters, and symbols.
The barcode value can be created by inserting our BEX identifier code (‘BX’) between the ConPrefix and ConRange, with a 3-digit unit number appended to the end. Barcodes must be 20 characters long.
To achieve a 20-character length, add the number of zeroes required after ‘BX’.
\nBEX Barcode Number Formula: ConPrefix + ‘BX’ + 00000 + ConRange + Unit Number
\n_
\nExample: Consignment# EGGS000429 with 1x logistic unit
\nBarcode Formula EGGS + ‘BX’ + ‘00000’ + 000429 + ‘001’__Unit Barcode# EGGSBX00000000429001
\nGS1-128
\nGS1-128 Barcode format is a subset of the Code-128 symbology and is maintained as a global standard by GS1.
\nYou must become a GS1 member to use GS1 barcodes.
\nQuiet Zone
The right and left ends of the barcode symbol. If the margin is not wide enough, scanning may be affected resulting in unstable scan results.
_Magnification_____The barcode itself will ideally have dimensions of 130mm x 40mm. This is referred to as 100% Barcode Magnification.
There is an allowable magnification range of 51% to 100%
Route Codes
The route code is the 3-letter abbreviation which informs the freight sorters where to route the freight. For custom/inhouse produced labels, we will provide a list of Route Codes by Suburb & Postcode. Route code listings can also be obtained via our API, which eliminates the need for manual updates.
Service Type
3-letter abbreviation to indicate the method of shipping, i.e., PAR/Parcel, BUL/Bulk, ECM/eCommerce
Best Practice
\n§ Clean and maintain your label printer regularly
\n§ A dark barcode on a light background is essential
\n§ The package must be in its' finished form before the barcode is applied
\nWhat Not To Do
\n§ Barcodes should not be wrinkled, creased, folded or placed on the package in a manner that may adversely affect barcode scanning/reading
\n§ When re-using a box, remove all labels and stickers. Ensure that the box is in good shape and not worn out
\n§ Do not use substandard or damaged packaging
\n§ Do not apply barcodes with print quality issues
\nIntroduction
\nHaving a valid delivery address is a critical factor when it comes to providing the best possible delivery service. The purpose of the address is to convey accurately, sufficient information to enable both our drivers, and our IT systems to identify the correct pickup or delivery location the first time, every time. Please ensure that addresses for all freight consignments follow these requirements:
\nAddress Fields
\n· Address fields are provided for ADDRESS information ONLY. No other type of information is to be in these fields. Where additional delivery instructions are required they MUST be entered in the appropriate field (Comments/Special Instructions).
\n· An address is NOT to include: Opening Times, Phone Numbers, Peoples Names, Attention: as there are other fields appropriate for this information i.e. Comments/Receiver Phone/Receiver Contact/etc.
\n· Where possible, we need the delivery address which is sometimes different to the mailing address (i.e. the loading dock may be off a street at the rear of the property).
\n· The first address line may contain shop/factory/unit details but if you wish to add more information (i.e. shopping centre name) then put the actual street address in line 2.
\n· The second address line must only contain a street number, name and type (e.g. 135 High Street)
\n· Do not punctuation (i.e. commas, colons, etc. in an address).
\n· The correct suburb, state and postcode are vital as there are many suburbs in Australia with the same name.
\n· We do not deliver to Post Office boxes (PO Box), Roadside Mail Boxes (RMB), parcel lockers or Lot Numbers. Only valid street addresses.
\n· Address MUST contain sufficient information to unambiguously identify the correct location.
\nStreet Numbers
\n· Must be present.
\n· Must not contain other number decoration like \"No.\" or \"#\"
\n· If there is a range of numbers then they SHOULD be separated by a hyphen.
\n· If subdivided then additional sub division must come after the numeric component.
\n· For example: 75a Ogilvie Street
\n· LOT/subdivision numbers are NOT RECOMMENDED and MUST NOT be used where street numbers have been assigned.
\nSub Street Numbers
\n· Shop, Factory, or Unit numbers MUST be separated from the Street Number. The RECOMMENDED separator is the oblique slash \"/\".
\n· For example: Unit 1 / 130 Puckle Street
\nStreet Name
\n· One, two or three street names are valid, any more creates an invalid address.
\n· Multi word street names may be separated by hyphens or space.
\n· For Australia, street names are always spelt in words, never numbers.
\n· For example: ALWAYS \"Tenth St NEVER \"10th St.
\n· Directional indicators are allowed after street types \"NORTH\", \"SOUTH\", \"EAST\", or \"WEST\"
\n· Additional \"helper\" street addressing is NOT RECOMMENDED.
\n· In the example: \"Cnr Ballarat Rd (Western Hwy) & Butler Streets\" the \"(Western Hwy)\" information is unnecessary and should not be provided.
\n· Use gazetted street names ONLY. Not the name the “locals” know.
\nStreet Type
\n· MUST be spelt correctly with only the acceptable abbreviation list provided.
\n· MUST be provided for every street name.
\n· Commonly used street types and their appropriate abbreviations are listed below:
\nCorners
\n· Corner addressing for either cross roads, or T intersections are NOT RECOMMENDED as it does not uniquely identify the delivery location. Where possible provide the actual street number and street name.
\n· Corners of more than two streets are NOT supported.
\nSuburb
\n· MUST be present and correct for the street, and postcode. Vanity suburb names are NOT RECOMMENDED.
\nPostcode
\n· MUST be valid for the delivery location. Not all assigned Postcodes are valid (e.g. Mail Centres (MC), Military Post Offices (Milpo).
\nAddress Examples:
\nAcceptable Variations:
\nBuilding / Complex Sub Unit - Must be followed by a space and then the number:
\nYour assistance in providing a valid address will assist greatly in Border Express continuing to provide great service.
\nMore Information:
\nFor more information on this subject, please contact the Border Express Integrations team via Integrations@borderexpress.com.au.
\n","_postman_id":"89aa1e4a-42b2-424f-a41b-669e7d99d585"}]}