Click & Drop API Generate Labels
I have a few issues with Royal Mail Click & Drop API.
[1] When sending a request to /orders with the LabelGenerationRequest.IncludeLabelInResponse, 400 Bad Request is returned with 'Amount of labels across all items must not exceed 1'. This is using the CreateOrders end point and on each order is has the property to request a label. With any or all orders as true, this error is returned and no orders are created.
[2] Tracking number is not returned in the response, even when the order is successfully sent to Click & Drop account and has postage applied based on Shipping Rules. I believe this is due to labels not being generated.
[3] GENERATE LABELS.
Why would you want to use an API, when you've got to then manually log into Click & Drop to generate a label. In our system, we want to take advantage of the labels in PDF format so we can convert this to a PNG and display on our own picking note sheets, but we cannot call this endpoint until someone goes into the Click & Drop Dashboard to generate the labels. Utterly pointless.
Alex Godwin
shared this idea
Thank you for your feedback.
We believe there are 2 approaches you can take to solve the issue.
Approach 1) Generate 1 order at a time. This will generate a label in the response, including the PDF and the tracking number.
Approach 2) Generate multiple orders without labels (includeLabelInResponse = false). After the orders are created in bulk, you can then request labels in bulk via the Get Labels endpoint. After you have generated the labels, you can retrieve the tracking numbers via the Get Orders endpoint.
When you created orders, the API returns orderIdentifier. You can use the identifier returned to retrieve labels, and the order details. The order details contains the tracking number.
Further details can be found in our documentation:
https://api.parcel.royalmail.com/#tag/Orders/operation/GetSpecificOrdersAsync
https://api.parcel.royalmail.com/#tag/Labels/operation/GetOrdersLabelAsync
Hopefully this resolves your issue. If any further help is needed please get in touch with our support team.
Kind regards,
Click & Drop Team