En innsetting eller oppdatering deduplisert på tax_id pluss et oppslag i ANAF-registeret (Romania), slik at e-fakturaen ikke avvises.
← Tilbake til API-dokumentasjonen
Din første faktura på 6 steg
- POST /v1/clients oppretter eller oppdaterer en kunde, deduplisert på tax_id og ellers på det normaliserte navnet.
- GET /v1/clients lister kunder med limit, offset og fritekst-q.
- GET /v1/lookup/company/{tax_id} validerer et CUI mot ANAF-registeret (Romania) og returnerer de offisielle opplysningene.
- Forhåndsutfyll buyer med resultatet av oppslaget, slik at e-Factura ikke avvises på grunn av et utdatert navn eller en utdatert adresse.
Alle endepunkter
| Metode | Endepunkt | Scope | Idempotency-Key | Forespørsler / minutt |
|---|---|---|---|---|
| GET | /clients List kunder | clients:read | — | 120 |
| POST | /clients Opprett eller oppdater en kunde | clients:write | — | 30 |
| GET | /lookup/company/{tax_id} Valider et CUI mot ANAF-registeret (Romania) | clients:read | — | 120 |
Hva 4invoices-API-et er
bash
# Deduplisert på tax_id, ellers på det normaliserte navnet:
# ny sending av samme kunde OPPDATERER den i stedet for å lage et duplikat.
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"
# Offisielle data fra ANAF-registeret (Romania) — bruk dem til å forhåndsutfylle "buyer", slik at
# e-Factura ikke avvises på grunn av et utdatert navn eller en utdatert adresse.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Vanlige feil
- Du trenger ikke en lagret kunde for å utstede: buyer-objektet kan sendes rett i POST /invoices.
- For rumenske kjøpere må county være riktig fylke; for București setter du sektoren i city.
- tax_id godtas med eller uten landprefiks (RO12345678 eller 12345678).
- Ny sending av samme kunde oppdaterer posten, så en gjentatt import lager ingen duplikater.
Spørsmål og svar for utviklere
Hvilket scope trenger oppslaget i ANAF-registeret (Romania)?
clients:read. Å skrive kunder krever clients:write.
Kan jeg importere tusenvis av kunder fra et eldre system?
Ja, men respekter skrivekvoten på 30 per minutt. Importer i batcher med backoff ved 429.
Hva hvis CUI-et ikke finnes i registeret?
Oppslaget returnerer 404 not_found. Du kan fortsatt utstede med egne data, men risikerer en avvisning ved innsending (i Romania etter CIUS-RO).