Kunder och uppslag i ANAF-registret (Rumänien)

En infogning eller uppdatering deduplicerad på tax_id plus ett uppslag i ANAF-registret (Rumänien), så att e-fakturan inte avvisas.

En infogning eller uppdatering deduplicerad på tax_id plus ett uppslag i ANAF-registret (Rumänien), så att e-fakturan inte avvisas.

← Tillbaka till API-dokumentationen

Din första faktura i 6 steg

  1. POST /v1/clients skapar eller uppdaterar en kund, deduplicerad på tax_id och annars på det normaliserade namnet.
  2. GET /v1/clients listar kunder med limit, offset och fritextsökningen q.
  3. GET /v1/lookup/company/{tax_id} validerar ett CUI mot ANAF-registret (Rumänien) och returnerar de officiella uppgifterna.
  4. Förifyll buyer med resultatet av uppslaget, så att e-Factura inte avvisas på grund av ett föråldrat namn eller en gammal adress.

Alla endpoints

MetodEndpointScopeIdempotency-KeyFörfrågningar / minut
GET/clients
Lista kunder
clients:read—120
POST/clients
Skapa eller uppdatera en kund
clients:write—30
GET/lookup/company/{tax_id}
Validera ett CUI mot ANAF-registret (Rumänien)
clients:read—120

Vad 4invoices API är

bash
# Deduplicerad på tax_id, annars på det normaliserade namnet:
# att skicka samma kund igen UPPDATERAR den i stället för att skapa en dubblett.
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"

# Officiella uppgifter från ANAF-registret (Rumänien) — använd dem för att förifylla "buyer" så att
# e-Factura inte avvisas på grund av ett föråldrat namn eller en gammal adress.

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

Vanliga misstag

  • Du behöver ingen sparad kund för att utfärda: buyer-objektet kan skickas direkt i POST /invoices.
  • För rumänska köpare måste county vara det riktiga länet; för Bukarest anger du sektorn i city.
  • tax_id accepteras med eller utan landsprefix (RO12345678 eller 12345678).
  • Att skicka samma kund igen uppdaterar posten, så en upprepad import skapar inga dubbletter.

Frågor och svar för utvecklare

Vilket scope behövs för uppslaget i ANAF-registret (Rumänien)?

clients:read. Att skriva kunder kräver clients:write.

Kan jag importera tusentals kunder från ett äldre system?

Ja, men respektera skrivgruppen på 30 per minut. Importera i omgångar med backoff vid 429.

Vad händer om CUI:t inte finns i registret?

Uppslaget returnerar 404 not_found. Du kan fortfarande utfärda med dina egna uppgifter, men riskerar ett avslag vid inlämningen (i Rumänien enligt CIUS-RO).