API pentru accesul la datele din TDec

Integrați TDec în aplicația dvs. de contabilitate, facturare sau ERP.

Actualizat la 21.03.2026 20:59

Apelurile prin API pot fi efectuate pe stația unde TDec funcționează în Mod Activ sau Mod OAuth, printr-un schimb de fișiere text într-un folder sau prin protocolul HTTP (REST API).

Schimb de fișiere

Creează un folder gol pe PC (numit în continuare „Folder I/O”), apoi configurează-l în Accesorii > Setări aplicație > Opțiuni > Folder I/O.
Creează un fișier in.txt având conținutul formatat conform descrierii de mai jos și copiază-l în Folder I/O.
În câteva secunde, TDec creează automat un fișier out.txt având conținutul formatat conform descrierii de mai jos, copiază fișierele solicitate (declarații, facturi și transporturi) în Folder I/O și șterge in.txt.
Procesarea sau ștergerea fișierului out.txt cât și a fișierelor declarații și facturi din Folder I/O rămâne la latitudinea dezvoltatorului programului de contabilitate.

Pentru adăugarea de noi declarații și facturi în vederea transmiterii, acestea trebuie copiate în folderul definit în Accesorii > Setări aplicație > Fișiere > Preia din > Folder.

În cazul în care fișierul in.txt nu poate fi procesat, în cel mult 10 secunde va apărea o înregistrare cu mesajul de eroare în Accesorii > Setări aplicație > Jurnal procesare fișiere.

Fișierul „in.txt”

Numele fișierului de interogare poate avea oricare dintre formatele:

in.txt
inIDENTIFICARE.txt

unde IDENTIFICARE poate fi un număr de sesiune (thread) definit de programator pentru a asocia interogarea cu răspunsul.

Fișierul conține una sau mai multe linii. Fiecare linie poate avea oricare dintre formatele:

CATEGORIE;CIF;AN;LUNA;ZI;TIP;FORMAT
CATEGORIE;CIF;AN;LUNA;ZI;IDANAF;FORMAT
CATEGORIE;CIF;AN;LUNA;ZI;UIT;FORMAT
CATEGORIE;CIF;AN;LUNA;ZI;REF;FORMAT
CATEGORIE;CIF;AN;LUNA;ZI;IDFACTURA;FORMAT
CATEGORIE;CIF;;;ZILE;TIP;FORMAT
CATEGORIE;CIF;;;;ULTIM;FORMAT
CATEGORIE;FISIERXML

unde:

Poziție	Denumire	Tip	Valoare / Constrângeri
1	CATEGORIE	STRING(1)	Litera „D” - Declarații și recipise „F” - Facturi „M” - Mesaj cumpărător (pentru facturi) „T” - Transporturi. „S” - Mesaje SPV. Valoare obligatorie.
2	CIF	INT(2…13)	Codul de înregistrare fiscală, numeric fără „RO”.
3	AN	INT(4)	Pentru CATEGORIE = D este anul de raportare Pentru CATEGORIE = F,T,S este anul recipisei Format AAAA. Dacă AN este specificat, atunci și LUNA trebuie specificată.
4	LUNA	INT(2)	Pentru CATEGORIE = D este luna de raportare Pentru CATEGORIE = F,T,S este anul recipisei Formatt LL. Dacă LUNA este specificată, atunci și AN trebuie specificat.
5	ZI	INT(2)	Ziua recipisei în formatul ZZ. Dacă ZI este specificată, atunci AN și LUNA trebuie specificate, iar grupul AN;LUNA;ZI reprezintă data recipisei (dacă există) sau data la care documentul a fost încărcat în TDec.
5	ZILE	INT(2)	Numărul de zile în format NN pentru care se face interogarea, unde 00 = azi, 01 = azi și ieri, … 99 = ultimele 99 zile până în prezent. Dacă ZILE este specificat, atunci AN și LUNA nu trebuie specificate.
6	TIP	STRING(1…5)	Tipul declarației (indiferent dacă este sau nu rectificativă), pentru CATEGORIE = D Litera „T” - Trimisă sau „P” - primită, pentru CATEGORIE = F Categorie sau Detalii mesaj, pentru CATEGORIE = S
	IDFACTURA	STRING	Numărul unic al facturii (cbc:ID din XML), pentru CATEGORIE = F
	LIVRARE	STRING	Locația de livrare din factură (cac:Delivery/cac:DeliveryLocation/cbc:ID din XML), pentru CATEGORIE = F
	IDANAF	INT	Indexul de încărcare obținut de la ANAF pentru CATEGORIE = D,F
	UIT	STRING(16)	UIT obținut de la ANAF pentru transport, pentru CATEGORIE = T
	REF	STRING	Referință declarant (refDeclarant din XML) pentru transport, pentru CATEGORIE = T
	ULTIM	STRING	Cuvântul „ULTIM” - returnează ultimul document din CATEGORIE încărcat în TDec pentru CIF specificat, indiferent de starea sa, și ignoră toate celelalte variabile.
