tax_id üzerinden tekilleştirilmiş ekleme veya güncelleme (upsert) ve ANAF sicil sorgusu (Romanya), böylece e-fatura reddedilmez.
6 adımda ilk fatura
- POST /v1/clients bir müşteriyi oluşturur veya günceller; tekilleştirme tax_id’ye, o yoksa normalleştirilmiş ada göre yapılır.
- GET /v1/clients müşterileri limit, offset ve serbest metin q ile listeler.
- GET /v1/lookup/company/{tax_id} bir CUI’yi ANAF sicilinde (Romanya) doğrular ve resmî verileri döndürür.
- e-Factura’nın güncel olmayan bir ad veya adres yüzünden reddedilmemesi için buyer’ı sorgu sonucundan önceden doldurun.
Tüm uç noktalar
| Metot | Uç nokta | Scope | Idempotency-Key | İstek / dakika |
|---|---|---|---|---|
| GET | /clients Müşterileri listele | clients:read | — | 120 |
| POST | /clients Müşteri oluştur veya güncelle | clients:write | — | 30 |
| GET | /lookup/company/{tax_id} ANAF sicilinde CUI doğrula (Romanya) | clients:read | — | 120 |
4invoices API'si nedir
bash
# tax_id'ye göre tekilleştirilir; yoksa normalleştirilmiş ada göre:
# Aynı müşteriyi yeniden göndermek, çift kayıt yerine onu GÜNCELLER.
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"
# ANAF sicilinden (Romanya) resmi veriler — "buyer" alanını önceden doldurmak için kullanın, böylece
# e-Factura eski bir ad veya adres yüzünden reddedilmesin.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Sık yapılan hatalar
- Düzenleme için kayıtlı bir müşteriye ihtiyacınız yoktur: buyer nesnesi POST /invoices içinde inline gönderilebilir.
- Romen alıcılar için county gerçek il (județ) olmalıdır; Bükreş için sektörü city alanına yazın.
- tax_id ülke önekiyle veya öneksiz kabul edilir (RO12345678 ya da 12345678).
- Aynı müşteriyi yeniden göndermek kaydı günceller; böylece tekrarlanan bir içe aktarma mükerrer kayıt oluşturmaz.
Geliştiriciler için soru ve cevaplar
ANAF sicil sorgusu (Romanya) hangi scope’u gerektirir?
clients:read. Müşteri yazmak için clients:write gerekir.
Eski bir sistemden binlerce müşteri aktarabilir miyim?
Evet, ancak dakikada 30’luk yazma kovasına uyun. 429’da backoff uygulayarak partiler hâlinde aktarın.
CUI sicilde yoksa ne olur?
Sorgu 404 not_found döndürür. Kendi verilerinizle yine de düzenleyebilirsiniz, ancak gönderimde ulusal e-fatura sisteminin reddetmesi riskini alırsınız.