Cuprinsul documentației

Ghid de integrare

Exemple JavaScript, Python și Postman

Descarcă exemplele din secțiunea Resurse. Rulează-le pe serverul tău, cu MEREU_API_URL=https://mereu.md/api/v1 și cheia în MEREU_API_KEY.

FișierRol
mereu-client.mjs / mereu-client.pyAutentificare, cereri și codificarea parametrilor GET.
crm-sync.mjs / crm-sync.pyO pagină de export sau modificări, cu un cursor salvat durabil.
pos-checkout.mjsRezervare, confirmarea vânzării, import și retur.
mereu-postman.jsonCereri manuale cu referințe, UUID-uri și sume de completat.

Pentru importuri Python, redenumește modulele în mereu_client.py și crm_sync.py. În numele modulelor Python nu se folosesc cratime.

  • CRM: citește starea salvată și apelează syncMereuPage(api, resource, state, commitPage) sau sync_mereu_page(api.request, resource, state, commit_page).
  • state=null / None începe exportul. Funcția procesează O SINGURĂ pagină și returnează phase și cursor.
  • În callback, resetează setul intermediar la reset=true, adaugă rândurile neșterse și înlocuiește setul activ numai la complete=true. În modul changes, aplică inserările/actualizările/ștergerile.
  • Salvează cursorul împreună cu datele, într-o singură tranzacție. Lasă erorile de salvare să se propage. Planifică pagina următoare în coada ta de lucrări, în limita de cereri.
  • POS: prepareCheckout trimite doar preview, rezervare și payment-started, prin callbackul tău durabil persist.
  • Furnizează UUID-urile din comanda salvată. Începe plata în sistemul tău numai după succesul funcției și salvarea jurnalului.
  • După verificarea plății, apelează commitVerifiedPayment. Pentru importuri achitate folosește recordVerifiedPurchase; pentru retururi verificate, recordVerifiedReturn.
  • Un eșec al jurnalului după răspuns poate însemna că operația s-a aplicat deja. Recuperează cererea salvată și verifică starea înainte să o repeți.

În Postman completează variabilele goale și sumele numerice întregi. La commit, copiază expected_paid_total din ofertă și revizia din payment-started. La retur, folosește alocarea eligibilă inițială și banii real restituiți.