TOTVS AGRO

Páginas filhas
  • API Movimentos de Lubrificações (Manutenção Industrial)

 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

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 Lubrificantes consumidos para baixa no ERP)

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

Response
{
    "hasNext": true,
    "items": [
        {
            "id": "MNI99999000000572025",
            "origem": "MI_MANLUBR",
            "instancia": "PRX",
            "boletim": 6672,
            "ordemServico": 286159,
            "dataApontamento": "2019-07-17T03:00:00.000+00:00",
            "dataEnvio": "2025-06-18T03:00:00.000+00:00",
            "codigoMaterial": "47767",
            "codigoMaterialERP": "47767",
            "quantidade": 1,
            "unidadeMedida": "LT",
            "codigoCentroCusto": "70",
            "codigoDepositoERP": null,
            "usuario": "PIMSCS",
            "codigoEmpresaERP": "123",
            "codigoFilialERP": "456",
            "codigoContaContabilERP": null
        },
        {
            "id": "MNI99999000000712025",
            "origem": "MI_MANLUBR",
            "instancia": "PRX",
            "boletim": 9876,
            "ordemServico": 401301,
            "dataApontamento": "2020-01-25T03:00:00.000+00:00",
            "dataEnvio": "2025-06-18T03:00:00.000+00:00",
            "codigoMaterial": "47627",
            "codigoMaterialERP": "47627",
            "quantidade": 0.5,
            "unidadeMedida": "KG",
            "codigoCentroCusto": "60",
            "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

  • O material/lubrificante informado no apontamento deve estar cadastrado e não pode estar definido como reutilização.
  • A empresa informada no apontamento deve estar cadastrada.
  • O centro de custo informado no apontamento deve estar cadastrado.
  • 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.


PUT (Atualiza STATUS_INT_ERP para 1 indicando que a integração foi realizada)

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

Estrutura de dados para envio:

Body 
{
    "id": "MNI99999000000092025"
}

Observações

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