Kunder og opslag i ANAF-registret (Rumænien)

En indsættelse eller opdatering deduplikeret på tax_id plus et opslag i ANAF-registret (Rumænien), så e-fakturaen ikke afvises.

En indsættelse eller opdatering deduplikeret på tax_id plus et opslag i ANAF-registret (Rumænien), så e-fakturaen ikke afvises.

← Tilbage til API-dokumentationen

Din første faktura i 6 trin

  1. POST /v1/clients opretter eller opdaterer en kunde, deduplikeret på tax_id og, hvis den mangler, på det normaliserede navn.
  2. GET /v1/clients lister kunder med limit, offset og fritekst-q.
  3. GET /v1/lookup/company/{tax_id} validerer et CUI mod ANAF-registret (Rumænien) og returnerer de officielle data.
  4. Forudfyld buyer med resultatet af opslaget, så e-Factura ikke afvises på grund af et forældet navn eller en forældet adresse.

Alle endpoints

MetodeEndpointScopeIdempotency-KeyAnmodninger / minut
GET/clients
List kunder
clients:read—120
POST/clients
Opret eller opdatér en kunde
clients:write—30
GET/lookup/company/{tax_id}
Validér et CUI mod ANAF-registret (Rumænien)
clients:read—120

Hvad 4invoices API'et er

bash
# Deduplikeret på tax_id, ellers på det normaliserede navn:
# gensendelse af den samme kunde OPDATERER den i stedet for at oprette en dublet.
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"

# Officielle data fra ANAF-registret (Rumænien) — brug dem til at forudfylde "buyer", så
# e-Factura ikke afvises på grund af et forældet navn eller en forældet adresse.

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

Almindelige fejl

  • Du behøver ikke en gemt kunde for at udstede: buyer-objektet kan sendes direkte i POST /invoices.
  • For rumænske købere skal county være det rigtige amt; for Bukarest skal sektoren angives i city.
  • tax_id accepteres med eller uden landeprefiks (RO12345678 eller 12345678).
  • Gensendelse af den samme kunde opdaterer posten, så en gentagen import ikke skaber dubletter.

Spørgsmål og svar for udviklere

Hvilket scope kræver opslaget i ANAF-registret (Rumænien)?

clients:read. Skrivning af kunder kræver clients:write.

Kan jeg importere tusindvis af kunder fra et ældre system?

Ja, men respektér skrivekvoten på 30 pr. minut. Importér i batches med backoff ved 429.

Hvad hvis CUI'et ikke findes i registret?

Opslaget returnerer 404 not_found. Du kan stadig udstede med dine egne data, men risikerer en afvisning ved indsendelsen (i Rumænien efter CIUS-RO).