-
Web Service URL: https://[SERVER_ADDRESS]/GeneralWS/GeneralData.asmx
-
MPS Version: From 5.3.0
Description
This method registers a new Customer Stock with the provider. If the Customer Stock already exists, this method can be used to update address information.
Syntax
public string ImportCompanyStocks(string dealerName, string dealerUserEmail, string dealerUserPassword, string stockName, string description, int progDays, bool securityOnly, string countryName, string stateName, string cityName, string street, string neighborhood, string postalCode, int number, string additionalInfo, string contactName, string contactEmail, string contactPhone, int customField1InUse, string customField1Name, string customField1Value, int customField2InUse, string customField2Name, string customField2Value, int customField3InUse, string customField3Name, string customField3Value)
Parameters
-
dealerName: Provider name;
-
dealerUserEmail: Provider user email;
-
dealerUserPassword: Encrypted user password;
-
stockName: Name of the stock to be registered;
-
description: Description of the stock to be registered;
-
progDays: Period in days that the next forecast should be performed;
-
securityOnly: Indicates whether the stock forecast is only for safety items;
-
contactName: Name of the stock contact;
-
contactEmail: Email of the stock contact;
-
contactPhone: Contact phone number for the stock;
-
countryName: Country where the stock to be registered is located;
-
stateName: State where the stock to be registered is located;
-
cityName: City where the stock to be registered is located;
-
street: Name of the street where the stock to be registered is located;
-
neighborhood: Name of the neighborhood where the stock to be registered is located;
-
postalCode: Postal code number where the stock to be registered is located;
-
number: Number of the location where the stock is located;
-
additionalInfo: Additional information about where the stock is located;
-
customField1InUse: Indicates whether the first additional field will be used in stock (0 - Do not use; 1 - Use);
-
customField1Name: Name of the first additional field;
-
customField1Value: Value of the first additional field;
-
customField2InUse: Indicates whether the second additional field will be used in stock (0 - Do not use; 1 - Use);
-
customField2Name: Name of the second additional field;
-
customField2Value: Value of the second additional field;
-
customField3InUse: Indicates whether the third additional field will be used in stock (0 - Do not use; 1 - Use);
-
customField3Name: Name of the third additional field;
-
customField3Value: Value of the third additional field.
Characters not allowed in parameters and the error that will be returned
|
Parameter |
Unsupported characters |
Error |
|
stockName |
; |
ERR_DATA_INVALIDSTOCKNAME |
|
description |
; |
ERR_DATA_INVALIDSTOCKDESCRIPTION |
|
countryName |
!@#$%¨&*=§[]{}ºª?/°;:><\/+-.,_()³£¢¬²+|´`´~^+\ |
ERR_DATA_INVALIDCOUNTRYNAME |
|
stateName |
!@#$%¨&*=§[]{}ºª?/°;:><\/+-.,_()³£¢¬²+|´`´~^+\ |
ERR_DATA_INVALIDSTATENAME |
|
cityName |
!@#$%¨&*=§[]{}ºª?/°;:><\/+-.,_()³£¢¬²+|´`´~^+\ |
ERR_DATA_INVALIDCITYNAME |
|
street |
!@#$%¨&*=§[]{}ºª?/°;:><\/+-.,_()³£¢¬²+|´`´~^+\ |
ERR_DATA_INVALIDSTREET |
|
neighborhood |
!@#$%¨&*=§[]{}ºª?/°;:><\/+-.,_()³£¢¬²+|´`´~^+\ |
ERR_DATA_INVALIDNEIGHBORHOOD |
|
postalCode |
!@#$%¨&*=§[]{}ºª?/°;:><\/+.,_()³£¢¬²+|´`´~^+\ |
ERR_DATA_INVALIDPOSTALCODE |
Return
If successful, the return is: [{“StockID”:number}], where number is the identifier number in the new stock entered.
Click here to learn more about the format of returns.
Possible errors returned
Click here to check the possible errors that may be returned and learn about their reasons.
Restrictions
-
To execute this method, the user must have full permissions in Stock Administration.