Como homologar minha integração com a SkyHub?

Para que o nosso time possa iniciar o processo de homologação é importante que você responda seguinte pergunta:

Você é uma loja que desenvolverá integração própria ou plataforma/ERP?

Caso seja uma loja, por gentileza solicitar a homologação através do link: https://ajuda.skyhub.com.br/hc/pt-br/requests/new

Utilizar a seguinte categoria: homologação > solicitar homologação

Caso seja uma plataforma/Erp, por gentileza, entre em contato com o Hub de Lojas, através do email: hub.de.lojas.marketplace@b2winc.onmicrosoft.com

Eles irão solicitar a criação de sua conta teste e em breve você receberá os dados para que possa iniciar os testes.

Com os dados em mãos, daremos início aos testes.

Veja o vídeo de como funciona a homologação com a SkyHub.


Pré-requisitos

É fundamental que você homologue a integração por completo.

Produtos

  1. Criar
  2. Atualizar
  3. Deletar

Obs.: Em todos os produtos devem conter foto e categoria.

Pedidos

  1. Criar
  2. Atualizar
  3. Consumir

Obs.: A Skyhub não faz empenho de estoque, é de extrema importância que você tenha desenvolva uma solução de empenho de estoque do seu lado.

Obs.: Durante o processo de homologação você precisará criar pedidos na API SkyHub, para tal, você poderá utilizar ferramentas rest como: DHC, Postman etc.

Entretanto, se a homologação for via módulo SkyHub (integração Magento), a equipe de homologação criará os pedidos necessários.


Quais métodos serão utilizados para realizar a homologação?


POST = Criar

PUT = Atualizar

GET = Buscar

DELETE = Deletar


O que iremos homologar?

Obs.: É essencial que para cada tópico abaixo nos envie um produto que corresponda ao que foi solicitado.

Produtos

  • Criar produto Simples

  • Criar produto com uma variação

  • Criar produto com mais de uma variação

  • Criar produto com mais de uma variação e com variação de preço no sku.

  • Criar produto com variação contendo o atributo tamanho

  • Criar produto com variação contendo o atributo cor

  • Criar produto com variações contendo os atributos cor e tamanho

  • Criar produto com variação contendo o atributo voltagem

  • Criar produto com categoria (categoria + subcategoria)

  • Atualizar estoque de produto (enviar valores antes da atualização e após a atualização)

  • Atualizar preço de produto (enviar valores antes da atualização e após a atualização)

  • Alterar status do produto para 'enabled'

  • Alterar status do produto para 'disabled'

  • Deletar um produto

Visite nosso guia de produtos

Pedidos

  • Criar pedido com produto simples

  • Criar pedido com produto simples e a quantidade do produto maior que 1

  • Criar pedido com produto que contenha variação

  • Criar pedido com produto que contenha variação e a quantidade da mesma maior que 1

  • Atualizar status de pedido para aprovado

  • Atualizar status de pedido para enviado com código de rastreio e chave da NFE

  • Atualizar status de pedido para entregue com código de rastreio e chave da NFE

  • Atualizar status de pedido para cancelado

  • Atualizar status de pedido para exceção de entrega

  • Consumir todos os pedidos pela fila de integração (/queues). Importante realizar um GET para consumir o pedido e um DELETE para retira-lo da fila.

Visite nosso guia de pedidos

Obter Etiqueta de Frete

Atualmente a B2W possui o serviço de frete B2W Entrega e o Marcado Livre o Mercados Envios 2 onde é disponibilizado um endpoint a etiqueta de frete para esses pedidos.

Catalogo de Erros

Atualmente a Skyhub disponibiliza um endpoint para que a integração tenha acesso aos erros que acontecem de integração na sua plataforma, para saber mais sobre esse recurso, acesse Catalogo de erros


Guia de boas práticas

As questões abaixo estão diretamente relacionadas ao tratamento realizado na integração.

  1. As informações sobre dimensão do SKU são obrigatórias, qual a trativa será tomada para nos enviar essas dimensões?

  2. Os produtos precisam ser enviados com o peso em kilograma (KG) e as dimensões em centímetro (cm), qual o tratamento realizado para consistência do envio dessas informações?

  3. Qual o tratamento dado para o produto ou atualização de status de pedido quando ocorre um erro? Existe uma forma de retirar este produto ou pedido do fluxo de integração par evitar um número de erros maior? Se sim, qual?

  4. Sabendo que nossa API tem o limite de 500 requisições por minutos, qual a tratativa realizada para não ultrpassar o limite? Obs.: Ao receber o retorno 429 na API será necessário aguardar até o próximo minuto para realizar uma nova requisição.

  5. É obrigatório consumir todos os pedidos da fila de integração (Queues) com status pendente, para que os produtos sejam empenhados em seus estoque.

Porque é obrigatório?

Para não ter divergência de estoque Disponível X estoque Empenhado

Se não consumir os pedidos o que pode acontecer? Podemos vender produtos sem estoque, uma vez que o empenho não existe na plataforma receberemos o estoque como Estoque Disponível, consequentemente disponibilizaremos o estoque errado para o Marketplace.

Vale Lembrar: As plataformas que não se adequarem a essa regra de negócios podem arcar com prejuízo do seller, uma vez que são detentores da informação.

Vale Lembrar que: Para a Skyhub deve ser enviado apenas o estoque disponível.



Caso tenha dúvida no processo de homologação

Você deve entrar em contato com a equipe de homologação através do e-mail api@skyhub.com.br com o seguinte titulo:

Dúvida – Como fazer (insira aqui o procedimento) da homologação - "NomedaLoja"


Não esqueça de descrever no e-mail a sua dúvida.



Caso você tenha concluído o desenvolvimento

Por gentileza, solicite a homologação através do api@skyhub.com.br com o seguinte titulo:

Homologação API – “NomedaLoja”

Na Descrição do e-mail, favor, informar todos os pontos listados para a homologação com as respostas abaixo da pergunta correspondente e em breve um de nossos analistas dará o retorno sobre a homologação.


O que a equipe de Homologação não faz?

  • Não apoiamos duvidas de código de programação

  • Não geramos pedidos para integração via API


Como a equipe de homologação pode ajudar?

  • Apoiamos as duvidas relacionas a requisições feitas em Json

    Ficamos no aguardo do seu contato. (: