invoiceInfo, view, invoiceapproval ve invoicecancel türlerini kabul eder.
1
Bağlantıyı ve belge seçeneklerini hazırlayın
Bağlantı durumunu, krediyi ve ayarları okuyun. Bağlı hesap bulunmuyorsa yetkili bilgilerle bağlantı kurun.Fatura işlem ucunda
type=invoiceInfo kullanarak mükellef/seri/şablon seçeneklerini alın. Bu varyant okuma izni ister. Gerçek alıcı posta kutusunu, seriyi ve şablonu bu seçeneklerden seçin.2
Belge verisini hazırlayın ve taslak oluşturun
Alıcı, satır, vergi ve toplamları veri kuralları ile doğrulayın. İş referansınız için kalıcı bir
Idempotency-Key saklayın; type=view ile taslak oluşturun.view yalnız önizleme değildir; sağlayıcıda gerçek taslak oluşturur. Dönen belge ve işlem kimliklerini kaydedin. Rastgele UUID üretip sağlayıcı kimliği kabul etmeyin.3
Mevcut taslağı gönderin
Aynı işlem ucunda
type=invoiceapproval, uygun moduleType=eInvoice|eArchive ve 1–100 benzersiz belge UUID’sini kullanın. Örnek gövdeler işlem sayfasında ayrı sekmelerdedir.Gönderim kabulü doğrulanmadan belgenin aktarılmış olduğunu varsaymayın. Kısmi veya belirsiz sonucu bütün hedefler için başarı saymayın; makbuzları ayrı izleyin.4
Muhasebe aktarımını doğrulayın
Belge aktarımı veya eşitleme ilgili mali kayıtları oluşturabilir. Eşitlemede
Idempotency-Key zorunludur; alt belge işlemlerini de takip edin.Aynı firmada devam eden başka bir mali işlemle çakışma varsa 409 alınabilir. Mevcut işlemin durumunu kontrol edin; yeni anahtarla tekrar başlatmayın.Silme, iptal ve bağlantıyı kaldırma
Banka hareketine bağlı veya birden çok faturaya mahsup edilmiş ödeme içeren iptal
409 INVOICE_COMPLEX_PAYMENT_CANCEL_UNSUPPORTED ile reddedilir. Desteklenmeyen kaynaktan oluşturulmuş faturada 409 INVOICE_EXCLUDED_SOURCE_CANCEL_UNSUPPORTED döner. Bu hatalarda belge iptali başlatılmaz.
Belirsiz cevapta
502, bağlantı kopması veya review_required sonucunda yeniden taslak/gönderim başlatmayın. İşlem durumunu okuyun ve sağlayıcıdaki belgeyle mutabakat yapın. Tamamlanmış tekrar cevabı ilk HTML/PDF veya mali gövdeyi birebir tekrarlamaz.