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

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

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 }
    ],
    "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 vai 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
  }
}

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