Помилки при створенні ТТН

У цій статті зібрали відповіді на найчастіші помилки при створенні трек-номера.
Написано Анастасія Останіна
Оновлено 1 тиждень тому

Нова пошта

1. Помилка «AfterpaymentOnGoodsCost недоступний» 

У налаштуваннях Нової Пошти в кабінеті KeyCRM увімкнена послуга «Контроль оплат», але сама послуга недоступна у кабінеті НП.

Рішення: Для активації «Контроль оплат» потрібно укласти договір з Новою Поштою та NovaPay. Після цього надається новий API ключ для заміни в KeyCRM.

Якщо договір укладений — скопіюйте новий API ключ з кабінету Нової пошти та замініть старий у KeyCRM в «Налаштування» → «Доставка». Якщо помилка продовжується, зверніться до підтримки Нової Пошти.

Якщо договір не укладений — перейдіть у «Налаштування» → «Доставка» → редагування НП → вкладка «Параметри» → вимкніть «Контроль оплат» і натисніть «Зберегти».

2. Помилка «Відправник не належить цьому користувачу» / Помилка «Контакт відправника видалено»

При підключенні Нової Пошти не був обраний відправник і контактна особа після вказання API ключа. Або видалили значення відправника.

Рішення: Перейдіть у «Налаштування» → «Доставка» → натиснути на редагування під'єднаної НП → у вкладці «Під'єднання» обрати відправника і контактну особу, і натиснути «Зберегти».

3. Помилка «Адреса одержувача не належить до цього одержувача» або «SenderWarehouse is denied to select»

Відділення зачинено або обраний невірний населений пункт при створенні ТТН.

Рішення: На сайті НП https://novaposhta.ua/office/list або https://novapost.com/uk-ua/departments перевірити чи населений пункт (район) відображається у списку (чи відчинене відділення). Звернутись у підтримку НП, щоб вони змогли надати більш точну інформацію по цьому відділенню.

4. Помилка «Термін дії API key закінчився»

У кабінеті Нової Пошти закінчився термін дії API ключа, який вказали при підключенні у KeyCRM.

Рішення: Перейдіть у кабінет НП для створення або подовження API ключа. Якщо створили новий, замініть його в KeyCRM: «Налаштування» → «Доставка» → редагування НП → «Під'єднання» → заміна ключа, оберіть відправника та контактної особи, натисніть «Зберегти».

5. Помилка «Special Cargo seat not match in size»

Оформлюється ТТН з ручною обробкою і габарити (параметри) посилки, довжина, ширина, висота перевищує 120 см.

Рішення: При ручній обробці кожен параметр посилки немає перевищувати 120 см.

6. Помилка «Invalid recipient»

Вказане невірне або не повне ім'я в отримувачі.

Рішення: В одержувачі має бути вказане ім'я та прізвище кириличними буквами без зайвих символів.

7. Помилка «Прізвище або ім’я містить неприпустимі символи»

В прізвищі або імені отримувача присутній символ через який виникає помилка.

Рішення: Повне ім’я отримувача має бути кирилицею (апостроф і тире). Іноді можуть бути латинські букви або приховані символи.

Перейдіть у замовлення, натисніть на ім’я отримувача (або покупця). Скопіюйте ім’я через ctrl+a і вставте в блокнот або Word для перевірки на приховані символи.

8. Помилка «Max param value sizes is …»

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

Рішення: Перейдіть на сайт НП https://novaposhta.ua/office/list або https://novapost.com/uk-ua/departments і перевірити максимальні габарити, які може прийняти це відділення.

9. Помилка «RecipientAddressCity does not belong to AddressCity»

У місті одержувача немає відділення (доставки) Нової Пошти.

Рішення:  Змінити місто в даних Одержувача.

Укрпошта

1.  Помилка «Postcode can't be empty»

У полі Індекс не вказаний або вказаний невірний індекс поштового відділення/адреси.

Рішення: Перейдіть до адреси одержувача та перевірте поле індекс. Якщо посилка надсилається до відділені, то у полі адреса має бути вказана саме адреса відділення.

Перевірте чи індекс відповідає вказаній адресі:
- Для відділень: на сайті УкрПошти https://offices.ukrposhta.ua/
- Для адрес: на сайті https://postcode.in.ua/​​

