ESSE É UM FAQ PARA USO EXCLUSIVAMENTE INTERNO.
Este FAQ tem como objetivo indicar soluções para problemas e ajudar com duvidas que podem surgir na Integração com a Centauro.
ATENÇÃO: MUDANÇAS SPLUNK PARA OPEN SEARCH
Devido as mudanças relacionadas ao log, favor desconsiderar "queries" relacionadas ao splunk mencionadas neste FAQ, recomendamos a uitlização do seguinte arquivo como referencia, até que o FAQ seja atualizado. (Estas novas queries tambem estão disponiveis para consulta no canal #team-connections.
UPDATE FAQ | CLIQUE AQUI E ACOMPANHE AS ULTIMAS ATUALIZAÇÕES DO NOSSO FAQ
O FAQ ESTÁ CLASSIFICADO DA SEGUINTE FORMA:
1. UPDATE FAQ | ACOMPANHE AS ULTIMAS ATUALIZAÇÕES DO NOSSO FAQ
2. TICKETS | QUAIS INFOS PODEM AJUDAR O TIME DE PRODUTO EM UMA INVESTIGAÇÃO?
3. QUESTIONS | PRODUCTS
4. QUESTIONS | ORDERS
5. QUESTIONS | SETTINGS
6. INVESTIGATIONS | PRODUCTS
7. INVESTIGATIONS | SETTINGS
8. INVESTIGATIONS | ORDERS
QUAIS INFOS PODEM AJUDAR O TIME DE PRODUTO EM UMA INVESTIGAÇÃO?
Ficou com duvida na hora de criar um ticket para Connections? CLIQUE AQUI
Temos algumas dicas que podem ajudar a melhorar nossa comunicação e diminuir o "vai e vem" dos tickets, dando assim mais agilidade no atendimento/resposta do time de produto. Aqui estão algumas dicas que achamos essencial para iniciar uma investigação.
QUESTIONS | PRODUCTS
Q: Integração sku com erro "The Attribute value is invalid"
A: Este erro geralmente esta relacionado aos atributos mapeados nas colunas "Centauro Atributo Valor" e "Loja Atributo Valor" [ticket referencia]
Q: SKU sem o atributo "COR" ou SKU sem o atributo "TAMANHO"
A: Estes erros geralmente estão relacionados a mapeamento [ticket 01] [ticket 02]
Q: Marketplace aceita alteração de imagem depois que o sku foi aprovado/integrado?
A: Nós como integração sempre sempre enviamos update image, mesmo o SKU já estando integrado, já do lado da Centauro depois que o SKU é integrado eles também aceitam, porém eles podem recusar esta atualização caso o sku esteja aprovado pela moderação.
Q: É possível realizar o envio de kits?
A: Não temos esta feature implementada na Centauro.
Q: Considerando que a integração não faz a integração de KIT na Centauro, pq o seller conseguiu integrar alguns kits e outros não?
A: Se ele integrar vai integrar como um sku normal, nao como KIT. Em resumo, como não está mapeado na aplicação, nem a configuração e nem o SKU tem flag para identificar se é kit ou não, então o SKU kit vai integrar como um SKU normal, sem nenhuma restrição ou tratamento.
Q: Skus com erro "The product already exists in the Centauro's system"
A: Este problema acontece do lado da Centauro e já é de conhecimento do marketplace, o erro vai acontecer quando da timeout na primeira requisição enviada pra cadastrar esses produtos. Infelizmente do nosso lado nada pode ser feito, então recomentamos que nestes casos o seller siga com um chamado direto com a Centauro, passando o a descrição do erro e os skus impactados.
Q: Sku mapeado corretamente, mas segue logando erro "O Atributo pode estar faltando ou o mapeamento do atributo pode estar errado/faltando"
A: Normalmente este erro vai acontecer quando já existe um mapeamento mais "generica" para esta mesma categoria, por exemplo: a integração vai pegar da categoria mais genérica pra mais especifica, ou seja se estiver mapeado a categoria 6 e a 52 a integração vai olhar para a categoria 6.
Mas o seller mapeou apenas a 52, não deveria pegar a 52?
Se existir um mapeamento realizado anteriormente para esta categoria a integração vai pedir a catgoria 6, por exemplo: anteriormente na planilha só tinha mapeado TAMANHO usando a categoria 6, então como a integração esta pegando a mais genérica primeiro, ele esta olhando só para a categoria 6, devido ao mapeamento já realizado anteriormente. Obs: não é possível modificar.
Q: Skus com erro "Access Denied. You don't have permission to access."
A: Até onde sabemos este erro ocorre quando a Centauro passa por algum pico de requisições, e então algumas requisições são bloqueadas (eles trabalham com um rate limit de 30 requisições por segundo), ideal neste caso é que o seller abra um ticket com o suporte centauro para registrar o ocorrido.
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: "The description has not been informed or is invalid"?
A: Isso acontece 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: Sim, mas existe uma particularidade, em conversa com a Centauro, fomos informados que só é possível alterar se o produto não estiver aprovado pela moderação centauro, ou seja recusado, do contrário é necessário abrir uma solicitação de alteração junto ao marketplace. Importante lembrar que a descrição do produto, fica somente no produto, e não no SKU.
Q: É possivel alterar o nome de um sku integrado e aprovado na Centauro?
A: Não, só é possível alterar se o produto não estiver aprovado pela moderação centauro, do contrário é
necessário abrir uma solicitação de alteração junto ao marketplace. Importante lembrar que a informação do nome do produto, fica somente no produto, e não no SKU.
QUESTIONS | ORDERS
Q: Pedidos com erro "Could not find order 95058500001 of hub Vtex and seller with CNPJ 419239350X"
A: Este erro pode ocorrer por dois motivos
card da integração
1. token cadstrado errado/invalido
2. account centauro incorreto
Solução
Seller deve acionar o time da Centauro para revisao destes pontos
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: Em quais status um pedido pode ser cancelado na VTEX?
A: A integração não valida o status do pedido para fazer cancelamento. Então se o pedido foi criado na VTEX ele vai executar o cancelamento normalmente, independente se está faturado ou não.
Q: entao se o pedido for cancelado na centauro deveria cancelar aqui na VTEX independendte do status, certo?
A: Exatamente, salvo alguma regra interna do Checkout que não conhecemos.
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 cotaçã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 acontece?
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).
https://help.vtex.com/pt/tutorial/vincular-um-account-name-a-um-website-binding--PxjfleOw6suCSO2uGWMMs?&utm_source=autocomplete
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.
Importante: por via de regra a Centauro precisa ter a marca como parte do nome do produto e para evitar erro por ser uma obrigatoriedade por parte da Centauro nós realizamos a concatenação do nome + marca. O mesmo ocorre para Gênero (que é recomendado pela Centauro sua presença no título) e, nesse caso, nossa integração busca automaticamente especificações de Produto com nome "Gênero", "Genero" ou "Genre" para compor o título junto com marca
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 | SETTINGS
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
Comentários