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

- Mayıs 2026’da güncellendi

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.