Dropshipping API — руководство партнёра

Как получить доступ

Доступ к API выдаётся вручную. Самостоятельно получить первый ключ нельзя: мы проверяем партнёра и заключаем договор до выдачи ключа.

1. ЗаявкаОставьте заявку через форму на странице для салонов (юр. лицо, рег. номер, VAT, контакты).
2. ПроверкаМы проверяем компанию и платёжеспособность. Дропшиппинг работает по предоплате — заказы оплачиваются банковским переводом до отгрузки.
3. ДоговорПодписываем партнёрский договор и соглашение об обработке данных (шаблоны ниже). Партнёрский уровень (Bronze/Silver/Gold) фиксируется в договоре.
4. Выдача ключаМенеджер выдаёт API-ключ emmebi_dsk_…. Ключ показывается один раз — храните его как пароль. При компрометации сообщите нам: ключ отзывается мгновенно, выпускается новый.

Договоры

Партнёрские договоры (договор дропшиппинга и DPA) доступны зарегистрированным бизнес-партнёрам в вашем кабинете.

Готовые данные для импорта в вашу платформу

Импортируйте весь наш каталог прямо в свой магазин — без парсинга. Один запрос GET /dropship/feed отдаёт все опубликованные товары с переводами, фотографиями, наличием и вашими ценами в формате, который нативный импортёр вашей CMS читает напрямую.

Параметры: format — платформа (см. таблицу); locale — язык данных: et, en, ru, fi, sv, lv, lt.

curl -H "Authorization: Bearer emmebi_dsk_..." \
  "https://api.emmebi.ee/dropship/feed?format=woocommerce&locale=et" \
  -o emmebi-catalog.csv

Цена продажи в фиде — наша рекомендованная розница (с НДС), готова к продаже; вы можете изменить наценку. Ваша закупочная цена (розница минус скидка тарифа) идёт в отдельной колонке: Meta: _dropship_cost (WooCommerce), Variant Cost (Shopify), Wholesale price (PrestaShop).

Работаете на другой платформе? Подготовим выгрузку под неё — напишите нам, и мы добавим нужный формат.

Автоматическое обновление

Фид формируется на лету при каждом запросе. Новый товар, фото, изменение цены или наличия появляются в нём сразу. Настройте в импортёре вашей CMS периодический импорт по URL фида (расписание в WP All Import, Matrixify, cron-импорт PrestaShop) — и каталог будет синхронизироваться сам.

1. Доступ к API

2. Каталог

Параметры: limit (до 100, по умолчанию 50), offset, handle (фильтр по одному товару).

curl -H "Authorization: Bearer emmebi_dsk_..." \
  "https://api.emmebi.ee/dropship/products?limit=50&offset=0"

{
  "tier": "silver",
  "discount": 0.1,
  "count": 106,
  "products": [
    {
      "title": "Argania Sahara Secrets Mask",
      "handle": "argania-sahara-secrets-mask",
      "variants": [
        {
          "variant_id": "variant_01...",
          "sku": "ARGMASK200",
          "barcode": "8032825918934",
          "retail_price": 18,      // recommended retail, EUR, incl. VAT
          "your_price": 16.2,      // your tier price
          "available": 3           // total available across warehouses
        }
      ]
    }
  ]
}

Рекомендация: синхронизируйте каталог не чаще раза в час, остаток конкретного SKU проверяйте точечно перед оформлением заказа.

3. Остатки

curl -H "Authorization: Bearer emmebi_dsk_..." \
  "https://api.emmebi.ee/dropship/inventory/ARGMASK200"

{
  "sku": "ARGMASK200",
  "available": 3,
  "warehouses": [
    { "name": "Rakvere Warehouse", "available": 2 },
    { "name": "Kohtla-Järve Warehouse", "available": 1 }
  ]
}

4. Создание заказа

Обязателен заголовок Idempotency-Key — любая ваша уникальная строка (например, номер вашего заказа). Повторный запрос с тем же ключом вернёт уже созданный заказ, а не дубль — безопасно ретраить при таймаутах.

curl -X POST "https://api.emmebi.ee/dropship/orders" \
  -H "Authorization: Bearer emmebi_dsk_..." \
  -H "Idempotency-Key: my-shop-order-10422" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "sku": "ARGMASK200", "quantity": 2 }
    ],
    "shipping_address": {
      "first_name": "Mari",
      "last_name": "Tamm",
      "address_1": "Pikk 12-4",
      "city": "Tallinn",
      "postal_code": "10123",
      "country_code": "ee",
      "phone": "+372 5xxx xxxx"
    },
    "end_customer_email": "[email protected]",
    "reference": "my-shop-order-10422"
  }'

shipping_address — адрес вашего конечного покупателя: посылку отправляем напрямую ему. В items можно указывать sku или variant_id.

// Response 201
{
  "order_id": "order_01...",
  "display_id": 137,
  "status": "awaiting_payment",
  "total": 32.4,
  "proforma_emailed": true,
  "payment": {
    "method": "bank_transfer",
    "recipient": "HairFresh OÜ",
    "iban": "EE73 1010 2202 9766 2225",
    "swift": "EEUHEE2X",
    "bank": "SEB Pank",
    "reference": "EMB-PRO-137",
    "amount": 32.4
  }
}

Оплата

Работаем по предоплате. После создания заказа на email вашего аккаунта автоматически приходит проформа-счёт (PDF) с реквизитами. Оплатите банковским переводом, в назначении укажите reference (например EMB-PRO-137). Товар зарезервирован за вами с момента создания заказа; отгружаем в день подтверждения оплаты.

Ошибки

5. Статус заказа

{
  "display_id": 137,
  "payment_status": "paid",
  "shipped": true,
  "delivered": false,
  "fulfillments": [
    {
      "shipped_at": "2026-07-04T09:12:00Z",
      "tracking": [
        { "tracking_number": "JJFI123...", "tracking_url": "https://..." }
      ]
    }
  ]
}

Поллинга раз в 15–30 минут достаточно. Появился tracking_number — передайте его вашему покупателю.

6. Типовой цикл интеграции

раз в час        GET  /dropship/products         → обновить витрину и цены
перед заказом    GET  /dropship/inventory/{sku}  → проверить остаток
продажа у вас    POST /dropship/orders           → создать заказ (Idempotency-Key!)
после оплаты     банковский перевод по проформе
каждые 15-30 мин GET  /dropship/orders/{id}      → payment_status / трекинг