Înregistrare Autentificare

API Facturi

Gestionarea facturilor emise — preluare, creare, modificare, închidere și integrare NAV

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/invoice/

Endpointul de facturi gestionează facturile emise, facturile de avans, facturile manuale și proformele. Fiecare cerere returnează un răspuns JSON. În caz de succes result.code == 1, în caz de eroare result.code == 0.

GET /api/invoice/get

Preluarea unei singure facturi emise pe baza identificatorului, cu detalii complete (poziții, partener, totaluri).

Parametri de query

Parametru Tip Obligatoriu Descriere
id int Identificatorul unic al facturii
identify string Poate fi preluată și pe baza identificatorului (de ex. SZ-2024-0042)

Exemplu de cerere

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

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 42,
    "identify": "SZ-2024-0042",
    "date_create": "2024-05-01 10:00:00",
    "date_perform": "2024-05-10",
    "date_pay": "2024-05-24",
    "status_id": 1,
    "partner_company_name": "Minta Kft.",
    "price_brutto": 127000,
    "price_netto": 100000,
    "price_tax": 27000,
    "currency_name": "HUF",
    "item": [
      {
        "product_id": 5,
        "quantity": 2,
        "price": 50000,
        "price_brutto": 63500
      }
    ]
  }
}
GET /api/invoice/list

Preluarea paginată a listei facturilor emise, cu opțiuni de filtrare și sortare.

Parametri de query

Parametru Tip Obligatoriu Descriere
list_offset int Decalajul de paginare (implicit: 0)
list_count int Numărul de rezultate pe pagină (implicit: 10)
list_sort[field] string Numele câmpului de sortare
list_sort[sort] string ASC sau DESC
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[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)
list_condition[partner_id] int Filtrare după ID-ul partenerului

Exemplu de cerere

GET /api/invoice/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": 42,
      "identify": "SZ-2024-0042",
      "date_create": "2024-05-01",
      "date_pay": "2024-05-24",
      "status_name": "Nyitott",
      "partner_company_name": "Minta Kft.",
      "price_brutto": 127000
    }
  ],
  "params": {
    "list_count": 10,
    "list_offset": 0,
    "list_all": 156
  }
}
POST /api/invoice/save

Creare sau modificare a unei facturi emise. Pentru o factură 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 = factură nouă, >0 = modificare
company_id int Identificatorul companiei
company_user_id int ID-ul angajatului responsabil
company_address_id int ID-ul punctului de lucru al companiei
currency_id int Identificatorul monedei
date_perform date Data prestației (YYYY-MM-DD)
partner_id int Identificatorul partenerului/clientului
partner_shipping_id int ID-ul adresei de livrare a partenerului
date_pay date Termenul de plată (YYYY-MM-DD)
paymod_id int Identificatorul modalității de plată
comment_top string Observație de antet afișată pe factură
comment_bottom string Observație de subsol afișată pe factură
jobnumber_id int Identificatorul numărului de lucrare
project_id int Identificatorul proiectului
item array Vectorul de poziții — este necesară cel puțin o poziție (vezi mai jos)

Câmpurile poziției — data[item][]

Câmp Tip Obligatoriu Descriere
product_id int Identificatorul produsului
quantity float Cantitate
price float Preț unitar net
tax_id int Identificatorul cotei de TVA
price_discount float Procentul de discount
remove int 1 = ștergerea poziției la modificare

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/invoice/save
X-API-KEY: {cheia_dvs_api}
Content-Type: application/json

{
  "data": {
    "id": 0,
    "company_id": 1,
    "company_user_id": 3,
    "company_address_id": 1,
    "currency_id": 1,
    "partner_id": 12,
    "date_perform": "2024-06-15",
    "date_pay": "2024-06-29",
    "paymod_id": 2,
    "comment_top": "Köszönjük a megrendelést!",
    "item": [
      {
        "product_id": 5,
        "quantity": 2,
        "price": 50000,
        "tax_id": 2
      }
    ]
  },
  "params": {
    "close": 0,
    "download": 0
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 43,
    "identify": "SZ-2024-0043"
  }
}
POST /api/invoice/delete

Ștergerea unei facturi emise. Se poate șterge doar o factură deschisă (status_id = 1).

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
receipt_id int Identificatorul facturii de șters

Exemplu de cerere

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

{
  "data": {
    "receipt_id": 42
  }
}

Exemplu de răspuns

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

Închiderea unei facturi emise deschise. La închidere factura este finalizată și poate fi raportată către NAV (Online Számla). Se poate închide doar o factură cu status_id = 1 (deschisă).

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
receipt_id int Identificatorul facturii de închis

Exemplu de cerere

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

{
  "data": {
    "receipt_id": 42
  }
}

Exemplu de răspuns

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

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

Parametri de query

Parametru Tip Obligatoriu Descriere
receipt_id int Identificatorul facturii
file_type string Formatul de ieșire (vezi mai jos)
language string Numele folderului de limbă al șablonului (de ex. hungarian)
language_id int Identificatorul limbii (pentru căutare pe bază de ID)
template_id int ID-ul șablonului de tipărire personalizat

Valorile posibile pentru file_type

Valoare Descriere
pdf Returnarea PDF-ului codificat base64 cu metadate
pdf-string Identic cu pdf — string base64 + metadate
pdf-string-sample Generare PDF de previzualizare
stream Stream direct de fișier (descărcare în browser)

Exemplu de cerere

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

Exemplu de răspuns (file_type=pdf)

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "name": "SZ-2024-0042.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