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ı.
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 kullanın.
Faturalarınızı dönüştürmeye hazır mısınız?
PDF faturalarınızı XRechnung, ZUGFeRD ve diğer formatlara dönüştürün. Abonelikler yıllık faturalandırmada aylık 10 €'dan başlar (vergiler hariç); ilk abonelikte 3 günlük deneme vardır. Ya da abonelik olmadan dönüşüm başına 5 € ödeyin (vergiler hariç).