URL de bază
https://{tenant}.logzi.com/api/compensate/
Fiecare cerere returnează un răspuns JSON. În caz de succes result.code == 1, în caz de eroare result.code == 0. Compensarea reprezintă înregistrarea plății unui document (factură sau bon de casă).
/api/compensate/get
Preluarea unei singure compensări, pe baza identificatorului, împreună cu datele documentului asociat.
Parametri de interogare
| Parametru | Tip | Obligatoriu | Descriere |
|---|---|---|---|
id | int | Identificatorul unic al compensării |
Exemplu de cerere
GET /api/compensate/get?id=55
X-API-KEY: {cheia_dvs_api}
/api/compensate/list
Preluarea listei paginate de compensări, cu opțiuni de filtrare.
Parametri de interogare
| Parametru | Tip | Obligatoriu | Descriere |
|---|---|---|---|
list_offset | int | Decalajul paginării (implicit: 0) | |
list_condition[search_text] | string | Căutare liberă după numărul documentului și numele partenerului | |
list_condition[partner_company_name] | string | Filtrare după numele partenerului (LIKE) | |
list_condition[receipt_identify] | string | Filtrare după numărul documentului (LIKE) | |
list_condition[invoice_receipt_type_id] | int | Filtrare după tipul documentului | |
list_condition[invoice_receipt_id] | int | Filtrare după identificatorul documentului | |
list_condition[company_id] | int | Identificatorul companiei (implicit: 1) |
Exemplu de cerere
GET /api/compensate/list?list_offset=0&list_condition[partner_company_name]=Minta
X-API-KEY: {cheia_dvs_api}
/api/compensate/save
Înregistrarea unei compensări pentru un document existent (factură sau bon de casă). Documentul poate fi identificat prin numărul documentului, numărul comenzii clientului sau adresa de e-mail.
Câmpuri POST — obiectul data
| Câmp | Tip | Obligatoriu | Descriere |
|---|---|---|---|
receipt_id | int | 0 = compensare nouă (cu identificator existent), >0 = modificare | |
amount | float | Suma compensată | |
company_user_id | int | Identificatorul angajatului care înregistrează | |
identify_invoice | string | Numărul facturii (dacă se caută pe baza facturii) | |
identify_customer | string | Numărul comenzii clientului (dacă se caută pe baza comenzii) | |
customer_email | string | Adresa de e-mail a clientului (dacă se caută pe baza e-mailului) | |
parcel_number | string | Numărul coletului (dacă se caută pe baza expedierii) |
Exemplu de cerere
POST /api/compensate/save
X-API-KEY: {cheia_dvs_api}
Content-Type: application/json
{
"data": {
"receipt_id": 0,
"amount": 127000,
"company_user_id": 3,
"identify_invoice": "2024/00123"
}
}
/api/compensate/delete
Ștergerea unei compensări. După ștergere, documentul asociat va fi considerat din nou deschis.
Câmpuri POST — obiectul data
| Câmp | Tip | Obligatoriu | Descriere |
|---|---|---|---|
receipt_id | int | Identificatorul compensării de șters |
Exemplu de cerere
POST /api/compensate/delete
X-API-KEY: {cheia_dvs_api}
Content-Type: application/json
{ "data": { "receipt_id": 55 } }
Ești interesat de software-ul nostru? Scrie-ne cu încredere!
Dacă nu găsești răspunsul și ai nevoie de asistență
Creează-ți contul acum,
plătește mai târziu!