Skip to content

Examples

Tore Darell edited this page Oct 29, 2026 · 46 revisions

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

Domestic Shipments

<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>

Abroad Shipments

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>

Clone this wiki locally