> For the complete documentation index, see [llms.txt](https://api-portal.novapost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-portal.novapost.com/metodi-1/metodi/readme/vidpravlennya/rozrakhunok-vartosti-dostavki.md). # Розрахунок вартості доставки ## Розрахунок вартості доставки > Цей API-метод дозволяє розрахувати орієнтовну вартість доставки та термін доставки для вашого вантажу.\ > Вартість та термін доставки розраховуються на основі таких факторів, як вага, габарити, місце призначення та спосіб доставки.\ > Надавши необхідні дані про вантаж і відправлення, ви можете отримати орієнтовну вартість доставки товарів.\ > Відповідь зазвичай містить розраховану вартість та заплановану дату доставки на основі наданої інформації.\
\ > \ > 🔹\*\*Description of control elements:\*\*\ > \ > \*\*SCHEMA\*\*\
\ > Відображає повну технічну структуру запиту або відповіді, включаючи назви полів, типи даних, обов’язкові поля, допустимі значення та правила валідації.\ > \- \*\*Single line description\*\*\
\ > Опис, який вміщується в один рядок; текст, що не вміщується, залишається прихованим.\ > \- \*\*Multiline description\*\*\
\ > Розширений опис, який відображає більше одного рядка тексту.\ > \ > \*\*EXAMPLE\*\*\
\ > Показує готовий приклад JSON з коректно заповненими значеннями, щоб продемонструвати, як має виглядати валідний запит або відповідь.
```json {"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[{"name":"Shipments"}],"servers":[{"description":"sandbox","url":"https://api-stage.novapost.com/v.1.0/"},{"description":"production","url":"https://api.novapost.com/v.1.0/"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"Authorization","description":"JWT-токен авторизації зі строком дії 1 годину у заголовку"}},"responses":{"Unauthorized":{"description":"Неавторизований доступ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Вказаний ресурс не знайдено","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Validation":{"description":"Помилка валідації","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Time-out":{"description":"Час очікування з’єднання вичерпано","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"errors":{"type":"object","properties":{"":{"type":"string"}}}}}}},"paths":{"/shipments/calculations":{"post":{"tags":["Shipments"],"description":"Цей API-метод дозволяє розрахувати орієнтовну вартість доставки та термін доставки для вашого вантажу.\nВартість та термін доставки розраховуються на основі таких факторів, як вага, габарити, місце призначення та спосіб доставки.\nНадавши необхідні дані про вантаж і відправлення, ви можете отримати орієнтовну вартість доставки товарів.\nВідповідь зазвичай містить розраховану вартість та заплановану дату доставки на основі наданої інформації.
\n\n🔹**Description of control elements:**\n\n**SCHEMA**
\nВідображає повну технічну структуру запиту або відповіді, включаючи назви полів, типи даних, обов’язкові поля, допустимі значення та правила валідації.\n- **Single line description**
\n Опис, який вміщується в один рядок; текст, що не вміщується, залишається прихованим.\n- **Multiline description**
\n Розширений опис, який відображає більше одного рядка тексту.\n\n**EXAMPLE**
\nПоказує готовий приклад JSON з коректно заповненими значеннями, щоб продемонструвати, як має виглядати валідний запит або відповідь.\n","requestBody":{"description":"Optional description in *Markdown*","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"payerType":{"type":"string","description":"Визначає, хто відповідає за оплату послуг доставки. Тип платника визначає, яка сторона несе витрати:\n- `Sender`: Сторона, що відправляє товар, оплачує доставку.\n- `Recipient`: Сторона, що отримує товар, відповідає за оплату доставки.\n- `ThirdPerson`: Третя сторона оплачує доставку.\n- Для відправлень у межах Європи або з Європи в Україну необхідно передати поле `payerContractNumber`.\n- Для відправлень з України `payerContractNumber` не є обов’язковим.\"\n","enum":["Sender","Recipient","ThirdPerson"]},"payerContractNumber":{"type":"string","description":"Обов’язковий, якщо `payerType` = `ThirdPerson` для відправлень у межах Європи або з Європи в Україну.\nВказує номер договору платника-третьої сторони (наприклад, `CNPP-00001797`).\n"},"deliveryTypes":{"type":"array","items":{"type":"string"},"description":"Визначає список тарифних типів, які використовуються для розрахунку вартості доставки.\nУ відповіді розрахунку повертаються результати вартості для кожного переданого типу доставки.\n\n- `standard`: Стандартний тариф міжнародної доставки.\n- `economy`: Економ-тариф міжнародної доставки.\n- `express`: Експрес-тариф міжнародної доставки.\n\nЯкщо поле не передано, відповідний тариф визначається автоматично згідно з поточними бізнес-правилами, а поведінка розрахунку залишається без змін.\n\n**🔹Це поле є необов’язковим.**\n","enum":["standard","economy","express"]},"invoice":{"type":"object","description":"Інформація для розрахунку вартості доставки та митних платежів.","properties":{"incoterm":{"type":"string","description":"Тип розрахунку податків.\n- `DAP` – Поставка в місце призначення\n- `DDP` – Поставка зі сплатою мита\n","enum":["DAP","DDP"]},"currency":{"type":"string","description":"Код валюти у форматі ISO 4217 (наприклад, USD, EUR, GBP)."},"cost":{"type":"number","description":"Загальна задекларована вартість інвойсу у вихідній валюті, яка повинна дорівнювати сумі всіх позицій інвойсу, розрахованих як **(amount × cost)** для кожної позиції.\nЗадекларована вартість відправлення, що використовується для розрахунку митних платежів.\nТакож визначає максимальну суму компенсації у випадку втрати або пошкодження.\nОбов’язковий параметр, якщо incoterm = `DDP`.\n","minimum":1},"payerFeesCustoms":{"type":"string","description":"Визначає, хто відповідає за оплату митних платежів.\nВизначає сторону, яка несе витрати: `Sender`, `Recipient` або `ThirdPerson`.\n","enum":["Sender","Recipient","ThirdPerson"]}}},"parcels":{"type":"array","description":"Масив об’єктів посилок, де кожен об’єкт представляє окрему посилку у відправленні.\nЦей параметр є важливим для розрахунку вартості доставки, оскільки містить інформацію про габарити, вагу та інші характеристики кожної посилки.\nКожен об’єкт у цьому масиві містить необхідну інформацію для точного розрахунку вартості доставки з урахуванням розміру, ваги посилки та, за потреби, типу товару, що може впливати на спосіб доставки та тарифікацію.\n","items":{"type":"object","properties":{"cargoCategory":{"type":"string","description":"Визначає тип відправлення, що допомагає класифікувати товари для логістики та митного оформлення. Категорія впливає на обробку відправлення, його вартість та необхідну документацію. Доступні категорії:\n- parcel: Посилки малого та середнього розміру, зазвичай для споживчих товарів.\n- documents: Поштові відправлення, що містять документи, такі як листи, договори та офіційні документи. Ця категорія призначена для відправлень вагою не більше 1 кг та з габаритами, що не перевищують 35 см у довжину, 25 см у ширину та 2 см у висоту.\n- pallet: Тип вантажу, сформований як палетне відправлення з фіксованими габаритами та обмеженнями по вазі, доступний у Бізнес-кабінеті Європи для юридичних осіб:\n - До 250 кг, площа ~0.48 м², габарити 80 × 60 × 170 см\n - До 500 кг, площа ~0.96 м², габарити 120 × 80 × 170 см\n - До 750 кг, площа ~1.2 м², габарити 120 × 100 × 170 см\n - До 1000 кг, площа\n","enum":["parcel","documents","pallet"]},"insuranceCost":{"type":"number","format":"float","description":"Задекларована вартість відправлення для страхового покриття у валюті країни відправника. Визначає максимальну суму компенсації у разі втрати або пошкодження. Це значення визначає максимальну суму компенсації у разі пошкодження або втрати під час транспортування. Коректне встановлення цього значення є критично важливим для забезпечення належного страхового покриття. Важливо точно задекларувати цю вартість відповідно до фактичної вартості вмісту відправлення, оскільки її заниження може призвести до недостатньої компенсації.","minimum":0,"exclusiveMinimum":true},"rowNumber":{"type":"integer","description":"Послідовний ідентифікатор кожної посилки у відправленні, що використовується для впорядкування та відстеження окремих місць, особливо у випадку, коли відправлення містить кілька позицій. Якщо відправлення складається з однієї посилки, значення має бути 1.","minimum":1},"width":{"type":"integer","description":"Ширина посилки в міліметрах, що використовується разом із довжиною та висотою для розрахунку загального об’єму з метою логістичного планування.","minimum":1},"length":{"type":"integer","description":"Довжина посилки в міліметрах, що використовується разом із висотою та шириною для розрахунку загального об’єму з метою логістичного планування.","minimum":1},"height":{"type":"integer","description":"Висота посилки в міліметрах, що використовується разом із довжиною та шириною для розрахунку загального об’єму з метою логістичного планування.","minimum":1},"actualWeight":{"type":"integer","description":"Фактична загальна вага всіх одиниць товару в грамах (g), що є критичною для розрахунку вартості доставки та відповідності обмеженням перевізника щодо ваги.\nОчікувана одиниця виміру: грами (g)\nПідтримується точність лише до 10 грамів (0.01 кг). Значення, не кратні 10 г, округлюються вниз до найближчого меншого кратного 10 г.\n\n⚠️ВАЖЛИВО: Рекомендується округлювати значення ваги до найближчих 10 г перед відправкою, щоб уникнути неочікуваних коригувань.\n","minimum":1,"maximum":2147483647},"volumetricWeight":{"type":"integer","description":"Розрахункова вага, визначена на основі габаритів посилки, що використовується для тарифікації у випадках, коли об’єм впливає на вартість більше, ніж фактична вага. Відображає об’ємну (габаритну) вагу посилки.","minimum":0,"maximum":2147483647}}}},"sender":{"type":"object","description":"Містить основну інформацію про сторону, що відправляє вантаж. Надана тут інформація використовується для керування даними про місце відправлення з метою логістичного планування та впливає на розрахунок вартості доставки залежно від місцезнаходження відправника та застосовних правил перевезення. \nЯкщо платником є Відправник і відправлення здійснюється від юридичної особи, параметри \"companyTin\" та \"companyName\" використовуються для застосування індивідуальної знижки контрагента. Якщо знижка не застосовується або її не потрібно враховувати, ці параметри можуть бути порожніми або виключені із запиту.\n","properties":{"companyTin":{"type":"string","description":"Податковий ідентифікаційний номер або еквівалентний ідентифікатор (ЄДРПОУ, TIN, NIP, IČO) юридичної особи.\n\n🔹**Обов’язковий для юридичних та митних документів, якщо відправник є юридичною особою.**\n","maxLength":20,"nullable":true},"companyName":{"type":"string","description":"Офіційна назва компанії відправника. Використовується, якщо відправник є юридичною особою, для ідентифікації організації у документах та облікових записах. Вкажіть \"Private person\", якщо відправник не є компанією.","maxLength":100,"nullable":true},"countryCode":{"type":"string","description":"Дволітерний код країни відправника відповідно до стандарту ISO 3166-1 Alpha-2, що визначає країну походження відправлення.","pattern":"^[A-Z]{2}$"},"divisionNumber":{"type":"string","description":"Необов’язковий ідентифікатор, що визначає унікальний номер відділення або поштомата, з якого здійснюється відправлення. Використовується, якщо відправлення здійснюється з конкретного відділення. Поле взаємозамінне з 'divisionId', достатньо передати одне з них. Залишайте null, якщо відправлення здійснюється з адреси без прив’язки до відділення.","nullable":true},"divisionId":{"type":"integer","description":"Необов’язковий ідентифікатор, що представляє унікальний код відділення, з якого здійснюється відправлення. Використовується, коли потрібна обробка через конкретне відділення. Може використовуватись як альтернатива 'divisionNumber', достатньо одного з цих параметрів. Повинен бути null, якщо відправлення здійснюється з адреси без прив’язки до відділення.","nullable":true},"addressParts":{"type":"object","description":"Цей набір полів є обов’язковим при відправленні безпосередньо з адреси та описує місце, з якого відправляється посилка. Він містить детальну адресу, що забезпечує точну ідентифікацію місця забору.","properties":{"city":{"type":"string","description":"Назва міста, з якого здійснюється відправлення. Допомагає точно визначити місце забору або відправлення.","maxLength":100},"region":{"type":"string","description":"Визначає ширшу адміністративну одиницю (наприклад, штат або провінцію), що охоплює місто, надаючи додатковий контекст щодо місця відправлення.","maxLength":100},"street":{"type":"string","description":"Назва вулиці відправника, необхідна для точного визначення місця забору або доставки.","maxLength":100},"postCode":{"type":"string","description":"Поштовий індекс (ZIP-код), що відповідає адресі відправника. Необхідний для ефективного сортування та маршрутизації відправлення.","maxLength":10},"building":{"type":"string","description":"Номер або назва будівлі за вказаною адресою, що дозволяє точно визначити місце забору відправлення.","maxLength":100},"flat":{"type":"string","description":"За наявності - номер квартири або офісу в будівлі, з якої здійснюється відправлення, що дозволяє кур’єру точно знайти потрібне приміщення.","maxLength":10},"block":{"type":"string","description":"Вказує конкретний корпус або секцію в межах великого житлового масиву чи комплексу (за потреби), що допомагає точно визначити місце відправлення вантажу.","maxLength":100,"nullable":true},"note":{"type":"string","description":"Дозволяє вказати додаткову інформацію або інструкції щодо адреси відправника, які можуть полегшити процес забору, такі як коди доступу, конкретні входи або бажаний час для зв’язку.","maxLength":100}}}}},"recipient":{"type":"object","description":"Інформація про отримувача відправлення, що описує фізичну особу або організацію, відповідальну за отримання вантажу.","properties":{"countryCode":{"type":"string","description":"Дволітерний код, що ідентифікує країну отримувача відповідно до стандарту ISO 3166-1 Alpha-2, який визначає країну призначення відправлення.","pattern":"^[A-Z]{2}$"},"divisionNumber":{"type":"string","description":"Необов’язковий ідентифікатор, що використовується для зазначення унікального номера відділення або поштомата, з якого здійснюється отримання відправлення. Актуальний у випадках, коли відправлення спрямоване до конкретного відділення. Це поле є взаємозамінним із 'divisionId', і достатньо передати один із цих ідентифікаторів. Це поле слід залишати null, якщо відправлення адресоване безпосередньо на адресу без прив’язки до відділення.","nullable":true},"divisionId":{"type":"integer","description":"Необов’язковий ідентифікатор, що представляє унікальний код відділення, до якого має бути доставлене відправлення. Як і recipientDivisionNumber, цей ідентифікатор є важливим у випадках, коли доставка передбачає обробку через конкретне відділення. Може використовуватися як альтернатива до divisionNumber, достатньо передати один із цих ідентифікаторів для визначення відділення отримання. Це поле слід залишати null, якщо відправлення доставляється на адресу без прив’язки до конкретного відділення.","nullable":true},"addressParts":{"type":"object","description":"Цей набір полів є необхідним, коли відправлення спрямоване на конкретну адресу, і визначає точні деталі місця доставки посилки. Він містить повну адресну інформацію, що забезпечує точну ідентифікацію місця доставки.","properties":{"city":{"type":"string","description":"Місто, до якого здійснюється доставка відправлення. Ця інформація забезпечує спрямування посилки до правильного населеного пункту отримувача.","maxLength":100},"region":{"type":"string","description":"Визначає штат або провінцію отримувача в межах країни призначення, що є критично важливим для коректної маршрутизації та доставки відправлення. При відправленні до США обов’язково слід вказувати дволітерний код штату, наприклад \"WA\" для Вашингтона або \"DC\" для округу Колумбія, відповідно до стандарту ISO 3166-2:US.","maxLength":100},"street":{"type":"string","description":"Назва вулиці за адресою отримувача, необхідна для точного визначення місця доставки.","maxLength":100},"postCode":{"type":"string","description":"Поштовий індекс (ZIP-код) адреси отримувача, критично важливий для точного сортування та маршрутизації посилки до кінцевого пункту призначення.","maxLength":10},"building":{"type":"string","description":"Визначає номер або назву будівлі за адресою отримувача, що дозволяє доставити відправлення до конкретної будівлі на відповідній вулиці.","maxLength":100},"flat":{"type":"string","description":"Номер квартири або офісу (за наявності), якщо доставка здійснюється до будівлі з кількома приміщеннями, що забезпечує доставку посилки до конкретного приміщення отримувача.","maxLength":10},"block":{"type":"string","description":"Визначає корпус або секцію в межах великого житлового масиву чи комплексу для отримувача, що є корисним у великих житлових забудовах для точнішого визначення місця доставки.","maxLength":100,"nullable":true},"note":{"type":"string","description":"Поле для додаткових інструкцій або деталей щодо адреси отримувача, які можуть допомогти під час доставки, таких як умови доступу, конкретні двері для доставки або бажаний час доставки.","maxLength":100}}}}}}}}}},"responses":{"200":{"description":"Successful cost calculation","content":{"application/json":{"schema":{"type":"object","properties":{"scheduledDeliveryDate":{"type":"string","format":"date-time","description":"Орієнтовна дата доставки, розрахована на основі маршрутизації та рівня сервісу. Може змінюватися залежно від логістичних та зовнішніх факторів. Дата у форматі ISO 8601.","nullable":true},"sender":{"type":"object","description":"Надає базову географічну інформацію про відправника як частину даних про місце відправлення у відповіді. Об’єкт містить інформацію про країну відправника та може включати додаткові ідентифікатори місця, такі як settlementId та divisionId, якщо вони доступні.","properties":{"countryCode":{"type":"string","description":"Дволітерний код країни відправника відповідно до стандарту ISO 3166-1 Alpha-2, що визначає країну походження відправлення.","pattern":"^[A-Z]{2}$"},"settlementId":{"type":"integer","description":"Ідентифікатор населеного пункту (міста або селища), з якого здійснюється відправлення, якщо було вказано `divisionId`. Якщо було вказано домашню адресу відправника, це поле матиме значення null.","nullable":true},"divisionId":{"type":"integer","description":"Унікальний ідентифікатор відділення відправника, з якого здійснюється відправлення, якщо його було вказано. Якщо було вказано домашню адресу відправника, це поле матиме значення null.","nullable":true}}},"recipient":{"type":"object","description":"Надає базову географічну інформацію про отримувача як частину даних про доставку у відповіді. Об’єкт містить інформацію про країну отримувача та може включати додаткові ідентифікатори місця, такі як settlementId та divisionId, якщо вони доступні.","properties":{"countryCode":{"type":"string","description":"Дволітерний код країни отримувача відповідно до стандарту ISO 3166-1 Alpha-2, що визначає країну призначення відправлення.","pattern":"^[A-Z]{2}$"},"settlementId":{"type":"integer","description":"Ідентифікатор населеного пункту (міста або селища), до якого відправляється відправлення, якщо було вказано `divisionId`. Якщо було вказано домашню адресу отримувача, це поле матиме значення null.","nullable":true},"divisionId":{"type":"integer","description":"Унікальний ідентифікатор відділення або пункту видачі отримувача, якщо його було вказано. Якщо було вказано домашню адресу отримувача, це поле матиме значення null.","nullable":true}}},"services":{"type":"array","description":"Набір сервісів, пов’язаних із відправленням, де кожен елемент описує конкретну послугу, застосовану або запитану для відправлення. Об’єкт містить деталі сервісу, такі як тип послуги, кількість, договірні дані, а також додаткові параметри, що визначають умови або особливості сервісу.","items":{"type":"object","properties":{"shipmentId":{"type":"integer","description":"Унікальний ідентифікатор відправлення, до якого належить ця послуга. Використовується для зв’язування послуги з конкретним відправленням у системі. Це поле може мати значення null або 0, якщо послуга попередньо налаштовується або якщо відправлення ще не створене чи не призначене в системі.","nullable":true},"shipmentParcelRowNumber":{"type":"string","description":"Ідентифікатор місця (посилки) у відправленні, до якого застосовується послуга. Використовується для управління кількома місцями в одному відправленні.","nullable":true},"serviceId":{"type":"string","description":"Унікальний ідентифікатор, призначений конкретній послузі, що описується, необхідний для відстеження та управління послугою."},"serviceType":{"type":"string","description":"Тип послуги.
\n**🔹Це поле є необов’язковим.**\n"},"serviceName":{"type":"string","description":"Назва послуги.
\n**🔹Це поле є необов’язковим.**\n"},"serviceCode":{"type":"string","description":"Код послуги.
\n**🔹Це поле є необов’язковим.**\n"},"amount":{"type":"number","description":"Загальна кількість одиниць або об’єктів, що входять до цієї послуги.","minimum":0},"contractNumber":{"type":"string","description":"Номер договору, в межах якого надається послуга (за наявності). Використовується в B2B або B2C сценаріях.","minLength":2,"maxLength":20,"nullable":true},"payer_type":{"type":"string","description":"Визначає, хто відповідає за оплату послуги. Типові значення: Sender, Recipient або ThirdPerson."},"paymentStatus":{"type":"string","description":"Статус оплати послуг доставки (наприклад, 'Paid', 'NeedPay', 'ContractAfterPayment', 'FreeOfCharge', 'Holded')."},"divisionId":{"type":"string","description":"Унікальний ідентифікатор відділення (за наявності).","nullable":true},"price":{"type":"number","description":"Вартість послуги до застосування будь-яких знижок.","minimum":0},"discount":{"type":"number","description":"Будь-яка знижка, застосована до послуги, що зменшує загальну вартість.","minimum":0},"cost":{"type":"number","format":"float","description":"Загальна вартість послуги після застосування знижок.","minimum":0},"user":{"type":"string","description":"Визначає тип користувача, який взаємодіє з послугою. Використовується для внутрішніх потреб.","maxLength":50},"shipmentLockVersion":{"type":"integer","description":"Версія даних відправлення для контролю конкурентного доступу."},"additional_parameters":{"type":"object","description":"Цей об’єкт містить додаткові параметри, що надають критично важливу інформацію для забезпечення коректної обробки та доставки відправлення.","properties":{"cod":{"type":"number","description":"Сума післяплати (COD), якщо застосовується. Визначає суму, яку необхідно стягнути під час доставки, що є критично важливим для операцій, які передбачають оплату при отриманні.","nullable":true},"date":{"type":"integer","description":"Орієнтовна дата доставки, розрахована на основі логістичних даних та інформації про маршрут. Якщо дату доставки неможливо визначити через недостатність даних для обраного напрямку, це поле може містити значення 0.","nullable":true},"from":{"type":"integer","description":"Відображає орієнтовний час початку інтервалу доставки. Це поле може містити значення 0, якщо недостатньо даних для визначення часу початку доставки.","nullable":true},"to":{"type":"integer","description":"Відображає орієнтовний час завершення інтервалу доставки. Аналогічно до параметра from, це поле може містити значення 0, якщо недостатньо даних для визначення часу завершення доставки.","nullable":true},"string":{"type":"integer","description":"Відображає категорію вантажу, визначену в параметрі 'cargoCategory'. Може містити значення, такі як 'Parcel', 'Documents', 'Cargo' або 'Pallet', що відображають тип відправлених товарів.","nullable":true},"fullName":{"type":"integer","description":"Повне ім’я отримувача. Використовується для забезпечення доставки конкретній особі та є необхідним для перевірки під час вручення.","nullable":true},"phone":{"type":"integer","description":"Контактний номер телефону отримувача або представника компанії отримувача. Використовується для сповіщень про доставку та комунікації з клієнтом під час обробки відправлення.\n\n**Формат:** Номер телефону має бути вказаний у **міжнародному форматі** відповідно до стандарту **E.164**.\n\nПриклад: 380XXXXXXXXX, 491234567890, 371XXXXXXXX\n\n**Обмеження:**\n- Для доставки до відділень Nova Post у Європі допускаються українські мобільні номери.\n- Для доставки до **партнерських локацій** (таких як InPost, GLS, Venipak, Cargus тощо) та при **міжнародній адресній доставці**, номер телефону повинен належати мобільному оператору країни отримувача. Якщо номер передано у локальному (не міжнародному) форматі, система намагатиметься нормалізувати його до міжнародного формату, однак внутрішній алгоритм не охоплює всі можливі випадки. Якщо ваша система не підтримує валідацію номерів на стороні інтерфейсу (front-end), рекомендується повідомляти про випадки некоректних номерів для подальшого вдосконалення логіки нормалізації.\n","nullable":true}}},"createdAt":{"type":"string","format":"date-time","description":"Дата та час створення запису, у форматі ISO 8601."},"updatedAt":{"type":"string","format":"date-time","description":"Дата та час останнього оновлення запису, у форматі ISO 8601."},"deliveryType":{"type":"string","description":"Унікальний ідентифікатор (UUID) типу тарифу доставки, використаного в результаті розрахунку.\nЦе значення відповідає внутрішньому ідентифікатору обраного тарифу.\n"},"deliveryTypeName":{"type":"string","description":"Код типу тарифу доставки, застосованого в результаті розрахунку.\n- `standard`: Стандартний тариф на міжнародну доставку.\n- `economy`: Економний тариф на міжнародну доставку.\n- `express`: Експрес-тариф на міжнародну доставку.\n"}}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Validation"},"503":{"$ref":"#/components/responses/Time-out"}},"summary":"Розрахунок вартості доставки"}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://api-portal.novapost.com/metodi-1/metodi/readme/vidpravlennya/rozrakhunok-vartosti-dostavki.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.