Ops! Esse email nao possui permissão para abertura de ticket. Por favor, entre em contato com o responsável pela sua loja para providenciar o acesso.

Centauro - FAQ Interno

ESSE É UM FAQ PARA USO EXCLUSIVAMENTE INTERNO.

Este guia tem como objetivo indicar soluções para problemas que podem surgir na Integração com a Centauro. Este artigo está dividido em 2 seções: "Anúncios/Produtos" e "Configurações".

Anúncios/Produtos

 

Estoque/Preço não estão sendo atualizados (como investigar)

 

O Fluxo de atualização de preço e estoque nos marketplaces é:

Cliente altera estoque/preço no catálogo/pricing -> catálogo/pricing notifica o Broadcaster -> Broadcaster notifica a integração -> integração altera o estoque/preço no marketplace.

  • Primeira metade do fluxo = Merch
  • Segunda metade = Channels

É necessário investigar cada passo para identificar a falha no fluxo.

  1. Cliente altera estoque/preço no catálogo/pricing:

Se for estoque, verificar histórico de alteração da informação no admin.

Se for preço, verificar histórico de alteração da informação no splunk:

link do splunk

Assim, obter a informação de data e hora da última atualização de informação.

2. Catálogo/Pricing notifica o Broadcaster:

O Broadcaster (ou ccnotificator) é o sub-sistema responsável por distribuir e disparar notificações sobre alguma alteração de produto, preço ou estoque à cada um dos afiliados. Para que ele dispare essas informações, é necessário que ele seja notificado de alguma alteração ocorreu.

Sendo assim, é necessário pesquisar pelo log de notificação no splunk. 

Se for estoque, pesquisar pela seguinte query:

index=ccnotificator account={{accountName}} workflow_instance={{idSku}} workflow_type=EnqueueStockChangeNotification

Se for preço, pesquisar pela seguinte query:

index=ccnotificator account={{accountName}} workflow_instance={{idSku}} workflow_type=EnqueuePriceChangeNotification

 

  • Caso na data e hora em que houve a última alteração da informação (passo 1) não houver um log de notificação, a falha no fluxo deve ser tratada com o time de Merch.

 

3. Broadcaster notifica a integração:

Após o broadcaster ser notificado de que houve uma alteração de informação, é necessário que ele repasse essa informação para todos os afiliados.

Portanto, é preciso verificar se há logs no splunk de que essa informação foi repassada.

Se for estoque, pesquisar pela seguinte query:

index=ccnotificator account={{accountName}} {{affiliateID}} workflow_instance={{idSku}} workflow_type=NotifyAffiliatesAboutStockChangeAsync

Se for preço, pesquisar pela seguinte query:

index=ccnotificator account={{accountName}} workflow_instance={{idSku}} workflow_type=NotifyAffiliatesAboutPriceChangeAsync

  • Caso esse log esteja com a mensagem de erro “Ocorreu um erro de comunicação com o catálogo de produtos. Acesso não autorizado do seller 1  para o sales channel “x”.” é necessário verificar o binding para a política comercial cadastrada no marketplace (tanto da account quanto da subaccount).
  • Caso esse log esteja apontando para um endpoint diferente de “http://centaurointegration.vtexinternal.com.br/api/centaurointegration/indexedstockkeepingunit?an={{accountName}}” é necessário ajustar para esse endpoint, provavelmente o cliente fez alguma alteração manual.

 

  • Caso esse log esteja com algum erro não identificável, a falha no fluxo deve ser tratada com o time de Channels, sendo imprescindível constar no ticket a query utilizada no splunk e o erro identificado

 

4. Integração altera o estoque/preço no marketplace:

Considerando que o passo 3 tenha sido realizado com sucesso no fluxo, é necessário verificar agora se a integração realizou a alteração necessária no marketplace. 

Para o caso da Centauro, é preciso verificar nos logs do splunk o envio dessa informação:

Se for estoque, pesquisar pela seguinte query:

index=centaurointegration account={{accountName}} workflow_instance={{skuId}} workflow_type=ProcessInventoryItemAsync

Se for preço, pesquisar pela seguinte query:

index=centaurointegration account={{accountName}} workflow_instance={{skuId}} workflow_type=ProcessPriceItemAsync

 

  • Caso esse log não exista ou esteja com um erro não identificável, a falha no fluxo deve ser tratada com o time de Channels, sendo imprescindível constar no ticket a query utilizada no splunk

 

  • Caso esse log esteja com um valor diferente do cadastrado no admin da VTEX ou no módulo de Pricing, é necessário realizar uma simulação de fulfillment para analisar quais as informações de estoque e preço estão sendo repassadas para a integração , pois a integração utiliza a informação retornada pela simulação de fullfilment para consultar os valores de estoque e preço que serão enviados ao marketplace. 

API de fulfillment:

