Vendas Mensais

O endpoint PostAddMonthlyIncome é responsável pelo cadastro do valor das vendas mensais realizadas no ERP no sistema MIMS.

---

Como cadastrar o valor das vendas mensais

Request HTTP Post

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

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)
OverwriteIfExists	Boolean	Não	Flag que indica que os dados devem ser sobrescritos caso o registro já exista
ItemList	AddMonthlyIncomeItemList	Sim	Lista de todos os custos por produto no período

📝 Objeto AddMonthlyIncomeItemList

O objeto AddMonthlyIncomeItemList representa um item da venda mensal realizada no ERP.

Parâmetros de Entrada

Parâmetro	Tipo	Obrigatório	Descrição
ProductNo	String(25)	Sim	Código Externo do produto
TotalProductWeight	Float	Sim	Peso total do produto
TotalProductCost	Float	Sim	Custo total do produto

---

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

---

Exemplo de Request

curl --location --request POST '{{url_base}}/PostAddMonthlyIncome' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
  "BranchNo": "FIL123",
  "Period": "01-2025",
  "OverwriteIfExists": true,
  "ItemList": [
    {
      "ProductNo": "PROD001",
      "TotalProductWeight": 1000.50,
      "TotalProductCost": 50000.75
    },
    {
      "ProductNo": "PROD002",
      "TotalProductWeight": 750.30,
      "TotalProductCost": 32000.40
    }
  ]
}

---

Exemplo de Response

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

---

🐞 Possíveis Erros

Código	Mensagem
AMI‑001	O Custo Mensal já foi processado para o Período (PeriodNo) [valor enviado na requisição] e Filial (BranchNo) [valor enviado na requisição] informados. Operação não permitida!
AMI‑002	A Receita Mensal já existe para o Período (PeriodNo) [valor enviado na requisição] e Filial (BranchNo) [valor enviado na requisição] informados. Operação não permitida!

---