Dropshipping API — partneri juhend

Kuidas juurdepääsu saada

API juurdepääs antakse käsitsi. Esimest võtit ei saa ise luua: enne võtme väljastamist kontrollime partnerit ja sõlmime lepingu.

1. AvaldusEsitage taotlus salongide lehel oleva vormi kaudu (juriidiline isik, registrikood, VAT, kontaktid).
2. KontrollKontrollime ettevõtet ja selle maksevõimet. Dropshipping toimib ettemaksu alusel — tellimused tasutakse pangaülekandega enne kauba väljasaatmist.
3. LepingSõlmime partnerlepingu ja andmetöötluslepingu (mallid allpool). Teie partneritase (Bronze/Silver/Gold) fikseeritakse lepingus.
4. Võtme väljastamineHaldur väljastab API võtme emmebi_dsk_…. Võtit näidatakse ainult üks kord — hoidke seda nagu parooli. Kompromiteerimise korral andke meile teada: võti tühistatakse koheselt ja väljastatakse uus.

Lepingud

Partnerlepingud (dropshipping-leping ja DPA) on saadaval registreeritud äripartneritele sinu konto sees.

Valmis andmed impordiks sinu platvormile

Impordi kogu meie kataloog otse oma poodi — ilma parsimiseta. Üks päring GET /dropship/feed tagastab kõik avaldatud tooted koos tõlgete, fotode, laoseisu ja sinu hindadega vormingus, mida sinu CMS-i importija loeb otse.

Parameetrid: format — platvorm (vt tabelit); locale — andmete keel: 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

Müügihind voos on meie soovitatav jaehind (koos käibemaksuga), müügivalmis — juurdehindlust saad muuta. Sinu ostuhind (jaehind miinus taseme allahindlus) on eraldi veerus: Meta: _dropship_cost (WooCommerce), Variant Cost (Shopify), Wholesale price (PrestaShop).

Kasutad muud platvormi? Valmistame sellele ekspordi — võta ühendust ja lisame vajaliku vormingu.

Automaatne uuendamine

Voog genereeritakse iga päringu peale reaalajas. Uus toode, foto, hinna- või laomuutus ilmub sinna kohe. Seadista oma CMS-i importijas korduv import voo URL-ilt (WP All Import ajakava, Matrixify, PrestaShopi cron-import) ja kataloog püsib ise sünkroonis.

1. API juurdepääs

Kuidas teie hind arvutatakse

your_price = retail_price × (1 − taseme allahindlus), ümardatuna sendini. Näide Silver puhul (−10%): jaehind 18 € → teie hind 16,20 €. retail_price on meie Eesti regiooni jaehind koos käibemaksuga.

Taseme ülevaatus

Kord kuus (1. kuupäeval, eelmise kuu tasutud tellimuste käibe põhjal) vaatame teie taseme üle. Läved: Bronze — alates ≈417 €/kuus, Silver — alates ≈1250 €/kuus, Gold — alates ≈3333 €/kuus. Tõus rakendub kohe läve saavutamisel. Langus rakendub alles pärast kaht järjestikust kuud allpool läve — üks nõrk kuu taset ei muuda. Igast taseme muutusest teavitame e-kirjaga, näidates käivet ja jõustumise kuupäeva; juba kinnitatud tellimusi see ei puuduta.

2. Kataloog

Parameetrid: limit (kuni 100, vaikimisi 50), offset, handle (filtreerimine üksiku toote järgi).

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

Soovitus: sünkroonige kataloogi mitte sagedamini kui kord tunnis; konkreetse SKU laoseisu kontrollige täpselt vahetult enne tellimuse esitamist.

3. Laoseis

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

Otsing triipkoodi järgi

Sama vastus, kuid meie SKU asemel EAN/GTIN triipkoodi järgi — mugav, kui teie süsteem hoiab tooteid triipkoodi järgi.

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. Tellimuse loomine

Päis Idempotency-Key on kohustuslik — mis tahes teie unikaalne string (nt teie tellimuse number). Korduspäring sama võtmega tagastab juba loodud tellimuse, mitte duplikaadi — ajalõppude korral on ohutu uuesti proovida.

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 on teie lõppkliendi aadress: saadame paki otse temale. Väljal items võite edastada sku, variant_id või 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
  }
}

Oma saatja sildil

Paluge oma haldurilt panna tarneetiketile Emmebi Italia asemel teie nimi ja kontaktandmed (ja kui vedaja lubab, ka täisaadress) «saatjana» — kaubad pakime ja saadame ikkagi meie. Tähtis: kui vedaja ise (mitte meie tagastusetiketi tööriist) ei saa pakki kohale toimetada ja tagastab selle automaatselt, läheb see etiketile trükitud saatja aadressile — ehk teile, mitte meie lattu.

Makse

Töötame ettemaksu alusel. Pärast tellimuse loomist saadetakse teie kontole automaatselt e-kirjaga proforma-arve (PDF) koos pangarekvisiitidega. Tasuge pangaülekandega, märkides makse selgitusse reference (nt EMB-PRO-137). Kaup reserveeritakse teile alates tellimuse loomise hetkest; saadame kauba teele makse kinnitamise päeval.

Vead

5. Tellimuse staatus

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

Piisab pärimisest iga 15–30 minuti järel. Kui ilmub tracking_number — edastage see oma kliendile.

6. Tüüpiline integratsioonitsükkel

kord tunnis       GET  /dropship/products         → värskenda vitriini ja hindu
enne tellimust    GET  /dropship/inventory/{sku}  → kontrolli laoseisu
müük teie poolel  POST /dropship/orders           → loo tellimus (Idempotency-Key!)
pärast makset     pangaülekanne proforma alusel
iga 15-30 min     GET  /dropship/orders/{id}      → payment_status / tracking