Rate a Parcel

HTTP Request

POST /v1/rates

Summary

Use this operation to rate a parcel before you print and purchase a shipment label.

Note

This API does not validate addresses.

Considerations

1. You can rate parcels for the following labels:

   • Pitney Bowes Delivery (PB Expedited Delivery and PB Standard Delivery)

   • PB Expedited Returns

   • CBDS

   • FedEx

   • UPS

   Note

   The Rates API does not return rates for PB Standard Returns.

2. To rate a parcel for a single service, include the serviceId in the request body. The response will return a single Rates Object.

   PB Standard Delivery only: The serviceId field is required.

3. To rate a parcel for multiple services for a given parcel type, omit the serviceId field from the request body. The response will contain a separate Rates Object for each service rated.

   PB Standard Delivery only: You can rate a parcel for only one service at a time. The serviceId field is required.

4. PB Expedited only: To rate a parcel for multiple services and parcel types at once, omit both the serviceId and parcelType fields in the request body. The response will contain a separate Rates Object for each combination of service and parcel type rated.

5. The fromAddress and toAddress objects require the following address fields:

   Carrier	Required Fields
   PB Expedited	postalCode countryCode
   PB Standard	The fromAddress object requires the following fields: addressLines postalCode countryCode The toAddress object requires the following fields: name addressLines cityTown stateProvince postalCode countryCode
   CBDS	name addressLines cityTown stateProvince countryCode
   UPS	name postalCode countryCode

6. The Rate a Parcel API does not validate addresses.

7. You must include the SHIPPER_ID option in the shipmentOptions array. This ensures the API returns the correct rates. (Note that in some cases the API leaves the shipmentOptions array out of the response.)

8. You can pass only one Rates Object in the request body, as shown in the Sample Requests below. The response might contain multiple Rates Objects, which can occur if you have omitted the serviceId field from the request.

9. For the available services and parcel types, see the carrier’s reference page.

10. PB Expedited only: The PB Ecommerce APIs require that all parcels be trackable. If you are rating a service that is not trackable, such as Priority Mail (PM), add at least one trackable special service, such as Delivery Confirmation (DelCon). DelCon is a no-charge service that triggers tracking but does not increase the cost of the shipment. Before adding a special service, check its compatibility with the service.

11. PB Standard Delivery only: The following additional fields are required in the request body:

    • parcel.weight

    • parcel.dimension

    • rates.carrier: Set this to PBCS. (Note that the deprecated value NEWGISTICS still works.)

    • rates.serviceId: Rating is available only for Parcel Select and Parcel Select Lightweight. Set this to either PRCLSEL (Parcel Select) or PSLW (Parcel Select Lightweight).

    • rates.parcelType: Set this to PKG.

    • shipmentOptions: You must include the following options:

      • SHIPPER_ID

      • CLIENT_ID. If testing in Sandbox, use the following value: NGST

      • CLIENT_FACILITY_ID. If testing in Sandbox, use the following value: 0093

      • CARRIER_FACILITY_ID. If testing in Sandbox, use the following value: 1585

      • If you set an irregular parcel girth value in the parcel.dimension object, then you must include the IS_RECTANGULAR option and set it to false.

    Important

    The Rates API uses different Sandbox values than other APIs for CLIENT_ID and CARRIER_FACILITY_ID.

12. PB Standard Delivery only: In the response body, the totalCarrierCharge equals the baseCharge plus all surcharges.

    The surcharges array will show only the FUEL surcharge. If other surcharges apply, they are not shown in the surcharges array. They are, however, included in the totalCarrierCharge.

Request URLs

Sandbox: https://shipping-api-sandbox.pitneybowes.com/shippingservices/v1/rates
Production: https://shipping-api.pitneybowes.com/shippingservices/v1/rates

Query Parameter

The query parameter is optional.

