Розрахунок вартості доставки

Розрахунок вартості доставки

post

/shipments/calculations

Цей API-метод дозволяє розрахувати орієнтовну вартість доставки та термін доставки для вашого вантажу. Вартість та термін доставки розраховуються на основі таких факторів, як вага, габарити, місце призначення та спосіб доставки. Надавши необхідні дані про вантаж і відправлення, ви можете отримати орієнтовну вартість доставки товарів. Відповідь зазвичай містить розраховану вартість та заплановану дату доставки на основі наданої інформації.

Authorizations

AuthorizationstringRequired

JWT-токен авторизації зі строком дії 1 годину у заголовку

Body

payerTypestring · enumOptional

Визначає, хто відповідає за оплату послуг доставки. Тип платника визначає, яка сторона несе витрати:

• Sender: Сторона, що відправляє товар, оплачує доставку.
• Recipient: Сторона, що отримує товар, відповідає за оплату доставки.
• ThirdPerson: Третя сторона оплачує доставку.
• Для відправлень у межах Європи або з Європи в Україну необхідно передати поле payerContractNumber.
• Для відправлень з України payerContractNumber не є обов’язковим."

Example: SenderPossible values:

payerContractNumberstringOptional

Обов’язковий, якщо payerType = ThirdPerson для відправлень у межах Європи або з Європи в Україну. Вказує номер договору платника-третьої сторони (наприклад, CNPP-00001797).

Example: CNPP-00001797

deliveryTypesarray · enumOptional

Визначає список тарифних типів, які використовуються для розрахунку вартості доставки. У відповіді розрахунку повертаються результати вартості для кожного переданого типу доставки.

• standard: Стандартний тариф міжнародної доставки.
• economy: Економ-тариф міжнародної доставки.
• express: Експрес-тариф міжнародної доставки.

🔹Для відправлень з України до США тариф economy не підтримується.

Якщо поле не передано, відповідний тариф визначається автоматично згідно з поточними бізнес-правилами, а поведінка розрахунку залишається без змін.

🔹Це поле є необов’язковим.

Possible values:

Responses

200

Successful cost calculation

application/json

scheduledDeliveryDatestring · date-time · nullableOptional

Орієнтовна дата доставки, розрахована на основі маршрутизації та рівня сервісу. Може змінюватися залежно від логістичних та зовнішніх факторів. Дата у форматі ISO 8601.

Example: 2023-04-14T09:00:00Z

401

Неавторизований доступ

application/json

404

Вказаний ресурс не знайдено

application/json

422

Помилка валідації

application/json

503

Час очікування з’єднання вичерпано

application/json

post/shipments/calculations

POST /v.1.0/shipments/calculations HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 522

{
  "payerType": "ThirdPerson",
  "payerContractNumber": "CNPP-00001797",
  "parcels": [
    {
      "cargoCategory": "parcel",
      "insuranceCost": 1.5,
      "rowNumber": 1,
      "width": 500,
      "length": 500,
      "height": 500,
      "actualWeight": 1000,
      "volumetricWeight": 1000
    }
  ],
  "sender": {
    "companyTin": "",
    "companyName": "",
    "countryCode": "PL",
    "divisionId": null,
    "addressParts": {
      "city": "Warsaw",
      "region": "Warszawa County",
      "street": "15 Sierpnia",
      "postCode": "000100",
      "building": "1",
      "flat": "",
      "block": "",
      "note": ""
    }
  },
  "recipient": {
    "countryCode": "CZ",
    "divisionId": 1834946,
    "addressParts": {}
  }
}

{
  "scheduledDeliveryDate": null,
  "sender": {
    "countryCode": "UA",
    "settlementId": 115801,
    "divisionId": 4438
  },
  "recipient": {
    "countryCode": "US",
    "settlementId": null,
    "divisionId": null
  },
  "services": [
    {
      "shipmentId": null,
      "shipmentParcelRowNumber": null,
      "serviceId": null,
      "serviceType": null,
      "serviceName": null,
      "serviceCode": null,
      "amount": 1,
      "contractNumber": null,
      "payerType": "Sender",
      "paymentStatus": "NeedPay",
      "divisionId": null,
      "price": 11259,
      "discount": 0,
      "cost": 11220,
      "user": "",
      "shipmentLockVersion": null,
      "additionalParameters": null,
      "currencyCode": "UAH",
      "createdAt": "2026-08-25T13:07:32.551228Z",
      "updatedAt": "0001-01-01T00:00:00.000000Z",
      "deliveryType": "fe0a07b5-a212-11eb-94e4-b8830365bd14",
      "deliveryTypeName": "standard",
      "recipientPayerFeesCustomsCost": 710,
      "senderPayerFeesCustomsCost": 39
    },
    {
      "shipmentId": null,
      "shipmentParcelRowNumber": null,
      "serviceId": null,
      "serviceType": null,
      "serviceName": null,
      "serviceCode": null,
      "amount": 1,
      "contractNumber": null,
      "payerType": "Sender",
      "paymentStatus": "NeedPay",
      "divisionId": null,
      "price": 11259,
      "discount": 0,
      "cost": 11220,
      "user": "",
      "shipmentLockVersion": null,
      "additionalParameters": null,
      "currencyCode": "UAH",
      "createdAt": "2026-08-25T13:07:32.551252Z",
      "updatedAt": "0001-01-01T00:00:00.000000Z",
      "deliveryType": "aebf0991-ec73-11f0-9dff-8c8474c74d21",
      "deliveryTypeName": "express",
      "recipientPayerFeesCustomsCost": 710,
      "senderPayerFeesCustomsCost": 39
    }
  ],
  "messageForFeesCustomsCost": ""
}