Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo1 |
---|
| Adicionar Embalagem do Produto - POSTObjetivoMé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. ChamadaPOST 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)Nome (Name) | Descrição (Description) | Tipo (Type) | Informações Adicionais (Adittional Information) | SEQPRODUTO* | Código sequencial do produto. | integer |
| NROEMPRESA* | Número da empresa ou código do depositante (quando utilizado Operador Logístico). | integer | Valor Máximo: 999 | QTDEMBALAGEM* | Quantidade de unidades dentro de cada embalagem. | decimal (8,3) | Valor Máximo: 99999,999 | EMBALAGEM* | Descrição da embalagem. Exemplo UN, CX, LT, etc. | string | Tamanho Máximo: 3 | STATUSEMBALAGEM* | Status da embalagem: A – Ativo I – Inativo. | string | Tamanho Máximo: 1 | INDMIUDEZAGRANDEZA | Indica se a embalagem do produto corresponde à: M – Miudeza G – Grandeza. | string | Tamanho Máximo: 1 | PESOBRUTO** | Peso bruto na embalagem do produto. Unidade de medida: quilo (kg). | decimal (7,3) | Valor Máximo: 9999,999 | PESOLIQUIDO** | Peso líquido na embalagem do produto. Unidade de medida: quilo (kg). | decimal (7,3) | Valor Máximo: 9999,999 | ALTURA** | Altura na embalagem do produto. Unidade de medida: centímetro (cm). | decimal (9,6) | Valor Máximo: 999,999999 | LARGURA** | Largura na embalagem do produto. Unidade de medida: centímetro (cm). | decimal (9,6) | Valor Máximo: 999,999999 | PROFUNDIDADE** | Profundidade na embalagem do produto. Unidade de medida: centímetro (cm). | decimal (9,6) | Valor Máximo: 999,999999 | INDEMBALADO | Indica se a embalagem do produto corresponde o tipo embalado: N – Não S – Sim. | string | Tamanho Máximo: 1 | CODTARA | Código da tara na embalagem do produto. A tara deve estar previamente cadastrada no WMS Parâmetros → Produtos → Tara Balança. | string | Tamanho Máximo: 10 | PESOMEDIO | Peso médio da embalagem do produto. Unidade de medida: quilo (kg). Utilizada na tolerância de separação. | decimal (7,3) | Valor Máximo: 9999,999 | INDPADRAOEMBCOMPRA | Indica se a embalagem é padrão de compra: N – Não S – Sim. Obs. Na importação da primeira embalagem do produto ela será considerada padrão de compra independente do valor passado e quando vier uma nova embalagem setada como padrão de compra, esta nova será considerada e a anterior deixará de ser padrão. | string | Tamanho Máximo: 1 | INDPADRAOEMBVENDA | Indica se a embalagem é padrão de venda: N – Não S – Sim. Obs. Na importação da primeira embalagem do produto ela será considerada padrão de venda independente do valor passado e quando vier uma nova embalagem setada como padrão de venda, esta nova será considerada e a anterior deixará de ser padrão. | string | Tamanho Máximo: 1 |
*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ísticasAs 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. - O Produto (SeqProduto) deverá estar cadastrada previamente para a empresa (NroEmpresa) informada;
- A Empresa (NroEmpresa) deverá estar cadastrada previamente no Cadastro de Depositantes (WMS Parâmetros → Cadastro → Depositante);
- 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 Bloco de código |
---|
| [
{
"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) |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| Adicionar Código de Barras do Produto - POSTObjetivoMétodo que permite inserir/atualizar os códigos de barras dos produtos (códigos DUN, EAN, Internos ou Transição). ChamadaPOST 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)Nome (Name) | Descrição (Description) | Tipo (Type) | Informações Adicionais (Adittional Information) | SEQPRODUTO* | Código sequencial do produto. | integer |
| NROEMPRESA* | Número da empresa ou código do depositante (quando utilizado Operador Logístico). | integer | Valor Máximo: 999 | QTDEMBALAGEM* | Quantidade de unidades dentro de cada embalagem. | decimal (8,3) | Valor Máximo: 99999,999 | CODACESSO* | Código de barras do produto, podendo ser EAN8, EAN13, UCC12, DUN14 ou código de barras próprio definido internamente pela empresa. | string | Tamanho Máximo: 20 | TIPCODIGO* | 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 | string | Tamanho Máximo: 1 |
*Campos Obrigatórios Validações LogísticasAs 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. - 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 Bloco de código |
---|
| [
{
"seqProduto": 1,
"nroEmpresa": 1,
"qtdEmbalagem": 1.0,
"codAcesso": "1234567890",
"tipCodigo": "B"
}
] |
Informações para Resposta (Response Information)Códigos do Recurso (Response Codes) |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
| Adicionar Espécie de Endereço do Produto - POSTObjetivoMé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. ChamadaPOST 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)Nome (Name) | Descrição (Description) | Tipo (Type) | Informações Adicionais (Adittional Information) | SEQPRODUTO* | Código sequencial do produto. | integer |
| NROEMPRESA* | Número da empresa ou código do depositante (quando utilizado Operador Logístico). | integer | Valor Máximo: 999 | QTDEMBALAGEM* | Quantidade de unidades dentro de cada embalagem. | decimal (8,3) | Valor Máximo: 99999,999 | ESPECIEENDERECO* | Espécie de endereço previamente cadastrada em WMS Parâmetros → Cadastro → Endereços → Espécie de Endereços. | string | Tamanho Máximo: 1 | PALETELASTRO* | Quantidade do lastro da norma. | integer | Tamanho Máximo: 99999 | PALETEALTURA* | Quantidade da altura da norma. | integer | Tamanho Máximo: 99999 | ESTQMINIMOREP | Quantidade de estoque mínimo da espécie de endereço do produto para que seja iniciado o processo de reposição. | decimal (12,3) | Valor Máximo: 999999999,999 |
*Campos Obrigatórios Validações LogísticasAs 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. - O Produto (SeqProduto) deverá estar cadastrada previamente para a empresa (NroEmpresa) informada;
- A Embalagem (QtdEmbalagem) deverá estar cadastrada previamente para o produto (SeqProduto) e empresa (NroEmpresa) informada;
- 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 Bloco de código |
---|
| [
{
"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) |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo4 |
---|
| Adicionar Categorias dos Produtos - POSTObjetivoMétodo que permite inserir/atualizar os dados de associação das categorias aos produtos. ChamadaPOST /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)Nome (Name) | Descrição (Description) | Tipo (Type) | Informações Adicionais (Adittional Information) | SEQPRODUTO* | Código sequencial do Produto. | integer |
| NRODIVISAO* | Número da divisão da empresa ( Quando o ERP não utiliza deste recurso passar ZERO ). | integer | Valor Máximo: 999 | NROEMPRESA* | Código da empresa do Produto. | integer | Valor Máximo: 999 | SEQCATEGORIA* | Código Sequencial da Categoria em que o produto está vinculado. Somente pode vincular uma categoria que estiver com MAXHIERARQUIA = 'S'. | integer | Valor Máximo: 99999 |
*Campos Obrigatórios Validações LogísticasAs 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. - 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 Bloco de código |
---|
| {
"seqProduto": 407640,
"nroEmpresa": 100,
"nroDivisao": 1,
"seqCategoria": 102
} |
Informações para Resposta (Response Information)Códigos do Recurso (Response Codes) |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo5 |
---|
| Adicionar Componentes do Produto Composto - POSTObjetivoMé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. ChamadaPOST /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)Nome (Name) | Descrição (Description) | Tipo (Type) | Informações Adicionais (Adittional Information) | SEQPRODFINAL* | Código sequencial do produto final que é gerado após a finalização da composição. | integer |
| SEQPRODCOMPONENTE* | Código sequencial do produto que serão componentes na composição do produto final acabado, que deverá estar previamente cadastrada no WMS. | integer |
| NROEMPRESA* | Número da empresa ou código do depositante (quando utilizado Operador Logístico). | integer | Valor Máximo: 999 | QTDEMBALAGEM* | Quantidade de unidades dentro de cada embalagem do produto componente na composição do produto final acabado. | integer | Valor Máximo: 999999999999,999999 | QUANTIDADE* | Quantidade utilizada do produto componente na composição do produto final acabado. | integer | Valor Máximo: 999999999999,999 |
*Campos Obrigatórios Validações LogísticasAs 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. - O produto final (SeqProdFinal) deverá estar cadastrado previamente na empresa (NroEmpresa) informada.
- O produto componente (SeqProdComponente) deverá estar cadastrado previamente na empresa (NroEmpresa) informada.
- 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 Bloco de código |
---|
| [
{
"seqProdFinal": 120612,
"seqProdComponente": 12987,
"nroEmpresa": 100,
"qtdEmbalagem": 1,
"quantidade": 15
}
] |
Informações para Resposta (Response Information)Códigos do Recurso (Response Codes) | HTML | <style>
div.theme-default .ia-splitter #main {
margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
display: none;
}
#main {
padding-left: 10px;
padding-right: 10px;
overflow-x: hidden;
}
.aui-header-primary .aui-nav, .aui-page-panel {
margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
margin-left: 0px !important;
}
</style>
|