Name	Description
includeDeliveryCommitment	When set to true, returns estimated transit time. Transit time is returned as number of days. Valid values: true false Note: This parameter is not available for PB Standard Delivery.
carrier	CBDS only. Required for PB Cross-Border Delivery Service (CBDS). Set this to PBI.

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.
X-PB-Shipper-Rate-Plan	Shipper rate plan, if applicable. For more information, see this FAQ.
X-PB-Integrator-CarrierId	Negotiated services rate, if applicable.
X-PB-Shipper-Carrier-AccountId	Conditional. The unique identifier for the carrier account. To retrieve the identifier, see this FAQ. This header is required if the merchant has registered multiple accounts for the same carrier. For more information, see Add Carrier Accounts.
X-PB-UnifiedErrorStructure	Recommended. Set this to true to use the standard error object if an error occurs.

Request / Response Elements

The Rates API sends and receives a Shipment Object. The table below describes all possible fields in the Shipment Object. Some do not apply to this operation and are marked as such.

Important

Some fields in the Shipment Object do not apply to the Rates API.

Name	Data Type	Description
fromAddress	Address Object	Required. Origin address. If you want a different address to appear on the label from the one listed here, see How do I print a return address that is different from the origin address?
toAddress	Address Object	Required. Destination address. FedEx, UPS: If you are shipping with FedEx or UPS to Puerto Rico or an international destination, and if the importer is different from the final recipient, this is the address of the importer. Enter the recipient’s address in the soldToAddress object. If importer’s address is the same as the final recipient, the toAddress and soldToAddress must match.
altReturnAddress	Address Object	PB Expedited, CBDS Only. Sets the address for parcel returns. Use this in the following situations: PB Expedited: If you are sending an international shipment and if you have set the NON_DELIVERY_OPTION option to redirect, use this field to specify the address for a parcel return. CBDS shipment: By default, parcel returns are sent to a shipment’s fromAddress. (Parcel returns are sent from the Consolidation Center.) If the fromAddress is the wrong address for your returns, then you must use the altReturnAddress to enter the correct address for returns. Failure to enter the correct address will result in parcels being returned to the wrong address.
parcel	Parcel Object	Required. Contains physical characteristics of the parcel.
rates	Array[Rates Object]	Required. Specifies the carrier, service, parcel, and other information. In a response, this field also contains the service charges. Important: In a request, the rates array can contain only one rates object.
documents	Array[Documents Object]	Conditional. Defines the label, manifest, or other shipping document created by the API call. In a response, this array provides the URL or Base64 string for a document and in some cases can contain multiple objects. This field is required, except in the following cases: This field does not apply to Rate Parcel requests. This field does not apply to the Create CBDS Shipment request if the merchant prints the first-mile label prior to invoking the API.
shipmentOptions	Array[Object]	Required. Each object in this array defines a shipment option. Specify each option as a name-value pair in the array. The SHIPPER_ID option is required. For additional requirements for a carrier, see the Considerations section on the carrier’s Create Shipment page.
shipmentOptions.name	String	The name of the shipment option.
shipmentOptions.value	String	The value of the shipment option.
customs	Object	Conditional. For shipments that use customs forms, this object contains the customs information. This field is required for the following carriers in the following situations: PB Expedited: Required for shipments to international destinations. Conditional for shipments to APO/FPO/DPO, U.S. Territories, and FAS, as explained in this FAQ. CBDS: Required for all shipments. FedEx: Required for shipments to international destinations and Puerto Rico. UPS: Required for shipments to international destinations and Puerto Rico.
customs.customsInfo	Customs Info Object	Customs clearance information for the commercial invoice. When using the Customs Info Object, make sure to include the fields marked Required.
customs.customsItems	Array[Customs Items Object]	Customs clearance information for each commodity. When using the Customs Items Object, make sure to include the fields marked Required. The maximum number of objects in this array is 30.
domesticShipmentDetails	Domestic Shipment Details Object	CBDS Only. Required if the merchant prints the first-mile label prior to invoking the Create CBDS Shipment API. This object contains information about the first-mile leg of the shipment.
soldToAddress	Address Object	FedEx, UPS Only. The final recipient of a the shipment. Required for a shipment from the U.S. to Puerto Rico or to an international destination. Otherwise optional. This address must match the toAddress.countryCode, with the exception of shipments to Canada and to U.S. satellite countries. If the final recipient’s address is the same as the importer’s address, the entries in the soldToAddress object must match the entries in the toAddress object.
shipmentType	String	Return Labels Only. Set this to RETURN. Required for Rate Expedited Returns, Create Expedited Returns, and Create Standard Returns. Note: You cannot rate Standard Returns.
references	Array[Object]	PB Standard, CBDS Only. Conditional. The merchant’s reference fields. Each object in the array includes a name-value pair that defines a reference field. This array applies only to the following two carriers: PB Standard: The array is optional. See PB Standard References. CBDS: The array is required for specific delivery solutions. See References Array in a CBDS Shipment. To pass references for carriers other than the above, see Reference Fields.
references.name	String	PB Standard, CBDS Only. The name of the reference field.
references.value	String	PB Standard, CBDS Only. The value for the reference field.
hazmatDetails	Hazmat Details Object	PB Standard Only. If shipping hazardous materials with PB Standard, use this object.
carrierPayments	Array[Shipment: Carrier Payments Object]	FedEx, UPS Only. Indicates that one or more of the shipment costs should be charged to a third-party account.
shipmentId	String	RESPONSE ONLY. Unique identifier for the shipment, generated by the system in response to shipment purchase.
parcelTrackingNumber	String	RESPONSE ONLY. Tracking number assigned to the shipment by the system.

