Material Monthly Price

The PostAddMaterialMonthlyPrice endpoint is responsible for registering the monthly price of a material in the MIMS system and can be viewed on screen CST003.

---

How to register material monthly price

HTTP POST Request

Request Type	Example URL
POST	{{url_base}}/PostAddMaterialMonthlyPrice
Example	http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddMaterialMonthlyPrice"

Input Parameters

Parameter	Type	Required	Description
BranchNo	String(25)	Yes	External code of the branch
Period	String(40)	Yes	Period (format: Month + Year)
MaterialNo	String(25)	Yes	External code of the material
Price	Float	Yes	Material price
OverwriteIfExists	Boolean	No	Flag indicating that data should be overwritten if the record already exists

---

Return

Parameter	Type	Required	Description
WebServiceReturn	WebServiceReturn	Yes	Standard WebService response information in method execution

---

Request Example

curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddMaterialMonthlyPrice"' \
--header 'Content-Type: application/json' \
--data '{
    "BranchNo": "FIL123",
    "Period": "02-2024",
    "MaterialNo": "MAT456",
    "Price": 75.50,
    "OverwriteIfExists": true
}'

---

Response Example

{
    "WebServiceReturn": {
        "Status": "wrsSuccess",
        "ErrorCode": "",
        "Message": "",
        "Actor": "",
        "ReturnQuestion": null
    }
}

---

🐞 Possible Errors

Code	Message
MMP‑001	The informed Period is invalid! The period must be in format "MM/YYYY"
MMP‑002	The informed Period is blocked!

---