Kunder og oppslag i ANAF-registeret (Romania)

En innsetting eller oppdatering deduplisert på tax_id pluss et oppslag i ANAF-registeret (Romania), slik at e-fakturaen ikke avvises.

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

  1. POST /v1/clients oppretter eller oppdaterer en kunde, deduplisert på tax_id og ellers på det normaliserte navnet.
  2. GET /v1/clients lister kunder med limit, offset og fritekst-q.
  3. GET /v1/lookup/company/{tax_id} validerer et CUI mot ANAF-registeret (Romania) og returnerer de offisielle opplysningene.
  4. 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

MetodeEndepunktScopeIdempotency-KeyForespø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).