Ana içeriğe geç

importBondTransactionXML

Genel Bilgi

Özellik Değer
Endpoint Adı importBondTransactionXML
SOAPAction urn:WebticariService#importBondTransactionXML
Açıklama Senet işlemlerini XML formatında sisteme içe aktarır. Müşteriden alınan veya tedarikçiye verilen senetleri kaydeder.
Kimlik Doğrulama Gerektirir Evet (token)

senet XML Alanları (Senet İşlemi)

Alan Tip Zorunlu Açıklama
sh_carino integer Evet Cari hesap numarası
cr_kod string Hayır Cari hesap kodu (carino yerine kullanılabilir)
sh_islemtarihi date Evet İşlem tarihi
sn_tutarson decimal Evet Senet tutarı
sn_var1 string Hayır Ek alan 1
sn_var2 string Hayır Ek alan 2
sn_var3 string Hayır Ek alan 3
sn_ozelkod string Hayır Özel kod
sn_takipno string Hayır Takip numarası
sn_snno string Hayır Senet numarası
sn_tutarsonbirim string Hayır Para birimi (varsayılan: sistem para birimi)
sn_tutarsonkur decimal Hayır Kur (varsayılan: 1)
sh_tutarkur decimal Hayır Cari para birimi kuru
sn_vadetarih date Hayır Vade tarihi (varsayılan: şu an)
sn_sahibi string Hayır Senet sahibi adı
sn_cirosahibi string Hayır Ciro sahibi adı
sn_sonkisi string Hayır Son kişi adı
sn_kasideyeri string Hayır Kasideyeri
sn_aciklama string Hayır Açıklama
sn_durum string Hayır Durum (varsayılan: "Senet Tahsilat"/"Senet Ödeme")
sh_carisube integer Hayır Cari şube ID
sn_sube integer Hayır Şube numarası (varsayılan: oturum şubesi)
sn_muhonay string Hayır Muhasebe onay (E/H)
sn_iptal string Hayır İptal durumu (E/H, varsayılan: H)
sn_proje string Hayır Proje kodu
sn_temsilci integer Hayır Temsilci numarası
sn_tipi string Hayır Senet tipi
sh_personel integer Hayır Personel numarası (varsayılan: oturum personeli)
kasa integer Hayır Kasa numarası (varsayılan: oturum kasası)

Kontrol Alanları

Alan Adı Tip Açıklama
sn_iptal string H=aktif işlem, E=iptal (kasa ve cari hareketleri oluşturulmaz)

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
token xsd:string Evet login endpoint'inden alınan oturum token'ı
islemtipi xsd:string Evet İşlem tipi (örn. alacak_senedi, borc_senedi)
senet xsd:string Evet Senet işlem verilerini içeren XML

Yanıt Parametreleri

Parametre Tip Açıklama
return xsd:string İşlem sonucu

Yanıt Yapısı

Standart import yanıt formatı:

<transactions>
  <transferreds>
    <transaction>
      <server_id>SUNUCU_SENET_NO</server_id>
    </transaction>
  </transferreds>
  <transposeds>...</transposeds>
  <duplicates>
    <transaction>
    </transaction>
  </duplicates>
</transactions>

Mükerrer Kayıt Tespiti

Aşağıdaki alanların kombinasyonuna göre mükerrer kontrolü yapılır: - sn_tutarson (net tutar) - sh_islemtarihi (işlem tarihi) - cr_kod (cari kodu) - sn_var1, sn_var2, sn_var3

XML Yapısı

<senetler>
  <senet>
    <sh_islemtarihi>2024-06-01</sh_islemtarihi>
    <sh_carino>42</sh_carino>               <!-- Cari ID -->
    <sn_tutarson>5000.00</sn_tutarson>      <!-- Senet tutarı -->
    <sn_vadetarih>2024-09-01</sn_vadetarih> <!-- Vade tarihi -->
    <sn_snno>SN-2024-001</sn_snno>         <!-- Senet numarası -->
    <sn_tutarsonbirim>TL</sn_tutarsonbirim>
    <sn_var1>DIS_SENET_ID</sn_var1>
  </senet>
</senetler>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importBondTransactionXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <islemtipi>alacak_senedi</islemtipi>
      <senet><![CDATA[
        <senetler>
          <senet>
            <sh_islemtarihi>2024-06-01</sh_islemtarihi>
            <sh_carino>42</sh_carino>
            <sn_tutarson>5000.00</sn_tutarson>
            <sn_vadetarih>2024-09-01</sn_vadetarih>
            <sn_snno>SN-2024-001</sn_snno>
            <sn_var1>ERP_SENET_13001</sn_var1>
          </senet>
        </senetler>
      ]]></senet>
    </tns:importBondTransactionXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • islemtipi parametresi senedin tipini belirtir (orn. alacak_senedi, borclanma_senedi).
  • Dış sistem referansını sn_var1–sn_var3 alanlarında saklamak mükerrer tespiti için kullanışlıdır.
  • Token geçersizse yanıt Invalid Token string'i döner.