Páginas filhas
  • API Materiais por Empresas (Manutenção Industrial)

Versões comparadas

Chave

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

 Disponibilizado endpoint para integração do cadastro de Materiais Industriais por Empresas com os métodos GET, POST, PUT, PATCH e DELETE.


Estrutura:

Atributos

Descrição

Tamanho

Tipo

Chave Primária

Requerido

Valor Default

Valores Válidos

Observação

id

Id

12

INTEGER

SS

N

-

-

Gerado automaticamente no Insert, obrigatório no Update

material

Código do material

13

STRING

N

S

-

Material cadastrado

-

empresa

Código da empresa

2

INTEGER

N

S

-

Empresa cadastrada

-

almoxarifado

Código do almoxarifado

10

STRING

N

N

-

-

-

descricaoAlmoxarifado

Descrição do almoxarifado

40

STRING

N

N

-

-


saldo

Saldo do material

15,4

NUMBER

N

N

-

-

-

ultimaAtualizacao

Data da última atualização

10

DATE

N

N

-

-

-

ultimaCompra

Data da última compra

10

DATE

N

N

-

-

-

valorUnitarioMedio

Valor unitário médio

13,4

NUMBER

N

N

-

-

-

valorUnitarioReposicao

Valor unitário reposição

13,4

NUMBER

N

N

-

-

-

estocavel

Estocável

1

STRING

N

N

-

-

-

compra

Compra

1

STRING

N

N

-

-

-

codigoMaterialERP

Código do material vindo do ERP

20

STRING

N

N

-

-

-


GET (Consulta Material Industrial por Empresa)

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

Bloco de código
languagejava
titleResponse
{
    "hasNext": true,
    "items": [
        {
            "id": 1,
            "material": "22535",
            "empresa": 1,
            "almoxarifado": "99",
            "descricaoAlmoxarifado": "Central",
            "saldo": 25,
            "ultimaAtualizacao": "2002-11-08T00:00:00",
            "ultimaCompra": "2002-11-08T00:00:00",
            "valorUnitarioMedio": 0.001,
            "valorUnitarioReposicao": 46.3,
            "estocavel": "S",
            "compra": "N"
        }
    ]
}

Parâmetros

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

...

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


POST (Cadastra Material Industrial por Empresa)

http:127.0.0.1:8080/api/entity/v1/materialEmpresaInd

...

Bloco de código
languagejava
titleBody
collapsetrue
{
    "material": 1000"22942",
    "empresa": 1,
    "instanciaalmoxarifado": "1199",
    "depositodescricaoAlmoxarifado": "VIRTBORR01Central",
    "saldo": 5010,
    "ultimaAtualizacao": "20232025-0801-30T0001T00:00:00",
    "ultimaCompra": "2024-0112-02T0010T00:00:00",
    "valorUnitarioMedio": 50.5001,
    "valorUnitarioReposicao": 646.53,
    "estocavel": "S",
    "compra": "N",
    "conta": "987.654.321"
}

Estrutura de dados retorno:

Bloco de código
languagejava
titleResponse
collapsetrue
{
    "material": "22942",
    "empresa": 10001,
    "instanciaalmoxarifado": "1199",
    "depositodescricaoAlmoxarifado": "VIRTBORR01Central",
    "saldo": 5010,
    "ultimaAtualizacao": "20232025-0801-30T0001T00:00:00",
    "ultimaCompra": "2024-0112-02T0010T00:00:00",
    "valorUnitarioMedio": 50.5001,
    "valorUnitarioReposicao": 646.53,
    "estocavel": "S",
    "compra": "N",
    "conta": "987.654.321",
    "id": "2629822"
}

- É obrigatório informar ou o atributo material ou o atributo codigoMaterialERP, ambos serão validados contra a tabela MCPMATERIAL para verificação de sua existência.

- Será realizada validação para verificar se o registro já não é existente na base, caso sim o mesmo será atualizado, caso não, o mesmo será inserido.

PUT e PATCH (Atualiza Material Industrial por Empresa)

http:127.0.0.1:8080/api/entity/v1/materialEmpresaInd

...

Bloco de código
languagejava
titleBody
collapsetrue
{
    "id": 26"29822",
    "material": 1000"22942",
    "empresa": 1,
    "instanciaalmoxarifado": "1199",
    "depositodescricaoAlmoxarifado": "VIRTBORR01Central",
    "saldo": 509,
    "ultimaAtualizacao": "20232025-0801-30T0001T00:00:00",
    "ultimaCompra": "2024-0112-02T0010T00:00:00",
    "valorUnitarioMedio": 50.5001,
    "valorUnitarioReposicao": 646.53,
    "estocavel": "S",
    "compra": "N",
    "conta": "987.654.321"
}

Estrutura de dados retorno:

Bloco de código
languagejava
titleResponse
collapsetrue
{
    "id": 26"29822",
    "material": "22942",
    "empresa": 10001,
    "instanciaalmoxarifado": "1199",
    "depositodescricaoAlmoxarifado": "VIRTBORR01Central",
    "saldo": 509,
    "ultimaAtualizacao": "20232025-0801-30T0001T00:00:00",
    "ultimaCompra": "2024-0112-02T0010T00:00:00",
    "valorUnitarioMedio": 50.5001,
    "valorUnitarioReposicao": 646.53,
    "estocavel": "S",
    "compra": "N",
    "conta": "987.654.321"
}
}

- É obrigatório informar ou o atributo material ou o atributo codigoMaterialERP, ambos serão validados contra a tabela MCPMATERIAL para verificação de sua existência.

- Será realizada validação para verificar se o registro já não é existente na base, caso sim o mesmo será atualizado, caso não, o mesmo será inserido.

DELETE (Apaga Material por Empresa)

http:127.0.0.1:8080/api/entity/v1/materialEmpresaInd?id=2629822

Observações

- É obrigatório informar os atributos que compõem a chave primária como parâmetros da chamada.

...