Request / Response Elements: Rates Object

The rates array takes one Rates Object in the request and returns one or more Rates Objects in the response. In the response, each object shows a different rating option.

Important

The following table describes all fields and values in the Rates Object. Some might not apply to this operation.

Name	Data Type	Description
carrier	String	Required. Carrier name. Valid values are: USPS: PB Expedited or PMOD PBCS: PB Standard PBPRESORT: PB Presort PBI: PB Cross-Border Delivery Service (CBDS) FEDEX: FedEx UPS: United Parcel Service
serviceId	String	Conditional. The abbreviated name of the carrier-specific service. For abbreviations, see the Services table on the carrier’s reference page. Required for creating a shipment. Optional for rating a parcel. If you use PB Expedited as the carrier: To determine any additional restrictions on a USPS service, use the Carrier Rules API. See also the USPS Domestic Mail Manual. The APIs require that all USPS parcels be trackable. If the parcel uses a service that is not trackable, such as Priority Mail, you must add at least one trackable special service, such as Delivery Confirmation (DelCon). DelCon is a no-charge special service that triggers tracking but does not increase the cost of the shipment. Before adding a special service, check its compatibility with the service.
parcelType	String	Conditional. The parcel type. For supported parcel types, see the carrier’s reference page. Required for: Creating a shipment Rating a FedEx or UPS parcel Not applicable to the CBDS Checkout Quotes API.
specialServices	Array[Special Services Object]	Conditional. The special services to be applied. For available special services and requirements, see the Special Services table on the carrier’s reference page. Important In a Create Shipment request, including a special service in this array means you intend to apply the special service. This array is not applicable to the CBDS Checkout Quotes API.
inductionPostalCode	String	The postal code where the shipment is tendered to the carrier. If this field is present, the postal code specified here is used instead of the postal code in the fromAddress when calculating rates and when determining if a shipment can be added to a manifest. If this field is absent, the postal code listed in the fromAddress is used instead. This field applies to PB Expedited, PB Presort, PMOD, FedEx, and UPS.
currencyCode	String	Type of currency referenced in the piece price. For example: USD, CAD, EUR This field applies to PB Expedited, CBDS, PMOD, FedEx, and UPS.
dimensionalWeight	Object	RESPONSE ONLY, PB Expedited Only. If dimensional (DIM) weight pricing applies, this object lists the DIM weight. If DIM weight does not apply, this object lists 0.0 as the weight. DIM weight applies to large light packages, as explained in this FAQ. This field applies only to PB Expedited and only to the Create Shipment API. This field does not apply to the Rate Shipment API.
dimensionalWeight. weight	Double	The calculated DIM weight. To calculate DIM weight, see this FAQ.
dimensionalWeight. unitOfMeasurement	String	The unit of measure for the calculated DIM weight. Possible values: GM: Grams OZ: Ounces
baseCharge	Double	RESPONSE ONLY. The base service charge payable to the carrier, excluding special service charges. If your request includes a shipper rate plan, see this FAQ on how the shipper rate affects this field. Note: This field does not apply to PB Standard.
totalCarrierCharge	Double	RESPONSE ONLY. The total amount payable to the carrier, including special service fees, surcharges, and any international taxes and duties, except as noted below. If your request includes a shipper rate plan, see this FAQ on how the shipper rate affects this field. CBDS: In certain cases, the totalCarrierCharge might not reflect additional surcharges. UPS: In Sandbox, the data UPS supplies for totalCarrierCharge might be incorrect. Specifically it might be 1% too low or exclude special service fees, or both. In Production, UPS provides the correct data. Note: This field does not apply to PB Standard.
surcharges	Array[Object]	RESPONSE ONLY. Additional fees or surcharges for the shipment. Each object in the array defines a surcharge and fee. This field applies to PB Expedited, FedEx, and UPS.
surcharges.name	String	The type of surcharge. For possible surcharges, see the carrier’s reference page.
surcharges.fee	Double	The amount of the surcharge.
alternateBaseCharge	Double	RESPONSE ONLY. If your request includes a shipper rate plan and if the shipper does not have an NSA, this is the base service charge payable by the shipper, excluding special service charges. The rate is based on the plan specified in the X-PB-Shipper-Rate-Plan parameter. This field can be returned only if carrier has a value of USPS. If the shipper has an NSA, do not use this field. Use the response’s baseCharge field instead. For more information, see this FAQ.
alternateTotalCharge	Double	RESPONSE ONLY. If your request includes a shipper rate plan and if the shipper does not have an NSA, this is the total charge payable by the shipper, including special service charges. The rate is based on the plan specified in the X-PB-Shipper-Rate-Plan parameter. This field can be returned only if carrier has a value of USPS. If the shipper has an NSA, do not use this field. Use the response’s totalCarrierCharge field instead. For more information, see this FAQ.
deliveryCommitment	Object	RESPONSE ONLY. Time in transit for the shipment. For PB Expedited, see also Pitney Bowes Delivery Guarantee. Note: This field does not apply to PB Standard.
deliveryCommitment. minEstimatedNumberOfDays	String	The minimum number of delivery days.
deliveryCommitment. maxEstimatedNumberOfDays	String	The maximum number of delivery days.
deliveryCommitment. estimatedDeliveryDateTime	String	The estimated delivery date and time in the local time of the destination.
deliveryCommitment. guarantee	String	States whether carrier delivery is guaranteed. Possible values: FULL NONE
deliveryCommitment. additionalDetails	String	These are carrier specific details that may be provided.
destinationZone	String	RESPONSE ONLY. The destination zone used to determine the rate. The zone is based on the origin address or CBDS Consolidation Center, and on the destination address. This field applies to PB Expedited, CBDS, and PMOD. Note: For CBDS shipments, destinationZone is returned as a Number.
rateTypeId	String	RESPONSE ONLY. The type of rate, such as COMMERCIAL_BASE (USPS) or COMMERCIAL (FedEx, UPS).
linePrice	BigDecimal	RESPONSE ONLY. The unit price multiplied by quantity. This field applies to CBDS.
totalTaxAmount	BigDecimal	RESPONSE ONLY. The total tax amount payable to the carrier. This field applies to CBDS, FedEx, and UPS.
totalDutyAmount	BigDecimal	RESPONSE ONLY. The total duty amount payable to the carrier. This field applies to CBDS.

