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
- POST /v1/clients skapar eller uppdaterar en kund, deduplicerad på tax_id och annars på det normaliserade namnet.
- GET /v1/clients listar kunder med limit, offset och fritextsökningen q.
- GET /v1/lookup/company/{tax_id} validerar ett CUI mot ANAF-registret (Rumänien) och returnerar de officiella uppgifterna.
- 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
| Metod | Endpoint | Scope | Idempotency-Key | Fö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).