Categoria de Material

O endpoint PostAddMaterialCategory é responsável pelo cadastro de uma nova categoria de material no sistema MIMS. Esse cadastro pode ser visualizado na tela CAD005.

---

Como cadastrar uma categoria de material

Request HTTP POST

Tipo da Requisição	URL Exemplo
POST	{{url_base}}/PostAddMaterialCategory
Exemplo	http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddMaterialCategory"

Parâmetros de Entrada

Parâmetro	Tipo	Obrigatório	Descrição
MaterialCategoryNo	String(25)	Sim	Código externo da categoria de material
Name	String(40)	Sim	Descrição da categoria de material
OverwriteIfExists	Boolean	Não	Flag que indica que os dados devem ser sobrescritos caso o registro já exista

---

Retorno

Parâmetro	Tipo	Obrigatório	Descrição
WebServiceReturn	WebServiceReturn	Sim	Informações padrão de resposta do WebService na execução do método
MaterialCategoryCode	Integer	Sim	Código interno da Categoria de Material gerado no sistema MIMS

---

Exemplo de Request

curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddMaterialCategory"' \
--header 'Content-Type: application/json' \
--data '{
    "MaterialCategoryNo": "CAT123",
    "Name": "Categoria Exemplo",
    "OverwriteIfExists": true
}'

---

Exemplo de Response

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

---

🐞 Possíveis Erros

Código	Mensagem
ACM‑001	Parâmetro Código Externo da Categoria do Material (MaterialCategoryNo) informado já existe!

---