Sample Requests

See the following examples:

• PB Expedited (USPS)

• PB Standard Delivery

• CBDS

• FedEx

• UPS

PB Expedited Sample Request

PB Expedited Sample Rate Request

curl -X POST ../v1/rates?includeDeliveryCommitment=true \
-H "Authorization: Bearer <oauth_token>" \
-H "Content-Type: application/json" \
-H "X-PB-UnifiedErrorStructure: true" \
-d '
{
    "fromAddress": {
        "postalCode": "06484",
        "countryCode": "US"
    },
    "toAddress": {
        "postalCode": "28607",
        "countryCode": "US"
    },
    "parcel": {
        "weight": {
            "unitOfMeasurement": "OZ",
            "weight": 1
        },
        "dimension": {
            "unitOfMeasurement": "IN",
            "length": 6,
            "width": 2,
            "height": 4
        }
    },
    "rates": [ {
        "carrier": "USPS",
        "parcelType": "PKG",
        "specialServices": [ {
            "specialServiceId": "Ins",
            "inputParameters": [ {
                "name": "INPUT_VALUE",
                "value": "50"
            } ]
        } ]
    } ],
    "shipmentOptions": [ {
        "name": "SHIPPER_ID",
        "value": "9024324564"
    } ]
}'

PB Expedited Sample Rate Response

