How do I Add Reference Fields for My Carrier?

← Shipping FAQs

Reference fields (also called reference numbers and reference IDs) are custom identifiers you can add to a shipment, such as order numbers or customer IDs. How you add reference fields depends on the carrier. See the sections below for how to add reference fields for your carrier.

PB Expedited Reference Fields

You can print reference fields on the shipping label. To do so, include one or both of the following in the shipmentOptions array:

PB Standard Reference Fields

You can store reference fields in the shipment data and print reference fields on the shipping label:

  • To store reference fields in the shipment data, enter the fields in the references array when creating the shipment. For details, see PB Standard References.

  • To print reference fields on the shipping label include the PRINT_CUSTOM_MESSAGE_2 option in the shipmentOptions array when creating the shipment.

Cross-Border Delivery Service (CBDS) Reference Fields

You can associate the order ID with a shipment. CBDS will include the ID in the tracking file and invoice.

To associate the order ID, set the following in the references array when creating the shipment:

  • Set references.name to ORDER_NUMBER.

  • Set references.value to the order ID. The order ID cannot contain spaces.

For example:

"references": [ {
    "name": "ORDER_NUMBER",
    "value": "123456"
} ]

PB Presort Reference Fields

You can print reference fields on the shipping label. To do so, include one or both of the following in the shipmentOptions array. Note that you can print reference fields for certain parcel types only. For details, see the definition of each shipment option:

FedEx Reference Fields

You can print reference fields on the shipping label by including the PRINT_CUSTOM_MESSAGE_1 option in the shipmentOptions array when creating the shipment.