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:

1. Produtos
2. Estoque
3. Preço
4. Promoções
5. Pedido

O envio de produtos é feito de forma automática, em torno de 8 horas depois de a configuração da integração ter sido realizada com sucesso. Para isso, ela se baseia na política comercial cadastrada e envia a primeira carga de produtos.

Os 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.

Para os produtos serem exibidos no Carrefour, a integração envia os seguintes campos de produto e SKU:

Produto	SKU
Nome*	Nome*
Descrição*	EAN*
Marca (dependendo da escolha na configuração da integração, a informação vai ser adicionada no título do produto)	Peso*
Especificações	Altura*
-	Largura*
-	Comprimento*
-	Imagens*
-	Especificações

Legenda: * Campos obrigatórios.

O Carrefour não aceita produtos com variação (mais de um SKU).

Uma 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.

Ex: Camisa Azul (produto) | P, M, G (variações/skus)

Com todos os produtos processados corretamente e catalogados pelo Carrefour, suas ofertas podem ter os seguintes status:

• Ativo: disponível para venda
• Inativo: indisponível para venda (quando o produto fica sem estoque), mas ele ainda aparece nos resultados de busca

Ao 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.

Por 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.

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.

Quando 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.

Poré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.

Depois 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.

Quando 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.

Poré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.

Depois 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.

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.

Para 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.

Exemplo 1: uma promoção que oferece 10% de desconto para uma determinada categoria

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.

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.

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.

Diferente 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.

A 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:

Tipo de desconto	Itens	Condições
Percentual	Categorias	Valor mín/máximo do Pedido
Nominal	Marcas	Valor mín/máximo do Item
Frete Nominal	Coleções	Preço de/por
Frete Percentual	Produtos	CEP
Frete Máximo	-	Tipo de Frete
Frete Grátis	-	-

Os detalhes do pedido são influenciados diretamente por fatores como entrega, preço e disponibilidade.

Frete

O 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 for cadastrada no painel do Carrefour.

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.

Se 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.

Preço/Disponibilidade:

No 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.

Os 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.

Status VTEX	Status Carrefour	Descrição Status Carrefour
Aguardando autorização para despachar	STAGING	Pedido novo onde o pagamento não foi aprovado ainda
Carência para cancelamento / Pronto para manuseio /Preparando entrega	SHIPPING	Pagamento Aprovado
Faturado	SHIPPED / CLOSED	Nota fiscal emitida
Faturado	SHIPPED / CLOSED	Pedido despachado
Faturado	Não tem Status	Pedido entregue
Cancelado	Canceled	Pedido cancelado

A 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).

Durante 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 e tome a ação necessária. Com tudo feito, basta reprocessar o pedido.

Depois que a integração acontece, os pedidos continuam sendo tratados com o mesmo ID usado no Carrefour.

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.

Depois 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.

Ações que são refletidas tanto na VTEX quanto no Carrefour:

• Cancelamento de pedido no Carrefour (a integração cancela na VTEX também).
• Faturamento de pedido na VTEX (a integração fatura e atualiza o status do pedido no Carrefour, conforme explicado a seguir no item D).

Ações que não são refletidas nas duas plataformas:

• Cancelamento de pedido na VTEX (a integração não consegue cancelar no Carrefour).
• Faturamento de pedido no Carrefour (a integração não consegue faturar na VTEX).

Quando 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.

1- Para alterar o status para Shipped, será necessário: invoiceKey, invoiceNumber, trackingUrl, trackingNumber, courier, issuanceDate.

2- Para alterar o pedido com a informação de entregue ao cliente, será necessário: courierStatus: esse campo pode ser populado de modo automático (via atualizações de rastreio das próprias transportadoras) 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.