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

Versões comparadas

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

codigo

Código do Material Industrial

13

STRING

S

S

-

-

descricao

Descrição do Material Industrial

60

STRING

N

S

-

-

tipo

Tipo do Material Industrial

1

STRING

N

N

M

M = Material | S = Serviço

codigoEmpresa

Código da Empresa

2

INTEGER

N

N

Empresa padrão YML

-

descricaoDetalhada

Detalhamento do Material Industrial

2000

STRING

N

N

-

-

codigoAlmoxarifado

Código do Almoxarifado (Localização física)

10

STRING

N

N

-

-

descricaoAlmoxarifado

Descrição do Almoxarifado

40

STRING

N

N

-

-

codigoUnidadeMedida

Codigo da Unidade de Medida

8

STRING

N

N

-

-

familia

Família do Material Industrial

10

STRING

N

N

-

-

grupo

Grupo do Material Industrial

5

INTEGER

N

N

-

-

precoUltimaCompra

Preço Unit. Última Compra

13,4

NUMBER

N

N

-0

-

situacao

Situação do Material Industrial

1

STRING

N

N

1

1 = Ativo | 0 = Inativo

saldo

Saldo

15,4

NUMBER

N

N

-0

-

vidaUtil

Vida útil estimada (Meses)

4

INTEGER

N

N

-0

-

estocavel

Estocável

1

STRING

N

N

-

-

compra

Compra

1

STRING

N

N

-

-

integraERP

Integra ERP

1

STRING

N

N

1

1 = Sim | 0 = Não

precoMedioUnitario

Preço Médio Unitário

13,4

NUMBER

N

N

-0

-

ultimaAtualizacao

Data da última atualização

10

DATE

N

N

-

-

ultimaCompra

Data da última compra

10

DATE

N

N

-

-

localizacao

Localização do Material

10

STRING

N

N

-

-

categoria

Categoria

3

STRING

N

N

-

-

codigoERP

Código ERP

25

STRING

N

N

-

-

contaERP

Conta ERP

25

STRING

N

N

-

-

gestaoEstoque

Gestão de Estoque

1

INTEGER

N

N

-

-

...

Bloco de código
languagejava
titleResponse
{
    "hasNext": false,
    "items": [
        {
            "codigo": 1"ABC123",
            "descricaotipo": "TESTE MATERIALM",
            "codigoExternocodigoEmpresa": "1",
            "codigoContaErpdescricao": "1MATERIAL TESTE API-HUB",
            "codigoErpdescricaoDetalhada": "1"null,
            "codigoReferenciacodigoAlmoxarifado": "COD_REF"null,
            "codigoGrupoMaterialdescricaoAlmoxarifado": 2null,
            "codigoUnidadeMedida": "UN",
            "codigoUnidadeMedidaErpfamilia": null"1",
            "fatorConversaoUnidMedidaErpgrupo": null10,
            "exportaPalmprecoUltimaCompra": null0,
            "observacaoIntegracaosituacao": null"1",
            "materialComprasaldo": null0,
            "materialEstoquevidaUtil": null0,
            "materialServicoestocavel": null,
            "indisponibilidadePedOficinacompra": null,
            "materialAtivointegraERP": "S1",
            "classificacaoMaterialprecoMedioUnitario": 0,
   "M"         "ultimaAtualizacao": null,
            "fabricanteultimaCompra": null,
            "FABlocalizacao": null,
            "marcacategoria": null,
            "MARcodigoERP": null,
            "descricaoExternacontaERP": "TESTE MATERIAL"null,
            "rowversiongestaoEstoque": 1null
        }
    ]
}

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.


POST (Cadastra Material Industrial)

...

Bloco de código
languagejava
titleBody
collapsetrue
{
	"codigo": 1,
	"descricao": "TESTE MATERIAL",
	"codigoExterno": "1",
	"codigoContaErpcodigo": "1ABC123",
	"codigoErp": "1",
	"codigoReferencia": "COD_REF",
	"codigoGrupoMaterial": 2,
	"codigoUnidadeMedida": "UN",
	"codigoUnidadeMedidaErp"tipo": null,
	"fatorConversaoUnidMedidaErp": null,
	"exportaPalm": null,
	"observacaoIntegracao": null,
	"materialCompra": null,
	"materialEstoque": null,
	"materialServicocodigoEmpresa": null,
	"indisponibilidadePedOficina": null,
	"materialAtivo": "S",
	"classificacaoMaterial": "M",
	"fabricante": "FAB",
	"marca "descricao": "MAR",
	"descricaoExterna": "TESTE MATERIALMATERIAL TESTE API-HUB",
	"rowversion": null
}

