Ana içeriğe geç

Webticari SOAP Docs

importCreditTransactionXML

importCreditTransactionXML

Genel Bilgi

Özellik	Değer
Endpoint Adı	`importCreditTransactionXML`
SOAPAction	`urn:WebticariService#importCreditTransactionXML`
Açıklama	Kredi kartı işlemlerini XML formatında sisteme içe aktarır. Sanal POS ve fiziksel POS işlemleri için kullanılır.
Kimlik Doğrulama Gerektirir	Evet (token)

`kredi` XML Alanları (Kredi Kartı Ödeme/Tahsilat)

Alan	Tip	Zorunlu	Açıklama
`kk_musno`	`integer`	Evet	Müşteri numarası
`cr_kod`	`string`	Hayır	Cari hesap kodu (musno yerine kullanılabilir)
`kk_odemetarih`	`date`	Evet	Ödeme tarihi
`kk_tutarson`	`decimal`	Evet	İşlem tutarı
`kk_kartsahibi`	`string`	Hayır	Kart sahibi adı
`kk_aciklama`	`string`	Hayır	Açıklama
`kk_posid`	`integer`	Hayır	POS ID numarası
`kk_planid`	`integer`	Hayır	Plan ID numarası
`kk_taksitsay`	`integer`	Hayır	Taksit sayısı
`kk_var1`	`string`	Hayır	Ek alan 1
`kk_var2`	`string`	Hayır	Ek alan 2
`kk_var3`	`string`	Hayır	Ek alan 3
`kk_satisno`	`integer`	Hayır	İlgili satış numarası
`kk_bankano`	`integer`	Hayır	Banka ID (kk_posid bulunamazsa kullanılır)
`bn_firmakodu`	`string`	Hayır	Banka firma kodu (banka araması için)
`kk_poskod`	`string`	Hayır	POS kodu (kk_posid yerine kullanılabilir)
`kk_belgeno`	`string`	Hayır	Belge numarası
`kk_mussube`	`integer`	Hayır	Müşteri cari şube ID
`kk_tutarsonbirim`	`string`	Hayır	Para birimi (varsayılan: POS para birimi)
`kk_tutarsonkur`	`decimal`	Hayır	Kur
`kk_tutarbirim`	`string`	Hayır	Cari para birimi
`kk_tutarkur`	`decimal`	Hayır	Cari para birimi kuru
`kk_izahat`	`string`	Hayır	İzahat (varsayılan: "Kredi Kartı Tahsilat"/"Kredi Kartı Ödeme")
`kk_personel`	`integer`	Hayır	Personel numarası (varsayılan: oturum personeli)
`kk_sube`	`integer`	Hayır	Şube numarası (varsayılan: oturum şubesi)
`kk_muhonay`	`string`	Hayır	Muhasebe onay (E/H)
`kk_iptal`	`string`	Hayır	İptal durumu (E/H, varsayılan: H)
`kk_belgeturu`	`string`	Hayır	Belge türü
`kasa`	`integer`	Hayır	Kasa numarası (varsayılan: oturum kasası)
`kai_kod`	`string`	Hayır	Kasa kodu (`kasa` yerine kullanılabilir)

Kontrol Alanları

Alan Adı	Tip	Açıklama
`kk_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 (tahsilat / ödeme)
`kredi`	`xsd:string`	Evet	Kredi kartı işlem verilerini içeren XML
`sanalPazar`	`xsd:string`	Hayır	Sanal pazar yeri bilgisi (e-ticaret entegrasyonları için)

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_KREDIKARTI_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: - kk_tutarson (net tutar) - kk_odemetarih (ödeme tarihi) - cr_kod (cari kodu) - kk_var1, kk_var2, kk_var3

Sanal Pazar Modu (`sanalPazar`)

sanalPazar parametresi true gönderildiğinde sistem: - İşlemi sanal pazar POS logüna (tbsanalposlog) ayrıca kaydeder. - E-ticaret platformlarından (pazar yerleri, online mağaza) gelen kredi kartı ödemelerini izlemek için kullanılır.

XML Yapısı

<kredikarti>
  <islem>
    <kk_odemetarih>2024-06-01</kk_odemetarih>
    <kk_musno>42</kk_musno>              <!-- Cari ID -->
    <kk_tutarson>1200.00</kk_tutarson>     <!-- Net tutar -->
    <kk_tutarsonbirim>TL</kk_tutarsonbirim>
    <kk_tutarsonkur>1.00</kk_tutarsonkur>
    <kk_aciklama>Online mağaza ödemesi</kk_aciklama>
    <kk_var1>PAZAR_SIPARIS_ID</kk_var1>
    <kk_taksitsay>1</kk_taksitsay>        <!-- Taksit sayısı -->
  </islem>
</kredikarti>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importCreditTransactionXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <islemtipi>tahsilat</islemtipi>
      <kredi><![CDATA[
        <kredikarti>
          <islem>
            <kk_odemetarih>2024-06-01</kk_odemetarih>
            <kk_musno>42</kk_musno>
            <kk_tutarson>1200.00</kk_tutarson>
            <kk_tutarsonbirim>TL</kk_tutarsonbirim>
            <kk_var1>TRENDYOL_ORDER_12345</kk_var1>
          </islem>
        </kredikarti>
      ]]></kredi>
      <sanalPazar>true</sanalPazar>
    </tns:importCreditTransactionXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

islemtipi parametresi işlemin yönünü belirtir (tahsilat = müşteriden alınan, odeme = müşteriye verilen).
Sanal pazar entegrasyonlarında sanalPazar=true ile POS logü tutulur.
Dış sistem ödeme referansını kk_var1–kk_var3 alanlarında saklamak mükerrer tespiti için kullanışlıdır.
Token geçersizse yanıt Invalid Token string'i döner.