Este artigo tem como objetivo descrever todo o fluxo da integração com a CNova/Via Varejo. Desta forma, fica mais claro como funciona a integração e o comportamento esperado em cada etapa. O tutorial está dividido em cinco etapas:

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

A integração envia produto, estoque e preços em entidades separadas. Uma vez que os produtos são enviados com sucesso, já possível encontrá-los na CNova/Via Varejo. A integração envia os seguintes campos:

Produto	SKU
Nome*	EAN
Descrição*	Peso*
Marca*	Altura*
Categoria na VTEX*	Largura*
Especificações	Comprimento*
-	Imagens*
-	Especificações

Em asterisco os campos obrigatórios.

Ao serem enviados com sucesso pela primeira vez, a CNova/Via Varejo recebe os produtos e realiza um processo de catalogação interno. Uma vez que são aprovados pela CNova/Via Varejo, eles não permitem que nenhum campo deste seja atualizado através da VTEX. Caso queira fazer alguma alteração nas informações do produto, é necessário alterar diretamente na CNova/Via Varejo. Ou então, apagar o produto na CNova/Via Varejo e refazer todo o processo de integração desde o começo já com as informações atualizadas.

Ex: se a descrição do produto for alterada, a integração não atualizará a descrição que está no marketplace.

Na CNova/Via Varejo, os produtos possuem dois status possíveis:

• Ativo: disponível para venda
• Inativo: indisponível para venda, fazendo com que o produto não apareça no marketplace.

Lá eles ficam agrupados por um produto que possui diversas variações/skus.

Ex: Cafeteira Preta (produto) | 127V e 220V (variações/skus)

A categoria é enviada em formato de breadcrumb.

Ex: Cozinha > Utensílios > Cafeteiras

Quando um produto é enviado pela primeira vez, o estoque também é enviado. No entanto, ele é descartado pela CNova/Via Varejo, pois eles só aceitam receber os estoques para produtos já catalogados. Esta política existe para que o estoque disponível no marketplace seja sempre o mais atualizado.

Porém, quando esta aprovação é feita, a CNova/Via Varejo não notifica a VTEX disto. Então, a nossa integração não tem como saber quando podemos enviar os estoques novamente. Desta forma, a integração do estoque fica dependente de alguma atualização feita diretamente em Estoque & Entrega.

Depois que os produtos recebem a primeira carga de estoque, a atualização é feita SKU por SKU sempre que ocorre alguma alteração de estoque na VTEX.

Quando um produto é enviado pela primeira vez, o preço também é enviado. No entanto, ele é descartado pela CNova/Via Varejo pois, eles só aceitam receber os preços para produtos já catalogados. Esta política existe para que o preço disponível no marketplace seja sempre o mais atualizado.

Porém, quando esta aprovação é feita, a CNova/Via Varejo não notifica a VTEX disto. Então, a nossa integração não tem como saber quando podemos enviar os preços novamente. Desta forma, a integração dos preços fica dependente de alguma atualização feita diretamente em Preços.

Depois que os produtos recebem a primeira carga de preço, a atualização é feita SKU por SKU sempre que ocorre alguma modificação de preços na VTEX. No entanto, para preços com validade, quando a data expira o sistema não notifica os afiliados. Desta forma, o preço base só será enviado na próxima modificação de preços.

A integração envia os preços 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. Em um cenário padrão, o preço enviado 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.

Ex1: promoção de 10% de desconto para determinada categoria

Ex2: SKU X está R$ 10,00 na política comercial usada na CNova/Via Varejo e tem um preço fixo de R$ 15,00 para essa mesma política. A integração enviará R$ 15,00.

OBS: como a forma de pagamento é feita no marketplace, as regras de pagamento são determinadas por ele. Por conta disto, não conseguimos enviar preços diferenciados em função da forma de pagamento.
Ex: se na VTEX existem juros configurados para pagamentos parcelados, o preço enviado continuará sendo o que a simulação de fulfillment retorna.

Só são aplicadas promoções que conseguem ser calculadas na simulação de fulfillment. Neste caso, as seguintes condições conseguem ser 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	-	-

Quando um pedido é feito no marketplace existem alguns pontos que influenciam em seus detalhes, como entrega, preço e disponibilidade.

Entrega:

Nesta integração existem dois pontos que influenciarão na entrega: Cálculo do Frete e o Tempo de Preparo de Envio. O somatório dos dois será o Tempo de Entrega Total.

Ex:
Frete Normal = 3 dias
Tempo de Custo = 2 dias
Tempo Total de Entrega = 5 dias

• Frete

No momento do pedido, por padrão, a CNova/Via Varejo consulta a tabela de frete cadastrada na VTEX e nós retornamos apenas uma opção de frete para eles, sempre ordenando pela opção mais barata. Vale destacar que, para que seja possível realizar a consulta, é necessário cadastrar a API de Frete no painel da CNova/Via Varejo.

O lojista tem também a possibilidade de cadastrar na CNova/Via Varejo uma tabela de contingência. Dessa forma, se por algum acaso a integração não conseguir consultar o frete na VTEX (ex: instabilidade momentânea) ou a API de Frete não esteja cadastrada no painel deles, a CNova/Via Varejo usa as informações desta tabela. Neste caso, a CNova/Via Varejo nos passa o pedido e a integração tenta fazer um match do frete calculado com a transportadora que mais se adequa dentro da VTEX (usamos o nome da transportadora escolhida como parâmetro). Caso a integração não consiga encontrar uma transportadora igual, nós integramos o pedido usando a transportadora mais barata disponível.

