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>
<customer-number>c===1036</customer-number>
<name>Plantasjen Forus</name>
<address1>POSTBOKS 2001 LURA</address1>
<country>NO</country>
<postcode>4394</postcode>
<city>SANDNES</city>
</service_partner>
</parts>
Important: For shipments outside Norway you MUST use <customer-number>. Value is in format c=XXXX where XXXX is the value from Bring API additionalServiceCode or if you are using our service_partners.xml API it is the same <customer-number>.
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>