API Estorno de Movimentos de Abastecimentos e Lubrificações Automotivas

Disponibilizado endpoint para integração dos movimentos de estornos de abastecimentos e lubrificações automotivas 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	Abastecimento: CS_MNFABAS Lubrificação: CS_MNFLUBR	-	-
instancia	Código da instância	5	STRING	N	N	-	-	-
boletim	Número do boletim	10	INTEGER	N	N	-	-	-
sequencia	Sequência	3	INTEGER	N	N	-	-	-
dataApontamento	Data do apontamento	10	DATE	N	N	-	-	-
dataEnvio	Data da coleta do registro	10	DATE	N	N	TRUNC(SYSDATE)	-	-
codigoMaterial	Código do material no PIMS	12	INTEGER	N	N	-	-	-
codigoMaterialERP	Código do material no ERP	25	STRING	N	N	-	-	-
quantidade	Quantidade	8,3	NUMBER	N	N	-	-	-
unidadeMedida	Código da unidade de medida no PIMS	3	STRING	N	N	-	-	-
unidadeMedidaERP	Código da unidade de medida no ERP	3	STRING	N	N	-	-	-
codigoCentroCusto	Código do centro de custo no PIMS	20	INTEGER	N	N	-	-	-
codigoCentroCustoERP	Código do centro de custo no ERP	15	STRING	N	N	-	-	-
codigoDepositoERP	Código do depósito do material no ERP	15	STRING	N	N	-	-	-
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'
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	-	-	Caso atributo origem = CS_MNFABAS, valor será resgatado a partir do parâmetro do Bioenergia: Seção: 'INT_ERP' / Entrada: 'CD_CTA_CTB_MNFABAS_APIHUB' Caso atributo origem = CS_MNFLUBR, valor será resgatado a partir do parâmetro do Bioenergia: Seção: 'INT_ERP' / Entrada: 'CD_CTA_CTB_MNFLUBR_APIHUB'

GET (Consulta alterações/deleções de Movimentos de Abastecimentos e Lubrificantes Automotivos para estorno no ERP)

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

Response

{
    "hasNext": false,
    "items": [
        {
            "id": "MNF99999900000012025",
            "origem": "CS_MNFABAS",
            "instancia": "11",
            "boletim": 338179,
            "sequencia": 1,
            "dataApontamento": "2025-06-01T03:00:00.000+00:00",
            "dataEnvio": "2025-06-24T03:00:00.000+00:00",
            "codigoMaterial": 295564,
            "codigoMaterialERP": "295564",
            "quantidade": 50,
            "unidadeMedida": "L",
            "unidadeMedidaERP": "L", 
            "codigoCentroCusto": 214042400,
            "codigoCentroCustoERP": "4.04.2.400",
            "codigoDepositoERP": "FREN1CCT",
            "usuario": "PIMSCS",
            "codigoEmpresaERP": "123",
            "codigoFilialERP": "456",
            "codigoContaContabilERP": null
        },
        {
            "id": "MNF00444000010022025",
            "origem": "CS_MNFLUBR",
            "instancia": "11",
            "boletim": 90000003,
            "sequencia": 1,
            "dataApontamento": "2025-06-20T03:00:00.000+00:00",
            "dataEnvio": "2025-06-24T03:00:00.000+00:00",
            "codigoMaterial": 201482,
            "codigoMaterialERP": "201482",
            "quantidade": 0.3,
            "unidadeMedida": "L", 
            "unidadeMedidaERP": "L",
            "codigoCentroCusto": 214042400,
            "codigoCentroCustoERP": "4.04.2.400",
            "codigoDepositoERP": null,
            "usuario": "PIMSCS",
            "codigoEmpresaERP": "123",
            "codigoFilialERP": "456",
            "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 (equipamento, 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').

Abastecimentos
- O material/combustível informado no apontamento deve estar cadastrado e deve estar classificado como exporta = 'S'.
- O grupo de material do material/combustível informado no apontamento deve estar cadastrado e deve estar classificado como exporta = 'S'.
- O ponto de abastecimento informado no apontamento deve estar cadastrado e deve estar classificado como exporta = 'S'.
- O centro de custo do equipamento informado no apontamento deve estar cadastrado.
- A quantidade informada no apontamento deve ser maior que zero.
Lubrificações
- O material/lubrificante informado no apontamento deve estar cadastrado e deve estar classificado como exporta = 'S'.
- O grupo de material do material/lubrificante informado no apontamento deve estar cadastrado e deve estar classificado como exporta = 'S'.
- O ponto de lubrificação informado no apontamento deve estar cadastrado e deve estar classificado como exporta = 'S'.
- O centro de custo do equipamento informado no apontamento deve estar cadastrado.
- A quantidade informada no apontamento deve ser maior que zero.

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

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

Estrutura de dados para envio:

Body

{
    "id": "MNF99999900000012025"
}

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 Baixa de Consumíveis.

Páginas filhas

API Estorno de Movimentos de Abastecimentos e Lubrificações Automotivas

Parâmetros