İzibiz Developer Portal
SOAP WS · E-Mutabakat (ReconciliationWS)

Mutabakat Gönderme (SendReconciliation)

SOAPSendReconciliationRequest
  • Özel entegratör sistemi üzerinden toplu BA/BS Mutabakat veya Cari Mutabakat gönderimini sağlayan servistir.
  • Toplu mutabakat göndermek için RECONCILIATION parametresi çoklanabilir.
  • RECONCILIATION_TYPE parametresinin aldığı değerlere göre Cari ve BA/BS Mutabakat arası ayrım yapılır.
  • BA/BS mutabakat için cariye düzenlenen belge tutarı 5000 TL ve üzeri olmalıdır.
  • BA/BS Mutabakatlar için BABS_ACCOUNTING_PERIOD, BA_DOCUMENT_AMOUNT, BA_DOCUMENT_COUNT, BS_DOCUMENT_AMOUNT ve BS_DOCUMENT_COUNT kullanılır. Cari Mutabakatlar için CM_AMOUNT, CM_AMOUNT_TYPE ve CM_DATE kullanılır. Kalan parametreler iki seçenek için ortaktır.
  • Cari Mutabakatlarda CM_AMOUNT_TYPE alani mutabakatin yonunu belirtir: A = alacak, B = borc.

Parametreler

AdTipZorunluAciklama
REQUEST_HEADER object Evet Request Header objesi içerisinde SESSION_ID ve APPLICATION_NAME, CHANNEL_NAME alanı zorunludur.
└ SESSION_ID text Evet Kimlik doğrulama servisi (AuthenticationWS) oturum açma metodundan (Login) alına oturum/token/session bilgisi.
└ CLIENT_TXN_ID text Hayir İstemci uygulama tarafından işlem için üretilen işlem bilgisi (transaction id) varsa istek esnasında gönderilip, sonuçta alabileceğiniz bir değerdir. request/response eşleşmesi yapmak için kullanılabilir.
└ APPLICATION_NAME text Evet Metodu çağıran uygulamanın adı. Örnek: AppName-v1.4.67
└ COMPRESSED text Hayir İçerikte taşınan bilginin ZIP formatında sıkıştırılmış mı gönderildiği/talep edildiği bilgisi. Belge gönderim ve belge okuma servislerinde gönderilen değere göre işlem yapılmaktadır.
RECONCILIATION object Evet En az bir mutabakat bulunmalıdır. Toplu gönderim için bu eleman çoklanır.
└ TYPE text Evet Gönderilmek istenilen mutabakat tipi için kullanılır: BA/BAS Mutabakat için EM,Cari Mutabakat için CM olabilir.
└ UUID text Hayir Evrensel Tekil Tanımlama Numarası (ETTN) ile her mutabakat için oluşturulması gerekir. Daha sonra getReconciliationStatus metodu ile mutabakat okumak için kullanılabilir. GUID formatındadır.
└ CUSTOMER_IDENTIFIER text Evet Mutabakat gönderilecek firmanın vergi kimlik numarası. VKN doğrulaması yapılmadığı için gönderilen verinin doğruluğu mükellefe aittir.
└ COMMERCIAL_NAME text Evet Mutabakat gönderilecek firmanın ünvanı. Alıcı firmaya gönderilen e-posta üzerinde görünecektir.
└ TAX_OFFICE text Hayir Mutabakat gönderilecek firmanın vergi dairesi.
└ CUSTOMER_ADDRESS text Evet Mutabakat gönderilecek firmanın adresi.
└ TELEPHONE_NO text Hayir Mutabakat gönderilecek firmanın telefon numarası. Format: 0 (212) 555 55 55
└ FAX_NO text Hayir Mutabakat gönderilecek firmanın faks numarası. Format: 0 (212) 555 55 55
└ EMAIL text Evet Mutabakat gönderilecek firmanın e-posta adresi. E-posta adresinin formatı kontrol edilir ancak doğruluğu ve geçerliliği mükellefin sorumluluğundadır. Format: muhasebe@firma.com.tr
└ CURRENCY_CODE text Evet Mutabakat içerisinde kullanılacak para birimidir. TRY, USD, EUR, GBP ve CAD değerleri gönderilebilir.
└ BABS_ACCOUNTING_PERIOD text Hayir BA-BS Mutabakatlar için kullanılan Mutabakat dönemi. Format: 201901
└ BA_DOCUMENT_COUNT text Hayir BA mutabakat belge adeti.
└ BA_DOCUMENT_AMOUNT text Hayir BA mutabakat belgelerinin toplam tutarı.
└ BS_DOCUMENT_COUNT text Hayir BS mutabakat belge adeti.
└ BS_DOCUMENT_AMOUNT text Hayir BS mutabakat belgelerinin toplam tutarı.
└ CM_DATE text Hayir Cari Mutabakatlar için kullanılan Mutabakat dönemi. Format: 2019-01-01
└ CM_AMOUNT_TYPE text Hayir Cari Mutabakatlar için mutabakatın yönünü belirtmek için kullanılır. A veya B değerlerini alabilir.
└ CM_AMOUNT text Hayir Cari Mutabakat tutarını belirtmek için kullanılır.
└ NOTE text Hayir Mutabakat gönderilecek firmaya iletilmek istenilen not metni. Maksimum 250 karakter gönderilebilir.

Ornek Yanit (XML)

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://schemas.izibiz.com/ei/wsdl/reconciliation">
  <soapenv:Body>
    <wsdl:SendReconciliationResponse>
      <REQUEST_RETURN>
        <INT_TXN_ID>884512</INT_TXN_ID>
        <RETURN_CODE>0</RETURN_CODE>
      </REQUEST_RETURN>
    </wsdl:SendReconciliationResponse>
  </soapenv:Body>
</soapenv:Envelope>

Hata Yaniti (Fault)

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <soapenv:Fault>
      <faultcode>soapenv:Server</faultcode>
      <faultstring>MUTABAKAT SISTEMDE MEVCUT ( VKN/TCKN:4840847211, DONEM:202401)</faultstring>
      <detail>
        <ERROR_TYPE>
          <INTL_TXN_ID>884513</INTL_TXN_ID>
          <ERROR_CODE>230</ERROR_CODE>
          <ERROR_SHORT_DESC>MUTABAKAT SISTEMDE MEVCUT</ERROR_SHORT_DESC>
        </ERROR_TYPE>
      </detail>
    </soapenv:Fault>
  </soapenv:Body>
</soapenv:Envelope>