{
    "fromAddress": {
        "addressLines": [],
        "postalCode": "06484",
        "countryCode": "US"
    },
    "toAddress": {
        "addressLines": [],
        "postalCode": "28607",
        "countryCode": "US"
    },
    "parcel": {
        "weight": {
            "unitOfMeasurement": "OZ",
            "weight": 1.0
        },
        "dimension": {
            "length": 6.0,
            "width": 2.0,
            "height": 4.0,
            "unitOfMeasurement": "IN"
        }
    },
    "rates": [ {
        "carrier": "usps",
        "parcelType": "PKG",
        "specialServices": [ {
            "fee": 2.45,
            "inputParameters": [ {
                "name": "INPUT_VALUE",
                "value": "50"
            } ],
            "specialServiceId": "Ins"
        } ],
        "deliveryCommitment": {
            "additionalDetails": "By end of Day",
            "estimatedDeliveryDateTime": "2021-11-22",
            "guarantee": "NONE",
            "maxEstimatedNumberOfDays": "3",
            "minEstimatedNumberOfDays": "3"
        },
        "serviceId": "FCM",
        "baseCharge": 3.36,
        "destinationZone": "4",
        "rateTypeId": "COMMERCIAL_BASE",
        "totalCarrierCharge": 5.81
    }, ... ]
}

PB Standard Delivery Sample Request

PB Standard Delivery Sample Rate Request

curl -X POST ../v1/rates \
-H "Authorization: Bearer <oauth_token>" \
-H "Content-Type: application/json" \
-H "X-PB-UnifiedErrorStructure: true" \
-d '
{
    "fromAddress": {
        "addressLines": [ "27 Waterview Drive" ],
        "postalCode": "06484",
        "countryCode": "US"
    },
    "toAddress": {
        "name": "Jane Wilson",
        "addressLines": [ "643 Greenway RD" ],
        "cityTown": "Boone",
        "stateProvince": "NC",
        "postalCode": "28607",
        "countryCode": "US"
    },
    "parcel": {
        "weight": {
            "unitOfMeasurement": "OZ",
            "weight": 90
        },
        "dimension": {
            "unitOfMeasurement": "IN",
            "length": 8,
            "width": 4,
            "height": 6
        }
    },
    "rates": [ {
        "carrier": "PBCS",
        "serviceId": "PRCLSEL",
        "parcelType": "PKG",
        "specialServices": [ {
            "specialServiceId": "DelCon"
        } ]
    } ],
    "shipmentOptions": [ {
        "name": "SHIPPER_ID",
        "value": "9024324564"
    },{
        "name": "CLIENT_ID",
        "value": "2689"
    },{
        "name": "CLIENT_FACILITY_ID",
        "value": "0093"
    },{
        "name": "CARRIER_FACILITY_ID",
        "value": "2594"
    } ]
}'

PB Standard Delivery Sample Rate Response

{
    "fromAddress": {
        "addressLines": [ "27 Waterview Drive" ],
        "postalCode": "06484",
        "countryCode": "US"
    },
    "toAddress": {
        "name": "Jane Wilson",
        "addressLines": [ "643 Greenway RD" ],
        "cityTown": "Boone",
        "stateProvince": "NC",
        "postalCode": "28607",
        "countryCode": "US"
    },
    "parcel": {
        "weight": {
            "unitOfMeasurement": "OZ",
            "weight": 90.0
        },
        "dimension": {
            "length": 8.0,
            "width": 4.0,
            "height": 6.0,
            "unitOfMeasurement": "IN"
        }
    },
    "rates": [ {
        "carrier": "PBCS",
        "parcelType": "PKG",
        "specialServices": [ {
            "specialServiceId": "DelCon"
        } ],
        "deliveryCommitment": {},
        "serviceId": "PRCLSEL",
        "baseCharge": 5.62,
        "surcharges": [ {
            "fee": 0.28,
            "name": "FUEL"
        } ],
        "totalCarrierCharge": 5.9
    } ],
    "shipmentOptions": [ {
        "name": "SHIPPER_ID",
        "value": "9024324564"
    },{
        "name": "CLIENT_ID",
        "value": "2689"
    },{
        "name": "CLIENT_FACILITY_ID",
        "value": "0093"
    },{
        "name": "CARRIER_FACILITY_ID",
        "value": "2594"
    } ]
}

