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
Yüksek işlem hacimli PDF'ten e-faturaya dönüşümü otomatikleştirin, asenkron sorgulamayı yapılandırın, webhook olaylarını yönetin ve birden çok dosyayı 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/convertadresine birPOSTisteği gönderin. - Asenkron görev yanıtını ele alın ve durum için sorgulama yapın veya webhook'ları dinleyin.
- Doğrulanmış
XRechnung,ZUGFeRDveyaUBLXML çıktısını alın.
Asenkron sorgulama ve webhook'lar
E-fatura uyumluluğunu ölçekli bir şekilde entegre etmek, manuel dosya yüklemelerinden tam otomatik, asenkron API iş akışlarına geçişi gerektirir. Invoice Converter, yüksek hacimli toplu işlemler için optimize edilmiş yüksek performanslı bir arka uç sağlar.
Yüksek hacimli ortamlar için asenkron bir entegrasyon öneririz. Bir PDF yüklediğinizde, API anında benzersiz bir görev kimliği ile birlikte 202 Accepted durumu döndürür.
Sisteminiz, her birkaç saniyede bir GET /api/v1/tasks/{id} adresindeki görev durumu uç noktasını sorgulayabilir veya dönüşüm hazır olur olmaz otomatik bir POST bildirimi almak için bir webhook URL'si kaydedebilir.
Ö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.
- Gelen olayların Invoice Converter kaynaklı olduğundan emin olmak için webhook imza doğrulamasını etkinleştirin.