Histórico da Página

Tempo aproximado para leitura: 10 min

Objetivo

Método que permite inserir/atualizar o produto.

Chamada

POST api/v1/importacao/produto

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Não há.

Parâmetros do Corpo (Body Parameters)

*Campos Obrigatórios

Validações Logísticas

As validações logísticas, não impactam no retorno da requisição. Entretanto, para a correta importação do produto, os critérios listados abaixo devem ser atendidos. Caso contrário, será gerada uma crítica logística**, e o registro ficará pendente de verificação por um usuário. 

1. O Tipo de Endereço (CodTipEndereco) deverá estar cadastrado previamente no Cadastro de Tipos de Endereco (WMS Parâmetros → Cadastro → Endereço → Tipos de Endereços);
2. O Tipo da Separação (TipSeparacao) deverá estar cadastrado previamente no Cadastro de Atributos Fixos, na opção Tipo de Atributo: Tipo de Separação (WMS Parâmetros → Cadastro → Atributos Fixos);
3. O Tipo da Armazenagem (TipArmazenagem) deverá estar cadastrado previamente no Cadastro de Atributos Fixos, na opção Tipo de Atributo: Tipo de Armazenagem (WMS Parâmetros → Cadastro → Atributos Fixos);
4. O Fornecedor (SeqFornecedor) deverá estar cadastrado previamente no sistema;
5. O Produto Base (SeqProdutoBase) não poderá estar relacionado a outro produto;
6. O Produto Base (SeqProdutoBase) não poderá ter a propriedade Pesável diferente do produto relacionado.

_{**As críticas logísticas podem ser visualizadas através da aplicação: WMS Centro de Distribuição -> Gerencial -> Consultas -> Exclusão de Rejeições da Importação Automática.}

Formatos de Request (Request Formats)

application/json, text/json

{
   "seqProduto": 11,
  "nroEmpresa": 100,  
  "seqFornecedor": 752,
  "tipCodigo": "I",
  "codTipEndereco": "N",
  "descCompleta": "Teste descriçao completa",
  "descReduzida": "Teste reduzida",
  "statusCompra": "A",
  "statusVenda": "A",  
  "tipArmazenagem": "N",
  "tipSeparacao": "N",
  "pzoValidadeDia": 100,
  "pesavel": "N",
  "emtEtiqueta": "N",
  "indProcFabricacao": "S",
  "medVDiaGeral": 1500.000000,
  "ExgNroLoteexgNroLote" : "N",
  "AdvArmazenagemseqProdutoBase": 1,
  "advArmazenagem": "Teste Advertencia",
  "RefFabricanterefFabricante" : "Teste Ref.Fabricante",
  "ExgNroSerieexgNroSerie" : "N",
  "QtdTolArmazProdqtdTolArmazProd" : 1,
  "Referenciareferencia" : "Teste Referencia",
  "UtzEstrutDriveInutzEstrutDriveIn" : "N",
  "ExgCertificadoexgCertificado" : "N",
  "IndAltoRiscoindAltoRisco" : "N",
  "IndExgValidacaoMontagemPaleteindExgValidacaoMontagemPalete" : "N",
  "QtdVolGeraEtqMasterqtdVolGeraEtqMaster" : null,
  "SeqFamiliaseqFamilia" : null,
  "IndControlaTemperaturaindControlaTemperatura" : "N",
  "IndControlaRastreabilidadeindControlaRastreabilidade" : "SN",
  "QtdDiasControleQuarentenaqtdDiasControleQuarentena" : 1,
  "UsuarioAlteracaousuarioAlteracao" : "CONSINCO"
}

Informações para Resposta (Response Information)

Códigos do Recurso (Response Codes)

• OK (201)
• BadRequest (400)

Requisições para adicionar as informações complementares do Produto:

