Înregistrare Autentificare

API Relații cu Clienții

Gestionarea înregistrărilor CRM și a relațiilor cu clienții — preluare, creare, modificare, închidere și descărcare

Endpointuri

Autentificare

Fiecare cerere API necesită trimiterea header-ului X-API-KEY.

X-API-KEY: {cheia_dvs_api}

Mai ai întrebări?

Trimite-ne un tichet, sau caută în motorul nostru de căutare.

Dacă ți-a plăcut, distribuie-l și altora

URL de bază

https://{tenant}.logzi.com/api/crm/

Fiecare cerere returnează un răspuns JSON. În caz de succes result.code == 1, în caz de eroare result.code == 0.

GET /api/crm/get

Preluarea unei singure înregistrări CRM pe baza identificatorului, cu detalii complete.

Parametri de query

Parametru Tip Obligatoriu Descriere
id int Identificatorul unic al înregistrării CRM

Exemplu de cerere

GET /api/crm/get?id=15
X-API-KEY: {cheia_dvs_api}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 15,
    "identify": "CRM-2024-0015",
    "date_create": "2024-05-01 10:00:00",
    "date_perform": "2024-05-10",
    "status_id": 1,
    "subject": "Ügyféltárgyalás",
    "partner_company_name": "Minta Kft.",
    "company_user_name": "Kovács János",
    "crm_source_name": "Telefon",
    "comment_top": "Előzetes egyeztetés.",
    "comment_bottom": "Belső megjegyzés."
  }
}
GET /api/crm/list

Preluarea paginată a listei înregistrărilor CRM, cu opțiuni de filtrare.

Parametri de query

Parametru Tip Obligatoriu Descriere
list_offset int Decalajul de paginare (implicit: 0)
list_condition[identify] string Filtrare după identificator (LIKE)
list_condition[company_name] string Filtrare după numele partenerului (LIKE)
list_condition[status_id] int Filtrare după status (1=deschis, 2=închis)
list_condition[crm_source_id] int Filtrare după identificatorul sursei
list_condition[company_user_id] int Filtrare după ID-ul angajatului responsabil
list_condition[date_create_from] date Data creării — de la (YYYY-MM-DD)
list_condition[date_create_to] date Data creării — până la (YYYY-MM-DD)

Exemplu de cerere

GET /api/crm/list?list_offset=0&list_condition[status_id]=1
X-API-KEY: {cheia_dvs_api}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": [
    {
      "id": 15,
      "identify": "CRM-2024-0015",
      "date_create": "2024-05-01",
      "status_name": "Nyitott",
      "subject": "Ügyféltárgyalás",
      "partner_company_name": "Minta Kft."
    }
  ],
  "params": {
    "list_count": 10,
    "list_offset": 0,
    "list_all": 42
  }
}
POST /api/crm/save

Creare sau modificare a unei înregistrări CRM. Pentru o înregistrare nouă folosiți data[id] = 0, pentru modificare specificați ID-ul existent.

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
id int 0 = înregistrare CRM nouă, >0 = modificare
company_id int Identificatorul companiei
company_user_id int ID-ul angajatului responsabil
partner_id int Identificatorul partenerului/clientului
crm_source_id int Identificatorul sursei
subject string Subiect
date_perform datetime Data prestației (YYYY-MM-DD HH:MM:SS)
comment_top string Observație vizibilă pentru client
comment_bottom string Observație internă
status_id int Identificatorul statusului

Câmpuri POST — obiectul params (opțional)

Câmp Tip Obligatoriu Descriere
close int 1 = închidere automată după salvare
download int 1 = generare PDF după salvare

Exemplu de cerere

POST /api/crm/save
X-API-KEY: {cheia_dvs_api}
Content-Type: application/json

{
  "data": {
    "id": 0,
    "company_id": 1,
    "company_user_id": 3,
    "partner_id": 12,
    "crm_source_id": 2,
    "subject": "Termékbemutató egyeztetés",
    "date_perform": "2024-06-20 14:00:00",
    "comment_top": "Ügyfél érdeklődik az új termékcsalád iránt.",
    "status_id": 1
  },
  "params": {
    "close": 0,
    "download": 0
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 16,
    "identify": "CRM-2024-0016"
  }
}
POST /api/crm/delete

Ștergerea unei înregistrări CRM. Se poate șterge doar o înregistrare cu status deschis.

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
receipt_id int Identificatorul înregistrării CRM de șters

Exemplu de cerere

POST /api/crm/delete
X-API-KEY: {cheia_dvs_api}
Content-Type: application/json

{
  "data": {
    "receipt_id": 15
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}
POST /api/crm/close

Închiderea unei înregistrări CRM deschise. Se poate închide doar o înregistrare cu status_id = 1 (deschisă).

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
receipt_id int Identificatorul înregistrării CRM de închis

Exemplu de cerere

POST /api/crm/close
X-API-KEY: {cheia_dvs_api}
Content-Type: application/json

{
  "data": {
    "receipt_id": 15
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}
GET /api/crm/download

Descărcarea/generarea documentului înregistrării CRM în diferite formate (PDF, string base64, stream).

Parametri de query

Parametru Tip Obligatoriu Descriere
receipt_id int Identificatorul înregistrării CRM
file_type string Format de ieșire: pdf, pdf-string, stream
language string Numele folderului de limbă al șablonului (de ex. hungarian)
template_id int ID-ul șablonului de tipărire personalizat

Exemplu de cerere

GET /api/crm/download?receipt_id=15&file_type=pdf
X-API-KEY: {cheia_dvs_api}

Exemplu de răspuns (file_type=pdf)

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "name": "CRM-2024-0015.pdf",
    "content": "JVBERi0xLjQK...",
    "receipt": { ... }
  }
}

Ia legătura cu noi

Ești interesat de software-ul nostru? Scrie-ne cu încredere!

Trimite o solicitare

Ai nevoie de ajutor?

Dacă nu găsești răspunsul și ai nevoie de asistență

Răsfoiește centrul de ajutor

Creează-ți contul acum,
plătește mai târziu!

Încearcă gratuit timp de 3 zile, fără riscuri și fără obligații!
Creare cont
Înregistrare