Repository navigation
Examples
A few shipping products and services do require additional input from the user. A few of those special cases are illustrated with examples here. Please contact us if you are going to use such a service that is not listed here. Most other services has no other attributes.They are only specified with an id attribute on the <service> element like this:
<service id="postnord_notification_sms" />Bring - Betale ved utlevering (COD)
<service id="bring2_cash_on_delivery">
<amount>4571</amount>
<account>34541024533</account>
<currency>NOK</currency>
<reference>1000076353545222</reference> <-- Optional -->
</service>Bring - Valgfritt Hentested
<service id="bring2_choice_of_pickup_point" />
<parts>
...
...
<service_partner>
<number>2645534</number>
<name>Extra Brandbu</name>
<address1>Torgvegen 3</address1>
<postcode>2760</postcode>
<city>BRANDBU</city>
<country>NO</country>
</service_partner>
...
...
</parts>Note: When shipping abroad you must include a <customer-number> element.
This element is also returned from the Service Point API.
<service id="bring_valgfritt_postkontor" />
<parts>
...
...
<service-partner>
<number>599358</number>
<customer-number>c===0010</customer-number>
<name>OKQ8 BORGHOLM</name>
<address1>STORGATAN 77</address1>
<address2/>
<postcode>38734</postcode>
<city>Borgholm</city>
<country>SE</country>
</service-partner>
....
....
</parts>
Bring - Leveringsdato
<service id="bring2_delivery_date">
<date>2023-08-27</date> <!-- required -->
</service>Bring - Tilleggsforsikring
<service id="bring2_optional_insurance" />
In addition you must add insurance amount and item description for each item/parcel:
<items>
<item type="package" amount="1" weight="1" description="Handbags" insurance_amount="890" />
</items>
Bring - Pallehåndtering
<service id="bring2_pallet_handling">
<num_pallets>2</num_pallets> <!-- required -->
</service>Bring - Pickup Order
<service id="bring2_pickup_order">
<date>2023-08-15</date>
<time>13:00</time>
<message>Ring Paul på lageret</message>
</service>Bring - Tidsvindu for henting og levering
<service id="bring2_time_window_delivery">
<earliest>2023-08-15T13:00:00</earliest>
<latest>2023-08-15T16:00:00</latest> <!-- required -->
</service>
<service id="bring2_time_window_pickup">
<earliest>2023-08-15T13:00:00</earliest> <!-- required -->
<latest>2023-08-15T16:00:00</latest>
</service>DHL Express - Electronic Invoice
All possible values shown here. Please contact DHL Express for further details
<service id="dhl_express_electronic_invoice_edi">
<consignor_eori_no></consignor_eori_no>
<consignor_eori_country></consignor_eori_country>
<consignor_tax_id_vat_no></consignor_tax_id_vat_no>
<consignor_tax_id_vat_country></consignor_tax_id_vat_country>
<consignor_ioss_osr_lvg_voec_no>string</consignor_ioss_osr_lvg_voec_no>
<consignor_ioss_osr_lvg_voec_country>string</consignor_ioss_osr_lvg_voec_country>
<consignee_tax_id_vat_no></consignee_tax_id_vat_no>
<consignee_tax_id_vat_country></consignee_tax_id_vat_country>
<consignee_ioss_osr_lvg_voec_no>string</consignee_ioss_osr_lvg_voec_no>
<consignee_ioss_osr_lvg_voec_country>string</consignee_ioss_osr_lvg_voec_country>
<consignee_eori_no>string</consignee_eori_no>
<consignee_eori_country>string</consignee_eori_country>
<billed_to_name>Mr Joe</billed_to_name>
<billed_to_address1>Street 3</billed_to_address1>
<billed_to_address2></billed_to_address2>
<billed_to_country>IT</billed_to_country>
<billed_to_postcode>232522</billed_to_postcode>
<billed_to_city>Roma</billed_to_city>
<billed_to_phone></billed_to_phone>
<billed_to_tax_id_vat_no></billed_to_tax_id_vat_no>
<billed_to_tax_id_vat_country></billed_to_tax_id_vat_country>
<billed_to_contact_name>string</billed_to_contact_name>
<billed_to_email>string</billed_to_email>
<billed_to_eori_no>string</billed_to_eori_no>
<billed_to_eori_country>string</billed_to_eori_country>
<billed_to_ioss_osr_lvg_voec_no>string</billed_to_ioss_osr_lvg_voec_no>
<billed_to_ioss_osr_lvg_voec_country>string</billed_to_ioss_osr_lvg_voec_country>
<bank_inn></bank_inn>
<bank_ogrn></bank_ogrn>
<bank_kpp></bank_kpp>
<bank_okpo></bank_okpo>
<bank_settlement_account_usd_eur></bank_settlement_account_usd_eur>
<bank_settlement_account_rur></bank_settlement_account_rur>
<bank_name></bank_name>
<invoice_number></invoice_number> <!-- REQUIRED -->
<exporter_id></exporter_id>
<exporter_code></exporter_code>
<exporter_name>string</exporter_name>
<exporter_address1>string</exporter_address1>
<exporter_address2>string</exporter_address2>
<exporter_country>string</exporter_country>
<exporter_postcode>string</exporter_postcode>
<exporter_city>string</exporter_city>
<exporter_phone>string</exporter_phone>
<exporter_contact_name>string</exporter_contact_name>
<exporter_email>string</exporter_email>
<exporter_tax_id_vat_no>string</exporter_tax_id_vat_no>
<exporter_tax_id_vat_country>string</exporter_tax_id_vat_country>
<exporter_eori_no>string</exporter_eori_no>
<exporter_eori_country>string</exporter_eori_country>
<exporter_ioss_osr_lvg_voec_no>string</exporter_ioss_osr_lvg_voec_no>
<exporter_ioss_osr_lvg_voec_country>string</exporter_ioss_osr_lvg_voec_country>
<other_remarks></other_remarks>
<reason_for_export>ENUM</reason_for_export> <!-- REQUIRED -->
<type_of_export>ENUM</type_of_export> <!-- REQUIRED -->
<other_charges></other_charges>
<freight_cost></freight_cost>
<insurance_cost></insurance_cost>
<total_goods_value>decimal</total_goods_value> <!-- REQUIRED -->
<currency_code></currency_code> <!-- REQUIRED -->
<terms_of_payment></terms_of_payment> <!-- REQUIRED -->
<payer_of_gst_vat></payer_of_gst_vat>
<duty_taxes_acct>Receiver Will Pay</duty_taxes_acct>
<duty_tax_billing_service></duty_tax_billing_service>
<requiere_pedimento></requiere_pedimento>
<ultimate_consignee></ultimate_consignee>
<exemption_citation></exemption_citation>
<type_of_invoice>ENUM</type_of_invoice> <!-- only commercial allowed -->
<customs_clearance_instructions>string</customs_clearance_instructions>
<place_of_incoterms>string</place_of_incoterms>
<signature>string</signature>
<signature_name>string</signature_name>
<invoice_date_time>DateTime: Eks: 2023-02-21T12:05</invoice_date_time> <!-- REQUIRED -->
<export_or_import>ENUM</export_or_import> <!-- REQUIRED -->
<commercial_or_personal>ENUM</commercial_or_personal> <!-- REQUIRED -->
<origin_declaration_text_with_or_without_exporter_id>string</origin_declaration_text_with_or_without_exporter_id>
<data> <!-- REQUIRED -->
{
"items": [
{
"description": "Batteries",
"commodity_code": "BT123",
"quantity": 300,
"unit_value": 0.5,
"sub_total_value": 150,
"net_weight": 10,
"gross_weight": 15,
"country_of_origin": "DK"
"part_number": "string",
"eccn_number": "string",
"sku_number": "string",
"gst_paid": boolean,
"original_export_date": "string: eks: 2022-01-01",
"original_outbound_carrier": "string",
"original_export_tracking_id": "string",
"dds": "12345",
"taric": "64324",
"merchant_product_id": "MPID123",
"non_standardized_manufacturer_product_id": "NSMPID123",
"standardized_manufacturer_product_id": "SMPID123"
},
{
"description": "Flux Capacitor",
"commodity_code": "FX3000",
"quantity": 1,
"unit_value": 10,
"sub_total_value": 10,
"net_weight": 500,
"gross_weight": 500,
"country_of_origin": "DE"
"part_number": "string",
"eccn_number": "string",
"sku_number": "string",
"gst_paid": boolean,
"original_export_date": "string: eks: 2022-01-01",
"original_outbound_carrier": "string",
"original_export_tracking_id": "string",
"dds": "757534",
"taric": "2323",
"merchant_product_id": "MPID123",
"non_standardized_manufacturer_product_id": "NSMPID123",
"standardized_manufacturer_product_id": "SMPID123"
},
{
"description": "Units",
"commodity_code": "XX99",
"quantity": 45,
"unit_value": 1.99,
"sub_total_value": 89.55,
"net_weight": 2,
"gross_weight": 3.5,
"country_of_origin": "FI"
"part_number": "string",
"eccn_number": "string",
"sku_number": "string",
"gst_paid": boolean,
"original_export_date": "string: eks: 2022-01-01",
"original_outbound_carrier": "string",
"original_export_tracking_id": "string",
"dds": "5555",
"taric": "33333",
"merchant_product_id": "MPID123",
"non_standardized_manufacturer_product_id": "NSMPID123",
"standardized_manufacturer_product_id": "SMPID123"
}
]
}
</data>
</service> Here is the list of ENUM values for those fields marked as ENUM above:
type_of_export: permanent, temporary, return, repair
reason_for_export: P, T, D, M, I, C, E, S, G, U, W, D, F, R
P PERMANENT
R RETURN FOR REPAIR T TEMPORARY
M USED EXIBITION GOODS TO ORIGIN
I INTERCOMPANY_USE
C COMMERCIAL PURPOSE/ SALE
E PERSONAL BELONGINGS/PERSONAL USE S SAMPLE G GIFT
U RETURN TO ORIGIN
W WARRANTY REPLACEMENT D DIPLOMATIC GOODS F DEFENCE MATERIAL
commercial_or_personal: commercial, personal
export_or_import: import, export
type_of_invoice: proforma, commercial (Currently DHL Express only supports 'commercial')
data: These keys in items are required
{
"items": [
{
"commodity_code": "FX3000",
"country_of_origin": "CN",
"description": "Batteries",
"net_weight": 10,
"quantity": 300,
"sub_total_value": 150,
"unit_value": 0.5
}
]
}Example With Minimum Required Values
<service id="dhl_express_electronic_invoice_edi">
<reason_for_export>R</reason_for_export>
<type_of_export>repair</type_of_export>
<type_of_invoice>commercial</type_of_invoice>
<invoice_number>74635533</invoice_number>
<currency_code>EUR</currency_code>
<export_or_import>export</export_or_import>
<commercial_or_personal>personal</commercial_or_personal>
<invoice_date_time>2023-02-21T12:05</invoice_date_time>
<total_goods_value>342.50</total_goods_value>
<terms_of_payment>DDP</terms_of_payment>
<data>
{
"items": [
{
"quantity": 300,
"unit_value": 0.5,
"sub_total_value": 150,
"net_weight": 10,
"country_of_origin": "CN",
"description": "Batteries",
"commodity_code": "FX3000"
}
]
}
</data>
</service>Example of Return Shipment (import)
<?xml version="1.0" encoding="UTF-8"?>
<consignments>
<consignment print="false" transport_agreement="27317">
<product>dhl_express_worldwide_nondoc</product>
<parts>
<consignee>
<name>Hieu Lie</name>
<address1>Sætreberget 22</address1>
<country>SE</country>
<postcode>12346</postcode>
<city>Stockholm</city>
</consignee>
</parts>
<items>
<item amount="1" description="test1" type="package" weight="0.5"/>
</items>
<tod city="Stockholm" code="DAP" country="SE" postcode="12346"/>
<services>
<service id="dhl_express_return"/>
<service id="dhl_express_customs_value">
<amount>6300.00</amount>
<currency>nok</currency>
</service>
<service id="dhl_express_paperless_trade"/>
<service id="dhl_express_electronic_invoice_edi">
<reason_for_export>U</reason_for_export>
<type_of_export>return</type_of_export>
<type_of_invoice>commercial</type_of_invoice>
<terms_of_payment>DAP</terms_of_payment>
<consignor_eori_no>9585</consignor_eori_no>
<consignor_eori_country>DK</consignor_eori_country>
<consignor_tax_id_vat_no>34443</consignor_tax_id_vat_no>
<consignor_tax_id_vat_country>DK</consignor_tax_id_vat_country>
<consignor_ioss_osr_lvg_voec_no>4344444</consignor_ioss_osr_lvg_voec_no>
<consignor_ioss_osr_lvg_voec_country>DK</consignor_ioss_osr_lvg_voec_country>
<consignee_eori_no>77777</consignee_eori_no>
<consignee_eori_country>DK</consignee_eori_country>
<consignee_tax_id_vat_no>3434</consignee_tax_id_vat_no>
<consignee_tax_id_vat_country>DK</consignee_tax_id_vat_country>
<billed_to_name>Fredriksons Fabrik</billed_to_name>
<billed_to_address1>Gatan 23</billed_to_address1>
<billed_to_address2>Utanfør</billed_to_address2>
<billed_to_country>SE</billed_to_country>
<billed_to_postcode>025652</billed_to_postcode>
<billed_to_city>STOCHOLM</billed_to_city>
<billed_to_phone>004658585658</billed_to_phone>
<billed_to_tax_id_vat_no>44</billed_to_tax_id_vat_no>
<billed_to_tax_id_vat_country>SE</billed_to_tax_id_vat_country>
<billed_to_contact_name>Fredirk</billed_to_contact_name>
<billed_to_email>billed@billted.to</billed_to_email>
<billed_to_eori_no>4454</billed_to_eori_no>
<billed_to_eori_country>FI</billed_to_eori_country>
<billed_to_ioss_osr_lvg_voec_no>78787</billed_to_ioss_osr_lvg_voec_no>
<billed_to_ioss_osr_lvg_voec_country>FI</billed_to_ioss_osr_lvg_voec_country>
<invoice_number>888888</invoice_number>
<exporter_id>99</exporter_id>
<exporter_code>FF99FF</exporter_code>
<exporter_name>Peder</exporter_name>
<exporter_address1>Pedersiten 3</exporter_address1>
<exporter_address2></exporter_address2>
<exporter_country>SE</exporter_country>
<exporter_postcode>87876</exporter_postcode>
<exporter_city>sødertelje</exporter_city>
<exporter_phone>1111111</exporter_phone>
<exporter_contact_name>Per</exporter_contact_name>
<exporter_email>per@mail.pp</exporter_email>
<exporter_tax_id_vat_no>8988</exporter_tax_id_vat_no>
<exporter_tax_id_vat_country>SE</exporter_tax_id_vat_country>
<exporter_eori_no>55555</exporter_eori_no>
<exporter_eori_country>SE</exporter_eori_country>
<exporter_ioss_osr_lvg_voec_no>121212</exporter_ioss_osr_lvg_voec_no>
<exporter_ioss_osr_lvg_voec_country>SE</exporter_ioss_osr_lvg_voec_country>
<other_remarks>Intet at meddela</other_remarks>
<other_charges>5050</other_charges>
<freight_cost>900</freight_cost>
<insurance_cost>100</insurance_cost>
<currency_code>SEK</currency_code>
<total_goods_value>500.00</total_goods_value>
<place_of_incoterms>KØBENHAVN</place_of_incoterms>
<invoice_date_time>2023-02-21T12:05</invoice_date_time>
<export_or_import>import</export_or_import>
<commercial_or_personal>commercial</commercial_or_personal>
<origin_eeclaration_text_with_or_without_exporter_id>en lang tekst</origin_eeclaration_text_with_or_without_exporter_id>
<data>
{
"items": [
{
"description": "Batteries",
"commodity_code": "BT123",
"quantity": 300,
"unit_value": 0.5,
"sub_total_value": 150,
"net_weight": 10,
"gross_weight": 15,
"country_of_origin": "DK",
"part_number": "NN565",
"eccn_number": "32323",
"sku_number": "sKU45",
"gst_paid": false,
"original_export_date": "2022-01-01",
"original_outbound_carrier": "dhl",
"original_export_tracking_id": "898989898"
}
]
}
</data>
</service>
</services>
<references>
<consignor>10007 / 996963</consignor>
</references>
</consignment>
</consignments>
DHL Express - Tollverdi
<service id="dhl_express_customs_value">
<amount>670.00</amount> <!-- REQUIRED -->
<currency>EUR</currency> <!-- REQUIRED -->
<paid_by_custno>3252252</paid_by_custno>
</service>DHL Express - Duties & Taxes Paid (DD)
<service id="dhl_express_dtp">
<paid_by_custno>924232332</paid_by_custno> <!-- Optional -->
</service>DHL Express - Forsikring
<service id="dhl_express_insurance">
<amount>670.00</amount> <!-- REQUIRED -->
<currency>eur</currency>
</service>DHL Express - Booking / Pickup
The aditional information is not required, but will help in terms of making a successful booking/pickup. DHL Express does not notify the sender if any requirements in terms of time, as described below, are not fulfillled. The booking will simply fail.
<service id="dhl_express_pickup">
<pickup_time>2022-09-22T13:00</pickup_time> <!-- Note! It must be at least one hour until pickup is booked! -->
<pickup_location>i.e. Oslo City, second floor.</pickup_location>
<pickup_location_close_time>17:00</pickup_location_close_time> <!-- Note! Booking must be at least one hour before closing time! -->
<pickup_instruction>i.e. Ask for Christopher.</pickup_instruction>
</service>Postnord - Groupage Return
These parties are mandatory
<consignment>
...
<product>stykkgods_innland_booking_me</product>
...
<parts>
<consignee freight_payer="true">
<customer-number>3252512</customer-number>
<name>Mitt Firma AS</name>
<country>NO</country>
<postcode>6412</postcode>
<city>Molde</city>
</consignee>
<pickup_address>
<name>Lagerplassen</name>
<address1>Lagerveien 34</address1>
<country>NO</country>
<postcode>0068</postcode>
<city>Oslo</city>
</pickup_address>
</parts>
</consignment>
</parts>
Postnord - Groupage Pickup-Delivery
These parties are mandatory
<consignment>
...
<product>stykkgods_innland_booking_other</product>
...
<parts>
<consignee>
<name>Leveringsfirma AS</name>
<country>NO</country>
<postcode>1338</postcode>
<city>Sandvika</city>
</consignee>
<pickup_address>
<name>Lagerplassen</name>
<address1>Lagerveien 34</address1>
<country>NO</country>
<postcode>1412</postcode>
<city>Sofiemyr</city>
</pickup_address>
<freight_payer_address>
<customer-number>3252512</customer-number>
<name>Mitt Firma AS</name>
<address1>Betalerveien 34</address1>
<country>NO</country>
<postcode>0068</postcode>
<city>Oslo</city>
</freight_payer_address>
</parts>
</consignment>Postnord - Pallet
Postnord requries that you tell what type of Pallet you ship. You need to use one of these:
<consignment>
...
<product>tg_pall</product>
...
<items>
<item type="palette" .....></item>
<item type="1_4_palette" ....></item>
<item type="1_2_palette" ....></item>
<item type="1_1_palette" ....></item>
<item type="x_palette" ....></item>
</items>
...
</consignment>Postnord - Etterkrav
<service id="tg_etterkrav">
<amount>4571</amount>
<currency>NOK</currency>
<kid>1000076353545222</kid> <-- optional -->
</service>Postnord - COD
Only to be used for some export products<service id="cod">
<amount>4571</amount>
<currency>EUR</currency>
<transaction_id>1000076353545222</transaction_id> <-- optional -->
<account_number>40542312211</account_number>
<account_type></account_type>
<bic>DABAIE2D</bic>
<iban>987654321</iban>
</service>Postnord - Forsikring
<service id="tg_insurance">
<amount>4571</amount>
<currency>nok</currency>
</service>Schenker Domestic- Enhetskodet gods
<service id="schenker_domestic_unit_code">
<unit_code>51</unit_code>
</service>Valid unit_code values are:
- 51
- 52
- 53
- 54
- 61
- 71
You need an agreement with Schenker to use this service and they inform you what code to use.
Schenker Domestic - Fix Day
<service id="schenker_domestic_fix_day">
<date>2023-09-30</date> <!-- required -->
</service>Schenker Domestic - Fix Day10
<service id="schenker_domestic_fix_day_10">
<date>2023-09-30</date> <!-- required -->
</service>Schenker Domestic - Fix Day13
<service id="schenker_domestic_fix_day_13">
<date>2023-09-30</date> <!-- required -->
</service>Schenker Domestic - Fix day delivery
<service id="schenker_domestic_fix_day_delivery">
<date>2023-09-30</date> <!-- required -->
</service>Schenker Domestic - Fix day pick-up
<service id="schenker_domestic_fix_day_pickup">
<date>2023-09-30</date> <!-- required -->
</service>Schenker Domestic - Plus pick-up
<service id="schenker_domestic_plus_pickup">
<date>2023-09-30</date> <!-- required -->
</service>Schenker Domestic - Return shipment
<service id="schenker_domestic_return_private">
<date>2023-09-30</date> <!-- required -->
</service>Schenker Utland- Cash On Delivery(COD)
<service id="schenker_cod">
<amount>2023-09-30</amount> <!-- required -->
<currency>
<!-- Possible values -->
<!-- eur -->
<!-- dkk -->
<!-- sek-->
<!-- usd -->
</currency>
<giro_number>87888777666</giro_number>
<payee>Name of Payee</payee> <!-- required -->
<reference_number>BG456456</reference_number> <!-- required -->
</service>Schenker Utland- Fix day
<service id="schenker_fix_day"> <!-- Fix Day -->
<delivery_time>2023-09-30</delivery_time> <!-- required -->
</service>
<service id="schenker_fix_day_10"> <!-- Fix Day 10 -->
<delivery_time>2023-09-30</delivery_time> <!-- required -->
</service>
<service id="schenker_fix_day_13"> <!-- Fix Day 13 -->
<delivery_time>2023-09-30</delivery_time> <!-- required -->
</service>Schenker Utland - Insurance
<service id="schenker_insurance">
<amount>250.50</amount> <!-- required -->
<currency>usd</currency> <!-- required -->
</service>Postnord Sverige - Time Agreed Delivery
<service id="postnord_leveransanvisning">
<leverans_nr>71</leverans_nr>
</service>Valid leverans_nr are:
- 71
- 72
- 73
- 74
- 53
- 89
DSV - Temperaturgods
<service id="dsv_temp_goods">
<temp_max>10</temp_max> <!-- required -->
<temp_min>1</temp_min> <!-- required -->
</service>Brevpost - Digitalt frimerke
<service id="digital_stamp">
<stamp_code>857463522</stamp_code> <!-- required -->
</service>Budbilene - Leveringstidspunkt
<service id="budbilene_delivery_time">
<requested_delivery_time>2023-11-02T12:00:00:00</requested_delivery_time>
<requested_pickup_time>2023-11-01T09:30:00</requested_pickup_time>
</service>Hurtig-gutta Transport - Leveringstidspunkt
<service id="delivery_time">
<requested_delivery_time>2023-11-02T12:00:00:00</requested_delivery_time>
<requested_pickup_time>2023-11-01T09:30:00</requested_pickup_time>
</service>