# API 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ı

- 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/convert` adresine bir `POST` isteğ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`, `ZUGFeRD` veya `UBL` XML çı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

- 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.
- Gelen olayların Invoice Converter kaynaklı olduğundan emin olmak için webhook imza doğrulamasını etkinleştirin.