PB Standard Delivery FAQs

← Back to All FAQs

Can I retrieve rates for PB Standard Delivery shipments?

Yes. You can use the Rates API to retrieve rates for PB Standard Delivery shipments. Note, however, that you cannot retrieve rates for PB Standard Returns shipments.

Does my shipper rate plan apply to PB Standard Delivery shipments?

No. Shipper rate plans apply only to prepaid USPS shipments. They do not apply to PB Standard Delivery shipments.

Does my postage account get charged when I print a PB Standard Delivery label?

No. PB Standard Delivery labels are post-paid labels and do not incur a charges at print time.

Can I subscribe a shipment to notifications?

Yes. You can subscribe a shipment to receive provisioned notifications by including the NOTIFICATIONS special service in the request. To use this feature, you must be configured for PB Standard notifications. For more information, see PB Standard Notifications.

Can I include reference fields in a PB Standard Delivery shipment?

Yes. To pass merchant-defined reference fields or reference IDs, see PB Standard References.

What is the default non-delivery option?

The NON_DELIVERY_OPTION shipment option provides instructions to USPS if a parcel cannot be delivered. If you leave this option out, USPS treats an undeliverable package as follows, depending on the service class:

  • Parcel Select (PRCLSEL) is treated as “Forwarding Service Requested” (ForwardingServiceRequested).

  • Parcel Select Lightweight (PSLW) is destroyed by USPS.

Can I use the APAC Services to create a shipment and default services to manifest or void it?

No. If you use the Asia-Pacific (APAC) Services to create a shipment, you must also use the APAC Services if you manifest or void the shipment. The opposite is also true. If you use the default services to create a shipment, you must use the default services if you manifest or void the shipment.

Why is “Exception Label” printed on the label?

If a label prints with the words “Exception Label,” the label is still a fully compliant and valid label. “Exception Label” indicates that the sort information was not available at the time of print.

Exception Label


Can I use my PB Standard Delivery request to print a PB Expedited label?

Yes. To use your Standard Delivery request to print a PB Expedited label, set the carrier to USPS and set the service, parcel type, and special services to the desired PB Expedited options. For PB Expedited options, see the Pitney Bowes reference page.

In the shipmentOptions array, you can leave the options that are specific to PB Standard as is. They will be ignored. In the references array, you can leave the options as is if you will not use the array to pass references. If you will use the array to pass references, enter the desired values. Either way, the reference values are returned in the response. You can choose to use them or ignore them.

Example

In the following example, the left column shows the request body for a PB Standard shipment. The right column shows the same request modified to create a PB Expedited shipment. The PB Expedited request does the following:

  • Sets the rates.carrier field to USPS (line 17).

  • Sets the rates.serviceId field to PM (line 18).

  • Adds the “Ins” special service (lines 24-27).

  • Makes no changes to the CLIENT_FACILITY_ID and CARRIER_FACILITY_ID options (lines 44-48). They will be ignored by PB Expedited.

  • Changes the name and value of the first object in the references array in order to pass a reference specific to the PB Expedited shipment (lines 55-56).

  • Makes no changes to the second and third objects in the references array, even though they are not used by PB Expedited (lines 58-62). They will be returned in the response, but you can ignore them.

Standard Delivery Shipment:
 1 {
 2     "fromAddress": { ... },
 3     "toAddress": { ... },
 4     "parcel": {
 5         "weight": {
 6             "unitOfMeasurement": "OZ",
 7             "weight": 8
 8         },
 9         "dimension": {
10             "unitOfMeasurement": "IN",
11             "length": 6,
12             "width": 1,
13             "height": 4
14         }
15     },
16     "rates": [ {
17         "carrier": "NEWGISTICS",
18         "serviceId": "PRCLSEL",
19         "parcelType": "PKG",
20         "specialServices": [ {
21             "specialServiceId": "DelCon",
22             "inputParameters": [ ]
23 
24 
25 
26 
27 
28 
29         } ]
30     } ],
31     "documents": [ {
32         "size": "DOC_4X6",
33         "fileFormat": "PDF",
34         "contentType": "URL",
35         "type": "SHIPPING_LABEL"
36     } ],
37     "shipmentOptions": [ {
38         "name": "SHIPPER_ID",
39         "value": "9024324564"
40       },{
41         "name": "ADD_TO_MANIFEST",
42         "value": "true"
43       },{
44         "name": "CLIENT_FACILITY_ID",
45         "value": "0093"
46       },{
47         "name": "CARRIER_FACILITY_ID",
48         "value": "1585"
49       },{
50         "name": "PRINT_CUSTOM_MESSAGE_2",
51         "value": "Thank you for shopping with us!"
52       }
53     ],
54     "references": [ {
55         "name": "ReferenceNumber",
56         "value": "28914-035761"
57       },{
58         "name": "AddlRef1",
59         "value": "124C78d576-5432"
60       },{
61         "name": "AddlRef2",
62         "value": "CC4321"
63     } ]
64 }
Expedited Delivery Shipment:
{
    "fromAddress": { ... },
    "toAddress": { ... },
    "parcel": {
        "weight": {
            "unitOfMeasurement": "OZ",
            "weight": 8
        },
        "dimension": {
            "unitOfMeasurement": "IN",
            "length": 6,
            "width": 1,
            "height": 4
        }
    },
    "rates": [ {
        "carrier": "USPS",
        "serviceId": "PM",
        "parcelType": "PKG",
        "specialServices": [ {
            "specialServiceId": "DelCon",
            "inputParameters": [ ]
        },{
            "specialServiceId": "Ins",
            "inputParameters": [ {
                "name": "INPUT_VALUE",
                "value": "50"
            } ]
        } ]
    } ],
    "documents": [ {
        "size": "DOC_4X6",
        "fileFormat": "PDF",
        "contentType": "URL",
        "type": "SHIPPING_LABEL"
    } ],
    "shipmentOptions": [ {
        "name": "SHIPPER_ID",
        "value": "9024324564"
      },{
        "name": "ADD_TO_MANIFEST",
        "value": "true"
      },{
        "name": "CLIENT_FACILITY_ID",
        "value": "0093"
      },{
        "name": "CARRIER_FACILITY_ID",
        "value": "1585"
      },{
        "name": "PRINT_CUSTOM_MESSAGE_2",
        "value": "Thank you for shopping with us!"
      }
    ],
    "references": [ {
        "name": "Order_Number",
        "value": "123876-54910"
      },{
        "name": "AddlRef1",
        "value": "124C78d576-5432"
      },{
        "name": "AddlRef2",
        "value": "CC4321"
    } ]
}