Reallocate a consignment

You can reallocate a consignment to an alternative carrier service. Reallocating a consignment involves deleting its existing allocation and repeating the process of allocating it.

Reallocate consignment requests

You need the following to make reallocate consignment requests.

Parameter Value Description
status ALLOCATED or
PRINTED or
READY TO MANIFEST		 The consignment lifecycle status.
consignmentCode The consignment identifier generated by Metapack when a consignment is created.

To reallocate a consignment, complete the following steps:

  1. Delete the allocation of the consignment .
  2. Optional: Verify whether shipping rules can be applied to the now unallocated consignment.
  3. Allocate the consignment .
Tip

For steps 1 and 3, you can use Get a consignment with the consignmentCode to verify the status of the consignment.

Reallocate consignment response

201 (Created)

Significant parameters in a successful response are as follows.

Parameter Value Description
status ALLOCATED

You can reallocate or delete the consignment, or add parcels to it. Modifying the consignment will require deleting its allocation, which will change the status to UNALLOCATED.

If a suitable subscribed carrier service is not found for the consignment, the status will be UNALLOCATED.

Related tasks