Ana içeriğe atla

Rehber · 2026-05-16

Markdown dışa aktar

API Aracılığıyla Ölçeklenebilir PDF'ten E-Faturaya Dönüşümün Otomasyonu

PDF'ten e-faturaya dönüşümü API üzerinden otomatikleştirin, asenkron durum sorgulamayı yapılandırın ve her fatura için bir dönüşüm isteğiyle birden çok faturayı programlı olarak işleyin.

Anahtar entegrasyon adımları

  • Geliştirici panelinden bir üretim API anahtarı alın.
  • Tüm istekleri bir Bearer belirteci içeren Authorization üstbilgisiyle yetkilendirin.
  • PDF dosyası ve uyumluluk profili parametreleriyle /api/v1/invoices:convert adresine bir POST isteği gönderin.
  • Asenkron görev yanıtını ele alın ve dönüşüm tamamlanana veya başarısız olana kadar GET /api/v1/tasks/{task_id} uç noktasını sorgulayın.
  • Doğrulanmış XRechnung, ZUGFeRD veya UBL XML çıktısını alın.

Asenkron durum sorgulama

E-fatura uyumluluğunu ölçekli bir şekilde entegre etmek, gönderim ve sonuç alma işlemlerini API üzerinden otomatikleştirmek anlamına gelir. Her istek tam olarak bir faturayı dönüştürür ve dönüştürülen sonuçlar, uç durumlar ve düşük kaliteli kaynak belgeler için yine normal inceleme ve istisna sürecinizden geçmelidir.

API asenkron çalışır: bir PDF yüklediğinizde, anında benzersiz bir görev kimliğiyle birlikte 202 Accepted durumu döndürür.

Sisteminiz, görev tamamlandı veya başarısız olarak raporlanana kadar GET /api/v1/tasks/{task_id} adresindeki görev durumu uç noktasını her 10-15 saniyede bir sorgular. API webhook sağlamaz; sisteminiz bir dönüşümün hazır olduğunu sorgulama yoluyla öğrenir.

Ölçeklenebilirlik için en iyi uygulamalar

  • Otomatik algılama gecikmelerini atlamak için her zaman XRechnung veya ZUGFeRD gibi açık bir uyumluluk profili belirtin.
  • Gereksiz oran sınırlarından (rate limit) kaçınmak için görev durumu sorgulanırken üstel geri çekilme uygulayın.
  • Kolay izleme ve denetim günlüğü için döndürülen görev UUID'lerini yerel veritabanınızda saklayın.
  • Yeniden denemelerin yinelenen dönüşümler oluşturmaması için fatura başına sabit bir Idempotency-Key üstbilgisi gönderin.