Pular para conteúdo

Integração de produto

Para a integração de produto, será necessário chamar o método integrarProduto. A chamada desse serviço procede da seguinte forma:

URL

http://ip_servidor:9090/cyberweb/api/cadastro/integrarProduto

Headers

chave : "epa42b92-d78b-7g88-p538-279qw562h54m"

token : "9166226b-6afd-4298-b6cc-d7dc3aef8f48"

Content-Type : "application/x-www-form-urlencoded"

Body

produto : "JSON Produto"

JSON Produto

{
    "operacao":"INSERT",
    "erpId":"28500740000106_1",
    "empresa":"1",
    "codigoReduzido":"WMS_CYBERLOG_001",
    "codigoBarras":"WMS_CYBERLOG_001",
    "codigoEstruturado":"",
    "nome":"PROD 01 - INTEGRA WMS CYBERLOG DESCRICAO",
    "unome":"PROD 01 - INTEGRA WMS CYBERLOG DESCRICAO",
    "nomeLocal1":"",
    "nomeLocal2":"",
    "item":true,
    "pesoUnitario":5.37,
    "altura":854,
    "largura":247,
    "profundidade":452,
    "unidade":"CX",
    "agrupaSeparacao":false,
    "separacaoMinimo":"P",
    "controlaLote":true,
    "controlaValidade":false,
    "controlaSerial":true,
    "semPickingFixo":false,
    "perigoso":false,
    "refrigerado":false,
    "cofre":false,
    "marca":"",
    "percentualSeguranca":0,
    "leadTime":0,
    "valorVenda":11086.03,
    "minimoVenda":0,
    "controlaQuarentena":false,
    "pesado":false,
    "produzido":false,
    "produzidoconf":false,
    "agrupaEmbalagem":false,
    "cuidadosEspeciais":0,
    "observacao":"",
    "categoria":"Importados",
    "fornecedor":0,
    "codigoDun":"CB_M_WMS_CYBERLOG_001",
    "unidadeDun":"CX",
    "fatorDun":200,
    "pesoDun":5.37,
    "alturaDun":0,
    "larguraDun":0,
    "npLargura":5,
    "npAltura":5,
    "npProfundidade":5,
    "shelfLife":5,
    "profundidadeDun":0,
    "empilhamento":10,
    "codigoDisplay":"CB_I_WMS_CYBERLOG_001",
    "unidadeDisplay":"CX",
    "fatorDisplay":20,
    "converterMedida":1,
    "baixaAutomatica":true,
    "geraEtiqueta":false,
    "informarLote":false,
    "imagemProduto":"\\imagensprodutos\\28500740000106_1.png",
    "nivelMaximo":10,
    "codigosMultiplos":[
        {
            "operacao":"INSERT",
            "erpId":"id_erp",
            "empresa":"01",
            "codigo":"999999999999",
            "tipo":"U",
            "codigoReduzido":"999999999",
            "codFornecedor":"1",
            "fator":1,
            "padrao":"T"
        },
        {
            "operacao":"INSERT",
            "erpId":"id_erp2",
            "empresa":"01",
            "codigo":"888888888888",
            "tipo":"U",
            "codigoReduzido":"888888888",
            "codFornecedor":"1",
            "fator":1,
            "padrao":"F"
        }
    ],
    "tipoEstrutura":{
        "operacao":"INSERT",
        "codigo":"014",
        "empresa":"01",
        "descricao":"xkskk",
        "noOrdem":1,
        "noGrupo":1,
        "conferenciaSep":"T",
        "tipo":"M"
    }
}

Response

{
    "CyberWeb": "1 - Inserido"
}

URL

http://ip_servidor:9090/SyncWS/SyncWS/integrarProduto

Headers

Content-Type : text/xml

Body - (XML) Produto

<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <Body>
        <integrarProduto xmlns="http://soap.cyber/">
            <sessionId xmlns="">SessionId</sessionId>
            <produto xmlns="">JSON Produto</produto>
        </integrarProduto>
    </Body>
</Envelope>

JSON Produto

