Cartonisation for Delivery Tracker

'Cartonisation' refers to the division of an 'outer' or 'parent' consignment (e.g. a pallet), into 'inner' or 'child' consignments (e.g. cartons). These are then linked to the 'parent' for tracking purposes (refer to Cartonisation ('Parent' and 'Child') for full information).


The setup for Delivery Tracker is the 'Click and Collect' model, where the status(es) of the parent is applied to all the children.

A child, 'inner' consignment can only ever have one parent, 'outer' consignment.

'Cartonisation' allows labels and manifests to be generated for two independent legs of a journey, for separate carriers that have no relationship, and for the consignments to be tracked over both legs.

The first leg of the journey is the delivery of the parent and child consignments to the seller's central distribution centre by a carrier or retailer fleet vehicle,

The second leg is the tracked transit of the child consignments to local stores, and 'delivery' is the consumer collection.


The parent/child linking means that a store receipt for the parent, and its subsequent 'cartonisation', can be used as events to trigger e-mails for all the children, so that the associated consumers are notified when their packages can be picked up.

How to Cartonise a Consignment

The sequence of events for Delivery Tracker cartonisation is as follows:

  1. Create the parent record for the pallet/large box by using createConsignments.

    Store the automatically generated Consignment Code (starting with DMC).

  2. Create and allocate the child record for each 'inner' package using, for example despatchConsignmentWithBookingCode, despatchConsignment or createAndAllocateConsignmentsWithBookingCode. You should specify the same carrier service code for each package (this should be the one for the carrier in the destination country if using Direct Injection).

    Store each Consignment Code.

  3. Generate the paperwork for each child consignment.

    If you used despatchConsignmentWithBookingCode or despatchConsignment, the paperwork will have been generated as part of the call. If you used createAndAllocateConsignmentsWithBookingCode, then you need to use one of the following: createPaperworkForConsignments, createPaperworkForCarton or createPaperworkForParcel.

  4. Allocate the parent consignment to a carrier service using allocateConsignmentsWithBookingCode.

  5. Use addInnerToOuter to link each child to the parent as it is being packed. You do this using the parent/child Consignment Codes and parcel numbers (e.g. link parcel 1 of the child consignment to parcel 1 of the parent consignment).

  6. Generate the paperwork for the parent consignment, using one of the following: createPaperworkForConsignments, createPaperworkForCarton or createPaperworkForParcel.

  7. Associate all the consignments (parent and child) with the same Manifest Group Code, so that they all go on the same trailer for the first leg of the journey (refer to Scan to Trailer).

  8. Mark all the consignments (both 'inner' and 'outer') as ready to manifest.

  9. Create the manifest.