Dropshipping API — partnerio vadovas

Kaip gauti prieigą

API prieiga suteikiama rankiniu būdu. Pirmojo rakto negalite sugeneruoti patys: prieš išduodami raktą įvertiname partnerį ir pasirašome sutartį.

1. ParaiškaPateikite užklausą per formą salonų puslapyje (juridinis asmuo, registracijos numeris, PVM kodas, kontaktai).
2. PatikrinimasPatikriname įmonę ir jos mokumą. Dropshipping veikia išankstinio apmokėjimo principu — užsakymai apmokami banko pavedimu prieš išsiuntimą.
3. SutartisPasirašome partnerystės sutartį ir duomenų tvarkymo sutartį (šablonai žemiau). Jūsų partnerio lygis (Bronze/Silver/Gold) įtvirtinamas sutartyje.
4. Rakto išdavimasVadybininkas išduoda API raktą emmebi_dsk_…. Raktas parodomas vieną kartą — saugokite jį kaip slaptažodį. Jei jis buvo pažeistas, praneškite mums: raktas nedelsiant panaikinamas ir išduodamas naujas.

Sutartys

Partnerio sutartys (dropshipping sutartis ir DPA) prieinamos registruotiems verslo partneriams jūsų paskyroje.

Paruošti duomenys importui į jūsų platformą

Importuokite visą mūsų katalogą tiesiai į savo parduotuvę — be jokio parsinimo. Viena GET /dropship/feed užklausa grąžina visus paskelbtus produktus su vertimais, nuotraukomis, likučiais ir jūsų kainomis formatu, kurį jūsų TVS importuoklis skaito tiesiogiai.

Parametrai: format — platforma (žr. lentelę); locale — duomenų kalba: 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

Pardavimo kaina sraute — mūsų rekomenduojama mažmeninė kaina (su PVM), paruošta pardavimui; antkainį galite keisti. Jūsų pirkimo kaina (mažmeninė minus jūsų lygio nuolaida) yra atskirame stulpelyje: Meta: _dropship_cost (WooCommerce), Variant Cost (Shopify), Wholesale price (PrestaShop).

Naudojate kitą platformą? Paruošime eksportą jai — susisiekite su mumis ir pridėsime jums reikalingą formatą.

Automatinis atnaujinimas

Srautas generuojamas realiu laiku kiekvienos užklausos metu. Naujas produktas, nuotrauka, kainos ar likučio pokytis jame atsiranda iškart. Nustatykite TVS importuoklyje periodinį importą iš srauto URL (WP All Import tvarkaraštis, Matrixify, PrestaShop cron importas) ir katalogas sinchronizuosis pats.

1. API prieiga

2. Katalogas

Parametrai: limit (iki 100, numatytoji 50), offset, handle (filtruoti pagal vieną prekę).

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
        }
      ]
    }
  ]
}

Rekomendacija: sinchronizuokite katalogą ne dažniau kaip kartą per valandą; konkretaus SKU atsargas tiksliai patikrinkite prieš pat pateikdami užsakymą.

3. Atsargos

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. Užsakymo sukūrimas

Antraštė Idempotency-Key yra privaloma — bet kokia jūsų unikali eilutė (pvz., jūsų užsakymo numeris). Pakartotinė užklausa su tuo pačiu raktu grąžina jau sukurtą užsakymą, o ne dublikatą — saugu kartoti įvykus skirtajam laikui.

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 yra jūsų galutinio kliento adresas: siuntą pristatome tiesiai jam. Lauke items galite perduoti sku arba 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
  }
}

Apmokėjimas

Dirbame išankstinio apmokėjimo principu. Sukūrus užsakymą, į jūsų paskyrą automatiškai išsiunčiama išankstinė sąskaita faktūra (PDF) su banko rekvizitais. Apmokėkite banko pavedimu, mokėjimo paskirtyje nurodydami reference (pvz., EMB-PRO-137). Prekės jums rezervuojamos nuo užsakymo sukūrimo momento; išsiunčiame tą pačią dieną, kai patvirtinamas apmokėjimas.

Klaidos

5. Užsakymo būsena

{
  "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://..." }
      ]
    }
  ]
}

Užtenka tikrinti kas 15–30 minučių. Kai atsiranda tracking_number — perduokite jį savo klientui.

6. Tipinis integracijos ciklas

kas valandą      GET  /dropship/products         → atnaujinti vitriną ir kainas
prieš užsakymą   GET  /dropship/inventory/{sku}  → patikrinti atsargas
pardavimas pas jus POST /dropship/orders           → sukurti užsakymą (Idempotency-Key!)
po apmokėjimo    banko pavedimas pagal išankstinę sąskaitą
kas 15-30 min    GET  /dropship/orders/{id}      → payment_status / tracking