Autentificare

Fiecare cerere autentificată poartă două headere:

Authorization: Bearer fgo_test_api_v1....
Fgo-Cod-Unic: 12345678

Cheia decide firma. E generată pentru firma selectată în FGO în momentul generării și nu poate lucra pentru alta — pentru altă firmă folosești altă cheie.

Fgo-Cod-Unic nu alege firma; confirmă că ai legat cheia potrivită în configurația ta. Dacă nu se potrivește cu firma cheii, primești 403 cu motiv.cod = cod_unic_neasociat. Trimite numai cifrele, fără RO și fără spații.

Nomenclatoarele (/v2/nomenclatoare/...) sunt singurele operații fără autentificare.

Verifică cheia

curl https://api-testuat.fgo.ro/v2/identitate \
  -H "Authorization: Bearer fgo_test_api_v1...." \
  -H "Fgo-Cod-Unic: 12345678"

{
  "data": {
    "drepturi": ["facturi:citire", "facturi:emitere", "articole:citire"],
    "expira_la": null,
    "cautare_articol_dupa": "cod_articol"
  },
  "meta": { "timestamp": "2026-09-03T12:00:00+03:00" }
}

expira_la e null când cheia nu are termen. Când are, e un moment RFC 3339 cu offset. Codul unic nu apare în răspuns.

cautare_articol_dupa e câmpul după care firma identifică articolele, setarea „Căutare articole după” din Configurare API: cod_articol, cod_bare sau denumire. Citește-l la pornirea integrării: la emitere articolul se caută după acest câmp când linia îl are, iar pe listare și stocuri e singurul filtru de identificare acceptat. Vezi Emiterea unei facturi.

Drepturi

Când generezi cheia, alegi ce are voie să facă. Fiecare operație din referință își scrie dreptul necesar la finalul descrierii, sub Drept necesar.

Drept	Ce deschide
`facturi:citire`	listarea facturilor, starea unei facturi, statusul e-Factura, facturile asociate unei proforme
`facturi:emitere`	emiterea unei facturi și atașarea AWB-ului
`facturi:anulare`	anulare, stornare, ștergere
`facturi:incasare`	adăugarea și ștergerea încasărilor
`facturi:spv`	trimiterea în SPV
`facturi:trimitere`	trimiterea facturii pe email
`articole:citire`	articolele și gestiunile firmei
`clienti:citire`	clienții, clienții cu restanțe, facturile restante ale unui client
`furnizori:citire`	furnizorii, soldul lor, facturile primite de la ei
`clienti:scriere`	crearea și actualizarea clienților fără documente
`furnizori:scriere`	crearea și actualizarea furnizorilor
`leaduri:citire`	listarea și citirea lead-urilor CRM
`leaduri:scriere`	crearea și actualizarea lead-urilor CRM
`facturi-furnizori:scriere`	înregistrarea facturilor primite cu articole și preluare opțională în stoc
`parteneri:citire`	fișele de partener
`solduri:citire`	soldurile conturilor bancare și soldul unui client
`rapoarte:citire`	rapoartele de vânzări
`contabilitate:citire`	balanța și indicatorii financiari
`firma:citire`	poziția firmei la ANAF
`arhive:gestionare`	arhivele PDF

O operație pe care cheia n-are dreptul răspunde 403 cu motiv.cod = drept_lipsa. Același răspuns îl primești și când abonamentul firmei nu include operația — mesajul din motiv.mesaj spune care dintre cele două e cazul.

Dreptul de pe cheie și accesul inclus în abonament sunt verificate separat. De exemplu, articole:citire pe o cheie Premium nu acordă acces la listarea articolelor sau la endpointurile de stoc rezervate Enterprise. Vezi disponibilitatea pe abonamente.

`Fgo-Url-Platforma`

Operațiile care schimbă o factură — emitere, anulare, stornare, ștergere — cer un al treilea header:

Fgo-Url-Platforma: https://magazinul-tau.ro

E adresa site-ului sau a magazinului din care vine cererea. O înregistrezi o singură dată, pe firmă, în Setări eCommerce → API; o adresă neînregistrată respinge cererea.