TOTVS AGRO

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

Versões comparadas

Versão antiga 1

changes.mady.by.user Raul Goulart Rodrigues

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Raul Goulart Rodrigues

Gravado em

Chave

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

...

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

MI_MANLUBR

-

-

INSTANCIAinstancia

Código da instância

5

STRING

N

N

-

-

Instância vinculada com a tabela de empresa.

NO_BOLETIMboletim

Número do boletim

12

INTEGER

N

N

-

-

-

NO_SEQ

Sequência

1

INTEGER

N

N

1

-

-

ordemServico

NO_OS

Número da ordem de serviço

7

INTEGER

N

N

-

-

-

DATA_MOVTOdataApontamento

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 no PIMS

13

STRING

N

N

-

-

-

COD_MATERIAL_ERPcodigoMaterialERP

Código do lubrificante no ERP

1325

STRING

N

N

-

-

-

QUANTIDADEquantidade

Quantidade

8,4

NUMBER

N

N

-

-

-

COD_UNMED_ERPunidadeMedida

Código da unidade de medida no ERP

18

STRING

N

N

-

-

-

COD_CCUSTO_PIMScodigoCentroCusto

Código do centro de custo no PIMS

20

STRING

N

N

-

-

-

COD_CCUSTO_ERPcodigoDepositoERP

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 BioEnergiaBioenergia

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

USUARIOusuario

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_MNFMI'

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

SN

-

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.

-

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

http:127.0.0.1:8080/entityapi/query/v1/materialEmpresabaixaConsumiveisIndustriaisMativ?page=1&pagesize=12

Bloco de código
languagejava
titleResponse
{
    "hasNext": true,
    "items": [
        {
            "id": 1"MNI99999000000572025",
            "materialorigem": 207052"MI_MANLUBR",
            "instancia": "11PRX",
            "depositoboletim": "VIRTBORR01"6672,
            "saldoordemServico": 25286159,
            "ultimaAtualizacaodataApontamento": "20232019-0807-03T0017T03:00:00.000+00:00",
            "ultimaCompradataEnvio": "20242025-0106-01T0018T03:00:00.000+00:00",
            "valorUnitarioMediocodigoMaterial": 10.25"47767",
            "valorUnitarioReposicaocodigoMaterialERP": 11.25"47767",
            "estocavelquantidade": "N"1,
            "compraunidadeMedida": "SLT",
            "contacodigoCentroCusto": "123.456.78970",
        }
    ]
}

Parâmetros

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

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:

Bloco de código
languagejava
titleBody
collapsetrue
{
    "material": 1000,
"codigoDepositoERP": null,
            "instanciausuario": "11PIMSCS",
            "depositocodigoEmpresaERP": "VIRTBORR01123",
    "saldo": 50,
        "ultimaAtualizacaocodigoFilialERP": "2023-08-30T00:00:00456",
     "ultimaCompra": "2024-01-02T00:00:00",
       "valorUnitarioMediocodigoContaContabilERP": 5.5,null
       "valorUnitarioReposicao": 6.5 },
       "estocavel": "S",
 {
       "compra": "N",
    "contaid": "987.654.321MNI99999000000712025"
}

Estrutura de dados retorno:

Bloco de código
languagejava
titleResponse
collapsetrue
{
,
       "material": 1000,
    "instanciaorigem": "11MI_MANLUBR",
    "deposito": "VIRTBORR01",
    "saldo": 50,
    "ultimaAtualizacaoinstancia": "2023-08-30T00:00:00PRX",
       "ultimaCompra": "2024-01-02T00:00:00",
    "valorUnitarioMedioboletim": 5.59876,
      "valorUnitarioReposicao": 6.5,
      "estocavelordemServico": "S"401301,
    "compra": "N",
        "contadataApontamento": "987.654.3212020-01-25T03:00:00.000+00:00",
            "iddataEnvio": "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:

Bloco de código
languagejava
titleBody
collapsetrue
{
    "id": 26,
    "material": 1000,
2025-06-18T03:00:00.000+00:00",
            "instanciacodigoMaterial": "1147627",
    "deposito": "VIRTBORR01",
    "saldo": 49,
    "ultimaAtualizacaocodigoMaterialERP": "2023-08-30T00:00:0047627",
       "ultimaCompra": "2024-01-02T00:00:00",
    "valorUnitarioMedioquantidade": 50.5,
     "valorUnitarioReposicao": 6.5,
       "estocavelunidadeMedida": "SKG",
    "compra": "N",
        "contacodigoCentroCusto": "987.654.32160"
}

Estrutura de dados retorno:

Bloco de código
languagejava
titleResponse
collapsetrue
{
,
       "id": 26,
    "materialcodigoDepositoERP": 1000null,
       "instancia": "11",
    "depositousuario": "VIRTBORR01PIMSCS",
    "saldo": 49,
        "ultimaAtualizacaocodigoEmpresaERP": "2023-08-30T00:00:00123",
            "ultimaCompracodigoFilialERP": "2024-01-02T00:00:00456",
    "valorUnitarioMedio": 5.5,
    "valorUnitarioReposicao": 6.5,
    "estocavelcodigoContaContabilERP": "S",null
      "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.

]
}

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

http:127.0.0.1:8080/entityapi/query/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.

...

baixaConsumiveisIndustriaisMativ

Estrutura de dados para envio:

Bloco de código
languagejava
titleBody
collapsetrue
{
    "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

...

  • .