Manual de Integração Marketplace Netshoes/Zattini
Sumário Manual de Integração... 1 Marketplace Netshoes/Zattini... 1 Apresentação... 3 Entrando em contato com a Netshoes/Zattini... 4 Gerando Access Token API Netshoes/Zattini... 5 Criação de produtos na Netshoes/Zattini... 6 Produto Simples... 6 Produto Agrupado... 6 Pedidos... 8 WebHooks e Notificações... 9
Apresentação A Hub2b em parceria com o Grupo Netshoes disponibiliza hoje uma integração completa entre o sistema de origem de preferência do cliente com os Marketplaces do Grupo Netshoes, que englobam tanto a Netshoes quanto a Zattini. As operações disponíveis envolvem: criação de produtos na Netshoes, Atualização geral do produto na Netshoes, Atualização de preço e estoque, Baixa de pedidos e Atualização de pedidos.
Entrando em contato com a Netshoes/Zattini O primeiro passo para começar suas vendas na Netshoes é entrar em contato com o grupo Netshoes e obter uma loja dentro deste Marketplace. O site da Netshoes expõe 8 motivos para começar a vender com eles: 1. Mais de 54 milhões de visitantes únicos por mês 2. Varejo número 1 em fãs na América Latina: 9,4 milhões no Facebook 3. Antecipação de recebimentos 4. Cross-selling de produtos 5. Marca aderente ao seu nicho de mercado 6. Presente em várias plataformas: Mobile, Tablet e Desktop 7. Condições e forma de pagamento da Netshoes 8. Padrão Netshoes de atendimento ao cliente Todas as informações para obter sua loja estão disponíveis em : http://www.netshoes.com.br/marketplace/ Para tal, execute os passos à seguir para gerar o Token de acesso.
Gerando Access Token API Netshoes/Zattini Para receber o token, você deve entrar em contato com o analista comercial da Netshoes. Caso você não tenha o contato, poderá procurar por uma destas pessoas: Raissa Lopes Ninomiya raissa.ninomiya@netshoes.com Iolanda de Oliveira Fabri iolanda.fabri@netshoes.com Taiane de Paula Ferreira taiane.ferreira@netshoes.com O responsável pela API irá gerar a chave e lhe enviar. Assim que receber nos envie. Qualquer dúvida entre em contato conosco.
Criação de produtos na Netshoes/Zattini A criação de produtos pode ser feita de duas maneiras: produto simples ou agrupado (pai e variações). Independente do tipo de envio, para que um produto seja criado na Netshoes, existem determinadas regras aplicadas pelo próprio marketplace. Abaixo são listadas as principais regras: - Todo produto deve conter cor ou sabor(um e apenas um deles), tamanho e gênero; - Os valores para gênero devem ser : Homem, Mulher ou Unissex; - O tamanho máximo para o nome do produto é de 500 caracteres; - O tamanho máximo para descrição do produto é de 1230 caracteres; - A descrição não pode conter nenhum tipo de Html; Todos os atributos preenchidos em nossa plataforma são enviados para a Netshoes, porém, todos eles passam por uma validação interna, onde são efetivamente enviados, apenas os atributos válidos. Sendo assim, é perfeitamente normal que um atributo seja listado em nossa plataforma e não apareça no Marketplace. Neste caso, o atributo estará listado juntamente com a descrição. Produto Simples Quando um produto simples é enviado para a Netshoes, todas as informações são obtidas do próprio produto, sendo necessário que nele estejam todas as informações acima listadas. Produto Agrupado No caso de produtos agrupados, existem algumas informações que são capturadas do cadastro do produto pai e outras que são seguidas de acordo com cada variação cadastrada na Plataforma Hub.
As informações capturadas do produto pai são : sku, categoria, marca e especificações. Já no caso das variações, são enviadas as informações de: sku, nome, descrição, opções, ean, preço, imagens, dimensões e peso. Em nossa plataforma tanto opções como especificações são tratadas como atributos. A grande diferença de uma opção para uma especificação é que a opção é obrigatória e necessária para distinguir uma variação de outra, enquanto que a especificação é apenas um atributo do produto que não muda para cada variação. No caso da Netshoes, são listados abaixo os atributos classificados como opção: - Tamanho; - Sabor; - Gênero; - Cor; Sendo assim, estes 4 atributos devem constar no produto filho, enquanto que os demais serão obtidos do produto pai. Visto que uma variação deve conter ou cor ou sabor, uma e apenas uma delas. Após devidamente cadastrados os produtos em nossa plataforma, ele deve ser marcado como conectado em nossa plataforma e em questão de minutos será enviado ao sistema da Netshoes, onde passará por um processo de validação, neste meio tempo, seu produto ficará com status Em catalogação em nossa plataforma, até que ele seja aceito pela equipe da Netshoes e efetivamente comece a vender. Neste momento, ele passará para o status Sincronizado.
Pedidos Iniciadas as vendas, começam a cair os pedidos, que periodicamente são consultados por nosso serviço e criados em nossa plataforma, para que posteriormente seja enviado ao seu ERP ou e-commerce. Após criado em seu sistema de preferência, periodicamente consultaremos suas atualizações de status de pedido e atualizaremos estas informações no canal de venda, passando, na Netshoes, pelos status: Aprovado, Faturado, Enviado e Entregue. No caso de um pedido cancelado, será necessário cancelá-lo diretamente na plataforma da Netshoes. Para que um pedido seja atualizado para Faturado, é necessário que ele tenha as informações de nota fiscal: chave, número e série. O status Enviado terá sua atualização realizada apenas com a informação de código de rastreamento. Para atualizar seu pedido como Entregue, no momento da adesão do contrato, basta nos informar o sistema de entrega que deseja utilizar e assim que atualizado no sistema, fazemos atualização no marketplace. Hoje, trabalhamos com Correios, JadLog e LogBee.
WebHooks e Notificações Trabalhando sempre obter uma integração cada vez melhor, hoje damos suporte recepção de notificações de produtos e pedidos. Utilizando o recurso de notificações podemos receber as atualizações da Netshoes em tempo real! Quando ocorre algum evento (novo pedido, cancelamento, etc) recebemos uma notificação e atualizamos a informação no mesmo momento no painel da Hub2b. Isso garante que as informações estejam sempre atualizadas, em tempo real. Para configurar este recurso você precisa inserir a URL de notificação no painel da Netshoes, seguindo os passos abaixo: 1) URL: https://eb-api.plataformahub.com.br/restserviceimpl.svc/notifications/netshoes/codigo_da_sua_empresa Informe o código da sua empresa na URL, substituindo o campo "codigo_da_sua_empresa". Para saber o código da sua empresa, acesse o painel da Hub2b e verifique no canto superior direito, ao lado do usuário, conforme imagem abaixo: Exemplo: https://eb-api.plataformahub.com.br/restserviceimpl.svc/notifications/netshoes/1010 2) Acesse o painel da Netshoes, procure pelo módulo Notificações, ative as Notificações de Pedidos e Produtos e:
Informe a URL e os token da sua conta (pode copiar e colar o que está abaixo): App token: hub2b_token App key: hub2b_key Clique em Salvar. Caso tiver dúvidas, verifique o manual da Netshoes neste link: http://developers.netshoes.com.br/api-portal/content/notificacao#index3 ou entre em contato com nossa equipe de suporte. Obrigado e boas vendas!