Sari la conținut
MommyHAI

Vinzi prin MommyHAI direct din sistemul tău.

Îți trimiți singur produsele și stocurile, iar comenzile plătite îți ajung în secunde. Fără introducere manuală și fără fișiere pe email.

primul apel: confirmă cheia
# un cont fără produse răspunde cu o listă goală
curl https://web.mommyhai.com/api/v1/partner/products \
  -H "Authorization: Bearer mhk_cheia_ta" \
  -H "Accept: application/json"

200 OK
{ "data": [] }

# și o comandă plătită, așa cum ți-o trimitem
{
  "event": "order.processing",
  "order": {
    "order_id": 5441,
    "delivery_date": "2026-11-14",
    "delivery_slot": "07:00-09:00",
    "total": "50.00"
  }
}

De la cheie la prima comandă

Patru pași, în ordinea asta. Primul produs pe care îl trimiți e o probă nepublicată, ca să nu apară nimic în magazin până nu ești gata.

  1. Cere cheia

    Primești o cheie API și, dacă vrei notificări de comandă, un secret de semnare. Se transmit o singură dată, pe canal securizat.

  2. Fă primul apel

    Un GET /products confirmă cheia. Apoi trimiți un produs TEST-… cu is_active: false.

  3. Trimite catalogul

    Cu PUT /products, în loturi. SKU-ul tău e identitatea produsului: același SKU actualizează, nu dublează.

  4. Primește și închide comenzi

    Comenzile plătite vin pe adresa ta de webhook. Le marchezi livrate, cu AWB, și atașezi factura.

Ce poți face prin API

Toate apelurile sunt pe HTTPS, cu cheia ta în antet. Limita e de 60 de cereri pe minut, pe cheie.

Produse și stoc

Creezi și actualizezi produse în masă, cu alergeni și valori nutriționale la alimente. Stocul și prețul au un apel scurt, pentru schimbări dese.

  • PUT/products
  • PATCH/products/{sku}
  • GET/products

Comenzi și factură

Vezi doar comenzile cu produsele tale. Schimbi statusul, treci AWB-ul și linkul de urmărire și atașezi factura PDF.

  • GET/orders
  • PATCH/orders/{id}
  • POST/orders/{id}/invoice

Notificare la comandă

Nu trebuie să întrebi periodic. Trimitem noi comanda pe adresa ta, semnată criptografic, la fiecare schimbare de status.

  • HOOKorder.processing
  • HOOKorder.completed
  • HOOKorder.cancelled

Alege cum te conectezi

API-ul e pentru catalog mare și stoc care se mișcă des. Celelalte variante cer mai puțin de la echipa ta tehnică și se pot schimba oricând.

A

Ne trimiți tu, prin API

Sistemul tău apelează API-ul când se schimbă ceva. Pentru peste 30 de produse și stoc care se mișcă în timpul zilei.

B

Citim noi de la tine

Ne dai adresa feed-ului sau accesul de citire la magazinul tău, iar noi îl citim periodic.

C

Trimiți un fișier

Un CSV cu produsele, pe care îl importăm noi. Pentru cataloage care se schimbă rar.

D

Din panou, manual

Primești un cont și adaugi produsele din browser. Pentru sub 30 de produse.

Cinci lucruri de știut înainte de primul apel

Sunt cele care costă cel mai mult dacă le afli din producție.

  • Nu există mediu de testUn produs nu se șterge prin API. Fă proba cu is_active: false și un SKU TEST-….
  • Livrează doar la processingGET /orders fără status întoarce și comenzi neplătite sau rambursate. Cere status=processing.
  • total nu include transportulDe încasat pentru un rând: total plus shipping_total.
  • Un 200 la produse nu înseamnă „e în magazin”Sincronizarea cu magazinul poate eșua fără semnal. Deschide câteva produse după fiecare lot.
  • Statusul e al comenzii întregiPe o comandă cu mai mulți furnizori, un status pus de tine se aplică tuturor. Nu anula fără să ne scrii.

Cere o cheie API

Scrie-ne cine ești, ce sistem folosești și cam câte produse ai. Îți răspundem în aceeași zi lucrătoare.

hai@mommyhai.com