Estrutura de dados retorno:

Bloco de código
languagejava
titleResponse
collapsetrue
{
    "codigodescricaoDetalhada": 1null,
    "descricaocodigoAlmoxarifado": "TESTE MATERIAL"null,
    "codigoExternodescricaoAlmoxarifado": "1"null,
    "codigoContaErpcodigoUnidadeMedida": "1UN",
    "codigoErpfamilia": "1",
    "codigoReferenciagrupo": "COD_REF"10,
    "codigoGrupoMaterialprecoUltimaCompra": 2null,
    "codigoUnidadeMedidasituacao": "UN"null,
    "codigoUnidadeMedidaErpsaldo": null,
    "fatorConversaoUnidMedidaErpvidaUtil": null,
    "exportaPalmestocavel": null,
    "observacaoIntegracaocompra": null,
    "materialCompraintegraERP": null,
    "materialEstoqueprecoMedioUnitario": null,
    "materialServicoultimaAtualizacao": null,
    "indisponibilidadePedOficinaultimaCompra": null,
    "materialAtivolocalizacao": "S"null,
    "classificacaoMaterialcategoria": "M"null,
    "fabricantecodigoERP": "FAB"null,
    "marcacontaERP": "MAR"null,
    "descricaoExternagestaoEstoque": "TESTE MATERIAL",
    "rowversion": 1
}

PUT (Atualiza Material Industrial)

...

null
}

Estrutura de dados para envioretorno:

Bloco de código
languagejava
titleBodyResponse
collapsetrue
{
    "codigo": 1,
    "descricao": "TESTE MATERIALABC123",
    "codigoExternotipo": "1M",
    "codigoContaErpcodigoEmpresa": "1",
    "codigoErpdescricao": "1",
MATERIAL    "codigoReferencia": "COD_REFTESTE API-HUB",
    "codigoGrupoMaterial": 2,
    "codigoUnidadeMedida": "UN",
    "codigoUnidadeMedidaErpdescricaoDetalhada": null,
    "fatorConversaoUnidMedidaErpcodigoAlmoxarifado": null,
    "exportaPalmdescricaoAlmoxarifado": null,
    "observacaoIntegracaocodigoUnidadeMedida": null,
    "materialCompra": null"UN",
    "materialEstoquefamilia": null1,
    "materialServicogrupo": null10,
    "indisponibilidadePedOficinaprecoUltimaCompra": null0,
    "materialAtivosituacao": "S1",
    "classificacaoMaterialsaldo": "M"0,
    "fabricantevidaUtil": "FAB"0,
    "marcaestocavel": "MAR"null,
    "descricaoExternacompra": "TESTE MATERIAL"
}

Estrutura de dados retorno:

Bloco de código
languagejava
titleResponse
collapsetrue
{
    "codigo": 1null,
    "descricaointegraERP": "TESTE MATERIAL",
    "codigoExterno": "1",
    "codigoContaErpprecoMedioUnitario": "1"0,
    "codigoErpultimaAtualizacao": "1"null,
    "codigoReferenciaultimaCompra": "COD_REF"null,
    "codigoGrupoMaterial": 2,
    "codigoUnidadeMedidalocalizacao": "UN",
    "codigoUnidadeMedidaErp": null,
    "fatorConversaoUnidMedidaErpcategoria": null,
    "exportaPalmcodigoERP": null,
    "observacaoIntegracaocontaERP": null,
    "materialCompragestaoEstoque": null,
    "materialEstoque": null,
    "materialServico": null,
    "indisponibilidadePedOficina": null,
}


PUT/PATCH (Atualiza Material Industrial)

http:127.0.0.1:8080/entity/v1/materiaisInd

Estrutura de dados para envio:

Bloco de código
languagejava
titleBody
collapsetrue
{
    "materialAtivocodigo": "SABC123",
    "classificacaoMaterialsaldo": "M",
    "fabricante": "FAB"50
}

Estrutura de dados retorno:

Bloco de código
languagejava
titleResponse
collapsetrue
{,
    "marcacodigo": "MARABC123",
    "descricaoExternasaldo": "TESTE MATERIAL"50
}

Observações

  • Quando PATCH poderão ser enviados apenas os atributos que necessitam de atualização e os atributos que compõe a chave primária.
  • No caso de PUT deverão ser enviados os atributos necessários/obrigatórios.


DELETE (Apaga Material Industrial)

http:127.0.0.1:8080/entity/v1/materiaisInd

Observações-

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