Servis Adresi
/DealerSale/AddProduct
İstek Parametreleri
DealerSaleAuthentication
Parametre |
Açıklama |
DealerCode(string) |
Ruut sistemi tarafından verilen bayi kodu |
Username (string) |
Ruut sistemi tarafından verilen Api kullanıcı adı |
Password (string) |
Ruut sistemi tarafından verilen Api şifresi |
CheckKey (string) |
Kontrol anahtarı (DealerCode + "MK" + Username + "PD" + Password) String olarak birleştirilen bu bilgilerin SHA-256 hash algoritmasından geçirilmesiyle oluşturulur.
Buraya tıklayarak deneme ekranına gidebilirsiniz. |
DealerSaleRequest
Parametre |
Açıklama |
ProductName (string) |
Ürünün adı (Max 100 chars) |
ProductCode (string) |
Ürünün bayi tarafındaki özel kodudur. Boş gönderilirse guid oluşturulur |
Örnek İstek (JSON)
{
"DealerSaleAuthentication": {
"DealerCode": "xxx",
"Username": "xxx",
"Password": "xxx",
"CheckKey": "aabbccddeeff"
},
" DealerSaleRequest": {
"ProductCode": "Product01",
"ProductName": "Product"
}
}
Başarılı İstek Sonucu
Gönderilen istek verileri Ruut’ da başarılı bir şekilde işlenmişse, geri dönüş nesnesinin "ResultCode" alanında "Success" bilgisi yazar.
"Data" alanında ise dönen işlem sonucu bulunur. "Data" içinde yer alan bilgileri kontrol ederek akışlarınızı devam ettirebilirsiniz.
Parametre |
Açıklama |
DealerProductId (integer) |
Ruut tarafındaki ürünün Unique ID sidir. |
ProductName (string) |
Ürünün adı |
ProductCode (string) |
Bayi, özel bir kod göndermemişse bu alanda guid döner. |
Başarılı Sonuç Örneği
{
"Data": {
"DealerProductId": 1009,
"ProductName": "Product",
"ProductCode": "Product01"
},
"ResultCode": "Success",
"ResultMessage": "",
"Exception": null
}
Başarısız İstek Sonucu
Gönderilen istek verileri Ruut akışları içerisinde işlenemediyse, geri dönüş nesnesinin "ResultCode" alanında alttaki tablodaki hata kodlarından birisi bulunur.
Beklenmeyen yazılımsal bir hata oluştuğunda ise, "ResultCode" alanında EX yazar ve "ResultMessage" alanında alınan hata mesajı (Exception) yer alır.
Her iki durumda da, "Data" nesnesi null olarak gelir.
ResultCode | Açıklama |
DealerSale.AddProduct.InvalidRequest | CheckKey hatalı ya da nesne hatalı ya da JSON bozuk olabilir. |
DealerSale.AddProduct.ProductNameIsRequired | Ürün adı gereklidir. |
DealerSale.AddProduct.ProductCodeAlreadyUsing | Ürün kodu zaten kullanılıyor. |
DealerSale.AddProduct.ProductNameAlreadyExists | Ürün adı zaten mevcut. |
EX | Beklenmeyen bir hata oluştu |
Başarısız Sonuç Örneği
{
"Data": null,
"ResultCode": "DealerSale.AddProduct.ProductNameIsRequired",
"ResultMessage": "",
"Exception": null
}