Ana içeriğe geç

importChequeTransactionXML

Genel Bilgi

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

cek XML Alanları (Çek İşlemi)

Alan Tip Zorunlu Açıklama
ck_carino integer Evet Cari hesap numarası
cr_kod string Hayır Cari hesap kodu (carino yerine kullanılabilir)
ck_tarih date Evet Çek tarihi
ch_islemtarihi date Hayır Mükerrer tespitinde kullanılan işlem tarihi
ck_tutarson decimal Evet Çek tutarı
ck_var1 string Hayır Ek alan 1
ck_var2 string Hayır Ek alan 2
ck_var3 string Hayır Ek alan 3
ck_bankaid integer Hayır Banka ID (tahsilat: bnisim_id, ödeme: bn_bankano)
bnisim_kod string Hayır Banka isim kodu (tahsilatta ck_bankaid yerine)
bnisim_ad string Hayır Banka isim adı (tahsilatta ck_bankaid yerine)
bn_hesapkodu string Hayır Banka hesap kodu (ödemede ck_bankaid yerine)
bn_hesapadi string Hayır Banka hesap adı (ödemede ck_bankaid yerine)
ck_hesapid integer Hayır Banka hesap ID
ck_tutarsonbirim string Hayır Para birimi (varsayılan: sistem para birimi)
ck_tutarsonkur decimal Hayır Kur (varsayılan: 1)
ck_tutarkur decimal Hayır Cari para birimi kuru
ck_vadetarih date Hayır Vade tarihi (varsayılan: şu an)
ck_ozelkod string Hayır Özel kod
ck_takipno string Hayır Takip numarası
ck_bankasube string Hayır Banka şubesi
ck_kasideyeri string Hayır Kasideyeri
ck_cekno string Hayır Çek numarası
ck_hesapno string Hayır Hesap numarası
ck_sahibi string Hayır Çek sahibi adı
ck_cirosahibi string Hayır Ciro sahibi adı
ck_aciklama string Hayır Açıklama
ck_durum string Hayır Durum (varsayılan: "Çek Tahsilat"/"Çek Ödeme")
ck_carisube integer Hayır Cari şube ID
ck_sube integer Hayır Şube numarası (varsayılan: oturum şubesi)
ck_muhonay string Hayır Muhasebe onay (E/H)
ck_iptal string Hayır İptal durumu (E/H, varsayılan: H)
ck_proje string Hayır Proje kodu
ck_temsilci integer Hayır Temsilci numarası
ck_tipi string Hayır Çek tipi
ck_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
ck_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. musteri_ceki, odeme_ceki)
cek xsd:string Evet Çek 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_CEK_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: - ck_tutarson (net tutar) - ch_islemtarihi (işlem tarihi) - cr_kod (cari kodu) - ck_var1, ck_var2, ck_var3

XML Yapısı

<cekler>
  <cek>
    <ch_islemtarihi>2024-06-01</ch_islemtarihi>
    <ck_carino>42</ck_carino>              <!-- Cari ID -->
    <ck_tutarson>3000.00</ck_tutarson>     <!-- Çek tutarı -->
    <ck_vadetarih>2024-08-01</ck_vadetarih> <!-- Vade tarihi -->
    <bnisim_ad>Ziraat Bankası</bnisim_ad>   <!-- Tahsilat: banka isim adı -->
    <ck_bankasube>Kadıköy</ck_bankasube>
    <ck_cekno>TRX-123456</ck_cekno>        <!-- Çek numarası -->
    <ck_tutarsonbirim>TL</ck_tutarsonbirim>
    <ck_var1>DIS_CEK_ID</ck_var1>
  </cek>
</cekler>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importChequeTransactionXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <islemtipi>musteri_ceki</islemtipi>
      <cek><![CDATA[
        <cekler>
          <cek>
            <ch_islemtarihi>2024-06-01</ch_islemtarihi>
            <ck_carino>42</ck_carino>
            <ck_tutarson>3000.00</ck_tutarson>
            <ck_vadetarih>2024-08-01</ck_vadetarih>
            <bnisim_ad>Ziraat Bankası</bnisim_ad>
            <ck_bankasube>Kadıköy</ck_bankasube>
            <ck_cekno>TRX-123456</ck_cekno>
            <ck_var1>ERP_CEK_12001</ck_var1>
          </cek>
        </cekler>
      ]]></cek>
    </tns:importChequeTransactionXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • islemtipi parametresi çekin tipini belirtir (orn. musteri_ceki, firma_ceki).
  • Vade tarihi çek takibi için kritiktir; eksik gönderilirse problem oluşabilir.
  • Dış sistem referansını ck_var1–ck_var3 alanlarında saklamak mükerrer tespiti için kullanışlıdır.
  • Token geçersizse yanıt Invalid Token string'i döner.