Páginas filhas
  • API Movimentos de Abastecimentos e Lubrificações Automotivas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Número da ordem de serviçoCOD_UNMED_ERP1

Atributos

Descrição

Tamanho

Tipo

Chave Primária

Requerido

Valor Default

Valores Válidos

Observação

ID_RATREARid

Id único para rastreamento do registro de ponta a ponta

20

STRING

S (lógica)

S

-

-

Gerado automaticamente quando o registro é inserido na tabela

ORIGEMorigem

Origem do registro

10

STRING

N

N

Abastecimento: CS_MNFABAS

Lubrificação: CS_MNFLUBRMI_MANLUBR

-

-

INSTANCIAinstancia

Código da instância

5

STRING

N

N

-

-

Instância vinculada com a tabela de empresa.

-

boletimNO_BOLETIM

Número do boletim

1210

INTEGER

N

N

-

-

-

NO_SEQsequencia

Sequência

13

INTEGER

N

N

1

-

-

NO_OS

7

INTEGER

N

N

-

-

-

dataApontamento

Data do apontamento

DATA_MOVTO

Data da lubrificação

10

DATE

N

N

-

-

-

DATA_ENVIOdataEnvio

Data da coleta do registro

10

DATE

N

N

TRUNC(SYSDATE)

-

-

COD_MATERIAL_PIMScodigoMaterial

Código do lubrificante material no PIMS

1312

STRINGINTEGER

N

N

-

-

-

COD_MATERIAL_ERPcodigoMaterialERP

Código do lubrificante material no ERP

1325

STRING

N

N

-

-

-

QUANTIDADEquantidade

Quantidade

8,43

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

-

-

-

COD_CCUSTO_PIMScodigoCentroCusto

Código do centro de custo no PIMS

20

STRINGINTEGER

N

N

-

-

-

COD_CCUSTO_ERPcodigoCentroCustoERP

Código do centro de custo no ERP

2015

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

-

codigoDepositoERPCOD_DEP_ERP

Código do depósito do lubrificante material no ERP

25015

STRING

N

N

-

-

Resgatado a partir do parâmetro do BioEnergia

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

-

usuario

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 BioEnergiaBioenergia

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

COD_EMPRESA_ERPcodigoEmpresaERP

Código da empresa no ERP

250

STRING

N

N

-

-

Resgatado a partir do parâmetro do BioEnergiaBioenergia

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

COD_FILIAL_ERPcodigoFilialERP

Código da filial no ERP

250

STRING

N

N

-

-

Resgatado a partir do parâmetro do BioEnergiaBioenergia

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

STATUS_INT_ERP

Status da integração com o ERP

codigoContaContabilERP

Código da conta contábil no ERP

2501

STRING

N

N

-

Null = Indisponível para integração

0 = Disponível para integração

1 = Integrado com sucesso

2 = Cancelado antes da integração

-

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: 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 Abastecimentos e Lubrificantes Automotivos consumidos para baixa no ERP)

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

Bloco de código
languagejava
titleResponse
{
    "hasNext": true,
    "items": [
        {
            "ID_RASTREARid": "MNI99999000000572025MNF00038000005312024",
            "ORIGEMorigem": "MICS_MANLUBRMNFABAS",
            "INSTANCIAinstancia": "PRX11",
            "NO_BOLETIMboletim": 6672338117,
            "NO_SEQsequencia": 1,
            "NO_OSdataApontamento": 286159,
            "DATA_MOVTO": "2019-07-17T03"2024-05-15T03:00:00.000+00:00",
            "DATA_ENVIOdataEnvio": "2025-06-09T0318T03:00:00.000+00:00",
            "COD_MATERIAL_PIMScodigoMaterial": 47767214687,
            "COD_MATERIAL_ERPcodigoMaterialERP": "47767214687",
            "QUANTIDADEquantidade": 1130.6,
            "unidadeMedida": "COD_UNMED_ERP"L",
            "unidadeMedidaERP": "LTL",
            "COD_CCUSTO_PIMScodigoCentroCusto": "70"114035150,
            "COD_CCUSTO_ERPcodigoCentroCustoERP": "704.03.5.150",
            "COD_DEP_ERPcodigoDepositoERP": null"EAM-FPOSTO",
            "USUARIOusuario": "PIMSCS",
            "COD_EMPRESA_ERPcodigoEmpresaERP": "123",
            "COD_FILIAL_ERPcodigoFilialERP": null"456",
        },
        {"codigoContaContabilERP": null
        },
       "ID_RASTREAR": "MNI99999000000712025", {
            "ORIGEMid": "MI_MANLUBRMNF00038000005362024",
            "INSTANCIAorigem": "PRXCS_MNFABAS",
            "NO_BOLETIMinstancia": 9876"11",
            "NO_SEQboletim": 1338117,
            "NO_OSsequencia": 4013016,
            "DATA_MOVTOdataApontamento": "20202024-0105-25T0315T03:00:00.000+00:00",
            "DATA_ENVIOdataEnvio": "2025-06-09T0318T03:00:00.000+00:00",
            "COD_MATERIAL_PIMScodigoMaterial": 47627422286,
            "COD_MATERIAL_ERPcodigoMaterialERP": "47627422286",
            "QUANTIDADEquantidade": 040.53,
            "COD_UNMED_ERPunidadeMedida": "KGL",
            "COD_CCUSTO_PIMS": "60"unidadeMedidaERP": "L",
            "codigoCentroCusto": 114035150,
            "COD_CCUSTO_ERPcodigoCentroCustoERP": "604.03.5.150",
            "COD_DEP_ERPcodigoDepositoERP": null"EAM-FPOSTO",
            "USUARIOusuario": "PIMSCS",
            "COD_EMPRESA_ERPcodigoEmpresaERP": "123",
            "COD_FILIAL_ERPcodigoFilialERP": null
       "456",
            "codigoContaContabilERP": null
        }
    ]
}

Parâmetros

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

Observações

  • Abastecimentos
    • O material/
    lubrificante
    • 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
    não pode
    • deve estar
    definido como reutilização.A empresa informada
    • classificado como exporta = 'S'.
    • O ponto de abastecimento informado no apontamento deve estar
    cadastrada
    • cadastrado e deve estar classificado como exporta = 'S'.
    • O centro de custo do equipamento informado no apontamento deve estar cadastrado.
    • A
    ordem de serviço
    • quantidade informada no apontamento deve
    estar cadastrada, deve ser do tipo PRP e deve estar finalizada
    • 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
    real
    • 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 a integração foi realizada)

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

...

Bloco de código
languagejava
titleBody
collapsetrue
{
    "ID_RASTREARid": "MNF00460000005142024"
}

Observações

  • Deverá ser enviado o ID_RASTREAR id referente ao registro que foi baixado para que o sistema atualize o STATUS_INT_ERP = '1'status. Com isso, o registro não estará mais disponível em novas consultas GET.

...