,
  "embalagensProduto": [
    {        
	  "qtdEmbalagem": 1,
  	  "embalagem": "UN",
  	  "statusEmbalagem": "A",
  	  "indMiudezaGrandeza": "M",  
  	  "indEmbalado": "S",
  	  "codTara": "1",
  	  "pesoBruto": 1.5,
  	  "pesoLiquido": 1.25,
  	  "altura": 50.12,
  	  "largura": 25.0,
  	  "profundidade": 25.0,
  	  "pesoMedio": 1.5,
	  "indPadraoEmbCompra": "S",
  	  "indPadraoEmbVenda": "N"       
	}
  ],
  "codigosBarrasProduto": [
    {       
	  "qtdEmbalagem": 1.0,
      "codAcesso": "1234567890",
      "tipCodigo": "B"     
	}
  ],
  "especiesEnderecoProduto": [
    {         
	  "qtdEmbalagem": 12,
      "especieEndereco": "A",
      "paleteLastro": 10,
      "paleteAltura": 1,
      "estqMinimoRep": 10      
	}
  ]
  "categoriaProduto": {
    "nroDivisao": 1,
    "seqCategoria": 102
  },
  "componentesProdutoComposto": [
    {
  	  "seqProdComponente": 12987,
  	  "qtdEmbalagem": 1,
  	  "quantidade": 15
    }
  ]
}

Informações para Resposta (Response Information)

Códigos do Recurso (Response Codes)

1. OK (201)
2. BadRequest (400)

Requisições para adicionar as informações complementares do Produto:

Adicionar Embalagem do Produto - POST

Objetivo

Método que permite inserir/atualizar as embalagens dos produtos. Podem ser enviadas várias embalagens, de compra ou de venda, para um mesmo produto, sendo exigido pelo menos uma de cada tipo.

Chamada

POST api/v1/importacao/produto/embalagem

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Não há.

Parâmetros do Corpo (Body Parameters)

*Campos Obrigatórios
**Campos Obrigatórios caso o parâmetro dinâmico CRITICA_PRODUTO_INFO_FISICA tenha o valor "S - Sim". Pode ser verificado em: WMS Parâmetros → Parâmetro → Dinâmico.

Validações Logísticas

As validações logísticas, não impactam no retorno da requisição. Entretanto, para a correta importação da embalagem, os critérios listados abaixo devem ser atendidos. Caso contrário, será gerada uma crítica logística***, e o registro ficará pendente de verificação por um usuário. 

1. O Produto (SeqProduto) deverá estar cadastrada previamente para a empresa (NroEmpresa) informada;
2. A Empresa (NroEmpresa) deverá estar cadastrada previamente no Cadastro de Depositantes (WMS Parâmetros → Cadastro → Depositante);
3. O Códiga da Tara (CodTara), quando informado, deverá estar cadastrado previamente no Cadastro de Tara Balança (WMS Parâmetros → Cadastro → Produtos → Tara Balança).

_{***As críticas logísticas podem ser visualizadas através da aplicação: WMS Centro de Distribuição -> Gerencial -> Consultas -> Exclusão de Rejeições da Importação Automática.}

Formatos de Request (Request Formats)

application/json, text/json

POST api/v1/importacao/produto/embalagem

[
  {
  	"seqProduto": 1,
    "nroEmpresa": 1,
  	"qtdEmbalagem": 1,
  	"embalagem": "UN",
  	"statusEmbalagem": "A",
  	"indMiudezaGrandeza": "M",  
  	"indEmbalado": "S",
  	"codTara": "1",
  	"pesoBruto": 1.5,
  	"pesoLiquido": 1.25,
  	"altura": 50.12,
  	"largura": 25.0,
  	"profundidade": 25.0,
  	"pesoMedio": 1.5,
	"indPadraoEmbCompra": "S",
  	"indPadraoEmbVenda": "N" 
  }
]

POST api/v1/importacao/produto/codigobarras

[
  {
    "seqProduto": 1,
    "nroEmpresa": 1,
    "qtdEmbalagem": 1.0,
    "codAcesso": "1234567890",
    "tipCodigo": "B"
  }
]

POST api/v1/importacao/produto/especieendereco

[
  {
    "seqProduto": 1,
    "nroEmpresa": 1,
    "qtdEmbalagem": 12,
    "especieEndereco": "A",
    "paleteLastro": 10,
    "paleteAltura": 1,
    "estqMinimoRep": 10
  }
]

POST /api/v1/importacao/produto/categoriaproduto

{
   "seqProduto": 407640,
   "nroEmpresa": 100,
   "nroDivisao": 1,
   "seqCategoria": 102
}

