Manifesting is a strict requirement of Royal Mail - shipments must be manifested prior to pickup and processing.
- EasyPost will automatically manifest any unmanifested Royal Mail shipments at the end of every day.
- For providing manifests to pickup drivers, manual manifesting via the EasyPost API is recommended.
Asynchronous Manifesting
Manifesting is not instantaneous and may take several minutes to complete and receive a manifest document.
Immediate receipt of a driver manifest summary is not possible; it becomes available shortly after the manifesting process:
- Create a batch with a list of shipments (or add shipments to the batch throughout the day).
- Batch Processing
Option A: Wait approximately 1-3 seconds for the batch creation to complete.
Option B: Monitor for a batch.updated webhook event indicating the batch.state has changed to created.Note: Initiating the next step during “creating” status leads to errors.
- Execute the manifest ‘scan_form’ batch.
- Manifest Confirmation
Option A: Wait up to five minutes and retrieve the ‘scan_form’ to confirm completion.
Option B: Use webhooks to wait for the ‘scan_form.updated’ event and obtain the manifest document URL at that time.
cURL Example
curl -X GET https://api.easypost.com/v2/scan_forms \
-u : \
-d 'page_size=20' \
-d 'start_datetime=2022-01-23T00:00:00Z' \
-d 'end_datetime=2022-01-24T24:00:00Z'