Apiship

Интеграция ApiShip для Medusa

Документация
Плагин Medusa для интеграции с агрегатором служб доставки ApiShip, предоставляющий вашему магазину доступ к 40+ перевозчикам при минимальной настройке. Готов к продакшену.
Read README in English ↗

▶ Смотреть демо-видео

Возможности плагина

• Готов к продакшену: Проверен в боевых магазинах и готов к использованию в реальных проектах.
• Подключение 40+ служб доставки: Работа по прямым договорам с множеством перевозчиков через единую интеграцию.
• Автоматический расчёт доставки: Учёт габаритов, веса и тарифов служб доставки, а в корзину попадает цена тарифа, который выбрал покупатель.
• Доставка в пункты выдачи: Плагин возвращает пункты выдачи, которые обслуживает каждый тариф, а пример витрины показывает их на интерактивной карте.
• Службы доставки для каждого склада: Свяжите договор с каждым перевозчиком со складом, со своим пунктом приёма заказов и своим списком разрешённых тарифов.
• Создание заказа в один клик: Оформление отправления в ApiShip прямо из Medusa Admin без ручного ввода данных.
• Этикетки отправлений: Трек-номер, ссылка для отслеживания и PDF этикетки появляются в фулфилменте заказа в Medusa Admin.
• Наложенный платёж: Получение стоимости товаров при доставке, со ставкой НДС на доставку в заказе ApiShip.
• Несколько аккаунтов ApiShip: Регистрируйте несколько инстансов плагина, у каждого свой токен и свои настройки.
• Полное тестовое покрытие: Юнит- и интеграционные тесты, покрывающие основные сценарии и граничные случаи.
• Пример витрины магазина: Готовая витрина на Next.js, которую можно использовать как образец.
• Тестовый режим: Переключение на тестовую среду ApiShip, где расчёты и заказы не создают настоящих отправлений.
• Подробное логирование: Логи запросов и ответов на уровне логирования Copy to clipboarddebug для отладки и поддержки.
• Модуль интеграций : Настройте плагин прямо в приложении Medusa Admin, без правок конфигурационных файлов и повторного развёртывания магазина.

Модуль интеграций: Этот плагин поддерживает модуль интеграций — он позволяет администратору магазина настраивать его прямо в приложении Medusa Admin, не редактируя конфигурационные файлы и не выполняя повторное развёртывание магазина. Конфиденциальные значения шифруются, а настройки проверяются перед применением.

Что такое ApiShip

Российская платформа-агрегатор служб доставки ApiShip подключает интернет-магазины к 40+ курьерским службам через единый API. Вместо отдельной интеграции с каждым перевозчиком ApiShip предоставляет унифицированный интерфейс для расчёта тарифов, создания заказов, отслеживания и формирования документов по всем подключённым провайдерам.

Среди популярных служб доставки, доступных через ApiShip: СДЭК, Яндекс Доставка, Почта России, Деловые Линии, ПЭК, Boxberry, СберЛогистика, DPD, и многие другие. Полный список можно посмотреть на странице служб доставки на сайте ApiShip.

💬 Поддержка и сообщество

Есть вопросы по плагину или идеи? Пишите в чат поддержки в Telegram @gorgojs_chat.

Общайтесь с другими разработчиками Medusa в Telegram в @medusajs_chat.

Требования

• Medusa v2.17.2 или новее
• Node.js 20.19 или новее либо 22.12 или новее
• Аккаунт ApiShip – зарегистрируйтесь или войдите
• Модуль интеграций

Установка

123
yarn add @gorgo/medusa-integration @gorgo/medusa-fulfillment-apiship
# или
npm install @gorgo/medusa-integration @gorgo/medusa-fulfillment-apiship

Документация

Полное руководство по установке, настройке и использованию плагина доступно на сайте документации Gorgo.

Лицензия

Распространяется на условиях лицензии MIT.