↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Продажі та документи
    4. Обробка замовлень покупця
    5. Служби доставки в Elbuz

    Meest API в Elbuz: накладна із замовлення, стікер і статуси посилок

    7 хв читанняОновлено

    Elbuz підключається до Meest API і виписує накладну із картки замовлення на відділення одержувача, друкує стікер і кожні 10 хвилин приносить статус посилки — без кабінету Meest.

    Коли це знадобиться:

    • Відправляєте Meest ПОШТА за договором — одержувач, відділення й сума підставляються із замовлення.
    • Покупець обрав відділення Meest на вашому сайті — відділення вже в замовленні, місто Elbuz знайде за ним сам.
    • Клієнт платить при отриманні — післяплата на суму замовлення ставиться сама.

    З чого почати: отримайте логін і пароль API в менеджера Meest → впишіть їх у запис Meest в Elbuz.

    Що вміє Meest в Elbuz

    Реєстри, переадресація, повернення й виклик кур'єра з Elbuz серед українських служб є лише в Нової пошти. Для Meest ці дії — в кабінеті Meest.

    Як підключити Meest: логін, пароль, відділення відправника

    Де взяти логін і пароль API Meest

    Логін і пароль для API видає ваш менеджер Meest. Другий шлях — особистий кабінет 24.meest.com: «Налаштування» → «API інтеграції» → «Укласти договір», і кабінет видасть токен. Договір Meest ПОШТА підписують через особистий кабінет або з представником компанії, за даними Meest — за один день. У менеджера запитайте й ID договору (contractID). Документація API для розробників — на wiki.meest-group.com.

    Куди вписати логін і пароль в Elbuz

    Де: Зовнішні сервіси та інтеграції → група «Доставка» → запис «Meest».

    1. Логін впишіть у поле «Користувач», пароль — у «Пароль». Якщо маєте токен з кабінету Meest, вставте його в поле «Токен», а «Користувач» і «Пароль» лишіть порожніми.
    2. Увімкніть «Активність».
    3. Оновіть довідник відділень, оберіть своє відділення в блоці «Відправник», впишіть телефон і назву компанії.
    4. Впишіть «ID договору Meest», якщо менеджер його дав.

    За логіном і паролем Elbuz сам отримує токен доступу й тримає його 24 години, потім бере новий. Порожня «Назва компанії» — у накладну піде назва вашої компанії із замовлення.

    Форма підключення Meest: доступи та блок «Відправник»
    1Користувач і Пароль
    2Відділення відправника
    3Телефон
    4Назва компанії
    5ID договору Meest
    1. Логін і пароль кабінету Meest вводяться в полях «Користувач» і «Пароль».
    2. Відділення, з якого відправляються посилки.
    3. Телефон відправника.
    4. Назва компанії відправника.
    5. ID договору Meest — необов'язкове поле, його видає менеджер Meest.

    Довідник відділень

    Відділення в блоці «Відправник» і у формі накладної Elbuz бере з власного довідника відділень Meest. Він оновлюється щоночі сам; після першого підключення натисніть «Оновити довідники» в блоці «Довідники служби» — це триває до кількох хвилин.

    Форма підключення Meest: налаштування повідомлень і довідники служби
    1Відділення — 3 записи
    2Оновити довідники
    3Статуси доставки
    1. Рядок «Відділення» показує кількість записів і час останнього оновлення.
    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 кг
    Оголошена вартість, грнСума замовлення
    Платник за доставку«Одержувач»; можна обрати «Відправник»
    Зворотна доставка (одержувач)«Гроші» на суму замовлення, якщо воно не оплачене й оплата — при отриманні
    Форма створення накладної Meest із заповненими даними одержувача та параметрами відправлення
    1Оголошена вартість, грн
    2Платник за доставку
    3Зворотна доставка (одержувач)
    4Створити накладну
    1. Оголошена вартість, грн — сума, на яку застрахована посилка.
    2. Платник за доставку — одержувач або відправник.
    3. Зворотна доставка (одержувач) — режим «Гроші» і сума, яку одержувач сплатить при отриманні.
    4. Кнопка «Створити накладну» — відправляє дані до Meest.

    Накладна Meest з Elbuz — лише на відділення, адресної доставки у формі немає. Форма зберігається в замовлення за кожної зміни поля.

    Що відбувається після «Створити накладну»

    1. Elbuz перевіряє в записі Meest відділення, телефон і назву відправника, а у формі — ПІБ, телефон і відділення одержувача та вагу.
    2. Якщо відділення не обрано, шукає його за адресою із замовлення.
    3. Створює посилку в Meest і записує її номер (штрихкод) у замовлення.

    Другу накладну на те саме замовлення Elbuz не створить: «Накладну вже створено: … — пропущено.» Опис відправлення обрізається до 100 символів.

    Посилка з'являється в Meest одразу. Поки Meest не прийняв її у відділенні, накладну можна видалити з Elbuz.

    Пачкою: список замовлень → позначте → «Створити ТТН (доставка)» (накладні пачкою).

    Статуси посилок і друк стікера

    Кожні 10 хвилин Elbuz питає Meest про кожну накладну окремо — до 100 за прохід. Відстежуються замовлення за останні 60 днів або в позначених статусах, доки посилку не доручено або не повернуто. Щойно створена посилка має статус «Відправлення створено, але не передано на доставку» (код 2). Усі посилки — у «Відправленні», коди — в таблиці.

    Стікер 100×100: картка замовлення → «Перегляд накладної» → «Друк» або «Відправлення» → рядок → «Друк накладної». Elbuz сам завантажує PDF у Meest і відкриває його у вікні; пароль у браузер не потрапляє.

    Як видалити накладну Meest

    Де: картка замовлення → «Перегляд накладної» → «Видалити накладну» або «Відправлення» → рядок → «Видалити накладну». Кнопка є, поки Meest не прийняв посилку у відділенні. Elbuz видаляє посилку в Meest, очищує номер у замовленні й пише це в історію замовлення — накладну можна виписати знову.

    Перегляд ТТН Meest зі статусом і кнопками друку та видалення
    1Статус посилки
    2Друк
    3Видалити накладну
    1. Статус посилки: відправлення створено, але не передано на доставку.
    2. Друк стікера 100×100 (PDF).
    3. Видалення накладної в службі доставки.

    Сценарії

    Перше підключення

    Що зробити. Отримайте логін і пароль у менеджера, впишіть у «Користувач» і «Пароль», натисніть «Оновити довідники», оберіть своє відділення, перевірте коди в «Статуси доставки».

    Що вийде. У формі накладної є списки міст і відділень 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, відділення, з якого відправляєте

    Накладну можна виписати лише для замовлення, яке користувач бачить за налаштуванням «Чиї дані».

    1. Отримати логін і пароль APIМенеджер Meest
    2. Вписати логін і парольЗовнішні сервіси та інтеграції → Meest
    3. Завантажити відділення й обрати своєТам само, «Довідники служби»
    4. Заповнити коди статусівТам само, «Налаштування повідомлень»
    5. Виписати накладнуКартка замовлення, секція «Доставка»

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно