Custo Médio Mensal por Material Consumido

Descrição

O endpoint PostAddMaterialMonthlyAverageCost realiza o cadastro do custo médio mensal por materiais consumidos realizados no ERP no sistema MIMS.

---

Como cadastrar o custo médio mensal

Request HTTP POST

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

---

Parâmetros de Entrada

Parâmetro	Tipo	Obrigatório	Descrição
BranchNo	String(25)	Sim	Código externo da filial
Period	String(40)	Sim	Período (Mês + Ano)
OverwriteExists	Boolean	Não	Flag que indica se os dados existentes devem ser sobrescritos caso o registro já exista
ItemList	AddMaterialMonthlyAverageCostItemList	Sim	Lista de todos os materiais consumidos no período

📝 Objeto AddMaterialMonthlyAverageCostItemList

Descrição

O objeto AddMaterialMonthlyAverageCostItemList representa o custo médio mensal de um material consumido no ERP.

Parâmetros de entrada

Parâmetro	Tipo	Obrigatório	Descrição
MaterialNo	String(25)	Sim	Código Externo do Material
AverageCost	Float	Sim	Valor unitário médio do material consumido

---

Retorno

Nome	Tipo	Obrigatório	Descrição
WebServiceReturn	WebServiceReturn	Sim	Informações padrão de resposta do WebService na execução do método

---

Exemplo de Request

POST http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/PostAddMaterialMonthlyAverageCost
Content-Type: application/json

{
  "BranchNo": "BR001",
  "Period": "202502",
  "OverwriteExists": true,
  "ItemList": [
    {
      "MaterialNo": "MAT001",
      "AverageCost": 10.50
    }
  ]
}

---

Exemplo de Response

{
  "WebServiceReturn": {
    "Success": true,
    "Message": "Custo médio mensal por material cadastrado com sucesso."
  }
}

---

Notas de Dev

• Certifique-se de que BranchNo, Period e MaterialNo sejam válidos e existentes no sistema MIMS.
• O campo Period deve estar no formato "AAAAMM" (ex.: 202502 para fevereiro de 2025).
• O campo OverwriteExists, quando true, sobrescreve os dados existentes para o mesmo período, filial e material, se houver um registro duplicado.
• O valor AverageCost representa o custo médio unitário do material consumido no período especificado.

---