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
- POST /v1/clients crea o aggiorna un cliente, deduplicato su tax_id e, in mancanza, sul nome normalizzato.
- GET /v1/clients elenca i clienti con limit, offset e ricerca testuale libera q.
- GET /v1/lookup/company/{tax_id} verifica un CUI rumeno nel registro di ANAF e restituisce i dati ufficiali.
- 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
| Metodo | Endpoint | Scope | Idempotency-Key | Richieste / 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).