Ana içeriğe geç

onlinePurchase

Genel Bilgi

Özellik Değer
Endpoint Adı onlinePurchase
SOAPAction urn:WebticariService#onlinePurchase
Açıklama Webticari üzerinden çevrimiçi modül veya ek hizmet satın alma işlemini gerçekleştirir. Ek kullanıcı lisansı, modül aktivasyonu gibi online alımlar bu endpoint üzerinden yapılır.
Kimlik Doğrulama Gerektirir Evet (token)

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
token xsd:string Evet login endpoint'inden alınan oturum token'ı
crno xsd:string Evet Cari no; bayi kendi müşterisi için ödeme yapıyorsa @@{mno/vkn/tckn} formatında
urkodu xsd:string Evet Satın alınacak ürün kodu
vkn xsd:string Evet Vergi kimlik numarası (VKN) veya T.C. Kimlik numarası (TCKN)
salt xsd:string Evet Güvenlik doğrulama parametresi

Yanıt Parametreleri

Parametre Tip Açıklama
return xsd:string İşlem sonucu ve ödeme/aktivasyon bilgisi

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:onlinePurchase>
      <token>abc123tokendeğeri</token>
      <crno>1042</crno>
      <urkodu>MODUL_EFATURA</urkodu>
      <vkn>1234567890</vkn>
      <salt>güvenlik_değeri</salt>
    </tns:onlinePurchase>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Token gereklidir.
  • crno @@ ön ekiyle gönderilirse bayi modu aktif olur: @@ kaldırılır; değer 10-11 haneli sayıysa VKN/TCKN olarak, aksi hâlde tbsirket.si_vdno/si_tckimlik sorgusu yapılır.
  • Salt doğrulaması şu an devredışı bırakılmıştır; geçersiz salt değerleri hata üretmez.
  • teslim->teslimEt() dönüş değerleri: başarı → 'Başarılı'; kontör değil → 'Satis kontör değil'; VKN hatası → 'Vergi kimlik numarası hatalı'; diğer → 'Hata oluştu'.
  • Lisans uzatma için extendLicense endpoint'ini kullanın.
  • Sözleşme onayı gerekebilir; agreementApproval ile önceden onaylanmalıdır.