Histórico da Página

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

Estrutura:

Número da ordem de serviço5

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

Abastecimento: CS_MNFABAS

Lubrificação: CS_MNFLUBR

-

instancia

Código da instância

5

STRING

N

-

boletim

Número do boletim

10

INTEGER

N

-

sequencia

Sequência

3

INTEGER

N

-

ordemServico

7

INTEGER

N

Null

-

Não envia.

dataApontamento

Data do apontamento

10

DATE

N

-

dataEnvio

Data da coleta do registro

10

DATE

N

TRUNC(SYSDATE)

-

codigoMaterial

Código do material no PIMS

12

INTEGER

N

-

codigoMaterialERP

Código do material no ERP

25

STRING

N

-

quantidade

Quantidade

128,3

NUMBER

N

-

unidadeMedida

Código da unidade de medida no PIMS

3

STRING

N

-

unidadeMedidaERP

Código da unidade de medida no ERP

3

STRING

N

-

centroCustocodigoCentroCusto

Código do centro de custo no PIMS

20

INTEGER

N

-

centroCustoERPcodigoCentroCustoERP

Código do centro de custo no ERP

2015

INTEGERSTRING

N

-

codigoDepositoERP

Código do depósito do material no ERP

15

STRING

N

-

usuario

Usuário responsável pelo apontamento

250

STRING

N

-

Caso o usuário não esteja preenchido no apontamento:

Resgatado a partir do parâmetro do BioEnergiaBioenergia

Seção: 'INT_ERP' / Entrada: 'CD_REQUISITANTE_MNF'

codigoEmpresaERP

Código da empresa no ERP

250

STRING

N

-

Resgatado a partir do parâmetro do BioEnergiaBioenergia

Seção: 'INT_ERP' / Entrada: 'EMPRESA_ERP'

codigoFilialERP

Código da filial no ERP

250

STRING

N

-

Resgatado a partir do parâmetro do BioEnergiaBioenergia

Seção: 'INT_ERP' / Entrada: 'FILIAL_ERP'

codigoContaContabilERP

Código da conta contábil no ERP

250

STRING

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 Estornos alterações/deleções de Movimentos de Abastecimentos e Lubrificantes Automotivos consumidos para baixa estorno no ERP)

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

Bloco de código

language	java
title	Response

{
    "hasNext": false,
    "items": [
        {
            "id": "MNF99999900000012025",
            "origem": "CS_MNFABAS",
            "instancia": "11",
            "boletim": 338179,
            "sequencia": 1,
            "ordemServico": null,
            "dataApontamento": "2025-06-01T03:00:00.000+00:00",
            "dataEnvio": "2025-06-24T03:00:00.000+00:00",
            "codigoMaterial": 295564,
            "codigoMaterialERP": "295564",
            "quantidade": 50,
            "unidadeMedidaERPunidadeMedida": "L",
            "centroCustounidadeMedidaERP": "L", 
            "codigoCentroCusto": 214042400,
            "centroCustoERPcodigoCentroCustoERP": "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,
            "ordemServico": null,
            "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",
            "centroCustocodigoCentroCusto": 214042400,
            "centroCustoERPcodigoCentroCustoERP": "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 para ser estornado(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.
- Serão considerados apenas apontamentos desbloqueados.
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.Serão considerados apenas movimentos de troca e/ou remonta, desconsiderando movimentos de limpeza.

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

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

...

Páginas filhas

Versões comparadas

Versão antiga 2

Nova versão Atual

Chave

Parâmetros