Facturis Online API
Automatizează emiterea facturilor, gestiunea avizelor, a clienților și produselor prin API-ul REST Facturis Online. Toate cererile se fac prin POST sau GET către un singur endpoint, transmițând parametrii ca string JSON.
Afișare Produse
Returnează lista de produse din Nomenclatorul de Produse al contului. Apelul fără parametri de filtrare returnează toate produsele active. Pentru căutare punctuală se folosesc parametrii <code>prod_cod_cautare</code> și <code>prod_cautare_valoare</code>.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru produse:
Produse.act
Acțiune. Pentru afișare:
Get.prod_cod_cautare
Criteriul după care se face căutarea:
Denumire · Cod_EAN · Cod_SKU · Alt_Cod · prod_key.prod_cautare_valoare
Valoarea efectivă care este căutată pe câmpul specificat în
prod_cod_cautare.💡 Sfat
Pentru căutare punctuală combină cei doi parametri:
prod_cod_cautare: "Cod_EAN" + prod_cautare_valoare: "5941234567890". Câmpul Id din răspuns corespunde lui prod_key folosit la Upd și Del.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Produse",
"act": "Get"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Produse", "act" => "Get", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Produse", "act": "Get" }'
200 OK { "success": 2000, "result": [ { "Id": "169710", "Denumire": "Ciocolata Poiana amaruie 100 gr", "Tip": "produs", "Categorie": "Bacanie - Dulciuri", "Cod_EAN": "", "Cod_SKU": null, "Alt_Cod": null, "UM": "BUC", "Pretul_fara_TVA": null, "Pret_cu_TVA": "3.50000", "Moneda": "RON", "Observatii1": "", "Observatii2": "", "Observatii3": "", "Cota_TVA": "" }, { "Id": "169711", "Denumire": "Ciocolata Poiana Ananas 100 gr", "Tip": "produs", "Categorie": "Bacanie - Dulciuri", "Cod_EAN": "", "Cod_SKU": null, "Alt_Cod": null, "UM": "BUC", "Pretul_fara_TVA": null, "Pret_cu_TVA": "3.50000", "Moneda": "RON", "Observatii1": "", "Observatii2": "", "Observatii3": "", "Cota_TVA": "" } ] }
Adăugare Produs
Adaugă un produs nou în Nomenclatorul de Produse. Identificarea produsului se face automat după codul EAN, SKU sau alt cod, în funcție de configurarea contului. Dacă produsul există deja, se actualizează informațiile, în caz contrar este creat ca înregistrare nouă.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru produse:
Produse.act
Acțiune. Pentru inserare:
Ins.Identificare produs
prod_key
Identificator intern al produsului. Folosit pentru referențiere unică în sistem.
prod_nume
Denumirea produsului — câmp principal afișat pe documente.
prod_cod
Codul EAN (cod de bare) al produsului.
prod_sku
Codul SKU intern (Stock Keeping Unit).
prod_cod1
Cod alternativ — utilizat pentru codificări proprii sau coduri furnizor.
prod_tip
Tipul produsului:
produs · altceva · inactiv.Preț și unitate de măsură
prod_um
Unitatea de măsură (ex.
BUC, KG, L, M).prod_pret_ftva
Prețul fără TVA al produsului.
prod_pret_ctva
Prețul cu TVA al produsului. Dacă nu este specificat, se calculează automat.
fk_curs_moneda
Moneda prețului (ex.
RON, EUR, USD).fk_cote_tva_nume
Cota de TVA aplicată (ex.
19%, 9%, 5%, 0%).Observații (opțional)
prod_obs1
Câmp de observații 1 — utilizat pentru note suplimentare despre produs.
prod_obs2
Câmp de observații 2.
prod_obs3
Câmp de observații 3.
prod_obs4
Câmp de observații 4.
prod_obs5
Câmp de observații 5.
prod_obs6
Câmp de observații 6.
💡 Sfat
Câmpul
prod_pret_ctva este opțional — dacă nu îl trimiți, sistemul îl calculează automat pe baza prod_pret_ftva și a cotei de TVA. Pentru produse fără TVA folosește fk_cote_tva_nume: "0%".⚠️ Atenție
Identificarea produselor existente se face după
prod_cod (EAN), prod_sku sau prod_cod1. Dacă trimiți un produs cu un cod care există deja în Nomenclator, înregistrarea existentă va fi actualizată în loc să se creeze una nouă.{
"APIkey": "123456789",
"u": "admin",
"p": "parola123",
"c": "ro 31234567",
"met": "Produse",
"act": "Ins",
"prod_nume": "produs3",
"prod_cod": "cod EAN",
"prod_sku": "cod SKU",
"prod_cod1": "alt cod",
"prod_obs1": "Observatii1",
"prod_obs2": "Observatii2",
"prod_obs3": "Observatii3",
"prod_obs4": "Observatii4",
"prod_obs5": "Observatii5",
"prod_obs6": "Observatii6",
"prod_um": "BUC",
"prod_pret_ftva": "50",
"fk_curs_moneda": "RON",
"fk_cote_tva_nume": "19%",
"prod_pret_ctva": "59.5",
"prod_tip": "produs"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "parola123", "c" => "ro 31234567", "met" => "Produse", "act" => "Ins", "prod_nume" => "produs3", "prod_cod" => "cod EAN", "prod_sku" => "cod SKU", "prod_cod1" => "alt cod", "prod_obs1" => "Observatii1", "prod_obs2" => "Observatii2", "prod_um" => "BUC", "prod_pret_ftva" => "50", "fk_curs_moneda" => "RON", "fk_cote_tva_nume" => "19%", "prod_pret_ctva" => "59.5", "prod_tip" => "produs", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "parola123", "c": "ro 31234567", "met": "Produse", "act": "Ins", "prod_nume": "produs3", "prod_cod": "cod EAN", "prod_sku": "cod SKU", "prod_um": "BUC", "prod_pret_ftva": "50", "fk_curs_moneda": "RON", "fk_cote_tva_nume": "19%", "prod_pret_ctva": "59.5", "prod_tip": "produs" }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "1284593" } }
Modificare Produs
Actualizează un produs existent din Nomenclatorul de Produse. Identificarea produsului care se modifică se face strict după <code>prod_key</code> (identificatorul intern). Toate celelalte câmpuri sunt suprascrise cu valorile trimise — dacă un câmp nu este inclus în request, valoarea anterioară este păstrată.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru produse:
Produse.act
Acțiune. Pentru modificare:
Upd.Identificare produs
prod_key
Identificator intern al produsului care va fi modificat. Obligatoriu pentru acțiunea
Upd — îl obții din răspunsul la Ins sau dintr-un apel Get.prod_nume
Denumirea produsului — câmp principal afișat pe documente.
prod_cod
Codul EAN (cod de bare) al produsului.
prod_sku
Codul SKU intern (Stock Keeping Unit).
prod_cod1
Cod alternativ — utilizat pentru codificări proprii sau coduri furnizor.
prod_tip
Tipul produsului:
produs · altceva · inactiv.Preț și unitate de măsură
prod_um
Unitatea de măsură (ex.
BUC, KG, L, M).prod_pret_ftva
Prețul fără TVA al produsului.
prod_pret_ctva
Prețul cu TVA al produsului. Dacă nu este specificat, se calculează automat.
fk_curs_moneda
Moneda prețului (ex.
RON, EUR, USD).fk_cote_tva_nume
Cota de TVA aplicată (ex.
19%, 9%, 5%, 0%).Observații (opțional)
prod_obs1
Câmp de observații 1 — utilizat pentru note suplimentare despre produs.
prod_obs2
Câmp de observații 2.
prod_obs3
Câmp de observații 3.
prod_obs4
Câmp de observații 4.
prod_obs5
Câmp de observații 5.
prod_obs6
Câmp de observații 6.
⚠️ Atenție
Fără
prod_key request-ul va eșua sau, în funcție de configurație, va încerca să creeze un produs nou. Asigură-te că trimiți întotdeauna identificatorul corect al înregistrării pe care vrei să o modifici.💡 Sfat
Poți trimite doar câmpurile pe care vrei să le modifici — restul rămân neschimbate. De exemplu, pentru o simplă actualizare de preț e suficient să trimiți
prod_key, prod_pret_ftva și prod_pret_ctva.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Produse",
"act": "Upd",
"prod_key": "1342461",
"prod_nume": "produs3",
"prod_cod": "cod EAN",
"prod_sku": "cod SKU",
"prod_cod1": "alt cod",
"prod_obs1": "Observatii1",
"prod_obs2": "Observatii2",
"prod_obs3": "Observatii3",
"prod_um": "um",
"prod_pret_ftva": "50",
"fk_curs_moneda": "RON",
"fk_cote_tva_nume": "19%",
"prod_pret_ctva": "59.5",
"prod_tip": "produs"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Produse", "act" => "Upd", "prod_key" => "1342461", "prod_nume" => "produs3", "prod_cod" => "cod EAN", "prod_sku" => "cod SKU", "prod_cod1" => "alt cod", "prod_obs1" => "Observatii1", "prod_obs2" => "Observatii2", "prod_obs3" => "Observatii3", "prod_um" => "um", "prod_pret_ftva" => "50", "fk_curs_moneda" => "RON", "fk_cote_tva_nume" => "19%", "prod_pret_ctva" => "59.5", "prod_tip" => "produs", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Produse", "act": "Upd", "prod_key": "1342461", "prod_nume": "produs3", "prod_pret_ftva": "50", "fk_curs_moneda": "RON", "fk_cote_tva_nume": "19%", "prod_pret_ctva": "59.5", "prod_tip": "produs" }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "1496380" } }
Afișare Clienți
Returnează lista de clienți din baza de date a contului. Apelul fără parametri de filtrare returnează toți clienții. Pentru căutare punctuală se folosește parametrul <code>clienti_cautare</code>, care caută simultan după ID, denumire, cod fiscal sau email. Opțional, prin <code>show_pdl: "true"</code>, se pot include și punctele de livrare (PDL) asociate fiecărui client.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru clienți:
Clienti.act
Acțiune. Pentru afișare:
Get.clienti_cautare
Valoare de căutare. Filtrează simultan după
clienti_key (ID), clienti_nume (denumire), clienti_cod (cod fiscal) și clienti_email.show_pdl
Dacă are valoarea
true, fiecare client include un array pdl_client_json cu punctele de livrare (PDL) asociate.💡 Sfat
Câmpul
clienti_cautare caută în mai multe coloane deodată — poți trimite un ID numeric, o parte din denumire, codul fiscal sau adresa de email. Câmpul Id din răspuns corespunde lui clienti_key folosit la Upd.📍 Puncte de livrare (PDL)
Trimite
show_pdl: "true" pentru a primi, pentru fiecare client, un câmp suplimentar pdl_client_json — un array JSON cu punctele de livrare asociate (pdl_clienti_name, pdl_clienti_address, clienti_judet_pdl, clienti_oras_pdl, clienti_reg_pdl, clienti_id_locatie_bt_71). Clienții fără PDL returnează [].{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Clienti",
"act": "Get"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Clienti", "act" => "Get", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Clienti", "act": "Get" }'
200 OK { "success": 2000, "result": [ { "Id": "223609", "Denumire": "MIDSOFT IT GROUP S.R.L.", "CUI_CNP": "RO 19211548", "NrREG_SN": "J40 /18713 /2006", "Telefon": "456456", "Persoana": "juridica", "Sediu": "BUCURESTI, STR. GAZELEI 28C", "Judet": "MUNICIPIUL BUCURESTI", "Oras": "", "Tara": "Romania", "Email": "", "Cont": "-", "Banca": "-", "Adresa_Livrare": "", "Zile_Scadenta": "0", "Discount": "", "Observatii_Client": "", "Observatii_Factura": "" } ] }
Adăugare Client
Adaugă un client nou în baza de date. Înainte de salvare, sistemul verifică unicitatea clientului după denumire, cod fiscal și nr. de registru — dacă clientul există deja, request-ul este respins cu eroarea <code>1112</code>. Câmpurile obligatorii depind de configurarea contului (setările de câmpuri obligatorii pe factură). Opțional, se pot atașa unul sau mai multe puncte de livrare (PDL) prin array-ul <code>pdl</code>.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru clienți:
Clienti.act
Acțiune. Pentru inserare:
Ins.Date de identificare
clienti_key
Identificator intern. Lăsat gol la inserare — este generat automat de sistem.
clienti_nume
Denumirea clientului. Obligatoriu dacă
fk_facturi_nume_client este activ în setările contului.clienti_cod
Codul fiscal (CUI / CNP). Obligatoriu dacă
fk_facturi_codf_client este activ. Determină automat tipul (fizică/juridică) dacă clienti_tip lipsește.clienti_reg
Numărul de la Registrul Comerțului. Obligatoriu dacă
fk_facturi_nrreg_client este activ.clienti_tip
Tipul persoanei:
fizica · juridica. Dacă lipsește, se deduce automat din lungimea codului fiscal.clienti_card
Cod client / cod card de fidelitate.
clienti_id_furnizor
Identificator extern al clientului în sistemul furnizorului.
Date de contact și adresă
clienti_tel
Telefon de contact.
clienti_email
Adresă de email. Pot fi mai multe adrese; toate sunt validate.
clienti_sediu
Adresa sediului. Obligatoriu dacă
fk_facturi_sediu_client este activ.clienti_judet
Județul sediului. Obligatoriu dacă
fk_facturi_judet_client este activ.clienti_oras
Orașul / localitatea sediului.
clienti_tara
Țara.
Date bancare
clienti_banca
Banca. Obligatoriu dacă
fk_facturi_banca_client este activ.clienti_cont
Contul IBAN. Obligatoriu dacă
fk_facturi_cont_client este activ.Adresă de livrare
clienti_adresa_livrare
Adresa de livrare (dacă diferă de sediu).
clienti_oras_livrare
Orașul de livrare.
clienti_judet_livrare
Județul de livrare.
clienti_country_livrare
Țara de livrare.
Condiții comerciale
clienti_nr_zile
Numărul de zile de scadență la plată.
clienti_disc
Discount aplicat (ex.
5%).clienti_sold_blocare
Pragul de sold la care se blochează emiterea de documente. Trebuie să fie valoare numerică.
clienti_reference_contract
Referință / număr de contract asociat clientului.
Observații și contact suplimentar
clienti_obs
Observații afișate pe factură. Dacă nu este trimis, se salvează un spațiu gol.
clienti_obs1
Observații interne despre client (nu apar pe document).
clienti_nume_contact_bt56
Numele persoanei de contact (câmp BT-56 pentru e-Factura).
Puncte de livrare — PDL (opțional)
pdl
Array de obiecte, fiecare reprezentând un punct de livrare asociat clientului.
pdl[].pdl_clienti_name
Denumirea punctului de livrare.
pdl[].pdl_clienti_address
Adresa punctului de livrare.
pdl[].clienti_judet_pdl
Județul punctului de livrare.
pdl[].clienti_oras_pdl
Orașul punctului de livrare.
pdl[].clienti_reg_pdl
Nr. de registru asociat punctului de livrare.
pdl[].clienti_id_locatie_bt_71
Identificatorul locației (câmp BT-71 pentru e-Factura).
⚠️ Verificare unicitate
Înainte de inserare, sistemul verifică dacă clientul există deja (după denumire, cod fiscal și nr. de registru). Dacă există, primești eroarea
1112 — "Clientul exista in baza de date." și nu se creează o înregistrare duplicat.💡 Câmpuri obligatorii dinamice
Caracterul obligatoriu al câmpurilor (
clienti_nume, clienti_cod, clienti_reg, clienti_sediu, clienti_judet, clienti_banca, clienti_cont) depinde de setările contului tău (câmpurile obligatorii configurate pe factură). Dacă un câmp obligatoriu lipsește, primești eroarea 1005 — câmp necesar.📍 Puncte de livrare
Array-ul
pdl este opțional și poate conține oricâte puncte de livrare. Fiecare PDL este salvat și legat automat de clientul nou creat.⚠️ Validări suplimentare
Adresele de email sunt validate — un format invalid întoarce eroarea
1115. Câmpul clienti_sold_blocare, dacă este trimis, trebuie să fie valoare numerică, altfel întoarce eroarea 1005.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Clienti",
"act": "Ins",
"clienti_key": "",
"clienti_nume": "Client Test",
"clienti_cod": "RO 1234567",
"clienti_reg": "J00/00/0000",
"clienti_tel": "0987654321",
"clienti_tip": "juridica",
"clienti_card": "0o9i8u7y",
"clienti_email": "email@domeniu.ro",
"clienti_sediu": "Str. Pacii nr. 20",
"clienti_oras": "Bucuresti",
"clienti_tara": "Romania",
"clienti_banca": "Banca",
"clienti_judet": "",
"clienti_cont": "",
"clienti_obs": "Observatii",
"clienti_obs1": "Obs. Client",
"clienti_adresa_livrare": "Adresa",
"clienti_nr_zile": "15",
"clienti_disc": "0%",
"clienti_sold_blocare": "5000",
"clienti_reference_contract": "CTR-2026-001",
"clienti_nume_contact_bt56": "Ion Popescu",
"pdl": [
{
"pdl_clienti_name": "Depozit Central",
"pdl_clienti_address": "Str. Industriei nr. 5",
"clienti_judet_pdl": "Ilfov",
"clienti_oras_pdl": "Voluntari",
"clienti_reg_pdl": "",
"clienti_id_locatie_bt_71": ""
}
]
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Clienti", "act" => "Ins", "clienti_nume" => "Client Test", "clienti_cod" => "RO 1234567", "clienti_reg" => "J00/00/0000", "clienti_tel" => "0987654321", "clienti_tip" => "juridica", "clienti_card" => "0o9i8u7y", "clienti_email" => "email@domeniu.ro", "clienti_sediu" => "Str. Pacii nr. 20", "clienti_oras" => "Bucuresti", "clienti_tara" => "Romania", "clienti_banca" => "Banca", "clienti_obs" => "Observatii", "clienti_obs1" => "Obs. Client", "clienti_adresa_livrare" => "Adresa", "clienti_nr_zile" => "15", "clienti_disc" => "0%", "clienti_sold_blocare" => "5000", "clienti_reference_contract" => "CTR-2026-001", "clienti_nume_contact_bt56" => "Ion Popescu", "pdl" => [ [ "pdl_clienti_name" => "Depozit Central", "pdl_clienti_address" => "Str. Industriei nr. 5", "clienti_judet_pdl" => "Ilfov", "clienti_oras_pdl" => "Voluntari", "clienti_reg_pdl" => "", "clienti_id_locatie_bt_71" => "", ], ], ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Clienti", "act": "Ins", "clienti_nume": "Client Test", "clienti_cod": "RO 1234567", "clienti_reg": "J00/00/0000", "clienti_tip": "juridica", "clienti_email": "email@domeniu.ro", "clienti_sediu": "Str. Pacii nr. 20", "clienti_oras": "Bucuresti", "clienti_tara": "Romania", "clienti_nr_zile": "15", "clienti_disc": "0%" }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "1342457" } }
Modificare Client
Actualizează un client existent. Identificarea înregistrării care se modifică se face strict după <code>clienti_key</code> (identificatorul intern). Câmpurile acceptate sunt aceleași ca la adăugare, cu excepția array-ului <code>pdl</code> (punctele de livrare nu se gestionează prin acest endpoint).
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru clienți:
Clienti.act
Acțiune. Pentru modificare:
Upd.Date de identificare
clienti_key
Identificator intern al clientului care va fi modificat. Obligatoriu pentru acțiunea
Upd — îl obții din răspunsul la Ins sau dintr-un apel Get (câmpul Id).clienti_nume
Denumirea clientului.
clienti_cod
Codul fiscal (CUI / CNP).
clienti_reg
Numărul de la Registrul Comerțului.
clienti_tip
Tipul persoanei:
fizica · juridica.clienti_card
Cod client / cod card de fidelitate.
clienti_id_furnizor
Identificator extern al clientului în sistemul furnizorului.
Date de contact și adresă
clienti_tel
Telefon de contact.
clienti_email
Adresă de email (validată).
clienti_sediu
Adresa sediului.
clienti_judet
Județul sediului.
clienti_oras
Orașul / localitatea sediului.
clienti_tara
Țara.
Date bancare
clienti_banca
Banca.
clienti_cont
Contul IBAN.
Adresă de livrare
clienti_adresa_livrare
Adresa de livrare (dacă diferă de sediu).
clienti_oras_livrare
Orașul de livrare.
clienti_judet_livrare
Județul de livrare.
clienti_country_livrare
Țara de livrare.
Condiții comerciale
clienti_nr_zile
Numărul de zile de scadență la plată.
clienti_disc
Discount aplicat (ex.
5%).clienti_sold_blocare
Pragul de sold la care se blochează emiterea de documente. Valoare numerică.
clienti_reference_contract
Referință / număr de contract.
Observații și contact suplimentar
clienti_obs
Observații afișate pe factură.
clienti_obs1
Observații interne despre client.
clienti_nume_contact_bt56
Numele persoanei de contact (câmp BT-56).
⚠️ Atenție
Fără
clienti_key nu poți identifica înregistrarea de modificat. Asigură-te că trimiți întotdeauna identificatorul corect al clientului existent.💡 Diferențe față de adăugare
Modificarea acceptă aceleași câmpuri ca
Ins, dar fără array-ul pdl — punctele de livrare nu se actualizează prin acest endpoint. Poți trimite doar câmpurile pe care vrei să le modifici.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Clienti",
"act": "Upd",
"clienti_key": "1342461",
"clienti_nume": "Client Test",
"clienti_cod": "RO 1234567",
"clienti_reg": "J00/00/0000",
"clienti_tel": "0987654321",
"clienti_tip": "juridica",
"clienti_card": "0o9i8u7y",
"clienti_email": "email@domeniu.ro",
"clienti_sediu": "Str. Pacii nr. 20",
"clienti_oras": "Bucuresti",
"clienti_tara": "Romania",
"clienti_banca": "Banca",
"clienti_judet": "",
"clienti_cont": "",
"clienti_obs": "Observatii",
"clienti_obs1": "Obs. Client",
"clienti_adresa_livrare": "Adresa",
"clienti_nr_zile": "15",
"clienti_disc": "0%",
"clienti_sold_blocare": "5000",
"clienti_reference_contract": "CTR-2026-001",
"clienti_nume_contact_bt56": "Ion Popescu"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Clienti", "act" => "Upd", "clienti_key" => "1342461", "clienti_nume" => "Client Test", "clienti_cod" => "RO 1234567", "clienti_reg" => "J00/00/0000", "clienti_tel" => "0987654321", "clienti_tip" => "juridica", "clienti_card" => "0o9i8u7y", "clienti_email" => "email@domeniu.ro", "clienti_sediu" => "Str. Pacii nr. 20", "clienti_oras" => "Bucuresti", "clienti_tara" => "Romania", "clienti_banca" => "Banca", "clienti_obs" => "Observatii", "clienti_obs1" => "Obs. Client", "clienti_adresa_livrare" => "Adresa", "clienti_nr_zile" => "15", "clienti_disc" => "0%", "clienti_sold_blocare" => "5000", "clienti_reference_contract" => "CTR-2026-001", "clienti_nume_contact_bt56" => "Ion Popescu", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Clienti", "act": "Upd", "clienti_key": "1342461", "clienti_nume": "Client Test", "clienti_cod": "RO 1234567", "clienti_tel": "0987654321", "clienti_email": "email@domeniu.ro", "clienti_nr_zile": "30", "clienti_disc": "5%" }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "1342457" } }
Afișare Avize
Returnează lista de avize emise în intervalul de dată specificat. Permite filtrare după dată scadență, status și tip (emise, anulate, transformate).
POST
https://api.facturis-online.ro/api/?json={json}
Parametri
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru avize:
Avize.act
Acțiune. Pentru afișare:
Get.avize_key
Id-ul avizului — filtrare pentru un singur aviz specific.
date_start
Data de început (format
DD-MM-YYYY).date_stop
Data de sfârșit (format
DD-MM-YYYY).date_startS
Data scadență aviz — început interval.
date_stopS
Data scadență aviz — sfârșit interval.
searchDeleted
Filtrare după stare:
1 — afișare doar șterse · 2 — afișare șterse și neșterse.avize_emise
Filtrare avize emise (
1 pentru activare).avize_anulate
Filtrare avize anulate (
1 pentru activare).avize_transformate
Filtrare avize transformate în factură (
1 pentru activare).💡 Sfat
Răspunsul include și lista de produse pentru fiecare aviz în câmpul
dataProd. Dacă nu specifici date_start/date_stop, se vor returna toate avizele din cont.{
"APIkey": "123456789",
"u": "admin",
"p": "parola1",
"c": "ro 31234567",
"met": "Avize",
"act": "Get",
"date_start": "01-04-2021",
"date_stop": "01-07-2021",
"avize_emise": "1",
"searchDeleted": "2"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "parola1", "c" => "ro 31234567", "met" => "Avize", "act" => "Get", "date_start" => "01-04-2021", "date_stop" => "01-07-2021", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "parola1", "c": "ro 31234567", "met": "Avize", "act": "Get", "date_start": "01-04-2021", "date_stop": "01-07-2021" }'
200 OK { "success": 2000, "result": [ { "avize_key": "148304", "avize_serie_numar": "61", "avize_data": "27-03-2026 14:02:13", "avize_prod_pretftva": "270.27", "avize_prod_val_tva": "56.76", "avize_prod_val_tot": "327.03", "avize_moneda": "RON", "avize_status": "Emis", "usr_name": "Mihalache Iulian", "avize_nume_client": "Firma Mea SRL", "avize_codf_client": "-", "avize_sediu_client": "Calea J.J Rousseau nr. 986", "clienti_oras": "Abrud", "avize_judet_client": "Alba", "clienti_tara": "Romania", "avize_banca_client": "BCR", "pdl_nume": "SEDIUL SOCIAL", "dataProd": [ { "avize_prod_nume": "CARCASA AMBREIAJ 123456", "avize_prod_moneda": "RON", "avize_prod_pretftva": "270.270000", "avize_prod_pretctva": "327.026700", "avize_prod_cant": "1.000000", "avize_prod_val": "270.270000", "avize_prod_val_tva": "56.760000", "avize_prod_val_tot": "327.026700", "prod_cod": "594488290455", "prod_sku": "", "prod_cod1": "046-2022-ANTONIO-728-%" } ] } ] }
Adăugare Avize
Creează un aviz nou cu produsele specificate. Identificarea clientului se face automat după codul fiscal (pentru persoane juridice) sau după nume (pentru persoane fizice). Dacă clientul nu există în nomenclator, este adăugat automat.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru avize:
Avize.act
Acțiune. Pentru inserare:
Ins.Structura request-ului
dataFact
Obiect cu datele avizului: client, dată emitere, sediu, delegat, observații, status etc.
dataProd
Array de produse. Fiecare produs este un obiect separat cu cantități, prețuri și cotă TVA.
dataFact — date document
facturi_key
Identificator aviz. Lăsat gol la adăugare — generat automat de sistem.
facturi_punct_de_lucru
Punctul de lucru.
facturi_gestiune
Gestiunea din care se face descărcarea.
facturi_data
Data emiterii avizului (format
YYYY-MM-DD HH:MM:SS).facturi_data_scadenta
Data scadență (format
YYYY-MM-DD).facturi_serie
Seria avizului. Lasă gol pentru auto-incrementare.
facturi_numar
Numărul avizului. Lasă gol pentru auto-incrementare.
facturi_cota_tva
Cota de TVA implicită a documentului (ex.
19%).facturi_moneda
Moneda documentului (ex.
RON, EUR).facturi_status
Status aviz, de regulă
Emisa.fk_agent_name
Numele agentului asociat documentului.
dataFact — date client
facturi_nume_client
Denumirea clientului.
facturi_tip_persoana
Tipul persoanei:
fizica · juridica.facturi_codf_client
Codul fiscal al clientului (CUI / CNP).
facturi_nrreg_client
Numărul de la Registrul Comerțului.
facturi_sediu_client
Adresa sediului clientului.
facturi_judet_client
Județul clientului.
facturi_oras_client
Orașul clientului.
facturi_tara_client
Țara clientului.
facturi_cont_client
Contul IBAN al clientului.
facturi_banca_client
Banca clientului.
facturi_clienti_adresa_livrare
Adresa de livrare a clientului.
facturi_obs_client
Observații despre client.
dataFact — delegat și observații
facturi_nume_delegat
Numele delegatului.
facturi_act_delegat
Actul de identitate al delegatului.
facturi_obs_delegat
Observații despre delegat.
facturi_obs_up
Alte observații pe document.
dataProd — produse (per element)
facturi_prod_nume
Denumirea produsului.
facturi_prod_moneda
Moneda produsului.
facturi_prod_pretftva
Prețul unitar fără TVA.
facturi_prod_pretctva
Prețul unitar cu TVA.
facturi_prod_cant
Cantitatea.
facturi_prod_val
Valoarea fără TVA (preț × cantitate).
facturi_prod_val_tva
Valoarea TVA.
facturi_prod_val_tot
Valoarea totală (cu TVA).
facturi_prod_tva
Cota de TVA a produsului (ex.
19%).prod_cod
Codul EAN al produsului.
prod_sku
Codul SKU al produsului.
prod_cod1
Cod alternativ al produsului.
prod_cod_cautare
Câmpul după care se identifică produsul în aplicație:
prod_cod · prod_sku · prod_cod1.⚠️ Atenție
Identificarea clientului se face automat după CUI (juridice) sau nume (fizice). Dacă nu există în baza de date, se inserează automat în Nomenclatorul de Clienți.
💡 Identificarea produselor
Câmpul
prod_cod_cautare indică după ce câmp este căutat produsul în Nomenclator: prod_cod (EAN), prod_sku sau prod_cod1. Trimite valoarea corespunzătoare în câmpul indicat (prod_cod / prod_sku / prod_cod1).📦 Mai multe produse
Array-ul
dataProd poate conține oricâte produse — fiecare ca obiect separat. Totalurile documentului se calculează prin însumarea valorilor de pe fiecare linie.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Avize",
"act": "Ins",
"dataFact": {
"facturi_key": "",
"facturi_punct_de_lucru": "",
"facturi_gestiune": "",
"facturi_data": "2019-01-09 15:30:52",
"facturi_data_scadenta": "2019-01-31",
"facturi_serie": "",
"facturi_numar": "",
"facturi_cota_tva": "19%",
"facturi_moneda": "RON",
"facturi_nume_client": "Nume Client",
"facturi_tip_persoana": "fizica",
"facturi_codf_client": "18181818181",
"facturi_nrreg_client": "cd23123213",
"facturi_sediu_client": "Bacau",
"facturi_judet_client": "Bacau",
"facturi_oras_client": "Bacau",
"facturi_tara_client": "Romania",
"facturi_cont_client": "Cont",
"facturi_banca_client": "banca",
"facturi_clienti_adresa_livrare": "adresa de livrare",
"facturi_obs_client": "obs_client",
"facturi_nume_delegat": "nume delegat",
"facturi_act_delegat": "act delegat",
"facturi_obs_delegat": "obs delegat",
"facturi_obs_up": "alte observatii",
"facturi_status": "Emisa",
"fk_agent_name": "Nume Agent"
},
"dataProd": [
{
"facturi_prod_nume": "produs test1",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "50",
"facturi_prod_pretctva": "59.5",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "50",
"facturi_prod_val_tva": "9.5",
"facturi_prod_val_tot": "59.5",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
},
{
"facturi_prod_nume": "produs test2",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "456",
"facturi_prod_pretctva": "542.64",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "456",
"facturi_prod_val_tva": "86.64",
"facturi_prod_val_tot": "542.64",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
}
]
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Avize", "act" => "Ins", ]; $values['dataFact'] = [ "facturi_data" => "2019-01-09 15:30:52", "facturi_data_scadenta" => "2019-01-31", "facturi_cota_tva" => "19%", "facturi_moneda" => "RON", "facturi_nume_client" => "Nume Client", "facturi_tip_persoana" => "fizica", "facturi_codf_client" => "18181818181", "facturi_nrreg_client" => "cd23123213", "facturi_sediu_client" => "Bacau", "facturi_judet_client" => "Bacau", "facturi_oras_client" => "Bacau", "facturi_tara_client" => "Romania", "facturi_clienti_adresa_livrare" => "adresa de livrare", "facturi_nume_delegat" => "nume delegat", "facturi_act_delegat" => "act delegat", "facturi_obs_up" => "alte observatii", "facturi_status" => "Emisa", "fk_agent_name" => "Nume Agent", ]; $values['dataProd'][0] = [ "facturi_prod_nume" => "produs test1", "facturi_prod_moneda" => "RON", "facturi_prod_pretftva" => "50", "facturi_prod_pretctva" => "59.5", "facturi_prod_cant" => "1.000", "facturi_prod_val" => "50", "facturi_prod_val_tva" => "9.5", "facturi_prod_val_tot" => "59.5", "prod_cod" => "-", "prod_cod_cautare" => "prod_cod", "facturi_prod_tva" => "19%", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Avize", "act": "Ins", "dataFact": { "facturi_data": "2019-01-09 15:30:52", "facturi_nume_client": "Nume Client", "facturi_tip_persoana": "fizica", "facturi_codf_client": "18181818181", "facturi_status": "Emisa" }, "dataProd": [ { "facturi_prod_nume": "produs test1", "facturi_prod_pretftva": "50", "facturi_prod_cant": "1.000", "facturi_prod_tva": "19%", "prod_cod_cautare": "prod_cod" } ] }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "2322212" } }
Modificare Avize
Actualizează un aviz existent. Spre deosebire de alte endpoint-uri, modificarea folosește tot acțiunea <code>Ins</code> — diferența este că în obiectul <code>dataFact</code> trimiți <code>facturi_key</code> cu identificatorul avizului existent. La salvare, produsele din <code>dataProd</code> înlocuiesc complet liniile avizului.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru avize:
Avize.act
Acțiune. Pentru modificare se folosește tot
Ins.Structura request-ului
dataFact
Obiect cu datele avizului. Trebuie să conțină
facturi_key cu identificatorul avizului care se modifică.dataProd
Array de produse care înlocuiesc liniile existente ale avizului.
dataFact — date document
facturi_key
Identificatorul avizului care va fi modificat. Obligatoriu — îl obții din răspunsul la
Ins sau dintr-un apel Get.facturi_punct_de_lucru
Punctul de lucru.
facturi_gestiune
Gestiunea din care se face descărcarea.
facturi_data
Data emiterii avizului (format
YYYY-MM-DD HH:MM:SS).facturi_data_scadenta
Data scadență (format
YYYY-MM-DD).facturi_serie
Seria avizului.
facturi_numar
Numărul avizului.
facturi_cota_tva
Cota de TVA implicită a documentului.
facturi_moneda
Moneda documentului.
facturi_status
Status aviz, de regulă
Emisa.dataFact — date client
facturi_nume_client
Denumirea clientului.
facturi_tip_persoana
Tipul persoanei:
fizica · juridica.facturi_codf_client
Codul fiscal al clientului (CUI / CNP).
facturi_nrreg_client
Numărul de la Registrul Comerțului.
facturi_sediu_client
Adresa sediului clientului.
facturi_judet_client
Județul clientului.
facturi_oras_client
Orașul clientului.
facturi_tara_client
Țara clientului.
facturi_cont_client
Contul IBAN al clientului.
facturi_banca_client
Banca clientului.
facturi_clienti_adresa_livrare
Adresa de livrare a clientului.
facturi_obs_client
Observații despre client.
dataFact — delegat și observații
facturi_nume_delegat
Numele delegatului.
facturi_act_delegat
Actul de identitate al delegatului.
facturi_obs_delegat
Observații despre delegat.
facturi_obs_up
Alte observații pe document.
dataProd — produse (per element)
facturi_prod_nume
Denumirea produsului.
facturi_prod_moneda
Moneda produsului.
facturi_prod_pretftva
Prețul unitar fără TVA.
facturi_prod_pretctva
Prețul unitar cu TVA.
facturi_prod_cant
Cantitatea.
facturi_prod_val
Valoarea fără TVA (preț × cantitate).
facturi_prod_val_tva
Valoarea TVA.
facturi_prod_val_tot
Valoarea totală (cu TVA).
facturi_prod_tva
Cota de TVA a produsului (ex.
19%).prod_cod
Codul EAN al produsului.
prod_sku
Codul SKU al produsului.
prod_cod1
Cod alternativ al produsului.
prod_cod_cautare
Câmpul după care se identifică produsul:
prod_cod · prod_sku · prod_cod1.⚠️ Produsele se înlocuiesc
La modificare, liniile din
dataProd înlocuiesc complet produsele avizului. Trimite întotdeauna lista completă a produselor dorite, nu doar cele modificate.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Avize",
"act": "Upd",
"dataFact": {
"facturi_key": "63448",
"facturi_punct_de_lucru": "",
"facturi_gestiune": "",
"facturi_data": "2019-01-09 15:30:52",
"facturi_data_scadenta": "2019-01-31",
"facturi_serie": "",
"facturi_numar": "",
"facturi_cota_tva": "19%",
"facturi_moneda": "RON",
"facturi_nume_client": "Nume Client",
"facturi_tip_persoana": "fizica",
"facturi_codf_client": "18181818181",
"facturi_nrreg_client": "cd23123213",
"facturi_sediu_client": "Bacau",
"facturi_judet_client": "Bacau",
"facturi_oras_client": "Bacau",
"facturi_tara_client": "Romania",
"facturi_cont_client": "Cont",
"facturi_banca_client": "banca",
"facturi_clienti_adresa_livrare": "adresa de livrare",
"facturi_obs_client": "obs_client",
"facturi_nume_delegat": "nume delegat",
"facturi_act_delegat": "act delegat",
"facturi_obs_delegat": "obs delegat",
"facturi_obs_up": "alte observatii",
"facturi_status": "Emisa"
},
"dataProd": [
{
"facturi_prod_nume": "produs test1",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "50",
"facturi_prod_pretctva": "59.5",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "50",
"facturi_prod_val_tva": "9.5",
"facturi_prod_val_tot": "59.5",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
},
{
"facturi_prod_nume": "produs test2",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "456",
"facturi_prod_pretctva": "542.64",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "456",
"facturi_prod_val_tva": "86.64",
"facturi_prod_val_tot": "542.64",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
}
]
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Avize", "act" => "Upd", ]; $values['dataFact'] = [ "facturi_key" => "63448", "facturi_data" => "2019-01-09 15:30:52", "facturi_data_scadenta" => "2019-01-31", "facturi_cota_tva" => "19%", "facturi_moneda" => "RON", "facturi_nume_client" => "Nume Client", "facturi_tip_persoana" => "fizica", "facturi_codf_client" => "18181818181", "facturi_status" => "Emisa", ]; $values['dataProd'][0] = [ "facturi_prod_nume" => "produs test1", "facturi_prod_pretftva" => "50", "facturi_prod_cant" => "1.000", "facturi_prod_tva" => "19%", "prod_cod_cautare" => "prod_cod", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Avize", "act": "Upd", "dataFact": { "facturi_key": "63448", "facturi_data": "2019-01-09 15:30:52", "facturi_nume_client": "Nume Client", "facturi_codf_client": "18181818181", "facturi_status": "Emisa" }, "dataProd": [ { "facturi_prod_nume": "produs test1", "facturi_prod_pretftva": "50", "facturi_prod_cant": "1.000", "facturi_prod_tva": "19%", "prod_cod_cautare": "prod_cod" } ] }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "2322212" } }
Listare Aviz (PDF)
Returnează documentul PDF al unui aviz emis. Avizul se identifică după <code>id_fact</code>; alternativ poate fi identificat prin combinația <code>serie</code> + <code>nr</code>. Parametrii opționali permit alegerea limbii, monedei și formatului de tipărire.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru listarea PDF:
FacturiHtml.act
Acțiune. Pentru listare:
Facturi.id_fact
Id-ul avizului care va fi listat.
type
Tipul documentului — pentru avize:
aviz.serie
Seria avizului. Alternativă la
id_fact, folosită împreună cu nr pentru identificarea documentului.nr
Numărul avizului. Alternativă la
id_fact, folosit împreună cu serie.select_language
Limba documentului:
1 — Română · 2 — Engleză · 3 — Franceză...select_currency
Moneda de afișare (ex.
RON, EUR, USD...).select_format
Formatul de tipărire:
1 — A4 · 2 — Rolă termică 58mm · 3 — Rolă termică 80mm...📄 Format răspuns
Răspunsul este direct conținutul binar al fișierului PDF (nu JSON și nu base64). Salvează corpul răspunsului ca atare într-un fișier
.pdf — în PHP, scrie direct rezultatul cu file_put_contents(), fără decodare.💡 Identificare document
Avizul se identifică prin
id_fact. Alternativ, poți folosi combinația serie + nr. Parametrul type trebuie să fie aviz pentru acest tip de document.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "RO 31234567",
"met": "FacturiHtml",
"act": "Facturi",
"id_fact": "1761103",
"serie": "AA",
"nr": "123",
"type": "aviz",
"select_language": "1",
"select_currency": "RON",
"select_format": "1"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "RO 31234567", "met" => "FacturiHtml", "act" => "Facturi", "id_fact" => "1761103", "type" => "aviz", "select_language" => "1", "select_currency" => "RON", "select_format" => "1", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); // Răspunsul este direct conținutul binar al PDF-ului file_put_contents("aviz.pdf", $result);
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "RO 31234567", "met": "FacturiHtml", "act": "Facturi", "id_fact": "1761103", "type": "aviz", "select_language": "1", "select_currency": "RON", "select_format": "1" }'
200 OK · Content-Type: application/pdf %PDF-1.4 %âãÏÓ ... (conținut binar PDF) ... %%EOF
Afișare Bonuri
Returnează lista de bonuri emise în intervalul de dată specificat. Fiecare bon include datele clientului, modalitatea de plată și lista de produse din câmpul <code>dataProd</code>.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru bonuri:
Bonuri.act
Acțiune. Pentru afișare:
Get.facturi_key
Id-ul bonului — filtrare pentru un singur bon specific.
date_start
Data de început (format
DD-MM-YYYY).date_stop
Data de sfârșit (format
DD-MM-YYYY).💡 Sfat
Răspunsul include lista de produse pentru fiecare bon în câmpul
dataProd, precum și detaliile de plată (modalitate_plata_bon, mod_plata_cash, mod_plata_card, mod_plata_tiket). Dacă nu specifici date_start/date_stop, se returnează toate bonurile din cont.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Bonuri",
"act": "Get",
"date_start": "01-04-2021",
"date_stop": "01-07-2021"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Bonuri", "act" => "Get", "date_start" => "01-04-2021", "date_stop" => "01-07-2021", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Bonuri", "act": "Get", "date_start": "01-04-2021", "date_stop": "01-07-2021" }'
200 OK { "success": 2000, "result": [ { "facturi_key": "1857678", "facturi_serie": "TEST", "facturi_serie_numar": "141", "facturi_data": "11-02-2020 15:30:52", "facturi_prod_pretftva": "50.00", "facturi_prod_val_tva": "9.50", "facturi_prod_cota_disc": "0.00", "facturi_prod_val_tot": "59.50", "facturi_moneda": "RON", "facturi_status": "Emisa", "facturi_data_scadenta": "02-03-2020", "facturi_nume_client": "Nume Client", "facturi_codf_client": "18181818181", "facturi_nrreg_client": "cd23123213", "facturi_sediu_client": "Bacau", "clienti_oras": "Bacau", "clienti_tara": "Romania", "facturi_judet_client": "Bacau", "clienti_adresa_livrare": "adresa de livrare", "clienti_cod": "", "facturi_cont_client": "Cont", "facturi_banca_client": "banca", "clienti_tel": "", "clienti_email": "", "facturi_tip_persoana": "fizica", "facturi_nume_delegat": "", "facturi_act_delegat": "act delegat", "facturi_obs_delegat": "obs delegat", "fk_agent_name": null, "usr_name": "Iulian Iulian", "facturi_pers_livrare": "Iulian Iulian|AC214234", "pdl_nume": "SEDIUL SOCIAL", "facturi_obs_up": "alte observatii", "facturi_obs_client": "obs_client", "incasare_factura": "", "modalitate_plata_bon": "", "mod_plata_cash": "", "mod_plata_card": "", "mod_plata_tiket": "", "bon_key": "", "chitante_serie": "", "chitante_serie_numar": "", "bonuri_serie": "", "facturi_cota_tva": "19%", "dataProd": [ { "facturi_prod_nume": "170-092XNV", "facturi_prod_moneda": "RON", "facturi_prod_pretftva": "50", "facturi_prod_pretctva": "59.5", "facturi_prod_cant": "1.000", "facturi_prod_val": "50", "facturi_prod_val_tva": "9.5", "facturi_prod_val_tot": "59.5", "prod_cod": "", "prod_sku": "", "prod_cod1": "", "prod_cod_cautare": "prod_cod", "facturi_prod_tva": "19%" } ] } ] }
Adăugare Bon
Creează un bon nou cu produsele specificate. Identificarea clientului se face automat după codul fiscal (juridice) sau după nume (fizice) — dacă nu există în nomenclator, este adăugat automat. Bonurile includ în plus câmpurile de modalitate de plată (cash / card / tichet).
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru bonuri:
Bonuri.act
Acțiune. Pentru inserare:
Ins.Structura request-ului
dataFact
Obiect cu datele bonului: client, dată emitere, modalitate de plată, observații, status etc.
dataProd
Array de produse. Fiecare produs este un obiect separat cu cantități, prețuri și cotă TVA.
dataFact — date document
facturi_key
Identificator bon. Lăsat gol la adăugare — generat automat de sistem.
facturi_punct_de_lucru
Punctul de lucru.
facturi_gestiune
Gestiunea din care se face descărcarea.
facturi_data
Data emiterii bonului (format
YYYY-MM-DD HH:MM:SS).facturi_data_scadenta
Data scadență (format
YYYY-MM-DD).facturi_serie
Seria bonului. Lasă gol pentru auto-incrementare.
facturi_numar
Numărul bonului. Lasă gol pentru auto-incrementare.
facturi_cota_tva
Cota de TVA implicită a documentului (ex.
19%).facturi_moneda
Moneda documentului (ex.
RON, EUR).facturi_status
Status bon, de regulă
Emisa.dataFact — modalitate de plată
modalitate_plata_bon
Modalitatea de plată:
Cash · Card · Tichet · Combinata.mod_plata_cash
Suma achitată cash.
mod_plata_card
Suma achitată cu cardul.
mod_plata_tiket
Suma achitată cu tichete.
dataFact — date client
facturi_nume_client
Denumirea clientului.
facturi_tip_persoana
Tipul persoanei:
fizica · juridica.facturi_codf_client
Codul fiscal al clientului (CUI / CNP).
facturi_nrreg_client
Numărul de la Registrul Comerțului.
facturi_sediu_client
Adresa sediului clientului.
facturi_judet_client
Județul clientului.
facturi_cont_client
Contul IBAN al clientului.
facturi_banca_client
Banca clientului.
facturi_clienti_adresa_livrare
Adresa de livrare a clientului.
facturi_obs_client
Observații despre client.
dataFact — delegat și observații
facturi_nume_delegat
Numele delegatului.
facturi_act_delegat
Actul de identitate al delegatului.
facturi_obs_delegat
Observații despre delegat.
facturi_obs_up
Alte observații pe document.
dataProd — produse (per element)
facturi_prod_nume
Denumirea produsului.
facturi_prod_moneda
Moneda produsului.
facturi_prod_pretftva
Prețul unitar fără TVA.
facturi_prod_pretctva
Prețul unitar cu TVA.
facturi_prod_cant
Cantitatea.
facturi_prod_val
Valoarea fără TVA (preț × cantitate).
facturi_prod_val_tva
Valoarea TVA.
facturi_prod_val_tot
Valoarea totală (cu TVA).
facturi_prod_tva
Cota de TVA a produsului (ex.
19%).prod_cod
Codul EAN al produsului.
prod_sku
Codul SKU al produsului.
prod_cod1
Cod alternativ al produsului.
prod_cod_cautare
Câmpul după care se identifică produsul în aplicație:
prod_cod · prod_sku · prod_cod1.⚠️ Atenție
Identificarea clientului se face automat după CUI (juridice) sau nume (fizice). Dacă nu există în baza de date, se inserează automat în Nomenclatorul de Clienți.
💳 Modalitate de plată
Pentru plată simplă folosește
modalitate_plata_bon (Cash, Card sau Tichet) și suma corespunzătoare. Pentru plată mixtă folosește Combinata și completează simultan mod_plata_cash, mod_plata_card și/sau mod_plata_tiket — suma lor trebuie să acopere totalul bonului.📦 Mai multe produse
Array-ul
dataProd poate conține oricâte produse — fiecare ca obiect separat. Câmpul prod_cod_cautare indică după ce câmp este identificat produsul în Nomenclator: prod_cod (EAN), prod_sku sau prod_cod1.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Bonuri",
"act": "Ins",
"dataFact": {
"facturi_key": "",
"facturi_punct_de_lucru": "",
"facturi_gestiune": "",
"facturi_data": "2019-01-09 15:30:52",
"facturi_data_scadenta": "2019-01-31",
"modalitate_plata_bon": "Cash",
"mod_plata_cash": "602.14",
"mod_plata_card": "0.00",
"mod_plata_tiket": "0.00",
"facturi_cota_tva": "19%",
"facturi_moneda": "RON",
"facturi_nume_client": "Nume Client",
"facturi_tip_persoana": "fizica",
"facturi_codf_client": "18181818181",
"facturi_nrreg_client": "cd23123213",
"facturi_sediu_client": "Bacau",
"facturi_judet_client": "Bacau",
"facturi_cont_client": "Cont",
"facturi_banca_client": "banca",
"facturi_clienti_adresa_livrare": "adresa de livrare",
"facturi_obs_client": "obs_client",
"facturi_nume_delegat": "nume delegat",
"facturi_act_delegat": "act delegat",
"facturi_obs_delegat": "obs delegat",
"facturi_obs_up": "alte observatii",
"facturi_status": "Emisa"
},
"dataProd": [
{
"facturi_prod_nume": "produs test1",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "50",
"facturi_prod_pretctva": "59.5",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "50",
"facturi_prod_val_tva": "9.5",
"facturi_prod_val_tot": "59.5",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
},
{
"facturi_prod_nume": "produs test2",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "456",
"facturi_prod_pretctva": "542.64",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "456",
"facturi_prod_val_tva": "86.64",
"facturi_prod_val_tot": "542.64",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
}
]
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Bonuri", "act" => "Ins", ]; $values['dataFact'] = [ "facturi_data" => "2019-01-09 15:30:52", "facturi_data_scadenta" => "2019-01-31", "modalitate_plata_bon" => "Cash", "mod_plata_cash" => "602.14", "mod_plata_card" => "0.00", "mod_plata_tiket" => "0.00", "facturi_cota_tva" => "19%", "facturi_moneda" => "RON", "facturi_nume_client" => "Nume Client", "facturi_tip_persoana" => "fizica", "facturi_codf_client" => "18181818181", "facturi_status" => "Emisa", ]; $values['dataProd'][0] = [ "facturi_prod_nume" => "produs test1", "facturi_prod_pretftva" => "50", "facturi_prod_cant" => "1.000", "facturi_prod_tva" => "19%", "prod_cod_cautare" => "prod_cod", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Bonuri", "act": "Ins", "dataFact": { "facturi_data": "2019-01-09 15:30:52", "modalitate_plata_bon": "Cash", "mod_plata_cash": "59.5", "facturi_nume_client": "Nume Client", "facturi_codf_client": "18181818181", "facturi_status": "Emisa" }, "dataProd": [ { "facturi_prod_nume": "produs test1", "facturi_prod_pretftva": "50", "facturi_prod_cant": "1.000", "facturi_prod_tva": "19%", "prod_cod_cautare": "prod_cod" } ] }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "92382888" } }
Modificare Bon
Actualizează un bon existent. Identificarea bonului care se modifică se face după <code>facturi_key</code> din obiectul <code>dataFact</code>. La salvare, produsele din <code>dataProd</code> înlocuiesc complet liniile bonului.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru bonuri:
Bonuri.act
Acțiune. Pentru modificare:
Upd.Structura request-ului
dataFact
Obiect cu datele bonului. Trebuie să conțină
facturi_key cu identificatorul bonului care se modifică.dataProd
Array de produse care înlocuiesc liniile existente ale bonului.
dataFact — date document
facturi_key
Identificatorul bonului care va fi modificat. Obligatoriu — îl obții din răspunsul la
Ins sau dintr-un apel Get.facturi_punct_de_lucru
Punctul de lucru.
facturi_gestiune
Gestiunea din care se face descărcarea.
facturi_data
Data emiterii bonului (format
YYYY-MM-DD HH:MM:SS).facturi_data_scadenta
Data scadență (format
YYYY-MM-DD).facturi_serie
Seria bonului.
facturi_numar
Numărul bonului.
facturi_cota_tva
Cota de TVA implicită a documentului.
facturi_moneda
Moneda documentului.
facturi_status
Status bon, de regulă
Emisa.dataFact — modalitate de plată
modalitate_plata_bon
Modalitatea de plată:
Cash · Card · Tichet · Combinata.mod_plata_cash
Suma achitată cash.
mod_plata_card
Suma achitată cu cardul.
mod_plata_tiket
Suma achitată cu tichete.
dataFact — date client
facturi_nume_client
Denumirea clientului.
facturi_tip_persoana
Tipul persoanei:
fizica · juridica.facturi_codf_client
Codul fiscal al clientului (CUI / CNP).
facturi_nrreg_client
Numărul de la Registrul Comerțului.
facturi_sediu_client
Adresa sediului clientului.
facturi_judet_client
Județul clientului.
facturi_cont_client
Contul IBAN al clientului.
facturi_banca_client
Banca clientului.
facturi_clienti_adresa_livrare
Adresa de livrare a clientului.
facturi_obs_client
Observații despre client.
dataFact — delegat și observații
facturi_nume_delegat
Numele delegatului.
facturi_act_delegat
Actul de identitate al delegatului.
facturi_obs_delegat
Observații despre delegat.
facturi_obs_up
Alte observații pe document.
dataProd — produse (per element)
facturi_prod_nume
Denumirea produsului.
facturi_prod_moneda
Moneda produsului.
facturi_prod_pretftva
Prețul unitar fără TVA.
facturi_prod_pretctva
Prețul unitar cu TVA.
facturi_prod_cant
Cantitatea.
facturi_prod_val
Valoarea fără TVA (preț × cantitate).
facturi_prod_val_tva
Valoarea TVA.
facturi_prod_val_tot
Valoarea totală (cu TVA).
facturi_prod_tva
Cota de TVA a produsului (ex.
19%).prod_cod
Codul EAN al produsului.
prod_sku
Codul SKU al produsului.
prod_cod1
Cod alternativ al produsului.
prod_cod_cautare
Câmpul după care se identifică produsul:
prod_cod · prod_sku · prod_cod1.⚠️ facturi_key obligatoriu
Spre deosebire de adăugare, modificarea folosește acțiunea
Upd și necesită facturi_key în dataFact pentru a identifica bonul existent.⚠️ Produsele se înlocuiesc
La modificare, liniile din
dataProd înlocuiesc complet produsele bonului. Trimite întotdeauna lista completă a produselor dorite, nu doar cele modificate.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Bonuri",
"act": "Upd",
"dataFact": {
"facturi_key": "2686267",
"facturi_punct_de_lucru": "",
"facturi_gestiune": "",
"facturi_data": "2019-01-09 15:30:52",
"facturi_data_scadenta": "2019-01-31",
"modalitate_plata_bon": "Cash",
"mod_plata_cash": "602.14",
"mod_plata_card": "0.00",
"mod_plata_tiket": "0.00",
"facturi_cota_tva": "19%",
"facturi_moneda": "RON",
"facturi_nume_client": "Nume Client",
"facturi_tip_persoana": "fizica",
"facturi_codf_client": "18181818181",
"facturi_nrreg_client": "cd23123213",
"facturi_sediu_client": "Bacau",
"facturi_judet_client": "Bacau",
"facturi_cont_client": "Cont",
"facturi_banca_client": "banca",
"facturi_clienti_adresa_livrare": "adresa de livrare",
"facturi_obs_client": "obs_client",
"facturi_nume_delegat": "nume delegat",
"facturi_act_delegat": "act delegat",
"facturi_obs_delegat": "obs delegat",
"facturi_obs_up": "alte observatii",
"facturi_status": "Emisa"
},
"dataProd": [
{
"facturi_prod_nume": "produs test1",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "50",
"facturi_prod_pretctva": "59.5",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "50",
"facturi_prod_val_tva": "9.5",
"facturi_prod_val_tot": "59.5",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
},
{
"facturi_prod_nume": "produs test2",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "456",
"facturi_prod_pretctva": "542.64",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "456",
"facturi_prod_val_tva": "86.64",
"facturi_prod_val_tot": "542.64",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
}
]
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Bonuri", "act" => "Upd", ]; $values['dataFact'] = [ "facturi_key" => "2686267", "facturi_data" => "2019-01-09 15:30:52", "modalitate_plata_bon" => "Cash", "mod_plata_cash" => "602.14", "facturi_cota_tva" => "19%", "facturi_moneda" => "RON", "facturi_nume_client" => "Nume Client", "facturi_tip_persoana" => "fizica", "facturi_codf_client" => "18181818181", "facturi_status" => "Emisa", ]; $values['dataProd'][0] = [ "facturi_prod_nume" => "produs test1", "facturi_prod_pretftva" => "50", "facturi_prod_cant" => "1.000", "facturi_prod_tva" => "19%", "prod_cod_cautare" => "prod_cod", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Bonuri", "act": "Upd", "dataFact": { "facturi_key": "2686267", "facturi_data": "2019-01-09 15:30:52", "modalitate_plata_bon": "Cash", "mod_plata_cash": "59.5", "facturi_nume_client": "Nume Client", "facturi_status": "Emisa" }, "dataProd": [ { "facturi_prod_nume": "produs test1", "facturi_prod_pretftva": "50", "facturi_prod_cant": "1.000", "facturi_prod_tva": "19%", "prod_cod_cautare": "prod_cod" } ] }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "92382888" } }
Afișare Chitanțe
Returnează lista de chitanțe emise. Permite filtrare după interval de dată, status, client și factură asociată.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru chitanțe:
Chitante.act
Acțiune. Pentru afișare:
Get.chitante_key
Id-ul chitanței — filtrare pentru o singură chitanță specifică.
fk_clienti_key
Id-ul clientului — filtrare după client.
fk_factura_key
Id-ul facturii asociate — filtrare după factură.
date_start
Data de început (format
DD-MM-YYYY).date_stop
Data de sfârșit (format
DD-MM-YYYY).searchDeleted
Filtrare după stare:
1 — afișare doar șterse · 2 — afișare șterse și neșterse.chitante_emise
Filtrare chitanțe emise (
1 pentru activare).chitante_anulate
Filtrare chitanțe anulate (
1 pentru activare).💡 Sfat
Poți filtra chitanțele direct după factura asociată folosind
fk_factura_key sau după client folosind fk_clienti_key. Dacă nu specifici date_start/date_stop, se returnează toate chitanțele din cont.{
"APIkey": "123456789",
"u": "admin",
"p": "parola1",
"c": "ro 31234567",
"met": "Chitante",
"act": "Get",
"date_start": "01-04-2021",
"date_stop": "01-07-2021"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "parola1", "c" => "ro 31234567", "met" => "Chitante", "act" => "Get", "date_start" => "01-04-2021", "date_stop" => "01-07-2021", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "parola1", "c": "ro 31234567", "met": "Chitante", "act": "Get", "date_start": "01-04-2021", "date_stop": "01-07-2021" }'
200 OK { "success": 2000, "result": [ { "chitante_key": "1026177", "chitante_serie": "CH", "chitante_serie_numar": "152", "chitante_serie_completa": "CH 152", "chitante_data": "27-03-2026 14:02:13", "chitante_suma": "327.030000", "chitante_moneda": "RON", "chitante_obs": "Plată factură FCT-2026-00145", "modalitate_plata_chitanta": "Cash", "chitante_status": "Emis", "chitante_nume_client": "Firma Mea SRL", "chitante_codf_client": "RO12345678", "chitante_nrreg_client": "J40/1234/2020", "chitante_sediu_client": "Calea J.J Rousseau nr. 986, bl. A, sc. B, et. 6, ap. 39, 508063", "clienti_oras": "Abrud", "clienti_judet": "Alba", "clienti_tara": "Romania", "chitante_pdl": "SEDIUL SOCIAL", "chitante_gestiune": "Gestiune principala", "fk_clienti_key": "245", "fk_factura_key": "8901", "fk_gest_key": "1", "unique_id": "a1b2c3d4e5f6", "chitante_is_autochit": "0", "factura_asociata": "FCT 2026-00145", "usr_name": "Mihalache Iulian", "pdl_nume": "SEDIUL SOCIAL" } ] }
Adăugare Chitanță
Creează o chitanță nouă. Spre deosebire de avize și bonuri, chitanța nu conține produse (nu există <code>dataProd</code>) — datele se trimit doar în obiectul <code>dataFact</code>, care include suma încasată și, opțional, factura asociată. Identificarea clientului se face automat după codul fiscal sau nume; dacă nu există în nomenclator, este adăugat automat.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru chitanțe:
Chitante.act
Acțiune. Pentru inserare:
Ins.Structura request-ului
dataFact
Obiect cu datele chitanței: client, sumă, serie/număr, observații, dată, status. Chitanța nu conține un array de produse.
dataFact — date document
facturi_key
Identificator chitanță. Lăsat gol la adăugare — generat automat de sistem.
facturi_serie
Seria chitanței.
facturi_numar
Numărul chitanței. Lasă gol pentru auto-incrementare.
facturi_suma
Suma încasată.
facturi_moneda
Moneda (ex.
RON, EUR).facturi_obs
Observații (ex. factura pentru care se face încasarea).
facturi_data
Data chitanței (format
DD-MM-YYYY HH:MM:SS).facturi_status
Status chitanță, de regulă
Emisa.dataFact — date client
facturi_nume_client
Denumirea clientului.
facturi_tip_persoana
Tipul persoanei:
fizica · juridica.facturi_codf_client
Codul fiscal al clientului (CUI / CNP).
facturi_nrreg_client
Numărul de la Registrul Comerțului.
facturi_sediu_client
Adresa sediului clientului.
⚠️ Atenție
Identificarea clientului se face automat după CUI (juridice) sau nume (fizice). Dacă nu există în baza de date, se inserează automat în Nomenclatorul de Clienți.
🧾 Fără produse
Chitanța nu are linii de produse — toate datele (inclusiv
facturi_suma) se trimit în dataFact. Folosește facturi_obs pentru a nota factura sau motivul încasării.{
"APIkey": "123456789",
"met": "Chitante",
"act": "Ins",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"dataFact": {
"facturi_key": "",
"facturi_serie": "CCC",
"facturi_numar": "71",
"facturi_nume_client": "Nume Client",
"facturi_codf_client": "18181818181",
"facturi_nrreg_client": "cd23123213",
"facturi_sediu_client": "Bacau",
"facturi_suma": "1209.90",
"facturi_moneda": "RON",
"facturi_obs": "Contravaloare factura FF 123",
"facturi_data": "29-01-2019 12:28:49",
"facturi_status": "Emisa"
}
}
<?php $values = [ "APIkey" => "123456789", "met" => "Chitante", "act" => "Ins", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", ]; $values['dataFact'] = [ "facturi_serie" => "CCC", "facturi_numar" => "71", "facturi_nume_client" => "Nume Client", "facturi_codf_client" => "18181818181", "facturi_nrreg_client"=> "cd23123213", "facturi_sediu_client"=> "Bacau", "facturi_suma" => "1209.90", "facturi_moneda" => "RON", "facturi_obs" => "Contravaloare factura FF 123", "facturi_data" => "29-01-2019 12:28:49", "facturi_status" => "Emisa", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "met": "Chitante", "act": "Ins", "u": "admin", "p": "magazin", "c": "ro 31234567", "dataFact": { "facturi_serie": "CCC", "facturi_nume_client": "Nume Client", "facturi_codf_client": "18181818181", "facturi_suma": "1209.90", "facturi_moneda": "RON", "facturi_obs": "Contravaloare factura FF 123", "facturi_data": "29-01-2019 12:28:49", "facturi_status": "Emisa" } }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "1342457" } }
Modificare Chitanță
Actualizează o chitanță existentă. Identificarea chitanței care se modifică se face după <code>facturi_key</code> din obiectul <code>dataFact</code>. Câmpurile acceptate sunt aceleași ca la adăugare.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru chitanțe:
Chitante.act
Acțiune. Pentru modificare:
Upd.Structura request-ului
dataFact
Obiect cu datele chitanței. Trebuie să conțină
facturi_key cu identificatorul chitanței care se modifică.dataFact — date document
facturi_key
Identificatorul chitanței care va fi modificată. Obligatoriu — îl obții din răspunsul la
Ins sau dintr-un apel Get.facturi_serie
Seria chitanței.
facturi_numar
Numărul chitanței.
facturi_suma
Suma încasată.
facturi_moneda
Moneda (ex.
RON, EUR).facturi_obs
Observații.
facturi_data
Data chitanței (format
DD-MM-YYYY HH:MM:SS).facturi_status
Status chitanță, de regulă
Emisa.dataFact — date client
facturi_nume_client
Denumirea clientului.
facturi_tip_persoana
Tipul persoanei:
fizica · juridica.facturi_codf_client
Codul fiscal al clientului (CUI / CNP).
facturi_nrreg_client
Numărul de la Registrul Comerțului.
facturi_sediu_client
Adresa sediului clientului.
⚠️ facturi_key obligatoriu
Modificarea folosește acțiunea
Upd și necesită facturi_key în dataFact pentru a identifica chitanța existentă.{
"APIkey": "123456789",
"met": "Chitante",
"act": "Upd",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"dataFact": {
"facturi_key": "534592",
"facturi_serie": "CCC",
"facturi_numar": "71",
"facturi_nume_client": "Nume Client",
"facturi_codf_client": "18181818181",
"facturi_nrreg_client": "cd23123213",
"facturi_sediu_client": "Bacau",
"facturi_suma": "1209.90",
"facturi_moneda": "RON",
"facturi_obs": "Contravaloare factura FF 123",
"facturi_data": "29-01-2019 12:28:49",
"facturi_status": "Emisa"
}
}
<?php $values = [ "APIkey" => "123456789", "met" => "Chitante", "act" => "Upd", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", ]; $values['dataFact'] = [ "facturi_key" => "534592", "facturi_serie" => "CCC", "facturi_numar" => "71", "facturi_nume_client" => "Nume Client", "facturi_codf_client" => "18181818181", "facturi_nrreg_client"=> "cd23123213", "facturi_sediu_client"=> "Bacau", "facturi_suma" => "1209.90", "facturi_moneda" => "RON", "facturi_obs" => "Contravaloare factura FF 123", "facturi_data" => "29-01-2019 12:28:49", "facturi_status" => "Emisa", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "met": "Chitante", "act": "Upd", "u": "admin", "p": "magazin", "c": "ro 31234567", "dataFact": { "facturi_key": "534592", "facturi_suma": "1209.90", "facturi_obs": "Contravaloare factura FF 123", "facturi_status": "Emisa" } }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "1342457" } }
Listare Chitanță (PDF)
Returnează documentul PDF al unei chitanțe emise. Chitanța se identifică după <code>id_fact</code>. Parametrul opțional <code>select_language</code> permite alegerea limbii documentului.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru listarea PDF:
FacturiHtml.act
Acțiune. Pentru listarea chitanței:
Chitante.id_fact
Id-ul chitanței care va fi listată.
select_language
Limba documentului:
1 — Română · 2 — Engleză · 3 — Franceză...📄 Format răspuns
Răspunsul este direct conținutul binar al fișierului PDF (nu JSON și nu base64). Salvează corpul răspunsului ca atare într-un fișier
.pdf — în PHP, scrie direct rezultatul cu file_put_contents(), fără decodare.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "RO 31234567",
"met": "FacturiHtml",
"act": "Chitante",
"id_fact": "1761103",
"select_language": "1"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "RO 31234567", "met" => "FacturiHtml", "act" => "Chitante", "id_fact" => "1761103", "select_language" => "1", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); // Răspunsul este direct conținutul binar al PDF-ului file_put_contents("chitanta.pdf", $result);
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "RO 31234567", "met": "FacturiHtml", "act": "Chitante", "id_fact": "1761103", "select_language": "1" }'
200 OK · Content-Type: application/pdf %PDF-1.4 %âãÏÓ ... (conținut binar PDF) ... %%EOF
Afișare Facturi
Returnează lista facturilor emise, împreună cu produsele aferente fiecărei facturi (<code>dataProd</code>). Permite filtrare după interval de dată, status, factură specifică și stare (șterse / active).
POST
https://api.facturis-online.ro/api/?json={json}
Parametri
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru facturi:
Facturi.act
Acțiune. Pentru afișare:
Get.facturi_key
Id-ul facturii — filtrare pentru o singură factură specifică.
date_start
Data de început (format
DD-MM-YYYY).date_stop
Data de sfârșit (format
DD-MM-YYYY).date_startS
Data de început pentru scadență (format
DD-MM-YYYY). Se folosește împreună cu date_stopS.date_stopS
Data de sfârșit pentru scadență (format
DD-MM-YYYY).searchDeleted
Filtrare după stare:
1 — doar facturi șterse · 2 — șterse și active.facturi_emise
Include facturile cu status
Emisa (1 pentru activare).facturi_platite
Include facturile cu status
Platita (1 pentru activare).facturi_partiale
Include facturile cu status
Partial Platita (1 pentru activare).facturi_anulate
Include facturile cu status
Anulata (1 pentru activare).📦 Produse incluse
Fiecare factură conține un array
dataProd cu liniile de produse. Câmpurile facturi_prod_pretftva, facturi_prod_val_tva și facturi_prod_val_tot de la nivelul facturii sunt totaluri agregate pe document.💡 Filtrare după status
Poți combina
facturi_emise, facturi_platite, facturi_partiale și facturi_anulate (fiecare cu valoarea 1) pentru a filtra după unul sau mai multe statusuri. Dacă nu specifici niciunul, se returnează facturile indiferent de status.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Facturi",
"act": "Get",
"date_start": "01-02-2020",
"date_stop": "29-02-2020"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Facturi", "act" => "Get", "date_start" => "01-02-2020", "date_stop" => "29-02-2020", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Facturi", "act": "Get", "date_start": "01-02-2020", "date_stop": "29-02-2020" }'
200 OK { "success": 2000, "result": [ { "facturi_key": "1857678", "facturi_serie": "TEST", "facturi_serie_numar": "141", "facturi_data": "11-02-2020 15:30:52", "facturi_prod_pretftva": "50.00", "facturi_prod_val_tva": "9.50", "facturi_prod_cota_disc": "0.00", "facturi_prod_val_tot": "59.50", "facturi_moneda": "RON", "facturi_status": "Emisa", "facturi_data_scadenta": "02-03-2020", "fk_clienti_key": "245", "facturi_nume_client": "Nume Client", "facturi_codf_client": "18181818181", "facturi_nrreg_client": "cd23123213", "facturi_sediu_client": "Bacau", "clienti_oras": "Bacau", "clienti_country": "Romania", "facturi_judet_client": "Bacau", "fk_pdl_clienti_name": "", "fk_pdl_clienti_address": "", "fk_pdl_clienti_key": "", "clienti_adresa_livrare": "adresa de livrare", "clienti_cod": "", "facturi_cont_client": "Cont", "facturi_banca_client": "banca", "clienti_tel": "", "clienti_email": "", "facturi_tip_persoana": "fizica", "facturi_nume_delegat": "", "facturi_act_delegat": "act delegat", "facturi_obs_delegat": "obs delegat", "fk_agent_name": null, "usr_name": "Iulian Iulian", "facturi_pers_livrare": "Iulian Iulian|AC214234", "pdl_nume": "SEDIUL SOCIAL", "facturi_obs_up": "alte observatii", "facturi_obs_client": "obs_client", "incasare_factura": "", "modalitate_plata_bon": "", "bon_key": "", "mod_plata_cash": "", "mod_plata_card": "", "mod_plata_tiket": "", "mod_plata_voucher": "", "mod_plata_alta_plata": "", "chitante_serie": "", "chitante_serie_numar": "", "bonuri_serie": "", "facturi_cota_tva": "19%", "facturi_cod_fiscal": "", "facturi_status_efactura": "", "facturi_reference_contract": "", "facturi_reference_order": "", "facturi_reference_buyer": "", "facturi_factura_precedenta": "", "facturi_nr_aviz": "", "facturi_nr_aviz_receptie": "", "facturi_ref_contabila_cump": "", "facturi_ref_proiectului": "", "facturi_ref_prod_document": "", "facturi_ref_prod_comanda": "", "invoice_view_link": "https://api.facturis-online.ro/...&doc_type=invoice&hash_invoice=...", "dataProd": [ { "facturi_prod_nume": "170-092XNV", "facturi_prod_moneda": "RON", "facturi_prod_pretftva": "50", "facturi_prod_pretctva": "59.5", "facturi_prod_cant": "1.000", "facturi_prod_val": "50", "facturi_prod_val_tva": "9.5", "facturi_prod_val_tot": "59.5", "prod_cod": "", "prod_sku": "", "prod_cod1": "", "prod_cod_cautare": "prod_cod", "facturi_prod_tva": "19%" } ] } ] }
Adăugare Factură
Creează o factură nouă, împreună cu produsele aferente. Datele documentului și ale clientului se trimit în obiectul <code>dataFact</code>, iar liniile de produse în array-ul <code>dataProd</code>. Identificarea clientului se face automat după codul fiscal sau nume; dacă nu există în nomenclator, este adăugat automat. Returnează id-ul facturii create.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru facturi:
Facturi.act
Acțiune. Pentru inserare:
Ins.Structura request-ului
dataFact
Obiect cu datele facturii: document, client, livrare, delegat, status.
dataProd
Array de obiecte — liniile de produse ale facturii.
dataFact — date document
facturi_key
Identificator factură. Lăsat gol la adăugare — generat automat de sistem.
facturi_punct_de_lucru
Punctul de lucru.
facturi_gestiune
Gestiunea.
facturi_data
Data emiterii (format
YYYY-MM-DD HH:MM:SS).facturi_data_scadenta
Data scadenței (format
YYYY-MM-DD).facturi_serie
Seria facturii.
facturi_numar
Numărul facturii. Lasă gol pentru auto-incrementare.
facturi_cota_tva
Cota de TVA a documentului (ex.
19%).facturi_moneda
Moneda (ex.
RON, EUR).facturi_status
Status factură, de regulă
Emisa.facturi_obs_up
Alte observații pe document.
fk_agent_name
Denumirea agentului asociat.
incasare_factura
Metoda de plată a facturii. Se completează cu
Chitanta pentru a genera automat o chitanță la încasare.chitanta_serie
Seria chitanței generate (când
incasare_factura = Chitanta).dataFact — date client
facturi_nume_client
Denumirea clientului.
facturi_tip_persoana
Tipul persoanei:
fizica · juridica.facturi_codf_client
Codul fiscal al clientului (CUI / CNP).
facturi_nrreg_client
Numărul de la Registrul Comerțului.
facturi_sediu_client
Adresa sediului clientului.
facturi_judet_client
Județul clientului.
facturi_oras_client
Orașul clientului.
facturi_tara_client
Țara clientului.
facturi_cont_client
Contul bancar al clientului.
facturi_banca_client
Banca clientului.
facturi_clienti_tel
Telefonul clientului.
facturi_obs_client
Observații client.
dataFact — date livrare și delegat
facturi_clienti_adresa_livrare
Adresa de livrare.
facturi_clienti_judet_livrare
Județul de livrare.
facturi_clienti_oras_livrare
Orașul de livrare.
facturi_nume_delegat
Denumirea delegatului.
facturi_act_delegat
Actul de identitate al delegatului.
facturi_obs_delegat
Observații delegat.
dataProd[] — linie produs
facturi_prod_nume
Denumirea produsului.
facturi_prod_moneda
Moneda liniei.
facturi_prod_pretftva
Prețul unitar fără TVA.
facturi_prod_pretctva
Prețul unitar cu TVA.
facturi_prod_cant
Cantitatea.
facturi_prod_val
Valoarea fără TVA.
facturi_prod_val_tva
Valoarea TVA.
facturi_prod_val_tot
Valoarea totală a liniei.
prod_cod
Cod EAN.
prod_sku
Cod SKU.
prod_cod1
Alt cod.
prod_cod_cautare
Codul de identificare folosit la căutarea produsului în aplicație:
prod_cod · prod_sku · prod_cod1.facturi_prod_tva
Cota de TVA a produsului (ex.
19%).⚠️ Atenție
Identificarea clientului se face automat după CUI (juridice) sau nume (fizice). Dacă nu există în baza de date, se inserează automat în Nomenclatorul de Clienți.
🧾 Chitanță la încasare
Completează
incasare_factura cu Chitanta pentru a genera automat o chitanță odată cu factura. Opțional, poți specifica chitanta_serie.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Facturi",
"act": "Ins",
"dataFact": {
"facturi_key": "",
"facturi_punct_de_lucru": "",
"facturi_gestiune": "",
"facturi_data": "2019-01-09 15:30:52",
"facturi_data_scadenta": "2019-01-31",
"facturi_serie": "",
"facturi_numar": "",
"facturi_cota_tva": "19%",
"facturi_moneda": "RON",
"facturi_nume_client": "Nume Client",
"facturi_tip_persoana": "fizica",
"facturi_codf_client": "18181818181",
"facturi_nrreg_client": "cd23123213",
"facturi_sediu_client": "Bacau",
"facturi_judet_client": "Bacau",
"facturi_oras_client": "Bacau",
"facturi_tara_client": "Romania",
"facturi_cont_client": "Cont",
"facturi_banca_client": "banca",
"facturi_clienti_adresa_livrare": "adresa de livrare",
"facturi_clienti_judet_livrare": "judetul de livrare",
"facturi_clienti_oras_livrare": "orasul de livrare",
"facturi_clienti_tel": "telefon client",
"facturi_obs_client": "obs_client",
"facturi_nume_delegat": "nume delegat",
"facturi_act_delegat": "act delegat",
"facturi_obs_delegat": "obs delegat",
"facturi_obs_up": "alte observatii",
"facturi_status": "Emisa",
"fk_agent_name": "Nume Agent",
"incasare_factura": "Chitanta",
"chitanta_serie": ""
},
"dataProd": [
{
"facturi_prod_nume": "produs test1",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "50",
"facturi_prod_pretctva": "59.5",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "50",
"facturi_prod_val_tva": "9.5",
"facturi_prod_val_tot": "59.5",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
},
{
"facturi_prod_nume": "produs test2",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "456",
"facturi_prod_pretctva": "542.64",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "456",
"facturi_prod_val_tva": "86.64",
"facturi_prod_val_tot": "542.64",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
}
]
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Facturi", "act" => "Ins", ]; $values['dataFact'] = [ "facturi_data" => "2019-01-09 15:30:52", "facturi_data_scadenta" => "2019-01-31", "facturi_cota_tva" => "19%", "facturi_moneda" => "RON", "facturi_nume_client" => "Nume Client", "facturi_tip_persoana" => "fizica", "facturi_codf_client" => "18181818181", "facturi_status" => "Emisa", "incasare_factura" => "Chitanta", ]; $values['dataProd'] = [ [ "facturi_prod_nume" => "produs test1", "facturi_prod_moneda" => "RON", "facturi_prod_pretftva" => "50", "facturi_prod_pretctva" => "59.5", "facturi_prod_cant" => "1.000", "facturi_prod_val" => "50", "facturi_prod_val_tva" => "9.5", "facturi_prod_val_tot" => "59.5", "prod_cod_cautare" => "prod_cod", "facturi_prod_tva" => "19%", ], ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Facturi", "act": "Ins", "dataFact": { "facturi_data": "2019-01-09 15:30:52", "facturi_data_scadenta": "2019-01-31", "facturi_cota_tva": "19%", "facturi_moneda": "RON", "facturi_nume_client": "Nume Client", "facturi_tip_persoana": "fizica", "facturi_codf_client": "18181818181", "facturi_status": "Emisa", "incasare_factura": "Chitanta" }, "dataProd": [ { "facturi_prod_nume": "produs test1", "facturi_prod_pretftva": "50", "facturi_prod_pretctva": "59.5", "facturi_prod_cant": "1.000", "prod_cod_cautare": "prod_cod", "facturi_prod_tva": "19%" } ] }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "92382888" } }
Modificare Factură
Actualizează o factură existentă, împreună cu produsele aferente. Identificarea facturii care se modifică se face după <code>facturi_key</code> din obiectul <code>dataFact</code>. Câmpurile acceptate sunt aceleași ca la adăugare.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru facturi:
Facturi.act
Acțiune. Pentru modificare:
Upd.Structura request-ului
dataFact
Obiect cu datele facturii. Trebuie să conțină
facturi_key cu identificatorul facturii care se modifică.dataProd
Array de obiecte — liniile de produse ale facturii.
dataFact — date document
facturi_key
Identificatorul facturii care va fi modificată. Obligatoriu — îl obții din răspunsul la
Ins sau dintr-un apel Get.facturi_punct_de_lucru
Punctul de lucru.
facturi_gestiune
Gestiunea.
facturi_data
Data emiterii (format
YYYY-MM-DD HH:MM:SS).facturi_data_scadenta
Data scadenței (format
YYYY-MM-DD).facturi_serie
Seria facturii.
facturi_numar
Numărul facturii.
facturi_cota_tva
Cota de TVA a documentului (ex.
19%).facturi_moneda
Moneda (ex.
RON, EUR).facturi_status
Status factură, de regulă
Emisa.facturi_obs_up
Alte observații pe document.
dataFact — date client
facturi_nume_client
Denumirea clientului.
facturi_tip_persoana
Tipul persoanei:
fizica · juridica.facturi_codf_client
Codul fiscal al clientului (CUI / CNP).
facturi_nrreg_client
Numărul de la Registrul Comerțului.
facturi_sediu_client
Adresa sediului clientului.
facturi_judet_client
Județul clientului.
facturi_oras_client
Orașul clientului.
facturi_tara_client
Țara clientului.
facturi_cont_client
Contul bancar al clientului.
facturi_banca_client
Banca clientului.
facturi_clienti_adresa_livrare
Adresa de livrare.
facturi_obs_client
Observații client.
facturi_nume_delegat
Denumirea delegatului.
facturi_act_delegat
Actul de identitate al delegatului.
facturi_obs_delegat
Observații delegat.
dataProd[] — linie produs
facturi_prod_nume
Denumirea produsului.
facturi_prod_moneda
Moneda liniei.
facturi_prod_pretftva
Prețul unitar fără TVA.
facturi_prod_pretctva
Prețul unitar cu TVA.
facturi_prod_cant
Cantitatea.
facturi_prod_val
Valoarea fără TVA.
facturi_prod_val_tva
Valoarea TVA.
facturi_prod_val_tot
Valoarea totală a liniei.
prod_cod
Cod EAN.
prod_sku
Cod SKU.
prod_cod1
Alt cod.
prod_cod_cautare
Codul de identificare folosit la căutarea produsului:
prod_cod · prod_sku · prod_cod1.facturi_prod_tva
Cota de TVA a produsului (ex.
19%).⚠️ facturi_key obligatoriu
Modificarea folosește acțiunea
Upd și necesită facturi_key în dataFact pentru a identifica factura existentă.🔄 Înlocuire produse
La modificare, array-ul
dataProd înlocuiește liniile existente ale facturii. Trimite întreaga listă de produse, nu doar liniile modificate.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Facturi",
"act": "Upd",
"dataFact": {
"facturi_key": "63448",
"facturi_punct_de_lucru": "",
"facturi_gestiune": "",
"facturi_data": "2019-01-09 15:30:52",
"facturi_data_scadenta": "2019-01-31",
"facturi_serie": "",
"facturi_numar": "",
"facturi_cota_tva": "19%",
"facturi_moneda": "RON",
"facturi_nume_client": "Nume Client",
"facturi_tip_persoana": "fizica",
"facturi_codf_client": "18181818181",
"facturi_nrreg_client": "cd23123213",
"facturi_sediu_client": "Bacau",
"facturi_judet_client": "Bacau",
"facturi_oras_client": "Bacau",
"facturi_tara_client": "Romania",
"facturi_cont_client": "Cont",
"facturi_banca_client": "banca",
"facturi_clienti_adresa_livrare": "adresa de livrare",
"facturi_obs_client": "obs_client",
"facturi_nume_delegat": "nume delegat",
"facturi_act_delegat": "act delegat",
"facturi_obs_delegat": "obs delegat",
"facturi_obs_up": "alte observatii",
"facturi_status": "Emisa"
},
"dataProd": [
{
"facturi_prod_nume": "produs test1",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "50",
"facturi_prod_pretctva": "59.5",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "50",
"facturi_prod_val_tva": "9.5",
"facturi_prod_val_tot": "59.5",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
},
{
"facturi_prod_nume": "produs test2",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "456",
"facturi_prod_pretctva": "542.64",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "456",
"facturi_prod_val_tva": "86.64",
"facturi_prod_val_tot": "542.64",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
}
]
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Facturi", "act" => "Upd", ]; $values['dataFact'] = [ "facturi_key" => "63448", "facturi_data" => "2019-01-09 15:30:52", "facturi_data_scadenta" => "2019-01-31", "facturi_cota_tva" => "19%", "facturi_moneda" => "RON", "facturi_nume_client" => "Nume Client", "facturi_tip_persoana" => "fizica", "facturi_codf_client" => "18181818181", "facturi_status" => "Emisa", ]; $values['dataProd'] = [ [ "facturi_prod_nume" => "produs test1", "facturi_prod_moneda" => "RON", "facturi_prod_pretftva" => "50", "facturi_prod_pretctva" => "59.5", "facturi_prod_cant" => "1.000", "facturi_prod_val" => "50", "facturi_prod_val_tva" => "9.5", "facturi_prod_val_tot" => "59.5", "prod_cod_cautare" => "prod_cod", "facturi_prod_tva" => "19%", ], ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Facturi", "act": "Upd", "dataFact": { "facturi_key": "63448", "facturi_data": "2019-01-09 15:30:52", "facturi_cota_tva": "19%", "facturi_moneda": "RON", "facturi_nume_client": "Nume Client", "facturi_status": "Emisa" }, "dataProd": [ { "facturi_prod_nume": "produs test1", "facturi_prod_pretftva": "50", "facturi_prod_pretctva": "59.5", "facturi_prod_cant": "1.000", "prod_cod_cautare": "prod_cod", "facturi_prod_tva": "19%" } ] }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "92382888" } }
Listare Factură (PDF)
Generează și returnează documentul PDF al unei facturi. Spre deosebire de celelalte endpoint-uri, această cerere folosește metoda <code>FacturiHtml</code> cu acțiunea <code>Facturi</code>, iar răspunsul este un fișier PDF (binar), <strong>nu</strong> JSON. Factura se identifică după <code>id_fact</code> sau, alternativ, după <code>serie</code> + <code>nr</code>. Opțional se pot seta limba, moneda și formatul de tipărire.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru listare PDF:
FacturiHtml.act
Acțiune. Pentru listare PDF:
Facturi.id_fact
Id-ul facturii. Dacă lipsește, factura poate fi identificată prin
serie + nr.serie
Seria facturii (opțional — alternativă la
id_fact).nr
Numărul facturii (opțional — alternativă la
id_fact).select_language
Limba documentului:
1 — Română · 2 — Engleză · 3 — Franceză ... (opțional).select_currency
Moneda documentului:
RON · EUR · USD ... (opțional).select_format
Formatul de tipărire:
1 — A4 · 2 — Rolă termică 58mm · 3 — Rolă termică 80mm ... (opțional).📄 Răspuns PDF, nu JSON
Acest endpoint returnează direct fișierul PDF (binar). Nu încerca să-l decodezi ca JSON — salvează-l într-un fișier
.pdf (în cURL folosește --output, în PHP file_put_contents).🔎 Identificare factură
Trimite
id_fact pentru identificare directă. Alternativ, poți folosi combinația serie + nr.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "RO 31234567",
"met": "FacturiHtml",
"act": "Facturi",
"id_fact": "1761103",
"serie": "AA",
"nr": "123",
"select_language": "1",
"select_currency": "RON",
"select_format": "1"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "RO 31234567", "met" => "FacturiHtml", "act" => "Facturi", "id_fact" => "1761103", "serie" => "AA", "nr" => "123", "select_language" => "1", "select_currency" => "RON", "select_format" => "1", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $pdf = curl_exec($ch); curl_close($ch); // Răspunsul este conținutul PDF (binar) — îl salvăm într-un fișier. file_put_contents("factura_1761103.pdf", $pdf); echo "PDF salvat.";
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "RO 31234567", "met": "FacturiHtml", "act": "Facturi", "id_fact": "1761103", "serie": "AA", "nr": "123", "select_language": "1", "select_currency": "RON", "select_format": "1" }' \ --output factura_1761103.pdf
200 OK · Content-Type: application/pdf // Răspunsul este documentul PDF (conținut binar), nu JSON. // Salvează-l direct într-un fișier .pdf (vezi exemplele PHP / cURL). %PDF-1.7 ...conținut binar PDF... %%EOF
Modificare Status Factură
Schimbă statusul unei facturi existente, identificată prin <code>facturi_key</code>. Statusul trebuie să fie una dintre valorile acceptate. Dacă factura necesită raportare în e-Factura (SPV), sistemul actualizează automat și statusul e-Factura: îl setează pe <code>De Trimis</code> la activare, respectiv îl golește când factura este trecută pe <code>Anulata</code>.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru facturi:
Facturi.act
Acțiune. Pentru modificare status:
ChangeStatus.facturi_key
Identificatorul facturii al cărei status se modifică. Obligatoriu.
facturi_status
Noul status. Valori acceptate:
Emisa · Platita · Partial Platita · Anulata.⚠️ Status valid obligatoriu
Statusul trimis în
facturi_status trebuie să fie una dintre valorile acceptate (Emisa, Platita, Partial Platita, Anulata). Un status invalid sau lipsa lui facturi_key returnează eroare.📡 Sincronizare e-Factura
Pentru facturile care necesită raportare în SPV, statusul e-Factura se actualizează automat: devine
De Trimis când factura este activă, respectiv se golește când factura trece pe Anulata.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Facturi",
"act": "ChangeStatus",
"facturi_key": "1857997",
"facturi_status": "Platita"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Facturi", "act" => "ChangeStatus", "facturi_key" => "1857997", "facturi_status" => "Platita", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Facturi", "act": "ChangeStatus", "facturi_key": "1857997", "facturi_status": "Platita" }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "92382888" } }
Adăugare Proformă
Creează o proformă nouă cu produsele specificate. Identificarea clientului se face automat după codul fiscal (pentru persoane juridice) sau după nume (pentru persoane fizice). Dacă clientul nu există în nomenclator, este adăugat automat.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru proforme:
Proforme.act
Acțiune. Pentru inserare:
Ins.Structura request-ului
dataFact
Obiect cu datele proformei: client, dată emitere, sediu, delegat, observații, status etc.
dataProd
Array de produse. Fiecare produs este un obiect separat cu cantități, prețuri și cotă TVA.
dataFact — date document
facturi_key
Identificator proformă. Lăsat gol la adăugare — generat automat de sistem.
facturi_punct_de_lucru
Punctul de lucru.
facturi_gestiune
Gestiunea din care se face descărcarea.
facturi_data
Data emiterii proformei (format
YYYY-MM-DD HH:MM:SS).facturi_data_scadenta
Data scadență (format
YYYY-MM-DD).facturi_serie
Seria proformei. Lasă gol pentru auto-incrementare.
facturi_numar
Numărul proformei. Lasă gol pentru auto-incrementare.
facturi_cota_tva
Cota de TVA implicită a documentului (ex.
19%).facturi_moneda
Moneda documentului (ex.
RON, EUR).facturi_status
Status proformă, de regulă
Emisa.fk_agent_name
Numele agentului asociat documentului.
dataFact — date client
facturi_nume_client
Denumirea clientului.
facturi_tip_persoana
Tipul persoanei:
fizica · juridica.facturi_codf_client
Codul fiscal al clientului (CUI / CNP).
facturi_nrreg_client
Numărul de la Registrul Comerțului.
facturi_sediu_client
Adresa sediului clientului.
facturi_judet_client
Județul clientului.
facturi_oras_client
Orașul clientului.
facturi_tara_client
Țara clientului.
facturi_cont_client
Contul IBAN al clientului.
facturi_banca_client
Banca clientului.
facturi_clienti_tel
Numărul de telefon al clientului.
facturi_clienti_adresa_livrare
Adresa de livrare a clientului.
facturi_clienti_judet_livrare
Județul de livrare.
facturi_clienti_oras_livrare
Orașul de livrare.
facturi_obs_client
Observații despre client.
dataFact — delegat și observații
facturi_nume_delegat
Numele delegatului.
facturi_act_delegat
Actul de identitate al delegatului.
facturi_obs_delegat
Observații despre delegat.
facturi_obs_up
Alte observații pe document.
dataProd — produse (per element)
facturi_prod_nume
Denumirea produsului.
facturi_prod_moneda
Moneda produsului.
facturi_prod_pretftva
Prețul unitar fără TVA.
facturi_prod_pretctva
Prețul unitar cu TVA.
facturi_prod_cant
Cantitatea.
facturi_prod_val
Valoarea fără TVA (preț × cantitate).
facturi_prod_val_tva
Valoarea TVA.
facturi_prod_val_tot
Valoarea totală (cu TVA).
facturi_prod_tva
Cota de TVA a produsului (ex.
19%).prod_cod
Codul EAN al produsului.
prod_sku
Codul SKU al produsului.
prod_cod1
Cod alternativ al produsului.
prod_cod_cautare
Câmpul după care se identifică produsul în aplicație:
prod_cod · prod_sku · prod_cod1.⚠️ Atenție
Identificarea clientului se face automat după CUI (juridice) sau nume (fizice). Dacă nu există în baza de date, se inserează automat în Nomenclatorul de Clienți.
💡 Identificarea produselor
Câmpul
prod_cod_cautare indică după ce câmp este căutat produsul în Nomenclator: prod_cod (EAN), prod_sku sau prod_cod1. Trimite valoarea corespunzătoare în câmpul indicat (prod_cod / prod_sku / prod_cod1).📦 Mai multe produse
Array-ul
dataProd poate conține oricâte produse — fiecare ca obiect separat. Totalurile documentului se calculează prin însumarea valorilor de pe fiecare linie.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Proforme",
"act": "Ins",
"dataFact": {
"facturi_key": "",
"facturi_punct_de_lucru": "",
"facturi_gestiune": "",
"facturi_data": "2019-01-09 15:30:52",
"facturi_data_scadenta": "2019-01-31",
"facturi_serie": "",
"facturi_numar": "",
"facturi_cota_tva": "19%",
"facturi_moneda": "RON",
"facturi_nume_client": "Nume Client",
"facturi_tip_persoana": "fizica",
"facturi_codf_client": "18181818181",
"facturi_nrreg_client": "cd23123213",
"facturi_sediu_client": "Bacau",
"facturi_judet_client": "Bacau",
"facturi_oras_client": "Bacau",
"facturi_tara_client": "Romania",
"facturi_cont_client": "Cont",
"facturi_banca_client": "banca",
"facturi_clienti_adresa_livrare": "adresa de livrare",
"clienti_judet_livrare": "judetul de livrare",
"facturi_clienti_oras_livrare": "orasul de livrare",
"facturi_obs_client": "obs_client",
"facturi_nume_delegat": "nume delegat",
"facturi_act_delegat": "act delegat",
"facturi_obs_delegat": "obs delegat",
"facturi_obs_up": "alte observatii",
"facturi_status": "Emisa",
"fk_agent_name": "Nume Agent"
},
"dataProd": [
{
"facturi_prod_nume": "produs test1",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "50",
"facturi_prod_pretctva": "59.5",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "50",
"facturi_prod_val_tva": "9.5",
"facturi_prod_val_tot": "59.5",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
},
{
"facturi_prod_nume": "produs test2",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "456",
"facturi_prod_pretctva": "542.64",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "456",
"facturi_prod_val_tva": "86.64",
"facturi_prod_val_tot": "542.64",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
}
]
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Proforme", "act" => "Ins", ]; $values['dataFact'] = [ "facturi_key" => "", "facturi_data" => "2019-01-09 15:30:52", "facturi_data_scadenta" => "2019-01-31", "facturi_cota_tva" => "19%", "facturi_moneda" => "RON", "facturi_nume_client" => "Nume Client", "facturi_tip_persoana" => "fizica", "facturi_codf_client" => "18181818181", "facturi_status" => "Emisa", ]; $values['dataProd'][0] = [ "facturi_prod_nume" => "produs test1", "facturi_prod_pretftva" => "50", "facturi_prod_cant" => "1.000", "facturi_prod_tva" => "19%", "prod_cod_cautare" => "prod_cod", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Proforme", "act": "Ins", "dataFact": { "facturi_data": "2019-01-09 15:30:52", "facturi_nume_client": "Nume Client", "facturi_codf_client": "18181818181", "facturi_status": "Emisa" }, "dataProd": [ { "facturi_prod_nume": "produs test1", "facturi_prod_pretftva": "50", "facturi_prod_cant": "1.000", "facturi_prod_tva": "19%", "prod_cod_cautare": "prod_cod" } ] }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "82823249" } }
Modificare Proformă
Actualizează o proformă existentă folosind acțiunea <code>Upd</code>. În obiectul <code>dataFact</code> trimiți <code>facturi_key</code> cu identificatorul proformei existente. La salvare, produsele din <code>dataProd</code> înlocuiesc complet liniile proformei.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru proforme:
Proforme.act
Acțiune. Pentru modificare:
Upd.Structura request-ului
dataFact
Obiect cu datele proformei. Trebuie să conțină
facturi_key cu identificatorul proformei care se modifică.dataProd
Array de produse care înlocuiesc liniile existente ale proformei.
dataFact — date document
facturi_key
Identificatorul proformei care va fi modificată. Obligatoriu — îl obții din răspunsul la
Ins.facturi_punct_de_lucru
Punctul de lucru.
facturi_gestiune
Gestiunea din care se face descărcarea.
facturi_data
Data emiterii proformei (format
YYYY-MM-DD HH:MM:SS).facturi_data_scadenta
Data scadență (format
YYYY-MM-DD).facturi_serie
Seria proformei.
facturi_numar
Numărul proformei.
facturi_cota_tva
Cota de TVA implicită a documentului.
facturi_moneda
Moneda documentului.
facturi_status
Status proformă, de regulă
Emisa.dataFact — date client
facturi_nume_client
Denumirea clientului.
facturi_tip_persoana
Tipul persoanei:
fizica · juridica.facturi_codf_client
Codul fiscal al clientului (CUI / CNP).
facturi_nrreg_client
Numărul de la Registrul Comerțului.
facturi_sediu_client
Adresa sediului clientului.
facturi_judet_client
Județul clientului.
facturi_oras_client
Orașul clientului.
facturi_tara_client
Țara clientului.
facturi_cont_client
Contul IBAN al clientului.
facturi_banca_client
Banca clientului.
facturi_clienti_adresa_livrare
Adresa de livrare a clientului.
facturi_obs_client
Observații despre client.
dataFact — delegat și observații
facturi_nume_delegat
Numele delegatului.
facturi_act_delegat
Actul de identitate al delegatului.
facturi_obs_delegat
Observații despre delegat.
facturi_obs_up
Alte observații pe document.
dataProd — produse (per element)
facturi_prod_nume
Denumirea produsului.
facturi_prod_moneda
Moneda produsului.
facturi_prod_pretftva
Prețul unitar fără TVA.
facturi_prod_pretctva
Prețul unitar cu TVA.
facturi_prod_cant
Cantitatea.
facturi_prod_val
Valoarea fără TVA (preț × cantitate).
facturi_prod_val_tva
Valoarea TVA.
facturi_prod_val_tot
Valoarea totală (cu TVA).
facturi_prod_tva
Cota de TVA a produsului (ex.
19%).prod_cod
Codul EAN al produsului.
prod_sku
Codul SKU al produsului.
prod_cod1
Cod alternativ al produsului.
prod_cod_cautare
Câmpul după care se identifică produsul:
prod_cod · prod_sku · prod_cod1.⚠️ Produsele se înlocuiesc
La modificare, liniile din
dataProd înlocuiesc complet produsele proformei. Trimite întotdeauna lista completă a produselor dorite, nu doar cele modificate.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Proforme",
"act": "Upd",
"dataFact": {
"facturi_key": "63448",
"facturi_punct_de_lucru": "",
"facturi_gestiune": "",
"facturi_data": "2019-01-09 15:30:52",
"facturi_data_scadenta": "2019-01-31",
"facturi_serie": "",
"facturi_numar": "",
"facturi_cota_tva": "19%",
"facturi_moneda": "RON",
"facturi_nume_client": "Nume Client",
"facturi_tip_persoana": "fizica",
"facturi_codf_client": "18181818181",
"facturi_nrreg_client": "cd23123213",
"facturi_sediu_client": "Bacau",
"facturi_judet_client": "Bacau",
"facturi_oras_client": "Bacau",
"facturi_tara_client": "Romania",
"facturi_cont_client": "Cont",
"facturi_banca_client": "banca",
"facturi_clienti_adresa_livrare": "adresa de livrare",
"facturi_obs_client": "obs_client",
"facturi_nume_delegat": "nume delegat",
"facturi_act_delegat": "act delegat",
"facturi_obs_delegat": "obs delegat",
"facturi_obs_up": "alte observatii",
"facturi_status": "Emisa"
},
"dataProd": [
{
"facturi_prod_nume": "produs test1",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "50",
"facturi_prod_pretctva": "59.5",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "50",
"facturi_prod_val_tva": "9.5",
"facturi_prod_val_tot": "59.5",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
},
{
"facturi_prod_nume": "produs test2",
"facturi_prod_moneda": "RON",
"facturi_prod_pretftva": "456",
"facturi_prod_pretctva": "542.64",
"facturi_prod_cant": "1.000",
"facturi_prod_val": "456",
"facturi_prod_val_tva": "86.64",
"facturi_prod_val_tot": "542.64",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
}
]
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Proforme", "act" => "Upd", ]; $values['dataFact'] = [ "facturi_key" => "63448", "facturi_data" => "2019-01-09 15:30:52", "facturi_data_scadenta" => "2019-01-31", "facturi_cota_tva" => "19%", "facturi_moneda" => "RON", "facturi_nume_client" => "Nume Client", "facturi_tip_persoana" => "fizica", "facturi_codf_client" => "18181818181", "facturi_status" => "Emisa", ]; $values['dataProd'][0] = [ "facturi_prod_nume" => "produs test1", "facturi_prod_pretftva" => "50", "facturi_prod_cant" => "1.000", "facturi_prod_tva" => "19%", "prod_cod_cautare" => "prod_cod", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Proforme", "act": "Upd", "dataFact": { "facturi_key": "63448", "facturi_data": "2019-01-09 15:30:52", "facturi_nume_client": "Nume Client", "facturi_codf_client": "18181818181", "facturi_status": "Emisa" }, "dataProd": [ { "facturi_prod_nume": "produs test1", "facturi_prod_pretftva": "50", "facturi_prod_cant": "1.000", "facturi_prod_tva": "19%", "prod_cod_cautare": "prod_cod" } ] }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "82823249" } }
Listare Proformă (PDF)
Returnează documentul PDF al unei proforme emise. Proforma se identifică după <code>id_fact</code>; alternativ poate fi identificată prin combinația <code>serie</code> + <code>nr</code>. Parametrii opționali permit alegerea limbii, monedei și formatului de tipărire.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru listarea PDF:
FacturiHtml.act
Acțiune. Pentru listare:
Facturi.id_fact
Id-ul proformei care va fi listată.
type
Tipul documentului — pentru proforme:
proforma.serie
Seria proformei. Alternativă la
id_fact, folosită împreună cu nr pentru identificarea documentului.nr
Numărul proformei. Alternativă la
id_fact, folosit împreună cu serie.select_language
Limba documentului:
1 — Română · 2 — Engleză · 3 — Franceză...select_currency
Moneda de afișare (ex.
RON, EUR, USD...).select_format
Formatul de tipărire:
1 — A4 · 2 — Rolă termică 58mm · 3 — Rolă termică 80mm...📄 Format răspuns
Răspunsul este direct conținutul binar al fișierului PDF (nu JSON și nu base64). Salvează corpul răspunsului ca atare într-un fișier
.pdf — în PHP, scrie direct rezultatul cu file_put_contents(), fără decodare.💡 Identificare document
Proforma se identifică prin
id_fact. Alternativ, poți folosi combinația serie + nr. Parametrul type trebuie să fie proforma pentru acest tip de document.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "RO 31234567",
"met": "FacturiHtml",
"act": "Facturi",
"id_fact": "1761103",
"serie": "AA",
"nr": "123",
"type": "proforma",
"select_language": "1",
"select_currency": "RON",
"select_format": "1"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "RO 31234567", "met" => "FacturiHtml", "act" => "Facturi", "id_fact" => "1761103", "type" => "proforma", "select_language" => "1", "select_currency" => "RON", "select_format" => "1", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); // Răspunsul este direct conținutul binar al PDF-ului file_put_contents("proforma.pdf", $result);
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "RO 31234567", "met": "FacturiHtml", "act": "Facturi", "id_fact": "1761103", "type": "proforma", "select_language": "1", "select_currency": "RON", "select_format": "1" }'
200 OK · Content-Type: application/pdf %PDF-1.4 %âãÏÓ ... (conținut binar PDF) ... %%EOF
Afișare Încasări
Returnează lista de încasări din registru. Permite filtrare după interval de dată, client, serie document, monedă și tip de încasare.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru încasări:
RegistruIncasari.act
Acțiune. Pentru afișare:
Get.date_start
Data de început pentru filtrare (format
DD-MM-YYYY).date_stop
Data de sfârșit pentru filtrare (format
DD-MM-YYYY).incasari_client
Id-ul clientului — filtrare după client.
incasari_serie
Seria și numărul documentului de încasare — filtrare după document.
incasari_moneda
Moneda încasării (ex.
RON, EUR, USD).incasari_tip
Tipul încasării:
Banca · Card · Cash · Trezorerie · Altceva.💡 Sfat
Toți parametrii de filtrare sunt opționali. Dacă nu specifici
date_start/date_stop, se returnează toate încasările din registru. Poți combina filtrele (client, serie, monedă, tip) pentru rezultate mai precise.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "RO 31234567",
"met": "RegistruIncasari",
"act": "Get",
"date_start": "01-05-2022",
"date_stop": "10-05-2022",
"incasari_client": "101",
"incasari_serie": "FF 1234",
"incasari_moneda": "RON",
"incasari_tip": "cash"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "RO 31234567", "met" => "RegistruIncasari", "act" => "Get", "date_start" => "01-05-2022", "date_stop" => "10-05-2022", "incasari_client" => "101", "incasari_moneda" => "RON", "incasari_tip" => "cash", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "RO 31234567", "met": "RegistruIncasari", "act": "Get", "date_start": "01-05-2022", "date_stop": "10-05-2022", "incasari_client": "101" }'
200 OK { "success": 2000, "result": [ { "incasari_key": "1857678", "incasari_client": "TEST", "clienti_cod": "141", "incasari_serie": "FF 1234", "incasari_data": "22-06-2015 11:13:08", "incasari_suma": "300.00", "incasari_moneda": "RON", "incasari_tip": "Cash", "incasari_obs": "Contravaloare facturi: TEST 71; TEST 62; TEST 65; TEST 69;", "tip": "Incasare", "fk_clienti_key": "101", "fk_firme_key": "2107", "usr_name": "", "pdl_nume": "SEDIUL SOCIAL" } ] }
Adăugare Încasare
Adaugă o încasare nouă în registru. Toți parametrii se trimit la nivel de top (nu există <code>dataFact</code>/<code>dataProd</code>). Opțional, încasarea poate fi împerecheată cu una sau mai multe facturi prin array-ul <code>idFacturi</code>.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru încasări:
RegistruIncasari.act
Acțiune. Pentru inserare:
Ins.Date încasare
fk_clienti_key
Id-ul clientului pentru care se înregistrează încasarea.
incasari_data
Data încasării (format
DD-MM-YYYY HH:MM:SS).incasari_suma
Suma încasată.
incasari_serie
Seria și numărul documentului de încasare.
incasari_moneda
Moneda încasării (ex.
RON, EUR, USD).incasari_tip
Tipul încasării:
Banca · Card · Cash · Trezorerie · Altceva.incasari_obs
Observații încasare (ex.
Contravaloare facturi: aaa 29; aaa 40).Împerechere facturi
idFacturi
Array de id-uri de facturi care se doresc împerecheate cu această plată (ex.
[10, 25]).🔗 Împerechere cu facturi
Array-ul
idFacturi este opțional. Dacă îl trimiți, încasarea se asociază cu facturile indicate prin id-urile lor. Lasă-l gol sau omite-l pentru o încasare neasociată.💳 Tipuri de încasare
Câmpul
incasari_tip acceptă valorile: Banca, Card, Cash, Trezorerie, Altceva.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "RO 31234567",
"met": "RegistruIncasari",
"act": "Ins",
"fk_clienti_key": "101",
"incasari_data": "09-05-2022 18:22:06",
"incasari_suma": "10.52",
"incasari_serie": "FF 1234",
"incasari_moneda": "RON",
"incasari_tip": "cash",
"incasari_obs": "Contravaloare facturi: aaa 29; aaa 40;",
"idFacturi": [10, 25]
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "RO 31234567", "met" => "RegistruIncasari", "act" => "Ins", "fk_clienti_key" => "101", "incasari_data" => "09-05-2022 18:22:06", "incasari_suma" => "10.52", "incasari_serie" => "FF 1234", "incasari_moneda" => "RON", "incasari_tip" => "cash", "incasari_obs" => "Contravaloare facturi: aaa 29; aaa 40;", "idFacturi" => [10, 25], ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "RO 31234567", "met": "RegistruIncasari", "act": "Ins", "fk_clienti_key": "101", "incasari_data": "09-05-2022 18:22:06", "incasari_suma": "10.52", "incasari_serie": "FF 1234", "incasari_moneda": "RON", "incasari_tip": "cash", "incasari_obs": "Contravaloare facturi: aaa 29; aaa 40;", "idFacturi": [10, 25] }'
200 OK { "success": 2000, "result": "Datele au fost salvate cu succes!" }
Modificare Încasare
Actualizează o încasare existentă din registru. Identificarea încasării care se modifică se face prin <code>incasari_key</code>. Restul câmpurilor sunt aceleași ca la adăugare.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru încasări:
RegistruIncasari.act
Acțiune. Pentru modificare:
Upd.Date încasare
incasari_key
Id-ul încasării care se editează. Obligatoriu — îl obții dintr-un apel
Get.fk_clienti_key
Id-ul clientului pentru care se înregistrează încasarea.
incasari_data
Data încasării (format
DD-MM-YYYY HH:MM:SS).incasari_suma
Suma încasată.
incasari_serie
Seria și numărul documentului de încasare.
incasari_moneda
Moneda încasării (ex.
RON, EUR, USD).incasari_tip
Tipul încasării:
Banca · Card · Cash · Trezorerie · Altceva.incasari_obs
Observații încasare (ex.
Contravaloare facturi: aaa 29; aaa 40).Împerechere facturi
idFacturi
Array de id-uri de facturi care se doresc împerecheate cu această plată (ex.
[10, 25]).⚠️ incasari_key obligatoriu
Modificarea folosește acțiunea
Upd și necesită incasari_key pentru a identifica încasarea existentă din registru.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "RO 31234567",
"met": "RegistruIncasari",
"act": "Upd",
"incasari_key": "11",
"fk_clienti_key": "101",
"incasari_data": "09-05-2022 18:22:06",
"incasari_suma": "10.52",
"incasari_serie": "FF 1234",
"incasari_moneda": "RON",
"incasari_tip": "cash",
"incasari_obs": "Contravaloare facturi: aaa 29; aaa 40;",
"idFacturi": [10, 25]
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "RO 31234567", "met" => "RegistruIncasari", "act" => "Upd", "incasari_key" => "11", "fk_clienti_key" => "101", "incasari_data" => "09-05-2022 18:22:06", "incasari_suma" => "10.52", "incasari_serie" => "FF 1234", "incasari_moneda" => "RON", "incasari_tip" => "cash", "incasari_obs" => "Contravaloare facturi: aaa 29; aaa 40;", "idFacturi" => [10, 25], ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "RO 31234567", "met": "RegistruIncasari", "act": "Upd", "incasari_key": "11", "fk_clienti_key": "101", "incasari_data": "09-05-2022 18:22:06", "incasari_suma": "10.52", "incasari_serie": "FF 1234", "incasari_moneda": "RON", "incasari_tip": "cash", "incasari_obs": "Contravaloare facturi: aaa 29; aaa 40;", "idFacturi": [10, 25] }'
200 OK { "success": 2000, "result": "Datele au fost salvate cu succes!" }
Afișare Facturi Furnizori
Returnează lista facturilor primite de la furnizori (și a documentelor NIR asociate). Permite filtrare după interval de dată, dată scadență, status, tip document și furnizor.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru facturi furnizori:
FacturiFurnizori.act
Acțiune. Pentru afișare:
Get.Filtrare după document și furnizor
facturi_furnizori_key
Id-ul facturii furnizor — filtrare după o factură anume.
fk_furnizori_key
Id-ul furnizorului — filtrare după furnizor.
facturi_furnizori_doc
Tip document:
Factura Furnizor sau NIR.Filtrare după dată
date_start
Data de început (format
DD-MM-YYYY).date_stop
Data de sfârșit (format
DD-MM-YYYY).date_startS
Data scadență factură — început (format
DD-MM-YYYY).date_stopS
Data scadență factură — sfârșit (format
DD-MM-YYYY).Filtrare după status
searchDeleted
Filtrare după stare:
1 — afișare doar șterse · 2 — afișare șterse și neșterse.facturi_emise
0 / 1 — filtrare facturi emise.facturi_achitate
0 / 1 — filtrare facturi achitate.facturi_partial_achitate
0 / 1 — filtrare facturi parțial achitate.facturi_anulate
0 / 1 — filtrare facturi anulate.💡 Sfat
Toți parametrii de filtrare sunt opționali. Fără
date_start/date_stop se returnează toate facturile furnizori. Poți combina filtrele (furnizor, tip document, dată scadență, status) pentru rezultate mai precise.📄 Tip document
Câmpul
facturi_furnizori_doc filtrează după tipul documentului: Factura Furnizor sau NIR.{
"APIkey": "123456789",
"u": "admin",
"p": "parola1",
"c": "RO 31234567",
"met": "FacturiFurnizori",
"act": "Get",
"date_start": "01-04-2021",
"date_stop": "01-07-2021"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "parola1", "c" => "RO 31234567", "met" => "FacturiFurnizori", "act" => "Get", "date_start" => "01-04-2021", "date_stop" => "01-07-2021", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "parola1", "c": "RO 31234567", "met": "FacturiFurnizori", "act": "Get", "date_start": "01-04-2021", "date_stop": "01-07-2021" }'
200 OK { "success": 2000, "result": [ { "facturi_furnizori_key": "700714", "facturi_furnizori_serie": "FF-2026-00123", "facturi_furnizori_data": "27-03-2026", "facturi_furnizori_data_scad": "26-04-2026", "facturi_furnizori_valftva": "1500.000000", "facturi_furnizori_tva": "285.000000", "facturi_furnizori_total": "1785.000000", "facturi_furnizori_tip": "Emisa", "facturi_furnizori_moneda": "RON", "facturi_furnizori_furnizor": "Furnizor Exemplu SRL", "facturi_furnizori_obs": "Achiziție piese de schimb", "facturi_cota_tva": "19", "facturi_furnizori_doc": "Factura Furnizor", "unique_id": "a1b2c3d4e5f6", "fk_furnizori_key": "1234", "fk_nir_key": null, "usr_name": "Mihalache Iulian", "pdl_nume": "SEDIUL SOCIAL" } ] }
Afișare NIR
Returnează lista NIR-urilor (Note de Intrare-Recepție) cu valorile totale (achiziție și vânzare), datele furnizorului și ale documentului de intrare. Fiecare NIR include array-ul <code>dataProd</code> cu produsele aferente. Permite filtrarea după NIR specific, interval de date și afișarea documentelor șterse.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru NIR-uri:
Nir.act
Acțiune. Pentru afișare:
Get.Filtrare și căutare (opțional)
nir_key
Id-ul unui NIR specific. Dacă este trimis, se returnează doar acel NIR.
date_start
Data de început a intervalului (format
DD-MM-YYYY).date_stop
Data de sfârșit a intervalului (format
DD-MM-YYYY).searchDeleted
Filtrare documente șterse:
0 (implicit) doar NIR-urile active · 1 doar NIR-urile șterse · 2 ambele.💰 Valori achiziție vs. vânzare
Câmpurile cu sufixul
_a (ex. nir_prod_val_a) reprezintă valorile de achiziție, iar cele fără sufix (ex. nir_prod_val) reprezintă valorile de vânzare.📅 Format date
Parametrii
date_start și date_stop se trimit în format DD-MM-YYYY. Intervalul este inclusiv (de la 00:00:00 până la 23:59:59).🗑️ Documente șterse
Implicit (
searchDeleted lipsă sau 0) se returnează doar NIR-urile active. Trimite 1 pentru doar cele șterse sau 2 pentru a include ambele.📦 Produse per NIR
Fiecare NIR conține array-ul
dataProd cu liniile de produse aferente, inclusiv codurile prod_cod (EAN), prod_sku și prod_cod1.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "RO 31234567",
"met": "Nir",
"act": "Get",
"date_start": "01-01-2026",
"date_stop": "31-12-2026"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "RO 31234567", "met" => "Nir", "act" => "Get", "date_start" => "01-01-2026", "date_stop" => "31-12-2026", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "RO 31234567", "met": "Nir", "act": "Get", "date_start": "01-01-2026", "date_stop": "31-12-2026" }'
200 OK { "success": 2000, "result": [ { "nir_numar": "6", "nir_data": "29-09-2019", "nir_key": "1761103", "nir_prod_val_a": "47.00", "nir_prod_val_tva_a": "8.93", "nir_prod_val_tot_a": "55.93", "nir_prod_moneda": "RON", "nir_prod_val": "72.36", "nir_prod_val_tva": "13.76", "nir_prod_val_tot": "86.12", "nir_furnizor": "ABC SRL", "cui_furnizor": "RO12345678", "nir_auto": "13B124", "nir_tip_doc": "Factura Fiscala", "nir_nr_doc": "23", "nir_obs": "observatii", "nir_gestiune": "Gestiune principala", "nir_data_scadenta": "29-09-2019", "fk_gestiuni_key": "12345", "fk_furnizori_key": "6789", "fk_firme_key": "31234567", "nir_fact_data": "29-09-2019", "usr_name": "admin", "pdl_nume": "SEDIUL SOCIAL", "nir_membru_com_1": "", "nir_membru_com_2": "", "nir_membru_com_3": "", "nir_valoare_factura_furnizor": "0.00", "nir_moneda_factura_furnizor": "RON", "dataProd": [ { "nir_prod_nume": "1883 Amaretto 100 cl", "nir_prod_um": "BUC", "nir_prod_cant": "1.00", "nir_prod_pretftva_a": "24.00", "nir_prod_val_a": "24.00", "nir_prod_val_tva_a": "4.56", "nir_prod_tva_a": "19%", "nir_prod_moneda": "RON", "prod_cod": "5413134000019", "prod_sku": "AMARETTO100", "prod_cod1": "" } ] } ] }
Adăugare NIR
Creează un NIR (Notă de Intrare-Recepție) nou cu produsele specificate. Documentul conține datele furnizorului și ale documentului de intrare, precum și liniile de produse cu prețuri și valori atât de achiziție, cât și de vânzare.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru NIR-uri:
Nir.act
Acțiune. Pentru inserare:
Ins.Structura request-ului
dataFact
Obiect cu datele NIR-ului: furnizor, dată, document de intrare, gestiune, observații etc.
dataProd
Array de produse. Fiecare produs este un obiect separat cu cantități, prețuri și cote TVA, atât de achiziție cât și de vânzare.
dataFact — date document
nir_key
Identificator NIR. Lăsat gol la adăugare — generat automat de sistem.
nir_punct_de_lucru
Punctul de lucru.
nir_gestiune
Gestiunea în care se face recepția.
nir_data
Data NIR-ului (format
YYYY-MM-DD).nir_numar
Numărul NIR-ului.
nir_furnizor
Denumirea furnizorului.
nir_tip_doc
Tipul documentului de intrare (ex.
Factura Fiscala).nir_nr_doc
Numărul documentului de intrare.
nir_fact_data
Data documentului de intrare (format
YYYY-MM-DD).nir_valoare_factura_furnizor
Valoarea facturii fiscale a furnizorului.
nir_moneda_factura_furnizor
Moneda facturii fiscale a furnizorului (ex.
RON, EUR).nir_auto
Numărul de înmatriculare al furnizorului.
nir_obs
Observații pe document.
nir_data_scadenta
Data scadență a documentului de intrare (format
YYYY-MM-DD).nir_moneda
Moneda documentului (ex.
RON, EUR).dataProd — produse (per element)
nir_prod_nume
Denumirea produsului.
nir_prod_um
Unitatea de măsură (ex.
BUC).nir_prod_cant_a
Cantitatea conform document.
nir_prod_cant
Cantitatea achiziționată (recepționată).
nir_prod_tva_a
Cota TVA achiziție (ex.
19%).nir_prod_pretftva_a
Prețul unitar fără TVA — achiziție.
nir_prod_pretctva_a
Prețul unitar cu TVA — achiziție.
nir_prod_val_a
Valoarea fără TVA — achiziție.
nir_prod_val_tva_a
Valoarea TVA — achiziție.
nir_prod_val_tot_a
Valoarea totală — achiziție (cu TVA).
nir_prod_tva
Cota TVA vânzare (ex.
19%).nir_prod_pretftva
Prețul unitar fără TVA — vânzare.
nir_prod_pretctva
Prețul unitar cu TVA — vânzare.
nir_prod_val
Valoarea fără TVA — vânzare.
nir_prod_val_tva
Valoarea TVA — vânzare.
nir_prod_val_tot
Valoarea totală — vânzare (cu TVA).
nir_prod_moneda
Moneda produsului.
prod_cod
Codul EAN al produsului.
prod_sku
Codul SKU al produsului.
prod_cod1
Cod alternativ al produsului.
prod_cod_cautare
Câmpul după care se identifică produsul în aplicație:
prod_cod · prod_sku · prod_cod1.facturi_prod_tva
Cota TVA a produsului (ex.
19%).💡 Prețuri de achiziție și de vânzare
Fiecare linie de produs are două seturi de valori: cele cu sufixul
_a (Amaretto / achiziție — preț, TVA și valori de intrare) și cele fără sufix (prețurile și valorile de vânzare cu care produsul intră în gestiune).💡 Identificarea produselor
Câmpul
prod_cod_cautare indică după ce câmp este căutat produsul în Nomenclator: prod_cod (EAN), prod_sku sau prod_cod1. Trimite valoarea corespunzătoare în câmpul indicat.📦 Mai multe produse
Array-ul
dataProd poate conține oricâte produse — fiecare ca obiect separat. Totalurile documentului se calculează prin însumarea valorilor de pe fiecare linie.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Nir",
"act": "Ins",
"dataFact": {
"nir_key": "",
"nir_punct_de_lucru": "",
"nir_gestiune": "",
"nir_data": "2019-09-29",
"nir_numar": "6",
"nir_furnizor": "ABC SRL",
"nir_tip_doc": "Factura Fiscala",
"nir_nr_doc": "23",
"nir_fact_data": "2019-09-29",
"nir_valoare_factura_furnizor": "100",
"nir_moneda_factura_furnizor": "RON",
"nir_auto": "13B124",
"nir_obs": "observatii ",
"nir_data_scadenta": "2019-09-29",
"nir_moneda": "RON"
},
"dataProd": [
{
"nir_prod_nume": "1883 Amaretto 100 cl",
"nir_prod_um": "BUC",
"nir_prod_cant_a": "1.00",
"nir_prod_cant": "1.00",
"nir_prod_tva_a": "19%",
"nir_prod_pretftva_a": "24.00",
"nir_prod_pretctva_a": "28.56",
"nir_prod_val_a": "24.00",
"nir_prod_val_tva_a": "4.56",
"nir_prod_val_tot_a": "28.56",
"nir_prod_tva": "19%",
"nir_prod_pretftva": "36.18",
"nir_prod_pretctva": "43.06",
"nir_prod_val": "36.18",
"nir_prod_val_tva": "6.88",
"nir_prod_val_tot": "43.06",
"nir_prod_moneda": "RON",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
},
{
"nir_prod_nume": "1883 Artar 100 cl",
"nir_prod_um": "BUC",
"nir_prod_cant_a": "1.00",
"nir_prod_cant": "1.00",
"nir_prod_tva_a": "19%",
"nir_prod_pretftva_a": "23.00",
"nir_prod_pretctva_a": "27.37",
"nir_prod_val_a": "23.00",
"nir_prod_val_tva_a": "4.37",
"nir_prod_val_tot_a": "27.37",
"nir_prod_tva": "19%",
"nir_prod_pretftva": "36.18",
"nir_prod_pretctva": "43.06",
"nir_prod_val": "36.18",
"nir_prod_val_tva": "6.88",
"nir_prod_val_tot": "43.06",
"nir_prod_moneda": "RON",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
}
]
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Nir", "act" => "Ins", ]; $values['dataFact'] = [ "nir_key" => "", "nir_data" => "2019-09-29", "nir_numar" => "6", "nir_furnizor" => "ABC SRL", "nir_tip_doc" => "Factura Fiscala", "nir_nr_doc" => "23", "nir_fact_data" => "2019-09-29", "nir_moneda" => "RON", ]; $values['dataProd'][0] = [ "nir_prod_nume" => "1883 Amaretto 100 cl", "nir_prod_um" => "BUC", "nir_prod_cant" => "1.00", "nir_prod_tva_a" => "19%", "nir_prod_pretftva_a" => "24.00", "nir_prod_tva" => "19%", "nir_prod_pretftva" => "36.18", "nir_prod_moneda" => "RON", "prod_cod_cautare" => "prod_cod", "facturi_prod_tva" => "19%", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Nir", "act": "Ins", "dataFact": { "nir_data": "2019-09-29", "nir_numar": "6", "nir_furnizor": "ABC SRL", "nir_tip_doc": "Factura Fiscala", "nir_nr_doc": "23", "nir_moneda": "RON" }, "dataProd": [ { "nir_prod_nume": "1883 Amaretto 100 cl", "nir_prod_um": "BUC", "nir_prod_cant": "1.00", "nir_prod_pretftva": "36.18", "nir_prod_tva": "19%", "prod_cod_cautare": "prod_cod" } ] }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "92382888" } }
Modificare NIR
Actualizează un NIR existent folosind acțiunea <code>Upd</code>. În obiectul <code>dataFact</code> trimiți <code>nir_key</code> cu identificatorul NIR-ului existent. La salvare, produsele din <code>dataProd</code> înlocuiesc complet liniile NIR-ului.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru NIR-uri:
Nir.act
Acțiune. Pentru modificare:
Upd.Structura request-ului
dataFact
Obiect cu datele NIR-ului. Trebuie să conțină
nir_key cu identificatorul NIR-ului care se modifică.dataProd
Array de produse care înlocuiesc liniile existente ale NIR-ului.
dataFact — date document
nir_key
Identificatorul NIR-ului care va fi modificat. Obligatoriu — îl obții din răspunsul la
Ins.nir_punct_de_lucru
Punctul de lucru.
nir_gestiune
Gestiunea în care se face recepția.
nir_data
Data NIR-ului (format
YYYY-MM-DD).nir_numar
Numărul NIR-ului.
nir_furnizor
Denumirea furnizorului.
nir_tip_doc
Tipul documentului de intrare (ex.
Factura Fiscala).nir_nr_doc
Numărul documentului de intrare.
nir_fact_data
Data documentului de intrare (format
YYYY-MM-DD).nir_valoare_factura_furnizor
Valoarea facturii fiscale a furnizorului.
nir_moneda_factura_furnizor
Moneda facturii fiscale a furnizorului (ex.
RON, EUR).nir_auto
Numărul de înmatriculare al furnizorului.
nir_obs
Observații pe document.
nir_data_scadenta
Data scadență a documentului de intrare (format
YYYY-MM-DD).nir_moneda
Moneda documentului (ex.
RON, EUR).dataProd — produse (per element)
nir_prod_nume
Denumirea produsului.
nir_prod_um
Unitatea de măsură (ex.
BUC).nir_prod_cant_a
Cantitatea conform document.
nir_prod_cant
Cantitatea achiziționată (recepționată).
nir_prod_tva_a
Cota TVA achiziție (ex.
19%).nir_prod_pretftva_a
Prețul unitar fără TVA — achiziție.
nir_prod_pretctva_a
Prețul unitar cu TVA — achiziție.
nir_prod_val_a
Valoarea fără TVA — achiziție.
nir_prod_val_tva_a
Valoarea TVA — achiziție.
nir_prod_val_tot_a
Valoarea totală — achiziție (cu TVA).
nir_prod_tva
Cota TVA vânzare (ex.
19%).nir_prod_pretftva
Prețul unitar fără TVA — vânzare.
nir_prod_pretctva
Prețul unitar cu TVA — vânzare.
nir_prod_val
Valoarea fără TVA — vânzare.
nir_prod_val_tva
Valoarea TVA — vânzare.
nir_prod_val_tot
Valoarea totală — vânzare (cu TVA).
nir_prod_moneda
Moneda produsului.
prod_cod
Codul EAN al produsului.
prod_sku
Codul SKU al produsului.
prod_cod1
Cod alternativ al produsului.
prod_cod_cautare
Câmpul după care se identifică produsul:
prod_cod · prod_sku · prod_cod1.facturi_prod_tva
Cota TVA a produsului (ex.
19%).⚠️ Produsele se înlocuiesc
La modificare, liniile din
dataProd înlocuiesc complet produsele NIR-ului. Trimite întotdeauna lista completă a produselor dorite, nu doar cele modificate.{
"u": "admin",
"p": "magazin",
"c": "ro 31234567",
"met": "Nir",
"act": "Upd",
"dataFact": {
"nir_key": "23434222",
"nir_punct_de_lucru": "",
"nir_gestiune": "",
"nir_data": "2019-09-29",
"nir_numar": "6",
"nir_furnizor": "ABC SRL",
"nir_tip_doc": "Factura Fiscala",
"nir_nr_doc": "23",
"nir_fact_data": "2019-09-29",
"nir_valoare_factura_furnizor": "100",
"nir_moneda_factura_furnizor": "RON",
"nir_auto": "13B124",
"nir_obs": "observatii ",
"nir_data_scadenta": "2019-09-29",
"nir_moneda": "RON"
},
"dataProd": [
{
"nir_prod_nume": "1883 Amaretto 100 cl",
"nir_prod_um": "BUC",
"nir_prod_cant_a": "1.00",
"nir_prod_cant": "1.00",
"nir_prod_tva_a": "19%",
"nir_prod_pretftva_a": "24.00",
"nir_prod_pretctva_a": "28.56",
"nir_prod_val_a": "24.00",
"nir_prod_val_tva_a": "4.56",
"nir_prod_val_tot_a": "28.56",
"nir_prod_tva": "19%",
"nir_prod_pretftva": "36.18",
"nir_prod_pretctva": "43.06",
"nir_prod_val": "36.18",
"nir_prod_val_tva": "6.88",
"nir_prod_val_tot": "43.06",
"nir_prod_moneda": "RON",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
},
{
"nir_prod_nume": "1883 Artar 100 cl",
"nir_prod_um": "BUC",
"nir_prod_cant_a": "1.00",
"nir_prod_cant": "1.00",
"nir_prod_tva_a": "19%",
"nir_prod_pretftva_a": "23.00",
"nir_prod_pretctva_a": "27.37",
"nir_prod_val_a": "23.00",
"nir_prod_val_tva_a": "4.37",
"nir_prod_val_tot_a": "27.37",
"nir_prod_tva": "19%",
"nir_prod_pretftva": "36.18",
"nir_prod_pretctva": "43.06",
"nir_prod_val": "36.18",
"nir_prod_val_tva": "6.88",
"nir_prod_val_tot": "43.06",
"nir_prod_moneda": "RON",
"prod_cod": "-",
"prod_sku": "-",
"prod_cod1": "-",
"prod_cod_cautare": "prod_cod",
"facturi_prod_tva": "19%"
}
]
}
<?php $values = [ "u" => "admin", "p" => "magazin", "c" => "ro 31234567", "met" => "Nir", "act" => "Upd", ]; $values['dataFact'] = [ "nir_key" => "23434222", "nir_data" => "2019-09-29", "nir_numar" => "6", "nir_furnizor" => "ABC SRL", "nir_tip_doc" => "Factura Fiscala", "nir_nr_doc" => "23", "nir_fact_data" => "2019-09-29", "nir_moneda" => "RON", ]; $values['dataProd'][0] = [ "nir_prod_nume" => "1883 Amaretto 100 cl", "nir_prod_um" => "BUC", "nir_prod_cant" => "1.00", "nir_prod_tva_a" => "19%", "nir_prod_pretftva_a" => "24.00", "nir_prod_tva" => "19%", "nir_prod_pretftva" => "36.18", "nir_prod_moneda" => "RON", "prod_cod_cautare" => "prod_cod", "facturi_prod_tva" => "19%", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "u": "admin", "p": "magazin", "c": "ro 31234567", "met": "Nir", "act": "Upd", "dataFact": { "nir_key": "23434222", "nir_data": "2019-09-29", "nir_numar": "6", "nir_furnizor": "ABC SRL", "nir_tip_doc": "Factura Fiscala", "nir_nr_doc": "23", "nir_moneda": "RON" }, "dataProd": [ { "nir_prod_nume": "1883 Amaretto 100 cl", "nir_prod_um": "BUC", "nir_prod_cant": "1.00", "nir_prod_pretftva": "36.18", "nir_prod_tva": "19%", "prod_cod_cautare": "prod_cod" } ] }'
200 OK { "success": 2000, "result": { "msg": "Datele au fost salvate cu succes!", "id": "23434222" } }
Listare NIR (PDF)
Returnează documentul PDF al unui NIR existent. NIR-ul se identifică după <code>nir_key</code>. Răspunsul este direct conținutul binar al fișierului PDF.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru listarea PDF:
Nir.act
Acțiune. Pentru listare PDF:
Print.nir_key
Id-ul NIR-ului care va fi listat.
📄 Format răspuns
Răspunsul este direct conținutul binar al fișierului PDF (nu JSON și nu base64). Salvează corpul răspunsului ca atare într-un fișier
.pdf — în PHP, scrie direct rezultatul cu file_put_contents(), fără decodare.💡 Identificare document
NIR-ul se identifică prin
nir_key — id-ul obținut la adăugare (Ins).{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "RO 31234567",
"met": "Nir",
"act": "Print",
"nir_key": "1761103"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "RO 31234567", "met" => "Nir", "act" => "Print", "nir_key" => "1761103", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); // Răspunsul este direct conținutul binar al PDF-ului file_put_contents("nir.pdf", $result);
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "RO 31234567", "met": "Nir", "act": "Print", "nir_key": "1761103" }'
200 OK · Content-Type: application/pdf %PDF-1.4 %âãÏÓ ... (conținut binar PDF) ... %%EOF
Interogarea Stocului
Returnează stocul de produse pentru un punct de lucru și o gestiune. Permite căutarea după cod produs (prod_cod, prod_sku, prod_cod1, prod_key) și afișarea opțională a produselor cu stoc 0.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru stoc:
Stoc.act
Acțiune. Pentru interogare:
Get.Localizare stoc
pdl
Punctul de lucru la care se dorește stocul (ex.
SEDIUL SOCIAL).gestiune
Gestiunea la care se dorește stocul (ex.
gestiune principala).Filtrare și căutare (opțional)
prod_cod_cautare
Criteriul de căutare în aplicație:
prod_cod · prod_sku · prod_cod1 · prod_key.prod_cautare
Valoarea căutată, conform criteriului ales în
prod_cod_cautare.with_zero_stock
Dacă se dorește afișarea tuturor produselor (inclusiv cele cu stoc 0), acest parametru trebuie să fie
true.🔍 Căutare produs
Pentru a căuta un anumit produs, trimite perechea
prod_cod_cautare + prod_cautare. Criteriul acceptă: prod_cod, prod_sku, prod_cod1, prod_key.📦 Produse cu stoc 0
Implicit se returnează doar produsele cu stoc. Trimite
with_zero_stock cu valoarea true pentru a include și produsele care au stoc 0.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "RO 31234567",
"met": "Stoc",
"act": "Get",
"pdl": "SEDIUL SOCIAL",
"gestiune": "gestiune principala"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "RO 31234567", "met" => "Stoc", "act" => "Get", "pdl" => "SEDIUL SOCIAL", "gestiune" => "gestiune principala", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "RO 31234567", "met": "Stoc", "act": "Get", "pdl": "SEDIUL SOCIAL", "gestiune": "gestiune principala" }'
200 OK { "success": 2000, "result": [ { "Cod_EAN": "", "Denumire": "1883 Fructul Pasiunii 100 cl", "Cantitate": "225.00", "UM": "BUC", "Pret_fara_TVA_achizitie": "12.00", "Pret_cu_TVA_achizitie": "14.28", "Valoare_fara_TVA_achizitie": "2700.00", "Valoare_cu_TVA_achizitie": "3213.00", "Pret_fara_TVA_vanzare": "37.44", "Pret_cu_TVA_vanzare": "44.55", "Valoare_fara_TVA_vanzare": "8424.00", "Valoare_cu_TVA_vanzare": "10024.56", "Moneda": "RON", "Numar": "-", "Data_Document": "-", "Tip_Document": "-", "Document_Intrare": "-", "Gestiune": "Gestiune principala", "Punct_de_Lucru": "Sediul Social", "Data": "18-01-2019", "Observatii1": "", "Observatii2": "", "Observatii3": "", "Categorie": "Sirop 1883" } ] }
Fișa Produs - Magazie
Returnează fișa de magazie a unui produs (mișcările de stoc) pentru o gestiune dată. Produsul este identificat prin <code>fk_prod_key</code>. Opțional, rezultatele pot fi filtrate pe un interval de date și pot fi afișate cu sau fără TVA.
POST
https://api.facturis-online.ro/api/?json={json}
Parametri de autentificare
APIkey
Cheia de autorizare primită de la Facturis Online.
u
Utilizator cont Facturis.
p
Parola utilizatorului.
c
Cod fiscal firmă.
met
Metodă API. Pentru fișa produs:
FisaProdus.act
Acțiune. Pentru interogare:
Get.Identificare produs, gestiune și punct de lucru
fk_prod_key
Cheia (id-ul) produsului pentru care se dorește fișa de magazie. Câmp obligatoriu.
gestiune
Numele gestiunii pentru care se dorește fișa (ex.
gestiune principala). Câmp obligatoriu.pdl
Numele punctului de lucru (ex.
Sediu Social). Câmp obligatoriu.Filtrare (opțional)
date_start
Data de început a intervalului (ex.
01-01-2019).date_stop
Data de sfârșit a intervalului (ex.
31-12-2019).cu_TVA
Afișarea valorilor cu TVA (
1) sau fără TVA (0). Implicit este 0 (fără TVA).⚠️ Produs obligatoriu
Parametrul
fk_prod_key este obligatoriu. Dacă lipsește, API-ul returnează eroarea 1005: fk_prod_key - Campul este obligatoriu!.🏬 Gestiune obligatorie
Parametrul
gestiune este obligatoriu și primește numele gestiunii (ex. gestiune principala) — fișa de magazie se calculează pentru o singură gestiune.🧾 Valori cu / fără TVA
Implicit valorile sunt afișate fără TVA. Trimite
cu_TVA cu valoarea 1 pentru a afișa valorile cu TVA.ℹ️ Fără rezultate
Dacă nu există mișcări pentru produsul și filtrele date, API-ul returnează:
{"error":5005,"result":"Nu exista rezultate"}.📋 Structura răspunsului
Primul element din
result reprezintă stocul inițial și conține doar data, document și stoc (cu marcaj HTML <strong>). Restul elementelor sunt mișcările de stoc, în ordine cronologică, fiecare cu cheia key.{
"APIkey": "123456789",
"u": "admin",
"p": "magazin",
"c": "RO 31234567",
"met": "FisaProdus",
"act": "Get",
"fk_prod_key": "123456",
"gestiune": "gestiune principala",
"pdl": "Sediu Social"
}
<?php $values = [ "APIkey" => "123456789", "u" => "admin", "p" => "magazin", "c" => "RO 31234567", "met" => "FisaProdus", "act" => "Get", "fk_prod_key" => "123456", "gestiune" => "gestiune principala", "pdl" => "Sediu Social", ]; $json = json_encode($values); $ch = curl_init("https://api.facturis-online.ro/api/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => "json=$json", CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $result = curl_exec($ch); curl_close($ch); echo $result;
curl -X POST 'https://api.facturis-online.ro/api/' \ --data-urlencode 'json={ "APIkey": "123456789", "u": "admin", "p": "magazin", "c": "RO 31234567", "met": "FisaProdus", "act": "Get", "fk_prod_key": "123456", "gestiune": "gestiune principala", "pdl": "Sediu Social" }'
200 OK { "success": 2000, "result": [ { "data": "<strong>01-01-2026</strong>", "document": "<strong>Stoc initial</strong>", "stoc": "<strong>101.000</strong>" }, { "key": 1, "nr_crt": "1", "data": "29-01-2026", "document": "Aviz - Firma Mea SRL \" wrererewwe sdasdasd rox1\"", "seria": "avz 55", "cantitate": "-1.000", "stoc": "100.000", "pret_intrare": "", "valoare_intrare": "", "pret_iesire": "117.0000", "valoare_iesire": "117.00", "moneda": "RON", "lot": "", "expirare": "", "cantitate_document": "1.000", "um_document": "buc" }, { "key": 5, "nr_crt": "5", "data": "27-03-2026", "document": "NIR - SC METRO AUTO GLASS SRL", "seria": " 15 (az)", "cantitate": "1.000", "stoc": "98.000", "pret_intrare": "0.0000", "valoare_intrare": "0.00", "pret_iesire": "234.0000", "valoare_iesire": "234.00", "moneda": "RON", "lot": "", "expirare": "", "cantitate_document": "1.000", "um_document": "buc" }, { "key": 14, "nr_crt": "14", "data": "09-06-2026", "document": "Factura - Firma Mea SRL \" wrererewwe sdasdasd rox1\"", "seria": "ZZZ 600006", "cantitate": "-1.000", "stoc": "89.000", "pret_intrare": "", "valoare_intrare": "", "pret_iesire": "117.0000", "valoare_iesire": "117.00", "moneda": "EUR", "lot": "", "expirare": "", "cantitate_document": "1.000", "um_document": "buc" } ] }