PostNL Logo
Menu

Direct Parcel to China shipment example

Information

Direct Parcel requires some specific fields to use it, next to the usual GlobalPack requirements

  • Receiver country must be China (AddressType 01)
  • Specific receiver address fields are required (AddressType 01)
  • Street, city and region must be filled with Chinese Characters
  • SMSNr is required, can contain a maximum of 11 characters and must start with a '1' (Shipments/Shipment/Contacts/Contact/SMSNr with ContactType 01)
  • EAN and HS number fields are required (Shipments/Shipment/Customs/Content/Content/EAN and Shipments/Shipment/Customs/Content/Content/HSTariffNr)
  • The ProductURL is required (Shipments/Shipment/Customs/Content/Content/ProductURL)
  • The CustomerOrderNumber is required (Shipments/Shipment/CustomerOrderNumber)
  • The Person IDNumber is required (Shipments/Shipment/IDNumber and Shipments/Shipment/IDType with IDType 07)
  • The ShipmentType is Commercial Goods, due to this Invoice must be set to true and an InvoiceNr is required (Shipments/Shipment/Customs/InvoiceNr and Shipments/Shipment/Customs/Invoice)
  • Handle as non-deliverable must be set to false, returns are not possible (Shipments/Shipment/Customs/HandleAsNonDeliverable)

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:lab="http://postnl.nl/cif/services/LabellingWebService/" 
xmlns:tpp="http://postnl.nl/cif/domain/LabellingWebService/">
       <soapenv:Body>
             <lab:GenerateLabel>
      <tpp:Customer>
        <tpp:Address>
          <tpp:AddressType>02</tpp:AddressType>
          <tpp:City>Hoofddorp</tpp:City>
          <tpp:CompanyName>PostNL</tpp:CompanyName>
          <tpp:Countrycode>NL</tpp:Countrycode>
          <tpp:FirstName>Frank</tpp:FirstName>
          <tpp:HouseNr>42</tpp:HouseNr>
          <tpp:HouseNrExt>A</tpp:HouseNrExt>
          <tpp:Name>Peeters</tpp:Name>
          <tpp:Street>Siriusdreef</tpp:Street>
          <tpp:Zipcode>2132WT</tpp:Zipcode>
        </tpp:Address>
        <tpp:CollectionLocation>123456</tpp:CollectionLocation>
        <tpp:CustomerCode>DEVC</tpp:CustomerCode>
        <tpp:CustomerNumber>111223344</tpp:CustomerNumber>
      </tpp:Customer>
      <tpp:Message>
        <tpp:MessageID>1</tpp:MessageID>
        <tpp:MessageTimeStamp>29-06-2016 12:00:00</tpp:MessageTimeStamp>
        <tpp:Printertype>GraphicFile|PDF</tpp:Printertype>
      </tpp:Message>
      <tpp:Shipments>
        <tpp:Shipment>
          <tpp:Addresses>
            <tpp:Address>
              <tpp:AddressType>01</tpp:AddressType>
              <tpp:Buildingname>5号楼</tpp:Buildingname>
              <tpp:City>杭</tpp:City>
              <tpp:CompanyName>公司名称</tpp:CompanyName>
              <tpp:Countrycode>CN</tpp:Countrycode>
              <tpp:FirstName>公司名称</tpp:FirstName>
              <tpp:HouseNr>272</tpp:HouseNr>         
              <tpp:Name>收</tpp:Name>
              <tpp:Region>浙江</tpp:Region>
              <tpp:Street>路市桥</tpp:Street>
              <tpp:Zipcode>310000</tpp:Zipcode>
            </tpp:Address>       
           </tpp:Addresses>
             <tpp:Amounts>
            <tpp:Amount>
              <tpp:AmountType>04</tpp:AmountType>
              <tpp:Currency>EUR</tpp:Currency>      
              <tpp:Value>1.00</tpp:Value>
             </tpp:Amount>
             <tpp:Amount>
              <tpp:AmountType>12</tpp:AmountType>
              <tpp:Currency>EUR</tpp:Currency>      
              <tpp:Value>13.00</tpp:Value>
            </tpp:Amount>
          </tpp:Amounts>
          <tpp:Barcode>3SDEVC6659149</tpp:Barcode>
          <tpp:Contacts>
            <tpp:Contact>
              <tpp:ContactType>01</tpp:ContactType>
              <tpp:Email>receiver@gmail.com</tpp:Email>
              <tpp:SMSNr>13612345678</tpp:SMSNr>
            </tpp:Contact>
          </tpp:Contacts>
       <tpp:CustomerOrderNumber>CustOrder12345</tpp:CustomerOrderNumber>       
        <tpp:Customs>
        <tpp:Certificate/>
     <tpp:CertificateNr/>
            <tpp:Content>
              <tpp:Content>
                <tpp:CountryOfOrigin>NL</tpp:CountryOfOrigin>
                <tpp:Description>Powdered milk</tpp:Description>
                <tpp:EAN>123456789</tpp:EAN>
                <tpp:HSTariffNr>100878</tpp:HSTariffNr>
               <tpp:ProductURL>http://jishi.ydx.hk/goods.php?id=4974_1</tpp:ProductURL>
                <tpp:Quantity>1</tpp:Quantity>
                <tpp:Value>123</tpp:Value>
                <tpp:Weight>100</tpp:Weight>
              </tpp:Content>
            </tpp:Content>
            <tpp:Currency>EUR</tpp:Currency>
            <tpp:HandleAsNonDeliverable>true</tpp:HandleAsNonDeliverable>
            <tpp:Invoice>true</tpp:Invoice>
            <tpp:InvoiceNr>22334455</tpp:InvoiceNr>
            <tpp:ShipmentType>Commercial Goods</tpp:ShipmentType>
          </tpp:Customs>
          <tpp:Dimension>
            <tpp:Weight>1000</tpp:Weight>
          </tpp:Dimension>
          <tpp:IDNumber>512227195603140340</tpp:IDNumber>
         <tpp:IDType>07</tpp:IDType>
          <tpp:ProductCodeDelivery>4992</tpp:ProductCodeDelivery>
        </tpp:Shipment>
      </tpp:Shipments>
      </lab:GenerateLabel>
  </soapenv:Body>
</soapenv:Envelope>