Additional Requirements for Products and Services

A few shipping products and services do require additional input from the user. Those special cases are explained in detail here. All other services are by the time of this writing only boolean true/false on/off values. This might change in the future without us managing to keep this documentation up to date, so please let ut know if you find a product or service that has additional requirements, but aren't listed here.

How to get the complete list (XML) of all the names and identifiers of your customers carriers, products and services, can be found here.

Contents:

Brevpost services:

Customs declaration
Digitalt frimerke

Bring services:

eVarsling
Leveringstidspunkt
Postoppkrav
Prioritet
Utkjøring lørdag
Valgfritt hentested

Bring, revised services:

Bet. ved utlev. (COD)
Valgfritt hentested

DHL Express Services:

Electronic invoice
Forsikring
Paperless trade
Tollverdi

PostNord products:

DPD Export
Groupage return
Groupage Pickup-Deliv
Mypack Collect
Mypack Home
Pallet
Return Drop Off

PostNord services:

COD
Etterkrav
Forsikring
SMS Varsling
Utleveringsforbehold

 

Additional Requirements for Products and Services

Postnord

Products

MyPack Collect

<product>mypack</product>

In addition, you need to specify a PostNord Pick-up point. For valid Pick-up poins use this resource or use the resource through our API.

<parts>
      <service-partner>
        <number>3042033</number>
        <customer-number></customer-number>
        <name>ROMSDAL BLOMSTER OG GAVER</name>
        <address1>RAUMASENTERET ØRAN</address1>
        <country>NO</country>
        <postcode>6300</postcode>
        <city>Åndalsnes</city>
      </service-partner>
    </parts>

If no possible pick-up point is found in the list from PostNord please use this pick-up point:

<parts>
      <service-partner>
        <number>0413898</number>
        <customer-number>00098287279</customer-number>
        <name>Postens Godssenter</name>
        <country>NO</country>
        <postcode>0068</postcode>
        <city>Oslo</city>
      </service-partner>
    </parts>

Return Drop Off

<product>mypack_return</product

In addition, you need to specify a PostNord Pick-up point. For valid Pick-up poins use this resource

<parts>
      <service-partner>
        <number>3042033</number>
        <customer-number></customer-number>
        <name>ROMSDAL BLOMSTER OG GAVER</name>
        <address1>RAUMASENTERET ØRAN</address1>
        <country>NO</country>
        <postcode>6300</postcode>
        <city>Åndalsnes</city>
      </service-partner>
    </parts>

If no possible pick-up point is found in the list from PostNord please use this pick-up point:

<parts>
      <service-partner>
        <number>0413898</number>
        <customer-number>00098287279</customer-number>
        <name>Postens Godssenter</name>
        <country>NO</country>
        <postcode>0068</postcode>
        <city>Oslo</city>
      </service-partner>
    </parts>

DPD Eksport

<product>tg_dpd_utland</product>

Limitations of product: Only one element of this tag is allowed. Amount can only have value 1.

<items>
  <item type="package" amount="1" weight="2" volume="3" description="Something"/>
</items>

Groupage Return

<product>stykkgods_innland_booking_me</product>

These parties are mandatory

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

Groupage Pickup-Deliv

<product>stykkgods_innland_booking_other</product>

These parties are mandatory

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

Pallet

<product>tg_pall</product>

Postnord requries that you tell what type of Pallet you ship. You need to use one of these:

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

Mypack Home

<product>tg_home_delivery</product>

PostNord Services

Utleveringsforbehold

<service id="tg_giro">
   <amount>4571</amount>
   <currency>NOK</currency>
   <kid>1000076353545222</kid> <-- optional -->
   <account_number>40542312211</account_number>
 </service>

Etterkrav

<service id="tg_etterkrav">
   <amount>4571</amount>
   <currency>NOK</currency>
   <kid>1000076353545222</kid> <-- optional -->
 </service>

COD

Only to be used for MyPack Eksport to FI, DK and SE

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

Forsikring

<service id="tg_insurance">
   <amount>4571</amount>
   <currency>nok</currency>
</service>

SMS Varsling

<service id="postnord_notification_sms"></service>

 

Bring

Services

Postoppkrav

<service id="bring_oppkrav">
  <amount>4571</amount>
  <account_number>34541024533</account_number>
  <kid>1000076353545222</kid> <-- optional -->
</service>

 

eVarsling

    <service id="bring_e_varsle_for_utlevering"></service>

In addition you need to supply a mobile phone number and/or an email of the consignee:

<parts>
  <consignee>
    <name>Ola Mottaker AS</name>
    ...
    ...
    <mobile>96969696</mobile>
    <email>Denne e-postadressen er beskyttet mot programmer som samler e-postadresser. Du må aktivere javaskript for å kunne se den.</email>
    ...
    ...
  </consignee>
</parts>

 

Utkjøring Lørdag

Only possible in combination with the product Ekspress Over Natten

    <service id="bring_utkjoring_lordag"></service>

 

Valgfritt Hentested

    <service id="bring_valgfritt_postkontor"></service>

In addition you may choose to specify the chosen pick-up place. For a list of valid pick-up point, you have two choices.

The chosen pick-up point is placed in a <service_partner> element inside the <parts> element togheter with the <consignee> element.

<parts>
  <consignee>
    ...
    ...
  </consignee>
  <service_partner>
        <number>124813</number>
        <name>Plantasjen Forus</name>
        <address1>POSTBOKS 2001 LURA</address1>
        <country>NO</country>
        <postcode>4394</postcode>
        <city>SANDNES</city>
      </service_partner>
