Ana içeriğe atla
Fatura dönüştürme API’si: basit entegrasyon rehberi
Blog

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

1 dk okumaDenetlendi: 29 Ağustos 2026
Markdown dışa aktar

Resmî kaynaklar

Tarihleri, formatları ve resmî kural değişikliklerini doğrulamak için bu kaynakları kullanın.

İlgili teknik wiki

Bu makaleyle eşleşen ayrıntılı geliştirici belgelerini ve mevzuat kılavuzlarını keşfedin.

API ve otomasyon hata mesajları

Yaygın entegrasyon hata kodlarının teknik olmayan kullanıcılar için açıklaması.

ERP dışa aktarım doğrulama rehberleri

DATEV, Lexware, SAP Business One, Odoo ve Microsoft Dynamics fatura dışa aktarımlarını doğrulamak için pratik rehberler.

E-Fatura Kod Listeleri

Yaygın e-fatura kod listeleri: KDV kategori kodları, ödeme aracı kodları, birim kodları ve fatura türü kodları.

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ışı

Etkileşimli akış

Bir faturayı bu kanalda takip etmek için oynat düğmesine basın veya bir adıma tıklayın.

Çıktı:XRechnungZUGFeRDEN 16931UBLCII

İşleme aşaması

Adım 1 / 6SizTek seferlik kurulum

API anahtarı oluşturun

Etkin bir Enterprise aboneliğiyle profilinizde anahtar oluşturun. Anahtarı sunucunuzda tutun.

External API eşzamansızdır: sisteminiz bir görev oluşturur, durumunu sorgular ve doğrulanmış sonucu indirir. 1. API anahtarı oluşturun: Etkin bir Enterprise aboneliğiyle profilinizde anahtar oluşturun. Anahtarı sunucunuzda tutun. 2. Kaynağı gönderin: PDF, DOCX veya TXT dosyasını hedef format ve idempotency anahtarıyla yükleyin. Yapılandırılmış girdi için ayrı bir yol da vardır. 3. Görev kimliğini saklayın: API hemen bir görev kimliğiyle yanıt verir. Fatura arka planda dönüştürülür. 4. Artan aralıklarla sorgulayın: Durum tamamlandı veya başarısız olana kadar artan aralıklarla sorgulayın. Görev ancak dosya istenen profil için doğrulamayı geçtiğinde tamamlanır. 5. Dosyayı ve raporu indirin: Sonucu ve doğrulama raporunu alın. 6. Hataları bir kişiye yönlendirin: Doğrulama hatalarını değiştirmeden yeniden denemek yerine düzeltmeye yönlendirin. Çıktı: XRechnung, ZUGFeRD, EN 16931, UBL, CII. Adımlar bu rehberde ve External API V1 belirtiminde anlatıldığı gibidir. Durum: Ekim 2026.
  1. Etkin bir Enterprise aboneliğiyle profilinizde API anahtarı oluşturun.
  2. Kaynağı hedef format ve idempotency anahtarıyla POST /api/v1/invoices:convert adresine gönderin.
  3. Dönen görev kimliğini saklayın.
  4. Son duruma kadar GET /api/v1/tasks/{task_id} adresini artan aralıklarla sorgulayın.
  5. 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 kullanın.

Sık sorulan sorular

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.

Geliştirici API’sini inceleyin

Kimlik doğrulama, uç noktalar, örnekler, sınırlar ve hataları görün.

E-fatura API’si

İlgili Makaleler