latestOpenAPI 3.0.02026-08-10234193.3 KB

60e380005037

Shipments

Calculate delivery cost

This API method allows you to calculate the estimated delivery cost and delivery time for your cargo. The delivery cost and delivery time are calculated based on factors such as weight, dimensions, destination, and shipping method. By providing the necessary details of your cargo and shipment, you can obtain an estimated cost for delivering the goods. The response will typically include the calculated cost and the scheduled delivery date based on the provided information.</br>

post/shipments/calculations

Request body

payerType'Sender' | 'Recipient' | 'ThirdPerson'

Identifies who is responsible for the payment of delivery services. The payer type determines which party bears the cost:

  • Sender: The party sending the goods pays for the delivery.
  • Recipient: The party receiving the goods is responsible for the delivery cost.
  • ThirdPerson: A third party pays for delivery.
  • For shipments within Europe or from Europe to Ukraine, the field payerContractNumber must be provided.
  • For shipments from Ukraine, payerContractNumber is not required.
payerContractNumberstring

Required when payerType is ThirdPerson for shipments within Europe or from Europe to Ukraine. Specifies the contract number of the third-party payer (e.g., CNPP-00001797).

deliveryTypesstring[]

Defines the list of tariff types to be used for shipment cost calculation. The calculation response returns pricing results for each submitted delivery type.

  • standard: Standard international delivery tariff.
  • economy: Economy international delivery tariff.
  • express: Express international delivery tariff.

If the field is not provided, the applicable tariff is determined automatically according to current business rules, and the existing calculation behavior remains unchanged.

🔹This field is optional.

Response

Successful cost calculation

scheduledDeliveryDatestring date-time nullable

Estimated delivery date based on routing and service level, subject to change based on logistics and external factors. Date in ISO 8601 format.