• Tempo de preparo de envio

O tempo de preparo de envio é baseado no somatório do campo Tempo de custo no Estoque com o Tempo de Custo na Doca. E nós enviamos o mesmo tempo de preparo massivamente para todos os produtos.

Ex:
Estoque A
- Doca 1: Tempo de Custo = 3 dias
Estoque B
- Doca 1: Tempo de Custo = 5 dias

Doca 1:
- Tempo de Custo = 2 dias

Um pedido com Tempo de Frete = 3 dias, ficará com um Tempo Total de Entrega diferente dependendo de onde o produto sairá.

Saindo do estoque A:
- Tempo de preparo = 3 + 2 (doca 1) = 5 dias
- Tempo de frete = 3 dias
- Tempo total de entrega = 8 dias
Saindo do estoque B:
- Tempo de preparo = 5 + 2 (doca 1) = 7 dias
- Tempo de frete = 3 dias
- Tempo total de entrega = 10 dias

OBS: no caso de usar a tabela de contingência para fazer o cálculo do frete, a CNova não consulta a VTEX. Desta forma, o único fator que será levado em consideração para o Tempo Total de Entrega, será o Frete fornecido por eles, ignorando o Tempo de Preparo. Deve-se tomar cuidado com isto, pois pode gerar divergências no Tempo Total de Entrega.

Preço e disponibilidade:

No momento do pedido, a CNova/Via Varejo não consulta o preço do produto e nem se ele possui estoque. É considerado apenas o último preço/estoque enviado.

Os pedidos na CNova/Via Varejo dispõem dos próprios status. Segue uma explicação deles comparando com os status dentro da VTEX. Entenda mais sobre os status dos pedidos da VTEX aqui.

Status VTEX	Status CNova/Via Varejo	Descrição Status CNova/Via Varejo
Aguardando autorização para despachar	NEW	Pedido novo
Aguardando autorização para despachar	RAA	Risco de aprovação - pagamento pendente
Aguardando autorização para despachar	PEN	Pagamento pendente
Carência para cancelamento / Pronto para manuseio /Preparando entrega	Pay	Pagamento aprovado
Faturado	SHP	Nota fiscal emitida + Pedido despachado
Faturado	DLV	Pedido entregue
Cancelado	CAN	Pedido cancelado

Antes mesmo de integrar um pedido, a CNova/Via Varejo faz a reserva do mesmo (entenda aqui como funciona a reserva da VTEX). Simultaneamente, a VTEX lê um feed de pedidos na CNova/Via Varejo e integra apenas aqueles que estão nos status NEW e PAY. Qualquer pedido que já tenha passado deste status não será integrado e nem aparecerá nos logs de pedido na aba de Integrações.

Os pedidos são integrados com o mesmo ID usado na CNova/Via Varejo.

Caso um pedido não integre na primeira tentativa, a integração faz infinitas retentativas automáticas enquanto o status do pedido estiver em Pay ou New. Veja mais sobre erros conhecidos da CNova/Via Varejo aqui.

Uma vez que o pedido está integrado, todas as ações feitas na CNova/Via Varejo (antes do status Faturado) que condizem com o andamento do pedido refletem na VTEX. A CNova/Via Varejo é ativa neste quesito.

Ex1: ao aprovar o pagamento na CNova/Via Varejo, o fluxo anda na VTEX.

Ex2: ao cancelar o pedido na CNova/Via Varejo, ele é cancelado na VTEX.

Ex3: ao faturar um pedido na CNova/Via Varejo, ele não é faturado na VTEX.

O único caso de interação ativa na VTEX é no momento de faturar o pedido. Então, ao inserir a nota fiscal e faturar o pedido na VTEX, o pedido é faturado na CNova/Via Varejo.

Porém, nem todas as ações feitas na VTEX refletirão na CNova/Via Varejo.

Ex1: se um pedido for cancelado na VTEX, a integração não conseguirá cancela-lo na CNova/Via Varejo.

Ex2: se um pagamento não foi aprovado ainda na CNova/Via Varejo, e você tentar forçar o andamento do fluxo do pedido na VTEX, o pedido avançará na VTEX, mas continuará no mesmo status na CNova/Via Varejo.

Ao faturar o pedido na VTEX, a integração atualiza o status na CNova/Via Varejo para SHP e posteriormente para DLV. No entanto, para que isto aconteça, é necessário que alguns campos específicos estejam preenchidos de acordo com cada status. Entenda mais sobre o preenchimento destes campos aqui.

• Para alterar o status para SHP será necessário:

  • invoiceKey, trackingNumber, courier e CNPJ (este campo é deve ser preenchido nas configurações da integração

• Para alterar o status para DLV será necessário:

  • courierStatus: este é um campo que pode ser populado automaticamente (via atualizações de rastreio das próprias transportadoras ou manualmente (via API ou interface de Gerenciamento de pedidos). Quando o campo finished=true então o status do pedido é declarado como delivered e a integração envia isso ao marketplace. Caso o campo finished=false, o status do pedido não será alterado para delivered, permanecendo no status anterior.