CBDS Sample Request

CBDS Sample Rate Request

curl -X POST ../v1/rates?includeDeliveryCommitment=true&carrier=PBI \
-H "Authorization: Bearer <oauth_token>" \
-H "Content-Type: application/json" \
-H "X-PB-UnifiedErrorStructure: true" \
-d '
{
    "fromAddress": { ... },
    "toAddress": { ... },

    "parcel": {
        "dimension": {
            "unitOfMeasurement": "IN",
            "length": "12",
            "width": "5",
            "height": "10"
        },
        "weight": {
            "unitOfMeasurement": "OZ",
            "weight": 80
        }
    },
    "rates": [ {
        "carrier": "PBI",
        "serviceId": "PBXPS",
        "parcelType": "PKG"
    } ],
    "shipmentOptions": [ {
        "name": "SHIPPER_ID",
        "value": "9024324564"
    } ],
    "customs": {
        "customsInfo": {
            "currencyCode": "USD"
        },
        "customsItems": [ {
            "description": "dress",
            "itemId": "B004LB5FB9",
            "quantity": 2,
            "unitPrice": 25,
            "url": "www.example.com/dress/a"
        },{
            "description": "dress",
            "itemId": "B004LB5FB4",
            "quantity": 2,
            "unitPrice": 35,
            "url": "www.example.com/dress/b"
        } ]
    }
}'

CBDS Sample Rate Response

{
    "fromAddress": { ... },
    "toAddress": { ... },
    "parcel": {
        "dimension": {
            "length": 12,
            "height": 10,
            "width": 5,
            "unitOfMeasurement": "IN"
        },
        "weight": {
            "weight": 80,
            "unitOfMeasurement": "OZ"
        },
        "valueOfGoods": 120.00
    },
    "rates": [ {
        "carrier": "PBI",
        "serviceId": "PBXPS",
        "parcelType": "PKG",
        "baseCharge": 52.25,
        "totalCarrierCharge": 69.05,
        "deliveryCommitment": {
            "minEstimatedNumberOfDays": "6",
            "maxEstimatedNumberOfDays": "9"
        },
        "currencyCode": "USD",
        "totalTaxAmount": 16.80
    } ],
    "shipmentOptions": [ {
        "name": "SHIPPER_ID",
        "value": "9024324564"
    } ],
    "customs": {
        "customsInfo": {
            "currencyCode": "USD"
        },
        "customsItems": [ {
            "itemId": "B004LB5FB9",
            "description": "dress",
            "quantity": 2,
            "unitPrice": 25.00,
            "url": "www.example.com/dress/a"
        }, {
            "itemId": "B004LB5FB4",
            "description": "dress",
            "quantity": 2,
            "unitPrice": 35.00,
            "url": "www.example.com/dress/b"
        } ]
    }
}

FedEx Sample Request

The following request omits the serviceId field in order to rate the parcel for multiple services.

FedEx Sample Rate Request

curl -X POST ../v1/rates?includeDeliveryCommitment=true \
-H "Authorization: Bearer <oauth_token>" \
-H "Content-Type: application/json" \
-H "Accept-Language: en-US"
-H "X-PB-Shipper-Carrier-AccountId: <unique_carrier_account_id>" \
-H "X-PB-UnifiedErrorStructure: true" \
-d '
{
    "fromAddress": { ... },
    "toAddress": { ... },
    "parcel": {
        "weight": {
            "unitOfMeasurement": "OZ",
            "weight": 8.0
        }
    },
    "rates": [ {
        "carrier": "FEDEX",
        "parcelType": "PKG"
    } ],
    "shipmentOptions": [ {
        "name": "SHIPPER_ID",
        "value": "9024324564"
    } ]
}'