POST https://{{accountName}}.vtexcommercestable.com.br/api/fulfillment/pvt/orderForms/simulation?sc={{PolíticaComercial}}&affiliateId={{Afiliado}}

  1. Se a simulação de fulfillment retornar o valor que a integração enviou, então esse é o valor realmente cadastrado no sku. É necessário entender com o time de Checkout o motivo da divergência de valores.
  2. Se a simulação de fulfillment retornar um valor diferente do que a integração enviou, então é porque houve uma mudança recente nos valores do sku. Para atualizar a informação, basta realizar uma mudança no sku para que ele seja atualizado novamente no marketplace.

 

Erro de envio de sku. Mensagem no bridge: "The product name has not been informed or is invalid."

 

Existe uma limitação de até 100 caracteres para nome de um sku do lado da Centauro. Para corrigir esse erro, é preciso alterar o nome do sku.

OBS: É sempre importante verificar se o erro no splunk é o mesmo mostrado no bridge. Pois algumas vezes o erro no bridge está desatualizado.

index=centaurointegration account={{accountName}} workflow_instance={{skuId}}

 

Erro de envio de sku. Mensagem no bridge: "O serviço Centauro falhou.”

 

A Integração tem uma regra onde quando mandamos uma atualização de sku, ela faz primeiro uma validação de saldo, e se o saldo for igual a zero, ela para a validação e não tenta continuar  o processo já logando o erro no bridge.

Ou seja, nesse caso não se trata de um bug, só é preciso inserir estoque no sku e reenviá-lo.

OBS: É sempre importante verificar se o erro no splunk é o mesmo mostrado no bridge. Pois algumas vezes o erro no bridge está desatualizado.

index=centaurointegration account={{accountName}} workflow_instance={{skuId}}


----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Configuração

 

Planilha Base de Valores da Centauro

 

Planilha com os códigos de cores, tamanhos e sabores da Centauro:

https://docs.google.com/spreadsheets/d/1RiZLOJl6JBjaL7-_sK3LLHOvcyAgaQh0KTT1pKOz5RM/edit#gid=0

 

Planilha Modelo da integração com Centauro

 

Planilha que o cliente deve preencher no card de configuração

https://docs.google.com/spreadsheets/d/1r0pQ7Z8U-LH3i3ViRw9Y2q6o12BPy2GHlU34NRMd1bQ/edit#gid=0

  1.   ID Categoria: é o ID da categoria na VTEX. Você consegue encontrá-lo do lado do nome de cada categoria ao expandir a árvore.
  2. Loja Atributo Nome: é o nome do campo de SKU usado na sua loja na VTEX.

Ex: campos como "Tamanho", "Cor”.

Os atributos deverão ser preenchidos na planilha exatamente do modo como estão preenchidos na VTEX, incluindo letras maiúsculas e minúsculas.

  1.   Centauro Atributo: é o nome da especificação, mapeado na Centauro, que corresponde ao campo de SKU que você usou no campo Loja Atributo Nome.

Ex: se você usou "Cores" na coluna Loja Atributo Nome, então o nome correspondente na Centauro seria "COR".

Os valores aceitos são “COR” e “TAMANHO”.

  1.   Loja Atributo Valor: nome do valor usado no campo de SKU na VTEX.

Ex: para uma especificação de "Cor", os valores desse campo seriam as próprias cores usadas na loja, como "Vermelho", "Preto", "Branco" etc.

As variações deverão ser preenchidas na planilha exatamente do modo como estão preenchidas na VTEX, incluindo letras maiúsculas e minúsculas.

  1.   Centauro Atributo Valor: nessa coluna você deve preencher valores aceitos pela Centauro, correspondentes aos valores usados no campo Loja Atributo Valor. Na Planilha de Variações da Centauro, busque pelos valores aceitos para cada especificação que você preencheu na coluna Loja Atributo Valor.

Ex: se você preencheu o Loja Atributo Nome com Cores e o Loja Atributo Valor com "Preto", verá que o valor aceito pela Centauro é "02”.

Caso o SKU não tenha uma certa especificação (como cor, por exemplo), você vai precisar cadastrá-la na VTEX antes de completar o processo de integração (pode ser a nível de sku ou a nível de produto). Por exemplo, pode-se criar uma Cor como “N/D” e mapear com o código da Centauro “00” que corresponde a cor nula.

----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Pedidos

De/Para status pedidos VTEX x Centauro
 


Centauro notificou VTEX de um pedido novo = NEW
Centauro notificou que o pedido foi aprovado = APPROVED
O seller faturou o pedido na VTEX = INVOICED
O seller adicionou ao pedido as informações de tracking (Tracking Number e URL) = SENT
Bateu notificação, vindo da VTEX, de pedido entregue na integração = DELIVERED



Tem mais dúvidas? Envie uma solicitação

Comentários