Pitney Bowes Cross-Border Delivery Service (CBDS)¶

On This Page:

Overview
Onboard to Ship with CBDS
API Operations for Shipping with CBDS
CBDS Services
CBDS Parcels
CBDS Labels
CBDS Tracking
See Also

Overview¶

The PB Cross-Border Delivery Service (CBDS) ships parcels from CBDS Hubs to international and domestic destinations and ensures international parcels comply with international regulations before shipment. CBDS is a post-paid service. CBDS provides:

International Outbound shipping from the U.S., Canada, and United Kingdom.
International Inbound shipping to Canada.
Return shipping from Canada to the U.S.
Domestic shipping within Canada.

Onboard to Ship with CBDS¶

To onboard a merchant to ship with CBDS through the Ecommerce APIs, contact either ClientSupportTechServices@pb.com or ShippingAPIBusinessDevelopment@pb.com, or contact the merchant’s implementation manager.

During onboarding, the merchant chooses a delivery solution. The solution determines how parcels arrive at the CBDS Hub before they are shipped to their destinations.

API Operations for Shipping with CBDS¶

CBDS uses the API operations listed below. The operations include rating, shipping, tracking, and other operations. For the common sequence of operations used to ship a parcel, see this workflow.

Operation	Method	Resource Path
Rate a Parcel	POST	/v1/rates
Create an International Outbound Shipment	POST	/v1/shipments?carrier=PBI
Create an International Inbound Shipment	POST	/v1/shipments?carrier=PBI
Create International Inbound Container Labels	POST	/v1/container-manifest/Batch?carrier=PBI
Create a Domestic Shipment (Canada Only)	POST	/v1/shipments?carrier=PBI
Create a Return Label	POST	/v1/shipments?carrier=PBI
Reprint a Lost or Damaged Label	GET	/v1/shipments/{shipmentId}?carrier={carrier}
Retry a Label	GET	/v1/shipments?originalTransactionId={transaction_id}&carrier={carrier}
Void a Label	DELETE	/v1/shipments/{shipmentId}?carrier={carrier}&cancelInitiator=SHIPPER
Get Tracking Information	GET	/v1/tracking/{trackingNumber}?packageIdentifierType=TrackingNumber
Predict an HS Code	POST	/v1/crossborder/hs-classification/items
Get a Quote for a Shopping Cart	POST	/v1/crossborder/checkout/quotes
Manage Merchant Accounts	——	See API Operations for Merchant Accounts.

CBDS Services¶

CBDS offers the following services. Availability of a service depends on the merchant’s service agreement and on the shipping lane. For U.S. outbound shipping lanes, download the spreadsheet provided on this page.

International Outbound Services¶

International Outbound uses the following services:

Service ID

Description

Delivery Terms

Supported by Rates API?

Additional Info

PBXPE

Expedited DDP

DDP

Yes

Faster than Standard DDP and costs more. Does not support delivery to P.O. Boxes.

PBXPS

Standard DDP

DDP

Yes

More cost effective than Expedited DDP.

PBXUS

Standard DDU

DDU

Yes

Postal clearance is at the country of destination.

International Inbound Services¶

International Inbound uses the following services:

Service ID

Description

Supported by Rates API?

PBIBCS

Container Freight Station (CFS) Standard

No

PBIBS

PB Inbound Standard

No

Canada Domestic Service¶

CBDS Domestic uses the following services:

Service ID

Description

Supported by Rates API?

PBDS

Domestic Standard Service

No

Returns Services¶

CBDS Returns use the following services:

Service ID

Description

Supported by Rates API?

PBXRCS

Return Standard Consolidated

No

PBXRS

Return Standard Per Piece

No

Delivery Terms¶

Every shipment has a Transportation cost and an Importation cost. The Importation cost covers the duties and taxes charged at the destination country’s border. The Delivery Terms specify whether the merchant or the buyer pays the Importation cost. Each CBDS service class specifies one of the following delivery terms:

DDP: Delivered Duty Paid. The merchant pays both the Transportation and Importation costs. When a merchant creates a shipment that uses a DDP service class, the API returns estimates for both the Transportation and Importation costs.
DDU: Delivery Duty Unpaid. The merchant pays only the Transportation cost. The buyer is responsible for the Importation cost and might have to pay this upon receipt of the parcel. When a merchant creates a shipment that uses DDU, the API returns an estimate only for the Transportation cost.

CBDS Parcels¶

CBDS shipments use the following parcel type.

ID

Parcel Type

PKG

Package

CBDS Labels¶

In this section

Label Considerations
Label Sizes for USPS and PB Standard Labels Printed for CBDS
Label Options for USPS Labels Printed for CBDS
Label Options for PB Standard Labels Printed for CBDS
Label Options for CBDS Domestic Shipments

Label Considerations¶

The merchant’s delivery solution determines whether the Create Shipment API prints a label.
The value for the label size uses an uppercase X. Do not use a lowercase x.
Labels retrieved through URLs are available for 24 hours after creation.
For ZPL2 labels, if your printer does not support Unicode, see Troubleshoot a Problem Printing ZPL2 Labels.

Label Sizes for USPS and PB Standard Labels Printed for CBDS¶

Label size	USPS (PB Expedited)	PB Standard Delivery
DOC_4X4		✓
DOC_4X5		✓
DOC_4X6	✓	✓
DOC_4X8	✓
DOC_6X4	✓
DOC_8X11	✓
DOC_9X4	✓

Label Options for USPS Labels Printed for CBDS¶

If the CBDS shipment prints a USPS label, use the options described here. Before printing a label, please see the Label Considerations above.

Label Size

File Format

Content Type

Resolution

DOC_4X6

PDF

PNG

ZPL2

URL

BASE64

not applicable

DPI_203, DPI_300 (default)

DPI_203 (default), DPI_300 (domestic labels only)

DOC_4X8

PDF

PNG

ZPL2

URL

BASE64

not applicable

DOC_6X4

PDF

PNG

ZPL2

URL

BASE64

not applicable

DPI_203

DOC_8X11

PDF

PNG

URL

BASE64

not applicable

DPI_300

DOC_9X4

PDF

PNG

URL

BASE64

not applicable

DPI_203

Label Options for PB Standard Labels Printed for CBDS¶

If the CBDS shipment prints a PB Standard label, use the options described here. Before printing a label, please see the Label Considerations above.

Label Size

File Format

Content Type

Resolution

DOC_4X4

PDF

PNG

ZPL2

URL

BASE64

DPI_203

DPI_203 (default), DPI_300

DOC_4X5

PDF

PNG

ZPL2

TIF

BMP

URL

BASE64

DPI_203

DPI_203 (default), DPI_300

DPI_203, DPI_300, DPI_600 (default)

DOC_4X6

PDF

PNG

ZPL2

BMP

URL

BASE64

DPI_203

DPI_203 (default), DPI_300

DPI_203, DPI_300, DPI_600 (default)

Label Options for CBDS Domestic Shipments¶

Before printing a label, please see the Label Considerations above.

CBDS Domestic Shipments use the label options described here. A PDF label can be returned as either a URL or BASE64-encoded PDF. If the options you choose are not supported by the domestic carrier, the API might return different options from those you sent in the request.

Label Size

File Format

Content Type

Orientation

DOC_4X6

PDF

PNG

URL

BASE64

portrait

DOC_6X4

PDF

PNG

URL

BASE64

landscape

CBDS Tracking¶

You can track CBDS parcels through the following:

Pitney Bowes Cross-Border Delivery Service (CBDS)¶

Overview¶

Onboard to Ship with CBDS¶

API Operations for Shipping with CBDS¶

CBDS Services¶

International Outbound Services¶

International Inbound Services¶

Canada Domestic Service¶

Returns Services¶

Delivery Terms¶

CBDS Parcels¶

CBDS Labels¶

Label Considerations¶

Label Sizes for USPS and PB Standard Labels Printed for CBDS¶

Label Options for USPS Labels Printed for CBDS¶

Label Options for PB Standard Labels Printed for CBDS¶

Label Options for CBDS Domestic Shipments¶

CBDS Tracking¶

See Also¶