PB Presort

Overview

PB Presort provides presort services for domestic shipment of flats and letters. Presort labels are post-paid labels. No postage is charged at the time of print.

Onboard a Merchant to use PB Presort

A merchant must be enrolled with a PB Presort facility to use the service. To enroll a merchant, contact your Pitney Bowes account representative. Pitney Bowes will provide the following information for the merchant:

Mailer ID The Mailer ID (MID) identifies the merchant as validated for PB Presort. When creating a label, specify the MID value in the X-PB-Integrator-CarrierId header.
Job number

This identifies the agreement between the merchant and PB Presort for a committed volume of parcels and specific class of service at an agreed-upon rate. A merchant can be assigned multiple job numbers.

When creating a label, specify the job number in the X-PB-ShipmentGroupId header.

Date and time of pickup The regularly scheduled time for parcel pickup.
Rate charts The rates for PB Presort shipments. To determine a rate for a PB Presort shipment, use the rate charts. Do not use the Rates API.

Shipping Operations

Important

To rate a PB Presort shipment, use the rate charts. Do not use the Rates API.

Operation
Method Endpoint

Create PB Presort Label

POST

/v1/shipments
 

Reprint Label

GET

/v1/shipments/{shipmentId}?carrier={carrier}
 

Retry Label

GET

/v1/shipments?originalTransactionId={transaction_id}&carrier={carrier}
 

Create a PB Presort Pickup Slip

POST

/v1/manifests
 

Get Tracking Information

GET

/v1/tracking/{trackingNumber}?packageIdentifierType=TrackingNumber&carrier=USPS
 

Services

PB Presort supports the following services:

ID Service
BPM Bound Printed Matter
STANDARD Standard Mail


Special Service

The following special service is supported for PB Presort.

Important: Do not include a special service unless you intend to apply it.

ID Special Service Services Supporting the Special Service Input Parameter
DelCon Delivery Confirmation STANDARD

Input parameters are not required for DelCon. To use DelCon, add the following to the rates.specialServices array:

{ "specialServiceId": "DelCon" }


Parcel Types and Labels

Please read the following label considerations before creating a PB Presort shipment:

  • The label size, as specified in the documents.size field, uses an upper-case X. Using a lower-case x will result in an error.
  • If you choose to retrieve the label through a URL, the URL is available for 24 hours after the shipment is created.
  • By default, the APIs print ZPL2 labels using the Unicode character set. If you have an older printer that does not support Unicode, see this troubleshooting topic.
  • Advise shippers on correct label placement. Please see What is the correct placement for a shipping label?

The following table describes the options for each parcel type and label size.

Parcel Type ID

Parcel Type

Supported Services

Supported Label Size

Label Format / Content Type

Label Barcode

LGENV Large Envelope (Flat) BPM or STANDARD DOC_6X4 PDF / URL
ZPL2 / BASE64
IMb
PKG Package BPM DOC_4X6 PDF / URL
ZPL2 / BASE64
IMpb