Void Parcel Protection Coverage

HTTP Request

POST /v1/parcel-protection/void?parcelProtectionReferenceId={policyId}

Summary

This operation voids PB Parcel Protection coverage for a shipment.

Things to Consider

  1. To cancel coverage, the merchant must provide the Parcel Protection Policy ID. The ID was returned in the parcelProtectionReferenceID field in the response of the original Request Parcel Protection Coverage API call.
  2. Merchants cannot void coverage for packages that have already shipped or been delivered.

Request URIs

Sandbox: https://api-sandbox.pitneybowes.com/shippingservices/v1/parcel-protection/void?parcelProtectionReferenceId={policyId}
Production: https://api.pitneybowes.com/shippingservices/v1/parcel-protection/void?parcelProtectionReferenceId={policyId}

Query Parameters

Query parameters are optional.

Name Description
parcelProtectionReferenceId The identifier for the PB Parcel Protection policy that is being voided.

Request Headers

Name
Description
Authorization Required. OAuth token generated using the Generate an OAuth Token API.
Content-Type Required. The media type of the request entity. Set this to application/json.
Accept-Language Language and country code. Default: en-US
X-PB-TransactionId

Required. A unique identifier for the transaction, up to 25 characters.

Important: You must ensure this is a unique id.

X-PB-UnifiedErrorStructure Recommended. Set this to true to use the standard error object if an error occurs.

Request Elements

Name Data Type Description
shipperID String Required. The merchant’s Shipper ID. The Shipper ID is found in the postalReportingNumber field in the merchant object.
parcelProtectionAccountID String Parcel Protection account ID, if applicable.

Response Elements

Name Data Type Description
status String Returns a value of Void_Success to indicate that parcel protection coverage was successfully voided.

Sample Request

curl -X POST .../v1/parcel-protection/void?parcelProtectionReferenceId=IPPOL0010088026244' \
-H "Authorization: Bearer <oauth_token>" \
-H "Content-Type:application/json" \
-H "X-PB-TransactionId: 12345678-705476" \
-H "X-PB-UnifiedErrorStructure: true" \
-d '
{
    "shipperID": "9024324564",
    "parcelProtectionAccountID": "IPACT5320302"
}'

Sample Response

{
    "status": "Void_Success"
}

Error Codes

For a list of all PB Shipping APIs error codes, please see Error Codes.

The following error code is specific to this API:

errorCode errorDescription additionalInfo
131 ParcelProtectionID was voided parcelProtectionID