{"section":"tutorials","requestedLocale":"pt","requestedSlug":"como-funciona-a-integracao-com-o-carrefour","locale":"pt","slug":"como-funciona-a-integracao-com-o-carrefour","path":"docs/pt/tutorials/integrações/configurações-de-integrações/como-funciona-a-integracao-com-o-carrefour.md","branch":"main","content":"Este artigo tem o objetivo de descrever o fluxo da integração do __Carrefour__ com a VTEX. Explicando como ela funciona, fica mais fácil entender o comportamento esperado de cada uma das etapas:\n\n1. [Produtos](#1-produtos)\n2. [Estoque](#2-estoque)\n3. [Preço](#3-preco)\n4. [Promoções](#4-promocoes)\n5. [Pedido](#5-pedido)\n\n## 1. Produtos\n\n### Envio de produtos\nO envio de produtos é feito de forma automática, em torno de 8 horas depois de a [configuração da integração](/pt/tracks/configurar-integracao-com-o-carrefour--2wYlj07cNuA8k8mmwY86K2) ter sido realizada com sucesso. Para isso, ela se baseia na política comercial cadastrada e envia a primeira carga de produtos. \n\nOs campos de produto e SKU são enviados juntos, em um lote separado do lote de ofertas (que reúne informações de preço e estoque dos SKUs). Os dois lotes podem subir ao mesmo tempo e o sistema do Carrefour faz a validação.\n\n### Campos enviados\nPara os produtos serem exibidos no Carrefour, a integração envia os seguintes campos de _produto_ e _SKU_:\n\n| Produto     | SKU     |\n| ---------- | ---------- |\n| Nome*       | Nome*       |\n| Descrição*       | EAN*       |\n| Marca (dependendo da escolha na configuração da integração, a informação vai ser adicionada no título do produto)       | Peso*       |\n| Especificações       | Altura*       |\n| -       | Largura*       |\n| -       | Comprimento*       |\n| -       | Imagens*       |\n| -       | Especificações       |\n\n_Legenda:_\n`*` Campos obrigatórios.<br /> \n\n> ⚠️ O Carrefour não aceita produtos com variação (mais de um SKU).\n\n### Exibição do produto\nUma vez que os lotes de produto e oferta são enviados com sucesso e validados pelo Carrefour, todas as variações/SKUs de um mesmo produto são exibidas juntas, em um mesmo agrupamento.\n\n> ℹ️ Ex: Camisa Azul (produto) | P, M, G (variações/skus)\n\n### Status do produto\nCom todos os produtos processados corretamente e catalogados pelo Carrefour, suas ofertas podem ter os seguintes status:\n\n- __Ativo:__ disponível para venda\n- __Inativo:__ indisponível para venda (quando o produto fica sem estoque), mas ele ainda aparece nos resultados de busca\n\n### Atualizações de produto\nAo serem enviados com sucesso pela primeira vez, os produtos passam por um processo de catalogação interno do Carrefour. Com tudo certo, a integração não atualiza as informações de produto: isso iria desfazer as que já foram cadastradas. \n\nPor exemplo, se a descrição do produto for alterada, a integração não vai atualizá-la no marketplace. Para fazer algum tipo de alteração, você vai precisar entrar em contato direto com o Carrefour.\n\n> ⚠️ **OBS:** o produto não pode ser apagado no painel do Carrefour. Se isso acontecer, a integração não vai conseguir enviá-lo novamente.\n\n## 2. Estoque\nQuando um produto é enviado pela primeira vez, o estoque também é enviado. No entanto, ele é descartado pelo Carrefour, pois eles só aceitam receber os estoques para produtos já catalogados. Essa política existe para que o estoque disponível no marketplace seja sempre o mais atualizado.\n\nPorém, quando a catalogação é concluída, o Carrefour não notifica a VTEX. Isso significa que nossa integração não tem como saber quando é possível enviar os estoques novamente, ficando dependente de atualizações feitas diretamente no Estoque & entrega (módulo da VTEX). No momento em que o Carrefour confirmar a catalogação dos seus produtos, o marketplace vai solicitar à VTEX o envio dos estoques. Mas você pode forçar o envio dessas informações, bastando, para isso, fazer uma alteração qualquer de estoque em cada um dos seus SKUs.\n\nDepois que os produtos recebem a primeira carga de estoque, a atualização é feita SKU por SKU sempre que o estoque na VTEX sofre alguma mudança. Essa atualização é mandada em lotes de 6 em 6 minutos. Isso significa que a integração acumula todas as atualizações da sua loja por 6 minutos e manda tudo de uma vez. Caso a atualização de estoque esteja demorando mais do que o esperado, é provável que haja muitas informações na fila para serem atualizadas.\n\n## 3. Preço\nQuando um produto é enviado pela primeira vez, o preço também é enviado. No entanto, ele é descartado pelo Carrefour, pois eles só aceitam receber preços de produtos que já foram catalogados. Essa política existe para que o preço disponível no marketplace seja sempre o mais atualizado.\n\nPorém, o Carrefour não notifica a VTEX quando tudo foi aprovado. Isso significa que nossa integração não tem como saber quando é possível enviar os preços novamente, ficando dependente de atualizações feitas diretamente no Preços (módulo da VTEX). No momento em que o Carrefour confirmar a catalogação dos seus produtos, o marketplace vai solicitar à VTEX o envio dos preços. Mas você pode forçar o envio dessas informações, bastando, para isso, fazer uma alteração qualquer de preço em cada um dos seus SKUs.\n\nDepois que os produtos recebem a primeira carga de preço, a atualização é feita SKU por SKU sempre que os preços na VTEX sofrem alguma mudança. Essa atualização é mandada em lotes de 6 em 6 minutos. Isso significa que a integração acumula todas as atualizações da sua loja por 6 minutos e mandar tudo de uma vez. Caso a atualização de preços esteja demorando mais do que o esperado, é provável que haja muitas informações na fila para serem atualizadas.\n\n> ⚠️ Note que, para preços com validade, o sistema não notifica os afiliados quando a data expira. Assim, o preço base só será enviado na próxima modificação de preços.\n\nPara cada SKU, a integração envia apenas o preço final, baseado no retorno da simulação de fulfillment. Em um cenário padrão, o preço enviado vai ser sempre o determinado para a política comercial associada à integração. Porém, existem fatores que podem influenciar no preço final, como promoções e preços fixos.\n\n_`Exemplo 1:` uma promoção que oferece 10% de desconto para uma determinada categoria_\n\n_`Exemplo 2:` na política comercial usada no Carrefour, um SKU tem preço de R$ 10 e um preço fixo de R$ 15. O valor que a integração envia para o marketplace é R$ 15._\n\n> ⚠️ **Atenção:** como a forma de pagamento é dada no marketplace, as regras de pagamento também são determinadas por ele. Por causa disso, a integração não consegue enviar preços diferenciados de acordo com a forma de pagamento. <br /> *Ex: se na VTEX estiver configurada a incidência de juros para pagamentos parcelados, o preço enviado vai continuar sendo o que foi retornado pela simulação de fulfillment.*\n\n## 4. Promoções\nDiferente de uma promoção usada para o site da sua loja, uma promoção para marketplace apenas desconta o valor do produto, mas sem indicar que é uma promoção. Ou seja, o preço enviado já está modificado e não há um selo de promoção.\n\nA integração da VTEX com o Carrefour só aplica as promoções que conseguem ser calculadas na simulação de fulfillment. Nesses casos, as seguintes condições são aplicadas:\n\n| Tipo de desconto     | Itens     | Condições     |\n| ---------- | ---------- | ---------- |\n| Percentual       | Categorias       | Valor mín/máximo do Pedido       |\n| Nominal       | Marcas       | Valor mín/máximo do Item       |\n| Frete Nominal       | Coleções       | Preço de/por       |\n| Frete Percentual       | Produtos       | CEP       |\n| Frete Máximo       | -       | Tipo de Frete       |\n| Frete Grátis       | -       | -       |\n\n## 5. Pedido\n### 5.1 - Fazendo o pedido\nOs detalhes do pedido são influenciados diretamente por fatores como entrega, preço e disponibilidade.\n\n#### Frete\nO Carrefour consulta, no momento do pedido, a tabela de frete cadastrada na VTEX. Nossa plataforma retorna para eles as opções de frete disponíveis, de acordo com o mapeamento preenchido na configuração da integração. É importante ter em mente que a consulta só é possível se a [API de Frete](/pt/docs/tracks/enviar-produtos-para-carrefour) for cadastrada no painel do Carrefour.\n\n> ⚠️ OBS: caso nenhum dos campos do mapeamento seja preenchido corretamente, não será possível simular o frete na VTEX. Consequentemente, os pedidos feitos no Carrefour não serão integrados.\n\nSe a API de Frete não for cadastrada, o Carrefour vai usar uma __tabela de contingência__ para fazer o cálculo. Nesse caso, o Carrefour envia as informações do pedido e a integração tenta fazer um _match_ do frete calculado com a transportadora que mais se adequa dentro da VTEX (usamos o __tipo__ de transportadora como parâmetro). Caso não haja uma correspondência, haverá um erro na integração do pedido. Para solucionar isso, você precisará fazer primeiro o mapeamento de frete e, depois, reprocessar o pedido.\n\n#### Preço/Disponibilidade:\nNo momento em que o pedido é feito, o Carrefour __não consulta em tempo real__ o preço ou a disponibilidade em estoque dos produtos na VTEX. O marketplace considera apenas as últimas informações enviadas sobre _preço_ e _estoque_.\n\n### 5.2 - Integrando o pedido\nOs pedidos realizados no Carrefour têm um status próprio. Na tabela abaixo estão explicações de cada um deles e a correspondência com os status de pedidos na VTEX.\n\n| Status VTEX     | Status Carrefour     | Descrição Status Carrefour     |\n| ---------- | ---------- | ---------- |\n| Aguardando autorização para despachar       | STAGING       | Pedido novo onde o pagamento não foi aprovado ainda       |\n| Carência para cancelamento / Pronto para manuseio /Preparando entrega       | SHIPPING       | Pagamento Aprovado       |\n| Faturado       | SHIPPED / CLOSED       | Nota fiscal emitida       |\n| Faturado       | SHIPPED / CLOSED       | Pedido despachado       |\n| Faturado       | Não tem Status       | Pedido entregue       |\n| Cancelado       | Canceled       | Pedido cancelado       |\n\nA VTEX lê o feed de pedidos do Carrefour e faz a integração daqueles que estão com status __Staging__ no marketplace. Os pedidos que estão com qualquer outro status __não são integrados__ e __não aparecem nos logs__ de integração de pedido (seção Integrações no Admin da VTEX). \n\nDurante o processo, pode ser que o pedido não seja integrado por algum motivo. Você pode conferir o que deu errado clicando na opção _Pedidos_, que fica embaixo do item _Integrações_ da seção _Marketplace_ do menu lateral do Admin. Para resolver o problema, descubra o que deve ser feito em cada um dos [principais erros de integração de pedidos no Carrefour](/pt/faq/erros-de-pedidos-no-bridge-como-resolver--3LmQY3zPfiMYy4m2M0Ak2y#carrefour) e tome a ação necessária. Com tudo feito, basta reprocessar o pedido.\n\nDepois que a integração acontece, os pedidos continuam sendo tratados com o mesmo ID usado no Carrefour.\n\n> ⚠️ **OBS:** pedidos com algum tipo de incidente não são integrados. Caso o incidente ocorra depois da integração do pedido, um aviso vai ser exibido na aba de Rastreamento no Admin da VTEX.\n\n### 5.3 Interação do pedido\nDepois que o pedido foi integrado com sucesso, você pode interagir com ele tanto pelo Admin da VTEX quanto pelo painel de administrador do Carrefour. No entanto, algumas ações podem ou não ser aplicadas nos dois lados.\n\n#### Ações que são refletidas tanto na VTEX quanto no Carrefour:\n- Cancelamento de pedido no Carrefour (a integração cancela na VTEX também).\n- Faturamento de pedido na VTEX (a integração fatura e atualiza o status do pedido no Carrefour, conforme explicado a seguir no item `D`).\n\n#### Ações que não são refletidas nas duas plataformas:\n- Cancelamento de pedido na VTEX (a integração __não consegue cancelar__ no Carrefour).\n- Faturamento de pedido no Carrefour (a integração __não consegue faturar__ na VTEX).\n\n### 5.4 Faturando o pedido\nQuando um pedido que veio do Carrefour é faturado na VTEX, a integração faz a atualização do status no marketplace para __Shipped__ e, por último, inclui um campo que corresponde a `pedido entregue`. Mas, para que isso aconteça, campos específicos precisam estar preenchidos. Você pode ver mais detalhes sobre o preenchimento deles em nosso [Guia de Integração de ERPs](https://developers.vtex.com/docs/erp-integration-set-up-order-processing).\n\n__1-__ Para alterar o status para __Shipped__, será necessário:\n`invoiceKey`, `invoiceNumber`, `trackingUrl`, `trackingNumber`, `courier`, `issuanceDate`.\n\n__2-__ Para alterar o pedido com a informação de __entregue ao cliente__, será necessário:\n`courierStatus`: esse campo pode ser populado de modo automático (via [atualizações de rastreio das próprias transportadoras](/pt/docs/tutorials/quais-transportadoras-disponibilizam-o-rastreio-de-frete)) ou manual, via API ou interface de Pedidos, no módulo de Gerenciamento de pedidos. Quando o campo retornar `finished=true`, a integração envia a informação ao marketplace. Se o campo retornar `finished=false`, o pedido não será alterado com a informação de entrega."}