Clienti e verifica nel registro ANAF (Romania)

Un inserimento o aggiornamento deduplicato su tax_id e una ricerca nel registro ANAF per le aziende rumene, perché l'e-Factura non venga respinta.

Un inserimento o aggiornamento deduplicato su tax_id e una ricerca nel registro ANAF per le aziende rumene, perché l'e-Factura non venga respinta.

← Torna alla documentazione API

La prima fattura in 6 passi

  1. POST /v1/clients crea o aggiorna un cliente, deduplicato su tax_id e, in mancanza, sul nome normalizzato.
  2. GET /v1/clients elenca i clienti con limit, offset e ricerca testuale libera q.
  3. GET /v1/lookup/company/{tax_id} verifica un CUI rumeno nel registro di ANAF e restituisce i dati ufficiali.
  4. Precompila buyer con il risultato della ricerca, così la e-Factura non viene rifiutata per un nome o un indirizzo non aggiornato.

Tutti gli endpoint

MetodoEndpointScopeIdempotency-KeyRichieste / minuto
GET/clients
Elenca i clienti
clients:read—120
POST/clients
Crea o aggiorna un cliente
clients:write—30
GET/lookup/company/{tax_id}
Verifica un CUI rumeno nel registro ANAF
clients:read—120

Cos'è l'API 4invoices

bash
# Deduplicato su tax_id, in mancanza su un nome normalizzato:
# rinviare lo stesso cliente lo AGGIORNA invece di creare un duplicato.
curl -sS -X POST https://api.4invoices.net/v1/clients \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Exemplu Comert SRL",
    "tax_id": "RO12345678",
    "email": "[email protected]",
    "country": "RO",
    "county": "Cluj",
    "city": "Cluj-Napoca",
    "address": "Str. Fabricii 12",
    "iban": "RO49AAAA1B31007593840000"
  }'
bash
curl -sS https://api.4invoices.net/v1/lookup/company/RO12345678 \
  -H "Authorization: Bearer $ACCESS_TOKEN"

# Dati ufficiali del registro ANAF (Romania) — usali per precompilare "buyer" così che
# la e-Factura non venga rifiutata per un nome o un indirizzo non aggiornato.

https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json

Errori frequenti

  • Per emettere non serve un cliente salvato: l’oggetto buyer può essere inviato direttamente in POST /invoices.
  • Per gli acquirenti rumeni, county deve essere il distretto reale; per Bucarest indica il settore in city.
  • tax_id è accettato con o senza prefisso del paese (RO12345678 o 12345678).
  • Reinviare lo stesso cliente aggiorna il record, quindi un’importazione ripetuta non crea duplicati.

Domande e risposte per sviluppatori

Quale scope richiede la ricerca nel registro ANAF rumeno?

clients:read. La scrittura dei clienti richiede clients:write.

Posso importare migliaia di clienti da un sistema legacy?

Sì, ma rispetta il limite di 30 scritture al minuto. Importa a lotti con backoff in caso di 429.

E se il CUI non è nel registro?

La ricerca restituisce 404 not_found. Puoi comunque emettere con i tuoi dati, ma rischi un rifiuto al momento dell’invio (CIUS-RO, in Romania).