Klanten en registercontrole bij ANAF (Roemenië)

Een op tax_id gededupliceerde invoeging of update, plus een controle in het ANAF-register (Roemenië) zodat de e-factuur niet wordt geweigerd.

Een op tax_id gededupliceerde invoeging of update, plus een controle in het ANAF-register (Roemenië) zodat de e-factuur niet wordt geweigerd.

← Terug naar de API-documentatie

Je eerste factuur in 6 stappen

  1. POST /v1/clients maakt een klant aan of werkt die bij, ontdubbeld op tax_id en, als dat ontbreekt, op de genormaliseerde naam.
  2. GET /v1/clients toont klanten met limit, offset en vrije tekst q.
  3. GET /v1/lookup/company/{tax_id} valideert een Roemeens CUI in het register van ANAF en geeft de officiële gegevens terug.
  4. Vul buyer vooraf in met het resultaat van de lookup, zodat de e-Factura niet wordt geweigerd vanwege een verouderde naam of een verouderd adres.

Alle endpoints

MethodeEndpointScopeIdempotency-KeyVerzoeken / minuut
GET/clients
Klanten weergeven
clients:read—120
POST/clients
Een klant aanmaken of bijwerken
clients:write—30
GET/lookup/company/{tax_id}
Een CUI controleren in het ANAF-register (Roemenië)
clients:read—120

Wat de 4invoices-API is

bash
# Ontdubbeld op tax_id, en anders op een genormaliseerde naam:
# opnieuw versturen van dezelfde klant WERKT die bij in plaats van een duplicaat aan te maken.
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"

# Officiële gegevens uit het ANAF-register (Roemenië) — gebruik die om "buyer" vooraf in te vullen, zodat
# de e-Factura niet wordt afgewezen vanwege een verouderde naam of adres.

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

Veelgemaakte fouten

  • U hebt geen opgeslagen klant nodig om uit te geven: het buyer-object kan inline worden meegestuurd bij POST /invoices.
  • Voor Roemeense kopers moet county het werkelijke district zijn; voor Boekarest zet u de sector in city.
  • tax_id wordt geaccepteerd met of zonder landprefix (RO12345678 of 12345678).
  • Dezelfde klant opnieuw sturen werkt het record bij, dus een herhaalde import maakt geen duplicaten aan.

Vragen en antwoorden voor ontwikkelaars

Welke scope heeft de ANAF-lookup (Roemenië) nodig?

clients:read. Voor het schrijven van klanten is clients:write nodig.

Kan ik duizenden klanten importeren uit een legacysysteem?

Ja, maar respecteer de bucket van 30 schrijfbewerkingen per minuut. Importeer in batches, met backoff bij een 429.

Wat als de CUI niet in het register staat?

De lookup geeft 404 not_found terug. U kunt nog steeds met uw eigen gegevens uitgeven, maar u riskeert een afwijzing bij de indiening (in Roemenië: CIUS-RO).