{
    "operacao":"INSERT",
    "erpId":"28500740000106_1",
    "empresa":"DEPOSITO_001",
    "codigoReduzido":"WMS_CYBERLOG_001",
    "codigoBarras":"WMS_CYBERLOG_001",
    "codigoEstruturado":"",
    "nome":"PROD 01 - INTEGRA WMS CYBERLOG DESCRICAO",
    "unome":"PROD 01 - INTEGRA WMS CYBERLOG DESCRICAO",
    "nomeLocal1":"",
    "nomeLocal2":"",
    "item":true,
    "pesoUnitario":5.37,
    "altura":854,
    "largura":247,
    "profundidade":452,
    "unidade":"CX",
    "agrupaSeparacao":false,
    "separacaoMinimo":"P",
    "controlaLote":true,
    "controlaValidade":false,
    "controlaSerial":true,
    "semPickingFixo":false,
    "perigoso":false,
    "refrigerado":false,
    "cofre":false,
    "marca":"",
    "percentualSeguranca":0,
    "leadTime":0,
    "valorVenda":11086.03,
    "minimoVenda":0,
    "controlaQuarentena":false,
    "pesado":false,
    "produzido":false,
    "produzidoconf":false,
    "agrupaEmbalagem":false,
    "cuidadosEspeciais":0,
    "observacao":"",
    "categoria":"Importados",
    "fornecedor":0,
    "codigoDun":"CB_M_WMS_CYBERLOG_001",
    "unidadeDun":"CX",
    "fatorDun":200,
    "pesoDun":5.37,
    "alturaDun":0,
    "larguraDun":0,
    "npLargura":5,
    "npAltura":5,
    "npProfundidade":5,
    "shelfLife":5,
    "profundidadeDun":0,
    "empilhamento":10,
    "codigoDisplay":"CB_I_WMS_CYBERLOG_001",
    "unidadeDisplay":"CX",
    "fatorDisplay":20,
    "converterMedida":1,
    "baixaAutomatica":true,
    "geraEtiqueta":false,
    "informarLote":false,
    "imagemProduto":"\\imagensprodutos\\28500740000106_1.png",
    "nivelMaximo":10,
    "codigosMultiplos":[
        {
            "operacao":"INSERT",
            "erpId":"id_erp",
            "empresa":"01",
            "codigo":"999999999999",
            "tipo":"U",
            "codigoReduzido":"999999999",
            "codFornecedor":"1",
            "fator":1,
            "padrao":"T"
        },
        {
            "operacao":"INSERT",
            "erpId":"id_erp2",
            "empresa":"01",
            "codigo":"888888888888",
            "tipo":"U",
            "codigoReduzido":"888888888",
            "codFornecedor":"1",
            "fator":1,
            "padrao":"F"
        }
    ],
    "tipoEstrutura":{
        "operacao":"INSERT",
        "codigo":"014",
        "empresa":"01",
        "descricao":"xkskk",
        "noOrdem":1,
        "noGrupo":1,
        "conferenciaSep":"T",
        "tipo":"M"
    }
}

Response

<?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <S:Body>
        <ns2:integrarProdutoResponse xmlns:ns2="http://soap.cyber/">
            <return>1 - Inserido</return>
        </ns2:integrarProdutoResponse>
    </S:Body>
</S:Envelope>

RC's do método integrarProduto

  • 1 - Inserido;
  • 2 - Alterado;
  • 3 - Excluído;
  • !4 - Não inserido (não há configuração de depósito para a empresa);
  • !5 - Não inserido (depósito informado não possui configuração);
  • !6 - Não inserido (ERPID vazio);
  • !7 - Não inserido (código de barras vazio);
  • !8 - Não inserido (código reduzido vazio);
  • !9 - Não inserido (fornecedor não existe no WMS);
  • !10 - Não inserido tipo de estrutura (não há configuração de depósito para a empresa);
  • !11 - Não inserido tipo de estrutura (depósito informado não possui configuração);
  • !12 - Não inserido tipo de estrutura (código vazio);
  • !13 - Não inserido tipo de estrutura (tipo vazio/incorreto);
  • !14 - Não excluído tipo de estrutura (código informado não existe no sistema);
  • !15 - Não inserido tipo de estrutura (operação inválida);
  • !16 - Produto à ser deletado não existe no WMS;
  • !17 - Nenhuma operação válida enviada (válidas: INSERT, UPDATE, DELETE);
  • !18 - Não inserido (Codigo barras e Codigo reduzido não podem ser igual o codigo Dun);
  • !19 - Não há configuração de sincronizador para a empresa: XXXXX;
  • !42 - Erro não cadastrado (informações no log do servidor).

Atenção

As RC's do método integrarCodigoMultiplo também podem ser retornadas nessa integração.

Dicionário de dados - Produto

