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 FAQ 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: "Questions" e "Investigations"

QUESTIONS | PRODUCTS


Q:
Como funciona o fluxo para integração de um sku na Centauro?
A: O Conector vai mandar o SKU pra Centauro, se for a primeira vez então vai cair no fluxo de criação de SKU, nessa hora é criado um de/para entre VTEX e Centauro, indicando que o SKU foi criado na Centauro.
No momento que existe esse de/para, indicando que existe o SKU na Centauro, a integração passa a enviar requests para atualização de estoque assim que a notificação bater na integração. Antes de criar o SKU, a integração vai verificar que não existe o de/para para o SKU e vai descartar a notificação.

Q: Por que alguns skus apresentam erro: "message":"The description has not been informed or is invalid" na integração?
A: Porque a Centauro faz ulgumas validações na descrição do sku, então vai retornar este erro nas seguintes situações:
- Quando o campo estiver nulo;
- Quando o campo estiver vazio;
- Quando o campo possui mais de 4000 caracteres.

Q: É possivel alterar a descrição de um produto já integrado com sucesso na Centauro?
A: Não, em conversa com a Centauro, fomos informados de que a API de alteração de produto só pode ser utilizada para produtos criticados. Para produtos já aprovados é necessário abrir uma solicitação de alteração junto ao marketplace.

 

QUESTIONS | ORDERS

 

Q: Como funciona o fluxo para pedidos não pagos? Por exemplo: Boleto
A: De acordo com o fluxo da integração da Centauro, recebemos notificações de novos pedidos ainda não pagos/aprovados no marketplace com o status NEWe integramos os mesmos na VTEX. Caso o pagamento acabe não sendo feito ou não seja aprovado, recebemos uma notificação com o statusNOT_APPROVED, e cancelamos o pedido aqui no nosso lado. Ou seja, esses pedidos são integrados, e caso não aprovados, são cancelados automaticamente.

Q: Como funciona o De/Para status pedidos VTEX x Centauro?
A: O fluxo funciona da seguinte forma:

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

 

QUESTIONS | SETTINGS


Q: Centauro tem simulação de frete online aqui na VTEX? Como é feita a cotção de frete?
A: Na Centauro, não tem cotação de frete com a gente, o que acontece hoje é que eles fazem a cotação por lá e mandam o valor direto no pedido. Ai quando chega na integração, a gente faz a cotação de frete do nosso lado e mandamos integrar o pedido, geralmente tendo alguma divergência no preço de frete entre oq a gente calculou aqui e o que a Centauro mandou.

Q: Se dá erro na simulação versus o que ele manda, o que acotnece?
A: Se no pedido tiver um valor diferente do frete que a gente conseguiu calcular na integração, a gente tenta integrar o pedido com o valor que calculamos do nosso lado e isso deve causar um erro na hora de integrar, ai a gente checa o quanto divergiu do preço (em %) e bate isso com o que o seller configurou lá no bridge (Percentual de tolerância na divergência do valor do pedido *), se a diferença for menor ou igual ao que foi passado no bridge, a gente muda o preço para oq estava no pedido e desce ele de novo (agora vai integrar), caso contrário, é disparado uma mensagem de erro pro bridge indicando que houve uma diferença maior que o configurado e ai ele precisa aceitar a divergência manualmente (caso queira integrar o pedido)

 

INVESTIGATIONS | PRODUCTS


Cenário: "Estoque/Preço não estão sendo atualizados"
Como investigar: 
O Fluxo de atualização de preço e estoque nos marketplaces funciona assim:
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.

1. Primeira metade do fluxo = Merch
2. Segunda metade = Connections

É 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

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

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

Cenário: "The product name has not been informed or is invalid."
Como investigar:
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}}

Cenário: "O serviço Centauro falhou.”
Como investigar:
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}}

 

INVESTIGATIONS | MAPPING


Cenário: "Planilha Base de Valores da Centauro"
Como investigar: 
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.

3. 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”.

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

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

 

INVESTIGATIONS | ORDERS

 



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

Comentários