API eficio

Profilul firmei tale: nume, CUI, adresă, plan și statusul abonamentului.

Numărători rapide: produse, comenzi pe status, clienți și valoarea comenzilor.

Listă paginată a catalogului.

Creează un produs. „name" e singurul obligatoriu; SKU și slug se generează automat dacă lipsesc.

CopiazăCopiat ✓{
  "name": "Tricou bumbac organic",
  "sku": "TRI-BMB-01",
  "price": 99.90,
  "vat_rate": 21,
  "stock_quantity": 50,
  "status": "active"
}

Un produs cu relațiile complete (brand, categorie, variante, imagini, etichete).

Actualizează câmpurile produsului (oricare de mai sus, fără „type"). Minim un câmp.

Actualizează doar prețurile. Trimite cel puțin un câmp.

Actualizează prețuri în masă, după id SAU sku. Răspuns: {updated, not_found}.

CopiazăCopiat ✓{
  "items": [
    { "id": 12, "price": 89.90 },
    { "sku": "TRI-BMB-01", "sale_price": 79.90 }
  ]
}

Setează stocul absolut („quantity") sau aplică o ajustare relativă („delta").

CopiazăCopiat ✓{ "delta": -3 }

Stoc în masă. Fiecare element: id|sku, opțional variant_id|variant_sku, plus quantity sau delta.

CopiazăCopiat ✓{
  "items": [
    { "sku": "TRI-BMB-01", "quantity": 40 },
    { "id": 18, "delta": 5 }
  ]
}

Listă cu stocurile tuturor produselor (filtru search, paginare).

Listă paginată de comenzi (paginare per_page/page, filtru search/status).

Creează o comandă. Clientul: „customer_id" existent SAU obiect „customer" (creat după email). Minim o linie în „items".

CopiazăCopiat ✓{
  "customer": { "name": "Ion Popescu", "email": "ion@exemplu.ro", "phone": "0712345678" },
  "payment_status": "paid",
  "items": [
    { "sku": "TRI-BMB-01", "quantity": 2, "unit_price": 99.90 }
  ]
}

O comandă cu liniile, totalurile, clientul, AWB-ul și factura.

Actualizează comanda. Schimbarea de „status" trece prin fluxul intern (istoric + notificări). Minim un câmp.

CopiazăCopiat ✓{ "status": "confirmed", "note": "Confirmată telefonic" }

Generează AWB pentru comandă. Idempotent — dacă există deja AWB, îl returnează. Dacă nu ai curier conectat, se emite un AWB local de test.

CopiazăCopiat ✓{ "courier": "sameday", "weight": 1.2, "parcels": 1 }

Emite factura comenzii. Fără corp. Idempotent — dacă factura există deja, o returnează (status 200).

Listă paginată de clienți (filtru search).

Un client cu datele complete.

Actualizează datele clientului.

Listă de etichete (filtru search).

Creează o etichetă.

Redenumește / recolorează eticheta.

Șterge eticheta.

Atașează eticheta la produse.

CopiazăCopiat ✓{ "product_ids": [12, 18, 25] }

Detașează eticheta de la produse (același corp ca attach).

Arborele de categorii al catalogului.

O categorie.

Listă de cereri de retur.

O cerere de retur cu liniile ei.

Listă de oferte pe marketplace-uri.

O ofertă.

Marketplace-urile conectate (fără credențiale).

Curierii configurați.

Software-urile de facturare conectate.

Magazinele online conectate.

Depozitele / fulfillment-urile disponibile.

Lista de valute.

Lista de limbi.

Lista de țări.