Overview

When creating consignments that involve pallets, you may need to specify different pallet types such as CHEP, Loscam, or other pallet varieties. This guide explains how to properly specify pallet types in your consignment requests.

Item Types

When creating a consignment with pallets, you should first set the appropriate item type. The following pallet types are available:

  • Pallet - Generic pallet type
  • Chep - Standard CHEP pallet
  • ChepWood - CHEP wooden pallet
  • ChepPlastic - CHEP plastic pallet
  • Loscam - Standard Loscam pallet
  • LoscamWood - Loscam wooden pallet
  • LoscamPlastic - Loscam plastic pallet

{info} These ItemTypes may not be available by default in your MachShip account. If they do not appear in the itemType dropdown in MachShip, please contact your broker or MachShip support to enable them.

Note: The generic Chep and Loscam types are typically sufficient for most carriers. The material-specific versions (wood/plastic) should only be used when specifically required by the carrier.

Custom Values

To specify the quantity of each pallet type, use the customValues array in your consignment request. Each custom value object requires:

  • propertyName: The type of pallet (LoscamPallets, ChepPallets, or OtherPallets)
  • value: The quantity of pallets (integer)

The allowed property names are:

  • LoscamPallets
  • ChepPallets
  • OtherPallets

Examples

Example 1: Single Pallet Type

{
  "items": [
    {
      "itemType": "Chep",
      "name": "CHEP Pallets",
      "quantity": 2,
      "height": 100,
      "weight": 500,
      "length": 120,
      "width": 120
    }
  ],
  "customValues": [
    {
      "propertyName": "ChepPallets",
      "value": 2
    }
  ]
}

Example 2: Multiple Pallet Types

{
  "items": [
    {
      "itemType": "Chep",
      "name": "CHEP Pallets",
      "quantity": 2,
      "height": 100,
      "weight": 500,
      "length": 120,
      "width": 120
    },
    {
      "itemType": "Loscam",
      "name": "Loscam Pallets",
      "quantity": 1,
      "height": 100,
      "weight": 250,
      "length": 120,
      "width": 120
    }
  ],
  "customValues": [
    {
      "propertyName": "ChepPallets",
      "value": 2
    },
    {
      "propertyName": "LoscamPallets",
      "value": 1
    }
  ]
}

For more information about creating consignments, refer to our Creating Consignments Guide.

Additional Carrier-Specific Custom Values

While the above fields are typically all that is required, some carriers or situations do have additional custom field values you may need to implement.

Common property names may include:

  • IsTransfer
  • LoscamPalletsTransferDocketNumber
  • ChepPalletsTransferDocketNumber
  • OtherPalletsTransferDocketNumber

It is recommend you manifest consignments with the carriers during your testing phase and confirm all data they required has been included in the transfer.