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 Material por Empresa)

http:127.0.0.1:8080/entity/v1/materialEmpresa?page=1&pagesize=1

{
    "hasNext": true,
    "items": [
        {
            "id": 1,
            "material": 207052,
            "instancia": "11",
            "deposito": "VIRTBORR01",
            "saldo": 25,
            "ultimaAtualizacao": "2023-08-03T00:00:00",
            "ultimaCompra": "2024-01-01T00:00:00",
            "valorUnitarioMedio": 10.25,
            "valorUnitarioReposicao": 11.25,
            "estocavel": "N",
            "compra": "S",
            "conta": "123.456.789"
        }
    ]
}

Parâmetros

Observações

- Todos os atributos podem ser usados como parâmetro para a busca.

- Caso seja informado o codigoExterno, será usado como parâmetro, para a busca, a instancia referente a ele no Bioenergia. Essa informação sobrepõe a instancia caso ela seja informada.


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.