Elbuz підключається до Meest API і виписує накладну із картки замовлення на відділення одержувача, друкує стікер і кожні 10 хвилин приносить статус посилки — без кабінету Meest.
Коли це знадобиться:
- Відправляєте Meest ПОШТА за договором — одержувач, відділення й сума підставляються із замовлення.
- Покупець обрав відділення Meest на вашому сайті — відділення вже в замовленні, місто Elbuz знайде за ним сам.
- Клієнт платить при отриманні — післяплата на суму замовлення ставиться сама.
З чого почати: отримайте логін і пароль API в менеджера Meest → впишіть їх у запис Meest в Elbuz.
Що вміє Meest в Elbuz
- Накладна із замовлення — на відділення Meest, з післяплатою й вибором платника; по одній або пачкою.
- Довідник відділень — оновлюється щоночі, з нього обирають відділення відправника й одержувача.
- Статуси посилок — кожні 10 хвилин; за вашою таблицею кодів міняється статус замовлення, доставки й оплати.
- Стікер — PDF 100×100 з картки замовлення або з «Відправлення».
- Видалення накладної — поки Meest не прийняв посилку.
Реєстри, переадресація, повернення й виклик кур'єра з Elbuz серед українських служб є лише в Нової пошти. Для Meest ці дії — в кабінеті Meest.
Як підключити Meest: логін, пароль, відділення відправника
Де взяти логін і пароль API Meest
Логін і пароль для API видає ваш менеджер Meest. Другий шлях — особистий кабінет 24.meest.com: «Налаштування» → «API інтеграції» → «Укласти договір», і кабінет видасть токен. Договір Meest ПОШТА підписують через особистий кабінет або з представником компанії, за даними Meest — за один день. У менеджера запитайте й ID договору (contractID). Документація API для розробників — на wiki.meest-group.com.
Куди вписати логін і пароль в Elbuz
Де: Зовнішні сервіси та інтеграції → група «Доставка» → запис «Meest».
- Логін впишіть у поле «Користувач», пароль — у «Пароль». Якщо маєте токен з кабінету Meest, вставте його в поле «Токен», а «Користувач» і «Пароль» лишіть порожніми.
- Увімкніть «Активність».
- Оновіть довідник відділень, оберіть своє відділення в блоці «Відправник», впишіть телефон і назву компанії.
- Впишіть «ID договору Meest», якщо менеджер його дав.
За логіном і паролем Elbuz сам отримує токен доступу й тримає його 24 години, потім бере новий. Порожня «Назва компанії» — у накладну піде назва вашої компанії із замовлення.
1
Користувач і Пароль2
Відділення відправника3
Телефон4
Назва компанії5
ID договору Meest- Логін і пароль кабінету Meest вводяться в полях «Користувач» і «Пароль».
- Відділення, з якого відправляються посилки.
- Телефон відправника.
- Назва компанії відправника.
- ID договору Meest — необов'язкове поле, його видає менеджер Meest.
Довідник відділень
Відділення в блоці «Відправник» і у формі накладної Elbuz бере з власного довідника відділень Meest. Він оновлюється щоночі сам; після першого підключення натисніть «Оновити довідники» в блоці «Довідники служби» — це триває до кількох хвилин.
1
Відділення — 3 записи2
Оновити довідники3
Статуси доставки- Рядок «Відділення» показує кількість записів і час останнього оновлення.
- Кнопка ручного оновлення довідників (у зйомці не натискалась).
- Кнопка налаштування повідомлень за статусами доставки.
Кнопка працює лише після збереження логіна й пароля. Якщо Meest не відповів, довідник лишається попереднім.
Коди статусів Meest
Статус замовлення міняється лише в позначених статусах замовлень і за трьома таблицями «Налаштування повідомлень» — як у Укрпошти. Коди Meest у «Статуси доставки» вже вписані; їх можна змінити, через кому. Стан посилки у «Відправленні» Elbuz визначає за кодом Meest сам.
| Ваш статус доставки | Коди Meest | Що означають |
|---|---|---|
| Чекання від відправника | 2, 101 | Створено, оформлено для відправки |
| У дорозі | 8081, 11, 1100, 12, 1213, 1214 | Відправлено з підрозділу, сортувальний центр, надходження до підрозділу одержувача |
| У пункті призначення | 1216, 1220 | Надійшло у відділення, сповіщення про зберігання |
| Видана кур'єру | 1315 | Видано кур'єру |
| Доставлено | 1622 | Доручено |
| Відмова від отримання | 1620, 1825 | Відмова, повернуто відправнику |
Коди — з документації API Meest, метод відстеження. Після кодів «Доставлено», «Відмова від отримання», втрати (1629) й утилізації (1630) Elbuz посилку більше не опитує.
Як створити накладну Meest із замовлення
Де: картка замовлення → секція «Доставка» → «Створити накладну». Посилання є, якщо вид доставки замовлення — Meest; після першого відкриття форми воно називається «Редагувати накладну».
Що форма заповнить сама і що перевірити
| Поле | Звідки береться |
|---|---|
| Прізвище, Ім'я, По батькові, Телефон, E-Mail | Із замовлення |
| Відділення | Відділення з замовлення (сайт Elbuz CMS передає його сам) |
| Населений пункт | За назвою міста із замовлення в довіднику Meest |
| Загальна вага, кг | Сума ваг товарів; порожньо — піде 1 кг |
| Оголошена вартість, грн | Сума замовлення |
| Платник за доставку | «Одержувач»; можна обрати «Відправник» |
| Зворотна доставка (одержувач) | «Гроші» на суму замовлення, якщо воно не оплачене й оплата — при отриманні |
1
Оголошена вартість, грн2
Платник за доставку3
Зворотна доставка (одержувач)4
Створити накладну- Оголошена вартість, грн — сума, на яку застрахована посилка.
- Платник за доставку — одержувач або відправник.
- Зворотна доставка (одержувач) — режим «Гроші» і сума, яку одержувач сплатить при отриманні.
- Кнопка «Створити накладну» — відправляє дані до Meest.
Накладна Meest з Elbuz — лише на відділення, адресної доставки у формі немає. Форма зберігається в замовлення за кожної зміни поля.
Що відбувається після «Створити накладну»
- Elbuz перевіряє в записі Meest відділення, телефон і назву відправника, а у формі — ПІБ, телефон і відділення одержувача та вагу.
- Якщо відділення не обрано, шукає його за адресою із замовлення.
- Створює посилку в Meest і записує її номер (штрихкод) у замовлення.
Другу накладну на те саме замовлення Elbuz не створить: «Накладну вже створено: … — пропущено.» Опис відправлення обрізається до 100 символів.
Пачкою: список замовлень → позначте → «Створити ТТН (доставка)» (накладні пачкою).
Статуси посилок і друк стікера
Кожні 10 хвилин Elbuz питає Meest про кожну накладну окремо — до 100 за прохід. Відстежуються замовлення за останні 60 днів або в позначених статусах, доки посилку не доручено або не повернуто. Щойно створена посилка має статус «Відправлення створено, але не передано на доставку» (код 2). Усі посилки — у «Відправленні», коди — в таблиці.
Стікер 100×100: картка замовлення → «Перегляд накладної» → «Друк» або «Відправлення» → рядок → «Друк накладної». Elbuz сам завантажує PDF у Meest і відкриває його у вікні; пароль у браузер не потрапляє.
Як видалити накладну Meest
Де: картка замовлення → «Перегляд накладної» → «Видалити накладну» або «Відправлення» → рядок → «Видалити накладну». Кнопка є, поки Meest не прийняв посилку у відділенні. Elbuz видаляє посилку в Meest, очищує номер у замовленні й пише це в історію замовлення — накладну можна виписати знову.
1
Статус посилки2
Друк3
Видалити накладну- Статус посилки: відправлення створено, але не передано на доставку.
- Друк стікера 100×100 (PDF).
- Видалення накладної в службі доставки.
Сценарії
Перше підключення
Що зробити. Отримайте логін і пароль у менеджера, впишіть у «Користувач» і «Пароль», натисніть «Оновити довідники», оберіть своє відділення, перевірте коди в «Статуси доставки».
Що вийде. У формі накладної є списки міст і відділень Meest, статуси посилок приходять самі.
Замовлення з вашого сайту
Що зробити. Нічого: покупець на сайті Elbuz CMS обирає відділення Meest.
Що вийде. Відділення вже у формі; якщо місто порожнє, Elbuz знайде його за відділенням під час створення.
Доставку оплачує магазин
Що зробити. У формі накладної оберіть «Платник за доставку» → «Відправник».
Що вийде. Одержувач у відділенні платить лише післяплату, якщо вона є.
Що робити, коли щось пішло не так
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Служба доставки не підключена: заповніть налаштування API цієї служби…» замість форми | У записі Meest немає пароля або вимкнено «Активність» | Впишіть «Користувач» і «Пароль», увімкніть «Активність» (підключення) |
| «Error: Meest: login/password is not configured» або помилка входу від Meest | Порожнє поле «Користувач» або логін чи пароль не дійсні | Перевірте їх у менеджера Meest і впишіть заново |
| Порожні списки «Область», «Місто», «Відділення» | Довідник відділень ще не завантажено | «Оновити довідники» після збереження логіна й пароля (довідник) |
| «Error: sender branch_id is required (API settings)» | Не обрано відділення відправника | Оберіть його в блоці «Відправник» запису Meest |
| «Error: sender name is required (API settings)» або «sender phone is required (API settings)» | У записі Meest порожні «Назва компанії» чи «Телефон», а в замовленні не вказано вашу компанію | Впишіть їх у блоці «Відправник» запису Meest |
| «Error: branch_id is required for recipient» | Відділення одержувача не знайдено в довіднику | Оберіть місто й відділення у формі вручну |
| «Error:» з назвою поля, наприклад «receiver.phone: …» | Meest не прийняв значення цього поля | Виправте поле у формі накладної або в записі Meest і створіть накладну ще раз |
| Накладну не видалено: «Cancellation is only available until parcel arrives at the sender office» | Посилку вже прийняли у відділенні Meest | Видалення вже не працює — повернення чи переадресацію оформіть у кабінеті Meest |
Часті запитання
Скільки коштує інтеграція з Meest?
Elbuz за накладні, стікери й статуси нічого не списує. Доставку ви оплачуєте Meest за вашим договором.
Чи можна відправити на поштомат Meest?
У списку «Відділення» є ті точки, які Meest віддає в довіднику відділень. Адресної доставки у формі немає.
Що вписати: логін і пароль чи токен?
Одне з двох. З логіном і паролем Elbuz сам отримує токен і оновлює його щодоби. Токен з кабінету 24.meest.com вставляють у поле «Токен», тоді логін і пароль не потрібні.
Скільки важить посилка максимум?
Meest ПОШТА для інтернет-магазинів вказує посилки до 30 кг у відділення й поштомати.
Хто платить за доставку Meest?
За замовчуванням одержувач у відділенні. У формі накладної можна обрати «Відправник» — тоді платите ви за договором.
Де це і хто має доступ
- Меню
- Кабінет → Налаштування системи → Інші налаштування → Зовнішні сервіси та інтеграції → Доставка
- Інші входи
- Довідники → Документи → Відправлення → «Служби доставки»; картка замовлення → секція «Доставка»
- Право доступу
- підключення — «API та токени доступу»; накладна — вікно «Створення ТТН служби доставки»; посилки — «Відправлення»
- Підготувати
- договір з Meest, логін і пароль API, відділення, з якого відправляєте
Накладну можна виписати лише для замовлення, яке користувач бачить за налаштуванням «Чиї дані».
- Отримати логін і пароль APIМенеджер Meest
- Вписати логін і парольЗовнішні сервіси та інтеграції → Meest
- Завантажити відділення й обрати своєТам само, «Довідники служби»
- Заповнити коди статусівТам само, «Налаштування повідомлень»
- Виписати накладнуКартка замовлення, секція «Доставка»
Суміжні теми
- Якщо потрібно бачити посилки всіх служб в одному списку — Відправлення.
- Якщо відправляєте ще й Новою поштою — Нова пошта API в Elbuz.
- Якщо замовлення прийшло з Rozetka й накладну треба виписати через маркетплейс — накладна через Rozetka.
- Якщо накладні треба виписати по десятках замовлень — накладні пачкою.
