Pickup Basic example

See below for Pickup Plus example

Information

Pickup plus products require some specific fields to be used: 

  • First shipment segment
    • Address of collection: Shipment/Address/AddressType 04
      Antwoordnummer is required. 
    • 2S barcode
    • CollectionTimeStampBegin & CollectionTimeStampEnd (e.g. 23-09-2018 14:00:00)
    • product code: 3160
  • Second shipment segment
    • Address of delivery order: Shipment/Address/AddressType 01
    • 3S barcode (must be the same as 2S barcode, only difference being 3S instead of 2S)
    • Group type 01 with mainbarcode same as 2S barcode from first shipment
    • Group count: 1
    • Group sequence: 1
    • Product code: 3238
    • Zipcodes for all addresses should not contain spaces

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:con="http://postnl.nl/cif/services/ConfirmingWebService/" 
xmlns:tpp="http://postnl.nl/cif/domain/ConfirmingWebService/">
    <soapenv:Body>
        <con:Confirming>
            <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>11223344</tpp:CustomerNumber>
            </tpp:Customer>
            <tpp:Message>
                <tpp:MessageID>1</tpp:MessageID>
                <tpp:MessageTimeStamp>29-06-2016 12:00:00</tpp:MessageTimeStamp>
            </tpp:Message>
            <tpp:Shipments>
                <tpp:Shipment>
                    <tpp:Addresses>
                        <tpp:Address>
                            <tpp:AddressType>04</tpp:AddressType>
                            <tpp:City>Utrecht</tpp:City>
                            <tpp:CompanyName>PostNL</tpp:CompanyName>
                            <tpp:Countrycode>NL</tpp:Countrycode>
                            <tpp:FirstName>Femke</tpp:FirstName>
                            <tpp:HouseNr>110022</tpp:HouseNr>
                            <tpp:Name>Janssen</tpp:Name>
                            <tpp:Street>Antwoordnummer</tpp:Street>
                            <tpp:Zipcode>3571TS</tpp:Zipcode>
                        </tpp:Address>
                    </tpp:Addresses>
                    <tpp:Barcode>2SDEVC6659149</tpp:Barcode>
                    <tpp:CollectionTimeStampEnd>12-05-2016 12:00:00</tpp:CollectionTimeStampEnd>
                    <tpp:CollectionTimeStampStart>12-05-2016 12:00:00</tpp:CollectionTimeStampStart>
                    <tpp:Contacts>
                        <tpp:Contact>
                            <tpp:ContactType>01</tpp:ContactType>
                            <tpp:Email>receiver@gmail.com</tpp:Email>
                            <tpp:SMSNr>0612345678</tpp:SMSNr>
                        </tpp:Contact>
                    </tpp:Contacts>
                    <tpp:Dimension>
                        <tpp:Weight>4300</tpp:Weight>
                    </tpp:Dimension>
                    <tpp:ProductCodeDelivery>3160</tpp:ProductCodeDelivery>
                </tpp:Shipment>
                <tpp:Shipment>
                    <tpp:Addresses>
                        <tpp:Address>
                            <tpp:AddressType>01</tpp:AddressType>
                            <tpp:City>Utrecht</tpp:City>
                            <tpp:CompanyName>PostNL</tpp:CompanyName>
                            <tpp:Countrycode>NL</tpp:Countrycode>
                            <tpp:FirstName>Femke</tpp:FirstName>
                            <tpp:HouseNr>1</tpp:HouseNr>
                            <tpp:Name>Janssen</tpp:Name>
                            <tpp:Street>Antwoordnummer</tpp:Street>
                            <tpp:Zipcode>3500AA</tpp:Zipcode>
                        </tpp:Address>
                    </tpp:Addresses>
                    <tpp:Barcode>3SDEVC6659149</tpp:Barcode>
                    <tpp:CollectionTimeStampEnd>12-05-2016 12:00:00</tpp:CollectionTimeStampEnd>
                    <tpp:CollectionTimeStampStart>12-05-2016 12:00:00</tpp:CollectionTimeStampStart>
                    <tpp:Contacts>
                        <tpp:Contact>
                            <tpp:ContactType>01</tpp:ContactType>
                            <tpp:Email>receiver@gmail.com</tpp:Email>
                            <tpp:SMSNr>0612345678</tpp:SMSNr>
                        </tpp:Contact>
                    </tpp:Contacts>
                    <tpp:Dimension>
                        <tpp:Weight>4300</tpp:Weight>
                    </tpp:Dimension>
                    <tpp:Groups>
                        <tpp:Group>
                            <tpp:GroupCount>1</tpp:GroupCount>
                            <tpp:GroupSequence>1</tpp:GroupSequence>
                            <tpp:GroupType>01</tpp:GroupType>
                            <tpp:MainBarcode>2SDEVC6659149</tpp:MainBarcode>
                        </tpp:Group>
                    </tpp:Groups>
                    <tpp:ProductCodeDelivery>3238</tpp:ProductCodeDelivery>
                </tpp:Shipment>
            </tpp:Shipments>
        </con:Confirming>
    </soapenv:Body>