7	FORMAT	STRING(1…6)	Litera „Y” pentru a salva în Folder I/O toate fișierele disponibile; Litera „N” dacă nu este necesară salvarea fișierelor; Litera „S” dacă este necesară semnarea fișierelor (pentru arhivă electronică); Litera „D” - Declarații Litera „R” - Recipise Litera „P” - PDF Litera „X” - XML Litera „Z” - ZIP Combinații de una sau mai multe litere din setul DRPXZS; Textul „CSV” pentru metadatele din baza de date; in.txt conține un singur tip de CATEGORIE. Valoare obligatorie, cu excepția cazului de conversie XML - PDF.
2	FISIERXML	STRING	Conversie XML - PDF. Numele fișierului extern tip factură sau transport în format XML aflat în Folder I/O și care se dorește a fi convertit în PDF

Exemplu fișier in.txt

D;123453;2023;04;23;;X
D;123453;2022;01;11;D100;DR
D;123453;2022;03;;D112;Y
F;123453;;;;23358;Y
F;123453;;;;23369;Y
D;12340;2022;02;;D394;N
D;12340;2021;11;;;Y
F;123453;2022;04;28;;Y
T;12340;;;;ULTIM;Y
F;factura123.xml
F;fact.xml
T;12340;;;;4C0U0C0J0W3DDQ92;Y
S;12340;2024;05;;EXTRAS DE CONT;Y

Exemplu conținut Folder I/O

factura123.xml
fact.xml
in.txt

Fișierul „out.txt”

Numele fișierului de răspuns poate avea oricare dintre formatele:

out.txt
outIDENTIFICARE.txt

unde IDENTIFICARE este valoarea din numele fișierului interogare.

Fișierul de răspuns conține una sau mai multe linii.

Cazul FILE ≠ CSV

Fiecare linie poate avea oricare dintre formatele:

CATEGORIE;CIF;AN;LUNA;ZI;TIP;FORMAT;IDANAF;DATAANAF;MESAJ
CATEGORIE;CIF;AN;LUNA;ZI;IDFACTURA;FORMAT;IDANAF;DATAANAF;MESAJ
CATEGORIE;CIF;AN;LUNA;ZI;UIT;FORMAT;REF;DATAANAF;MESAJ
CATEGORIE;FISIERXML;FORMAT;FISIERPDF

unde:

Poziție	Denumire	Tip	Valoare
1	CATEGORIE	STRING(1)	Litera „D” - Declarații și recipise „F” - Facturi „M” - Mesaj cumpărător (pentru facturi) „T” - Transporturi „S” - Mesaj SPV
2	CIF	INT(2…13)	Codul de înregistrare fiscală
3	AN	STRING(4)	Anul de raportare în formatul AAAA
4	LUNA	STRING(2)	Luna de raportare în formatul LL
5	ZI	STRING(2)	Ziua de raportare în formatul ZZ
6	TIP	STRING(2…5)	Tipul declarației, pentru CATEGORIE = D
	IDFACTURA	STRING	Numărul unic al facturii (cbc:ID din XML), pentru CATEGORIE = F
	UIT	STRING(16)	Identificatorul unic al transportului returnat de ANAF, pentru CATEGORIE = T
7	FORMAT	STRING(1…6)	Litera „N” dacă nu a fost salvat în Folder I/O niciun fișier Litera „S” dacă au fost semnate fișierele (pentru arhivă electronică) Alte litere și combinații dacă au fost salvate acele tipuri de fișiere
8	IDANAF	INT(9…10)	Indexul de încărcare returnat de ANAF pentru CATEGORIE = D sau CATEGORIE = F sau cifra 0 (zero)
8	REF	STRING	Referință declarant (refDeclarant din XML) pentru CATEGORIE = T.
9	DATAANAF	STRING(12)	Data recipisei (dacă există) sau data la care documentul a fost încărcat în TDec în formatul AAAA-LL-ZZ.
10	MESAJ	STRING	MALFORMAT (dacă linia text nu este în formatul corect) INEXISTENT (dacă declarația / factura nu există în TDec) PROCESARE (dacă declarația / factura se află în curs de analiză, verificare, transmitere, așteptare la nivelul TDec) OK (procedura a fost finalizată cu succes) Orice alt mesaj reprezintă o eroare
2	FISIERXML	STRING	Numele fișierului factură / transport XML
4	FISIERPDF	STRING	Dacă FILE = „Y”, atunci FISIERPDF este numele fișierului inițial convertit în PDF, același cu FISIERXML, însă cu extensia .xml schimbată în .pdf Dacă FILE = „N”, atunci FISIERPDF este un mesaj de eroare

Exemplu fișier out.txt

D;123453;2021;12;;D100;DR;321067899;2022-01-24;OK
D;123453;2022;03;26;D112;N;0;0001-01-01;INEXISTENT
F;123453;2022;04;02;23358;Y;2013568;2022-04-02;OK
F;123453;2022;03;15;23369;N;0;0001-01-01;Verificarea a eșuat: furnizor neînregistrat în RO e-Factura
D;12340;2022;02;;D394;N;0;0001-01-01;Semnarea a eșuat: E: op1 (1) cuiP invalid…
D;12340;2021;11;;;N;0;0001-01-01;INEXISTENT
F;123453;2022;04;11;23358;Y;2013568;2022-04-02;OK
F;factura123.xml;Y;factura123.pdf
F;fact.xml;N;The 'cac:AccountingSupplier' start tag on line 11 position 3 does not match the end tag…
T;12340;2022;08;21;4C0U0C0J0W3DDQ92;Y;XTR0123;2022-08-07;OK
S;12340;2024;05;05;EXTRAS DE CONT;P;714281553;2024-05-05;OK

