Pentru aplicațiile scrise deja pe API-ul FGO v7 (ex. AnyQR, eScadent). Aceiași parametri, același hash SHA-1, același format de răspuns (Success, Message, Factura). Pentru aplicațiile noi și pentru magazine folosește API-ul eZif, care e mai sigur (HMAC-SHA256).
Activarea
Integrări → API și chei → Compatibil FGO → Activează. Primești o singură dată cheia privată; CodUnic este CUI-ul firmei (doar cifrele). Documentele se emit în numele celui care a activat compatibilitatea. Domeniile autorizate se aplică și aici, pe PlatformaUrl.
Ce schimbi în aplicație
| Setare | FGO | eZif |
|---|---|---|
| Adresa de bază | https://api.fgo.ro/v1 |
https://dev.ezif.ro/api/fgo/v1 (producție: https://app.ezif.ro/api/fgo/v1) |
| Cheia privată | cea din FGO | cea din eZif |
| CodUnic, Serie | la fel | la fel (seria trebuie să existe în eZif cu același prefix) |
Metodele acceptate
| Metoda | Hash = SHA-1 cu majuscule din | Observații |
|---|---|---|
POST /factura/emitere |
CodUnic + cheia + Client[Denumire] |
IdExtern = aceeași comandă nu dublează factura; PretUnitar = preț fără TVA; PretTotal = totalul liniei cu TVA |
POST /factura/print |
CodUnic + cheia + Numar |
Factura.Link = link public la PDF |
POST /factura/getstatus |
CodUnic + cheia + Numar |
Valoare, ValoareAchitata, plus Stare și StareSPV |
POST /factura/incasare |
CodUnic + cheia + NumarFactura |
TipIncasare: Card, Ordin de plată, Numerar… |
POST /factura/stornare |
CodUnic + cheia + Numar |
storno total |
POST /articol/list, /articol/get |
CodUnic + cheia | Pagina, NrArticole (max. 200) / CodArticol |
Limita: 60 de cereri pe minut pe firmă (peste ea, Success: false cu mesajul de așteptare). Cererile pot fi JSON sau formular (Client[Denumire]=…&Continut[0][Denumire]=…), ca în FGO.
Diferențe față de FGO
- Anulare și ștergere: nu există. O factură emisă în eZif e numerotată și, după caz, trimisă în SPV; se corectează cu
/factura/stornare. Răspunsul eSuccess: falsecu explicația. - Adresa clientului (județ, localitate, adresă) este obligatorie, pentru e-Factura.
- Liniile de tip Discount nu sunt acceptate încă: trimite prețul după discount.
- LinkPlata nu există (plata online vine din magazin).
- Erorile au mereu
Success: falseși mesajul în română; erorile neprevăzute intră în Jurnal erori cu un cod.
Înainte de trecerea unei aplicații, emite pe dev o factură de test și compară totalul cu aceeași factură din FGO.