Disponibilizado endpoint para integração dos movimentos de lubrificações industriais através do método GET e PUT para atualização do status após integração (baixa) realizada.
Estrutura:
Atributos | Descrição | Tamanho | Tipo | Chave Primária | Requerido | Valor Default | Valores Válidos | Observação |
ID_RATREAR | Id único para rastreamento do registro de ponta a ponta | 20 | STRING | S (lógica) | S | - | - | Gerado automaticamente quando o registro é inserido na tabela |
ORIGEM | Origem do registro | 10 | STRING | N | N | MI_MANLUBR | - | - |
INSTANCIA | Código da instância | 5 | STRING | N | N | - | - | Instância vinculada com a tabela de empresa. |
NO_BOLETIM | Número do boletim | 12 | INTEGER | N | N | - | - | - |
NO_SEQ | Sequência | 1 | INTEGER | N | N | 1 | - | - |
NO_OS | Número da ordem de serviço | 7 | INTEGER | N | N | - | - | - |
DATA_MOVTO | Data da lubrificação | 10 | DATE | N | N | - | - | - |
DATA_ENVIO | Data da coleta do registro | 10 | DATE | N | N | TRUNC(SYSDATE) | - | - |
COD_MATERIAL_PIMS | Código do lubrificante no PIMS | 13 | STRING | N | N | - | - | - |
COD_MATERIAL_ERP | Código do lubrificante no ERP | 13 | STRING | N | N | - | - | - |
QUANTIDADE | Quantidade | 8,4 | NUMBER | N | N | - | - | - |
COD_UNMED_ERP | Código da unidade de medida no ERP | 1 | STRING | N | N | - | - | - |
COD_CCUSTO_PIMS | Código do centro de custo no PIMS | 20 | STRING | N | N | - | - | - |
COD_CCUSTO_ERP | Código do centro de custo no ERP | 20 | STRING | N | N | - | - | Utiliza o mesmo código do centro de custo no PIMS pois não há campo específico para centro de custo no ERP |
COD_DEP_ERP | Código do depósito do lubrificante no ERP | 250 | STRING | N | N | - | - | Resgatado a partir do parâmetro do BioEnergia Seção: 'INT_ERP' / Entrada: 'DEPOSITO_LUBRIF_INDUSTRIAIS' |
USUARIO | Usuário responsável pelo apontamento | 250 | STRING | N | N | - | - | Caso o usuário não esteja preenchido no apontamento: Resgatado a partir do parâmetro do BioEnergia Seção: 'INT_ERP' / Entrada: 'CD_REQUISITANTE_MNF' |
COD_EMPRESA_ERP | Código da empresa no ERP | 250 | STRING | N | N | - | - | Resgatado a partir do parâmetro do BioEnergia Seção: 'GERAL' / Entrada: 'EMPRESA_ERP' |
COD_FILIAL_ERP | Código da filial no ERP | 250 | STRING | N | N | - | - | Resgatado a partir do parâmetro do BioEnergia Seção: 'GERAL' / Entrada: 'FILIAL_ERP' |
STATUS_INT_ERP | Status da integração com o ERP | 1 | STRING | N | S | - | Null = Indisponível para integração 0 = Disponível para integração 1 = Integrado com sucesso 2 = Cancelado antes da integração | GET: Serão disponibilizados apenas registros com o valor = 0 (zero). Campo utilizado para controle interno dos registros e não será disponibilizado no body. |
GET (Consulta Lubrificantes consumidos para baixa no ERP)
http:127.0.0.1:8080/query/v1/baixaConsumiveisIndustriaisMativ?page=1&pagesize=2
{
"hasNext": true,
"items": [
{
"ID_RASTREAR": "MNI99999000000572025",
"ORIGEM": "MI_MANLUBR",
"INSTANCIA": "PRX",
"NO_BOLETIM": 6672,
"NO_SEQ": 1,
"NO_OS": 286159,
"DATA_MOVTO": "2019-07-17T03:00:00.000+00:00",
"DATA_ENVIO": "2025-06-09T03:00:00.000+00:00",
"COD_MATERIAL_PIMS": 47767,
"COD_MATERIAL_ERP": "47767",
"QUANTIDADE": 1,
"COD_UNMED_ERP": "LT",
"COD_CCUSTO_PIMS": "70",
"COD_CCUSTO_ERP": "70",
"COD_DEP_ERP": null,
"USUARIO": "PIMSCS",
"COD_EMPRESA_ERP": "123",
"COD_FILIAL_ERP": null
},
{
"ID_RASTREAR": "MNI99999000000712025",
"ORIGEM": "MI_MANLUBR",
"INSTANCIA": "PRX",
"NO_BOLETIM": 9876,
"NO_SEQ": 1,
"NO_OS": 401301,
"DATA_MOVTO": "2020-01-25T03:00:00.000+00:00",
"DATA_ENVIO": "2025-06-09T03:00:00.000+00:00",
"COD_MATERIAL_PIMS": 47627,
"COD_MATERIAL_ERP": "47627",
"QUANTIDADE": 0.5,
"COD_UNMED_ERP": "KG",
"COD_CCUSTO_PIMS": "60",
"COD_CCUSTO_ERP": "60",
"COD_DEP_ERP": null,
"USUARIO": "PIMSCS",
"COD_EMPRESA_ERP": "123",
"COD_FILIAL_ERP": null
}
]
} |
Observações
- Todos os atributos podem ser usados como parâmetro para a busca.
POST (Cadastra Material por Empresa)
http:127.0.0.1:8080/entity/v1/materialEmpresa
Estrutura de dados para envio:
{
"material": 1000,
"instancia": "11",
"deposito": "VIRTBORR01",
"saldo": 50,
"ultimaAtualizacao": "2023-08-30T00:00:00",
"ultimaCompra": "2024-01-02T00:00:00",
"valorUnitarioMedio": 5.5,
"valorUnitarioReposicao": 6.5,
"estocavel": "S",
"compra": "N",
"conta": "987.654.321"
} |
Estrutura de dados retorno:
{
"material": 1000,
"instancia": "11",
"deposito": "VIRTBORR01",
"saldo": 50,
"ultimaAtualizacao": "2023-08-30T00:00:00",
"ultimaCompra": "2024-01-02T00:00:00",
"valorUnitarioMedio": 5.5,
"valorUnitarioReposicao": 6.5,
"estocavel": "S",
"compra": "N",
"conta": "987.654.321",
"id": "26"
} |
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.
- É obrigatório informar a instancia ou o codigoExterno.
PUT e PATCH (Atualiza Material por Empresa)
http:127.0.0.1:8080/entity/v1/materialEmpresa
Estrutura de dados para envio:
{
"id": 26,
"material": 1000,
"instancia": "11",
"deposito": "VIRTBORR01",
"saldo": 49,
"ultimaAtualizacao": "2023-08-30T00:00:00",
"ultimaCompra": "2024-01-02T00:00:00",
"valorUnitarioMedio": 5.5,
"valorUnitarioReposicao": 6.5,
"estocavel": "S",
"compra": "N",
"conta": "987.654.321"
} |
Estrutura de dados retorno:
{
"id": 26,
"material": 1000,
"instancia": "11",
"deposito": "VIRTBORR01",
"saldo": 49,
"ultimaAtualizacao": "2023-08-30T00:00:00",
"ultimaCompra": "2024-01-02T00:00:00",
"valorUnitarioMedio": 5.5,
"valorUnitarioReposicao": 6.5,
"estocavel": "S",
"compra": "N",
"conta": "987.654.321"
} |
Observações
- Caso seja informado o codigoExterno, será atualizada a instancia referente a ele no Bioenergia. Essa informação sobrepõe a instancia caso ela seja informada.
- É obrigatório informar a instancia ou o codigoExterno.
DELETE (Apaga Material por Empresa)
http:127.0.0.1:8080/entity/v1/materialEmpresa?id=26
Observações
- É obrigatório informar os atributos que compõem a chave primária como parâmetros da chamada.
- É obrigatório informar a instancia ou o codigoExterno.
- 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.