Ana içeriğe geç

extendLicense

Genel Bilgi

Özellik Değer
Endpoint Adı extendLicense
SOAPAction urn:WebticariService#extendLicense
Açıklama Mevcut Webticari lisansını uzatır. Lisans süresi dolmadan önce çağrılarak kullanım hakkı yenilenir.
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 (tbcari.cr_no); bayi kendi müşterisi için ödeme yapıyorsa @@{mno} formatında müşteri numarası
type xsd:string Evet Uzatma türü: year (yıldönümüne göre) veya month (1 ay uzat)

Yanıt Parametreleri

Parametre Tip Açıklama
return xsd:string İşlem sonucu XML: success (1 = başarılı, 0 = hata) ve explanation (hata açıklaması veya boş)

Yanıt Örneği

Başarılı: 

<response>
  <success>1</success>
  <explanation></explanation>
</response>

Lisans tarihi alınamadı (geçersiz cari/mno): 

<response>
  <success>0</success>
  <explanation>Lisans tarihi alınamadı</explanation>
</response>

⚠️ Yanıt, yeni lisans bitiş tarihini içermez; güncellenen tarihi öğrenmek için licenceInfo endpoint'ini çağırın.

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:extendLicense>
      <token>abc123tokendeğeri</token>
      <crno>1042</crno>
      <type>year</type>
    </tns:extendLicense>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Token gereklidir.
  • crno @@ ön ekiyle gönderilirse mno doğrudan kullanılır; aksi hâlde tbcari.cr_kod sorgulanır.
  • type='year': lisans kayıt yıldönümüne göre hesaplanan tarihe uzatır; lisans >1 yıl önce bitmişse bu yıl veya gelecek yıl yıldönümü hesaplanır.
  • type='month': lisans geçerliyse DATE_ADD(ms_lstarih, INTERVAL 1 MONTH); bitmiş ise DATE_ADD(NOW(), INTERVAL 1 MONTH).
  • Güncelleme tüm DB sunucularında (dbserver tablosu) gerçekleştirilir.
  • Mevcut lisans durumunu kontrol etmek için licenceInfo endpoint'ini kullanın.