Service Address
/DealerSale/AddProduct
Request Parameters
DealerSaleAuthentication
| Parameter |
Explanation |
| DealerCode(string) |
Dealer code issued by the Moka system |
| Username (string) |
Api username given by Moka system |
| Password (string) |
Api password given by Moka system |
| CheckKey (string) |
The control key (DealerCode + "MK" + Username + "PD" + Password) is created by passing this information, combined as a String, through the SHA-256 hash algorithm.
Click here to go to the trial screen. |
DealerSaleRequest
| Parameter |
Explanation |
| ProductName (string) |
Name of the product (Max 100 chars) |
| ProductCode (string) |
It is the special code of the product on the dealer side. If sent empty, guid will be created |
Sample Request (JSON)
{
"DealerSaleAuthentication": {
"DealerCode": "xxx",
"Username": "xxx",
"Password": "xxx",
"CheckKey": "aabbccddeeff"
},
" DealerSaleRequest": {
"ProductCode": "Product01",
"ProductName": "Product"
}
}
Successful Request Result
If the sent request data has been processed successfully in Moka, "Success" information is written in the "ResultCode" field of the return object . The "Data" field contains the result of the returned operation. You can continue your flows by checking the information in "Data" .
| Parameter |
Explanation |
| DealerProductId (integer) |
It is the Unique ID of the product on the moka side. |
| ProductName (string) |
Product name |
| ProductCode (string) |
If the dealer has not sent a special code, guid is returned in this field. |
Successful Result Example
{
"Data": {
"DealerProductId": 1009,
"ProductName": "Product",
"ProductCode": "Product01"
},
"ResultCode": "Success",
"ResultMessage": "",
"Exception": null
}
Failed Request Result
If the sent request data could not be processed in Moka streams, the "ResultCode" field of the return object contains one of the error codes in the table below.
When an unexpected software error occurs, EX is written in the "ResultCode" field and the error message (Exception) is displayed in the "ResultMessage" field
In both cases, the "Data" object arrives as null.
| ResultCode | Explanation |
|---|
| DealerSale.AddProduct.InvalidRequest | The CheckKey may be bad, or the object may be bad, or the JSON may be corrupt. |
| DealerSale.AddProduct.ProductNameIsRequired | The product name is required. |
| DealerSale.AddProduct.ProductCodeAlreadyUsing | The product code is already used. |
| DealerSale.AddProduct.ProductNameAlreadyExists | The product name already exists. |
| EX | An unexpected error has occurred |
Example of Failed Result
{
"Data": null,
"ResultCode": "DealerSale.AddProduct.ProductNameIsRequired",
"ResultMessage": "",
"Exception": null
}