Folderul I/O conține fișierele solicitate:

Format	Tip
D_IDANAF.pdf D_IDANAF.xml	Declarații
R_IDANAF.pdf R_IDANAF.xml	Recipise
F_IDANAF.pdf F_IDANAF.xml F_IDANAF.zip	Facturi
M_IDANAF.pdf M_IDANAF.xml M_IDANAF.zip	Mesaj cumpărător
T_UIT.pdf T_UIT.xml T_UIT.zip	Transporturi

Exemplu conținut Folder I/O

D_321067899.pdf
R_321067899.pdf
F_2013568.pdf
F_2013568.xml
F_2013568.zip
factura123.pdf
T_5000005341.pdf
T_5000005341.xml
S_714281553.pdf
out.txt

Cazul FILE = CSV

Liniile conțin valori delimitate prin ; (punct și virgulă).

CATEGORIE = D

Poziție	Denumire	Tip
1	Nume	STRING
2	CIF	INT(2…13)
3	Luna	STRING(yyyy.MM)
4	Tip	STRING
5	AMEF	STRING
6	Stare	STRING
7	Index	INT(9)
8	Data	DATE(yyyy-MM-dd HH:mm:ss)
9	User	STRING

CATEGORIE = F

Poziție	Denumire	Tip
1	Tip	STRING(1)
2	CIF_SPV	INT(2…13)
3	Nume_furnizor	STRING
4	CIF_furnizor	INT(2…13)
5	Nume_cumparator	STRING
6	CIF_cumpărător	INT(2…13)
7	Locatie_livrare	STRING
8	Tip_factura	INT(3)
9	ID_factura	STRING
10	Data_factura	DATE(yyyy-MM-dd HH:mm:ss)
11	Valoare_neta	DECIMAL(26.2)
12	Valoare_TVA	DECIMAL(26.2)
13	Suma	DECIMAL(26.2)
14	Moneda	STRING(3)
15	Contract	STRING
16	Comanda	STRING
17	Aviz	STRING
18	Index_incarcare	INT(10)
19	Index_descarcare	INT(10)
20	Data_ANAF	DATE(yyyy-MM-dd HH:mm:ss)
21	Stare	STRING
22	User	STRING

CATEGORIE = T

Poziție	Denumire	Tip
1	Nume	STRING
2	CIF_SPV	INT(2…13)
3	Nume_partener	STRING
4	CIF_partener	INT(2…13)
5	Nume_transportator	STRING
6	Tip_operatiune	INT(2)
7	Vehicul	STRING
8	Data_transport	DATE(yyyy-MM-dd HH:mm:ss)
9	Data_expirare	DATE(yyyy-MM-dd HH:mm:ss)
10	Valoare_netă	DECIMAL(26.2)
11	Referinta	STRING
12	Cod_UIT	STRING(16)
13	Index	INT(9)
14	Data	DATE(yyyy-MM-dd HH:mm:ss)
15	Stare	STRING
16	User	STRING

CATEGORIE = S

Poziție	Denumire	Tip
1	Nume	STRING
2	CIF	INT(2…13)
3	Data_descarcat	DATE(yyyy-MM-dd HH:mm:ss)
4	Categorie	STRING
5	Detalii	STRING
6	Stare	STRING
7	Index	INT(9)
8	Solicitare	STRING
9	Data_solicitare	DATE(yyyy-MM-dd HH:mm:ss)
10	Intrebare	STRING
11	Data	DATE(yyyy-MM-dd HH:mm:ss)
12	User	STRING

Protocol HTTP (REST API)

Configurează portul prin care să se realizeze conexiunea HTTP în Accesorii > Setări aplicație > Opțiuni > HTTP Port (în exemplele de mai jos este folosit portul 8080).
Inițiază apeluri (interogări), conform următoarelor indicații:

Interogare HTTP

Fiecare interogare poate avea oricare dintre formatele:

Listă de mesaje:

GET http://localhost:8080/api/CATEGORIE/CIF/AN/LUNA/ZI/TIP/JSON

GET http://localhost:8080/api/CATEGORIE/CIF/AN/LUNA/ZI/IDANAF/JSON

GET http://localhost:8080/api/CATEGORIE/CIF/AN/LUNA/ZI/UIT/JSON

GET http://localhost:8080/api/CATEGORIE/CIF/AN/LUNA/ZI/REF/JSON

GET http://localhost:8080/api/CATEGORIE/CIF/AN/LUNA/ZI/IDFACTURA/JSON

GET http://localhost:8080/api/CATEGORIE/CIF///ZILE/TIP/JSON

GET http://localhost:8080/api/CATEGORIE/CIF////ULTIM/JSON

GET http://localhost:8080/api/CATEGORIE/CIF/////JSON

unde:

