Ana içeriğe geç

Webticari SOAP Docs

importCashTransactionXML

importCashTransactionXML

Genel Bilgi

Özellik	Değer
Endpoint Adı	`importCashTransactionXML`
SOAPAction	`urn:WebticariService#importCashTransactionXML`
Açıklama	Nakit tahsilat ve ödeme işlemlerini XML formatında sisteme içe aktarır.
Kimlik Doğrulama Gerektirir	Evet (token)

`nakit` XML Alanları (Nakit Ödeme/Tahsilat)

Alan	Tip	Zorunlu	Açıklama
`nk_carino`	`integer`	Evet	Cari hesap numarası
`cr_kod`	`string`	Hayır	Cari hesap kodu (carino yerine kullanılabilir)
`nk_islemtarih`	`date`	Evet	İşlem tarihi
`nk_tutarson`	`decimal`	Evet	İşlem tutarı
`nk_var1`	`string`	Hayır	Ek alan 1
`nk_var2`	`string`	Hayır	Ek alan 2
`nk_var3`	`string`	Hayır	Ek alan 3
`kasa`	`integer`	Hayır	Kasa numarası (varsayılan: oturum kasası)
`kai_kod`	`string`	Hayır	Kasa kodu (`kasa` yerine kullanılabilir)
`nk_satisno`	`integer`	Hayır	İlgili satış numarası
`nk_belgeno`	`string`	Hayır	Belge numarası
`nk_belgeturu`	`string`	Hayır	Belge türü
`nk_tutarsonbirim`	`string`	Hayır	Para birimi (varsayılan: sistem para birimi)
`nk_tutarsonkur`	`decimal`	Hayır	Kur (varsayılan: 1)
`nk_tutarkur`	`decimal`	Hayır	Cari para birimi kuru
`nk_vadetarih`	`date`	Hayır	Her zaman `nk_islemtarih` ile aynı değere atanır; XML'de gönderilen değer göz ardı edilir
`nk_odeyen`	`string`	Hayır	Ödeyen kişi adı
`nk_izahat`	`string`	Hayır	İzahat (varsayılan: "Nakit Tahsilat"/"Nakit Ödeme")
`nk_aciklama`	`string`	Hayır	Açıklama
`nk_personel`	`integer`	Hayır	Personel numarası (varsayılan: oturum personeli)
`nk_sube`	`integer`	Hayır	Şube numarası (varsayılan: oturum şubesi)
`nk_carisube`	`integer`	Hayır	Cari şube ID
`nk_muhonay`	`string`	Hayır	Muhasebe onay (E/H)
`nk_iptal`	`string`	Hayır	İptal durumu (E/H, varsayılan: H)
`nk_proje`	`string`	Hayır	Proje kodu
`nk_temsilci`	`integer`	Hayır	Temsilci numarası

Kontrol Alanları

Alan Adı	Tip	Açıklama
`nk_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. `tahsilat`, `odeme`)
`nakit`	`xsd:string`	Evet	Nakit 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ı ile <duplicates> dahil:

<transactions>
  <transferreds>
    <transaction>
      <server_id>SUNUCU_NAKIT_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: - nk_tutarson (net tutar) - nk_islemtarih (işlem tarihi) - cr_kod (cari kodu) - nk_var1, nk_var2, nk_var3

XML Yapısı

<nakitler>
  <nakit>
    <nk_islemtarih>2024-06-01</nk_islemtarih>
    <nk_carino>42</nk_carino>              <!-- Cari ID -->
    <nk_tutarson>500.00</nk_tutarson>      <!-- Net tutar -->
    <nk_tutarsonbirim>TL</nk_tutarsonbirim>
    <nk_tutarsonkur>1.00</nk_tutarsonkur>
    <kasa>1</kasa>                        <!-- Kasa no -->
    <nk_aciklama>Tahsilat açıklaması</nk_aciklama>
    <nk_var1>DIS_ODEME_ID</nk_var1>
  </nakit>
</nakitler>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importCashTransactionXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <islemtipi>tahsilat</islemtipi>
      <nakit><![CDATA[
        <nakitler>
          <nakit>
            <nk_islemtarih>2024-06-01</nk_islemtarih>
            <nk_carino>42</nk_carino>
            <nk_tutarson>500.00</nk_tutarson>
            <nk_tutarsonbirim>TL</nk_tutarsonbirim>
            <kasa>1</kasa>
            <nk_var1>WEBSHOP_PAYMENT_001</nk_var1>
          </nakit>
        </nakitler>
      ]]></nakit>
    </tns:importCashTransactionXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

islemtipi parametresi nakit işlemin yönünü belirtir (tahsilat = müşteriden alınan, odeme = müşteriye ödenen).
Dış sistem ödeme referansını nk_var1–nk_var3 alanlarında saklamak mükerrer tespiti için kullanışlıdır.
İlgili cari hesap hareketleri otomatik oluşturulur.
Token geçersizse yanıt Invalid Token string'i döner.