FedEx Sample Rate Response

{
    "fromAddress": { ... },
    "toAddress": { ... },
    "parcel": {
        "weight": {
            "unitOfMeasurement": "OZ",
            "weight": 8.0
        }
    },
    "rates": [ {
        "carrier": "fedex",
        "parcelType": "PKG",
        "specialServices": [],
        "deliveryCommitment": {
            "additionalDetails": "By 12:00 of THU",
            "estimatedDeliveryDateTime": "2020-12-19 12:00:00",
            "guarantee": "FULL"
        },
        "serviceId": "2DA_AM",
        "baseCharge": 34.48,
        "currencyCode": "USD",
        "rateTypeId": "COMMERCIAL",
        "surcharges": [ {
            "fee": 2.85,
            "name": "DELIVERY_AREA"
        },{
            "fee": 2.8,
            "name": "FUEL"
        } ],
        "totalCarrierCharge": 40.13,
        "totalTaxAmount": 0.0
    }, ... ],
    "shipmentOptions": [ {
        "name": "SHIPPER_ID",
        "value": "9024324564"
    } ]
}

UPS Sample Request

The following request omits the serviceId field in order to rate the parcel for multiple services.

UPS Sample Rate Request

curl -X POST ../v1/rates?includeDeliveryCommitment=true \
-H "Authorization: Bearer <oauth_token>" \
-H "Content-Type: application/json" \
-H "Accept-Language: en-US"
-H "X-PB-Shipper-Carrier-AccountId: <unique_carrier_account_id>" \
-H "X-PB-UnifiedErrorStructure: true" \
-d '
{
    "fromAddress": {
        "postalCode": "94105",
        "countryCode": "US"
    },
    "toAddress": {
        "postalCode": "28607",
        "countryCode": "US"
    },
    "parcel": {
        "weight": {
            "unitOfMeasurement": "OZ",
            "weight": 38
        },
        "dimension": {
            "unitOfMeasurement": "IN",
            "length": 6,
            "width": 4,
            "height": 4
        }
    },
    "rates": [ {
        "carrier": "UPS",
        "parcelType": "PKG"
    } ],
    "shipmentOptions": [ {
        "name": "SHIPPER_ID",
        "value": "9024324564"
    } ]
}'

UPS Sample Rate Response

{
    "fromAddress": {
        "addressLines": [],
        "postalCode": "94105",
        "countryCode": "US"
    },
    "toAddress": {
        "addressLines": [],
        "postalCode": "28607",
        "countryCode": "US"
    },
    "parcel": {
        "weight": {
            "unitOfMeasurement": "OZ",
            "weight": 38.0
        },
        "dimension": {
            "length": 6.0,
            "width": 4.0,
            "height": 4.0,
            "unitOfMeasurement": "IN"
        }
    },
    "rates": [ {
        "carrier": "ups",
        "parcelType": "PKG",
        "specialServices": [],
        "deliveryCommitment": {
            "estimatedDeliveryDateTime": "2021-11-29 23:00:00",
            "guarantee": "FULL",
            "maxEstimatedNumberOfDays": "5",
            "minEstimatedNumberOfDays": "5"
        },
        "serviceId": "GRD",
        "baseCharge": 14.03,
        "currencyCode": "USD",
        "rateTypeId": "COMMERCIAL",
        "surcharges": [ {
            "fee": 3.1,
            "name": "DELIVERY_AREA"
        },{
            "fee": 1.88,
            "name": "FUEL"
        } ],
        "totalCarrierCharge": 19.01
    }, ... ],
    "shipmentOptions": [ {
        "name": "SHIPPER_ID",
        "value": "9024324564"
    } ]
}

Error Codes

For error codes specific to the CBDS, please see 13-Prefix Error Codes.

For a list of all error codes returned by the Ecommerce APIs, please see Error Codes.

 
 
 
 

• next
• previous |

© Copyright 2022, PB.