Nome Tipo de Dado Descrição Obrigatório Padrão
erpId varchar(30) Chave que identifica o registro.
operacao varchar(10) Operação ('INSERT', 'UPDATE', 'DELETE')
empresa varchar(20) Número da empresa.
codigoReduzido varchar(39) Código reduzido do produto.
codigoBarras varchar(39) Código de barras do produto.
codigoEstruturado varchar(20) Código estruturado do produto.
nome varchar(100) Nome do produto.
unome varchar(100) Nome do produto em caixa alta.
nomeLocal1 varchar(100) Nome local 1 do produto.
nomeLocal2 varchar(100) Nome local 2 do produto.
item boolean (true) o produto é item, (false) não. F
pesoUnitario number(15, 4) Peso unitário do produto.
altura number(10) Altura do produto. 0
largura number(10) Largura do produto. 0
profundidade number(10) Profundidade do produto. 0
unidade varchar(10) Unidade do produto. UN
agrupaSeparacao boolean (true) o produto agrupa na separação, (false) não. F
separacaoMinimo varchar(1) Tipo: P (Pallet), U (unit), D (display) e C (dun) P
controlaLote boolean (true) o produto controla lote, (false) não. F
controlaValidade boolean (true) o produto controla validade, (false) não. F
controlaSerial boolean (true) o produto controla serial, (false) não. F
semPickingFixo boolean (true) o produto utiliza picking fixo, (false) não. F
perigoso boolean (true) o produto é perigoso, (false) não. F
refrigerado boolean (true) o produto é refrigerado, (false) não. F
cofre boolean (true) o produto é cofre, (false) não. F
marca varchar(100) Marca do produto.
percentualSeguranca number(10) Percentual de segurança do produto. 0
leadTime number(10) Lead Time do produto. 0
valorVenda number(15, 4) Valor de venda do produto.
minimoVenda number(10) Mínimo de venda do produto. 0
cuidadosEspeciais number(10) Código dos cuidados especiais do produto. 0
observacao varchar(1000) Observação do produto.
categoria varchar(50) Descrição da categoria do produto. 0
fornecedor number(10) Número do fornecedor do produto. 0
codigoDun varchar(39) Código DUN do produto.
unidadeDun varchar(10) Unidade DUN do produto. CX
fatorDun number(15, 4) Fator DUN do produto.
pesoDun number(15, 4) Peso DUN do produto.
alturaDun number(10) Altura DUN do produto. 0
larguraDun number(10) Largura DUN do produto. 0
profundidadeDun number(10) Profundidade DUN do produto. 0
empilhamento number(10) Empilhamento do produto. 0
codigoDisplay varchar(39) Código Display do produto
unidadeDisplay varchar(10) Unidade Display do produto. DP
fatorDisplay number(15, 4) Fator Display do produto.
codigosMultiplos arraylist (CodigoMultiplo) Lista de códigos múltiplos (barras, DUN, display) a serem integrados.
npLargura number(10) Lastro
npAltura number(10) Camada
npProfundidade number(10) Profundidade
shelfLife number(10) Tempo de prateleira
converterMedida number(10) Tipo de conversão de medida do produto 0
baixaAutomatica boolean (true) o produto faz baixa automática, (false) não. F
tipoEstrutura Objeto TipoEstrutura Objeto TipoEstrutura a ser integrado com o produto
controlaQuarentena boolean (true) o produto controla quarentena, (false) não.
pesado boolean (true) o produto é pesado,, (false) não.
produzido boolean (true) o produto é produzido, (false) não.
produzidoconf boolean (true) o produto é produzido configurável, (false) não.
agrupaEmbalagem boolean (true) o produto agrupa embalagem, (false) não.
geraEtiqueta boolean (true) o produto gera etiqueta, (false) não.
informarLote boolean (true) o produto informa lote na separação, (false) não.
imagemProduto varchar(50) Informar o caminho da imagem do produto.
nivelMaximo number(10) Nível máximo. 10

Os possíveis valores do campo converterMedida do método integrarProduto

  • 0 - Nenhum;
  • 1 - Metro quadrado para metro linear.

Configuração atualizatodoscamposproduto na integração

Com essa configuração ativada, sempre que for enviado novamente um produto que já existe no WMS, ele terá suas informações atualizadas de acordo com as informações enviadas no JSON de integração e de acordo com os campos do produto com permissão para serem atualizados (configurável se necessário, por padrão somente o nome, peso unitário e item). Com essa configuração desativada, só será atualizado do produto as informações de: nome, peso unitário e item. Essa configuração por padrão está ativada, podendo ser solicitado ao Suporte que seja desativada para que não fique atualizando o produto sempre que ele é enviado.