Fatura aktarımını eşitle
Firma faturalarını Muhasip muhasebe kayıtlarıyla eşitler.
GET
Mali işlem sonucunu ve varsa
operationId değerini saklayın. Zaman aşımında veya review_required durumunda otomatik
tekrar yapmayın. Tamamlanmış tekrar cevabı ilk cevabın bütün gövdesini yeniden sunmaz. İşlem
takibiNe yapar?
Firma faturalarını Muhasip muhasebe kayıtlarıyla eşitler. GET isteği veri değiştirir; write izni ve Idempotency-Key zorunludur. type; eInvoice/Purchase, eInvoice/Sale veya eArchive/Invoices olmalıdır. Tarihler ISO biçiminde ve sıralı gönderilir; tarih verilmezse son 14 gün kullanılır. Bütün sayfalardaki belgeler değerlendirilir. Daha önce aktarılmış UUID için ikinci kayıt oluşturulmaz. Cevap TotalCount ve alt belge işlemlerinin operationIds değerlerini içerir. Bir aktarımın sonucu belirsizse eşitleme inceleme gerektirir ve başka mali yazmalar 409 döndürebilir. İşlem kimliklerini saklayın; replayed=true ilk cevabın bütün içeriğini tekrarlamaz.Ön koşullar ve izin
Etkin API anahtarı vemuhasip:invoice:write izni gerekir.
İlişkili kayıtlar aynı firmaya ait olmalıdır. Erişim ayarları için kimlik ve izinler rehberini inceleyin.
İşlem anahtarı: Idempotency-Key zorunludur. Aynı işlem için aynı anahtarı kullanın; örnekler MUHASIP_IDEMPOTENCY_KEY ortam değişkenini kullanır.
İstek ve cevap şemalarını indirin.
İstek örnekleri
Örnekler temsilîdir. Kimlikleri, belge tarihlerini ve iş verisini kendi yetkili kayıtlarınızla değiştirin. Node.js örnekleri Node.js 20 veya üzeri içindir; PHP örnekleri cURL uzantısını kullanır. Hiçbiri otomatik tekrar yapmaz.Cevabı değerlendirin
Önce HTTP durumunu, ardından bu kaynağınstatus ve sonuç alanlarını değerlendirin. Bütün uçlar aynı sonuç zarfını veya oluşturma için 201 kodunu kullanmaz.
Temsilî başarılı cevap; gerçek hizmet çağrısından alınmamıştır:
replayed:true varsa cevap güvenli makbuz ve sonuç kimlikleriyle sınırlı olabilir. İlk HTML/PDF veya mali gövdeyi tekrar beklemeyin. reviewRequired:true veya retryable:false yeni bir mali çağrı izni değildir.
Hata durumunda
Ağ kesintisi, zaman aşımı veya JSON olmayan cevap mali etkinin oluşmadığını kanıtlamaz. Ham istek/cevapları genel loglara yazmayın. Hata yönetimi
Sonraki adım
İşlem makbuzunu saklayın; durum adresinden kontrol edin ve sonuç kimliklerini ilgili belge/tahsilat/siparişle eşleştirin. reviewRequired=true ise yeniden göndermeden manuel inceleyin. Kaynak akışı · İşlem takibi · Kapsam ve sınırlamalarYetkilendirmeler
Kullanıcı adı apiUserId, parola secretKey. Aktif ve süresi geçmemiş API kullanıcısı ve uygun firma gerekir.
Başlıklar
Bu yeni mali işlem için zorunludur.
Required string length:
1 - 128Pattern:
^[!-~]+$Sorgu Parametreleri
Fatura kaynak kanalı. Belgenin kaynak kanalı. Kullanılabilir fatura kanalları eInvoice/Purchase, eInvoice/Sale ve eArchive/Invoices biçimindedir.
Mevcut seçenekler:
eInvoice/Purchase, eInvoice/Sale, eArchive/Invoices Başlangıç tarihi; varsayılan son 14 günlük dönemin başlangıcı. Belge tarihi; tarih-saat sunucu tarafından düzenlenir.
Bitiş tarihi; varsayılan dönemin sonu. Belge tarihi; tarih-saat sunucu tarafından düzenlenir.
Yanıt
İşlem tamamlandı. Örnek değerler temsilîdir.