Kapsam ve sınırlamalar

Muhasip API; fatura, banka, POS ve tahsilat, GİB e-Arşiv, Trendyol pazaryeri, online işlemler, görevler, ajanda ve takvim kaynaklarını sunar. Kullanılabilir istekleri API referansından seçin.

​

Entegrasyona başlamadan önce

• Geçerli API kimlik bilgilerini, ilgili modül izinlerini ve varsa IP kısıtını hazırlayın. Kimlik ve izinler
• Banka, POS ve e-belge işlemleri için ilgili hizmet bağlantısı etkin olmalıdır.
• Her işlemin alanlarını ve cevap biçimini kendi referansına göre kullanın. Firma uygulamalarının listelenmesi, ilgili bağlantının veya iznin hazır olduğunu göstermez.
• Google takvim bağlantısının kayıt durumu okunabilir; API üzerinden bağlantı oluşturma desteklenmez.

​

Mali işlem koşulları

​

Sonuçları takip edin

Gereken işlemlerde Idempotency-Key kullanın. Dönen operationId ve kayıt kimliklerini saklayın. Tamamlanmış tekrar cevabında replayed:true ve sonuç kimlikleri bulunabilir; ilk cevabın bütün belge içeriği yeniden verilmez. reviewRequired:true veya retryable:false durumunda otomatik tekrar yapmayın. İşlem takibi ve hata yönetimi rehberlerini izleyin.

​

Cevap ve veri kuralları

• POS listesinde isDefault=true varsayılan hesabı, false ek hesapları getirir. Parametre gönderilmezse varsayılan hesap listelenir.
• Online işlem ayarlarında status boolean olarak zorunludur. Güncellemede domain gönderilmezse mevcut adres korunur.
• Bağlantı anahtarları ve parolaları cevaplardan geri okunmaz; erişim bilgilerinizi uygulamanızda güvenli saklayın.
• Proje, görev, ajanda ve takvimde yalnız izinli alanları gönderin. Geçersiz kimlik, tarih veya boş güncelleme reddedilebilir.
• Belge HTML/PDF çıktıları ve SMS imzası ilgili fatura veya e-Arşiv işlemleriyle yürütülür.

İstek sınırı istemci IP’si başına 6 saniyede 100 istektir. Ayrıntılar hız ve gövde sınırları rehberindedir.