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

- Date: 2026-07-29
- Modified: 2026-08-29
- Denetlendi: 29 Ağustos 2026
- Reading time: 1 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.

> Şu resmî kaynaklara göre denetlendi: Invoice Converter geliştirici API’si, OASIS UBL 2.1 şartnamesi.

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.

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

- Etkin bir Enterprise aboneliğiyle profilinizde API 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.

## 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)