Newgistics

Overview

The PB Complete Shipping APIs provide integration to Newgistics domestic shipping services. Newgistics labels are post-paid labels. Postage is not charged at the time of print.

Onboarding a Merchant to use Newgistics

  1. Contact Newgistics to set up the merchant at one or more Newgistics hubs. Newgistics will provide the merchant with the following Newgistics IDs, which are required when creating Newgistics shipments and manifests:
    • Client Facility ID
    • Newgistics Facility ID
    • Newgistics Merchant ID
  2. If you have not already done so, enroll the merchant within your PB developer account using one of the Merchant Enrollment Models. Pitney Bowes assigns the merchant a PB Shipper ID.
  3. Contact PB Support to enable the merchant to use Newgistics. Send an email to ShippingAPISupport@pb.com and provide the merchant’s Newgistics IDs and PB Shipper ID.

Newgistics IDs

The Newgistics representative provides the merchant with the following IDs. To test the APIs on the sandbox environment, use the ID values listed in the Sandbox Value column.

ID Description API Field Sandbox Value
Client Facility ID This identifies a merchant location/facility. A merchant can have multiple client facility IDs. CLIENT_FACILITY_ID When testing in the sandbox environment, set this to 0093.
Newgistics Facility ID The Newgistics facility assigned to the merchant. A merchant can be assigned multiple Newgistics facilities. CARRIER_FACILITY_ID When testing in the sandbox environment, set this to 1585.
Newgistics Merchant ID
The unique ID assigned by Newgistics to a merchant. CLIENT_ID When testing in the sandbox environment, set this to NGST.

Shipping Operations

The following shipping operations can be used with Newgistics.

Operation Method Endpoint

Validate Address

POST

/v1/addresses/verify
 

Suggest Addresses

POST

/v1/addresses/verify-suggest
 

Create Newgistics Label

POST

/v1/shipments
 

Reprint Label

GET

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

Retry Label

GET

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

Void Label

DELETE

/v1/shipments/{shipmentId}
 

Create a Newgistics Manifest (Closeout)

POST

/v1/manifests
 

Get Tracking Information

GET

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


Supported Services

ID Service
BPM Bound Printed Matter
PRCLSEL Parcel Select
PSLW Parcel Select Lightweight
FCM First-Class Mail
PM Priority Mail


Supported Special Services

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
DelCon Delivery Confirmation
Sig Signature Confirmation
NOTIFICATIONS Subscribe to provisioned transit triggers.


Supported Parcel Type

ID Parcel Type Services Supporting the Parcel Type
PKG Package BPM, PRCLSEL, PSLW, FCM, PM


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_4X5 PDF

PNG

ZPL2 [1]
URL

BASE64

BASE64
DOC_4X6 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"
} ]

Sample Newgistics Label

Sample Newgistics Label