facturamea facturamea
Autentifică-te
← Înapoi la chei API

API pentru dezvoltatori

Conectează facturamea la propriile aplicații sau la alte sisteme de facturare. Poți emite facturi, gestiona clienți și produse programatic, prin REST. Toate sumele sunt în bani (întregi), iar totalurile sunt calculate pe server.

Autentificare

Generează o cheie din Setări → API & integrări și trimite-o în header-ul Authorization. Cheile fm_test_… sunt read-only (nu consumă o serie fiscală reală); cele fm_live_… emit documente reale. 

curl https://facturamea.com/api/v1/ping \
  -H "Authorization: Bearer fm_live_..."

Adresa de bază

https://facturamea.com/api/v1

Endpoint-uri

GET /ping Testează cheia. Returnează compania asociată.
GET /invoices Listează facturile (filtre: limit, offset, kind, status).
POST /invoices Creează și emite o factură.
GET /invoices/{id} Detaliile unei facturi.
GET /clients Listează clienții.
POST /clients Creează un client.
GET /products Listează produsele/serviciile.
POST /products Creează un produs/serviciu.

Emite o factură

POST /invoices. Trimite fie clientId (un client existent), fie un obiect client inline cu cel puțin name. Fiecare linie are name, quantity, unitPriceCents și opțional vatRate, unit, code. Pentru valută non-RON cursul BNR se preia automat; fără curs, cererea e respinsă (nu declarăm 1:1).

Cerere

{
  "client": { "name": "ACME SRL", "taxId": "RO12345678", "address": "Str. Exemplu 1, București" },
  "currency": "RON",
  "dueDate": "2026-07-15",
  "lines": [
    { "name": "Servicii consultanță", "quantity": 2, "unitPriceCents": 50000, "vatRate": 21, "unit": "ore" }
  ]
}

Răspuns

{
  "id": "v1_abc...",
  "fullNumber": "FAC 0042",
  "kind": "factura",
  "status": "issued",
  "currency": "RON",
  "subtotalCents": 100000,
  "vatCents": 21000,
  "totalCents": 121000,
  "clientName": "ACME SRL",
  "issuedAt": "2026-06-26T10:00:00.000Z"
}

Erori

Răspunsurile de eroare au forma { "error", "message" }: 401 unauthorized (cheie lipsă/invalidă), 400 bad_request (date invalide), 404 not_found, 500 server_error.

Vrei integrare cu un magazin (WooCommerce, Shopify, eMag, PrestaShop, Gomag) sau cu plăți (Stripe, Netopia, PayU)? Acelea se configurează fără cod din Setări → Integrări.