Extra@Home Pickup Service Information

Information

Extra @ Home pickup service products require some specific fields to be used: 

  • A shipment with AddressType 04 (collection address), a 3S barcode and product code mentioned in the table 
  • The collection date and timeframe (CollectionTimeStampStart / CollectionTimeStampEnd) 
  • A shipment with AddressType 02 (Sender address) 
  • Shipment.Content is required 
  • Shipment.Reference is required (this should be unique for each shipment as this will be used to generate the Extra@Home order reference) 
  • Volume is required (approximation suffices) 
  • Weight is required (approximation suffices) 
  • Mobile phone number required for text messages with ETA
  • E-mail address required for link Customer Portal incl. Track & Trace

Example

<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>3SDEVC6659149</tpp:Barcode>
                    <tpp:CollectionTimeStampEnd>10-12-2017 20:00:00</tpp:CollectionTimeStampEnd>
                    <tpp:CollectionTimeStampStart>10-12-2017 10: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:Content>Contents</tpp:Content>
                    <tpp:CostCenter>Costcenter</tpp:CostCenter>
                    <tpp:CustomerOrderNumber>12345</tpp:CustomerOrderNumber>
                    <tpp:DeliveryAddress>01</tpp:DeliveryAddress>
                    <tpp:Dimension>
                        <tpp:Volume>13000</tpp:Volume>
                        <tpp:Weight>9000</tpp:Weight>
                    </tpp:Dimension>
                    <tpp:ProductCodeDelivery>3780</tpp:ProductCodeDelivery>
                    <tpp:Reference>Order1234</tpp:Reference>
                </tpp:Shipment>
            </tpp:Shipments>
        </con:Confirming>
    </soapenv:Body>
</soapenv:Envelope>