Înregistrare Autentificare

API Registru parteneri

Gestionarea partenerilor (clienți, furnizori) — obținere, creare și modificare

Puncte finale

GET Obținere entitate
GET Obținere listă
POST Salvare / creare
POST Ștergere

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.

URL de bază

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

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

GET /api/partner/get

Obținerea unui singur partener pe baza identificatorului, denumirii companiei sau codului fiscal, cu detalii complete (adresă, persoane de contact).

Parametri de query

Parametru	Tip	Descriere
`id`	int	Identificatorul unic al partenerului
`company_name`	string	Denumirea companiei (căutare LIKE)
`taxcode`	string	Căutare pe baza codului fiscal
`identify`	string	Cod de identificare unic
`full`	int	1 = cu date complete (tranzacții, statistici)

Exemplu de cerere

GET /api/partner/get?id=42
X-API-KEY: {cheia_dvs_api}

GET /api/partner/list

Obținerea listei paginate de parteneri, cu posibilități de filtrare.

Parametri de query

Parametru	Tip	Descriere
`list_offset`	int	Decalajul de paginare (implicit: 0)
`list_count`	int	Numărul de înregistrări afișate pe pagină
`list_condition[company_name]`	string	Filtrare după denumirea companiei (LIKE)
`list_condition[taxcode]`	string	Filtrare după codul fiscal
`list_condition[bank_account]`	string	Filtrare după contul bancar
`list_condition[company_email]`	string	Filtrare după adresa de e-mail (LIKE)
`list_condition[partner_user_telephone]`	string	Filtrare după numărul de telefon

Exemplu de cerere

GET /api/partner/list?list_offset=0&list_condition[company_name]=Kft
X-API-KEY: {cheia_dvs_api}

POST /api/partner/save

Creare sau modificare partener. Pentru un partener nou data[id] = 0.

Câmpuri POST — obiectul data

Câmp	Tip	Descriere
`id`	int	0 = partener nou, >0 = modificare
`company_name`	string	Denumirea companiei / numele partenerului
`type_id`	int	Identificatorul tipului de partener (client, furnizor etc.)
`legal_entity_type_id`	int	Tipul entității juridice
`paymod_id`	int	Identificatorul modalității de plată implicite
`taxcode`	string	Cod fiscal intern
`taxcode_international`	string	Cod TVA comunitar (EU VAT)
`taxcode_group`	string	Cod fiscal de grup
`bank_account`	string	Cont bancar
`iban`	string	Cont bancar IBAN
`swift`	string	Cod SWIFT/BIC
`registration_number`	string	Număr de înregistrare la registrul comerțului
`company_email`	string	Adresa de e-mail a companiei
`identify`	string	Cod de identificare unic — dacă este gol, sistemul îl generează automat
`enolve_id`	string	Identificator din sistem extern
`pay_limit`	float	Valoarea plafonului de credit (implicit: 0)
`language_id`	int	Identificatorul limbii
`currency_out_id`	int	Valuta documentelor emise (ieșire)
`currency_in_id`	int	Valuta documentelor primite (intrare)
`tax_id`	int	Identificatorul șablonului de TVA implicit pentru ieșire
`tax_in_id`	int	Identificatorul șablonului de TVA implicit pentru intrare
`ledger_number_in_id`	int	Identificatorul contului contabil de intrare
`ledger_number_out_id`	int	Identificatorul contului contabil de ieșire
`commission_percent`	float	Procent de comision (implicit: 0)
`relationship_id`	int	Identificatorul tipului de relație
`satisfaction_id`	int	Identificatorul nivelului de satisfacție
`source_id`	int	Identificatorul sursei (originea lead-ului)
`loss_reason`	string	Motivul pierderii
`paymod_forbidden`	object	Modalități de plată interzise — obiect cheie-valoare (ex. `{"1": true, "3": true}`), cheile se stochează separate prin virgulă
`sms_enable`	int	Trimitere SMS activată (0 = nu, 1 = da). Implicit: 0. Dacă nu este specificat, valoarea existentă rămâne neschimbată
`email_enable`	int	Trimitere e-mail activată (0 = nu, 1 = da). Implicit: 1. Dacă nu este specificat, valoarea existentă rămâne neschimbată
`address`	array	Tablou de adrese (vezi mai jos)
`user`	array	Tablou de persoane de contact (vezi mai jos)

Câmpuri de adresă — data[address][]

Câmp	Tip	Descriere
`partner_address_id`	int	0 = adresă nouă, >0 = modificarea unei adrese existente
`country_id`	int	Identificatorul țării
`zip`	string	Cod poștal
`city`	string	Oraș
`address`	string	Stradă, număr
`partner_address_type_id`	int	Identificatorul tipului de adresă (facturare, livrare etc.)
`partner_address_status_id`	int	Identificatorul stării adresei
`address_user_name`	string	Numele destinatarului
`address_number`	string	Număr (max 50 caractere)
`address_building`	string	Clădire (max 50 caractere)
`address_stairwell`	string	Scară (max 50 caractere)
`address_floor`	string	Etaj (max 50 caractere)
`address_door`	string	Ușă (max 50 caractere)
`district`	string	Sector / cartier
`address_comment`	string	Observație pentru adresă
`remove`	int	1 = marcarea adresei pentru ștergere

Câmpuri persoană de contact — data[user][]

Câmp	Tip	Descriere
`partner_user_id`	int	0 = persoană de contact nouă, >0 = modificarea uneia existente
`name`	string	Numele persoanei de contact
`email`	string	Adresă de e-mail
`telephone`	string	Număr de telefon
`partner_user_status_id`	int	Identificatorul stării
`invocation`	string	Formulă de adresare / titlu
`fax`	string	Număr de fax
`remove`	int	1 = marcarea persoanei de contact pentru ștergere

Exemplu de cerere

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

{
  "data": {
    "id": 0,
    "company_name": "Minta Kft.",
    "type_id": 1,
    "legal_entity_type_id": 1,
    "paymod_id": 1,
    "taxcode": "12345678-2-41",
    "taxcode_international": "HU12345678",
    "bank_account": "12345678-12345678-12345678",
    "iban": "HU42117730161111101800000000",
    "registration_number": "01-09-123456",
    "company_email": "info@minta.hu",
    "pay_limit": 500000,
    "currency_out_id": 1,
    "address": [
      {
        "partner_address_id": 0,
        "country_id": 1,
        "zip": "1234",
        "city": "Budapest",
        "address": "Fő utca 1.",
        "partner_address_type_id": 1,
        "partner_address_status_id": 1
      }
    ],
    "user": [
      {
        "partner_user_id": 0,
        "name": "Minta János",
        "email": "janos@minta.hu",
        "telephone": "+36301234567",
        "partner_user_status_id": 1,
        "invocation": "Tisztelt Uram",
        "fax": ""
      }
    ]
  }
}

POST /api/partner/delete

Ștergerea unui partener (ștergere logică). Poate fi șters doar un partener fără document activ asociat.

Câmpuri POST — obiectul data

Câmp	Tip	Obligatoriu	Descriere
`id`	int		Identificatorul partenerului de șters

Exemplu de cerere

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

{ "data": { "id": 42 } }

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!

Înregistrare