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

Kaip apskaičiuojama jūsų kaina

your_price = retail_price × (1 − lygio nuolaida), apvalinama iki cento. Silver lygio pavyzdys (−10 %): mažmeninė kaina 18 € → jūsų kaina 16,20 €. retail_price — tai mūsų Estijos regiono mažmeninė kaina su PVM.

Lygio peržiūra

Kartą per mėnesį (1 dieną, pagal praėjusio mėnesio apmokėtų užsakymų apyvartą) peržiūrime jūsų lygį. Ribos: Bronze — nuo ≈417 €/mėn., Silver — nuo ≈1250 €/mėn., Gold — nuo ≈3333 €/mėn. Pakėlimas įsigalioja iškart pasiekus ribą. Nuleidimas įsigalioja tik po dviejų mėnesių iš eilės žemiau ribos — vienas silpnas mėnuo lygio nepakeičia. Apie kiekvieną lygio pasikeitimą pranešame el. paštu, nurodydami apyvartą ir įsigaliojimo datą; jau patvirtintiems užsakymams tai įtakos neturi.

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

Paieška pagal brūkšninį kodą

Tas pats atsakymas, bet pagal EAN/GTIN brūkšninį kodą, o ne mūsų SKU — patogu, jei jūsų sistema saugo prekes pagal brūkšninį kodą.

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

{
  "barcode": "8032825918934",
  "sku": "ARGMASK200",
  "variant_id": "variant_01...",
  "available": 3,
  "warehouses": [
    { "location_id": "sloc_01...", "name": "Rakvere Warehouse", "available": 2 },
    { "location_id": "sloc_02...", "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 },
      { "barcode": "8032825918934", "quantity": 1 }
    ],
    "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, variant_id arba barcode (EAN/GTIN).

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

Savas siuntėjas etiketėje

Paprašykite savo vadybininko siuntos etiketėje vietoje Emmebi Italia nurodyti jūsų vardą ir kontaktus kaip «siuntėją» (o jei vežėjas leidžia — ir pilną adresą) — siuntas vis tiek supakuojame ir išsiunčiame patys. Svarbu: jei pats vežėjas (ne per mūsų grąžinimo etiketės įrankį) negali pristatyti siuntos ir ją automatiškai grąžina, ji keliauja adresu, nurodytu kaip siuntėjas, t. y. jums, o ne į mūsų sandėlį.

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