API

Documentele firmei, direct din programul tău

Bonurile, facturile externe și celelalte documente ale firmei, direct din programul tău — cu aceleași reguli și aceleași limite ca prin site.

Documentația tehnică Creează cont

Pentru cine este

Firme cu un sistem propriu

Dacă cheltuielile intră deja undeva — un ERP, un program de gestiune, o aplicație făcută pentru voi — bonurile pot pleca de acolo automat, în loc să le reintroducă cineva a doua oară.

Contabili cu multe firme

O singură cheie citește documentele tuturor clienților la care ești legat, ca să le preiei direct în programul tău de contabilitate, fără să le descarci firmă cu firmă.

Cum arată

Trimiți cheia în antetul cererii și primești JSON. Atât.

curl https://api.bonurile.ro/v1/receipts?month=2026-09 \
  -H "Authorization: Bearer bnr_live_…"

{
  "data": [
    {
      "id": "6aa7b166af18714a560c9a72",
      "type": "fuel",
      "amount": "159.74",
      "vendor_name": "DIA LITORAL SRL",
      "vendor_cui": "RO28843217",
      "document_date": "2026-08-25",
      "file_url": "https://api.bonurile.ro/v1/receipts/6aa7b166af18714a560c9a72/file"
    }
  ],
  "meta": { "per_page": 50, "next_cursor": null }
}

Sumele sunt șiruri de caractere, nu numere zecimale — ca 142.60 să rămână 142.60 și în programul tău de contabilitate.

Cum începi

1. Intri în contul firmei, la Acces API (meniul din dreapta sus). Contabilii găsesc același lucru în portofoliu.
2. Faci o cheie, îi dai un nume după care o recunoști și alegi dacă are voie doar să citească sau și să scrie.
3. O copiezi — se arată o singură dată — și o lipești în programul tău.
4. Primul apel este GET /v1/me: îți spune ce firmă e, ce plan are și cât din plafonul lunii ai folosit.

Toate adresele, câmpurile și erorile sunt în documentația tehnică, unde poți și încerca apelurile pe datele firmei tale.

Întrebări frecvente

De ce aș folosi API-ul în loc de site?

Pentru că programul tău poate face treaba singur. Dacă firma are deja un sistem în care intră cheltuielile, bonurile pot pleca de acolo direct, fără ca cineva să le reintroducă. Iar dacă ești contabil, documentele clienților pot ajunge în programul tău de contabilitate fără să le descarci de fiecare dată.

Ce planuri includ accesul?

Pro și Max. Pentru o cheie de contabil contează planul clientului, nu al tău — contabilii nu plătesc niciodată. Verificarea se face la fiecare cerere, deci o firmă care trece pe gratuit dispare imediat din rezultate.

Documentele trimise prin API intră în plafonul lunar?

Da, în același plafon ca cele adăugate din site. Altfel cea mai ieftină cale de a ocoli planul ar fi un script. Plafonul se numără separat pentru bonuri, facturi externe și alte fișiere, iar GET /v1/me îți spune oricând cât ai folosit din fiecare.

Câte cereri pot face?

60 pe minut, pentru fiecare cheie. Este o fereastră glisantă, iar o cerere refuzată nu se numără — un client care reîncearcă prea des nu își sapă singur groapa. Fiecare răspuns îți spune câte ți-au rămas.

Ce se întâmplă dacă pierd cheia?

Nu se poate recupera. Cheia se arată o singură dată, la creare, pentru că nu o păstrăm nicăieri — în baza noastră există doar o amprentă a ei. Dacă ai pierdut-o, o revoci și faci alta.

Ce pot face cu o cheie de citire?

Tot ce înseamnă a vedea: liste, un document anume, fișierul lui, exportul lunar. Nu poate adăuga, modifica sau șterge nimic. Accesul se alege la creare și nu se mai poate schimba — altfel ai lărgi pe nesimțite o cheie pe care cineva a lipit-o deja într-un program.

Ce se întâmplă dacă un script șterge din greșeală?

Ștergerea ascunde documentul 30 de zile, nu îl distruge. Fișierul rămâne, ștergerea apare în Activitate cu numele cheii care a făcut-o, iar până la expirare documentul poate fi recuperat.

Există integrare gata făcută cu SAGA sau WinMentor?

Nu există un conector pe care să îl activezi singur. API-ul este cărămida din care se construiește unul, iar pe planul Max îl construim împreună, pentru programul pe care îl folosești.

Vezi documentația

Toate adresele, câmpurile și erorile, cu o consolă în care poți încerca apelurile pe datele firmei tale.

Deschide documentația Vezi cum funcționează