API Нової пошти для магазину: ключ, відділення, ТТН

API-ключ Нової пошти дозволяє магазину не просити покупця вручну писати «відділення №…» у коментарі. Через API можна підказувати міста й відділення у формі замовлення, створювати ТТН із кабінету та отримувати статуси доставки.

У Trendon кожна крамниця підключає власний ключ. Спільного ключа платформи для продавців немає.

Де взяти ключ

У бізнес-кабінеті Нової пошти відкрийте «Налаштування → Безпека → Створити ключ API».

Скопіюйте ключ і збережіть його як секрет. Не вставляйте його в публічну сторінку, опис товару або чат із покупцем.

Як підключити до Trendon

У кабінеті відкрийте «Інтеграції» → «Нова пошта», вставте ключ і збережіть.

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

Як це виглядає для покупця

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

Відділення та поштомати є різними типами точок. Для кур’єрської доставки потрібна адреса.

Це зменшує кількість помилок у назвах міст і номерах відділень порівняно з вільним текстовим полем.

Створення ТТН

Відкрийте замовлення і створіть ТТН із кабінету. Дані одержувача вже є в замовленні, тому їх не потрібно повторно переносити вручну.

Перевірте вагу, опис, відправника, платника доставки та післяплату, якщо вона використовується.

Накладений платіж

Післяплата, це не просто перемикач «отримати гроші у відділенні». У накладній потрібно правильно передати параметри грошового переказу згідно з вашими умовами роботи з перевізником.

Окремо перевірте, хто фіскалізує розрахунок у вашій схемі. Податкові наслідки залежать від договору та ролі перевізника, а не лише від назви «накладений платіж».

Статуси доставки

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

Статус у Trendon не замінює роботу з винятковими ситуаціями. Якщо посилка зависла або потрібна переадресація, користуйтеся інструментами перевізника.

Якщо потрібного відділення немає

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

Повний розбір помилок: «Підключення Нової пошти: ключ і відправник». Про всі способи доставки: «Доставка й оплата».

Дія зараз: створіть API-ключ, підключіть його й зробіть одну тестову ТТН до реального відділення, яким користуватиметься покупець.