# Fatura dönüştürme API’si: basit entegrasyon rehberi

- Date: 2026-07-29
- Reading time: 4 dk. okuma

Fatura dönüşümünü API ile bağlayın: erişim alın, idempotency anahtarıyla yükleyin, görevi sorgulayın ve sonucu indirin.

## Makale özeti

        Bu makale Fatura dönüştürme API’si: basit entegrasyon rehberi konusunu Avrupa e-fatura süreçleri için pratik bir başvuru kaynağı olarak açıklar. Konuyu sade bir dille tanımlar, uyumluluk bağlamına yerleştirir ve açıklamayı XRechnung, ZUGFeRD/Factur-X, UBL ve CII gibi fatura formatlarıyla ilişkilendirir.

Fatura dönüştürme API’si ERP, muhasebe sistemi veya özel uygulamayı bağlar. Eşzamansız çalışır: sisteminiz görev oluşturur, durumu kontrol eder ve sonucu indirir.

        ## Bu rehberi nasıl kullanmalı

        Bir finans veya ERP iş akışını değiştirmeden önce bu makaleyi başlangıç noktası olarak kullanın: geçerli ülke kuralını veya standardı belirleyin, beklenen yapılandırılmış formata karar verin, üretilen XML’i doğrulayın ve manuel inceleme gerektiren faturalar için belgelenmiş bir istisna süreci tutun.

## Beş adımda API akışı

Beş adımda API akışı için pratik çalışma sırası şöyle olmalıdır.

- API erişimi isteyin ve onaylı faturalama ya da ön ödemeli krediyle anahtar oluşturun.
- Kaynağı hedef format ve idempotency anahtarıyla POST /api/v1/invoices:convert adresine gönderin.
- Dönen görev kimliğini saklayın.
- Son duruma kadar GET /api/v1/tasks/{task_id} adresini artan aralıklarla sorgulayın.
- Sonuç ve doğrulama raporunu indirin. Doğrulama hatalarını değişmeden yeniden denemek yerine düzeltmeye yönlendirin.
## Girdiler ve formatlar

Yükleme yolu PDF, DOCX ve TXT kabul eder. Yapılandırılmış girdi için ayrı yol vardır. Hedefler XRechnung, ZUGFeRD, EN 16931, UBL ve CII’yi içerir. ZUGFeRD için PDF kaynak gerekir.

## API ne zaman uygundur?

Görev kimliği, idempotency ve açık indirme gereken sistemler arası akışlar için API’yi kullanın. Kontrollü ve düşük hacimli posta kutusu işleri için [e-posta yolunu](/tr/blog/invoice-conversion-by-email) kullanın.

## Geliştirici API’sini inceleyin

Kimlik doğrulama, uç noktalar, örnekler, hatalar ve güncel sözleşmeyi görün.

[API belgelerini aç](/tr/developer-api)

## FAQ

### API faturayı hemen döndürür mü?

Hayır. Bir görev kimliği döndürür. Entegrasyon görevi sorgular ve hazır sonucu indirir.

### API webhook sunuyor mu?

Mevcut ortak akışı webhook yerine artan aralıklı sorgulama kullanır.

## Resmî kaynaklar

- [Invoice Converter geliştirici API’si](https://www.invoice-converter.com/en/developer-api)
- [OASIS UBL 2.1 şartnamesi](https://docs.oasis-open.org/ubl/os-UBL-2.1/UBL-2.1.html)