</soapenv:Envelope>

Pickup Plus example

Information

Pickup plus products require some specific fields to be used: 

  • First shipment segment
    • Address of collection: Shipment/Address/AddressType 04
    • 2S barcode
    • CollectionTimeStampBegin & CollectionTimeStampEnd (e.g. 23-09-2018 14:00:00)
    • product code: 3151
  • Second shipment segment
    • Address of delivery order: Shipment/Address/AddressType 01
    • 3S barcode (must be the same as 2S barcode, only difference being 3S instead of 2S)
    • Group type 01 with mainbarcode same as 2S barcode from first shipment
    • Group count: 1
    • Group sequence: 1
    • Product code: 3238
    • Zipcodes for all addresses should not contain spaces

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:con="http://postnl.nl/cif/services/ConfirmingWebService/" 
xmlns:tpp="http://postnl.nl/cif/domain/ConfirmingWebService/">
    <soapenv:Body>
        <con:Confirming>
            <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>11223344</tpp:CustomerNumber>
            </tpp:Customer>
            <tpp:Message>
                <tpp:MessageID>1</tpp:MessageID>
                <tpp:MessageTimeStamp>29-06-2016 12:00:00</tpp:MessageTimeStamp>
            </tpp:Message>
            <tpp:Shipments>
                <tpp:Shipment>
                    <tpp:Addresses>
                        <tpp:Address>
                            <tpp:AddressType>04</tpp:AddressType>
                            <tpp:City>Utrecht</tpp:City>
                            <tpp:CompanyName>PostNL</tpp:CompanyName>
                            <tpp:Countrycode>NL</tpp:Countrycode>
                            <tpp:FirstName>Femke</tpp:FirstName>
                            <tpp:HouseNr>19</tpp:HouseNr>
                            <tpp:Name>Janssen</tpp:Name>
                            <tpp:Street>Linnaeuslaan</tpp:Street>
                            <tpp:Zipcode>3571TS</tpp:Zipcode>
                        </tpp:Address>
                    </tpp:Addresses>
                    <tpp:Barcode>2SDEVC6659149</tpp:Barcode>
                    <tpp:CollectionTimeStampEnd>12-05-2016 12:00:00</tpp:CollectionTimeStampEnd>
                    <tpp:CollectionTimeStampStart>12-05-2016 12:00:00</tpp:CollectionTimeStampStart>
                    <tpp:Contacts>
                        <tpp:Contact>
                            <tpp:ContactType>01</tpp:ContactType>
                            <tpp:Email>receiver@gmail.com</tpp:Email>
                            <tpp:SMSNr>0612345678</tpp:SMSNr>
                        </tpp:Contact>
                    </tpp:Contacts>
                    <tpp:Dimension>
                        <tpp:Weight>4300</tpp:Weight>
                    </tpp:Dimension>
                    <tpp:ProductCodeDelivery>3160</tpp:ProductCodeDelivery>
                </tpp:Shipment>
                <tpp:Shipment>
                    <tpp:Addresses>
                        <tpp:Address>
                            <tpp:AddressType>01</tpp:AddressType>
                            <tpp:City>Utrecht</tpp:City>
                            <tpp:CompanyName>PostNL</tpp:CompanyName>
                            <tpp:Countrycode>NL</tpp:Countrycode>
                            <tpp:FirstName>Femke</tpp:FirstName>
                            <tpp:HouseNr>1</tpp:HouseNr>
                            <tpp:Name>Janssen</tpp:Name>
                            <tpp:Street>Antwoordnummer</tpp:Street>
                            <tpp:Zipcode>3500AA</tpp:Zipcode>
                        </tpp:Address>
                    </tpp:Addresses>
                    <tpp:Barcode>3SDEVC6659149</tpp:Barcode>
                    <tpp:CollectionTimeStampEnd>12-05-2016 12:00:00</tpp:CollectionTimeStampEnd>
                    <tpp:CollectionTimeStampStart>12-05-2016 12:00:00</tpp:CollectionTimeStampStart>
                    <tpp:Contacts>
                        <tpp:Contact>
                            <tpp:ContactType>01</tpp:ContactType>
                            <tpp:Email>receiver@gmail.com</tpp:Email>
                            <tpp:SMSNr>0612345678</tpp:SMSNr>
                        </tpp:Contact>
                    </tpp:Contacts>
                    <tpp:Dimension>
                        <tpp:Weight>4300</tpp:Weight>
                    </tpp:Dimension>
                    <tpp:Groups>
                        <tpp:Group>
                            <tpp:GroupCount>1</tpp:GroupCount>
                            <tpp:GroupSequence>1</tpp:GroupSequence>
                            <tpp:GroupType>01</tpp:GroupType>
                            <tpp:MainBarcode>2SDEVC6659149</tpp:MainBarcode>
                        </tpp:Group>
                    </tpp:Groups>
                    <tpp:ProductCodeDelivery>3238</tpp:ProductCodeDelivery>
                </tpp:Shipment>
            </tpp:Shipments>
        </con:Confirming>
    </soapenv:Body>
</soapenv:Envelope>