Dropshipping API — partneru rokasgrāmata

Kā saņemt piekļuvi

Piekļuve API tiek piešķirta manuāli. Pirmo atslēgu nevar iegūt pašapkalpošanās režīmā: mēs pārbaudām partneri un noslēdzam līgumu, pirms izsniedzam atslēgu.

1. PieteikumsIesniedziet pieprasījumu, izmantojot formu salonu lapā (juridiskā persona, reģistrācijas numurs, PVN, kontakti).
2. PārbaudeMēs pārbaudām uzņēmumu un tā maksātspēju. Dropshipping darbojas ar priekšapmaksu — pasūtījumi tiek apmaksāti ar bankas pārskaitījumu pirms nosūtīšanas.
3. LīgumsMēs parakstām partnera līgumu un datu apstrādes līgumu (paraugi zemāk). Jūsu partnera līmenis (Bronze/Silver/Gold) tiek nostiprināts līgumā.
4. Atslēgas izsniegšanaVadītājs izsniedz API atslēgu emmebi_dsk_…. Atslēga tiek parādīta vienu reizi — glabājiet to kā paroli. Ja tā tiek kompromitēta, informējiet mūs: atslēga tiek nekavējoties atsaukta un tiek izsniegta jauna.

Līgumi

Partneru līgumi (dropshipping līgums un DPA) ir pieejami reģistrētiem biznesa partneriem jūsu kontā.

Gatavi dati importam jūsu platformā

Importējiet visu mūsu katalogu tieši savā veikalā — bez parsēšanas. Viens GET /dropship/feed pieprasījums atgriež visus publicētos produktus ar tulkojumiem, fotoattēliem, krājumiem un jūsu cenām formātā, ko jūsu CMS importētājs nolasa tieši.

Parametri: format — platforma (skat. tabulu); locale — datu valoda: 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

Pārdošanas cena plūsmā ir mūsu ieteicamā mazumtirdzniecības cena (ar PVN), gatava pārdošanai — uzcenojumu varat mainīt. Jūsu iepirkuma cena (mazumcena mīnus līmeņa atlaide) ir atsevišķā kolonnā: Meta: _dropship_cost (WooCommerce), Variant Cost (Shopify), Wholesale price (PrestaShop).

Izmantojat citu platformu? Sagatavosim eksportu tai — sazinieties ar mums, un mēs pievienosim nepieciešamo formātu.

Automātiska atjaunināšana

Plūsma tiek ģenerēta reāllaikā katrā pieprasījumā. Jauns produkts, foto, cenas vai krājumu izmaiņas tajā parādās uzreiz. Iestatiet CMS importētājā periodisku importu no plūsmas URL (WP All Import grafiks, Matrixify, PrestaShop cron imports), un katalogs sinhronizēsies pats.

1. Piekļuve API

Kā tiek aprēķināta jūsu cena

your_price = retail_price × (1 − līmeņa atlaide), noapaļots līdz centam. Piemērs Silver līmenim (−10%): mazumcena 18 € → jūsu cena 16,20 €. retail_price ir mūsu Igaunijas reģiona mazumtirdzniecības cena ar PVN.

Līmeņa pārskatīšana

Reizi mēnesī (1. datumā, pēc iepriekšējā mēneša apmaksāto pasūtījumu apgrozījuma) mēs pārskatām jūsu līmeni. Sliekšņi: Bronze — no ≈417 €/mēn., Silver — no ≈1250 €/mēn., Gold — no ≈3333 €/mēn. Paaugstinājums stājas spēkā uzreiz pēc sliekšņa sasniegšanas. Pazeminājums stājas spēkā tikai pēc diviem mēnešiem pēc kārtas zem sliekšņa — viens vājš mēnesis līmeni nemaina. Par katru līmeņa maiņu paziņojam pa e-pastu, norādot apgrozījumu un spēkā stāšanās datumu; jau apstiprinātus pasūtījumus tas neietekmē.

2. Katalogs

Parametri: limit (līdz 100, noklusējums 50), offset, handle (filtrēt pēc viena produkta).

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

Ieteikums: sinhronizējiet katalogu ne biežāk kā reizi stundā; konkrēta SKU krājumu precīzi pārbaudiet tieši pirms pasūtījuma veikšanas.

3. Krājumi

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

Meklēšana pēc svītrkoda

Tā pati atbilde, bet pēc EAN/GTIN svītrkoda mūsu SKU vietā — ērti, ja jūsu sistēma glabā produktus pēc svītrkoda.

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. Pasūtījuma izveide

Galvene Idempotency-Key ir obligāta — jebkura jūsu unikāla virkne (piemēram, jūsu pasūtījuma numurs). Atkārtots pieprasījums ar to pašu atslēgu atgriež jau izveidoto pasūtījumu, nevis dublikātu — droši atkārtot noildzes gadījumā.

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 ir jūsu gala klienta adrese: sūtījumu nosūtām tieši viņam. Laukā items varat norādīt sku, variant_id vai 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
  }
}

Savs sūtītājs uz etiķetes

Lūdziet savam pārstāvim uz sūtījuma etiķetes Emmebi Italia vietā norādīt jūsu vārdu un kontaktinformāciju kā «sūtītāju» (un, ja pārvadātājs to pieļauj, arī pilnu adresi) — sūtījumus mēs joprojām iepakojam un nosūtām paši. Svarīgi: ja pārvadātājs pats (nevis mūsu atgriešanas etiķetes rīks) nespēj piegādāt sūtījumu un to automātiski atgriež, tas dodas uz adresi, kas norādīta kā sūtītājs, — proti, jums, nevis uz mūsu noliktavu.

Apmaksa

Mēs strādājam ar priekšapmaksu. Kad pasūtījums ir izveidots, jūsu kontam automātiski tiek nosūtīts proforma rēķins (PDF) ar bankas rekvizītiem. Apmaksājiet ar bankas pārskaitījumu, maksājuma mērķī norādot reference (piemēram, EMB-PRO-137). Prece jums tiek rezervēta no pasūtījuma izveides brīža; nosūtām maksājuma apstiprināšanas dienā.

Kļūdas

5. Pasūtījuma statuss

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

Pietiek aptaujāt ik pēc 15–30 minūtēm. Tiklīdz parādās tracking_number — nododiet to savam klientam.

6. Tipiskais integrācijas cikls

reizi stundā       GET  /dropship/products         → atjaunināt veikalu un cenas
pirms pasūtījuma   GET  /dropship/inventory/{sku}  → pārbaudīt krājumu
pārdošana pie jums POST /dropship/orders           → izveidot pasūtījumu (Idempotency-Key!)
pēc apmaksas       bankas pārskaitījums pēc proformas
ik 15-30 min       GET  /dropship/orders/{id}      → payment_status / tracking