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

Для створення та оновлення міжнародних експрес-накладних (МЕН) з України через клієнтське 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

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

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

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

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