Fatura dönüştürme API’si: basit entegrasyon rehberi
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.
Yaygın entegrasyon hata kodlarının teknik olmayan kullanıcılar için açıklaması.
DATEV, Lexware, SAP Business One, Odoo ve Microsoft Dynamics fatura dışa aktarımlarını doğrulamak için pratik rehberler.
Yaygın e-fatura kod listeleri: KDV kategori kodları, ödeme aracı kodları, birim kodları ve fatura türü kodları.
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 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çFaturalarınızı dönüştürmeye hazır mısınız?
PDF faturalarınızı bugün XRechnung, ZUGFeRD ve diğer formatlara dönüştürmeye başlayın. Kredi veya ücretli plan seçin.