Additional Requirements for Products and Services
A few shipping product and services do require additional input from the user. Those special cases are explained in detail here. All other services are only boolean true/false on/off values. The list (XML) of the names and identifiers of all the other carriers, products and services can be found here
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 Standard
<product>tg_dpd_innland</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>
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>
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>
Brevpost
Services
For product brevpost-toll
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>