Poziție	Denumire	Tip	Valoare / Constrângeri
1	CATEGORIE	STRING(1)	Litera „D” - Declarații și recipise „F” - Facturi „M” - Mesaj cumpărător (pentru facturi) „T” - Transporturi. „S” - Mesaje SPV. „C” - Firme (Companii). Valoare obligatorie.
2	CIF	INT(2…13)	Codul de înregistrare fiscală, numeric fără „RO”, în cazul listei de mesaje.
3	AN	INT(4)	Pentru CATEGORIE = D este anul de raportare Pentru CATEGORIE = F,T,S este anul recipisei Format AAAA. Dacă AN este specificat, atunci și LUNA trebuie specificată.
4	LUNA	INT(2)	Pentru CATEGORIE = D este luna de raportare Pentru CATEGORIE = F,T,S este anul recipisei Formatt LL. Dacă LUNA este specificată, atunci și AN trebuie specificat.
5	ZI	INT(2)	Ziua recipisei în formatul ZZ. Dacă ZI este specificată, atunci AN și LUNA trebuie specificate, iar grupul AN;LUNA;ZI reprezintă data recipisei (dacă există) sau data la care documentul a fost încărcat în TDec.
5	ZILE	INT(2)	Numărul de zile în format NN pentru care se face interogarea, unde 00 = azi, 01 = azi și ieri, … 99 = ultimele 99 zile până în prezent. Dacă ZILE este specificat, atunci AN și LUNA nu trebuie specificate.
6	TIP	STRING(1…5)	Tipul declarației (indiferent dacă este sau nu rectificativă), pentru CATEGORIE = D Litera „T” - Trimisă sau „P” - primită, pentru CATEGORIE = F Categorie sau Detalii mesaj, pentru CATEGORIE = S
	IDFACTURA	STRING	Numărul unic al facturii (cbc:ID din XML), pentru CATEGORIE = F
	LIVRARE	STRING	Locația de livrare din factură (cac:Delivery/cac:DeliveryLocation/cbc:ID din XML), pentru CATEGORIE = F
	IDANAF	INT	Indexul de încărcare obținut de la ANAF pentru CATEGORIE = D,F
	UIT	STRING(16)	UIT obținut de la ANAF pentru transport, pentru CATEGORIE = T
	REF	STRING	Referință declarant (refDeclarant din XML) pentru transport, pentru CATEGORIE = T
	UID	STRING(24)	Unique identifier al fișierului în baza de date. Valoarea UID se obține în prealabil din lista de mesaje.
	ULTIM	STRING	Cuvântul „ULTIM” - returnează ultimul document din CATEGORIE încărcat în TDec pentru CIF specificat, indiferent de starea sa, și ignoră toate celelalte variabile.
7	JSON	STRING(4)	Cuvântul „JSON” Valoare obligatorie.

Descărcare fișier:

GET http://localhost:8080/api/CATEGORIE/UID/FORMAT

unde:

Poziție	Denumire	Tip	Valoare / Constrângeri
1	CATEGORIE	STRING(1)	Litera „D” - Declarații și recipise „F” - Facturi „M” - Mesaj cumpărător (pentru facturi) „T” - Transporturi. „S” - Mesaje SPV. Valoare obligatorie.
2	UID	STRING(24)	Unique identifier al fișierului în baza de date. Valoarea UID se obține în prealabil din lista de mesaje. Valoare obligatorie.
3	FORMAT	STRING(1)	Litera „D” - Declarație PDF „R” - Recipisă PDF „P” - Fișier PDF declarație, factură, transport sau mesaj SPV „X” - Fișier XML declarație, factură, transport „Z” - Fișier ZIP factură Valoare obligatorie.

Încărcare fișier:

POST http://localhost:8080/api/

având Content-Type: application/pdf, application/xml sau text/xml și având fișierul propriu-zis (PDF sau XML) în body:

