Зміни та оновлення в API Nova Post

Для відстеження міжнародних та внутрішніх відправлень

Розширено перелік статусів для методів FullTracking та BasicTracking. Це дозволяє отримувати детальнішу інформацію про рух вантажу, зокрема на етапах митного оформлення та складського зберігання.

Що змінилося:

• Прозорість митних процесів: додано статуси, що деталізують очікування документів, перевірку даних та рішення митниці.
• Керування винятками: з’явилися коди для випадків затримки, пошкодження пакування або заборони імпорту.
• Уніфікація: однаковий перелік статусів тепер доступний як у повному, так і в базовому трекінгу.

Повний перелік кодів та їх опис доступний у документації.

Для внутрішніх відправлень (MD–MD)

Реалізовано можливість оформлення зворотної доставки товарів та підписаних документів для клієнтів у межах Молдови.

Доступні сценарії:

• Повернення товарів (ExpBackwardGoods): ініціювання зворотної доставки на основі прямого відправлення.
• Повернення документів (ExpBackwardCreditDoc): сервіс для юридичних осіб, що дозволяє отримати підписані документи окремим відправленням.

Важливі обмеження:

• Платником за зворотну доставку документів завжди є Отримувач (безготівковий розрахунок).
• Сервіс недоступний для типів доставки PUDO та поштоматів.

Технічна інформація

Оновлено методи Create Shipment та Update Shipment Document. Додано нові параметри сервісів та приклади запитів для внутрішнього ринку Молдови.

Для створення відправлень з переліком товарів

Оновлено логіку перевірки ваги при формуванні міжнародних та внутрішніх накладних з інвойсом. Це забезпечує коректність розрахунків та запобігає помилкам при митному оформленні.

• Сумарна фактична вага всіх позицій у інвойсі повинна точно збігатися із загальною фактичною вагою всього відправлення.
• Параметр ваги стає обов'язковим для кожної товарної позиції.

В методі Create Shipment оновлено опис параметра actualWeight всередині блоку invoice.items. Якщо передається блок інвойсу, параметр є обов’язковим для кожного item.

Для доставки з України за кордон

Було створено новий метод, який дозволить користувачам дізнатися, чи є можливість по країні отримувача сплати митного платежу відправником з України. Клієнти після запиту отримують наступну інформацію:

• ознаку, чи може відправник сплатити митні платежі за посилку по вказаній країні отримувача;
• максимальний поріг вартості посилки у валюті країни отримувача, за яку треба вказувати платника митного збору. При перевищенні цього порогу платником завжди буде отримувач.

Для створення та оновлення міжнародних експрес-накладних (МЕН) з України через клієнтське API запроваджено новий параметр, який дозволяє визначити, хто саме сплачує митні платежі за посилку.

Можливі значення параметра:

• ThirdPerson — третя особа
• Sender — відправник
• Recipient — отримувач

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

• Якщо для країни-отримувача є можливість оплатити мито відправником, тоді передача нового параметру при створенні або оновленні є обов’язковою.
• За замовчуванням, якщо параметр не переданий, на стороні клієнтського API платником визначиться отримувач.
• Якщо загальна вартість посилки перевищує максимальний поріг вартості посилки у валюті країни отримувача, за яку відправник може сплатити мито, то платником також буде отримувач.

Для доставки з України за кордон

Розрахунок вартості митних платежів залежно від платника

Сума митних платежів залежно від країни платника може відрізнятись. В калькуляторі вартості доставки з'явилось додаткове поле, яке дозволяє вказати платником митних платежів одержувача, відправника або третю особу. Вартість митних платежів буде розрахована з урахуванням того, хто платить за посилку.

Прибрали дублювання параметрів для розрахунку податків

Тепер параметри для податкового розрахунку, поле загальної вартості розміщені в одному блоці.

Технічна інформація щодо змін в методі розрахунку вартості доставки для відправлень з України

Користувачі тепер можуть передавати валюту для кожної товарної позиції в інвойсі при експорті з України за кордон. Це дозволяє коректно формувати митні документи відповідно до фактичної валюти продажу. Якщо валюта не вказана — за замовчуванням використовується UAH.

Додано новий функціонал Webhook, що дозволяє:

1. 1
   GET /tracking-push/subscribers
   
   Отримати список всіх підписок, пов'язаних з клієнтом
2. 2
   POST /tracking-push/subscribers
   
   Створити нову підписку та отримувати повідомлення про відстеження. Підписка може бути різних типів, наприклад індивідуальна або корпоративна, і є необхідною для клієнтів, які хочуть отримувати оновлення про статус відправлення в режимі реального часу.
3. 3
   PUT /tracking-push/subscribers/{id}
   
   Оновити деталі існуючої підписки, такі як URL-адреса зворотного виклику, статус активації, типи подій тощо. Вона є необхідною для зміни налаштувань підписки для клієнтів, які бажають керувати тим, як вони отримують повідомлення про відстеження.
4. 4
   DELETE /tracking-push/subscribers/{id}
   
   Видалити підписку, вказану за її унікальним ідентифікатором. Видалення є незворотним і слід використовувати його з обережністю.
5. 5
   POST /tracking-push/subscribers/{id}/numbers
   
   Додавати номери відправлень до існуючої підписки, вказаної за її унікальним ідентифікатором. Номери необхідні для відстеження конкретних відправлень, пов'язаних з підпискою.
6. 6
   POST /tracking-push/subscribers/test-webhook
   
   Перевірити функціональності Webhook. Для успішної відповіді необхідна принаймні одна активна підписка.

Accordion description 4

Доступні напрямки: 

• Польща → Україна
• Румунія → Молдова (в тестовому режимі)

В майбутньому планується поширення послуги на інші країни та напрямки доставки: як для відправлень між країнами, так і для внутрішніх у межах Європи.

Щоб підключити послугу «Оплата при отриманні» для своїх клієнтів, зверніться до особистого менеджера.