Atributos | Descrição | Tamanho | Tipo | Requerido | Valor default |
Instancia | Código da instancia. | 5 | STRING | N | |
codigoEstabelecimento | Código do parceiro usado para recuperar a instancia. Também pode sobrepor o código da empresa. | 30 | STRING | N | |
codigoEmpresa | Código da empresa. | 5 | STRING | N | |
dataRefer | Data do consumo do material (AAAA-MM-DD) | 10 | DATE | S | |
codigoCcusto | Código do Centro de Custos | 20 | INTEGER | S | |
codigoCtaCon | Código da Conta Contábil. | 15 | STRING | S | |
qtValor | Valor da Despesa (moeda corrente) | 16 , 4 | INTEGER | N | |
qtValorInicial, qtValorFinal | Valores inicial e final usados para calcular o valor das despesas caso necessário. | 16 , 4 | NUMBER | N | |
qtValor1, qtValor2, qtValor3 ,qtValor4 | Valor do Consumo em outra moeda | 16 , 4 | NUMBER | N | |
vlTarifa1, vlTarifa2, vlTarifa3, vlTarifa4 | Tarifa ERP (pertence a CSTG_INTDG) | 16 , 4 | NUMBER | N |
Atributos da chave primária composta
instancia, codigoEmpresa, dataRefer, codigoCcusto, codigoCtaCon.
GET
http:127.0.0.1:8080/entity/v1/despesasGerais?dataRefer=2014-04-30&page=1&pagesize=20
http:127.0.0.1:8080/entity/v1/despesasGeraisERP?dataRefer=2014-04-30page=1&pagesize=20
{
"hasNext": false,
"items": [
{
"dataRefer": "2014-04-30",
"codigoCcusto": 1235556,
"codigoCtaCon": "41101003",
"qtValor": 0,
"qtValor1": 0,
"qtValor2": 0,
"qtValor3": 0,
"qtValor4": 0,
"instancia": "201",
"codigoEmpresa": "201"
}
]
} |
{
"hasNext": false,
"items": [
{
"instancia": "201",
"codigoEmpresa": "201",
"dataRefer": "2014-04-30",
"codigoCcusto": 1235556,
"codigoCtaCon": "41101003",
"qtValor": 0,
"qtValor1": 0,
"qtValor2": 0,
"qtValor3": 0,
"qtValor4": 0,
"vlTarifa1": null,
"vlTarifa2": null,
"vlTarifa3": null,
"vlTarifa4": null
}
]
} |
Observações
- Os atributos podem ser usados como parâmetro para a busca.
- É obrigatório informar a dataRefer para efetuar a busca.
- Os atributos relacionados a vlTarifa só funciona quando usado para buscar na despesasGeraisERP.
- O atributo codigoEstabelecimento pode ser usado no lugar do codigoEmpresa(dependendo de como o sistema é configurado)
- Caso queira usar a instancia para a busca, mas não possua seu valor, é possível deixar o atributo recuperarInstancia true e enviar codigoEmpresaInst ou codigoEstabelecimentoInst (dependendo de como o sistema é configurado).
Configuração de parâmetros
- Entrada: CSTGDG_FILT_EST, Seção: INT_ERP. Se o valor for 'S' instancia é recuperada usando o codigoEstabelecimento. Se o valor for 'N' instancia é recuperada usando o codigoEmpresa.
- Entrada: FG_EMPR_FILIAL, Seção: INT_ERP. Se o valor for 'F' é usado o codigoEstabelecimento como o codigoEmpresa. Se o valor for 'E' continua sendo usado o codigoEmpresa.
- Entrada: FG_INT_EMPRESA, Seção: CSTG_C. Se o valor for 1, o código é erp e será resgatado na tabela PMMAPPIMS_EXT o código do bioenergia. Se o valor for 2, não há alteração no código informado.
POST
http:127.0.0.1:8080/entity/v1/despesasGerais→ cadastra um objeto
http:127.0.0.1:8080/entity/v1/despesasGerais/batch → cadastra uma lista do objeto.
Estrutura de dados para envio:
{
"codigoExterno": "INSTEX01",
"codigoEmpresa": "EMP01",
"dataRefer": "2024-09-01",
"codigoFuncio": 12345,
"codigoEquipto": "EQUIP123456",
"codigoCcusto": 1234567890,
"quantidadeHoras": 1
} ou uma lista
[{
"codigoExterno": "INSTEX01",
"codigoEmpresa": "EMP01",
"dataRefer": "2024-09-01",
"codigoFuncio": 12345,
"codigoEquipto": "EQUIP123456",
"codigoCcusto": 1234567890,
"quantidadeHoras": 1
}, {
"codigoExterno": "INSTEX01",
"codigoEmpresa": "EMP002",
"dataRefer": "2024-09-01",
"codigoFuncio": 12345,
"codigoEquipto": "EQUIP123456",
"codigoCcusto": 1234567890,
"quantidadeHoras": 1.5
}] |
Estrutura de dados retorno:
{
"codigoExterno": "INSTEX01",
"codigoEmpresa": "EMP01",
"dataRefer": "2024-09-01",
"codigoFuncio": 12345,
"codigoEquipto": "EQUIP123456",
"codigoCcusto": 1234567890,
"quantidadeHoras": 1,
"instancia": "INST01"
} ou uma lista
{
"status": "COMPLETED",
"totalRecords": 2,
"processedRecords": 1,
"failRecords": 1,
"result": [
{
"recordId": {
"codigoEmpresa": "EMP01",
"codigoFuncio": 12346,
"codigoEquipto": "EQUIP123456",
"codigoCcusto": 1234567890,
"dataRefer": "2024-09-01"
},
"status": "SUCCESS",
"message": null
},
{
"recordId": {
"codigoEmpresa": "EMP002",
"codigoFuncio": 12345,
"codigoEquipto": "EQUIP123456",
"codigoCcusto": 1234567890,
"dataRefer": "2024-09-01"
},
"status": "ERROR",
"message": "Tamanho inválido para o atributo codigoEmpresa. Máximo: 5"
}
]
} |
Observações
- Caso seja informado o codigoExterno, será cadastrado a instancia referente a ele no Bioenergia. Essa informação sobrepõe a instancia caso ela seja informada.
- O codigoCcusto e o codigoEquipto não podem estar zerados ou nulos simultaneamente. Ex: caso o codigoCcusto seja zero o codigoEquipto deve existir.
- É verificado se o codigoEmpresa referencia uma empresa consolidada.
- O retorno do cadastro em lista é uma lista com a pk do objeto, status e mensagem. Em caso de erro é registrado no status e na mensagem o ocorrido.
Configuração de parâmetros
- Entrada: CSTGDG_FG_CCUST , Seção: INT_ERP. Se o valor for 'D', o código é erp e será resgatado na tabela CCUSTO o código do bioenergia. Se o valor for 'P', não há alteração no código informado.
- Entrada: CSTGDG_FILT_EST, Seção: INT_ERP. Se o valor for 'S' a instancia é recuperada usando o codigoEstabelecimento. Se o valor for 'N' instancia é recuperada usando o codigoEmpresa.
- Entrada: FG_EMPR_FILIAL, Seção: INT_ERP. Se o valor for 'F' é usado o codigoEstabelecimento como o codigoEmpresa. Se o valor for 'E' continua sendo usado o codigoEmpresa.
- Entrada: FG_INT_EMPRESA, Seção: CSTG_C. Se o valor for 1, o código é erp e será resgatado na tabela PMMAPPIMS_EXT o código do bioenergia. Se o valor for 2, não há alteração no código informado.
- Entrada: CSTGDG_TAM_CTA, Seção: INT_ERP. O valor define o tamanho do codigoCtaCon, se for maior do que o esperado ele é cortado.
- Entrada: CSTGDG_DEB_CRED , Seção: INT_ERP. Se o valor for 1 continua sendo usado o codigoEmpresa. Se o valor for 2 o atributo qtValor será calculado usando qtValorInicial e qtValorFinal (qtValorFinal - qtValorInicial )
ele é chamado de debito e crédito mudo o nome?
PUT
http:127.0.0.1:8080/entity/v1/horasManutencaoMecanica→ atualiza um objeto
http:127.0.0.1:8080/entity/v1/horasManutencaoMecanica/batch → atualiza uma lista de objeto.
Observações
- Caso seja informado o codigoExterno, será cadastrado a instancia referente a ele no Bioenergia. Essa informação sobrepõe a instancia caso ela seja informada.
- O retorno do update em lista é uma lista com a pk do objeto, status e mensagem. Em caso de erro é registrado no status e na mensagem o ocorrido.
DELETE
http:127.0.0.1:8080/entity/v1/horasManutencaoMecanica
Observações
- É obrigatório informar os atributos que formam a chave primária.
- Caso seja informado o codigoExterno, será usado como parâmetro, para a deleção, a instancia referente a ele no Bioenergia. Essa informação sobrepõe a instancia caso ela seja informada.