Integrarea CRM: export și sincronizare
CRM-ul preia datele din Mereu prin cereri GET. Nu există creare sau modificare de clienți prin acest API.
| Resursă | Ce sincronizezi | Permisiune |
|---|---|---|
| /data/customers | Identitatea locală, numele, datele de contact disponibile și acordul de marketing. | customers:read |
| /data/cards | Carduri, program, stare și soldurile calculate la citire. | cards:read |
| /data/transactions | Operațiunile aplicate în Casa/POS și valorile expuse ale beneficiilor. | transactions:read |
- Începe fiecare resursă cu
mode=snapshot&limit=100. Citește toate paginile folosindnext_cursorpână devinenull. - Salvează paginile într-un set intermediar. Înlocuiește setul activ din CRM numai după terminarea exportului.
- Păstrează
sync_cursoral exportului inițial. Cere apoi ACEEAȘI resursă cumode=changesși acel cursor. - Aplică modificările în ordinea paginilor: actualizează sau inserează după ID; pentru
operation=delete, șterge dupărecord_id. - Salvează datele și noul cursor în ACEEAȘI tranzacție a bazei CRM. La un eșec al salvării, reia de la cursorul salvat anterior.
La 410 CURSOR_EXPIRED, pornește un export complet nou și înlocuiește setul local. Dacă se schimbă autorizarea sau conexiunea, refă exportul și elimină datele la care nu mai ai acces. Nu există cotă totală de rânduri exportate; respectă limita de cereri.
Modificările descriu starea curentă, nu un jurnal istoric imuabil. Un eveniment repetat poate avea un conținut mai nou: nu ignora corpul doar fiindcă ai văzut același event_id. Procesează secvențial și aplică operation=delete / deleted=true, inclusiv ștergerea contactelor locale.
Exportul citește rândurile curente; modificările de după punctul său de pornire acoperă și actualizările din timpul paginării. Tranzacțiile încă nefinalizate pot întârzia temporar vizibilitatea schimbărilor. changed_at nu este un număr de versiune.
customer.id este UUID-ul cardului în această afacere. Nu uni automat persoane din afaceri diferite. În istoricul contabil, id și original_id sunt ID-uri native; numai financial_transaction_id, dacă nu este null, funcționează la endpointurile financiare de tranzacție și retur. Operațiunile făcute de echipă pot să nu aibă acest ID.
Verifică periodic /account pentru moneda și fusul orar curente. Păstrează asocierile CRM în sistemul tău; /resource-links este retras (410). Nu include date de contact în identificatori sau loguri.