Solomono Інструкції Всі модулі Модуль доставки REPOST

Модуль доставки REPOST

Що робить інтеграція

Модуль Repost додає міжнародну доставку через Repost Public API.

Де

Що відбувається

Checkout (вітрина)

Покупець бачить живі тарифи перевізників (NPU, DHL, UPS тощо) і обирає метод доставки Repost

Адмінка Solomono

Менеджер відкриває замовлення і передає його в Repost через форму Send to Repost

Кабінет Repost

З'являється створена посилка; етикетки, статуси й подальша логістика ведуться вже в Repost

У замовленні Solomono зберігаються:

  • обраний на checkout перевізник, ціна, валюта та шаблон упаковки;

  • після успішного Send to Repost — ідентифікатори посилки Repost і tracking (якщо API повернув його одразу).

Важливо. Основний спосіб створити посилку з Solomono — кнопка Send to Repost. Окреме «Сформувати» / «Синхронізація замовлень» у кабінеті Repost — інструменти самого Repost; ними не потрібно дублювати вже створену з Solomono посилку.

Що підготувати

  • Доступ адміністратора до магазину Solomono.

  • Акаунт Repost і API key з кабінету Repost.

  • Адресу відправника: країна, місто, індекс, вулиця.

  • Контактні дані магазину (телефон / email власника) — підставляються у форму відправника.

  • Вагу товарів у картках товарів. Без ваги тарифи можуть рахуватися за шаблоном коробки і бути менш точними.

  • У кабінеті Repost за потреби: Мої адреси та відділення — місто й відділення Нової Пошти за замовчуванням.

Увага. API key є секретним. Не додавайте його у відкриті скріншоти, листи або чати.


 

1. Зареєструйтеся або увійдіть у Repost

  1. Відкрийте https://repost.global/.

  2. Створіть акаунт або увійдіть у вже створений кабінет.

  3. Після входу відкрийте Налаштування → API.

  4. Скопіюйте API key. Якщо ключа ще немає, створіть його в цьому розділі.

  5. Переконайтеся, що ключ увімкнений і термін дії не закінчився.

Рисунок 1. Кабінет Repost: розділ налаштувань і пункт API

2. Увімкніть модуль у Solo modules

  1. Увійдіть в адмін-панель Solomono.

  2. Відкрийте Модулі → Solo modules.

  3. Знайдіть рядок Служба доставки Repost (Repost delivery service).

  4. Переконайтеся, що перемикач у цьому рядку увімкнений.

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

Рисунок 2. Увімкнений Repost delivery service у Solo modules

3. Вкажіть API key і хост у Integrations

  1. В адмін-панелі відкрийте розділ Integrations (інтеграції Solo), підрозділ Служба доставки / Repost.

  2. Увімкніть Enable Repost (true).

  3. Вставте API-ключ з кабінету Repost.

  4. У полі Хост API (API host / Public Host) вкажіть: https://repost.global

  5. За потреби увімкніть «Сповістити покупця email» — після успішного створення посилки клієнту піде лист.

Результат. Модуль підключений до Public API Repost. Без цього кроку тарифи на checkout і форма Send to Repost не працюватимуть.

4. Увімкніть shipping-модуль Repost

  1. В адмін-панелі відкрийте Модулі → Доставка.

  2. Знайдіть rePost international delivery (rePost міжнародна доставка).

  3. Якщо модуль не встановлений, натисніть кнопку встановлення. Якщо встановлений, відкрийте редагування.

  4. Увімкніть модуль (Status = True).

  5. Заповніть адресу відправника: країна, місто, індекс, вулиця.

  6. За потреби налаштуйте зону, international only, шаблон коробки за замовчуванням, TTL кешу тарифів, sort order і custom name.

Телефон відправника в цьому модулі не налаштовується — він береться з контактів магазину (телефон / email власника).

Рисунок 3. Shipping-модуль rePost international delivery

5. Перевірте товари та адресу покупця

  1. У картках товарів перевірте, що заповнена вага.

  2. На checkout адреса доставки має містити країну.

  3. Якщо увімкнено international only, країна доставки має відрізнятися від країни відправника.

  4. Покупець доходить до checkout і обирає доступний метод доставки Repost (наприклад, NPU).

Рисунок 4. Checkout: адреса покупця і тарифи Repost

