The GetQuote method returns the user a list of services that can be used to place an order for a given request. The response includes a quote id that can optionally be used to place an order and a list of service results. Each service result contains identifying information, including the service id that is used when placing an order, as well as a price break down and additional information that may be useful to the client which will be described below.
The below requests are based on shipments from UK to the United States (so as to include the commodity information).
{
"Credentials": {
"APIKey": "[API KEY]",
"Password": "[API PASSWORD]"
},
"Shipment": {
"Consignment": {
"ItemType": "Parcel",
"ItemsAreStackable": true,
"ConsignmentSummary": "Stationary",
"ConsignmentValue": 50.45,
"ConsignmentCurrency":{
"CurrencyCode": "GBP"
},
"Packages": [
{
"Weight": 25.0,
"Length": 30.0,
"Width": 20.0,
"Height": 10.0,
"CommodityDetails": [
{
"CommodityCode": "8708999790",
"CommodityDescription": "Car Batteries",
"CountryOfOrigin": {
"CountryCode": "DE"
},
"NumberOfUnits": 5,
"UnitValue": 15.5,
"UnitWeight": 4.0,
"ProductCode": "YourProductCode",
"ManufacturerAddress": {
"CompanyName": "[MANUFACTURER ADDRESS COMPANY NAME]",
"AddressLineOne": "[MANUFACTURER ADDRESS LINE 1]",
"AddressLineTwo": "[MANUFACTURER ADDRESS LINE 2]",
"City": "[MANUFACTURER ADDRESS CITY]",
"County": "[MANUFACTURER ADDRESS COUNTY]",
"Postcode": "[MANUFACTURER ADDRESS POSTCODE]",
"Country": {
"CountryCode": "GB"
}
}
},
{
"CommodityCode": "8708301040",
"CommodityDescription": "Brake Pads",
"CountryOfOrigin": {
"CountryCode": "FR"
},
"NumberOfUnits": 2,
"UnitValue": 11.0,
"UnitWeight": 2.5,
"ProductCode": "YourProductCode2"
}
]
},
{
"Weight": 3.5,
"Length": 47.98,
"Width": 45.62,
"Height": 12.5,
"CommodityDetails": [
{
"CommodityCode": "8708951010",
"CommodityDescription": "Air Bag",
"CountryOfOrigin": {
"CountryID": 231
},
"NumberOfUnits": 1,
"UnitValue": 35.78,
"UnitWeight": 3.5,
"ProductCode": "YourProductCode3",
"ManufacturerAddress": {
"CompanyName": "[MANUFACTURER ADDRESS COMPANY NAME]",
"AddressLineOne": "[MANUFACTURER ADDRESS LINE 1]",
"AddressLineTwo": "[MANUFACTURER ADDRESS LINE 2]",
"City": "[MANUFACTURER ADDRESS CITY]",
"County": "[MANUFACTURER ADDRESS COUNTY]",
"Postcode": "[MANUFACTURER ADDRESS POSTCODE]",
"Country": {
"CountryID": 232
}
}
}
]
}
]
},
"CollectionAddress": {
"Forename": "Joe",
"Surname": "Bloggs",
"EmailAddress": "joe.bloggs@testsender.co.uk",
"TelephoneNumber": "[TELEPHONE NUMBER HERE]",
"MobileNumber": "[MOBILE NUMBER HERE]",
"CompanyName": "Transglobal Express",
"AddressLineOne": "Unit 5, The Gateway",
"AddressLineTwo": "Old Hall Road",
"City": "Bromborough",
"County": "Merseyside",
"Postcode": "CH62 3NX",
"Country": {
"CountryID": 231
},
"IsAddressResidential": false,
"EORINumber": "[SENDER EORI NUMBER]",
"VATNumber": "[SENDER VAT NUMBER]"
},
"DeliveryAddress": {
"Forename": "Test",
"Surname": "Testerson",
"EmailAddress": "testerson@testreceiver.com",
"TelephoneNumber": "[TELEPHONE NUMBER HERE]",
"MobileNumber": "[MOBILE NUMBER HERE]",
"CompanyName": "Test Corp",
"AddressLineOne": "Test Street",
"City": "New York",
"County": "NY",
"Postcode": "10005",
"Country": {
"CountryCode": "US"
},
"IsAddressResidential": true,
"EORINumber": "[RECEIVER EORI NUMBER]",
"VATNumber": "[RECEIVER VAT NUMBER]"
},
"ExporterAddress": {
"Forename": "Joe",
"Surname": "Bloggs",
"EmailAddress": "joe.bloggs@testsender.co.uk",
"TelephoneNumber": "[TELEPHONE NUMBER HERE]",
"MobileNumber": "[MOBILE NUMBER HERE]",
"CompanyName": "Transglobal Express",
"AddressLineOne": "Unit 5, The Gateway",
"AddressLineTwo": "Old Hall Road",
"City": "Bromborough",
"County": "Merseyside",
"Postcode": "CH62 3NX",
"Country": {
"CountryID": 231
},
"IsAddressResidential": false,
"EORINumber": "[EXPORTER EORI NUMBER]",
"VATNumber": "[EXPORTER VAT NUMBER]"
},
"ImporterAddress": {
"Forename": "Test",
"Surname": "Testerson",
"EmailAddress": "testerson@testreceiver.com",
"TelephoneNumber": "[TELEPHONE NUMBER HERE]",
"MobileNumber": "[MOBILE NUMBER HERE]",
"CompanyName": "Test Corp",
"AddressLineOne": "Test Street",
"City": "New York",
"County": "NY",
"Postcode": "10005",
"Country": {
"CountryCode": "US"
},
"IsAddressResidential": true,
"EORINumber": "[IMPORTER EORI NUMBER]",
"VATNumber": "[IMPORTER VAT NUMBER]"
}
}
}
<GetQuoteRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.transglobalexpress.co.uk/API/V2">
<Credentials>
<APIKey>[API KEY]</APIKey>
<Password>[API PASSWORD]</Password>
</Credentials>
<Shipment>
<Consignment>
<ItemType>Parcel</ItemType>
<ItemsAreStackable>true</ItemsAreStackable>
<ConsignmentSummary>Stationary</ConsignmentSummary>
<ConsignmentValue>50.45</ConsignmentValue>
<ConsignmentCurrency>
<CurrencyCode>GBP</CurrencyCode>
</ConsignmentCurrency>
<Packages>
<Package>
<Weight>25</Weight>
<Length>30</Length>
<Width>20</Width>
<Height>10</Height>
<CommodityDetails>
<CommodityLine>
<CommodityCode>8708999790</CommodityCode>
<CommodityDescription>Car Batteries</CommodityDescription>
<CountryOfOrigin>
<CountryCode>DE</CountryCode>
</CountryOfOrigin>
<NumberOfUnits>5</NumberOfUnits>
<UnitValue>15.5</UnitValue>
<UnitWeight>4</UnitWeight>
<ProductCode>YourProductCode</ProductCode>
<ManufacturerAddress>
<CompanyName>[MANUFACTURER ADDRESS COMPANY NAME]</CompanyName>
<AddressLineOne>[MANUFACTURER ADDRESS LINE 1]</AddressLineOne>
<AddressLineTwo>[MANUFACTURER ADDRESS LINE 2]</AddressLineTwo>
<City>[MANUFACTURER ADDRESS CITY]</City>
<County>[MANUFACTURER ADDRESS COUNTY]</County>
<Postcode>[MANUFACTURER ADDRESS POSTCODE]</Postcode>
<Country>
<CountryCode>GB</CountryCode>
</Country>
</ManufacturerAddress>
</CommodityLine>
<CommodityLine>
<CommodityCode>8708301040</CommodityCode>
<CommodityDescription>Brake Pads</CommodityDescription>
<CountryOfOrigin>
<CountryCode>FR</CountryCode>
</CountryOfOrigin>
<NumberOfUnits>2</NumberOfUnits>
<UnitValue>11</UnitValue>
<UnitWeight>2.5</UnitWeight>
<ProductCode>YourProductCode2</ProductCode>
</CommodityLine>
</CommodityDetails>
</Package>
<Package>
<Weight>3.5</Weight>
<Length>47.98</Length>
<Width>45.62</Width>
<Height>12.5</Height>
<CommodityDetails>
<CommodityLine>
<CommodityCode>8708951010</CommodityCode>
<CommodityDescription>Air Bag</CommodityDescription>
<CountryOfOrigin>
<CountryID>231</CountryID>
</CountryOfOrigin>
<NumberOfUnits>1</NumberOfUnits>
<UnitValue>35.78</UnitValue>
<UnitWeight>3.5</UnitWeight>
<ProductCode>YourProductCode3</ProductCode>
<ManufacturerAddress>
<CompanyName>[MANUFACTURER ADDRESS COMPANY NAME]</CompanyName>
<AddressLineOne>[MANUFACTURER ADDRESS LINE 1]</AddressLineOne>
<AddressLineTwo>[MANUFACTURER ADDRESS LINE 2]</AddressLineTwo>
<City>[MANUFACTURER ADDRESS CITY]</City>
<County>[MANUFACTURER ADDRESS COUNTY]</County>
<Postcode>[MANUFACTURER ADDRESS POSTCODE]</Postcode>
<Country>
<CountryID>232</CountryID>
</Country>
</ManufacturerAddress>
</CommodityLine>
</CommodityDetails>
</Package>
</Packages>
</Consignment>
<CollectionAddress>
<Forename>Joe</Forename>
<Surname>Bloggs</Surname>
<EmailAddress>joe.bloggs@testsender.co.uk</EmailAddress>
<TelephoneNumber>[TELEPHONE NUMBER HERE]</TelephoneNumber>
<MobileNumber>[MOBILE NUMBER HERE]</MobileNumber>
<CompanyName>Transglobal Express</CompanyName>
<AddressLineOne>Unit 5, The Gateway</AddressLineOne>
<AddressLineTwo>Old Hall Road</AddressLineTwo>
<City>Bromborough</City>
<County>Merseyside</County>
<Postcode>CH62 3NX</Postcode>
<Country>
<CountryID>231</CountryID>
</Country>
<IsAddressResidential>false</IsAddressResidential>
<EORINumber>[SENDER EORI NUMBER]</EORINumber>
</CollectionAddress>
<DeliveryAddress>
<Forename>Test</Forename>
<Surname>Testerson</Surname>
<EmailAddress>testerson@testreceiver.com</EmailAddress>
<TelephoneNumber>[TELEPHONE NUMBER HERE]</TelephoneNumber>
<MobileNumber>[MOBILE NUMBER HERE]</MobileNumber>
<CompanyName>Test Corp</CompanyName>
<AddressLineOne>Test Street</AddressLineOne>
<City>New York</City>
<County>NY</County>
<Postcode>10005</Postcode>
<Country>
<CountryCode>US</CountryCode>
</Country>
<IsAddressResidential>true</IsAddressResidential>
<EORINumber>[RECEIVER EORI NUMBER]</EORINumber>
</DeliveryAddress>
<ExporterAddress>
<Forename>Joe</Forename>
<Surname>Bloggs</Surname>
<EmailAddress>joe.bloggs@testsender.co.uk</EmailAddress>
<TelephoneNumber>[TELEPHONE NUMBER HERE]</TelephoneNumber>
<MobileNumber>[MOBILE NUMBER HERE]</MobileNumber>
<CompanyName>Transglobal Express</CompanyName>
<AddressLineOne>Unit 5, The Gateway</AddressLineOne>
<AddressLineTwo>Old Hall Road</AddressLineTwo>
<City>Bromborough</City>
<County>Merseyside</County>
<Postcode>CH62 3NX</Postcode>
<Country>
<CountryID>231</CountryID>
</Country>
<IsAddressResidential>false</IsAddressResidential>
<EORINumber>[SENDER EORI NUMBER]</EORINumber>
<VATNumber>[SENDER VAT NUMBER]</VATNumber>
</ExporterAddress>
<ImporterAddress>
<Forename>Test</Forename>
<Surname>Testerson</Surname>
<EmailAddress>testerson@testreceiver.com</EmailAddress>
<TelephoneNumber>[TELEPHONE NUMBER HERE]</TelephoneNumber>
<MobileNumber>[MOBILE NUMBER HERE]</MobileNumber>
<CompanyName>Test Corp</CompanyName>
<AddressLineOne>Test Street</AddressLineOne>
<City>New York</City>
<County>NY</County>
<Postcode>10005</Postcode>
<Country>
<CountryCode>US</CountryCode>
</Country>
<IsAddressResidential>true</IsAddressResidential>
<EORINumber>[RECEIVER EORI NUMBER]</EORINumber>
<VATNumber>[RECEIVER VAT NUMBER]</VATNumber>
</ImporterAddress>
</Shipment>
</GetQuoteRequest>
| Property Name | Data Type | Parent | M | Comment | Example |
|---|---|---|---|---|---|
| GetQuoteRequest | Container | M | The root container for the request. | ||
| Credentials | |||||
| Credentials | Container | GetQuoteRequest | M | The api credentials container. | |
| APIKey | string | Credentials | M | The api key. | Th6fLmTxBv |
| Password | string | Credentials | M |
The api password. Please note this is NOT the password used to log into the website. |
rGf3!lmT4dA |
| Shipment | |||||
| Shipment | Container | GetQuoteRequest | M | The shipment container. | |
| Consignment | |||||
| Consignment | Container | Shipment | M | The consignment container. | |
| ItemType | string | Consignment | M |
The item type. Valid values are: Parcel, Document, Pallet, Suitcase |
Parcel |
| ItemsAreStackable | string | Consignment | O |
Indicates whether or not the items in the consignment
are stackable. Valid values are "true" and "false". Some carriers levy a surcharge if the items are not stackable, which will be show as part of the price breakdown of the service result. If not supplied the value will be defaulted to "true", however if the items go on to be deemed non stackable by the carrier and a surcharge applied this will be invoiced by our accounts team. |
false |
| ConsignmentSummary | string | Consignment | M | The summmary for the whole consignment. | Car Parts |
| ConsignmentValue | decimal | Consignment | M | The monetary value for the whole consignment. | 102.78 |
| ConsignmentCurrency | Container | Consignment | O |
Defines the currency the consignment value/commodity unit values are specified in. Please note: This section only specifies the currency for the consignment value/commodity values that will be used on your customs invoice, it does not affect any monetary values received in the api response; any monetary values in an api response will be in the default currency of GBP |
|
| CurrencyCode | string | ConsignmentCurrency | M |
The currency code that specifies the consignment value currency. Available options are: GBP: Great British Pound EUR: Euro USD: US Dollar AUD: Australian Dollar NZD: New Zealand Dollar CAD: Canadian Dollar CHF: Swiss Franc CNY: Chinese Renminbi SEK: Swedish Krona HKD: Hong Kong Dollar AED: UAE Dirham JPY: Japanese Yen |
GBP |
| Packages | |||||
| Packages | Container | Consignment | M | The container for consignment items. | |
| Package | Container | Packages | M |
The container for a consignment item. Note: The element container is used in XML format requests, if using JSON format it is not explicitly named, the "Packages" element (see above) is an array of Package objects. This is demonstrated in the provided JSON example above this table. |
|
| Weight | decimal | Package | M | The item weight in Kg. | 3.5 |
| Length | decimal | Package | M | The item length in Cm. | 47.98 |
| Width | decimal | Package | M | The item width in Cm. | 45.62 |
| Height | decimal | Package | M | The item height in Cm. | 12.5 |
| CommodityDetails | |||||
| CommodityDetails | Container | Package | C |
The container for commodity information. The information provided in this section will be used to generate a packing list if required when exporting to/importing from the destination. Some carriers require this information in order to place a booking with them, so this information may be required even if the client will be using their own packing list. The CommodityDetails must be provided if the shipment ItemType is not Document type, and it is importing from or exporting to a country outside of the EU. |
|
| CommodityLine | Container | CommodityDetails | O |
The container for commodity line information for each commodity type within the package. Note: The element container is used in XML format requests, if using JSON format it is not explicitly named, the "CommodityDetails" element (see above) is an array of CommodityLine objects. This is demonstrated in the provided JSON example above this table. |
|
| CommodityCode | string | CommodityLine | O | The commodity code. | 8708999790 |
| CommodityDescription | string | CommodityLine | M | The commodity description. | Car Batteries |
| CountryOfOrigin | Container | CommodityLine | M |
The container for defining the country of origin. Note this is the same container format when specifying a country anywhere in this request. |
|
| CountryID | integer | CountryOfOrigin | C |
The country id as defined within the Transglobal Express system. Note: This value can be omitted if providing a value for CountryCode. If both CountryID and CountryCode are provided, the CountryCode value will be ignored and the country will be selected based on the CountryID value. Country id values can be discovered via the countries section of the Transglobal Express API (/Country/V2/GetCountries). |
73 |
| CountryCode | string | CountryOfOrigin | C |
The ISO code for the country. Note: This value can be omitted if providing a value for CountryID. If both CountryID and CountryCode are provided, the CountryCode value will be ignored and the country will be selected based on the CountryID value. Country code values can be discovered via the countries section of the Transglobal Express API (/Country/V2/GetCountries). |
FR |
| NumberOfUnits | integer | CommodityLine | M |
The number of items for this commodity within the package. If sending large quantites of commodities it may be necessary to specify the number based on subgroupings such as "packs" rather than the individual unit. Some carriers validate the commodity data stringently and therefore so must we. An example would be sending a box of 10,000 pens in packs of 20, with a total value of £50.00 If specifying 1000 units the unit price would be £0.005, which would then be rejected by the carrier. If the unit value was increased to the minimum allowed ad inflated consignment value would be declared that could potentially incur greater customs charges. The best solution therefore is to specify the CommodityDescription as "pack of pens" and NumberOfUnits as "500" and then you can specify the unit value as "0.1". |
2 |
| UnitValue | decimal | CommodityLine | M | The monetary value of a single commodity item. | 11.00 |
| UnitWeight | decimal | CommodityLine | M | The weight in Kg of a single commodity item. | 2.5 |
| ProductCode | decimal | CommodityLine | C | The product code/reference of the commodities being sent. If you have products set up in your Account Product Library (See "Save items in your Product Library" on our Contents Declaration Page for more information), this will be used to link your commodity line to that product and gain access to data set there such as the manufacturer address, which may be required by certain carriers (eg USPS). | PR012462542 |
| ManufacturerAddress | Container | CommodityLine | C |
When sending with USPS, certain HS codes (subject to change) may require manufacturer address to be supplied in order for the booking to
be accepted. This can be passed via this ManufacturerAddress property, or be automatically looked up via the ProductCode property if
you have an entry in your Transglobal Account Product Library matching that product code with a manufacturer address already set. When passing via the ManufacturerAddress property, you can use the same object as is used for Collection/Delivery address. While the Forename, Surname, TelephoneNumber, EmailAddress properies need not be populated for the manufacturer address, including them will not negatively affect the booking. |
PR012462542 |
| CompanyName | string | ManufacturerAddress | M | The company name. | Transglobal Express Ltd |
| AddressLineOne | string | ManufacturerAddress | M | The address line one. | Unit 5, The Gateway |
| AddressLineTwo | string | ManufacturerAddress | O | The address line two. | Old Hall Road |
| City | string | ManufacturerAddress | M | The city. | Bromborough |
| County | string | ManufacturerAddress | C |
The county. While optional in most cases, when the addess is for the United States or Canada, the two letter state code must be provided here. |
Merseyside |
| Postcode | string | ManufacturerAddress | C |
The postcode. This is mandatory for all countries that have a postal or zip code. It is marked as conditional here because some countries such as Ireland (at the time of writing this documentation) do not use postcodes and as such no postcode would be required for an address in that country. |
CH62 3NX |
| Country | Container | ManufacturerAddress | M |
The postcode. The container for defining the address country. Note this is the same container format when specifying a country anywhere in this request. |
|
| CountryID | integer | Country | C |
The country id as defined within the Transglobal Express system. Note: This value can be omitted if providing a value for CountryCode. If both CountryID and CountryCode are provided, the CountryCode value will be ignored and the country will be selected based on the CountryID value. Country id values can be discovered via the countries section of the Transglobal Express API (/Country/V2/GetCountries). |
231 |
| CountryCode | string | Country | C |
The ISO code for the country. Note: This value can be omitted if providing a value for CountryID. If both CountryID and CountryCode are provided, the CountryCode value will be ignored and the country will be selected based on the CountryID value. Country code values can be discovered via the countries section of the Transglobal Express API (/Country/V2/GetCountries). |
GB |
| CollectionAddress | |||||
| CollectionAddress | Container | Shipment | M | The collection address container. | |
| Forename | string | CollectionAddress | M | The forename. | Joe |
| Surname | string | CollectionAddress | M | The surname. | Bloggs |
| Surname | string | CollectionAddress | M | The surname. | Bloggs |
| EmailAddress | string | CollectionAddress | M | The email address. | joe.bloggs@testsender.co.uk |
| TelephoneNumber | string | CollectionAddress | M | The phone number. | 01234567890 |
| MobileNumber | string | CollectionAddress | O | The mobile phone number. | 01234567890 |
| CompanyName | string | CollectionAddress | O | The company name. | Transglobal Express |
| AddressLineOne | string | CollectionAddress | M | The address line one. | Unit 5, The Gateway |
| AddressLineTwo | string | CollectionAddress | O | The address line two. | Old Hall Road |
| City | string | CollectionAddress | M | The city. | Bromborough |
| County | string | CollectionAddress | C |
The county. While optional in most cases, when the addess is for the United States or Canada, the two letter state code must be provided here. |
Merseyside |
| Postcode | string | CollectionAddress | C |
The postcode. This is mandatory for all countries that have a postal or zip code. It is marked as conditional here because some countries such as Ireland (at the time of writing this documentation) do not use postcodes and as such no postcode would be required for an address in that country. |
CH62 3NX |
| Country | Container | CollectionAddress | M |
The postcode. The container for defining the address country. Note this is the same container format when specifying a country anywhere in this request. |
|
| CountryID | integer | Country | C |
The country id as defined within the Transglobal Express system. Note: This value can be omitted if providing a value for CountryCode. If both CountryID and CountryCode are provided, the CountryCode value will be ignored and the country will be selected based on the CountryID value. Country id values can be discovered via the countries section of the Transglobal Express API (/Country/V2/GetCountries). |
231 |
| CountryCode | string | Country | C |
The ISO code for the country. Note: This value can be omitted if providing a value for CountryID. If both CountryID and CountryCode are provided, the CountryCode value will be ignored and the country will be selected based on the CountryID value. Country code values can be discovered via the countries section of the Transglobal Express API (/Country/V2/GetCountries). |
GB |
| IsAddressResidential | boolean | CollectionAddress | O |
Indicates whether or not the address is residential. true = Residential false = Non Residential |
true |
| EORINumber | string | CollectionAddress | C | The sender EORI Number | GBXXXXXXX |
| DeliveryAddress | |||||
| DeliveryAddress | Container | Shipment | M | The collection address container. | |
| Forename | string | DeliveryAddress | M | The forename. | Joe |
| Surname | string | DeliveryAddress | M | The surname. | Bloggs |
| Surname | string | DeliveryAddress | M | The surname. | Bloggs |
| EmailAddress | string | DeliveryAddress | M | The email address. | joe.bloggs@testsender.co.uk |
| TelephoneNumber | string | DeliveryAddress | M | The phone number. | 01234567890 |
| MobileNumber | string | DeliveryAddress | O | The mobile phone number. | 01234567890 |
| CompanyName | string | DeliveryAddress | O | The company name. | Transglobal Express |
| AddressLineOne | string | DeliveryAddress | M | The address line one. | Unit 5, The Gateway |
| AddressLineTwo | string | DeliveryAddress | O | The address line two. | Old Hall Road |
| City | string | DeliveryAddress | M | The city. | Bromborough |
| County | string | DeliveryAddress | C |
The county. While optional in most cases, when the addess is for the United States or Canada, the two letter state code must be provided here. |
Merseyside |
| Postcode | string | DeliveryAddress | C |
The postcode. This is mandatory for all countries that have a postal or zip code. It is marked as conditional here because some countries such as Ireland (at the time of writing this documentation) do not use postcodes and as such no postcode would be required for an address in that country. |
CH62 3NX |
| Country | Container | DeliveryAddress | M |
The postcode. The container for defining the address country. Note this is the same container format when specifying a country anywhere in this request. |
|
| CountryID | integer | Country | C |
The country id as defined within the Transglobal Express system. Note: This value can be omitted if providing a value for CountryCode. If both CountryID and CountryCode are provided, the CountryCode value will be ignored and the country will be selected based on the CountryID value. Country id values can be discovered via the countries section of the Transglobal Express API (/Country/V2/GetCountries). |
232 |
| CountryCode | string | Country | C |
The ISO code for the country. Note: This value can be omitted if providing a value for CountryID. If both CountryID and CountryCode are provided, the CountryCode value will be ignored and the country will be selected based on the CountryID value. Country code values can be discovered via the countries section of the Transglobal Express API (/Country/V2/GetCountries). |
US |
| IsAddressResidential | boolean | DeliveryAddress | O |
Indicates whether or not the address is residential. true = Residential false = Non Residential |
true |
| EORINumber | string | DeliveryAddress | C | The receiver EORI Number | FRXXXXXXX |
| Insurance | |||||
| Insurance | Container | GetQuoteRequest | O | The insurance container. | |
| CoverValue | decimal | Insurance | M | The value for which to cover the goods. | 119.78 |
| ExcessValue | decimal | Insurance | M | The insurance excess value. | 20 |
| GoodsAreNew | boolean | Insurance | M | Indicates whether or not the goods are in new condition. | true |
| GoodsAreFragile | boolean | Insurance | M | Indicates whether or not the goods are fragile. | false |
The responses below are based on a quote from The UK to Germany (so as to show the net and gross price differences).
{
"Status": "SUCCESS",
"Notifications": [],
"QuoteID": 1145,
"ServiceResults": [
{
"ServiceID": 87,
"ServiceName": "TG Euro Parcel",
"CarrierName": "DPD",
"ChargeableWeight": 10,
"TransitTimeEstimate": "2+",
"IsWarehouseService": true,
"TotalCost": {
"TotalCostNetWithCollection": 17.38,
"TotalCostNetWithoutCollection": 10.43,
"TotalCostGrossWithCollection": 20.86,
"TotalCostGrossWithoutCollection": 12.52
},
"ServicePriceBreakdown": [
{
"Code": "FRT",
"Description": "Freight Charge",
"Cost": 10.43
},
{
"Code": "COL",
"Description": "Collection",
"Cost": 6.95
}
],
"OptionalExtras": [
{
"Code": "INS",
"Description": "Transit Insurance",
"Cost": 5
}
],
"SignatureRequiredAvailable": false,
"ExpectedLabels": [
{
"LabelRole": "Primary",
"LabelFormat": "PDF",
"LabelGenerateStatus": "Conditional",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
},
{
"LabelRole": "Collection",
"LabelFormat": "PDF",
"LabelGenerateStatus": "Conditional",
"AvailableSizes": []
}
],
"CollectionOptions": [
{
"CollectionOptionID": 4,
"CollectionOptionTitle": "DPDCollection",
"CollectionCharge": 6.95,
"SameDayCollectionCutOffTime": "14:00",
"ExpectedLabel": {
"LabelRole": "Collection",
"LabelFormat": "PDF",
"LabelGenerateStatus": "LabelGenerated",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
}
},
{
"CollectionOptionID": 1,
"CollectionOptionTitle": "TNTCollection",
"CollectionCharge": 14.57,
"SameDayCollectionCutOffTime": "15:00",
"ExpectedLabel": {
"LabelRole": "Collection",
"LabelFormat": "PDF",
"LabelGenerateStatus": "LabelGenerated",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
}
},
{
"CollectionOptionID": 5,
"CollectionOptionTitle": "UPSCollection",
"CollectionCharge": 9.48,
"SameDayCollectionCutOffTime": "12:00",
"ExpectedLabel": {
"LabelRole": "Collection",
"LabelFormat": "PDF",
"LabelGenerateStatus": "LabelGenerated",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
}
}
],
"ServiceType": "AirAndRoad"
},
{
"ServiceID": 63,
"ServiceName": "DPD Classic",
"CarrierName": "DPD",
"ChargeableWeight": 10,
"TransitTimeEstimate": "2+",
"SameDayCollectionCutOffTime": "14:00",
"IsWarehouseService": false,
"TotalCost": {
"TotalCostNetWithCollection": 15.17,
"TotalCostNetWithoutCollection": 15.17,
"TotalCostGrossWithCollection": 18.2,
"TotalCostGrossWithoutCollection": 18.2
},
"ServicePriceBreakdown": [
{
"Code": "FRT",
"Description": "Freight Charge",
"Cost": 15.17
}
],
"OptionalExtras": [
{
"Code": "INS",
"Description": "Transit Insurance",
"Cost": 5
}
],
"SignatureRequiredAvailable": false,
"ExpectedLabels": [
{
"LabelRole": "Primary",
"LabelFormat": "PDF",
"LabelGenerateStatus": "LabelGenerated",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
}
]
},
{
"ServiceID": 53,
"ServiceName": "TG Express Worldwide",
"CarrierName": "DHL",
"ChargeableWeight": 10,
"TransitTimeEstimate": "1+",
"IsWarehouseService": true,
"TotalCost": {
"TotalCostNetWithCollection": 45.83,
"TotalCostNetWithoutCollection": 38.88,
"TotalCostGrossWithCollection": 55,
"TotalCostGrossWithoutCollection": 46.66
},
"ServicePriceBreakdown": [
{
"Code": "FRT",
"Description": "Freight Charge",
"Cost": 38.88
},
{
"Code": "COL",
"Description": "Collection",
"Cost": 6.95
}
],
"OptionalExtras": [
{
"Code": "INS",
"Description": "Transit Insurance",
"Cost": 5
}
],
"SignatureRequiredAvailable": false,
"ExpectedLabels": [
{
"LabelRole": "Primary",
"LabelFormat": "PDF",
"LabelGenerateStatus": "Conditional",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
},
{
"LabelRole": "Collection",
"LabelFormat": "PDF",
"LabelGenerateStatus": "Conditional",
"AvailableSizes": []
}
],
"CollectionOptions": [
{
"CollectionOptionID": 4,
"CollectionOptionTitle": "DPDCollection",
"CollectionCharge": 6.95,
"SameDayCollectionCutOffTime": "14:00",
"ExpectedLabel": {
"LabelRole": "Collection",
"LabelFormat": "PDF",
"LabelGenerateStatus": "LabelGenerated",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
}
},
{
"CollectionOptionID": 1,
"CollectionOptionTitle": "TNTCollection",
"CollectionCharge": 14.57,
"SameDayCollectionCutOffTime": "15:00",
"ExpectedLabel": {
"LabelRole": "Collection",
"LabelFormat": "PDF",
"LabelGenerateStatus": "LabelGenerated",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
}
},
{
"CollectionOptionID": 5,
"CollectionOptionTitle": "UPSCollection",
"CollectionCharge": 9.48,
"SameDayCollectionCutOffTime": "12:00",
"ExpectedLabel": {
"LabelRole": "Collection",
"LabelFormat": "PDF",
"LabelGenerateStatus": "LabelGenerated",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
}
}
],
"ServiceType": "Air"
},
{
"ServiceID": 23,
"ServiceName": "UPS Express Saver®",
"CarrierName": "UPS",
"ChargeableWeight": 10,
"TransitTimeEstimate": "1+",
"SameDayCollectionCutOffTime": "16:00",
"IsWarehouseService": false,
"TotalCost": {
"TotalCostNetWithCollection": 49.91,
"TotalCostNetWithoutCollection": 49.91,
"TotalCostGrossWithCollection": 59.89,
"TotalCostGrossWithoutCollection": 59.89
},
"ServicePriceBreakdown": [
{
"Code": "FRT",
"Description": "Freight Charge",
"Cost": 47.71
},
{
"Code": "RES",
"Description": "Residential Surcharge",
"Cost": 2.2
}
],
"OptionalExtras": [
{
"Code": "INS",
"Description": "Transit Insurance",
"Cost": 5
}
],
"SignatureRequiredAvailable": false,
"ExpectedLabels": [
{
"LabelRole": "Primary",
"LabelFormat": "PDF",
"LabelGenerateStatus": "LabelGenerated",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
}
],
"ServiceType": "Air"
},
{
"ServiceID": 35,
"ServiceName": "DHL Express Worldwide",
"CarrierName": "DHL",
"ChargeableWeight": 10,
"TransitTimeEstimate": "1+",
"SameDayCollectionCutOffTime": "15:30",
"IsWarehouseService": false,
"TotalCost": {
"TotalCostNetWithCollection": 73,
"TotalCostNetWithoutCollection": 73,
"TotalCostGrossWithCollection": 87.6,
"TotalCostGrossWithoutCollection": 87.6
},
"ServicePriceBreakdown": [
{
"Code": "FRT",
"Description": "Freight Charge",
"Cost": 73
}
],
"OptionalExtras": [
{
"Code": "INS",
"Description": "Transit Insurance",
"Cost": 5
}
],
"SignatureRequiredAvailable": false,
"ExpectedLabels": [
{
"LabelRole": "Primary",
"LabelFormat": "PDF",
"LabelGenerateStatus": "LabelGenerated",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
}
],
"ServiceType": "Air"
},
{
"ServiceID": 18,
"ServiceName": "TNT Economy Express",
"CarrierName": "TNT",
"ChargeableWeight": 10,
"TransitTimeEstimate": "2+",
"SameDayCollectionCutOffTime": "15:00",
"IsWarehouseService": false,
"TotalCost": {
"TotalCostNetWithCollection": 98.38,
"TotalCostNetWithoutCollection": 98.38,
"TotalCostGrossWithCollection": 118.06,
"TotalCostGrossWithoutCollection": 118.06
},
"ServicePriceBreakdown": [
{
"Code": "FRT",
"Description": "Freight Charge",
"Cost": 27.18
},
{
"Code": "STK",
"Description": "Non Stackable Surcharge",
"Cost": 71.2
}
],
"OptionalExtras": [
{
"Code": "INS",
"Description": "Transit Insurance",
"Cost": 5
}
],
"SignatureRequiredAvailable": false,
"ExpectedLabels": [
{
"LabelRole": "Primary",
"LabelFormat": "PDF",
"LabelGenerateStatus": "LabelGenerated",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
}
],
"ServiceType": "AirAndRoad"
},
{
"ServiceID": 44,
"ServiceName": "TG International Economy",
"CarrierName": "TG",
"ChargeableWeight": 10,
"TransitTimeEstimate": "3+",
"IsWarehouseService": true,
"TotalCost": {
"TotalCostNetWithCollection": 148.85,
"TotalCostNetWithoutCollection": 141.9,
"TotalCostGrossWithCollection": 178.62,
"TotalCostGrossWithoutCollection": 170.28
},
"ServicePriceBreakdown": [
{
"Code": "FRT",
"Description": "Freight Charge",
"Cost": 27.9
},
{
"Code": "STK",
"Description": "Non Stackable Surcharge",
"Cost": 114
},
{
"Code": "COL",
"Description": "Collection",
"Cost": 6.95
}
],
"OptionalExtras": [
{
"Code": "INS",
"Description": "Transit Insurance",
"Cost": 5
}
],
"SignatureRequiredAvailable": false,
"ExpectedLabels": [
{
"LabelRole": "Primary",
"LabelFormat": "PDF",
"LabelGenerateStatus": "NoLabel",
"AvailableSizes": []
},
{
"LabelRole": "Collection",
"LabelFormat": "PDF",
"LabelGenerateStatus": "Conditional",
"AvailableSizes": []
}
],
"CollectionOptions": [
{
"CollectionOptionID": 4,
"CollectionOptionTitle": "DPDCollection",
"CollectionCharge": 6.95,
"SameDayCollectionCutOffTime": "14:00",
"ExpectedLabel": {
"LabelRole": "Collection",
"LabelFormat": "PDF",
"LabelGenerateStatus": "LabelGenerated",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
}
},
{
"CollectionOptionID": 1,
"CollectionOptionTitle": "TNTCollection",
"CollectionCharge": 14.57,
"SameDayCollectionCutOffTime": "15:00",
"ExpectedLabel": {
"LabelRole": "Collection",
"LabelFormat": "PDF",
"LabelGenerateStatus": "LabelGenerated",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
}
},
{
"CollectionOptionID": 5,
"CollectionOptionTitle": "UPSCollection",
"CollectionCharge": 9.48,
"SameDayCollectionCutOffTime": "12:00",
"ExpectedLabel": {
"LabelRole": "Collection",
"LabelFormat": "PDF",
"LabelGenerateStatus": "LabelGenerated",
"AvailableSizes": [
{
"Size": "A4"
},
{
"Size": "Thermal"
}
]
}
}
],
"ServiceType": "Air"
}
]
}
<GetQuoteResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.transglobalexpress.co.uk/API/V2">
<Status>SUCCESS</Status>
<Notifications />
<QuoteID>1146</QuoteID>
<ServiceResults>
<ServiceQuoteResult>
<ServiceID>87</ServiceID>
<ServiceName>TG Euro Parcel</ServiceName>
<CarrierName>DPD</CarrierName>
<ChargeableWeight>10.00</ChargeableWeight>
<TransitTimeEstimate>2+</TransitTimeEstimate>
<IsWarehouseService>true</IsWarehouseService>
<TotalCost>
<TotalCostNetWithCollection>17.38</TotalCostNetWithCollection>
<TotalCostNetWithoutCollection>10.43</TotalCostNetWithoutCollection>
<TotalCostGrossWithCollection>20.86</TotalCostGrossWithCollection>
<TotalCostGrossWithoutCollection>12.52</TotalCostGrossWithoutCollection>
</TotalCost>
<ServicePriceBreakdown>
<PriceElement>
<Code>FRT</Code>
<Description>Freight Charge</Description>
<Cost>10.43</Cost>
</PriceElement>
<PriceElement>
<Code>COL</Code>
<Description>Collection</Description>
<Cost>6.95</Cost>
</PriceElement>
</ServicePriceBreakdown>
<OptionalExtras>
<PriceElement>
<Code>INS</Code>
<Description>Transit Insurance</Description>
<Cost>5</Cost>
</PriceElement>
</OptionalExtras>
<SignatureRequiredAvailable>false</SignatureRequiredAvailable>
<ExpectedLabels>
<ExpectedLabel>
<LabelRole>Primary</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>Conditional</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
<ExpectedLabel>
<LabelRole>Collection</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>Conditional</LabelGenerateStatus>
<AvailableSizes />
</ExpectedLabel>
</ExpectedLabels>
<CollectionOptions>
<ServiceResultCollectionOption>
<CollectionOptionID>4</CollectionOptionID>
<CollectionOptionTitle>DPDCollection</CollectionOptionTitle>
<CollectionCharge>6.95</CollectionCharge>
<SameDayCollectionCutOffTime>14:00</SameDayCollectionCutOffTime>
<ExpectedLabel>
<LabelRole>Collection</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>LabelGenerated</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
</ServiceResultCollectionOption>
<ServiceResultCollectionOption>
<CollectionOptionID>1</CollectionOptionID>
<CollectionOptionTitle>TNTCollection</CollectionOptionTitle>
<CollectionCharge>14.57</CollectionCharge>
<SameDayCollectionCutOffTime>15:00</SameDayCollectionCutOffTime>
<ExpectedLabel>
<LabelRole>Collection</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>LabelGenerated</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
</ServiceResultCollectionOption>
<ServiceResultCollectionOption>
<CollectionOptionID>5</CollectionOptionID>
<CollectionOptionTitle>UPSCollection</CollectionOptionTitle>
<CollectionCharge>9.48</CollectionCharge>
<SameDayCollectionCutOffTime>12:00</SameDayCollectionCutOffTime>
<ExpectedLabel>
<LabelRole>Collection</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>LabelGenerated</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
</ServiceResultCollectionOption>
</CollectionOptions>
<ServiceType>AirAndRoad</ServiceType>
</ServiceQuoteResult>
<ServiceQuoteResult>
<ServiceID>63</ServiceID>
<ServiceName>DPD Classic</ServiceName>
<CarrierName>DPD</CarrierName>
<ChargeableWeight>10.00</ChargeableWeight>
<TransitTimeEstimate>2+</TransitTimeEstimate>
<SameDayCollectionCutOffTime>14:00</SameDayCollectionCutOffTime>
<IsWarehouseService>false</IsWarehouseService>
<TotalCost>
<TotalCostNetWithCollection>15.17</TotalCostNetWithCollection>
<TotalCostNetWithoutCollection>15.17</TotalCostNetWithoutCollection>
<TotalCostGrossWithCollection>18.20</TotalCostGrossWithCollection>
<TotalCostGrossWithoutCollection>18.20</TotalCostGrossWithoutCollection>
</TotalCost>
<ServicePriceBreakdown>
<PriceElement>
<Code>FRT</Code>
<Description>Freight Charge</Description>
<Cost>15.17</Cost>
</PriceElement>
</ServicePriceBreakdown>
<OptionalExtras>
<PriceElement>
<Code>INS</Code>
<Description>Transit Insurance</Description>
<Cost>5</Cost>
</PriceElement>
</OptionalExtras>
<SignatureRequiredAvailable>false</SignatureRequiredAvailable>
<ExpectedLabels>
<ExpectedLabel>
<LabelRole>Primary</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>LabelGenerated</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
</ExpectedLabels>
<ServiceType>AirAndRoad</ServiceType>
</ServiceQuoteResult>
<ServiceQuoteResult>
<ServiceID>53</ServiceID>
<ServiceName>TG Express Worldwide</ServiceName>
<CarrierName>DHL</CarrierName>
<ChargeableWeight>10.00</ChargeableWeight>
<TransitTimeEstimate>1+</TransitTimeEstimate>
<IsWarehouseService>true</IsWarehouseService>
<TotalCost>
<TotalCostNetWithCollection>45.83</TotalCostNetWithCollection>
<TotalCostNetWithoutCollection>38.88</TotalCostNetWithoutCollection>
<TotalCostGrossWithCollection>55.00</TotalCostGrossWithCollection>
<TotalCostGrossWithoutCollection>46.66</TotalCostGrossWithoutCollection>
</TotalCost>
<ServicePriceBreakdown>
<PriceElement>
<Code>FRT</Code>
<Description>Freight Charge</Description>
<Cost>38.88</Cost>
</PriceElement>
<PriceElement>
<Code>COL</Code>
<Description>Collection</Description>
<Cost>6.95</Cost>
</PriceElement>
</ServicePriceBreakdown>
<OptionalExtras>
<PriceElement>
<Code>INS</Code>
<Description>Transit Insurance</Description>
<Cost>5</Cost>
</PriceElement>
</OptionalExtras>
<SignatureRequiredAvailable>false</SignatureRequiredAvailable>
<ExpectedLabels>
<ExpectedLabel>
<LabelRole>Primary</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>Conditional</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
<ExpectedLabel>
<LabelRole>Collection</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>Conditional</LabelGenerateStatus>
<AvailableSizes />
</ExpectedLabel>
</ExpectedLabels>
<CollectionOptions>
<ServiceResultCollectionOption>
<CollectionOptionID>4</CollectionOptionID>
<CollectionOptionTitle>DPDCollection</CollectionOptionTitle>
<CollectionCharge>6.95</CollectionCharge>
<SameDayCollectionCutOffTime>14:00</SameDayCollectionCutOffTime>
<ExpectedLabel>
<LabelRole>Collection</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>LabelGenerated</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
</ServiceResultCollectionOption>
<ServiceResultCollectionOption>
<CollectionOptionID>1</CollectionOptionID>
<CollectionOptionTitle>TNTCollection</CollectionOptionTitle>
<CollectionCharge>14.57</CollectionCharge>
<SameDayCollectionCutOffTime>15:00</SameDayCollectionCutOffTime>
<ExpectedLabel>
<LabelRole>Collection</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>LabelGenerated</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
</ServiceResultCollectionOption>
<ServiceResultCollectionOption>
<CollectionOptionID>5</CollectionOptionID>
<CollectionOptionTitle>UPSCollection</CollectionOptionTitle>
<CollectionCharge>9.48</CollectionCharge>
<SameDayCollectionCutOffTime>12:00</SameDayCollectionCutOffTime>
<ExpectedLabel>
<LabelRole>Collection</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>LabelGenerated</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
</ServiceResultCollectionOption>
</CollectionOptions>
<ServiceType>Air</ServiceType>
</ServiceQuoteResult>
<ServiceQuoteResult>
<ServiceID>23</ServiceID>
<ServiceName>UPS Express Saver®</ServiceName>
<CarrierName>UPS</CarrierName>
<ChargeableWeight>10.00</ChargeableWeight>
<TransitTimeEstimate>1+</TransitTimeEstimate>
<SameDayCollectionCutOffTime>16:00</SameDayCollectionCutOffTime>
<IsWarehouseService>false</IsWarehouseService>
<TotalCost>
<TotalCostNetWithCollection>49.91</TotalCostNetWithCollection>
<TotalCostNetWithoutCollection>49.91</TotalCostNetWithoutCollection>
<TotalCostGrossWithCollection>59.89</TotalCostGrossWithCollection>
<TotalCostGrossWithoutCollection>59.89</TotalCostGrossWithoutCollection>
</TotalCost>
<ServicePriceBreakdown>
<PriceElement>
<Code>FRT</Code>
<Description>Freight Charge</Description>
<Cost>47.71</Cost>
</PriceElement>
<PriceElement>
<Code>RES</Code>
<Description>Residential Surcharge</Description>
<Cost>2.20</Cost>
</PriceElement>
</ServicePriceBreakdown>
<OptionalExtras>
<PriceElement>
<Code>INS</Code>
<Description>Transit Insurance</Description>
<Cost>5</Cost>
</PriceElement>
</OptionalExtras>
<SignatureRequiredAvailable>false</SignatureRequiredAvailable>
<ExpectedLabels>
<ExpectedLabel>
<LabelRole>Primary</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>LabelGenerated</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
</ExpectedLabels>
<ServiceType>Air</ServiceType>
</ServiceQuoteResult>
<ServiceQuoteResult>
<ServiceID>35</ServiceID>
<ServiceName>DHL Express Worldwide</ServiceName>
<CarrierName>DHL</CarrierName>
<ChargeableWeight>10.00</ChargeableWeight>
<TransitTimeEstimate>1+</TransitTimeEstimate>
<SameDayCollectionCutOffTime>15:30</SameDayCollectionCutOffTime>
<IsWarehouseService>false</IsWarehouseService>
<TotalCost>
<TotalCostNetWithCollection>73.00</TotalCostNetWithCollection>
<TotalCostNetWithoutCollection>73.00</TotalCostNetWithoutCollection>
<TotalCostGrossWithCollection>87.60</TotalCostGrossWithCollection>
<TotalCostGrossWithoutCollection>87.60</TotalCostGrossWithoutCollection>
</TotalCost>
<ServicePriceBreakdown>
<PriceElement>
<Code>FRT</Code>
<Description>Freight Charge</Description>
<Cost>73.00</Cost>
</PriceElement>
</ServicePriceBreakdown>
<OptionalExtras>
<PriceElement>
<Code>INS</Code>
<Description>Transit Insurance</Description>
<Cost>5</Cost>
</PriceElement>
</OptionalExtras>
<SignatureRequiredAvailable>false</SignatureRequiredAvailable>
<ExpectedLabels>
<ExpectedLabel>
<LabelRole>Primary</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>LabelGenerated</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
</ExpectedLabels>
<ServiceType>Air</ServiceType>
</ServiceQuoteResult>
<ServiceQuoteResult>
<ServiceID>18</ServiceID>
<ServiceName>TNT Economy Express</ServiceName>
<CarrierName>TNT</CarrierName>
<ChargeableWeight>10.00</ChargeableWeight>
<TransitTimeEstimate>2+</TransitTimeEstimate>
<SameDayCollectionCutOffTime>15:00</SameDayCollectionCutOffTime>
<IsWarehouseService>false</IsWarehouseService>
<TotalCost>
<TotalCostNetWithCollection>98.38</TotalCostNetWithCollection>
<TotalCostNetWithoutCollection>98.38</TotalCostNetWithoutCollection>
<TotalCostGrossWithCollection>118.06</TotalCostGrossWithCollection>
<TotalCostGrossWithoutCollection>118.06</TotalCostGrossWithoutCollection>
</TotalCost>
<ServicePriceBreakdown>
<PriceElement>
<Code>FRT</Code>
<Description>Freight Charge</Description>
<Cost>27.18</Cost>
</PriceElement>
<PriceElement>
<Code>STK</Code>
<Description>Non Stackable Surcharge</Description>
<Cost>71.20</Cost>
</PriceElement>
</ServicePriceBreakdown>
<OptionalExtras>
<PriceElement>
<Code>INS</Code>
<Description>Transit Insurance</Description>
<Cost>5</Cost>
</PriceElement>
</OptionalExtras>
<SignatureRequiredAvailable>false</SignatureRequiredAvailable>
<ExpectedLabels>
<ExpectedLabel>
<LabelRole>Primary</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>LabelGenerated</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
</ExpectedLabels>
<ServiceType>AirAndRoad</ServiceType>
</ServiceQuoteResult>
<ServiceQuoteResult>
<ServiceID>44</ServiceID>
<ServiceName>TG International Economy</ServiceName>
<CarrierName>TG</CarrierName>
<ChargeableWeight>10.00</ChargeableWeight>
<TransitTimeEstimate>3+</TransitTimeEstimate>
<IsWarehouseService>true</IsWarehouseService>
<TotalCost>
<TotalCostNetWithCollection>148.85</TotalCostNetWithCollection>
<TotalCostNetWithoutCollection>141.90</TotalCostNetWithoutCollection>
<TotalCostGrossWithCollection>178.62</TotalCostGrossWithCollection>
<TotalCostGrossWithoutCollection>170.28</TotalCostGrossWithoutCollection>
</TotalCost>
<ServicePriceBreakdown>
<PriceElement>
<Code>FRT</Code>
<Description>Freight Charge</Description>
<Cost>27.90</Cost>
</PriceElement>
<PriceElement>
<Code>STK</Code>
<Description>Non Stackable Surcharge</Description>
<Cost>114.00</Cost>
</PriceElement>
<PriceElement>
<Code>COL</Code>
<Description>Collection</Description>
<Cost>6.95</Cost>
</PriceElement>
</ServicePriceBreakdown>
<OptionalExtras>
<PriceElement>
<Code>INS</Code>
<Description>Transit Insurance</Description>
<Cost>5</Cost>
</PriceElement>
</OptionalExtras>
<SignatureRequiredAvailable>false</SignatureRequiredAvailable>
<ExpectedLabels>
<ExpectedLabel>
<LabelRole>Primary</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>NoLabel</LabelGenerateStatus>
<AvailableSizes />
</ExpectedLabel>
<ExpectedLabel>
<LabelRole>Collection</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>Conditional</LabelGenerateStatus>
<AvailableSizes />
</ExpectedLabel>
</ExpectedLabels>
<CollectionOptions>
<ServiceResultCollectionOption>
<CollectionOptionID>4</CollectionOptionID>
<CollectionOptionTitle>DPDCollection</CollectionOptionTitle>
<CollectionCharge>6.95</CollectionCharge>
<SameDayCollectionCutOffTime>14:00</SameDayCollectionCutOffTime>
<ExpectedLabel>
<LabelRole>Collection</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>LabelGenerated</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
</ServiceResultCollectionOption>
<ServiceResultCollectionOption>
<CollectionOptionID>1</CollectionOptionID>
<CollectionOptionTitle>TNTCollection</CollectionOptionTitle>
<CollectionCharge>14.57</CollectionCharge>
<SameDayCollectionCutOffTime>15:00</SameDayCollectionCutOffTime>
<ExpectedLabel>
<LabelRole>Collection</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>LabelGenerated</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
</ServiceResultCollectionOption>
<ServiceResultCollectionOption>
<CollectionOptionID>5</CollectionOptionID>
<CollectionOptionTitle>UPSCollection</CollectionOptionTitle>
<CollectionCharge>9.48</CollectionCharge>
<SameDayCollectionCutOffTime>12:00</SameDayCollectionCutOffTime>
<ExpectedLabel>
<LabelRole>Collection</LabelRole>
<LabelFormat>PDF</LabelFormat>
<LabelGenerateStatus>LabelGenerated</LabelGenerateStatus>
<AvailableSizes>
<LabelSize>
<Size>A4</Size>
</LabelSize>
<LabelSize>
<Size>Thermal</Size>
</LabelSize>
</AvailableSizes>
</ExpectedLabel>
</ServiceResultCollectionOption>
</CollectionOptions>
<ServiceType>Air</ServiceType>
</ServiceQuoteResult>
</ServiceResults>
</GetQuoteResponse>
{
"Status": "FAIL",
"Notifications": [
{
"Message": "ItemType is required",
"Severity": "ERROR"
},
{
"Message": "Package 1 Commodity 2: CommodityCode is required",
"Severity": "ERROR"
},
{
"Message": "Collection Address: AddressLineOne is required",
"Severity": "ERROR"
}
],
"QuoteID": 0,
"ServiceResults": []
}
<GetQuoteResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.transglobalexpress.co.uk/API/V2">
<Status>FAIL</Status>
<Notifications>
<Notification>
<Message>ItemType is required</Message>
<Severity>ERROR</Severity>
</Notification>
<Notification>
<Message>Package 1 Commodity 2: CommodityCode is required</Message>
<Severity>ERROR</Severity>
</Notification>
<Notification>
<Message>Collection Address: AddressLineOne is required</Message>
<Severity>ERROR</Severity>
</Notification>
</Notifications>
<QuoteID>0</QuoteID>
<ServiceResults />
</GetQuoteResponse>
| Property Name | Data Type | Parent | M | Comment | Example |
|---|---|---|---|---|---|
| GetQuoteResponse | string | M |
The root element of the response. When returning JSON this is not explicitly named but is instead the object container of the response. |
SUCCESS | |
| Status | string | GetQuoteResponse | M |
The status indicating whe success of the request. Possible values are: SUCCESS, PARTIAL, FAIL, ERROR |
SUCCESS |
| Notifications | Container | GetQuoteResponse | M |
The container for list of notifications. Can be empty. |
|
| Notification | |||||
| Notification | Container | Notifications | M |
The container for notifications information. When using JSON this element is not explicitly named, instead the Notifications property is a list of anonymous objects containing the notification data. |
|
| Message | string | Notification | M | The notification message. | Authentication Failed |
| Severity | string | Notification | M | The notification severity level. | ERROR |
| QuoteID | integer | GetQuoteResponse | M |
The quote id that can be used to book a service contained in the
results via the book section of the API. If the quote request fails the quote id will be 0 and will not be usable. |
160 |
| ServiceResults | |||||
| ServiceResults | Container | GetQuoteResponse | M | The container for the list of service results. | |
| ServiceQuoteResult | Container | ServiceResults | M |
The container for the service result. When using JSON this element is not explicitly named, instead the ServiceResults property is a list of anonymous objects containing the service result data. |
|
| ServiceID | integer | ServiceQuoteResult | M | The service id. This value is used to identify the service to be booked when placing an order via the book section of the API. | 53 |
| ServiceName | string | ServiceQuoteResult | M | The service name. | TG Express Worldwide |
| CarrierName | string | ServiceQuoteResult | M | The carrier name. | DHL |
| ChargeableWeight | string | ServiceQuoteResult | M | The chargeable weight the freight pricing is based on. Each carrier has a formula for calculating the "volumetric" weight of a consignment. The chargeable is the greater of the stated and volumetric weights. | 18.58 |
| TransitTimeEstimate | string | ServiceQuoteResult | O | The transit time estimate. | 1-2 days |
| SameDayCollectionCutOffTime | string | ServiceResultCollectionOption | O |
The cut off time for placing a same day collection. This will only be returned if we have access to the information and the cut off time has not already passed at the time of getting the quote. |
14:30 |
| IsWarehouseService | boolean | ServiceQuoteResult | M |
Indicates whether or not the service is a "warehouse service". A warehouse service means the consignment will first have to come to our warehouse depot before being sent on to the final destination, either by collection if a collection is booked or by some other means if a collection is not booked. |
true |
| TotalCost | |||||
| TotalCost | Container | GetQuoteResponse | M | The container for the total cost summary. | |
| TotalCostNetWithCollection | decimal | TotalCost | M | The total cost net value when including collection cost. | 25.00 |
| TotalCostNetWithoutCollection | decimal | TotalCost | M | The total cost net value when excluding collection cost. | 20.00 |
| TotalCostGrossWithCollection | decimal | TotalCost | M | The total cost gross value when including collection cost. | 30.00 |
| TotalCostGrossWithoutCollection | decimal | TotalCost | M | The total cost gross value when excluding collection cost. | 24.00 |
| ServicePriceBreakdown | |||||
| ServicePriceBreakdown | Container | ServiceQuoteResult | M |
The container for the service price breakdown. Items within this container show a break down of how the values in TotalCost where calculated. |
|
| PriceElement | Container | ServicePriceBreakdown | M |
The container for price element data. When using JSON this element is not explicitly named, instead the ServicePriceBreakdown property is a list of anonymous objects containing the price element data. |
|
| Code | string | PriceElement | M | The code identifier for the price element. | FRT |
| Description | string | PriceElement | M | The price element description. | Freight Charge |
| Cost | string | PriceElement | M |
The price element cost. The cost is Net value. |
7.51 |
| OptionalExtras | |||||
| OptionalExtras | Container | ServiceQuoteResult | M |
The container for optional extras that can be booked. The elements within this container are not included as part of the TotalCost price figures, and the cost of any element selected at time of booking will be added onto the amount you are billed for the order. |
|
| PriceElement | Container | OptionalExtras | M |
The container for price element data. When using JSON this element is not explicitly named, instead the OptionalExtras property is a list of anonymous objects containing the price element data. |
|
| Code | string | PriceElement | M | The code identifier for the price element. | INS |
| Description | string | PriceElement | M | The price element description. | Transit Insurance |
| Cost | string | PriceElement | M |
The price element cost. The cost is Net value. |
5.00 |
| SignatureRequiredAvailable | boolean | ServiceQuoteResult | M | Indicates whether or not the signature required option is available. | true |
| ExpectedLabels | |||||
| ExpectedLabels | Container | ServiceQuoteResult | M |
Container for data pertaining what labels can be expected upon a successful booking. While in most cases when placing a successful order a label would be immediately available for you to download and print, this is not always the case. There are services that don't return a label (at time of writing instances of these would only ever be a "warehouse service"), and there are times when returning a label would be conditional. An example of this is when booking certain warehouses, a primary label will only be returned if a collection is not booked. If a collection is booked, the collection label is returned, and the primary label will be printed and attached by Transglobal Express once the consignmnt reaches our warehouse depot. To manage expectations of what you are expecting to see in a response, this section indicates what labels you should expect to receive upon a successful booking and the roles they play in the shipment. |
|
| ExpectedLabel | Container | ExpectedLabels | M |
The container for expected label data. When using JSON this element is not explicitly named, instead the ExpectedLabels property is a list of anonymous objects containing the expected label data. |
|
| LabelRole | string | ExpectedLabel | M |
The role the label plays within the shipment. The options are: Primary, Collection. |
Primary |
| LabelFormat | string | ExpectedLabel | M |
The format the label will be returned in. Currently labels are all returned in PDF format. |
|
| LabelGenerateStatus | string | ExpectedLabel | M |
The status indicating whether or not the label is expected in
the response. The options are: LabelGenerated - The label will be generated and returned in the response. Conditional - The label is not guaranteed to be returned in the response. NoLabel - The label will not be returned in the response. |
LabelGenerated |
| AvailableSizes | Container | ExpectedLabel | M | The container for the available sizes of the expected label. | |
| LabelSize | Container | AvailableSizes | M |
The container for label size data. When using JSON this element is not explicitly named, instead the AvailableSizes property is a list of anonymous objects containing the expected label data. If the LabelGenerateStatus is "Conditional" or "NoLabel" Then no items will be contained within this collection, as either no label will be generated (and as such sizes don't apply) or it is not known whether or not whether or not a label will be generated (likely to be the case when defining the expected collection label for a service with different collection options) |
|
| Size | Container | LabelSize | M | The label Size. Options are "A4" or "Thermal". | A4 |
| CollectionOptions | |||||
| CollectionOptions | Container | ServiceQuoteResult | O | The container for the service collection options. | |
| ServiceResultCollectionOption | Container | CollectionOptions | M |
The container for the service collection option data. When using JSON this element is not explicitly named, instead the CollectionOptions property is a list of anonymous objects containing the service collection option data. |
|
| CollectionOptionID | integer | ServiceResultCollectionOption | M |
The collection option id. This value is used to explicitly select the collection option when placing an order. |
1 |
| CollectionOptionTitle | string | ServiceResultCollectionOption | M | The collection option name. | TNTCollection |
| CollectionCharge | decimal | ServiceResultCollectionOption | M | The collection option cost (net). | 14.57 |
| SameDayCollectionCutOffTime | string | ServiceResultCollectionOption | O |
The cut off time for placing a same day collection. This will only be returned if we have access to the information and the cut off time has not already passed at the time of getting the quote. |
14:30 |
| ExpectedLabel | Container | ServiceResultCollectionOption | M | The container for expected label data. | |
| LabelRole | string | ExpectedLabel | M |
The role the label plays within the shipment. The options are: Primary, Collection. |
Primary |
| LabelFormat | string | ExpectedLabel | M |
The format the label will be returned in. Currently labels are all returned in PDF format. |
|
| LabelGenerateStatus | string | ExpectedLabel | M |
The status indicating whether or not the label is expected in
the response. The options are: LabelGenerated - The label will be generated and returned in the response. NoLabel - The label will not be returned in the response. |
LabelGenerated |
| ServiceType | string | ServiceQuoteResult | M |
The type of service The options are: Air - Air service. Road - Road service. AirAndRoad - Air and/or Road service. |
LabelGenerated |