e-Factura direct din magazinul tău

API REST

Orice platformă, același flux

Modulele de mai sus sunt clienți ai aceluiași API. Dacă ai un ERP, un magazin custom sau o platformă pe care n-o acoperim încă, îl folosești direct.

• Chei Bearer cu permisiuni pe resurse și preseturi (Viewer, E-commerce, Full)
• OpenAPI 3.1 — 54 de operații, exemple, plic de eroare unitar
• Idempotency-Key pe orice scriere: reîncercarea nu dublează factura
• error_code stabil (plan_limit_reached, anaf_validation_failed, already_sent…) — ramifici pe cod, nu pe text
• Rate limit per cheie, cu headere X-RateLimit-*

# 1. Emite factura (client identificat după CUI, sau inline)
curl -X POST https://zuc.ro/api/v1/invoices \
  -H "Authorization: Bearer zuc_…" \
  -H "Idempotency-Key: shop-order-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "supplier_id": 9,
    "customer_identifier": "RO14399840",
    "customer_name": "CLIENT DEMO SRL",
    "customer_street_name": "Str. Exemplu 1",
    "customer_city_name": "SECTOR2",
    "customer_country_subentity": "RO-B",
    "payment_method": "card",
    "items": [{
      "name": "Tricou bumbac", "quantity": 2,
      "unit_price": 79.90, "vat_rate": 21,
      "unit_of_measure": "buc"
    }]
  }'

# 2. Trimite la ANAF → index_incarcare
#    (a doua oară: 409 already_sent)
curl -X POST https://zuc.ro/api/v1/invoices/141/send-anaf \
  -H "Authorization: Bearer zuc_…"

# 3. PDF pentru client
curl -H "Authorization: Bearer zuc_…" \
  https://zuc.ro/api/v1/invoices/141/pdf -o factura.pdf