Müşteriler ve şirket sicili sorgusu

tax_id üzerinden tekilleştirilmiş ekleme veya güncelleme (upsert) ve ANAF sicil sorgusu (Romanya), böylece e-fatura reddedilmez.

tax_id üzerinden tekilleştirilmiş ekleme veya güncelleme (upsert) ve ANAF sicil sorgusu (Romanya), böylece e-fatura reddedilmez.

← API dokümantasyonuna dön

6 adımda ilk fatura

  1. 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.
  2. GET /v1/clients müşterileri limit, offset ve serbest metin q ile listeler.
  3. GET /v1/lookup/company/{tax_id} bir CUI’yi ANAF sicilinde (Romanya) doğrular ve resmî verileri döndürür.
  4. 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

MetotUç noktaScopeIdempotency-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.