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
- POST /v1/clients opretter eller opdaterer en kunde, deduplikeret på tax_id og, hvis den mangler, på det normaliserede navn.
- GET /v1/clients lister kunder med limit, offset og fritekst-q.
- GET /v1/lookup/company/{tax_id} validerer et CUI mod ANAF-registret (Rumænien) og returnerer de officielle data.
- 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
| Metode | Endpoint | Scope | Idempotency-Key | Anmodninger / 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).