-
Web Service URL: https://[SERVER_ADDRESS]/GeneralWS/GeneralData2.asmx
-
MPS Version: From 5.22.0
Description
This method requests a new security or scheduling demand for a printer.
Syntax
public string InsertNewDemand(string properties)
Setting Properties
The content of string properties must be text in JSON format containing the properties listed below. For example:
{"DealerName":"dealer","DealerUserEmail":"user@example.com","DealerUserPassword":"k1BAv1w=="}
You don't need to worry about whether property names are uppercase or lowercase; the Web Service is Case-Insensitive.
-
To submit a safety demand, only the StockID must be provided (do not include the EnterprisePrinterDeviceSlotID);
-
To submit a forecast¹ demand, the EnterprisePrinterDeviceSlotID must be provided (the StockID is not required).
¹ Available starting with version 5.39.0.
Properties accepted by the method
|
Property |
Type |
Required |
Allows null |
Allows empty |
Maximum size |
Description |
|
DealerName |
Text |
Yes |
- |
- |
- |
Provider name |
|
DealerUserEmail |
Text |
Yes |
- |
- |
- |
Provider user email |
|
DealerUserPassword |
Text |
Yes |
- |
- |
- |
Encrypted user password |
|
SupplyModelID |
Number |
Yes |
- |
- |
- |
Identification number of the supply model recognized in the system |
|
EnterprisePrinterDeviceSlotID |
Number |
No |
- |
- |
- |
Identifier number of a printer slot. Obtained via the GetPrintersSlots method |
|
StockID |
Number |
No |
- |
- |
- |
Stock identification number in the system |
|
UTCExpectedDate |
Date |
Yes |
- |
- |
- |
Expected delivery deadline (in UTC 0) (Format yyyy-MM-dd) |
Return
If successful, the return value is: [{“SupplyDemandID”:number}].
Click here to learn more about the response format.
Possible errors returned
Click here to check the possible errors that may be returned and understand their reasons.
Restrictions
-
This method can only be used when the provider is not configured to operate in basic mode;
-
If the user has permission to Authorize Requests, the request will already be created and approved.
For safety requests:
-
The user must be the sole person responsible for the stock; or
-
Have full stock administrator permissions.
For forecast requests:
-
The user must be the sole person responsible for the stock that supplies the site to which the printer belongs; or
-
Have full replenishment flow permissions and monitor the company or site to which the printer belongs.