</parts>

If you dont use the <service_partner> element, Cargonizer will do a look-up for you. The result will be what we call a "Qualified guess". It is up to you. 

 

Leveringstidspunkt

Only to be used with this products:

  • Courier Distribution
  • Business Distribution
  • Business Distribution Pallet
  • Courier Distribution Pallet

<service id="bring_delivery_time">
  <collection_time_earliest>4571</collection_time_earliest>  --> Format: YYYY-MM-DD HH:MM 
  <collection_time_latest>4571</collection_time_earliest>
  <delivery_time_earliest>4571</collection_time_earliest
  <delivery_time_latest>4571</collection_time_earliest
</service>

 

Prioritet

<service id="bring_priority>
   <type>1_hour</type> <!-- choose between 1_hour, 2_hour or 4_hour -->
</service>

 

Bring - revised services

Services

Bet. ved utlev. (COD)

<service id="bring2_cash_on_delivery">
  <amount>4571</amount>
  <account>34541024533</account>
  <currency>NOK</currency>
  <reference>1000076353545222</referenced> <-- optional -->
</service>

Valgfritt hentested

<service id="bring2_choice_of_pickup_point"></service>

In addition you may choose to specify the chosen pick-up place. For a list of valid pick-up point, you have two choices.

The chosen pick-up point is placed in a <service_partner> element inside the <parts> element togheter with the <consignee> element.

<parts>
  <consignee>
    ...
    ...
  </consignee>
  <service_partner>
        <number>124813</number>
        <name>Plantasjen Forus</name>
        <address1>POSTBOKS 2001 LURA</address1>
        <country>NO</country>
        <postcode>4394</postcode>
        <city>SANDNES</city>
      </service_partner>
</parts>

If you dont use the <service_partner> element, Cargonizer will do a look-up for you. The result will be what we call a "Qualified guess". It is up to you. 

 

Brevpost

Services

Customs declaration

For product Brev m/tolldeklarasjon / Letter with toll declaration - CN22

Example values

<service id="customs_declaration">
   <customs_declaration_gift>true</customs_declaration_gift>
   <customs_declaration_documents>false</customs_declaration_documents>
   <customs_declaration_commercial_sample>false</customs_declaration_commercial_sample>
   <customs_declaration_returned_goods>false</customs_declaration_returned_goods>
   <customs_declaration_other>false</customs_declaration_other>
   <customs_declaration_contents>Present for Kari</customs_declaration_contents>
   <customs_declaration_weight>1.0</customs_declaration_weight>
   <customs_declaration_currency>EUR</customs_declaration_currency>
   <customs_declaration_value>10.0</customs_declaration_value>
   <customs_declaration_tariff_number>1234</customs_declaration_tariff_number>
   <customs_declaration_country_of_origin>BE</customs_declaration_country_of_origin>
</service>

Digitalt frimerke

<service id="digital_stamp">
   <stamp_code>123ABC456</stamp_code> <!-- REQUIRED -->
</service>

 

DHL Express

Services

For product Economy Select

For product Express Worldwide (nondoc)

Electronic Invoice

Example With All values

<service id="dhl_express_electronic_invoice">
   <consignor_eori_no></consignor_eori_no>
   <consignor_tax_id_vat_no></consignor_tax_id_vat_no>
   <consignee_tax_id_vat_no></consignee_tax_id_vat_no>
   <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>
   <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>
   <exporter_id></exporter_id>
   <exporter_code></exporter_code>
   <other_remarks></other_remarks>
   <reason_for_export>Personal. Not for Resale</reason_for_export> <!-- REQUIRED -->
   <type_of_export>permanent</type_of_export> <!-- choose permanent, temporary, return or repair REQUIRED -->
   <other_charges></other_charges>
   <freight_cost></freight_cost>
   <insurance_cost></insurance_cost>
   <currency_code></currency_code>
   <terms_of_payment></terms_of_payment>
   <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>proforma</type_of_invoice> <!-- choose between proforma or commercial -->
   <eea_declaration>true</eea_declaration>
   <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"
              },
              {
                "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"
              },
              {
                "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"
              }
            ]
          }
   </data>
</service> 

 

Example With Minimum Required Values

<service id="dhl_express_electronic_invoice">
   <reason_for_export>Personal. Nor for Resale</reason_for_export>
   <type_of_export>repair</type_of_export>
   <data>
          {
            "items": [
              {
                "quantity": 300,
                "unit_value": 0.5,
                "sub_total_value": 150,
                "net_weight": 10
              }
            ]
          }
   </data>
</service>

 

See this document for field details

 

Tollverdi

<service id="dhl_express_customs_value">
   <amount>670.00</amount> <!-- REQUIRED -->
   <currency>EUR</currency> <!-- REQUIRED -->
   <paid_by_custno>3252252</paid_by_custno>
</service>

Paperless Trade

<service id="dhl_express_paperless_trade">
</service>

Other DHL services not necessarily related to Electronic invoice:

Forsikring

<service id="dhl_express_insurance">
   <amount>670.00</amount> <!-- REQUIRED -->
   <currency>eur</currency> 
</service>

 

 

 

Developer: Cargonizer API Documentation © Logistra AS   Øran Vest, 6300 Åndalsnes   Denne e-postadressen er beskyttet mot programmer som samler e-postadresser. Du må aktivere javaskript for å kunne se den.logistra facebook icon logistra twitter icon

Vi bruker informasjonskapsler (cookies) for å forbedre bruksopplevelsen og for å kunne føre statistikk over våre besøkende.