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