agreementApproval
Genel Bilgi
| Özellik |
Değer |
| Endpoint Adı |
agreementApproval |
| SOAPAction |
urn:WebticariService#agreementApproval |
| Açıklama |
Kullanım sözleşmesi veya hizmet koşullarını onaylar. Yeni kullanıcı aktivasyonu veya sözleşme yenileme sürecinde çağrılır. |
| Kimlik Doğrulama Gerektirir |
Hayır (token yerine musNo ile publicLogin() yapılır) |
İstek Parametreleri
| Parametre |
Tip |
Zorunlu |
Açıklama |
musNo |
xsd:string |
Evet |
Müşteri numarası; publicLogin() ile kimlik doğrulaması yapılır |
uuid |
xsd:string |
Evet |
Onaylanacak mutabakat kaydının UUID'si |
onay |
xsd:string |
Evet |
Onay durumu: true (onaylandı) veya false (reddedildi) |
donem |
xsd:string |
Hayır |
Dönem kodu; boş bırakılırsa aktif dönem kullanılır |
Yanıt Parametreleri
| Parametre |
Tip |
Açıklama |
return |
xsd:string |
İşlem sonucu (başarı/hata mesajı) |
Örnek SOAP İstek
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tns="urn:WebticariService">
<soapenv:Header/>
<soapenv:Body>
<tns:agreementApproval>
<musNo>MUSTERI123</musNo>
<uuid>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</uuid>
<onay>true</onay>
<donem>2024</donem>
</tns:agreementApproval>
</soapenv:Body>
</soapenv:Envelope>
Notlar
- Standart token doğrulaması kullanmaz;
musNo parametresiyle sistem dahili publicLogin() yapılır.
onay yalnızca 'true' veya 'false' değerini kabul eder; başka değer hata kodu 5 döndürür.
onay='true' → mutabakat durumu 2 (onaylandı); onay='false' → durum 3 (reddedildi).
donem boş bırakılırsa aktif dönem kullanılır.
- Hata kodları:
1=hatalı musNo, 2=mutabakat kaydı bulunamadı, 3=önceden onaylanmış, 4=önceden reddedilmiş, 5=geçersiz onay tipi, 6=güncelleme hatası.
- Sözleşme onaylanmadan bazı işlemler (lisans yenileme, modül aktivasyonu) tamamlanamayabilir.