Dropshipping API — partnerguide

Så får du åtkomst

API-åtkomst beviljas manuellt. Du kan inte själv skapa den första nyckeln: vi granskar partnern och tecknar ett avtal innan vi utfärdar en nyckel.

1. AnsökanSkicka in en förfrågan via formuläret på salongssidan (juridisk person, registreringsnummer, VAT, kontaktuppgifter).
2. GranskningVi kontrollerar företaget och dess betalningsförmåga. Dropshipping bygger på förskottsbetalning — ordrar betalas via banköverföring innan avsändning.
3. AvtalVi tecknar ett partneravtal och ett personuppgiftsbiträdesavtal (mallar nedan). Din partnernivå (Bronze/Silver/Gold) fastställs i avtalet.
4. NyckelutfärdandeHandläggaren utfärdar en API-nyckel emmebi_dsk_…. Nyckeln visas endast en gång — förvara den som ett lösenord. Om den komprometteras, meddela oss: nyckeln återkallas omedelbart och en ny utfärdas.

Avtal

Partneravtal (dropshipping-avtalet och DPA) är tillgängliga för registrerade företagspartner inne på ditt konto.

Färdiga data för import till din plattform

Importera hela vår katalog direkt till din butik — utan skrapning. En enda GET /dropship/feed-förfrågan returnerar alla publicerade produkter med översättningar, foton, lagersaldo och dina priser i ett format som din CMS-importör läser direkt.

Parametrar: format — plattform (se tabell); locale — dataspråk: 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

Försäljningspriset i flödet är vårt rekommenderade utpris (inkl. moms), redo att säljas — du kan justera påslaget. Ditt inköpspris (utpris minus din nivårabatt) finns i en separat kolumn: Meta: _dropship_cost (WooCommerce), Variant Cost (Shopify), Wholesale price (PrestaShop).

Använder du en annan plattform? Vi kan förbereda en export för den — kontakta oss så lägger vi till formatet du behöver.

Automatisk uppdatering

Flödet genereras live vid varje förfrågan. En ny produkt, foto, pris- eller lagerändring visas där direkt. Schemalägg en återkommande import från flödets URL i din CMS-importör (WP All Import-schema, Matrixify, PrestaShop cron-import) så håller sig katalogen synkroniserad av sig själv.

1. API-åtkomst

2. Katalog

Parametrar: limit (upp till 100, standard 50), offset, handle (filtrera på en enskild produkt).

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

Rekommendation: synka katalogen högst en gång i timmen; kontrollera lagersaldot för en specifik SKU exakt precis innan du lägger en order.

3. Lager

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. Skapa en order

Headern Idempotency-Key är obligatorisk — en valfri unik sträng från dig (t.ex. ditt ordernummer). En upprepad förfrågan med samma nyckel returnerar den redan skapade ordern i stället för en dubblett — säker att göra om vid timeouts.

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 är adressen till din slutkund: vi skickar paketet direkt till dem. I items kan du ange sku eller 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
  }
}

Betalning

Vi arbetar med förskottsbetalning. När ordern har skapats mejlas en proformafaktura (PDF) med bankuppgifter automatiskt till ditt konto. Betala via banköverföring och ange reference i betalningens meddelandefält (t.ex. EMB-PRO-137). Varorna reserveras åt dig från det att ordern skapas; vi skickar samma dag som betalningen bekräftas.

Fel

5. Orderstatus

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

Att fråga var 15–30:e minut räcker. När ett tracking_number dyker upp — vidarebefordra det till din kund.

6. Typisk integrationscykel

varje timme      GET  /dropship/products         → uppdatera butik och priser
före order       GET  /dropship/inventory/{sku}  → kontrollera lager
försäljning hos dig POST /dropship/orders           → skapa order (Idempotency-Key!)
efter betalning  banköverföring enligt proforman
var 15-30 min    GET  /dropship/orders/{id}      → payment_status / tracking