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

S

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

{
    "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

Observações

- 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

Estrutura de dados para envio:

{
    "material": "22942",
    "empresa": 1,
    "almoxarifado": "99",
    "descricaoAlmoxarifado": "Central",
    "saldo": 10,
    "ultimaAtualizacao": "2025-01-01T00:00:00",
    "ultimaCompra": "2024-12-10T00:00:00",
    "valorUnitarioMedio": 0.001,
    "valorUnitarioReposicao": 46.3,
    "estocavel": "S",
    "compra": "N"
}

Estrutura de dados retorno:

{
    "material": "22942",
    "empresa": 1,
    "almoxarifado": "99",
    "descricaoAlmoxarifado": "Central",
    "saldo": 10,
    "ultimaAtualizacao": "2025-01-01T00:00:00",
    "ultimaCompra": "2024-12-10T00:00:00",
    "valorUnitarioMedio": 0.001,
    "valorUnitarioReposicao": 46.3,
    "estocavel": "S",
    "compra": "N",
    "id": "29822"
}

- É 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

Estrutura de dados para envio:

{
    "id": "29822",
    "material": "22942",
    "empresa": 1,
    "almoxarifado": "99",
    "descricaoAlmoxarifado": "Central",
    "saldo": 9,
    "ultimaAtualizacao": "2025-01-01T00:00:00",
    "ultimaCompra": "2024-12-10T00:00:00",
    "valorUnitarioMedio": 0.001,
    "valorUnitarioReposicao": 46.3,
    "estocavel": "S",
    "compra": "N"    
}

Estrutura de dados retorno:

{
    "id": "29822",
    "material": "22942",
    "empresa": 1,
    "almoxarifado": "99",
    "descricaoAlmoxarifado": "Central",
    "saldo": 9,
    "ultimaAtualizacao": "2025-01-01T00:00:00",
    "ultimaCompra": "2024-12-10T00:00:00",
    "valorUnitarioMedio": 0.001,
    "valorUnitarioReposicao": 46.3,
    "estocavel": "S",
    "compra": "N"
}

- É 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=29822

Observações

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