Cuprinsul documentației

Ghid de integrare

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 sincronizeziPermisiune
/data/customersIdentitatea locală, numele, datele de contact disponibile și acordul de marketing.customers:read
/data/cardsCarduri, program, stare și soldurile calculate la citire.cards:read
/data/transactionsOperațiunile aplicate în Casa/POS și valorile expuse ale beneficiilor.transactions:read
  1. Începe fiecare resursă cu mode=snapshot&limit=100. Citește toate paginile folosind next_cursor până devine null.
  2. Salvează paginile într-un set intermediar. Înlocuiește setul activ din CRM numai după terminarea exportului.
  3. Păstrează sync_cursor al exportului inițial. Cere apoi ACEEAȘI resursă cu mode=changes și acel cursor.
  4. Aplică modificările în ordinea paginilor: actualizează sau inserează după ID; pentru operation=delete, șterge după record_id.
  5. 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.