{"section":"tutorials","requestedLocale":"pt","requestedSlug":"como-funciona-a-integracao-da-skyhub","locale":"pt","slug":"como-funciona-a-integracao-da-skyhub","path":"docs/pt/tutorials/integrações/configurações-de-integrações/como-funciona-a-integracao-da-skyhub.md","branch":"main","content":"A B2W e as Lojas Americanas fizeram uma fusão, dando origem ao [Americanas Marketplace](https://americanasmarketplace.com.br/). Através do [conector nativo](/pt/docs/tutorials/estrategias-de-marketplace-na-vtex#integrado-a-conector-nativo-vtex) da VTEX, é possível integrar com a B2W e aumentar seus canais de venda.\n\nA SkyHub é a integradora que gerencia a comunicação entre VTEX e a B2W/Americanas Marketplace. Depois de realizar a [integração com a SkyHub/B2W](/pt/docs/tracks/visao-geral-da-integracao-b2w), é necessário entender como funciona o fluxo da integração, ou seja, como suas informações são atualizadas no marketplace. Este artigo foi dividido em:\n\n- [Produtos](/pt/docs/tutorials/como-funciona-a-integracao-da-skyhub#produtos)\n- [Estoque](/pt/docs/tutorials/como-funciona-a-integracao-da-skyhub#estoque)\n- [Preços](/pt/docs/tutorials/como-funciona-a-integracao-da-skyhub#precos)\n- [Promoções](/pt/docs/tutorials/como-funciona-a-integracao-da-skyhub#promocoes)\n- [Pedidos](/pt/docs/tutorials/como-funciona-a-integracao-da-skyhub#pedidos)\n\n## Produtos\n\nApós configurar a integração com a B2W, o envio de produtos para o marketplace é feito de forma automática. A [política comercial](/pt/docs/tutorials/como-funciona-uma-politica-comercial) utilizada na etapa [configurar conector](/pt/docs/tracks/configurar-conector-b2w) é o que determina quais dos seus produtos serão enviados para o marketplace. \n\n### Campos enviados\n\nAs informações da sua loja VTEX enviadas para o marketplace são sobre produtos, estoque e preços. Os campos enviados para produtos e SKUs são os seguintes:\n\n| **Produto** |\n| ---------- |\n| Nome |   \n| Descrição |    \n| Marca |\n| Categoria |\n| [Especificações](/pt/docs/tracks/especificacoes-definicao-de-conceito#especificacao-de-produto) |\n\n| **SKU** |\n| ---------- |\n| EAN |   \n| Peso |   \n| Altura | \n| Largura |\n| Comprimento |\n| Imagens |      \n| [Especificações](/pt/docs/tracks/especificacoes-definicao-de-conceito#especificacao-de-sku) |\n\n### Catalogação de produtos\n\nA categoria dos produtos é enviada em formato de _breadcrumb_. Por exemplo: _Masculino > Camisas > Manga Longa_. \n\nA catalogação na B2W é feita de forma automática pela SkyHub. Caso queira alterá-la, entre em contato com o [suporte da SkyHub](https://ajuda.skyhub.com.br/hc/pt-br/categories/115001212186).\n\n### Status de produtos\n\nExistem dois status possíveis para um produto na B2W:\n\n- **Ativo:** aparece no marketplace e está disponível para venda.\n- **Inativo:** não aparece no marketplace e está indisponível para venda.\n\n> ℹ️ Não existem campos obrigatórios para que um produto seja integrado. No entanto, se um produto não possui preço cadastrado ou estoque positivo, ele se torna inativo.\n\n### Exibição de produtos\n\nNa página de detalhes de um produto na [Americanas Marketplace](https://www.americanas.com.br/?spa=true), as variações do produto (SKUs) são agrupadas em uma única interface. No exemplo ilustrado a seguir, o consumidor pode escolher entre as variações de tamanho Gg, P, M e G de uma camiseta.\n\n![print_camiseta_americanas_b2w](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/integrações/configurações-de-integrações/como-funciona-a-integracao-da-skyhub_1.png)\n\n### Atualização de produto\n\nUma vez realizada a integração com a SkyHub, qualquer alteração nos [campos enviados](/pt/docs/tutorials/como-funciona-a-integracao-da-skyhub#campos-enviados) de produtos e SKUs vai automaticamente se refletir na B2W. Por exemplo, se a descrição de um produto for alterada, a nova descrição vai aparecer na B2W sem necessidade de uma atualização manual.\n\n## Estoque\n\nDepois que os produtos recebem a primeira carga de estoque, a atualização será feita SKU por SKU sempre que ocorrer alguma alteração na VTEX. Essa atualização demora apenas alguns segundos para se refletir na B2W, mas o registro desses eventos no Admin VTEX pode levar alguns minutos. Você pode acompanhá-los em **MARKETPLACE > Integrações > Estoque**.\n\n## Preços\n\nA integração envia o [preço de lista](/pt/tracks/precos-101--6f8pwCns3PJHqMvQSugNfP/3XcXp0r5WrJvogB8KIX4Kx#preco-de-lista) e o preço final para cada SKU. O preço final é enviado de acordo com o retorno da [simulação de fulfillment](https://developers.vtex.com/vtex-rest-api/reference/fulfillment-simulation). Em um cenário padrão, o preço enviado será sempre o determinado pela política comercial usada na integração.\n\n> ℹ️ Qualquer alteração no [preço base](/pt/docs/tracks/preco-base-definicao-de-conceito) ou no [preço fixo](/pt/docs/tracks/preco-fixo-definicao-de-conceito) de um produto vai se refletir automaticamente na B2W. Vale ressaltar que o preço fixo se sobrepõe a todas as configurações de preços existentes em uma [tabela de preços](/pt/docs/tracks/tabelas-de-preco-definicao-de-conceito).\n\nNão é possível enviar preços diferenciados em função da forma de pagamento, pois a escolha da forma de pagamento é determinada no ambiente da B2W.\n\n## Promoções\n\nAs únicas promoções aceitas na B2W são as que podem ser calculadas na [simulação de fulfillment](https://developers.vtex.com/vtex-rest-api/reference/fulfillment-simulation). No caso, as seguintes condições podem ser aplicadas:\n\n| **Tipo de desconto** |\n| ---------- |\n| Percentual |\n| Nominal |\n| Frete Nominal |\n| Frete Percentual |\n| Frete Máximo |\n| Frete Grátis |\n\n| **Itens** |\n| ---------- |\n| Categorias |\n| Marcas |\n| Coleções |\n| Produtos |\n\n| **Condições** |\n| ---------- |\n| Valor mín/máximo do pedido |\n| Valor mín/máximo do item |\n| Preço de/por |\n| CEP |\n| Tipo de Frete |\n\n## Pedidos\n\nNo momento do pedido, a SkyHub não consulta o preço do produto e não verifica a quantidade em estoque. Ela considera apenas os últimos dados de preço e estoque enviados na carga inicial ou na última atualização feita.\n\nNesta seção, serão abordados os seguintes tópicos:\n\n- [Integrar pedido](/pt/docs/tutorials/como-funciona-a-integracao-da-skyhub#integrar-pedido)\n- [Interagir com pedido](/pt/docs/tutorials/como-funciona-a-integracao-da-skyhub#interagir-com-pedido)\n- [Faturar pedido](/pt/docs/tutorials/como-funciona-a-integracao-da-skyhub#faturar-pedido)\n- [Enviar pedido](/pt/docs/tutorials/como-funciona-a-integracao-da-skyhub#enviar-pedido)\n\n### Integrar pedido\n\nOs pedidos na SkyHub possuem status próprios, conforme a tabela a seguir. Para saber mais sobre os status de pedidos na VTEX, veja [Fluxo de pedido em Gerenciamento de pedidos](/pt/tutorial/fluxo-de-pedido).\n\n| **Status na VTEX** | **Status na SkyHub** | **Descrição do status na SkyHub** |\n| ---------- | ---------- | ---------- |\n| Aguardando autorização para despachar| _New_ | Novo pedido com pagamento ainda não aprovado|\n| Carência para cancelamento / Pronto para manuseio / Preparando entrega | _Approved_ | Pedido aprovado |\n| Faturado | _Shipped_ | Pedido despachado |\n| Faturado | _Delivered_ | Pedido entregue |\n| Cancelado | _Canceled_ | Pedido cancelado |\n| - | _Overdue_ | Pedido atrasado |\n| _Confirm Stock_ | _Confirm Stock_ | Reserva de estoque | \n\nA VTEX recebe um _feed_ de pedidos da SkyHub e integra apenas aqueles que estão no status `New` ou `Approved`. Nenhum outro status além desses dois será aceito para integrar um pedido. Os pedidos são integrados na VTEX com os mesmos IDs usados pela SkyHub.\n\nCaso um pedido não integre na primeira tentativa, existe uma retentativa automática programada para erros não mapeados pela integração. Em casos de erros conhecidos, é necessário resolvê-los com ações manuais. Para mais informações, veja [Erros de integração de pedidos da B2W](/pt/docs/tutorials/erros-de-integracao-de-pedidos-da-b2w).\n\n### Interagir com pedido\n\nQualquer interação com pedidos da B2W na plataforma VTEX será refletida na SkyHub e vice-versa. Por exemplo, o cancelamento de um pedido pode ser feito tanto no ambiente da VTEX como no da SkyHub, pois um reflete o outro.\n\n### Faturar pedido\n\nAo faturar o pedido na VTEX, a integração atualiza o status na SkyHub para `Shipped` e, depois, para `Delivered`. No entanto, para que isso aconteça, é necessário que alguns campos estejam preenchidos de acordo com cada status.\n\n- Para faturar o pedido na SkyHub, será necessário preencher o campo `invoiceKey`.\n- Para alterar o status para `Shipped`, será necessário preencher o campo `trackingNumber`.\n- Para alterar o status para `Delivered`, será necessário preencher o campo `CourierStatus`. \n\nO campo `CourierStatus` pode ser populado automaticamente por [atualizações de rastreio das próprias transportadoras](/pt/docs/tutorials/quais-transportadoras-disponibilizam-o-rastreio-de-frete) ou manualmente, pela API _[Update Order Tracking Status](https://developers.vtex.com/vtex-developer-docs/reference/updatetrackingstatus)_ ou pelo Admin VTEX, em **PEDIDOS > Gerenciamento de pedidos**. Quando o campo retornar `finished=true`, então o status do pedido é declarado como `Delivered` e a integração envia essa informação ao marketplace. Caso o campo retorne `finished=false`, o status do pedido não é alterado para `Delivered`, permanecendo no status anterior.\n\n> ℹ️ Se você utiliza o serviço [B2W Entregas ou B2W Entregas Direct](/pt/tracks/configurar-integracao-da-b2w--6w07SJBVqE020KIOOS8ygk/5hHCiAMHih2lc5xb3A5Ohp#b2w-entregas-e-b2w-entregas-direct), o preço do frete não entrará no valor do pedido integrado na VTEX e na nota fiscal constará apenas o custo dos produtos. A nota fiscal do frete deverá ser emitida pela própria B2W, que é quem está fornecendo esse serviço.\n\n### Enviar pedido\n\nPara cada novo pedido, a SkyHub consulta a tabela de frete cadastrada na VTEX e retorna apenas uma opção de frete. Para consultar a tabela de frete, é necessário [Cadastrar a API de Frete](/pt/tracks/configurar-integracao-da-b2w--6w07SJBVqE020KIOOS8ygk/3W7OqhHUl2CQKIsAc0SS4g#api-de-frete). A opção de frete que retorna é eleita conforme os critérios a seguir, em ordem de hierarquia:\n\n1. Entrega mais barata.\n2. Entrega mais rápida.\n\nApesar de a SkyHub consultar o frete na VTEX, a integração permite usar uma solução de terceiros para fazer o cálculo. Nesse caso, no momento do pedido, a SkyHub consulta a solução utilizada que, por sua vez, retorna o cálculo do frete.\n\nÉ possível também cadastrar na [SkyHub](https://skyhub.com.br/) uma tabela de contingência. Dessa forma, se por algum motivo a integração não conseguir consultar o frete na VTEX, a SkyHub usa as informações dessa tabela.\n\nNo caso de uma solução de terceiros fazer o cálculo de frete ou no caso de utilizar uma tabela de contingência, a integração faz um _match_ do frete calculado com a transportadora que mais se adequa na VTEX. O parâmetro utilizado é o nome da transportadora escolhida. Caso a integração não consiga encontrar uma transportadora idêntica, a VTEX integra o pedido com a transportadora mais barata disponível.\n\n> ℹ️ Para o seller que utiliza o serviço [B2W Entregas ou B2W Entregas Direct](/pt/tracks/configurar-integracao-da-b2w--6w07SJBVqE020KIOOS8ygk/5hHCiAMHih2lc5xb3A5Ohp#b2w-entregas-e-b2w-entregas-direct), a SkyHub não consulta a VTEX sobre frete, pois o envio é responsabilidade do marketplace. É possível também [Configurar integração de lojas físicas com a B2W](/pt/docs/tutorials/configurar-integracao-de-lojas-fisicas-com-a-b2w) e oferecer ao consumidor a opção de pontos de retirada do pedido.\n\n<br /></br>\n### Saiba mais\n\n- [Integração com SkyHub/B2W](/pt/tracks/configurar-integracao-da-b2w--6w07SJBVqE020KIOOS8ygk)\n- [Configurar integração de lojas físicas com a B2W](/pt/docs/tutorials/configurar-integracao-de-lojas-fisicas-com-a-b2w)\n- [Erros de integração de pedidos da B2W](/pt/docs/tutorials/erros-de-integracao-de-pedidos-da-b2w)"}