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 v22.23.4, v24.22.1, v26.12.1 или новее
• Аккаунт ApiShip – зарегистрируйтесь или войдите
• Модуль интеграций

Установка

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

Подключение

Зарегистрируйте плагин и Модуль интеграций в Copy to clipboardmedusa-config.ts:

1234567891011121314151617181920
const APISHIP_INTEGRATION_ID = "apiship-1"

module.exports = defineConfig({
  plugins: [
    {
      resolve: "@gorgo/medusa-integration",
      options: {
        encryptionKey: process.env.INTEGRATION_ENCRYPTION_KEY,
        providers: [
          {
            resolve: "@gorgo/medusa-fulfillment-apiship/providers/integration-apiship",
            id: APISHIP_INTEGRATION_ID,
            options: {},
          },
        ],
      },
    },
    {
      resolve: "@gorgo/medusa-fulfillment-apiship",
      options: {},

В Copy to clipboardINTEGRATION_ENCRYPTION_KEY задайте длинную случайную строку, например результат Copy to clipboardopenssl rand -hex 32. Из неё Модуль интеграций получает ключ, которым шифрует секретные параметры, например API-ключи.

Затем перезапустите сервер и настройте интеграцию в Medusa Admin в разделе Настройки → Интеграции → ApiShip.

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

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

Лицензия

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