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

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

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 }
    ],
    "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 või 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
  }
}

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