PB Presort

Overview

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

Onboarding 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 PB Presort schedules a regular time for pick up parcels.
Rate charts Use the rate charts instead of the API to rate shipments. Do not use the Rates API to request a rate for a PB Presort shipment. That results in an error.

Shipping Operations

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


Supported Services

ID Service
BPM Bound Printed Matter
PRCLSEL Parcel Select
PSLW Parcel Select Lightweight
STANDARD Standard Mail


Supported Special Service

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

The following are the available special services. The table is alphabetized by the “Special Service” column.

ID Special Service Services Supporting the Special Service
DelCon Delivery Confirmation STANDARD, PRCLSEL


Supported Parcel Types

ID Parcel Type Services Supporting the Parcel Type
LGENV Large Envelope/Flat. BPM, STANDARD
PKG Package BPM, PRCLSEL, PSLW


Supported Label Sizes and Formats

  • Label size uses upper-case X. Using lower case will result in an error.
  • A URL document is available for 24 hours after the document is created.
  • Advise shippers on correct label placement. Please see What is the correct placement for a shipping label?
  • 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.
Label Size File Format Content Type
DOC_4X6 PDF

PNG

ZPL2 [1]
URL

BASE64

BASE64
DOC_6X4 PDF

PNG

ZPL2 [1]
URL

BASE64

BASE64
[1](1, 2) 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.

Example documents object:

"documents": [ {
    "type": "SHIPPING_LABEL",
    "size": "DOC_4X6",
    "fileFormat": "PDF",
    "contentType": "URL",
    "printDialogOption": "EMBED_PRINT_DIALOG"
} ]