POST /api/v1/importacao/produto/componenteprodutocomposto

[
  {
  	"seqProdFinal": 120612,
  	"seqProdComponente": 12987,
  	"nroEmpresa": 100,
  	"qtdEmbalagem": 1,
  	"quantidade": 15
  }
]

[
  {
  	"seqProduto": 1,
    "nroEmpresa": 1,
  	"qtdEmbalagem": 1,
  	"embalagem": "UN",
  	"statusEmbalagem": "A",
  	"indMiudezaGrandeza": "M",  
  	"indEmbalado": "S",
  	"codTara": "1",
  	"pesoBruto": 1.5,
  	"pesoLiquido": 1.25,
  	"altura": 50.12,
  	"largura": 25.0,
  	"profundidade": 25.0,
  	"pesoMedio": 1.5,
  	"indPadraoEmbCompra": "S",
  	"indPadraoEmbVenda": "N" 
  }
]

Informações para Resposta (Response Information)

Códigos do Recurso (Response Codes)

• OK (201)
• BadRequest (400)

Adicionar Código de Barras do Produto - POST

Objetivo

Método que permite inserir/atualizar os códigos de barras dos produtos (códigos DUN, EAN, Internos ou Transição). 

Chamada

POST api/v1/importacao/produto/codigobarras

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Não há.

Parâmetros do Corpo (Body Parameters)

Código sequencial do produto.

Número da empresa ou código do depositante (quando utilizado Operador Logístico).

Quantidade de unidades dentro de cada embalagem.

Código de barras do produto, podendo ser EAN8, EAN13, UCC12, DUN14 ou código de barras próprio definido internamente pela empresa.

Tamanho Máximo: 20

Tipo do código do produto:
E – Código de barras de unidade de consumo (EAN/UCC)
D – Código de barras de unidade de despacho (DUN)
I – Transição
B – Código interno do produto

*Campos Obrigatórios

Validações Logísticas

As validações logísticas, não impactam no retorno da requisição. Entretanto, para a correta importação do código de barras, o critério listado abaixo deve ser atendido. Caso contrário, será gerada uma crítica logística**, e o registro ficará pendente de verificação por um usuário. 

1. A quantidade da embalagem (QTDEMBALAGEM) deverá estar previamente cadastrada para o Produto (SeqProduto) informado. 

_{**As críticas logísticas podem ser visualizadas através da aplicação: WMS Centro de Distribuição -> Gerencial -> Consultas -> Exclusão de Rejeições da Importação Automática.}

Formatos de Request(Request Formats)

application/json, text/json

[
  {
    "seqProduto": 1,
    "nroEmpresa": 1,
    "qtdEmbalagem": 1.0,
    "codAcesso": "1234567890",
    "tipCodigo": "B"
  }
]

Informações para Resposta (Response Information)

Códigos do Recurso (Response Codes)

• OK (201)
• BadRequest (400)

Adicionar Espécie de Endereço do Produto - POST

Objetivo

Método que permite inserir/atualizar as espécies de endereços dos produtos, incluindo os dados de norma de paletização, estoque mínimo para reposição, etc.

Não é obrigatório o envio dessa informação, e quando não é enviada, a mesma pode ser cadastrada diretamente no módulo WMS Centro de Distribuição.

Chamada

POST api/v1/importacao/produto/especieendereco

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Não há.

Parâmetros do Corpo (Body Parameters)

Código sequencial do produto.

Número da empresa ou código do depositante (quando utilizado Operador Logístico).

Quantidade de unidades dentro de cada embalagem.

Espécie de endereço previamente cadastrada em WMS Parâmetros → Cadastro → Endereços → Espécie de Endereços.

Tamanho Máximo: 1

Quantidade do lastro da norma.

*Campos Obrigatórios

Validações Logísticas

As validações logísticas, não impactam no retorno da requisição. Entretanto, para a correta importação da espécie de endereço, os critérios listados abaixo devem ser atendidos. Caso contrário, será gerada uma crítica logística**, e o registro ficará pendente de verificação por um usuário. 