Увага. На тестовому сайті тариф Repost може не з'явитися, якщо кошик не проходить мінімальну суму, у товару немає ваги / не підходить шаблон коробки, адреса не відповідає international only або зоні, або API key невірний / вимкнений.

6. Передайте замовлення в Repost з адмінки Solomono

  1. Після оформлення замовлення відкрийте Замовлення в адмін-панелі.

  2. У колонці Delivery перевірте, що вказано rePost international delivery і обраний сервіс (наприклад, NPU).

  3. Відкрийте картку замовлення.

  4. Натисніть Send to Repost, перевірте отримувача, відправника, коробку, товари, HS-коди, декларацію та перевізника.

  5. За потреби отримайте quotes і оберіть актуальний тариф, потім створіть посилку.

Після успіху в Solomono зберігаються ідентифікатори посилки (і tracking, якщо API його вже повернув). Якщо увімкнено сповіщення — клієнт отримує email.

Якщо Repost поверне підказку про місто та відділення Нової Пошти — це попередження налаштувань кабінету, а не обов'язково помилка створення. Перевірте Мої адреси та відділення у Repost і наявність посилки в розділі Посилки.

Рисунок 5. Замовлення Solomono з доставкою rePost international delivery

7. Перевірте посилку в кабінеті Repost

  1. У кабінеті Repost відкрийте розділ Посилки.

  2. Знайдіть щойно створену посилку (якщо її вже створено через Solomono, окрема «Синхронізація замовлень» не обов'язкова).

  3. Перевірте отримувача, перевізника / тариф, вагу й габарити.

  4. Етикетки та подальші дії (якщо потрібні кнопки на кшталт «Сформувати») виконуються в кабінеті Repost — Solomono їх не генерує.

Не створюйте другу посилку з нуля в Repost для того самого замовлення, якщо вона вже створена через Send to Repost — виникнуть дублікати.

Рисунок 6. Repost: обробка відправлення в кабінеті (не дублюйте створення, якщо посилка вже є)

Рисунок 7. Repost: список посилок

8. Tracking у Solomono

  • Якщо API одразу повернув tracking у відповіді на створення — він зберігається в замовленні Solomono.

  • Якщо tracking з'являється в Repost пізніше — автоматичної повторної синхронізації в Solomono наразі немає. За потреби скопіюйте номер із кабінету Repost вручну.


 

Типові проблеми

Проблема

Що перевірити

Repost не видно на checkout

Увімкнено Solo modules → Служба доставки Repost, Integrations → Enable Repost і Модулі → Доставка → rePost international delivery.

Тарифи не розраховуються

API key і Public Host; вага товарів або шаблон коробки; країна в адресі; international only; зона доставки.

У формі Send to Repost порожні дані

У замовленні є адреса, телефон, email, країна; у shipping-модулі заповнено ship-from; у магазині вказано телефон / email.

У Repost порожня колонка «Тарифи»

У формі Send to Repost має бути обраний перевізник (npu тощо), який був на checkout.

Повідомлення про відділення Нової Пошти

У кабінеті Repost: Мої адреси та відділення — місто й відділення за замовчуванням.

Створення посилки дублюється

Не відкривайте дві вкладки з Send to Repost одночасно; при повторній відправці підтверджуйте resend у UI.

Tracking є в Repost, але немає в Solomono

Tracking міг з'явитися вже після створення; автосинхронізації пізніше немає.

Потрібна діагностика

Для технічного спеціаліста: REPOST_DEBUG=true у hidden configuration.

Контрольний список

☐ Акаунт Repost створено.

☐ API key створено й увімкнено в Repost → Налаштування → API.

☐ У Solomono увімкнено Служба доставки Repost (Solo modules).

☐ В Integrations увімкнено Enable Repost, вказано API key і https://repost.global.

☐ За потреби увімкнено сповіщення покупця email.

☐ У Модулі → Доставка увімкнено rePost international delivery.

☐ Заповнено адресу відправника (країна, місто, індекс, вулиця).

☐ У товарах заповнено вагу.

☐ На checkout видно тарифи Repost для міжнародної адреси.

☐ Через Send to Repost створено посилку.

☐ Посилка є в кабінеті Repost (розділ Посилки).

☐ За потреби в Repost налаштовано адреси / відділення НП за замовчуванням.

Оновлено: 21/07/2026
icon