Rehber · Mayıs 2026’da güncellendi
Markdown dışa aktarAPI 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ı
Bu noktaları bu bölüm için pratik kontrol adımları olarak kullanın.
- Geliştirici panelinden bir üretim API anahtarı alın.
- Tüm istekleri bir
Bearerbelirteci içerenAuthorizationüstbilgisiyle yetkilendirin. - PDF dosyası ve uyumluluk profili parametreleriyle
/api/v1/invoices:convertadresine birPOSTisteğ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,ZUGFeRDveyaUBLXML çı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
Bu noktaları bu bölüm için pratik kontrol adımları olarak kullanın.
- Otomatik algılama gecikmelerini atlamak için her zaman
XRechnungveyaZUGFeRDgibi 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.