1. O Produto (SeqProduto) deverá estar cadastrada previamente para a empresa (NroEmpresa) informada;
2. A Embalagem (QtdEmbalagem) deverá estar cadastrada previamente para o produto (SeqProduto) e empresa (NroEmpresa) informada;
3. A Espécie de Endereco (EspecieEndereco) deverá estar cadastrada previamente para a empresa (NroEmpresa) informada.

_{**As críticas logísticas podem ser visualizadas através da aplicação: WMS Centro de Distribuição -> Gerencial -> Consultas -> Exclusão de Rejeições da Importação Automática.}

Formatos de Request(Request Formats)

application/json, text/json

[
  {
    "seqProduto": 1,
    "nroEmpresa": 1,
    "qtdEmbalagem": 12,
    "especieEndereco": "A",
    "paleteLastro": 10,
    "paleteAltura": 1,
    "estqMinimoRep": 10
  }
]

Informações para Resposta (Response Information)

Códigos do Recurso (Response Codes)

• OK (201)
• BadRequest (400)

Adicionar Categorias dos Produtos - POST

Objetivo

Método que permite inserir/atualizar os dados de associação das categorias aos produtos.

Chamada

POST /api/v1/importacao/produto/categoriaproduto

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Não há.

Parâmetros do Corpo (Body Parameters)

Código sequencial do Produto.

Número da divisão da empresa ( Quando o ERP não utiliza deste recurso passar ZERO ).

Código da empresa do Produto.

*Campos Obrigatórios

Validações Logísticas

As validações logísticas, não impactam no retorno da requisição. Entretanto, para a correta importação de associação das categorias aos produtos, o critério listado abaixo deve ser atendido. Caso contrário, será gerada uma crítica logística***, e o registro ficará pendente de verificação por um usuário. 

1. O produto (SeqProduto) deverá estar cadastrado previamente na empresa (NroEmpresa) informada.   

_{***As críticas logísticas podem ser visualizadas através da aplicação: WMS Centro de Distribuição -> Gerencial -> Consultas -> Exclusão de Rejeições da Importação Automática.}

Formatos de Request (Request Formats)

application/json, text/json

{
   "seqProduto": 407640,
   "nroEmpresa": 100,
   "nroDivisao": 1,
   "seqCategoria": 102
}

Informações para Resposta (Response Information)

Códigos do Recurso (Response Codes)

• OK (201)
• BadRequest (400)

Adicionar Componentes do Produto Composto - POST

Objetivo

Método que permite inserir/atualizar os dados do produto composto, incluindo os dados de produto componente, quantidades, etc.

Não é obrigatório o envio dessa informação quando não for utilizado o conceito de Produto Composto.

Chamada

POST /api/v1/importacao/produto/componenteprodutocomposto

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Não há.

Parâmetros do Corpo (Body Parameters)

Código sequencial do produto final que é gerado após a finalização da composição.

Código sequencial do produto que serão componentes na composição do produto final acabado, que deverá estar previamente cadastrada no WMS.

Número da empresa ou código do depositante (quando utilizado Operador Logístico).

*Campos Obrigatórios

Validações Logísticas

As validações logísticas, não impactam no retorno da requisição. Entretanto, para a correta importação dos componentes do produto, os critérios listados abaixo devem ser atendidos. Caso contrário, será gerada uma crítica logística***, e o registro ficará pendente de verificação por um usuário. 

1. O produto final (SeqProdFinal) deverá estar cadastrado previamente na empresa (NroEmpresa) informada. 
2. O produto componente (SeqProdComponente) deverá estar cadastrado previamente na empresa (NroEmpresa) informada. 
3. A embalagem (QtdEmbalagem) deverá estar cadastrada previamente para o SeqProdComponente informado. 

_{***As críticas logísticas podem ser visualizadas através da aplicação: WMS Centro de Distribuição -> Gerencial -> Consultas -> Exclusão de Rejeições da Importação Automática.}

Formatos de Request (Request Formats)

application/json, text/json

[
  {
  	"seqProdFinal": 120612,
  	"seqProdComponente": 12987,
  	"nroEmpresa": 100,
  	"qtdEmbalagem": 1,
  	"quantidade": 15
  }
]

Informações para Resposta (Response Information)

Códigos do Recurso (Response Codes)

• OK (201)
• BadRequest (400)