POST /api/ HTTP/1.1
User-Agent: PostmanRuntime/7.49.1
Accept: */*
Postman-Token: 3fc5710c-0feb-4083-a806-1823f335e670
Host: localhost:8080
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Length: 4807
Content-Type: application/pdf

%PDF-1.7
%âãÏÓ
4 0 obj
<</Length 1780/Filter/FlateDecode>>stream
…

Exemple apeluri:

http://localhost:8080/api/D/123453/2023/04/23//JSON
http://localhost:8080/api/D/123453/2022/01/11/D100/JSON
http://localhost:8080/api/D/123453/2022/03//D112/JSON
http://localhost:8080/api/F/123453////23358/JSON
http://localhost:8080/api/F/123453////23369/JSON
http://localhost:8080/api/D/12340/2022/02//D394/JSON
http://localhost:8080/api/D/12340/2021/11///JSON
http://localhost:8080/api/F/123453/2022/04/28//JSON
http://localhost:8080/api/T/12340////ULTIM/JSON
http://localhost:8080/api/T/12340////4C0U0C0J0W3DDQ92/JSON
http://localhost:8080/api/S/12340/2024/05//EXTRAS%20DE%20CONT/JSON
http://localhost:8080/api/C/12340/////JSON
http://localhost:8080/api/D/68d5584b1460ff491742ed28/P

Răspuns HTTP

Răspunsurile sunt în format JSON sau în formatul fișierului solicitat:

Exemple răspunsuri:

Liste de mesaje:

{
    "titlu": "Declarații, recipisa în 2025-11-23",
    "mesaje": [
        {
            "UID": "68d5584b1460ff491742ed28",
            "Nume": "AVTOMOIKA SRL",
            "CIF": 12340,
            "Luna": "2025.10",
            "Tip": "D300",
            "AMEF": "",
            "Stare": "Recipisa OK",
            "Index": 983452713,
            "Data": "2025-11-23 00:00:00",
            "Plati": [
                {
                    "CIF": 12340,
                    "Oblig": "300",
                    "Buget": "20A100101X",
                    "Valoare": 7235
                }
            ],
            "User": "VOLT\\ion"
        },
        {
            "UID": "68d5584b1460ff491762fd25",
            "Nume": "AVTOMOIKA SRL",
            "CIF": 12340,
            "Luna": "2025.08",
            "Tip": "D112",
            "AMEF": "",
            "Stare": "Recipisa OK",
            "Index": 983452821,
            "Data": "2025-11-23 00:00:00",
            "Plati": [
                {
                    "CIF": 12340,
                    "Oblig": "602",
                    "Buget": "5503XXXXXX",
                    "Valoare": 324
                },
                {
                    "CIF": 43214,
                    "Oblig": "602",
                    "Buget": "5503XXXXXX",
                    "Valoare": 23
                },
                {
                    "CIF": 12340,
                    "Oblig": "412",
                    "Buget": "5503XXXXXX",
                    "Valoare": 2342
                },
                {
                    "CIF": 12340,
                    "Oblig": "432",
                    "Buget": "5503XXXXXX",
                    "Valoare": 815
                },
                {
                    "CIF": 12340,
                    "Oblig": "480",
                    "Buget": "20470300XX",
                    "Valoare": 301
                }
            ],
            "User": "VOLT\\mihai"
        },
        {
            "UID": "68d5584b1460ff491742ed22",
            "Nume": "AVTOMOIKA SRL",
            "CIF": 12340,
            "Luna": "2025.10",
            "Tip": "D398",
            "AMEF": "",
            "Stare": "Recipisa OK",
            "Index": 983452714,
            "Data": "2025-11-23 00:00:00",
            "Plati": [
                {
                    "CIF": 12340,
                    "Oblig": "398",
                    "Buget": "",
                    "Valoare": 2154.75
                }
            ],
            "User": "VOLT\\ion"
        },
        {
            "UID": "68d5584b1460ff491742ed1c",
            "Nume": "APTEKA SA",
            "CIF": 123453,
            "Luna": "2025.10",
            "Tip": "D406",
            "AMEF": "",
            "Stare": "Recipisa OK",
            "Index": 983452715,
            "Data": "2025-11-23 00:00:00",
            "Plati": [],
            "User": "VOLT\\mihai"
        }
    ]
}

unde:

Denumire	Tip	Valoare / Constrângeri
.UID	STRING(24)	Unique identifier al fișierului în baza de date
.Nume	STRING
.CIF	INT(2,13)
.Luna	STRING(7)	yyyy.MM
.Tip	STRING(2,5)
.AMEF	STRING(0,20)	"" sau Format NUI_ZStart_ZStop (0000000000_0000_0000)
.Stare	STRING	"Recipisa OK", "Recipisa conține atenționări", "Recipisa conține erori" etc
.Index	INT(10)
.Data	DATETIME	yyyy-MM-dd HH:mm:ss
.Plati.CIF	INT(2,13)
.Plati.Oblig	INT(3)
.Plati.Buget	STRING(0,10)	"" sau cod bugetar
.Plati.Valoare	DECIMAL(,2)	Valoare INT în RON cu excepția D398 unde este DECIMAL în EUR
.User	STRING

{
    "titlu": "Facturi, ultima procesată",
    "mesaje": [
        {
            "UID": "6933f1ba1c3be83f9cefd53d",
            "Tip": "T",
            "CIF_SPV": 12340,
            "Nume_furnizor": "AVTOMOIKA SRL",
            "CIF_furnizor": 12340,
            "Nume_cumparator": "APTEKA SA",
            "CIF_cumparator": 123453,
            "Locatie_livrare": "5123454212565",
            "Tip_factura": 380,
            "ID_factura": "AZ1356",
            "Data_factura": "2025-12-13 00:00:00",
            "Valoare_neta": "500.00",
            "Valoare_TVA": "105.00",
            "Suma": "605.00",
            "Moneda": "RON",
            "Contract": "CT35",
            "Comanda": "PO153",
            "Aviz": "AVS351",
            "Index_incarcare": 5782315302,
            "Index_descarcare": 5651354411,
            "Data_ANAF": "2025-12-13 11:04:58",
            "Stare": "Răspuns OK",
            "User": "VOLT\\mihai"
        }
    ]
}

unde:

Denumire	Tip	Valoare / Constrângeri
.UID	STRING(24)	Unique identifier al fișierului în baza de date
.Tip	STRING(1)	E, P, T
.CIF_SPV	INT(2,13)
.Nume_furnizor	STRING
.CIF_furnizor	INT(2,13)
.Nume_cumparator	STRING
.CIF_cumparator	INT(2,13)
.Locatie_livrare	STRING
.Tip_factura	INT(3)
.ID_factura	STRING
.Data_factura	DATETIME	yyyy-MM-dd HH:mm:ss
.Valoare_neta	DECIMAL(,2)	Valoare fără TVA
.Valoare_TVA	DECIMAL(,2)	Valoare TVA
.Suma	DECIMAL(,2)	Valoare cu TVA
.Moneda	STRING(3)	ISO 4217
.Contract	STRING
.Comanda	STRING
.Aviz	STRING
.Index_incarcare	INT(10)
.Index_descarcare	INT(10)
.Data_ANAF	DATETIME	yyyy-MM-dd HH:mm:ss
.Stare	STRING	"Răspuns OK", "Răspunsul conține erori: …" etc
.User	STRING

{
    "titlu": "Transporturi, CUI 12340, UIT / referință 3E5P6P7M0T8F4K04",
    "mesaje": [
        {
            "UID": "692855b5f55ae4581172fff2",
            "Nume": "AVTOMOIKA SRL",
            "CIF_SPV": 12340,
            "Nume_partener": "APTEKA SA",
            "CIF_partener": 123453,
            "Nume_transportator": "AVTOMOIKA SRL",
            "Tip_operatiune": 30,
            "Vehicul": "DE16EDF",
            "Data_transport": "2025-11-27 00:00:00",
            "Data_expirare": "2025-12-02 00:00:00",
            "Valoare_neta": "195.00",
            "Referinta": "REF1234TR",
            "Cod_UIT": "9C2Q578701730174",
            "Index": 0,
            "Data": "2025-11-27 15:44:21",
            "Stare": "Transmiterea a eșuat:  Nu aveti drept in SPV pentru CIF=12340",
            "User": "VOLT\\ion"
        }
    ]
}

unde:

Denumire	Tip	Valoare / Constrângeri
.UID	STRING(24)	Unique identifier al fișierului în baza de date
.Nume	STRING
.CIF_SPV	INT(2,13)
.Nume_partener	STRING
.CIF_partener	INT(2,13)
.Nume_transportator	STRING
.Tip_operatiune": 30,
.Vehicul	STRING	1…3 numere de înmatriculare separate prin spațiu
.Data_transport	DATETIME	yyyy-MM-dd HH:mm:ss
.Data_expirare	DATETIME	yyyy-MM-dd HH:mm:ss
.Valoare_neta	DECIMAL(,2)	Valoare fără TVA
.Referinta	STRING
.Cod_UIT	STRING(16)
.Index	INT(10)
.Data	DATETIME	yyyy-MM-dd HH:mm:ss
.Stare	STRING	"Răspuns OK", "Răspunsul conține erori: …" etc
.User	STRING

{
    "titlu": "Mesaje SPV, recipisa în 2025-12-03, tip sau detalii EXTRAS DE CONT",
    "mesaje": [
        {
            "UID": "69306e5c5b132027bf5991f9",
            "Nume": "APTEKA SA",
            "CIF": 1234530,
            "Data_descarcat": "2025-12-03 12:08:45",
            "Categorie": "EXTRAS DE CONT",
            "Detalii": "extrasul pentru CUI 12340, COD_TREZ TREZ002, din data 2025-12-02 07:53:00",
            "Stare": "Mesaj OK",
            "Index": 813891253,
            "Solicitare": "",
            "Data_solicitare": "0001-01-01 02:00:00",
            "Intrebare": "",
            "Data": "2025-12-03 00:00:00",
            "User": "VOLT\\ion"
        }
    ]
}

unde:

Denumire	Tip	Valoare / Constrângeri
.UID	STRING(24)	Unique identifier al fișierului în baza de date
.Nume	STRING
.CIF	INT(2,13)
.Data_descarcat	DATETIME	yyyy-MM-dd HH:mm:ss
.Categorie	STRING
.Detalii	STRING
.Stare	STRING	"Mesaj OK", "Mesaj transmis", "Solicitare eșuată: …" etc
.Index	INT(10)
.Solicitare	STRING
.Data_solicitare	DATETIME	yyyy-MM-dd HH:mm:ss
.Intrebare	STRING
.Data	DATETIME	yyyy-MM-dd HH:mm:ss
.User	STRING

{
    "titlu": "Firme, CUI 12340",
    "mesaje": [
        {
            "CIF": 12340,
            "Data_adaugarii": "2025-01-20 21:16:22",
            "Activa": 1,
            "SPV_activ": 1,
            "SPV_actualizat": "2026-01-24 20:10:49",
            "Efactura_activ": 1,
            "Efactura_actualizat": "2026-01-24 20:12:42",
            "Efactura_doarprimite_activ": 0,
            "Etransport_activ": 0,
            "Etransport_actualizat": "0001-01-01 02:00:00",
            "Nume": "AVTOMOIKA SRL",
            "Adresa": "Bucuresti, Sector 2, Str. Valea Seaca, Nr.12, Ap.3",
            "Codpostal": "010516",
            "Alias": "AVT_SRL",
            "Tip_TVA": "NEINREGISTRAT",
            "ONRC": "J40/12345/1991",
            "Data_inregistrarii": "1992-12-10 00:00:00",
            "Email_notificari": "vlt@gmail.com",
            "Email_declaratii": "avt@yahoo.com",
            "Telefon": "0723456789",
            "Reprezentant_nume": "Ion Pop",
            "Reprezentant_functie": "Administrator",
            "Grupa": "mici",
            "Responsabil": "Daniela",
            "Certificat": "Ion Pop (pop@gmail.com)",
            "Trezorerie": "702",
            "IBAN": [
                "RO04BKCH0000011111111111",
                "RO50BREL0002001233190100"
            ],
            "CUI_sediisecundare": [
                "189482",
                "16899"
            ],
            "Observatii": "tse",
            "CAEN": 6310,
            "User": "VOLT\\ion",
            "Vector": [
                {
                    "Tip": "OBLIGATIE",
                    "Obiect": "103",
                    "Descriere": "",
                    "Perioada": 3,
                    "Termen_an": 0,
                    "Termen_semestru": 0,
                    "Luna_start": "",
                    "Luna_stop": "",
                    "Permanent": 1
                },
                {
                    "Tip": "OBLIGATIE",
                    "Obiect": "216",
                    "Descriere": "",
                    "Perioada": 1,
                    "Termen_an": 0,
                    "Termen_semestru": 0,
                    "Luna_start": "2023.05",
                    "Luna_stop": "2023.12",
                    "Permanent": 1
                },
                {
                    "Tip": "OBLIGATIE",
                    "Obiect": "300",
                    "Descriere": "",
                    "Perioada": 3,
                    "Termen_an": 0,
                    "Termen_semestru": 0,
                    "Luna_start": "2024.01",
                    "Luna_stop": "",
                    "Permanent": 1
                },
                {
                    "Tip": "OBLIGATIE",
                    "Obiect": "412",
                    "Descriere": "",
                    "Perioada": 1,
                    "Termen_an": 0,
                    "Termen_semestru": 0,
                    "Luna_start": "",
                    "Luna_stop": "",
                    "Permanent": 1
                },
                {
                    "Tip": "OBLIGATIE",
                    "Obiect": "432",
                    "Descriere": "",
                    "Perioada": 1,
                    "Termen_an": 0,
                    "Termen_semestru": 0,
                    "Luna_start": "",
                    "Luna_stop": "",
                    "Permanent": 1
                },
                {
                    "Tip": "OBLIGATIE",
                    "Obiect": "480",
                    "Descriere": "",
                    "Perioada": 1,
                    "Termen_an": 0,
                    "Termen_semestru": 0,
                    "Luna_start": "",
                    "Luna_stop": "",
                    "Permanent": 1
                },
                {
                    "Tip": "OBLIGATIE",
                    "Obiect": "602",
                    "Descriere": "",
                    "Perioada": 1,
                    "Termen_an": 0,
                    "Termen_semestru": 0,
                    "Luna_start": "",
                    "Luna_stop": "",
                    "Permanent": 1
                },
                {
                    "Tip": "DECLARATIE",
                    "Obiect": "S",
                    "Descriere": "",
                    "Perioada": 6,
                    "Termen_an": 5,
                    "Termen_semestru": 8,
                    "Luna_start": "",
                    "Luna_stop": "",
                    "Permanent": 1
                },
                {
                    "Tip": "DECLARATIE",
                    "Obiect": "SFI",
                    "Descriere": "",
                    "Perioada": 3,
                    "Termen_an": 0,
                    "Termen_semestru": 0,
                    "Luna_start": "",
                    "Luna_stop": "",
                    "Permanent": 1
                }
            ],
            "Variabile": {
                "CONTRACT": "123/12",
                "FFA": "DA",
                "ORE": "500",
                "TERMENDEPLATA": "60z"
            },
            "Abonamente": [
                {
                    "Furnizor": 123453,
                    "Denumire": "Contabilitate FX",
                    "Contract": "wr2",
                    "Valoare": 500,
                    "Moneda": "RON",
                    "Facturare_inavans": 0,
                    "Facturare_perioada": 1,
                    "Facturare_inziua": 15,
                    "Termenplata": 30,
                    "Luna_ultima": "2025.07",
                    "Luna_start": "",
                    "Luna_stop": "2026.03",
                    "Activitati": [
                        {
                            "Denumire": "Numarat banii",
                            "Valoare": 0,
                            "Moneda": "EUR",
                            "UM": "H87",
                            "Perioada": 1,
                            "Adaugare_inziua": 2,
                            "Adaugare_indata": "2026-02-21 00:00:00",
                            "Sarcinaclient": 0,
                            "Notificari": 0,
                            "Luna_ultima": "2025.09"
                        },
                        {
                            "Denumire": "Asist. juridică",
                            "Valoare": 100,
                            "Moneda": "EUR",
                            "UM": "HUR",
                            "Perioada": 0,
                            "Adaugare_inziua": 4,
                            "Adaugare_indata": "2026-02-21 00:00:00",
                            "Sarcinaclient": 0,
                            "Notificari": 0,
                            "Luna_ultima": "2024.12"
                        }
                    ]
                }
            ]
        }
    ]
}

unde:

Denumire	Tip	Valoare / Constrângeri
.CIF	INT(2,13)	Cod fiscal sau CNP
.Data_adaugarii	DATETIME	Data adăugării în TDec, yyyy-MM-dd HH:mm:ss
.Activa	INT(1)	1 - Da, 0 - Nu
.SPV_activ	INT(1)	1 - Da, 0 - Nu
.SPV_actualizat	DATETIME	yyyy-MM-dd HH:mm:ss
.Efactura_activ	INT(1)	1 - Da, 0 - Nu
.Efactura_actualizat	DATETIME	yyyy-MM-dd HH:mm:ss
.Efactura_doarprimite_activ	INT(1)	1 - Da, 0 - Nu
.Etransport_activ	INT(1)	1 - Da, 0 - Nu
.Etransport_actualizat	DATETIME	yyyy-MM-dd HH:mm:ss
.Nume	STRING	Denumire firmă sau persoană fizică
.Adresa	STRING	Format: JUDEȚ, LOCALITATE, Str. STRADA, Nr.NUMĂR, Bl.B2, Sc.SCARĂ, Et.ETAJ, Ap.APARTAMENT
.Codpostal	STRING(0,6)	"" sau număr din 6 cifre
.Alias	STRING
.Tip_TVA	STRING	NEINREGISTRAT, INREGISTRAT, INTRACOMUNITAR, LAINCASARE, GRUP_REPREZENTANT, GRUP_MEMBRU
.ONRC	STRING	"", J00/00000/0000 sau J0000000000000
.Data_inregistrarii	DATETIME	yyyy-MM-dd HH:mm:ss
.Email_notificari	STRING	email1@domain.ro,email2@domain.com,…
.Email_declaratii	STRING	email@domain.ro
.Telefon	STRING(0,10)	0700000000
.Reprezentant_nume	STRING	Nume și prenume
.Reprezentant_functie	STRING
.Grupa	STRING	"", mici, mijlocii, mari
.Responsabil	STRING
.Certificat	STRING	Nume Prenume (email@domain.ro)
.Trezorerie	STRING(0,3)	"" sau cod de 3 cifre
.IBAN	STRING[]	Array
.CUI_sediisecundare	STRING[]	Array
.Observatii	STRING
.CAEN	INT(0,4)
.User	STRING
.Vector[].Tip	STRING	AMEF, DECLARATIE, OBLIGATIE
.Vector[].Obiect	STRING	Cod ce reprezintă NUI AMEF, tip declarație sau cod obligație
.Vector[].Descriere	STRING
.Vector[].Perioada	INT(1,2)	1 - Lunar, 3 - Trimestrial, 6 - Semestrial, 12 - Anual
.Vector[].Termen_an	INT(1,2)	Luna în cazul vectorilor cu termen anual sau semestrial
.Vector[].Termen_semestru	INT(1,2)	Luna în cazul vectorilor cu termen semestrial
.Vector[].Luna_start	STRING(0,7)	"" sau yyyy.MM
.Vector[].Luna_stop	STRING(0,7)	"" sau yyyy.MM
.Vector[].Permanent	INT(1)	1 - Da, 0 - Nu
.Variabile	STRING[]	Associative array
.Abonamente[].Furnizor	INT(2,13)	CIF
.Abonamente[].Denumire	STRING
.Abonamente[].Contract	STRING	Număr și dată contract
.Abonamente[].Valoare	DECIMAL(5,2)	Valoare abonament pe perioada .Facturare_perioada
.Abonamente[].Moneda	STRING(3)	ISO 4217
.Abonamente[].Facturare_inavans	INT(1)	1 - Da, 0 - Nu
.Abonamente[].Facturare_perioada	INT(1,2)	0 - Suspendat, 1 - Lunar, 2 - Bilunar, 3 - Trimestrial, 6 - Semestrial, 12 - Anual
.Abonamente[].Facturare_inziua	INT(1,2)	0…31
.Abonamente[].Termenplata	INT(1,3)	Zile calendaristice pentru scadența plății
.Abonamente[].Luna_ultima	STRING(0,7)	"" sau yyyy.MM
.Abonamente[].Luna_start	STRING(0,7)	"" sau yyyy.MM
.Abonamente[].Luna_stop	STRING(0,7)	"" sau yyyy.MM
.Abonamente[].Activitati[].Denumire	STRING	Denumire serviciu suplimentar sau activitate
.Abonamente[].Activitati[].Valoare	DECIMAL(5,2)	Valoarea pentru o prestație
.Abonamente[].Activitati[].Moneda	STRING(3)	ISO 4217
.Abonamente[].Activitati[].UM	STRING(2,3)	UN/ECE Recommendation 20, including Recommendation 21 codes - prefixed with X
.Abonamente[].Activitati[].Perioada	INT(1,2)	-1 La data de .Adaugare_indata, 0 - La cerere, 1 - Lunar, 2 - Bilunar, 3 - Trimestrial, 6 - Semestrial, 12 - Anual
.Abonamente[].Activitati[].Adaugare_inziua	INT(1,2)	0…31
.Abonamente[].Activitati[].Adaugare_indata	DATETIME	yyyy-MM-dd HH:mm:ss
.Abonamente[].Activitati[].Sarcinaclient	INT(1)	1 - Da, 0 - Nu
.Abonamente[].Activitati[].Notificari	INT(1)	1 - Da, 0 - Nu
.Abonamente[].Activitati[].Luna_ultima	STRING(0,7)	"" sau yyyy.MM

Descărcare fișier:

HTTP/1.1 200 OK
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: POST, GET, OPTIONS
Access-Control-Allow-Headers: Content-Type
Content-Type: application/pdf
Content-Length: 4806
Content-Disposition: inline; filename="factura.pdf"
Connection: close

%PDF-1.7
%âãÏÓ
4 0 obj
<</Length 1779/Filter/FlateDecode>>stream
…

Încărcare fișier:
```
{"UID":"693e6b79767cc7a10b38eeb3"}
```
Solicitare eronată (malformată):
```
{"error":"Bad request"}
```
Descărcare fișier inexistent:
```
{"error":"Not found"}
```

Test AJAX

Aceasta este o simplă demostrație de apel folosing AJAX. Pentru a funcționa, trebuie să permiteți (pe perioada testului) accesul acestui website să se conecteze la orice dispozitiv din rețeaua locală.

GET http://localhost:/api/

POST http://localhost:/api/

Rezultat: