Pitney Bowes Cross-Border Delivery Service (CBDS)

Overview

The PB Cross-Border Delivery Service (CBDS) ships parcels from CBDS Hubs to international destinations and ensures the 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. (Coming Soon)

CBDS additionally provides 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 before you create a shipment	POST	/v1/rates
Create a CBDS international outbound shipment	POST	/v1/shipments
Create a CBDS international inbound shipment	POST	/v1/shipments
Create a CBDS domestic shipment (Canada only)	POST	/v1/shipments
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
Predicted the 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

The following services are used by international outbound shipping:

Service ID	Service Name	Delivery Terms	Description
PBXPS	Standard DDP	DDP	This service is cost effective and offers full tracking.
PBXUS	Standard DDU	DDU	The service uses postal clearance at the country of destination.
PBXPE	Expedited DDP	DDP	This service is faster than Prepay Standard and costs more. It offers full tracking. Note: Expedited DDP does not support delivery to P.O. Boxes.

International Inbound Services

Note

International inbound shipping is Coming Soon.

The following services are used by international inbound shipping:

Service ID	Service Name
PBIBS	PB Inbound Standard
PBIBCS	CFS Standard

Canada Domestic Service

The following service is used by domestic shipping, available in Canada only:

Service ID	Service Name	Description
PBDS	Domestic Standard Service	For more information, see Create a domestic shipment (Canada only).

Returns Services

The following services are used by CBDS Returns:

Service ID	Description
PBXRS	Return standard per piece
PBXRCS	Return standard consolidated

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

Label Considerations

• The merchant’s delivery solution determines whether the Create Shipment API prints a label.

• The value for the label size uses an upper-case X. Do not use a lower-case 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 BASE64	not applicable DPI_203, DPI_300 (default) DPI_203 (default), DPI_300 (domestic labels only)
DOC_4X8	PDF PNG ZPL2	URL BASE64 BASE64	not applicable not applicable not applicable
DOC_6X4	PDF PNG ZPL2	URL BASE64 BASE64	not applicable DPI_203 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 BASE64	DPI_203 DPI_203 DPI_203 (default), DPI_300
DOC_4X5	PDF PNG ZPL2 TIF BMP	URL BASE64 BASE64 BASE64 BASE64	DPI_203 DPI_203 DPI_203 (default), DPI_300 DPI_203, DPI_300, DPI_600 (default) DPI_203, DPI_300, DPI_600 (default)
DOC_4X6	PDF PNG ZPL2 BMP	URL BASE64 BASE64 BASE64	DPI_203 DPI_203 DPI_203 (default), DPI_300 DPI_203, DPI_300, DPI_600 (default)

Label Options for CBDS Domestic Shipments

CBDS Domestic Shipments use the label options described here. 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.

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

Label Size	File Format	Content Type	Resolution
DOC_4X6	PDF PNG	URL BASE64	DPI_203 DPI_203

CBDS Tracking

You can track CBDS parcels through the following:

• Track a Package API

• Track a Parcel Online

• Branded Tracking page

• Delivery Solutions
• Compliance
• Invoices
• CBDS Hubs
• Shipping Lanes

 
 
 
 

• next
• previous |

© Copyright 2022, PB.