How To: Import a Local Collect Shipment

Steps to complete:

For all local shipment request the following pre-requisites are required:

The company name must be listed as c/o [Location] Post Office' or 'c/o [Location] Enquiry Office
The enhancement code 22 must be used
The local collect section of the API must be set to true or service code 22 used
A tracking notification must be included in the request (service codes: 13, 14, 16)

Example Bulk mailing sample – Local Collect example.csv

API Request V3

{
"Shipper": 
{
"AddressId": "",
"ShipperReference": "REF123456789",
"ShipperDepartment": "",
"CompanyName": "C/O Company1 Post Office ",
"ContactName": "Jane Smith",
"AddressLine1": "Level 5",
"AddressLine2": "Hashmoore House",
"AddressLine3": "10 Sky Lane",
"Town": "Leatherhead",
"County": "Surrey",
"CountryCode": "GB",
"Postcode": "Tw15 1BS",
"PhoneNumber": "07723456789",
"EmailAddress": "email@server.com",
"VatNumber": "GB123 4567 89"
},
"Destination": 
{
"AddressId": "dc968907-b1cb-4b2b-9175-30dbd2ac15bb",
"CompanyName": "c/o Onida Enquiry Office",
"ContactName": "Jane Brown",
"AddressLine1": "White Horse",
"AddressLine2": "10 Round Road",
"AddressLine3": "Mitre Peak",
"Town": "GA",
"County": "GA",
"CountryCode": "US",
"Postcode": "30303",
"PhoneNumber": "07123456789",
"EmailAddress": "email@example.com",
"VatNumber": "GB123 4567 89"
},
"ShipmentInformation": 

{
"ShipmentDate": "2019-09-27",
"ServiceCode": "SD1",
"ServiceOptions": {
"PostingLocation": "9000257150",
        "ServiceLevel": "01",
      "ServiceFormat": "P",
      "Safeplace": "",
      "SaturdayGuaranteed": false,
      "ConsequentialLoss": "",
      "LocalCollect": true,
      "TrackingNotifications": "SMS",
      "RecordedSignedFor": false

},
"TotalPackages": 1,
"TotalWeight": 2.2,
"WeightUnitOfMeasure": "KG",
"Product": "NDX",
"DescriptionOfGoods": "Clothing",
"ReasonForExport": "Sale of goods",
"Value": 39.98,
"Currency": "GBP",
"LabelFormat": "PDF",
"SilentPrintProfile": "",
"ShipmentAction": "allocate",
"Packages": 

[

{
"PackageOccurrence": 1,
"PackagingId": "",
"Weight": 2.2,
"Length": 15,
"Width": 15,
"Height": 5
}
],
"Items": 

[

{
"ItemId": "",
"Quantity": 2,
"Description": "White Tee-shirt",
"Value": 19.99,
"Weight": 0.9,
"PackageOccurrence": 1,
"HsCode": "652534",
"SkuCode": "SKU3455692",
"CountryOfOrigin": "CN",
"ImageUrl": "http://www.myimagestore.com/myimage.jpg"
}
]
}
}

API Response

<ShipmentCreateResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <HttpStatusCode>200</HttpStatusCode>
    <HttpStatusDescription>OK</HttpStatusDescription>
    <Message>Shipment(s) allocated.</Message>
    <Packages>
        <PackageResponse>
            <PackageOccurance>1</PackageOccurance>
            <UniqueId>3A00697860000000BA07A</UniqueId>
            <TrackingNumber>JS578361500GB</TrackingNumber>
            <TrackingUrl>https://www.royalmail.com/track-your-item#/tracking-results/JS578361500GB</TrackingUrl>
            <CarrierCode>RMG</CarrierCode>
        </PackageResponse>
    </Packages>
    <LabelImageFormat xsi:nil="true" />
    <ReturnLabelImageFormat xsi:nil="true" />
</ShipmentCreateResponse>

Label created is:

Page:

How To: Import a Local Collect Shipment

How To: Import a Local Collect Shipment

Information on how to import and utilise the API request for Local Collect shipments, including enhancements and services that are required.

Steps to complete:

Related articles