API Estorno de Movimentos de Lubrificações Industriais (Manutenção Industrial)

Disponibilizado endpoint para integração dos movimentos de estornos de lubrificações industriais através do método GET e PUT para atualização do status após integração (estorno) realizado.

Estrutura:

Atributos	Descrição	Tamanho	Tipo	Chave Primária	Requerido	Valor Default	Valores Válidos	Observação
id	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.
boletim	Número do boletim	12	INTEGER	N	N	-	-	-
ordemServico	Número da ordem de serviço	7	INTEGER	N	N	-	-	-
dataApontamento	Data da lubrificação	10	DATE	N	N	-	-	-
dataEnvio	Data da coleta do registro	10	DATE	N	N	TRUNC(SYSDATE)	-	-
codigoMaterial	Código do lubrificante no PIMS	13	STRING	N	N	-	-	-
codigoMaterialERP	Código do lubrificante no ERP	25	STRING	N	N	-	-	-
quantidade	Quantidade	8,4	NUMBER	N	N	-	-	-
unidadeMedida	Código da unidade de medida	8	STRING	N	N	-	-	-
codigoCentroCusto	Código do centro de custo no PIMS	20	STRING	N	N	-	-	-
codigoDepositoERP	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_MI'
codigoEmpresaERP	Código da empresa no ERP	250	STRING	N	N	-	-	Resgatado a partir do parâmetro do Bioenergia Seção: 'INT_ERP' / Entrada: 'EMPRESA_ERP'
codigoFilialERP	Código da filial no ERP	250	STRING	N	N	-	-	Resgatado a partir do parâmetro do Bioenergia Seção: 'INT_ERP' / Entrada: 'FILIAL_ERP'
codigoContaContabilERP	Código da conta contábil no ERP	250	STRING	N	N	-	-	Resgatado a partir do parâmetro do Bioenergia Seção: 'INT_ERP' / Entrada: 'CD_CTA_CTB_MI_MANLUBR_APIHUB'

GET (Consulta alterações/deleções de Movimentos de Lubrificações Industriais para estorno no ERP)

http:127.0.0.1:8080/api/query/v1/estornoConsumiveisIndustriaisMativ?page=1&pagesize=2

Response

{
    "hasNext": false,
    "items": [
        {
            "id": "MNI99999000052802025",
            "origem": "MI_MANLUBR",
            "instancia": "PRX",
            "boletim": 32513,
            "ordemServico": 416349,
            "dataApontamento": "2025-10-23T03:00:00.000+00:00",
            "dataEnvio": "2025-10-23T03:00:00.000+00:00",
            "codigoMaterial": "301906",
            "codigoMaterialERP": "301906",
            "quantidade": 2,
            "unidadeMedida": "KG",
            "codigoCentroCusto": "50",
            "codigoDepositoERP": null,
            "usuario": null,
            "codigoEmpresaERP": null,
            "codigoFilialERP": null,
            "codigoContaContabilERP": null
         }
    ]
}

Parâmetros

page: Número da página.
pagesize: Quantidade máxima de registros por página.

Observações

Os dados retornados para estorno são referentes ao último registro de baixa integrado (STATUS_INT_ERP = '1') na tabela de log.
Serão considerados elegíveis de estorno apenas as alterações/deleções referentes a apontamentos que já tiveram a sua baixa integrada anteriormente.
Serão considerados elegíveis de estorno apenas as alterações que tiveram dados chave alterados (mis, quantidade, material e ponto).
Em caso de 2 ou mais registros de alteração para o apontamento que não tenham sido efetuado o estorno (STATUS_INT_ERP = '0') será considerado sempre o último (ordenado pelo ID_RASTREAR e NO_TRANSACAO) e ao confirmar o estorno todos os registros de alteração serão atualizados para integrado (STATUS_INT_ERP = '1').
A quantidade informada no apontamento deve ser maior que zero.
A ordem de serviço informada no apontamento deve estar cadastrada, deve ser do tipo PRP e deve estar finalizada.
A quantidade real informada no apontamento deve ser maior que zero.
O material/lubrificante informado no apontamento deve estar cadastrado e não pode estar definido como reutilização.

PUT (Atualiza STATUS_INT_ERP para 1 indicando que o estorno foi realizado)

http:127.0.0.1:8080/api/query/v1/estornoConsumiveisIndustriaisMativ

Estrutura de dados para envio:

Body

{
    "id": "MNI99999000052802025"
}

Observações

Deverá ser enviado o id referente ao registro que foi estornado para que o sistema atualize o status do estorno e em caso de alteração disponibilize a nova baixa.
Caso seja uma alteração, após a conclusão do estorno a nova baixa estará disponível para consumo via API Movimentos de Lubrificações (Manutenção Industrial).

Páginas filhas

API Estorno de Movimentos de Lubrificações Industriais (Manutenção Industrial)

Parâmetros