ExpressConnect Pricing Integration Guide Express Connect Shipping V3.8
User Manual: Pdf
Open the PDF directly: View PDF 
.
Page Count: 160
| Download | |
| Open PDF In Browser | View PDF |
ExpressConnect Shipping Integration Guide Version 3.8 Revision History Date Version Description 12/09/2016 3.0 RIH New version of technical user guide for ExpressConnect Shipping after major technical improvements 31/03/2017 26/04/2017 26/07/2017 3.1 RIH 3.2 RIH 3.3 RIH Updated to include section on CData entry. Include additional error messages for cut off times. Correct MOD7 rules and field validation lengths 26/07/2017 3.4 RIH Added additional information on “No Data Received at gateway from Client” 18/08/2017 3.5 BL Added php example 24/08/2017 3.6 RIH Updates based on customer feedback 06/09/2017 3.7 RIH Updates with additional based on customer feedback 27/11/2017 3.8 RIH Improvements to example xml Table of Contents 1. Introduction 6 1.1 Legend 7 1.2 Activities/functional features 8 1.3 Booking and Shipping failures 10 2. Registration 11 3. Making a request to the TNT server 12 4. Example XML Ship requestdocument 13 5. Input XML format 17 5.1 Header 5.2 Login 5.2.1 Interface / APPVERSION 5.3 Consignment Batch 5.4 Sender 5.4.1 The sender address and contact elements 5.4.2 The Collection element 5.4.2.1 The Collection address element 5.4.2.2 The Collection/Opening times details 5.5 Consignment 5.5.1 The ConRef element 5.5.2 The Receiver address element 5.5.3 The Delivery address element 5.6 The CONNUMBERelement 5.7 The CUSTOMERREF element 5.8 The CONTTYPE element 5.9 The PAYMENTIND element 5.10 The ITEMS element 5.11 The WEIGHT and VOLUME elements 5.12 The CURRENCYand GOODSVALUE elements 5.13 The INSURANCE CURRENCYand VALUE elements 5.14 The SERVICE element 5.15 The OPTIONelement 5.16 The DESCRIPTIONelement 5.17 The DELIVERYINST element 5.18 The Dangerous Goods elements 5.18.1 The PACKAGE element 5.18.1.1 The ARTICLE element 5.19 ACTIVITY Elements 5.19.1 Create Elements 5.19.2 Ship Elements 5.19.3 RATE Elements 5.19.4 BOOK Elements 5.19.5 PRINT Elements 18 18 19 20 21 22 23 23 24 25 25 26 26 27 27 27 28 29 29 30 30 30 31 31 31 32 33 34 35 35 36 36 37 38 5.19.6 SHOW_GROUPCODE Elements 39 6. Processing the XML Response 40 6.1 Processing the RESULT XML Response 41 6.1.1 CREATE response element 6.1.2 RATE response element 6.1.2.1 RATE response element – UK Domestic 6.1.2.1.1 generatedByName, generatedById, requestDateTime and quoteReference elements 6.1.2.1.2 TheavailableCollectionDate element 6.1.2.1.3 The collectionDepot, ratingDepot, accountName, divisionNumber, noteType, enhancedLiabilityIndicator, options, bookingStatus and quoteComment elements 6.1.2.1.4 TheavailableDeliveries section 6.1.2.1.5 TheratedServices and ratedService sections 6.1.2.1.6 Thesurcharges sections 6.1.3 BOOK response element 6.1.4 SHIP response element 6.1.5 PRINT response element 43 44 44 46 46 46 47 47 48 49 49 50 7. Shipping Documentation responses 51 7.1 Development your own solution 52 7.2 Using the TNT stylesheets in an XML compliant browser 53 7.3 Producing HTML with a compliant XML / XSL parser 54 7.4 Documentation requirement rules 55 7.5 Consignment Note 56 7.6 Address labels 61 7.7 Detail Manifest 67 7.8 Summary Manifest 72 7.9 Commercial invoice 73 8. Errors 78 8.1 Application generated errors 8.1.1 Request errors 8.1.2 XML errors 8.1.3 Validation errors 8.2 Table of application generated error codes, messages and resolutions 78 78 78 79 80 9. Connecting to ExpressConnect Shipping 97 9.1 VB Script sample 99 9.2 VB.net CONNECTION CODE EXAMPLE 105 9.3 JAVASCRIPT CONNECTION CODE EXAMPLE 107 9.4 C# EXAMPLE 109 9.5 C# EXAMPLE 111 9.6 PHP Example 114 10. Appendix A: XML elements definition (input) 116 11. Appendix B: XSD Data Types 132 11.1 Custom Data Types 132 12. Appendix C MANDATORY FIELDS (INPUT XML) 134 13. Appendix D DATA RULES (INPUT XML) 136 14. Appendix E: ISO 3166-1 Alpha-2 Country Codes 138 15. Appendix E: VAT codes 146 16. Appendix F - Example Booking confirmation from backend systems 148 17. Appendix G - Advanced Shipping Notification 149 18. Appendix H – Returns Paperwork 150 19. Appendix I – Modulus 11 or 7 Check Digit 151 19.1 Modulus 11 Check Digit 151 19.2 Modulus 7 Check Digit 153 20. Appendix J – Group Codes 154 21. Appendix K – Security/connectivity requirements 156 22. Appendix L – First Time Trader Requirements 157 23. Appendix M – XML markup Language characters 158 24. Appendix N – Dangerous Goods processing 159 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 1.Introduction ExpressConnect Shipping is part of the ExpressConnect family, providing B2B interfaces into TNT's operational and financial systems. The ExpressConnect Shipping interface is used to arrange a collection, rate a consignment and print the associated shipping documentation. This manual provides a technical guide to the ExpressConnect Shipping interface. It is designed to help developers understand the interface sufficiently to program an application to arrange a collection with TNT.With the use of XML (extensible mark-up language) technology, this will provideshipping functionality for multiple consignment submissions. The majority of examples in the document will be XML based as it is easier to understand the data involved. Return data from TNT will be formatted as XML, again in a predetermined structure. When this data is returned to a client, they may parse it for storage or presentation, as they require. An ExpressConnect Login Id will be arranged by your TNT representative. The customer must supply a list of valid TNT accounts numbers to be used with the system. A secure connection is thus set up, using both authentication and secure protocols, to submit requests and to receive processed CONSIGNMENT labels based on the published URL: https://express.tnt.com/expressconnect/shipping/ship Sample scripts are provided to show how a connection can be achieved together with example requests and responses to illustrate the data required; see Connecting to ExpressConnect Shipping. Consideration is given below to the networking and security requirements to ensure that this is successful. This document is structured as follows: • • • • • • • • Registration Making a request to the TNT server Example XML Shipping Request Document Input XML Format - the structure and content of the request Processing the response - information about the data that will be returned Errors - possible error messages and the steps you can take to resolve them Connecting to ExpressConnect Shipping Appendices Page 6 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 1.1Legend The following conventions have been used throughout this document. Normal Code [0..1] xsd:string … The majority of text in this document is in this style. Section in this style are part of the narrative of the document Sections or words in this text indicate a section of XML, XML element, or section of code. Digits within square brackets indicate the number of times an element may occur in an XML document. Examples include: [1] The element must appear once in the document [0..*]. The element may appear once, many times (unlimited) or not at all. [0..1] The element is optional. If it appears, it must appear only once. [1..5] The element may appear any number of times between 1 and 5 times This indicates one of the schema types, in this case a string. More information on defined schema data types can be found at http://www.w3.org/TR/xmlschema-2/#built-in-datatypes Means that the section has been omitted for the sake of clarity. This usually means that the omitted elements are described elsewhere or that the section where they appear is a repetition of a previous stanza. For example:Page 7 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 1.2Activities/functional features This web service offers collection booking and shipping functionality for single or multiple consignment submissions available. Consignments may be created on the system, and then the details later accessed, using the created consignment numbers in order to carry out various activities, such as rating, booking, and printing. The XML format required for these options is shown later. Consignments can also be batched, according to their group code, and be booked together or printed as one summary manifest. The five possible activities are: Create This stores the consignment on the ExpressConnect Shipping database for a period of one week. Consignments can then be referred to by consignment number in later processing. A Consignment Numbers will be returned for each successful consignment creation. Ship This activity allows the customer to send their consignment information directly into TNT’s back end shipping management systems without the need for a collection request. This is especially useful for customers who have a regular collection arranged with TNT, and therefore do not need to raise a separate collection request each time they submit data through Express Connect. The 12 … tag is only valid for the V2.2 and above versions of the interface. Rate Using the same functionality as ExpressConnect Pricing, rates will be returned for the submitted consignments. A rate is the projected cost of sending a consignment via TNT for a given service. You will usually have a number of options with regards to the level of service you require for sending a consignment. Rating a consignment will return a rate for all available services unless a specific service is specified. The RATE activity is used to provide an estimated cost for the delivery of the consignment. Book Once the consignment details are complete, the consignments are sent up to the central booking system and a success/fail message returned. If the customer name and account details are not recognized then a First Time Trader flag will be returned, warning the customer to expect security checks (see appendix I for details). Consignments can be batched for booking by including the group code for the group of consignments. In order to test booking without sending data to the TNT backend systems and actually creating a real booking it is possible to request a test id for your company in addition to the live userid. Two different confirmations are available. ExpressConnect can be set up to provide an email to confirm it has received and processed information; this is on a per userid basis. And the TNT booking system can send an email to the sender/collection email address provided in the input XML to confirm the actual booking in the backend systems together with the actual booking reference number. Page 8 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 When a customer requests a shipment using v2.2, they may also specify an additional attribute to the tag called ShowBookingRef. 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 YOUR USERID YOUR PASSWORD EC 2.2 Sender Co 01-008 TEST DO NOT COLLECT1 TEST DO NOT COLLECT2 TEST DO NOT COLLECT3 Atherstone Warwickshire CV9 2ry GB 987654321 Mr Contact 01827 717733 contact@tnt.com Collection Name TEST DO NOT COLLECT4 TEST DO NOT COLLECT5 TEST DO NOT COLLECT6 Atherstone Warwickshire CV9 1TT GB Mr Contact 00000 700005 contact@tnt.com 15/08/2016 09:00 10:00 11:00 12:00 use rear gate 01-008 ref01_008 Continued belowReceiver Name Page 13 of 160 Express ICS,TEST DO2017 NOT COLLECT7 TEST DO NOT COLLECT8 TEST DO NOT COLLECT9 Amsterdam 1012 AA NL VAT-0123 Mr Bob ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016ref01_008 Receiver Name TEST DO NOT COLLECT7 TEST DO NOT COLLECT8 TEST DO NOT COLLECT9 Amsterdam 1012 AA NL VAT-0123 Mr Bob 1672 987432 email@tnt.com Delivery Name TEST DO NOT COLLECT10 TEST DO NOT COLLECT11 TEST DO NOT COLLECT12 Amsterdam 1012 AA NL VAT-0123 Mr Frank 1672 987432 email@tnt.com DISKS N S 6 3.6 1.0 GBP 180.00 150.00 GBP 15N assorted office accessories Delivery Instructions TEST 3 box 1 0.1 Continued below0.2 0.3 0.4 1 paperclips .03 2.30 metal paperclips ABC GB 3 Page 14 of 160 Express ICS, 2017box 2 0.5 0.6 0.7 0.8 1 paperclips ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/20163 box 1 0.1 0.2 0.3 0.4 1 paperclips .03 2.30 metal paperclips ABC GB 3 box 2 0.5 0.6 0.7 0.8 1 paperclips .03 2.30 metal paperclips ABC GB ref01_008 Continued belowref01_008 ref01_008 ref01_008 Express ICS, ref01_008 ref01_008 ref01_008 bob.hitchens@tnt.com bob.hitchens@tnt.com Page 15 of 160N.B. XML is case sensitive. The element tags MUST all be upper case. ExpressConnect encoding must be UTF-8, encoding="UTF-8". Page 16 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.Input XML format The input XML format for ExpressConnect Shipping is a list of consignment requests. The structure for a Ship request is described below in detail. Alternatively, refer to Appendix A which contains a summary of the points below. Note It should be noted that XML defines a number of characters which are reserved. These include the greater-than (>), less-than (<), ampersand (&), and percent (%) characters. Where these appear in the data which is being submitted to ExpressConnect, the characters must be escaped or the content surrounded with a CDATA section. A common requirement is to submit an address which includes a company name such as: "Andrews & Plummer". The ampersand must therefore be escaped as per the XML rules (&) or alternatively the whole or part of the text must be wrapped in a CDATA section as follows: … ref01_008 ref01_008 ref01_008 ref01_008 ref01_008 ref01_008 ref01_008 bob.hitchens@tnt.com bob.hitchens@tnt.com The request has the following structure: • • • • Header – always required, this defines the XML document Login – always required, this provides the security details Consignment batch – always required, this contains the: o Sender – always required, this defines the document o Ship request– A list of The shipment date is the date which you wish the parcels to be collected, and it must be supplied in the format DD/MM/CCYY. It is a mandatory field. Collections is raised for every consignment (with exception of customers with scheduled collection). The earliest time the goods may be collected (Goods ready time) should be supplied in the “PREFCOLLECTTIME” / “FROM” element, in the format HH:MM. The latest time the goods can be collected must be supplied in the “PREFCOLLECTTIME” / “TO” element, in the format HH:MM. If your company has a lunchtime, them please supply the morning opening times in the PREFCOLLECTTIME” element and the afternoon opening times in the “ALTCOLLECTTIME”. These details are validated against the time the TNT truck will be within your area and these times must overlap. Please supply any special instruction which need to be passed to the collection driver in theelements for which this sender is sending consignments for. Normally there is just one. Activity – always required, this provides details on which functionality is required. Page 17 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.1Header The header section will begin every ExpressConnect Shipping request XML document submitted to TNT. This contains the XML declaration, which contains the character encoding used for the document and the standalone attribute, which should be set to “no”: 5.2Login Each LOGIN element contains the following information: All elements are mandatory. It contains a COMPANYelement which should contain your username as supplied by your TNT Representative. ThePASSWORDelement contains the associated password for this use. Failure to provide correctinformationwill result in an invalid request. The APPIDelementshould be defaulted to “IN”, unless it has been previously agreed with your TNT Representative to use an alternative APPID. This elementis used by various source applications to highlight where the request was made, it has no bearing on the functionality offered. The YOUR USERID YOUR PASSWORD IN 2.2 element states the version of the interface that you are using. Your TNT Representative should provide the version number that you should use when you start your engagement. Page 18 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.2.1Interface / APPVERSION ExpressConnect Shipping supports various version of the XML interface. This document will refer to different versions and the examples will often apply to the version the feature was introduced. You should use the latest version of the interface where possible, unless indicated to do so by your TNT Representative. The existing version are: Version 2.0 Comments When you use the BOOK activity this will automatically perform both a Booking and shipping activity. The SHIP activity is not supported. 2,1 Improved validation, which in version 3.0 release has been made backwardly compatible to version 2.0. 2.2 Introduction of the SHIP activity to allow you to manage when you wish to create a collection request separately from passing the shipping data to TNT. The SHIP activity allows you to send your consignment information directly into TNT’s back end shipping management systems without the need for a collection request. When a customer requests a shipment using v2.2, they may also specify an additional attribute to the tag called ShowBookingRef. Setting the ShowBookingRef attribute to ‘Y’ will, when a collection request is raised successfully in TNT’s collection booking system, return the booking reference number within the tag. 3.0 Introduction of the Division element, which allows selection of services for a particular TNT divisions. The support for supports Hazardous Goods has been increased. Please see Appendix N – Dangerous Goods processing Page 19 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.3Consignment Batch Each Consignment Batch element contains the following information: … A CONSIGNMENTBATCH contains a single SENDER element, which contains details about the sender and collection. A CONSIGNMENTBATCHcontains 1 or more CONSIGNMENTelements. This allows batching of Shipping requests. Each CONSIGNMENTelement contains the set of information needed to perform the functionality requested in the Activities element. A CONSIGNMENTelement contains a keyattribute that identifies it uniquely within the request. The response will associate Shipping data and validation errors with their ACTIVITY through this key. The value of this key must be of type string and is supplied in CONREF element. Page 20 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.4Sender There is a single SENDER element per consignment Batch, and contains the following information: … … … The SENDERis made up of the following parts. Except where noted, every element is required once. Page 21 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.4.1The sender address and contact elements … Sender Co 01-008 TEST DO NOT COLLECT1 TEST DO NOT COLLECT2 TEST DO NOT COLLECT3 Atherstone Warwickshire CV9 2ry GB 987654321 Mr Contact 01827 717733 contact@tnt.com Collection Name TEST DO NOT COLLECT4 TEST DO NOT COLLECT5 TEST DO NOT COLLECT6 Atherstone Warwickshire CV9 1TT GB Mr Contact 00000 700005 contact@tnt.com 15/08/2016 09:00 10:00 11:00 12:00 use rear gate 01-008 Sender Co 01-008 TEST DO NOT COLLECT1 TEST DO NOT COLLECT2 TEST DO NOT COLLECT3 Atherstone Warwickshire CV9 2ry GB 987654321 Mr Contact 01827 717733 contact@tnt.com … The sender element represents your company address and contact information. These sections contain the following elements, all of type string: • • • • • • • • • • • • The name of company at the given premises addressLine1 is the first line of the address. This line usually contains a building name or number Address lines 2 and 3 are optional. They may contain additional information to help locate the address The city for the address The province is also known as the region or county. The postcode of the address The ISO 3166-1 Alpha-2 country code. More information can be found in Appendix F: ISO 3166-1 Alpha 2 country codes Your TNT account as supplied by your TNT representative, 9 digits for standard account and 10 digits for UK domestic.The account number must be authorised to be used by the userid and password supplied in the LOGIN element. Your VAT number.More information can be found in Appendix G: VAT codes The name of the contact The contacts telephone number made up of the area code and phone number. The contacts email address. The Advance shipper notification emails will be sent to the contacts email address is supplied. To ship with TNT, we must know the exact location that you are shipping to/from, in TNT terms. The full town name must be supplied using TNT spelling. Please work with your TNT representative to ensure your town names match TNT’s.If the town contains local characters, then it is recommended to use these. For example, Köln Page 22 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.4.2The Collection element The collection element contains the Collection address and booking details. 5.4.2.1The Collection address element The collection address provides the address details from which consignment will be collected by our driver This should only be supplied if it differs from the sender address. As the definition for the all address are identical, please refer to The sender address and contact elementsPage 23 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.4.2.2The Collection/Opening times details The order must be made before the cut-off time for arranging a collection for the shipping date (collection date). … Collection Name TEST DO NOT COLLECT4 TEST DO NOT COLLECT5 TEST DO NOT COLLECT6 Atherstone Warwickshire CV9 1TT GB Mr Contact 00000 700005 contact@tnt.com 15/08/2016 09:00 10:00 11:00 12:00 use rear gate 01-008 element. Page 24 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.5Consignment There can be one to 50 CONSIGNMENT elements per consignment Batch but it is recommended that no more than 3 CONSIGNMENT elements are supplied, unless you have set a large timeout period. The element contains the following information: 5.5.1The ConRef element A CONSIGNMENT element contains a key attribute that identifies it uniquely within the request. The response will associate Shipping data and validation errors with their ACTIVITY through this key. The value of this key must be of type string and is supplied in CONREF element. ref01_008 … … DISKS N S 6 3.6 1.0 GBP 180.00 150.00 GBP 15N assorted office accessories Delivery Instructions TEST … … ref01_008 Page 25 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.5.2The Receiver address element The receiver address provides the address details of the company receiver the consignment. As the definition for the all address are identical, please refer to The sender address and contact elements5.5.3The Delivery address element The delivery address provides the address details for which consignment will be delivered by our driver This should only be supplied if it differs from the receiver address. As the definition for the all address are identical, please refer to The sender address and contact elements Receiver Name TEST DO NOT COLLECT7 TEST DO NOT COLLECT8 TEST DO NOT COLLECT9 Amsterdam 1012 AA NL VAT-0123 Mr Bob 1672 987432 email@tnt.com Page 26 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.6The CONNUMBERelement This element contains your consignment number, if your application generates its own TNT consignment number. Delivery Name TEST DO NOT COLLECT10 TEST DO NOT COLLECT11 TEST DO NOT COLLECT12 Amsterdam 1012 AA NL VAT-0123 Mr Frank 1672 987432 email@tnt.com GE100312111WW You userid must be configured to allow user generated consignment numbers and so contact your TNT representative to arrange for this feature. 5.7The CUSTOMERREF element This element contains your consignment reference. This will be printed on the shipping documentations and can be used to track your consignment.DISKS 5.8The CONTTYPE element This element identify whether you are shipping a “D” Document (paper/manuals/reports) or “N” Non-document (packages).N Document services are not offered for a number of TNT domestic shipments. For domestic shipment within these countries please use a CONTYPE of “N” for Non-document. Page 27 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.9The PAYMENTIND element This identifies whether this is an import (receiver pays) or export (sender pays) shipment.S Figure 18 A PAYMENTIND type of “S” represents a sender pays shipments, “R” represents a receiver. If this element is not supplied, then the payment type is defaulted to sender. Within ExpressConnect shipping there is limited support for ‘Receiver pays’ shipments. In order to create a receiver pays shipment you must first register the following details with TNT: 1. Theand combinations that you would like activated for receiver pays. This need to be added to our database and associated with your userid and password before receiver pays is activate for these accounts. The TNT representative will arrange this. Once the above details have been registered, simply amend the following in the INPUT XML to send a receiver pays shipment: i. Within the DETAILS parent element set the field to ‘R’: R ii. Within the SENDER parent element enter the sender’s account in thefield: 111 iii. Within the RECEIVER parent element add 2 additional tags for the receiver’s account and account country:Page 28 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.10The ITEMS element This element will contain the number of items within the shipment. Receivers Co. Ltd. Head Office Hoofddorp Amsterdam 1100 KG NL Mr Frank 39 203 987432 FrankA@rec.com 123 NL 1 Figure 15 This is a mandatory element. The ITEMS element should match the total number of items defined in the packages elements. 5.11The WEIGHT and VOLUME elements These elements describe the total weight and volume of the consignment being shipped.3.6 1.0 Figure 13 TheWEIGHTelement contains the total weight of the shipment in Kilograms and is a mandatory element. The VOLUME element contains the total volume of the shipment in cubic metres and is a mandatory element for Non-documents, CONTYPE = ‘N’. These totals should match the sum of the weights and volume supplies in the packages elements. The totals from the PACKAGE elements will be used if greater that the consignment supplied totals. Page 29 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.12The CURRENCYand GOODSVALUE elements These elementidentifies the value of the goods being shipped and the associated currency.GBP 180.00 The currency is represented by the 3 digit ISO 4217 Alpha-3 currency codes. The value of goods must be supplied if you wish to insures the shipment. 5.13The INSURANCE CURRENCYand VALUE elements These elements are for Enhanced Liability in countries where insurance is not available.150.00 GBP Insurance value MUST NOT be more than 110% of the goods value for non-documents or 500 Euros for documents. The maximum insurance value is 25,000 Euros. 5.14The SERVICE element The particular service that the shipment is being moved under.09N The values in this section will be provided by your TNT representative. Page 30 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.15The OPTIONelement Please specify any additional Service options that are required for this Shipment. There can be up to 5 options supplied, if insurance has not be specified. The values in this section will be provided by your TNT representative. 5.16The DESCRIPTIONelement Please describe the consignment goods being shipped. This is not used for custom purposes.assorted office accessories For UK domestic shipments, the Carton Code is populated from the first 2 characters of the description. This must be used to attract the correct rate when invoicing the consignment for Palletised goods. 5.17The DELIVERYINST element Please supply any instructions that must be passed to the TNT delivery driver when delivering the consignment.Delivery Instructions TESTY 1845 II For UK dangerous domestic shipments, the UN Number must be supplied in the first 4 characters of the DELIVERYINST, as well. For International shipments please ensure the appropriate option code is also supplied. Please refer to the TNT terms and conditions for further information on Dangerous/Hazard. If you are approved to ship dangerous goods please supply an associated UN number. UN numbers are four-digit identifiers for hazardous/dangerous substances, and articles (such as explosives, flammable liquids, toxic substances, etc.). If you wish to obtain an estimate cost for the shipment please contact your TNT representative as Rating for dangerous goods is not supported via ExpressConnect Shipping. It is the shipper’s responsibility to identify, classify, package, mark, label, and complete documentation for dangerous goods according to all national and international governmental regulations. Page 32 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.18.1The PACKAGE element The PACKAGE element provides details on the package line. There must be at least one Package per Consignment when entered in detail form. There may not be more than 50Packages per Consignment when entered in detail form with no more than 99 items for a consignment..At least one package MUST exist per consignment, UNLESS the consignment is internal to the EU The PACKAGE element describes a group of parcels (package) with the same details and dimensions. must be identical. All parcels The ITEMS is the total number of parcels and each one will need to be label. DESCRIPTION describes the package. The LENGTH, HEIGHT and WIDTH are supplied in meters. The WEIGHT is in Kilos. As a standard the following maximums are applied Max weight per package Max length per package Max height per package Max width per package 70kg 2.4m 1.5m 1.2m On request, these limits can be raised for each customer. If this is required, please contact your TNT representative who will arrange this for you. Page 33 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.18.1.1The ARTICLE element If the consignment is customs controlled, you should supply details on the article / goods being shipped. 3 box 1 0.1 0.2 0.3 0.4 1 paperclips .03 2.30 metal paperclips ABC GB Articles are not mandatory and there can be no more than 99Articles elements per Package. 9999 items per article line. There can be up to The 1 paperclips .03 2.30 metal paperclips 123456 GB contains details on the country of original manufacture. This is an ISO 3166-1 Alpha-2 country code. More information can be found in Appendix F: ISO 3166-1 Alpha 2 country codes. For each article you need to capture the Tariff code.A tariff code is a product-specific code as documented in the Harmonised System (HS) maintained by the World Customs Organisation (WCO). Tariff codes exist for almost every product involved in global commerce.The Harmonized Item Description and Coding System (HS) is an international standard maintained by the World Customs Organization (WCO) that classifies traded products. Items are identified by a 6-digit harmonized number that is recognized by countries that have adopted the harmonized system. The Tariff code is supplied in the element. None of the values entered into the Items fields will be validated against the number of packages/articles submitted with a consignment, the customer is responsible for making these values correspond if desired. Page 34 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.19ACTIVITY Elements This element allows you to state what you wish to do with the data you have passed in this call or passed previously to TNT. 5.19.1Create Elements This stores the consignment on the ExpressConnect Shipping database for a period of one week. A Consignment Number will be returned for each successful consignment creation. ref01_008 ref01_008 ref01_008 ref01_008 ref01_008 ref01_008 ref01_008 bob.hitchens@tnt.com bob.hitchens@tnt.com You may create up to 50 consignments in a single call but due to response times and timeouts it is recommended that you process a maximum of 3 create per call.The same is true for all activities. You must state the unique key ref01_008 supplied in the element to identify which consignment you wish to create. You must supply a for all consignmentsthat you require processing. Page 35 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.19.2Ship Elements To use the SHIP activity, the order must have previously been successfully created, using the CREATE activity. These activities can be performed in the same call. The SHIP activity allows you to send your consignment information directly into TNT’s back end shipping management systems without the need for a collection request. Please note that the elements are mandatory and so need to be supplied even if using just the activity. This is especially useful if you are on a regular collection and so not need to raise a separate collection request each new consignment, submitted through Express Connect. The ref01_008 tag is only valid for the V2.2 and above versions of the interface. If you have created the consignment in a previous call or you use your own consignment number, you can ship using a unique consignment number. In order to test shipping without sending data to the TNT backend systems and actually creating a real consignment it is possible to request a test id for your company in addition to the live userid. 5.19.3RATE Elements Using the same functionality as ExpressConnect Pricing, you can request an indicative rate for your consignment. A rate is the projected cost of sending a consignment via TNT for a given service. You will usually have a number of options with regards to the level of service you require for sending a consignment. GE889350673NL Again, if you have created the consignment in a previous call or you use your own consignment number, you can ship using a unique consignment number. ref01_008 Page 36 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.19.4BOOK Elements This element allows you to arrange a collection for your parcels. You can book a batch of consignments using the group code or Individual consignments using either the GE889350673NL or . For more information on the group code please refer to Appendix I – Group Codes. Two different confirmations are available. ExpressConnect can be set up to provide an email to confirm it has received and processed information; this is on a per userid basis. The TNT booking system can send an email to the sender/collection email address provided in the input XML to confirm the actual booking in the backend systems together with the actual booking reference number. When a customer requests a shipment using v2.2, they may also specify an additional attribute to the tag called ShowBookingRef. Setting the ShowBookingRef attribute to ‘Y’ will, when a collection request is raised successfully in TNT’s collection booking system, return the booking reference number within the ref2 tag. The element EMAILREQD which holds a character either 'Y' or 'N' indicating that a booking confirmation email is required or not. The default value is “N”. It normally takes approximately 1 hour before this email is generated by the appropriate TNT booking application. Please see Appendix F - Example Booking confirmation from backend systems In order to test booking without sending data to the TNT backend systems and actually creating a real booking it is possible to request a test id for your company in addition to the live userid. Page 37 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.19.5PRINT Elements There are four shipping documents available for each submitted consignments: Consignment Note (Con note), (address) label, commercial invoice and manifest. These will be returned with a style sheet, viewable as a document in your web browser. The manifest that is printed can take the form of a summary manifest if the group code is used, as opposed to the individual consignment numbers or references. The XML data returned is the same for the manifest and summary manifest, but with a different XSL style sheet specified in the processing instruction. For more information on the group code please refer to Appendix I – Group Codes. It is also possible for the printed documentation to be sent as HTML files to a given email address, using the email from and to elements. This allows you specify the email sender to imply it is generated from your application. This is useful when arranging consignments to be collected from a different site to the ExpressConnect installation. Please refer to Appendix H – Returns Paperwork ref2 Again, if you have created the consignment in a previous call or you use your own consignment number, you can print using a unique consignment number. To generate all possible shipment documents please specify the ref 1 ref 1 ref 1 bob.hitchens@tnt.com bob.hitchens@tnt.com element. Please refer to Shipping Documentation responses for more information on the shipment documents. Page 38 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 5.19.6SHOW_GROUPCODE Elements To display the groupcode in the output XML (For further information on Group codes see Appendix I – Group Codes). ref 2 Page 39 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 6.Processing the XML Response You will be returned an access code and your code needs to take this access code and send it back as part of a character string into the TNT server - in exactly the same way that you sent the XML document. The character string you send it in will depend upon which XML document you wish to retrieve. The options using the example access key ‘12345’ are: GET_RESULT:12345 GET_CONNOTE:12345 GET_LABEL:12345 GET_MANIFEST:12345 GET_INVOICE:12345 So, if you require the consignment note XML you will actually be sending through the socket the message: “xml_in=GET_CONNOTE:12345” The XML files are stored on the TNT ExpressConnect server for a period of 26 days, if later retrieval is necessary. For the Create, Rate, Ship and Book activities, the return data will be contained within one XML document – “RESULT”. This will also contain which and whether a shipping document has been successfully created. The Print XM, to allow you to generate the shipping documentation will be contained without their own XMLdocuments, retrieve as above. Please refer to Shipping Documentation responses on how to process the shipping document XML returns. Page 40 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 6.1Processing the RESULT XML Response The XML document contains whether an activity was successful or failed. The 1736 ref01_008 GE000003364GB Y ref01_008 15N Express Insurance GBP 996.61 Y ref01_008 GE000003364GB Y Y ref01_008 GE000003364GB Y CREATED CREATED CREATED element is using is group code process, for more information on group codes please refer to Appendix J – Group Codes. Page 41 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 You may also receive a run time error: If the validation fails, the reason will be supplied: The request to ExpressConnect Shipping has failed. Please contact your local service centre for further assistance For input string: "sion="1.0" encoding="UTF-8" standalone="yes"?> " login details not recognised Please refer to Errors for more information. Page 42 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 6.1.1CREATE response element The create element must be success to allow any other activity to be performed. 301Receiver company name must be entered Consignment reference: ref01_008 The ref01_008 GE000003364GB Y identifies which consignment was created and the response includes the unique consignment number. Page 43 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 6.1.2RATE response element The RATE element returns the indicative price for the shipment.. The price list element will contain a result. The rate identified supplied by the customer is returned along with the service and options codes/descriptions, rate (excluding V.A.T.) and a result code. If the result code is N then no rate was available for that service. 6.1.2.1RATE response element – UK Domestic UK Domestic RATE requests return additional information on the rate.. ref01_008 15N Express Insurance GBP 996.61 Y on> 10.210.137.238 10.210.137.238 1608-000000 2016-08-11T00:00:00 false 051 JOHN GOOD LTD 010 3 false CF QuoteViaWeb Generated via Web Request 2016-08-12T00:00:00 1 1EXPRESS D Continued below89.41 true Page 44 of 160 Express ICS, 20170.00 CF CF Surcharge 5.00 D Residential Supplement - delivery 2.00 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/20162016-08-12T00:00:00 1 1EXPRESS D 89.41 true 0.00 CF CF Surcharge 5.00 D Residential Supplement - delivery 2.00 8 Express Index 5.75 G 2012 CPI Supplement 3.60 J 2013 CPI Supplement 2.70 K 2014 CPI Supplement 1.90 M 2015 CPI Supplement 1.00 2016-08-12T00:00:00 true AM12:00 EXPRESS D 97.09 true 0.00 .... 2016-08-12T00:00:00 false ... Page 45 of 160 Express ICS, 2017 5.00 D Residential Supplement - delivery 2.00 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 6.1.2.1.1generatedByName, generatedById, requestDateTime and quoteReference elements The generatedByName, generatedById, requestDateTime and quoteReference, are used to uniquely identify the rating response. 10.210.132.246 10.210.132.246 2012-07-27T08:56:16 1207-000200 6.1.2.1.2TheavailableCollectionDate element The next available collection date after the supplied shipping date will be returned in the availableCollectionDate element2012-07-27T00:00:00 The date format is CCYY-MM-DD. 6.1.2.1.3The collectionDepot, ratingDepot, accountName, divisionNumber, noteType, enhancedLiabilityIndicator, options, bookingStatus and quoteComment elements There are a number of elements that have been retained in the interface for backward compatibility or to be used within TNT solutions using the same interface, they should not be coded into the user solution. These elements provide information on the shipment based on the supplied input.051 Fredrick Bloggs Ltd. 010 3 false CZ QuoteViaWeb Generated via Web Request Page 46 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 6.1.2.1.4TheavailableDeliveries section There is an availableDeliveries section for each delivery date based on the services determined that the user may select to delivery the shipment based on the details supplied. Normally there will be one section returned for the next working day. This section contains all the serviced that can be used to delivery on this date, these are detailed in the ratedServices.6.1.2.1.5TheratedServices and ratedService sections The ratedServices section can contain up to 10 ratedService elements. Each service that can be rated and is feasibility used to delivery the shipment described in the price check. 2012-07-30T00:00:00 1 … …Page 47 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 The service code and description are returned in the code and description elements. The charge amount is in Pound sterling, as is the discount that has been provided. The delivery date format is CCYY-MM-DD 6.1.2.1.6Thesurcharges sections The surcharges section can contain up to 10 surcharges that applies to this shipment. 1 1EXPRESS D 90.71 true 0.00 … 2012-07-30T00:00:00 true … …The surcharges category, associate description, charge code and where appropriate commodity code are returned for each rated service. The charge amount is in Pound sterling. Page 48 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 6.1.3BOOK response element This element highlights whether the book activity was successful or failed. By setting the ShowBookingRef attribute to ‘Y’ in the request, and if the collection request is raised successfully in TNT’s collection booking system, the return the booking reference number will be returned within the CZ CFwd and Hazardous Supplement 41.00 ELCF Enhanced Liability with CF 3.00 D Residential Supplement - delivery 7.50 8 Express Index 11.11 tag. This is not available for UK domestic bookings. Please refer to Appendix L – First Time Trader Requirements for more information on the ref2 GE857115020GB Y Y CVT 803567 element. 6.1.4SHIP response element This element highlights whether the Ship activity was successful or failed. Page 49 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 6.1.5PRINT response element This element highlights which shipping documents are available ref01_008 GE000003364GB Y Page 50 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 7.Shipping Documentation responses If a print request is successfully processed, XML documents will be created and should be retrieved by the customer using the access key. This XML can be printed by either writing print software using the data inside the XML or by simply parsing the XML documents with a suitable parser that conforms to the standards recommended by the W3C (World Wide Web Consortium). The printed documentation is created using stylesheets. An XSL (Extensible Stylesheet Language) stylesheet processor accepts a document or data in XML referencing an XSL stylesheet and presents that XML source content as intended by the said stylesheet. Three methods of producing the documentation are possible. • • • Development your own solution Using the TNT stylesheets in an XML compliant browser Producing HTML with a compliant XML / XSL parser The current TNT document stylesheets can be located at: https://express.tnt.com/expresswebservices-website/stylesheets/HTMLConsignmentNoteRenderer.xsl https://express.tnt.com/expresswebservices-website/stylesheets/HTMLAddressLabelRenderer.xsl https://express.tnt.com/expresswebservices-website/stylesheets/HTMLManifestRenderer.xsl https://express.tnt.com/expresswebservices-website/stylesheets/HTMLSummaryManifestRenderer.xsl https://express.tnt.com/expresswebservices-website/stylesheets/HTMLCommercialInvoiceRenderer.xsl Page 51 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 7.1Development your own solution By implementing the XML/XSL standards, TNT has divorced the data from the presentation, for enhanced flexibility and platform neutrality. If you wish to produce the required documentation through your own software solution, then please note that the formats must conform to the standards implemented by TNT. Your documentation will need to be passed to your local TNT representative for approval by TNT operations. It is possible to host certain elements, for example stylesheets, on the client server. This is not recommended as it means that the locally held elements will need to be refreshed in the event of changes being made to the centrally held item. Page 52 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 7.2Using the TNT stylesheets in an XML compliant browser Producing the documentation using this option is by far the easiest to adopt, because TNT have already done the work of creating the presentation. Simply open the returned print XML, as an .xml file in the browser and the documentation will be automatically rendered. Each XML print document will contain a reference to an XSL stylesheet held on the TNT webservers e.g. The second line tells the XML browser that there is a stylesheet designed to process and format the XML for display or print. The ‘href’ provides the address of the stylesheet and the ‘type’ tells the browser that the stylesheet is written in XSL. Page 53 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 7.3Producing HTML with a compliant XML / XSL parser If you use a browser other than IE or another XML supporting browser, then the XML can still be parsed with the stylesheets to produce HTML. This can then be rendered in any version 3.0+ browser supporting JavaScript. The most compatible method of producing the HTML is using the Microsoft MSXML parser. This is the internal COM parser used within IE. It is however available in a free redistributable version, from the Microsoft web site, additional information can be found at. https://msdn.microsoft.com/en-us/data/bb190600.aspx Other parsers are available from IBM and Datachannel, both supporting the W3C DOM. IBM’s browser is available at http://www.ibm.com XML4J – a platform independent parser written in Java XML4C – another IBM parser written in C++ Datachannel, who originally wrote the Microsoft parser also produce an XML parser available for download at http://www.datachannel.com Page 54 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 7.4Documentation requirement rules There are four shipping documents that can be produced. These are described below with ‘rules’ for their production – required information and suggested layout. If unsure as to which documents are required, the customer has the option of passing in the conrefs/consignment numbers in the CREATED CREATED CREATED element. This will then return documents based on the rule table below: Required Documents ConsignmentType Document Non-Doc Non-Doc Origin and destination countries both within the EU? N/A Y N Documents to be printed Labels, connotes, manifest Labels, manifest Labels, connotes, manifest, commercial invoice The (commercial) invoice is the primary document required by the Customs officials dealing with international transactions.It is used as a customs declaration provided by the person or corporation that is exporting an item across international borders. Most large export companies have their own invoice and it is recommended that they use theirs, but ExpressConnect Shipping will provide one if required. Please note that it is also hereby certified and agreed that, as TNT Express (including any other carrier involved in the transportation of the goods) does not have any possibility to control the accuracy of the information displayed on the commercial invoice, theshipper, consignee and buyer release TNT Express from all and any liability in connection with said information (including but not limited the declared value of the shipped goods) and agree to indemnify and hold TNTExpress harmless from any and all claims, actions and judgment incurred in connection therewith. Page 55 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 7.5Consignment Note A consignment note is a document that functions as a receipt for the goods to be shipped, and as evidence of the contract of carriage by setting out the rights and obligations of the consignor and the carrier, as well as placing limitations on the carrier’s liability for loss, damage or delay to the goods. It is not a document of title to the goods. The xml response for the consignment note can be retrieve in Java script using // Retrieve Consignment note xml_in = 'GET_CONNOTE:'+AccessCode; var ConNoteXML=SendXml(xml_in); and has the following structure: Page 58 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 When the xml is “Viewed” in a browser they appear like this (International): Page 59 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 If producing your own, they must contain all the information shown on the templates above, both on the receiver copy and on the customs copy.. If you create your own documentation it must be signed off by operations, your TNT representative can arrange this for you. Page 60 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 7.6Address labels To be attached to the package/s out for collection. Allows barcode scanning and tracking of consignments during delivery movement. It is recommended to use a routing label which can be produced using an alternative Webserver Expresslabel, access and assistance this can be arranged by your TNT representative. Further details can be found at: https://express.tnt.com/expresswebservices-website/app/routinglabelrequest.html The xml response for the label can be retrieve in Java script using // Retrieve label xml_in = 'GET_LABEL:'+AccessCode; var LabelXML=SendXml(xml_in); and has the following structure: /barbecue/barcode?type=code39&height=70&width=1&data= https://express.tnt.com /expresswebservices-website/rendering/images 15/08/2016 CV9 2ry UNITED KINGDOM 01827 717733 contact@tnt.com 987654321 Continued below. Page 56 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 CV9 1TT UNITED KINGDOM 00000 700005 contact@tnt.com N 1012 AA NETHERLANDS 1672 987432 email@tnt.com VAT-0123 Continued below. Page 57 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 1012 AA NETHERLANDS 1672 987432 email@tnt.com VAT-0123 1.0 1.4 N GE000003143GB 15N Express 150.00 2 180.00 PR Priority GBP GBP S ref01_008 ABC Page 64 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Viewed in the browser, the standard label appear like this: Page 65 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Below is an example of a UK domestic label: If producing your own, they must contain all the information shown below. If you create your own it must be signed off by operations, your TNT representative can arrange this for you. Page 66 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 7.7Detail Manifest The manifest is the form that lists the consignments traveling on a particular mode of transport on a particular date. The xml response for the detail manifest can be retrieve in Java script using // Retrieve manifest xml_in = 'GET_MANIFEST:'+AccessCode; var ManifestXML=SendXml(xml_in); and has the following structure: /barbecue/barcode?type=code39&height=70&width=1&data= http://gblabvl45.gb.tntpost.com:9082 /expresswebservices-website/rendering/images 15/08/2016 CV9 2ry UNITED KINGDOM 01827 717733 contact@tnt.com 987654321 Continued below. Page 61 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 CV9 1TT UNITED KINGDOM 00000 700005 contact@tnt.com N 1012 AA NETHERLANDS 1672 987432 email@tnt.com VAT-0123 Continued below. Page 62 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 1012 AA NETHERLANDS 1672 987432 email@tnt.com VAT-0123 1.0 1.4 N GE000003143GB 15N Express 150.00 2 180.00 PR Priority GBP GBP S ref01_008 ABC box 1 10.0 Continued20.0 30.0 0.4 3 0.019 1 2 2127 Page 63 of 160 Express ICS, 20172.30 1 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 box 1 10.0 20.0 30.0 0.4 3 0.019 1 2 2127 2.30 1 0.03 ABC GB box 2 50.0 60.0 70.0 0.8 3 0.63 2 2 2128 2.30 1 0.03 ABC GB Page 70 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Viewed in the browser it appears like this: Page 71 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 7.8Summary Manifest The summary manifest lists all of the consignments traveling on a particular mode of transport on a particular date, as a part of a batch. Viewed in the browser it appears like this: Page 72 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 7.9Commercial invoice The seller issues a commercial invoice to the buyer stating the cost of the goods being supplied plus any other charges that might be involved, e.g. insurance, freight. This type of invoice is raised when a commercial transaction has taken place. One commercial invoice is produced per consignment. The xml response for the Commercial Invoice can be retrieve in Java script using // Retrieve Invoice xml_in = 'GET_INVOICE:'+AccessCode; var INVOICEXML=SendXml(xml_in); and has the following structure: /barbecue/barcode?type=code39&height=70&width=1&data= http://gblabvl45.gb.tntpost.com:9082 /expresswebservices-website/rendering/images 15/08/2016 CV9 2ry UNITED KINGDOM 01827 717733 contact@tnt.com 987654321 Continued below. Page 67 of 160 Express ICS, 2017 CV9 1TT ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016CV9 1TT UNITED KINGDOM 00000 700005 contact@tnt.com N 1012 AA NETHERLANDS 1672 987432 email@tnt.com VAT-0123 Continued below. Page 68 of 160 Express 1012 AA NETHERLANDS ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 1012 AA NETHERLANDS 1672 987432 email@tnt.com VAT-0123 1.0 1.4 N GE000003143GB 15N Express 150.00 2 180.00 PR Priority GBP GBP S ref01_008 ABC box 1 10.0 Continued below.20.0 30.0 0.4 3 0.019 1 2 2127 Page 69 of 160 Express 2.30 1 0.03 ABC GB ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016box 1 10.0 20.0 30.0 0.4 3 0.019 1 2 2127 2.30 1 0.03 ABC GB box 2 50.0 60.0 70.0 0.8 3 0.63 2 2 2128 2.30 1 0.03 ABC GB Page 76 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Viewed in the browser it appears like this: Page 77 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 8.Errors There are a number of different errors that may occur when using ExpressConnect Shipping. Many of these are likely to be encountered in the initial development phase and are concerned with the format of the XML message and the presence of data items. The remaining messages are concerned with validation of the data items and the availability of the service. The error messages are shown below: It would be sensible to ensure that your code is capable of handling all of the potential error messages returned by ExpressConnect Shipping. 8.1Application generated errors The standard behaviour is for you will to receive a response and then for you to check the result (with GET_RESULT) to see if there are errors returned. In some cases, errors are returned directly in the response with an error. 8.1.1Request errors These are displayed as errors in response, for example Key value not written correctly. 15/08/2016 CV9 2ry UNITED KINGDOM 01827 717733 contact@tnt.com 987654321 Continued below. Page 73 of 160 Express ICS, 2017 CV9 1TT ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016CV9 1TT UNITED KINGDOM 00000 700005 contact@tnt.com N 1012 AA NETHERLANDS 1672 987432 email@tnt.com VAT-0123 Continued below. Page 74 of 160 Express 1012 AA NETHERLANDS ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 1012 AA NETHERLANDS 1672 987432 email@tnt.com VAT-0123 1.0 1.4 N GE000003143GB 15N Express 150.00 2 180.00 PR Priority GBP GBP S ref01_008 ABC box 1 10.0 Continued20.0 30.0 0.4 3 0.019 1 2 2127 Page 75 of 160 Express 2.30 1 0.03 ABC GB ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016box 1 10.0 20.0 30.0 0.4 3 0.019 1 2 2127 2.30 1 0.03 ABC GB box 2 50.0 60.0 70.0 0.8 3 0.63 2 2 2128 2.30 1 0.03 ABC GB 8.1.2XML errors Theses error occur if the XML is badly formatted, contain a typo and are returned via GET_RESULT. For example, if the Element No data received at gateway from client error contains a typo. Page 78 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 8.1.3Validation errors Theses error occur if there is an issue with the data supplied in the XM and are returned via GET_RESULT. For example, the XML contained the insurance element with a value, but the goods value element is missing Element content is invalid according to the DTD/Schema. Expecting: STREETADDRESS3, CITY. 13 26 ]]> For possible validation or verification errors please see Table of application generated error codes, messages and resolutions on the following pages. Page 79 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 8.2Table of application generated error codes, messages and resolutions The Default Message column contains the English language message that is returned with each code. This value is intended to be used by systems integrators. For content management you should use the error code. An element is considered empty if it contains no value or only whitespace. Therefore all of the following elements are empty: 351Goods value must be entered if insurance value supplied Consignment reference: ref0204 For Shipping Error Code 1 Error Description Resolution No data received at gateway from client error The request failed to receive a valid request – please resend or contact your local service centre for further assistance This error is returned when the http request is received by the ExpressConnect application without an XML payload. We have found that this can be caused by multiple reasons, including but not limited to: • Temporary network issue. Solved by resending request • Expired/Invalid certificate. Solved by installing the express.tnt.com certificate • By remove the linefeed character from the TNT transaction ID • Sending the xml payload as a form/url encoded parameter, but not setting the request header. Solved by setting the content type header appropriately. • Truncating the returned Requestid when requesting the result. Please re-check the your connection codes to connect the TNT server. Review the sample connection codes in this guide 2 Please contact your local service centre for further assistance 101 The request to ExpressConnect Shipping has failed. Please contact your local service centre for further assistance The {invalidfield.name} specified must be numeric Error Reading Configuration file 102 Failure to load XML Check that XML contains DTD in declaration 103 ConsignmentBatch Skipped - More Than 99 Packages Length Exceeds maximum allowed - Skipped to next consignment Height Exceeds maximum allowed - Skipped to next consignment Width Exceeds Mamimum Allowed - Skipped to next consignment Weight Exceeds maximum allowed - Skipped to next consignment Maximum Number Of Articles Exceeded Skipped to next Consignment Maximum Number Of Consignments exceeded Maximum of 99 packages per consignment only 3 104 105 106 107 108 110 Page 80 of 160 Please pass numeric data in the highlighted field Contact TNT Help Desk Max length permitted for a package is 2.4m Max height permitted for a package is 1.5m Max width permitted for a package is 1.2m Max weight permitted for a package is 70 kg Maximum of 99 articles elements per package only Refer to customer documentation for maximum limits set * Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code 113 Error Description Resolution Empty Consignment Reference found ConRefs must be supplied 114 Duplicate Consignment Reference not allowed ConRefs must be unique and are mandatory 115 Consignment Reference Not Recognized 116 Consignment Number Not Recognized 118 Cannot Rate a receiver pays shipment 119 200 If the origin or destination of a consignment is outside of the EU, the consignment must contain at least one package Duplicate consignment references not allowed for groupcode {groupcode}, conref {conref} A user ID must be entered Ensure that conrefs given in the Activity elements correspond to those in the Consignment batches Ensure that connumbers given in the Activity elements correspond to those consignments created less than 8 days ago. Unless you “own” the receiver account number it is not possible to see the estimated cost of the shipment. Add a package to the Input XML 201 A company name must be entered Enter company name in the input XML 202 The first line of the sender address must be entered A town for the sender address must be entered The three lines of the origin address can not all be empty A post code for the sender address must be entered A country code for the sender address must be entered Invalid country code for the sender address entered Sender account must be numeric Enter a sender post code The sender address contact name must be entered The sender address contact dial code must be entered The sender address contact dial code is too long Enter a Senders Contact Name The sender address contact telephone number must be entered The sender address contact telephone number is too long unable to determine the pick up depot from sender address Sender account number must be entered Enter a sender contact telephone number The collection address company name must be entered First line of the collection address must be entered A town for the collection address must be entered The collection address post code must be entered The collection address country code must be entered Invalid collection address country code entered Enter collection company name The collection address contact name must be entered The collection address contact dial code must be entered The collection address contact dial code is too long Enter a collection contact name 120 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 Page 81 of 160 Maximum of 99 packages per consignment only Enter the Customer ID in the input XML Enter a sender town Enter a valid sender country code Enter a valid sender country code Enter a valid sender account number Enter a sender contact dial code This field may only hold 7 digits This field may only hold 9 digits Check sender address details are valid Enter an account number associated with this customer The three lines of the collection address can not all be empty if these tags are used Enter a collection town Enter a collection post code Enter a valid collection country code Enter a valid collection country code Enter a collection contact dial code This field may only hold 7 digits Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code 224 Error Description Resolution Enter a collection contact telephone number 227 The collection address contact telephone must be entered The collection address contact telephone is too long unable to determine pick up depot from collection address The account number is invalid 228 Shipment date is invalid Enter the shipment date in DD/MM/YYYY format 229 The shipment date cannot be in the past Enter a shipment date that is not in the past 230 The shipment date cannot be more than {max.days.ahead.booking.allowed} days in the future Collections can not be made on this date Enter a date not more than 14 days in the future Enter a valid time in HHMM format 233 A preferred From collection-time must be entered The preferred From collection-time is invalid 234 A preferred To collection-time must be entered Enter a valid time in HHMM format 235 The preferred To collection -time is invalid The Prefered collection times must be completed in HHMM format 236 Enter a preferred collection time between 09:00 and 16:00 238 Collection times must overlap with {depot.opening.time} and {depot.closing.time} The alternate From collection time must be entered The alternate From collection time is invalid 239 The alternate To collection time is invalid Enter a valid time in HHMM format 240 The alternate To collection time is invalid The alternate collection times must be completed in HHMM format 241 Alternate collection times must be between 09:00 and 16:00 The preffered and alternate collection times must not overlap Unable to allocate unique identifier - contact administrator Group Code {groupcode} does not exist Enter an alternate collection time between 09:00 and 16:00 Error validating consignments for group code {groupcode} Cutoff time today for submitting shipping requests, {cutoff.date}, has passed Check that there are cons defined for this group code. The collection instruction can be a maximum of 24 characters in length. 300 The collection instruction is too long. Max length 60 characters Consignment reference must be entered 301 The receiver company name must be entered Enter receiver company name in the input XML 302 The three lines of the receiver address can not all be empty 303 The first line of the receiver address must be entered Receiver town must be entered 304 The receiver address post code must be entered Enter a receiver post code 305 The receiver address country code must be entered An invalid receiver country code has been entered Enter a valid receiver country code 225 226 231 232 237 242 243 244 246 247 248 306 Page 82 of 160 This field may only hold 9 digits Check collection address details are valid The account number entered is not associated with this customer The Country Cannot make a collection on the requested day The Prefered collection times must be completed in HHMM format Enter a valid time in HHMM format The alternate collection times must be completed in HHMM format Check your collection times do not overlap There has been an internal error in ExpressConnect, please contact the administrator Check that the correct group code has been entered for an existing batch. Please contact you TNT representative as the booking time has passed for the current day and we are unable to take your booking via ExpressConnect. Enter a reference for the consignment Enter a receiver town Enter a valid receiver country code Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code 307 Error Description Resolution A recipient name must be entered 308 The receiver address contact name must be entered The receiver address dial code must be entered 309 The receiver address dial code is too long This field may only hold 7 digits 310 Enter a receiver contact telephone number 315 The receiver address contact telephone number must be entered The receiver address contact telephone number is too long Unable to determine the TNT delivery depot from the receiver address The delivery address company name must be entered The first line of the delivery address must be entered A delivery address town name must be entered 316 A delivery address post code must be entered Enter a delivery post code 317 A delivery address country code must be entered Enter a valid delivery country code 318 The delivery address country code is invalid Enter a valid delivery country code 319 A delivery name must be entered 331 A delivery address contact name must be entered A delivery address contact dial code must be entered The delivery address contact dial code is too long A delivery address contact telephone number must be entered The delivery address contact telephone number is too long The delivery address company name must be entered Domestic shipments are not allowed for this country The consignment type must be entered, N (nondocuments) or D (documents) Consignment type must be N (non-documents) or D (documents) Payment indicator must be S (sender) or R (receiver) The receivers account number is required for receiver pays shipments Receivers pays shipments not allowed for this account number Total items must be entered 332 Total items must be numeric A Numeric value must be inserted into the item field 333 Total items must be greater than zero A Numeric value greater than zero must be inserted into the item field 334 The total weight must be entered A Numeric value must be inserted into the weight field 335 The total weight must be numeric A Numeric value must be inserted into the weight field 336 The total weight must be greater than zero A Numeric value greater than zero must be inserted into the weight field 337 The total volume must be entered for nondocument shipments The total volume must be numeric If con type is Non Doc, then enter a volume 311 312 313 314 320 321 322 323 324 325 326 327 328 329 330 338 Page 83 of 160 Enter a receiver contact dial code This field may only hold 9 digits Check receiver address details are valid Enter delivery company name in the input XML The three lines of the delivery address can not all be empty Enter a delivery town Enter a delivery contact dial code This field may only hold 7 digits Enter a delivery contact telephone number This field may only hold 9 digits Check delivery address details are valid The origin and destination countries must be different Enter a consignment type of ‘N’ (non-document) or ‘D’ (document) Enter a consignment type of ‘N’ (non-document) or ‘D’ (document) Terms of payments may only be (S)ender or (R)eceiver If Terms of payment is ‘R’ then the receivers account must be entered Receiver pays shipments are not allowed for this account A Numeric value must be inserted into the item field A Numeric value must be inserted into the volume field Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code 339 Error Description Resolution The total volume must be greater than zero A Numeric value greater than zero must be inserted into the volume field 340 The goods value must be numeric A Numeric value must be inserted into the goods value field 341 The goods value must be greater than zero A Numeric value greater than zero must be inserted into the goods value field 342 The goods value currency must be entered If Goods Value is entered a valid currency must be entered also 343 The goods value currency is invalid Enter a Valid Currency Code 344 If a Currency is entered, then a value must be entered also 345 The goods value must be entered if the currency is given The insurance value must be numeric 346 The insurance value must be greater than zero A Numeric value greater than zero must be inserted into the insurance value field 347 The insurance value currency must be entered Enter an insurance currency along with the insurance value 348 An invalid insurance currency has been entered Enter a valid Currency Code 349 The insurance value must be entered if currency given The insurance value must not exceed 110% of goods value The goods value must be entered if insurance value has been supplied An invalid service has been entered Enter an insurance value to go with the insurance currency Enter valid options 354 An invalid option code has been entered for this shipping service Duplicate option codes have been entered 355 The receivers account number must be numeric The account number must be numeric 356 The receivers account number is invalid The account number is not assoicated with the userid 357 The receiver account country code is invalid This is an internal TNT error and so please contact your TNT representative 358 The country code assiocate with the receiver is invalid 361 The receiver account country code must be entered The receiver account country code must be entered User not allowed to enter own consignment numbers User entered an invalid consignment number 362 Duplicate consignment numbers entered 363 A UN Number must be provided if shipment is hazardous User are not authorised to ship hazardous goods 350 351 352 353 359 360 364 365 A Numeric value must be inserted into the insurance value field Enter an insurance value which is not greater than 110% of the goods value Enter an goods value if insurance value is supplied Enter a valid service code Remove the duplicated option code For receiver pays shipments a valid receiver account is required The customer is not registered to allow them to use this functionality. Contact your TNT representative to arrange this if required. The last digit (check digit) on the consignment number is invalid. Enter a valid consignment number Enter a different consignment number Provide a UN Number for the hazardous shipment(UK Domestic shipments only) Contact your local CIT Representative to seek authorisation to ship Hazardous goods. (UK Domestic Shipments Only) Your perfered collection windows must match TNT availability 368 Preferred Collection times must be between 09:00 and 23:59 Alternate Collection times must be between 09:00 and 23:59 and not overlap with Preferred collection times An invalid delivery address country code entered The UN Number is too long 369 An insurance value must be entered The insurance value must be supplied. 400 The package items must be entered Enter a numeric value in the items field of the package 366 367 Page 84 of 160 Your Alternative (afternoon) collection windows must match TNT availability The country code assiocate with the delivery is invalid The UN number must be 4 characters in length Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code 401 Error Description Resolution The package items must be numeric A Numeric value must be inserted into the package field 402 The package items must be greater than zero A Numeric value greater than zero must be inserted into the package field 403 The package description must be entered Enter some descriptiove text in the package description field 404 The package length must be entered A length for the package must be entered 405 The package length must be numeric A Numeric value must be inserted into the package length field 406 The package length must be greater than zero A Numeric value greater than zero must be inserted into the package length field 407 The package width must be entered A Width for the package must be entered 408 The package width must be numeric A Numeric value must be inserted into the package width field 409 The package width must be greater than zero A Numeric value greater than zero must be inserted into the package width field 410 The package height must be entered A height for the package must be entered 411 The package height must be numeric A Numeric value must be inserted into the package height field 412 The package Height must be greater than zero A Numeric value greater than zero must be inserted into the package height field 413 The package weight must be entered A weight for the package must be entered 414 The package weight must be numeric A Numeric value must be inserted into the package weight field 415 The package weight must be greater than zero A Numeric value greater than zero must be inserted into the package weight field 500 Article Items must be entered The number of items for the article must be entered 501 Article items must be numeric A Numeric value must be inserted into the article items field 502 Article Items must be greater than zero A Numeric value greater than zero must be inserted into the article items field 503 Article description must be entered The description for the article must be entered 504 Article weight must be entered The weight for the article must be entered 505 Article weight must be numeric A Numeric value must be inserted into the article weight field 506 Article weight must be greater than zero A Numeric value greater than zero must be inserted into the article weight field 507 Article invoice value must be entered The invoice value for the article must be entered 508 Article invoice value must be numeric A Numeric value must be inserted into the article invoice field 509 Article invoice value must be greater than zero A Numeric value greater than zero must be inserted into the article invoice field 510 Article invoice description must be entered The invoice description for the article must be entered 511 Article origin country must be entered The origin country of the article must be entered 512 An invalid article origin country code entered Enter a valid origin country of the article 521 Invalid sender postcode format. Required: {postcode.masks} Invalid collection postcode format. Required: {postcode.masks} Invalid receiver postcode format. Required: {postcode.masks} Invalid delivery postcode format. Required: {postcode.masks} The collection address town and postcode has not been supplied Please correct the postocde to the match the required format 522 524 525 526 Page 85 of 160 Please correct the postocde to the match the required format Please correct the postocde to the match the required format Please correct the postocde to the match the required format Please supply the address details Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code 527 Error Description Resolution The collection address town could not be found Please supplied town (& postcode combination) in the required TNT spelling - please contact you TNT Representative for more assistance. Please supplied town (& postcode combination) is not unique - please contact you TNT Representative for more assistance. The province can be a maximum of 30 characters in length 528 The collection address town is not unique 529 532 The collection address province length is too long The collection address postcode is not allowed for the selected country The collection address province could not be found The collection address postcode is invalid 533 The collection address postcode is not unique 534 537 The collection address town postcode combination is invalid The collection address postcode is not in within a valid range The collection address postcode could not be found The collection address country code is not valid 538 The collection address is not unique 539 541 The collection postcode is below the minimum length The sender address town and postcode has not been supplied The sender address town could not be found 542 The sender address town is not unique 543 The sender address province length is too long 544 545 The sender address postcode is not allowed for the selected country The sender address province could not be found 546 The sender address postcode is invalid 547 The sender address postcode is not unique 548 550 The sender address town postcode combination is invalid The sender address postcode is not in within a valid range The sender address postcode could not be found 551 The sender address country code is not valid The country code must be a valid ISO country code. 552 The sender address is not unique 553 555 The sender address postcode does not have the minimum length The receiver address town and postcode has not been supplied The receiver address town could not be found The supplied address details are not unique - please contact you TNT Representative for more assistance. The Postcode length does not match the required Postcode length 556 The receiver address town is not unique 557 The receiver address province length is too long 530 531 535 536 540 549 554 Page 86 of 160 The postcode is not required The supplied province could not be found - please contact you TNT Representative for more assistance. The supplied postcode is classed as invalid - please contact you TNT Representative for more assistance. The supplied postcode is not unique - please contact you TNT Representative for more assistance. The supplied Town & Postcode combination is classed as invalid - please contact you TNT Representative for more assistance. We are unable to find this postcode for your supplied town We are unable to find this postcode The country code must be a valid ISO country code. The supplied address details are not unique - please contact you TNT Representative for more assistance. The Postcode length does not match the required Postcode length Please supply the address details Please supplied town (& postcode combination) in the required TNT spelling - please contact you TNT Representative for more assistance. Please supplied town (& postcode combination) is not unique - please contact you TNT Representative for more assistance. The province can be a maximum of 30 characters in length The postcode is not required The supplied province could not be found - please contact you TNT Representative for more assistance. The supplied postcode is classed as invalid - please contact you TNT Representative for more assistance. The supplied postcode is not unique - please contact you TNT Representative for more assistance. The supplied Town & Postcode combination is classed as invalid - please contact you TNT Representative for more assistance. We are unable to find this postcode for your supplied town We are unable to find this postcode Please supply the address details Please supplied town (& postcode combination) in the required TNT spelling - please contact you TNT Representative for more assistance. Please supplied town (& postcode combination) is not unique - please contact you TNT Representative for more assistance. The province can be a maximum of 30 characters in length Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code 558 Error Description Resolution The postcode is not required 560 The receiver address postcode is not allowed for the selected country The receiver address province could not be found The receiver address postcode is invalid 561 The receiver address postcode is not unique 562 565 The receiver address town postcode combination is invalid The receiver address postcode is not in within a valid range The receiver address postcode could not be found The receiver address country code is not valid 566 The receiver address is not unique 567 569 The receiver address postcode does not have the minimum length The delivery address town and postcode has not been supplied The delivery address town could not be found 570 The delivery address town is not unique 571 The delivery address province length is too long 572 573 the delivery address postcode not allowed for the selected country The delivery address province was not found 574 The delivery address postcode is invalid 575 The delivery address postcode is not unique 576 579 The delivery address town and postcode combination is invalid The delivery address postcode not within a valid range The delivery address postcode could not be found The delivery address country code is not valid 580 The delivery address is not unique 581 582 The delivery address postcode does not have the minimum length Delivery in depot not valid 583 The self collection TNT depot is not valid This is an internal TNT error and so please contact your TNT representative 584 Unable to calculate transit time This is an internal TNT error and so please contact your TNT representative 600 The sender address contact email is too long, maximum length is 50 The collection address contact email is too long, maximum length is 50 The receiver address contact email is too long, maximum length is 50 The delivery contact email is too long, maximum length is 50 Please correct the field as requested. 559 563 564 568 577 578 601 602 603 Page 87 of 160 The supplied province could not be found - please contact you TNT Representative for more assistance. The supplied postcode is classed as invalid - please contact you TNT Representative for more assistance. The supplied postcode is not unique - please contact you TNT Representative for more assistance. The supplied Town & Postcode combination is classed as invalid - please contact you TNT Representative for more assistance. We are unable to find this postcode for your supplied town We are unable to find this postcode The country code must be a valid ISO country code. The supplied address details are not unique - please contact you TNT Representative for more assistance. The Postcode length does not match the required Postcode length Please supply the address details Please supplied town (& postcode combination) in the required TNT spelling - please contact you TNT Representative for more assistance. Please supplied town (& postcode combination) is not unique - please contact you TNT Representative for more assistance. The province can be a maximum of 30 characters in length The postcode is not required The supplied province could not be found - please contact you TNT Representative for more assistance. The supplied postcode is classed as invalid - please contact you TNT Representative for more assistance. The supplied postcode is not unique - please contact you TNT Representative for more assistance. The supplied Town & Postcode combination is classed as invalid - please contact you TNT Representative for more assistance. We are unable to find this postcode for your supplied town We are unable to find this postcode The country code must be a valid ISO country code. The supplied address details are not unique - please contact you TNT Representative for more assistance. The Postcode length does not match the required Postcode length This is an internal TNT error and so please contact your TNT representative Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 Error Description Resolution The sender address account number is too long, maximum length is 10 receiver address account number is too long, maximum length is 10 One or more of the option codes are too long, maximum length is 3 The application id is too long, maximum length is 2 The application version is too long, maximum length is 5 The package quantity is too long, maximum length is 5 The article quantity is too long, maximum length is 3 The currency code is too long, maximum length is 3 The article country code is too long, maximum length is 3 The article invoice description is too long, maximum length is 78 The sender address vat number is too long, maximum length is 20 The receiver address vat number is too long, maximum length is 20 The collection address vat number is too long, maximum length is 20 The delivery vat number is too long, maximum length is 20 The sender address, address line 1 is too long, maximum length is 30 The sender address, address line 2 is too long, maximum length is 30 The sender address, address line 3 is too long, maximum length is 30 The sender address postcode is too long, maximum length is 9 The sender address country code is too long, maximum length is 3 The sender address town is too long, maximum length is 30 The sender address province is too long, maximum length is 30 The sender address company name is too long, maximum length is 50 The sender address contact name is too long, maximum length is 22 The receiver address, address line 1 is too long, maximum length is 30 The receiver address, address line 2 is too long, maximum length is 30 The receiver address, address line 3 is too long, maximum length is 30 The receiver address postcode is too long, maximum length is 9 The receiver address country code is too long, maximum length is 3 The receiver address town is too long, maximum length is 30 The receiver address province is too long, maximum length is 30 The receiver address company name is too long, Please correct the field as requested. Page 88 of 160 Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code Error Description Resolution maximum length is 50 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 The receiver address contact name is too long, maximum length is 22 The collection address address line 1 is too long, maximum length is 30 The collection address address line 2 is too long, maximum length is 30 The collection address address line 3 is too long, maximum length is 30 The collection address postcode is too long, maximum length is 9 The collection address country code is too long, maximum length is 3 The collection address town is too long, maximum length is 30 The collection address province is too long, maximum length is 30 The collection address company name is too long, maximum length is 50 The collection address contact name is too long, maximum length is 22 The delivery address, address line 1 is too long, maximum length is 30 The delivery address, address line 2 is too long, maximum length is 30 The delivery address, address line 3 is too long, maximum length is 30 The delivery address postcode code is too long, maximum length is 9 The delivery address country code is too long, maximum length is 3 The delivery address town is too long, maximum length is 30 The delivery address province is too long, maximum length is 30 The delivery address company name is too long, maximum length is 50 The delivery address contact name is too long, maximum length is 22 The package width is too long, maximum length is 7 The package length is too long, maximum length is 7 The package height is too long, maximum length is 7 The package weight is too long, maximum length is 9 The package description is too long, maximum length is 60 The article weight is too long, maximum length is 9 The article description is too long, maximum length is 60 The consignment delivery instructions are too long, maximum length is 60 The consignment total weight is too long, maximum length is 8 The consignment total volume is too long, maximum length is 8 The consignment user reference is too long, maximum length is 24 Page 89 of 160 Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Please correct the field as requested. Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code 665 Error Description Resolution Please correct the field as requested. 677 The consignment service is too long, maximum length is 4 The application version value must be 2.2 or greater The consignment description is too long, maximum length is 90 The ExpressConnect application version must be entered Sender address postcode masks/format not found for the selected country Collection address postcode masks/format not found for the selected country Receiver address postcode masks/format not found for the selected country Delivery address postcode masks/format not found for the selected country The sender address province is not allowed for the selected country The collection address province is not allowed for the selected country The receiver address province is not allowed for the selected country The delivery address province is not allowed for the selected country Sender town location is too short 678 Collection town location is too short This is an internal TNT error and so please contact your TNT representative 679 Receiver town location is too short This is an internal TNT error and so please contact your TNT representative 680 Delivery town location is too short This is an internal TNT error and so please contact your TNT representative 681 Packaging group must be provided if shipment is hazardous ConsignmentBatch Skipped - More Than 3 Packages ConsignmentBatch Skipped - More Than 20 Packages Consignment Skipped - More Than 99 Items in Packages There must be one hour difference between preferred collection times. There must be one hour difference between alternate collection times. If the collection date is today, preferred collection end time must be greater than now + 1 hour If the collection date is today, alternate collection end time must be greater than now + 1 hour Shipping request XML unmarshall failed with parsing error. Shipping request XML unmarshall failed with unknown error. login details not recognised The UN number and packaging group should be supplied for Dangerous Goods 666 667 668 669 670 671 672 673 674 675 676 682 683 689 690 691 692 693 997 998 999 Page 90 of 160 Please correct the field as requested. This is an internal TNT error and so please contact your TNT representative This is an internal TNT error and so please contact your TNT representative This is an internal TNT error and so please contact your TNT representative This is an internal TNT error and so please contact your TNT representative TNT does not require province for selected country TNT does not require province for selected country TNT does not require province for selected country TNT does not require province for selected country This is an internal TNT error and so please contact your TNT representative No longer used Please supply upto 20 package lines Please supply a maximum of 99 packages. Please correct the collection times supplied. Please correct the collection times supplied. Please correct the collection times supplied. Please correct the collection times s Pleae correct the supplied XML Pleae correct the supplied XML Your userid and password do not match the details stored for your user. Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 The following errors maybe returned if your select the Rating activity. Error Code Error Description Default Message Resolution The XML in the request is not formatted correctly. The services returned in the response may not all be valid due to a failure to validate the possible services. The options returned in the response may not all be valid due to a failure to validate the possible options. Failure to retrieve details of the service or options. A timeout occurred when making a call to the database. An error occurred on the TNT server. Ensure the XML in the request is of the correct structure. Refer to the XSD and available documentation to rectify. Resubmit the request for all services. Enter a valid account number. 9 No price requests found in the XML Failure to format incoming XML string Failure to specify available Services: those returned might not all apply Failure to specify available Options: those returned might not all apply Failure to retrieve Service/Option details Price Check Failure: Time out on database. Price Check Failure: Error in server Price Check Failure: No Rates Returned. FIELD/S MISSING OR INVALID. MANDATORY FIELDS ARE ORIGINCOUNTRY, DESTCOUNTRY, CONTYPE,ITEMS,WEIGHT AND VOLUME(IF NONDOC). No Price Requests Found 10 The account number entered is not Invalid Account Number 1 2 3 4 5 6 7 No rates available for the request Mandatory fields missing or invalid in the request XML. 8 Developer Notes Page 91 of 160 Express ICS, 2017 Resubmit the request for all options. Resubmit the request. If the problem persists, contact the TNT helpdesk. Resubmit the request. If the problem persists contact the TNT helpdesk. Resubmit the request. If the problem persists contact the TNT helpdesk. Source and destination addresses need to be serviceable by TNT. Ensure the XML in the request is of the correct structure and contains all mandatory fields. Refer to the XSD and available documentation to rectify. Refer to the XSD and available documentation to rectify. ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code Error Description Default Message Resolution Invalid Country Code Ensure the country code matches one of those in the TNT dataset. Invalid Town Group TownGroup code must match a code in the TNT Towngroup dataset. Standard Rates If account specific rates are required then account details should be populated in the request XML. Invalid Domestic Consignment Domestic shipments should be within supported TNT countries. Insurance value must be numeric Ensure the value of the Insurance element is a number. Service required with options Ensure a service code is specified for the requested options. Unable to retrieve service/option Refer to the XSD and available documentation to rectify. Service is invalid Ensure the service in the request matches a code in the TNT dataset. Pricing request failed with parsing error. XML supplied is not recognised as an ExpressConnect request. No data received at gateway from client error Exceeded maximum number of allowed options Ensure the XML is of a valid structure. Refer to the XSD and available documentation to rectify. Refer to the XSD and available documentation to rectify. associated with this customer 11 12 13 14 15 16 17 18 19 20 21 22 The country code in the request XML is invalid. The town group specified in the request XML is invalid. The rates returned are standard rates and do not include any account specific prices. Domestic price requests are not supported in the country specified. The value of the Insurance element should be a number. Options have been specified in the request XML without an associated service code. The system was unable to retrieve the service and option for the request. The service specified in the request is invalid. The system was unable to parse the request XML. The request XML was not recognised as a Express Connect request. No data was received from the client. The maximum number of options per service has been exceeded. Developer Notes Page 92 of 160 Express ICS, 2017 Resubmit the request. A maximum of 5 options per service are allowed. ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code Error Description Default Message Resolution 101 Origin address town not supplied Origin address town not supplied Supply origin address town Origin address town and postcode not supplied Origin address town has not been recognized. Origin address town results in more than one match The origin address province maximum length has been exceeded. Origin address postcode has been entered for a country that does not accept postcodes as part of the address. Origin address province not found Origin address town and postcode not supplied Origin address town not found Supply origin address town and postcode. Origin address town not unique Ensure the origin town is entered correctly. Do not use partial town names. Maximum 30 characters. The origin postcode is invalid in the request. Origin address postcode has an invalid format. For example CV9 XTT is incorrect for a UK postcode. Origin address postcode matches more than one town. This may occur if a partial postcode is entered. Origin address has an invalid town / postcode combination. For example if you entered a London postcode for Birmingham. Origin address postcode is not within Origin address postcode invalid Ensure origin province is entered correctly or remove the origin province element. Ensure the origin postcode element is entered correctly. Origin address postcode invalid format Ensure the origin postcode element is entered correctly and is no longer than 9 characters. Origin address postcode not unique Ensure the origin postcode is entered correctly. Origin address town/postcode combination invalid Ensure origin postcode and/or town are entered correctly. Origin address postcode not in Ensure origin postcode and/or town are entered correctly. 102 103 104 105 106 107 108 109 110 111 112 Origin address province length exceeded Origin address postcode not allowed for selected country Origin address province not found Developer Notes Page 93 of 160 Express ICS, 2017 Ensure that the specified origin town is a valid town. Remove the origin postcode element from the request. ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code 113 114 Error Description Default Message the valid range of postcodes for the town. Origin postcode is missing from the request XML. Origin country not found in the XML valid range 116 Origin address country is not valid ISO 3166-1 ALPHA-2. (2 character alpha). Origin address town results in more than one match. 117 Origin address postcode is below minimum length for selected country 115 201 202 203 204 205 206 Destination address town not supplied Destination address town and postcode not supplied Destination address town has not been recognized. Destination address town results in more than one match The Destination address province maximum length has been exceeded. Destination address postcode has been entered for a country that does not accept postcodes as part of the address. Origin address postcode not found Ensure origin postcode is entered correctly Origin address country not supplied Origin address country not valid ISO. Country is mandatory in the request. Origin address not unique Ensure origin town and/or postcode are entered correctly. Do not use partial town or postcodes. Origin address postcode is below minimum length for selected country Destination address town not supplied Destination address town and postcode not supplied Destination address town not found Ensure origin town and/or postcode are entered correctly. Do not use partial town or postcodes. Destination address town not unique Destination address province length exceeded Destination address postcode not allowed for selected country Ensure the destination town is entered correctly. Do not use partial town names. Maximum 30 characters. Developer Notes Page 94 of 160 Resolution Express ICS, 2017 Ensure origin country is entered correctly. Supply destination address town Supply destination address town and postcode. Ensure that the specified destination town is a valid town. Remove the destination postcode element from the request. ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code 207 208 209 210 211 212 213 214 215 216 Error Description Default Message Resolution Destination address province not found The Destination postcode is invalid in the request. Destination address postcode has an invalid format. For example CV9 XTT is incorrect for a UK postcode. Destination address postcode matches more than one town. This may occur if a partial postcode is entered. Destination address has an invalid town / postcode combination. For example if you entered a London postcode for Birmingham. Destination address postcode is not within the valid range of postcodes for the town. Destination postcode is missing from the request XML. Destination country not found in the XML Destination address country is not valid ISO 3166-1 ALPHA-2. (2 character alpha). Destination address town results in more than one match. Destination address province not found Destination address postcode invalid Destination address postcode invalid format Ensure destination province is entered correctly or remove the destination province element. Ensure the destination postcode element is entered correctly. Destination address postcode not unique Ensure the destination postcode is entered correctly. Destination address town/postcode combination invalid Ensure destination postcode and/or town are entered correctly. Destination address postcode not in valid range Ensure destination postcode and/or town are entered correctly. Destination address postcode not found Destination address country not supplied Destination address country not valid ISO. Ensure destination postcode is entered correctly Destination address not unique Ensure destination town and/or postcode are entered correctly. Do not use partial town or postcodes. Developer Notes Page 95 of 160 Express ICS, 2017 Ensure the destination postcode element is entered correctly and is no longer than 9 characters. Country is mandatory in the request. Ensure destination country is entered correctly. ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Error Code 217 301 302 401 999 Error Description Default Message Resolution Destination address postcode is below the minimum length for selected country The depot ID for the origin depot is not valid. The depot ID for the self collect delivery address is not valid. The TNT backend system was unable to determine the route between the source and destination addresses. The user name and password specified in the request have not been recognised. Destination address postcode is below minimum length for selected country Delivery in depot id is not valid Ensure destination town and/or postcode are entered correctly. Do not use partial town or postcodes. Self collect depot id is not valid Unable to determine traffic lane for route login details not recognised Developer Notes Page 96 of 160 Express ICS, 2017 Depot ID should be one of the valid TNT towngroup codes contained within the towngroup dataset. Depot ID should be one of the valid TNT towngroup codes contained within the towngroup dataset. Contact TNT helpdesk. Enter the correct username and password combination. Contact the TNT helpdesk if the problem persists. ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 9.Connecting to ExpressConnect Shipping ExpressConnect Shipping is a HTTP web service, which defines an XML interface for data transfer. The XSD for the service can be found in the Shipping section of the website. Before sending an XML document through a straight socket connection, you must verify that you can access TNT’s ExpressConnect applications by successfully viewing the test/demonstration web site provided by TNT. This is located at https://express.tnt.com/expresswebservices-website/app/landing.html The demonstration site does NOT support foreign (non-ASCII) characters. The demonstration site simulates a simple customer interface to the back-end ExpressConnect server. It is useful for developers to use as a tool to test their XML and analyse their return XML results, prior to and during the development of their front-end application. When testing ExpressConnect Shipping, the results come back in five separate packages. The XML results document holds the information pertaining to consignments created, rated or booked. The other four hold information required for consignment documentation: consignment notes, labels, manifest, and invoice. These four XML documents include a reference to an XSL style sheet 1 in the XML heading. If they are opened as XML files in IE6.0 or above, they will be automatically formatted and displayed as TNT shipping documents. Having made a successful submission of an XML document via the test page, you are ready to set up a socket connection and make a real XML submission using the code similar to Open a socket connection to the following address and port number. Domain Name IP Address Port https://express.tnt.com/expressconnect/shipping/ship 164.39.122.33 81 express.tnt.com Send the following lines, data between quotes. N.B. 1 blank line should be sent after Content-length line. "POST Shipping/ship HTTP/1.0" "Accept: */*" "User-Agent: Ship_socket/1.0"; "Content-type: application/x-www-form-urlencoded"; "Content-length: X"; (replace X with the length of data plus 7 for “xml_in=”) "" "xml_in=XML document" (this is the content of message) XML document isthe XML corresponding to the specified format (see later section). 1 The manifest document will refer to a different style sheet if it is a summary manifest. Developer Notes Page 97 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 Once the above data has been sent, read from the socket until no more data is available. The data returned will consist of some header information followed by a blank line, and then the shipping return code. This unique code is your key with which you can retrieve the various XML documents that your shipping request has produced. The return string will look like this: COMPLETED:nnnnnnnnnn where nnnnnnnnnn is a unique number. You will then send this number back in to the TNT server for each XML document – results XML, consignment XML, label XML, manifest XML or invoice XML – that you need. A code example of how this may be performed and the correct format of the requests are included below. Developer Notes Page 98 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 9.1VB Script sample ExpressConnect can be called from within a VB script. The sample script performs the following operations: • • • • Access the request XML from a folder on the local ‘C:’ drive Parse the basic XML to encode all non ASCII characters to their Hex equivalent. This is required to correctly handle special characters such as “ß©@¼Ùäá”. Send the encoded XML to ExpressConnect and retrieve the access code. The access code is a unique number that identifies the data for this submission. This is used in subsequent calls to retrieve the document, and summary information XML in subsequent calls. Make five separate calls to ExpressConnect to retrieve the summary result information and the four consignment documents, consignment notes, labels, commercial invoice and manifest. The following characters have special meaning in XML strings and these need to be encoded by your own application before being included in the request XML submitted: &<> “ ‘ To include these characters replace the character in your XML with the following literal string: & < > “ ‘ & < > " ' For example to pass the literal ‘Jack & Jill’ you need to pass in the XML: ‘Jack & Jill’ The example can be run from your own server to show a successful connection and the format of the response XML. Customers are free to utilize this code within their own application if they wish but please note that we cannot offer support for this. 'FILE: Sample_HTTP_shipping_request.vbs 'AUTH: Paul Horsley ' Folders required C:\expressconnect ' Folders required C:\expressconnect\original // Put your request XML message here with file name "TEST.xml" ' Ensure the tag has a date of today or in the future, in the format "DD/MM/YYYY" Const TristateTrue = -1 Const TristateFalse = 0 xml_out = "" Developer Notes Page 99 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 'note ----- The shipping request XML document dim objText dim objfilesys dim objSite Dim iAccessCodeLen Dim sfolder Dim sfilename Dim sUrl Dim xml_in Dim AccessCode iAccessCodeLen = 7 sUrl = "https://express.tnt.com/expressconnect/shipping/ship" sfolder = "C:\expressconnect\" Wscript.Echo WScript.Scriptname &" : Calling TNT Express Connect Shipping @ " & sUrl sFileName = "TEST.xml" set objfilesys = wscript.createobject("scripting.filesystemobject") ‘ For input files with ANSI encoding ‘ Set the format argument to “TristateTrue” (-1) for Unicode files, or “TristateFalse” (0) for ASCII files set objText = objfilesys.opentextfile(objfilesys.BuildPath(sfolder , "original\" & sfilename ), 1 ,False ,TristateFalse) ' Read in the request XML to xml_in variable xml_in = objText.ReadAll objText.close ' Encode the request XML xml_in = HEXThisStream(xml_in) ' Send the encoded XML and place the result in AccessCode variable AccessCode = Sendxml (xml_in ,"Shipping Connection response") ' Store the result in the "C:\expressconnect\" folder PersistXmlTestResults sfolder , "AccessCode=" & AccessCode, "AccessCode" ' Extract just the numeric access code from the response AccessCode = Right( AccessCode,iAccessCodeLen) Developer Notes Page 100 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 ' Display the returned AccessCode. The access code is a unique number that identifies the data for this submission. ' This is used in subsequent calls to retrieve the document, and summary information XML in subsequent calls. MsgBox "AccessCode - " & AccessCode ' Retrieve the consignment document XML ' The document XML will only be available if the appropriate tag has been included in the node ' of the original request XML. For all four documents to be available the following XML would need to be included ' with the appropriate reference or consignment number. "ref12" in the example below: ' ' ' ' Retrieve the consignment note XML if the' ' 'ref12 '' 'ref12 '' 'ref12 'tag has been included ' in the node Xml_In="GET_CONNOTE:" & AccessCode SendXml Xml_In, "Get_Connote" ' Retrieve the commercial invoice XML if the tag has been included ' in the node Xml_In="GET_INVOICE:" & AccessCode SendXml Xml_In, "Get_Invoice" ' Retrieve the manifest XML if the tag has been included Developer Notes Page 101 of 160 Express ICS, 2017 ExpressConnect Shipping Integration Guide Version: 1.0 Date: 05/08/2016 ' in the node Xml_In="GET_MANIFEST:" & AccessCode SendXml Xml_In, "Get_Manifest" ' Retrieve the label XML if the
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.7 Linearized : No Page Count : 160 Language : en-GB Tagged PDF : Yes XMP Toolkit : 3.1-701 Producer : Microsoft® Word 2016 Title : ExpressConnect Pricing Integration Guide Creator : Robert Hitchens Creator Tool : Microsoft® Word 2016 Create Date : 2017:11:27 11:03:45+00:00 Modify Date : 2017:11:27 11:03:45+00:00 Document ID : uuid:E5CA18A1-F6D8-40DC-82B4-3F114DAFC9EE Instance ID : uuid:E5CA18A1-F6D8-40DC-82B4-3F114DAFC9EE Author : Robert HitchensEXIF Metadata provided by EXIF.tools