Custo Direto
Descrição
Este endpoint cadastra gastos mensais por centro de custo (custo direto) no sistema MIMS. Ele registra informações como filial, período, centro de custo, conta contábil, valor do gasto e uma flag para sobrescrever dados existentes, gerando um código interno para o gasto mensal.
Request HTTP Post
| Tipo da Requisição | URL Exemplo |
|---|---|
| POST | {{url_base}}/PostAddDirectCost |
| Exemplo | http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/PostAddDirectCost |
Parâmetros de Entrada
| Nome | Tipo | Obrigatório | Comentários |
|---|---|---|---|
| BranchNo | String(25) | Sim | Código Externo da Filial |
| Period | String(40) | Sim | Período (Mês + Ano) |
| CostCenterNo | String(25) | Sim | Código Centro Custo |
| GLAccountNo | String(25) | Sim | Código Conta Contábil |
| PeriodValue | Float | Sim | Gastos no Período ou dados |
| OverwriteExists | Boolean | Não | Flag que indica se os dados existentes serão sobrescritos caso o registro já exista |
Retorno
| Nome | Tipo | Obrigatório | Comentários |
|---|---|---|---|
| WebServiceReturn | WebServiceReturn | Sim | Informações padrão de resposta do WebService na execução do método |
| DirectCostCode | Integer | Sim | Código interno do gasto mensal gerado no sistema MIMS |
Exemplo de Request
POST http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/PostAddDirectCost
Content-Type: application/json
{
"BranchNo": "BR001",
"Period": "202502",
"CostCenterNo": "CC001",
"GLAccountNo": "ACC123",
"PeriodValue": 5000.00,
"OverwriteExists": true
}
Exemplo de Response
{
"WebServiceReturn": {
"Success": true,
"Message": "Gasto mensal cadastrado com sucesso."
},
"DirectCostCode": 789
}
Notas de Dev
- Certifique-se de que
BranchNo,PeriodeGLAccountNosejam válidos e existentes no sistema MIMS. - O campo
Perioddeve estar no formato "AAAAMM" (ex.:202502para fevereiro de 2025). - O campo
CostCenterNoé opcional, mas deve ser fornecido se aplicável. - O campo
OverwriteExists, quandotrue, sobrescreve os dados existentes para o mesmo período, filial, centro de custo e conta contábil, se houver um registro duplicado. - O valor
PeriodValuerepresenta o valor financeiro dos gastos no período especificado.