Newgistics Services, Parcel Types, and Label Sizes

Services

The following are the supported services for Newgistics®.

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

Special Services

The following are the supported special services for Newgistics.

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

ID
Special Service
Input Parameters (inputParameters)
DelCon Delivery Confirmation

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

{ "specialServiceId": "DelCon" }
Sig Signature Confirmation

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

{ "specialServiceId": "Sig" }
NOTIFICATIONS

Subscribe to provisioned transit triggers.

The merchant must be configured for Newgistics transit triggers to use this special service.

To set input parameters, see the Newgistics Transit Triggers section on the Create a Newgistics Shipment page.

Parcels

The following parcel type is supported for Newgistics.

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

Labels

Please read the Label Considerations before printing a Newgistics label.

Label Considerations

  • 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?

Label Sizes and Formats

The following table describes the options for each label size. Set label options in the Documents Object.

Label Size
(size)
File Format
(fileFormat)
Content Type
(contentType)
DPI
(resolution)
DOC_4X4 (Sandbox only) PDF
PNG
ZPL2 [1]
URL
BASE64
BASE64
DPI_203
DPI_203
• DPI_203 (default)
• DPI_300
DOC_4X5 PDF
PNG
ZPL2 [1]
URL
BASE64
BASE64
DPI_203
DPI_203
• DPI_203 (default)
• DPI_300
DOC_4X6 PDF
PNG
ZPL2 [1]
URL
BASE64
BASE64
DPI_203
DPI_203
• DPI_203 (default)
• DPI_300
[1](1, 2, 3) 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.