2. Помилка  «Contracts (номер ID) conditions violation: postPayPaidByRecipient not allowed!»

Платник післяплати не може бути відправник.

Рішення: Необхідність вказати платника післяплати отримувач.

3. Помилка «Length + 2 * (height + width) should not exceed 200 cm»

Габарити посилки при обраному типі перевезення “Наземна” завеликі для відправки.

Рішення: Рекомендуємо змінити тип перевезення на “Авіа” або зменшити габарити посилки.

4. Помилка «cURL error 28: Operation timed out after 15001 milliseconds with 0 bytes received»

Не вдалось отримати відповідь від сервера УкрПошти. Скоріш за все проблема на стороні УкрПошти.

Рішення:  Зачекайте, поки УкрПошта виправить проблеми. Для додаткової інформації звертайтеся в підтримку.

Помилка зникне після виправлення проблеми.

5. Помилка «Client error: PUT https://www.ukrposhta.ua/ecom/0.0.1/clients/(ID) resulted in a 401 Unauthorized response: {"code":"UPE05001","message":"Counterparty mismatch. User (ID) permissions (truncated...)»

У існуючому підключенні УкрПошти намагаються змінити налаштування “Відправлення по Україні” на “Відправлення за межі України”.

Рішення: Поверніть налаштування та створіть нове підключення УкрПошти для міжнародних відправок.
Якщо використовуєте свої ключі, ви можете їх повторно вказати у новому підключенні.

6. Помилка «Client error: PUT https://www.ukrposhta.ua/ecom/0.0.1/clients/(ID) resulted in a ‘400 Bad Request’ response: {"code":UPE07002,"message":"Client’s type can’t be changed”}»

У існуючому підключенні УкрПошти намагаєтесь змінити “Тип клієнта” на інший.

Рішення: В існуючому підключенні не можна змінити тип клієнта. Рекомендуємо створити нове підключення та обрати виконати налаштування з необхідним типом.

7. Помилка «postId' should contain between 13 and 13 characters!»

В поле PostID вказали невірне значення.

Рішення: Правильний PostID можна знайти в особистому кабінеті УкрПошти. Рекомендуємо перейти до свого кабінету УкрПошти або можна звернутись у їх підтримку.

8. Помилка «Client (ID) can't create shipments with many parceles»

Намагається створити доставку з декількома місцями на наші ключі.

Рішення: Для доставки з кількома місцями потрібно укласти договір з УкрПоштою з відповідною позначкою. Після цього створіть нове підключення з власними ключами.

9. Помилка «For package type Express Mail Service, fields [value] in object parcelltems should be filled»

Рішення: Необхідно вказати ціну на товар вище нуля.

10. Помилка «Ім’я отримувача заповнене невірно»

Рішення: В імені отримувача необхідно вказати по батькові при увімкненні перемикача «Післяплата».

11. Помилка «Parcel items quantity can't be more than 4 in one parcel, if shipment type is INTERNATIONAL»

Рішення: Кількість місць для відправки не може бути більше 4-х позицій, просимо звернутись у підтримку Укрпошти.

12. Помилка «There must be an agreement for postpaid payment to a bank account»

Щоб формувати ТТН Укрпошти з виплатою післяплати на розрахунковий рахунок - у вас має бути укладений відповідний договір.

Рішення: Необхідно  звертатись до своїх менеджерів з якими були підписані договори. Менеджери мають виконати доналаштування, щоб все почало працювати:
Менеджер має в ЕРП встановити дату оновлення договору поточною датою і через годину відбудеться синхронізація даних з АРІ. Якщо цей варіант не спрацює, то потрібно в контрагенті клієнта додати відсутній код ІПН/ЄДРПОУ.

Rozetka

1. Помилка «Перевірте коректність введених даних. Значення «Weight» має бути не менше 0.1»

Rozetka при створенні ТТН через АРІ не приймає вагу в габаритах менше, ніж 100 грамів.

Рішення: При вказанні габаритів у поле «Вага» потрібно вказувати 100 грамів та більше, або 0.1 кг.

UPS

1.  Помилка «Missing or invalid ship to state provece code»

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

Рішення: Перед тим, як створити ТТН для відправки до Німеччини, видаліть регіон з адреси одержувача.

Теги: помилка при створення ТТН, UPS, Розетка, Укрпошта, Нова пошта
Чи була наша стаття корисною?