Ana içeriğe atla
POST
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 takibi

Ne yapar?

Verilen filtreyi firma kapsamındaki aktarım akışına kaydeder. Başarı yanıtı belge gönderiminin veya aktarımın tamamlandığını ifade etmez. Yan etkiler: Yeni aktarım filtresi kaydı oluşturur; tekrarlanan POST için idempotency güvencesi yoktur. Sonraki adım: Dönen id bilgisini saklayın ve aktarımın iş sonucu için ilgili belge/muhasebe kayıtlarını izleyin.

Ön koşullar ve izin

Etkin API anahtarı ve muhasip:invoice:write izni gerekir. İlişkili kayıtlar aynı firmaya ait olmalıdır. Erişim ayarları için kimlik ve izinler rehberini inceleyin. İ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ğın status 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

İlgili liste veya detay çağrısıyla kaydı ve bağlı iş sonucunu doğrulayın. Fiziksel silme, arşiv ve mali iptali ayrı değerlendirin. Kaynak akışı · İşlem takibi · Kapsam ve sınırlamalar

Yetkilendirmeler

Authorization
string
header
gerekli

Kullanıcı adı apiUserId, parola secretKey. Aktif ve süresi geçmemiş API kullanıcısı ve uygun firma gerekir.

Gövde

application/json
type
string
gerekli

Belgenin kaynak kanalı. Kullanılabilir fatura kanalları eInvoice/Purchase, eInvoice/Sale ve eArchive/Invoices biçimindedir.

StartDate
string<date>

Belge tarihi; tarih-saat sunucu tarafından düzenlenir.

EndDate
string<date>

Belge tarihi; tarih-saat sunucu tarafından düzenlenir.

Yanıt

İşlem tamamlandı. Örnek değerler temsilîdir.

status
boolean
gerekli
result
object
gerekli