ESSE É UM FAQ PARA USO EXCLUSIVAMENTE INTERNO.
Este FAQ tem como objetivo indicar soluções para problemas e duvidas que podem surgir na Integração com o Google
Importante: caso não encontre sua resposta a seguir e necessitar abrir um chamado com o time de ps-connections é necessário solicitar ao cliente acesso ao Google Merchant para os seguintes e-mails:
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-marketplace-out
Importante - Help VTEX
1. Antes de iniciar uma investigação, confirmar se o seller esta utilizando XML e API simultaneamente.
2. Alem disso, verifique se o seller utiliza a integração Nativa(API) ou XML, no caso de uma integração Nativa a investigação segue com Connections, se for XML deve ser verificado com o time de Merch.
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. TREINAMENTO | GOOGLE SHOPPING
4. DIAGRAMA | FLUXO INTEGRAÇÃO DE PRODUTOS NO GOOGLE SHOPPING
5. QUESTIONS | PRODUCTS
6. QUESTIONS | SETTINGS 7. INVESTIGATIONS | PRODUCTS
8. INVESTIGATIONS | SETTINGS
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.
TREINAMENTO | GOOGLE SHOPPING
Já assistiu nosso treinamento? Aqui mostramos como funciona a configuração da integração,
autenticação, erros comuns e possiveis causas: https://vtex.slack.com/archives/C928RF5PC/p1609936369293200
DIAGRAMA | FLUXO INTEGRAÇÃO DE PRODUTOS NO GOOGLE
QUESTIONS | PRODUCTS
Q: Implementing Custom Labels feature (12/03/2025)
A: O novo mapeamento de Custom Labels foi desenvolvido para a Americanas classificar e gerencias suas ofertas, e qualquer merchant pode usar para identificar a fonte de origem da sua oferta por exemplo.
Q: Gostaria de tirar uma dúvida sobre a funcionalidade de migração de catálogo do Google. Nossa documentação indica que seria necessário criar uma política comercial como primeiro passo, mas gostaria de entender melhor o motivo dessa exigência e se existe alguma forma de fazermos com a política principal da loja ou se ela só seria necessária no momento da migração e depois poderia ser desativada, seguindo via política principal. Isso porque o Google não é parceiro certificado, logo, essa política comercial não é bonificada e teria um custo mensal considerável para algo que não vai ter uma função prática no on going da loja, além do momento da migração.
A: A integração "obriga" inserir uma política, e nao pode ser inexistente, tem que existir mas não pode ter nenhum sku vinculado, o objetivo é evitar o envio de produtos que ficariam no limbo sem atualizações.
Q: Configurar desconto de preço à vista para Google Shopping - HELP VTEX
Q: É possível por meios nativos enviar os campos multipack e link móvel
A: Estes atributos podem ser incluídos nas especificações de produto (se for incluído será enviado)
Q: Bebidas Alcoólicas no Google Shopping
A: Uma vez concluída a integração, a categorização dos seus produtos terá sido realizada de forma automática. Porém, há casos em que um produto é reprovado porque o Google considera que a categoria atribuída a ele está incorreta [mais detalhes]
Q: Pq os skus estão sendo reprovados no Google Merchant Center pelos seguintes motivos: [ticket referencia]
1. Página de destino para computadores indisponível
2. Página de destino para dispositivos móveis indisponível
Erros:
1. O tempo limite de leitura da página foi esgotado
2. Resposta HTTP 5xx
A: Estes erros não estão relacionado a integração em si, isso pq nós como integração só enviamos a URL do produto para o Merchant Center, então se o link da url foi enviado corretamente do lado da integração esta tudo certo. Depois do envio da URL, quem fica responsável por atualizar as informações é ocrawler google, que passa visitando todas as paginas de produto.
Q: Qual a diferença entre"error"e"warning"no Merchant Center?
A: Sobre Error = Google reprova o sku e ele deixa de ser exibido nos resultados de busca;
Sobre Warning = é apenas um aviso, não reprovado sku e ele é exibido normalmente nos resultados de busca, mas sinaliza que o sku tem uma melhoria a ser revisada.
Q: Pq no merchant center o idsku é diferente?
A: Isso acontece pq o google concatena o PRODUCTID + SKUID. Então o padrão que vc vai ver no merchant center la na coluna "Id do item" vai ser o seguinte ID "999773617_913056".
Primeira parte | ID DO PRODUTO = 999773617
Segunda parte | SKUID = 913056
Q: No card da integração (storeconfig) com o GS temos uma chave "enviar preço" com as opções "sem multiplicador de unidade" e "com multiplicador de unidade", considerando esta regra, como enviamos o preço para o google, quando o seller seleciona "com multiplicador de unidade"?
A: O checkout responde um valor multiplicador por item na chamada de simulação. O preço é calculado com (sellingPrice / unitMultiplier)) / 100
Q: Quando um item está ativo na VTEX, mas com categoria inativa no catálogo VTEX, deveria ser disponibilizado no merchant?
A: O fato da categoria estar desativada não deve ser impeditivo para envio do SKU. Inclusive ao enviar o pedido ao GS existe uma flag SendGoogleCategories que possibilita o cliente enviar o SKU sem enviar a categoria, resultando em. um envio null para o marketplace.
Q: A integração considera PIX como pagamento a vista? (08/02/2024)
A: Sim, hoje a integração considera opções de pagamento como Boleto OU PIX, mas é muito importante lembrar que eles não funcionam simultanamente, ou seja, vai funcionar para PIX OU Boleto.
Q: Tem alguma previsão de implementar o funcionamento destes descontos a vista simultaneamente?
A: Não, esta limitação não fica na integração, o google mesmo só aceita uma fonte de "desconto".
Q: Seller externo não consegue integrar sku, erro no bridge: "Ineligible SKU"
A: Primeiro passo é entender em que seller estes skus estão vinculados e analisar os logs, ticket com passo a passo da investigação para referencia: https://vtexhelp.zendesk.com/agent/tickets/621989
Q: Integração enviou price e sale price corretamente, mas a "tag promocional" não aparece no anuncio do google.
A: Nós como conector não temos controle sobre esta tag, mas é importante ter em mente que o google possui algumas regras para exibição, esta documentação do google explica os requisitos para que essa tag apareça no produto: https://support.google.com/merchants/answer/9017019?hl=pt-BR
Q: Como funciona a tag de "Redução no preço"?
A: Se você mudar o preço do produto para um menor do que o valor médio listado antes, o Google vai mostrar no item o selo "Redução no preço". Esse ícone é mostrado apenas quando houver uma redução significativa do preço de um produto que não mudava muito há algum tempo. Importante ter em mente qye nós como conector não temos controle sobre esta tag, esta documentação do google explica os requisitos para que essa tag apareça no produto: https://support.google.com/merchants/answer/11435005?hl=pt-BR
Q: É possivel criar um campo no feed pra receber a árvore de categorias do produto?
A: Não, hoje a integração não suporta este tipo de configuração, nossa documentação pode ajudar com o contexto correto para mapeamento de categorias no GS https://help.vtex.com/pt/tutorial/configurando-a-categoria-global--tutorials_188
Q: Os produtos estão sendo reprovados devido a um campo incompatível: Atributo "installment" incompatível [parcela]. Tentei procurar esse campo, mas não consigo encontrar.
A: A configuração do parcelamento(installment) não é definida pela integração, enviamos o que a simulação retorna para a integração. O parcelamento é definido no Admin > Transações > Pagamentos > Configurações
Q: Por que existe divergencia de 0,01 centavo nos skus enviados para o Merchant Center?
A: Esta divergencia acontece quando o seller habilita a feature de enviar o preço à vista no GS no card da integração, a solução é a implementação do paymentSystemId na PDP da pagina do produto, seguindo documentação e Checkout API - Desconto
Q: O que pode causar divergência de preço/estoque no Google Shopping?
A: Antes de iniciar uma analise, verifique se o seller utiliza a integração Nativa(api) ou XML, no caso de uma integração Nativa a investigação segue com Connections, se for XML deve ser verificado com o time de Merch. Considerando estes pontos, recomendamos a revisão das seguintes configurações:
Configuração VTEX
Passo 1. Verificar se a conta está autenticada;
Passo 2. Verificar se o endpoint foi configurado corretamente para o afiliado do Google Shopping;
Passo 3. Verificar se as configurações do card estão condizentes com as informações do afiliado;
Passo 4. Verificar se o produto esta vinculado a politica comercial do GS;
Passo 5. Verificar as configurações de um sku de exemplo realizando a simulação de Checkout.
Passo 6. Verificar se o Sku possui preço fixo cadastrado (Consultar: "Preço do sku não foi atualizado no Marketplace.")
Splunk
Passo1. Verifique se o broadcaster esta recebendo notificação para alteração de preço/estoque
index=ccnotificator account=teste 2148137
Passo 2. Verifique no log se o preço/estoque está sendo enviado corretamente para o marketplace.
index=gsintegration account=teste
Configuração Merchant Center
Passo 1. Solicite ao seller acesso ao Merchant Center;
Passo 2. Melhorias Automáticas > Ativar atualização automática de itens > Recomendamos que o seller mantenha esta chave desligada, como a integração já faz a atualização para preço/estoque não é necessário habilitar. Quando habilitada em uma integração nativa pode causar conflito e divergência de preço.
Passo 3. Qual valor esta sendo gravado no campo "Atributos do feed bruto: account API"? Este campo dentro do Merchant Center é o mais importante, é aqui que o seller consegue validar oq a integração esta enviando para o google.
Crawler google
Depois disso quem fica responsável por atualizar as informações é o crawler google , que passa visitando todas as paginas de produto. Quando o crawler não consegue ver o preço corretamente, provavelmente existe algum erro relacionado a estrutura da pagina.
Esta ferramenta do google pode ajudar a investigar os erros relacionados a estrutura da pagina
https://search.google.com/test/rich-results?id=ajJ9-HfCwo7rJUd13N1glg
Importante
Nós como integração, não temos controle da estrutura e customizações das paginas de produto, mas existem algumas documentações que podem orientar a agencia/seller:
https://help.vtex.com/pt/tutorial/configuring-discounts-for-orders-prepaid-in-full-on-google-shopping--40K3R5d4NogMvCzIWdWt3e
https://developers.vtex.com/vtex-developer-docs/changelog/improvement-in-first-installment-payment-discount-configuration
Q: Por que alguns skus logam erro: "Errors: Attribute too large"?
A: Esse erro pode ocorrer por dois motivos:
1. O nome/titulo do SKU possui mais de 50 caracteres;
2. As descrições do produto excedem 5.000 caracteres.
Solução: diminuir o tamanho desses atributos para que os itens sejam enviados via API.
Documentação Google: https://support.google.com/merchants/answer/6324468?hl=pt-BR&ref_topic=6324338
Q: O que significa "Ineligible SKU"?
A: Isso significa que aquele produto foi considerado inelegível para a integração. Produtos podem se tornar inelegíveis pelos seguintes motivos:
- O produto está sem preço.
- Produto fora da politica comercial;
- O produto não possui imagem.
- Não há estoque do produto e ele foi configurado para ser excluído quando sem estoque.
Q: Gostaria de entender melhor o fluxo de atualização de preço na integração no Google Shopping para os produtos que são de seller NÃO VTEX, que usam HUB EXTERNO para integração de catalogo com a VTEX.
A: Quando o Marketplace é externo, o fluxo deve ser visto com o #team-marketplace. Todos os sellers externos precisam notificar o marketplace quando o preço muda, e isso precisa ser suficiente para os fluxos do próprio marketplace atualizem seus dados aonde necessário (como outras integrações externas). Quando o marketplace é externo e não nativo, a disponibilidade dos produtos é de responsabilidades deles. Para confirmar se o conector esta atualizando corretamente, é possivel forçar uma notificação, se o broadcaster for notificado, então conector esta ok.
[Notificação - Preço]
http://{{AccountName}}.vtexcommercestable.com.br/api/notificator/changenotification/{{Idsku}}/price
[Notificação - Estoque]
http://{{accountName}}.vtexcommercestable.com.br/api/notificator/changenotification/{{Idsku}}/stock
[Notificação - Produto]
http://{{AccountName}}.vtexcommercestable.com.br/api/notificator/changenotification/{{Idsku}}
Q: Pq alguns skus mostram uma diferença de -5% no Merchant Center sobre o valor cadastrado no Catalogo da VTEX?
A: Nestes caso, verifique se a chave "Considerar desconto para pagamento com boleto no preço enviado (Desconto à vista)" esta habilitada. Se sim, o seller habilitou a modalidade de pagamento por boleto bancário, ou seja, o preço do produto enviado para o Google Shopping será o valor com esse desconto. A integração vai enviar o preço do sku considerando o desconto. (A chave fica dentro dentro do card de configuração da integração do GS).
Q: O Google Shopping expira produtos sem atualização em 30 dias?
A: Sim, mas não é necessária nenhuma ação do seller, pq temos um sistema que faz este controle e manda uma atualização de 30 em 30 dias.
Q: Como é realizado o preenchimento do atributo item_group_id no XML da integração nativa?
A: Ele funciona assim: ItemGroupId = sku.ProductId, isso quer dizer que ele vai olhar e pegar o ProductId.
Q: É possível configurar de alguma forma oitem_group_id no XML da integração nativa?
A: Não, pq ele pega essa informação dando um Get lá no produto inserido no GoogleShopping.
Q: É possível enviar customlabels para o Google Shopping usando a integração Nativa?
A: Sim, é possível gerenciar tags personalizadas no VTEX Google Merchant Connector.
Se o produto tiver algum campo de especificação registrado, o conector o enviará.
Como você pode ver nas conexões da conta. Os campos marcados com (*) no final no Google são personalizados.
Q: Como funciona o envio de preço promocional?
A: A integração envia o preço definido na política comercial vinculada ao Google Shopping". Se existir preço de oferta (De/por), será enviado somente o preço "Por". Se existir promoção de desconto à vista (promoção condicionada ao método de pagamento BOLETO), esse benefício será aplicado ao valor do produto antes do envio. Caso essa flag de desconto de boleto esteja habilitada no card de configuração.
Q: Como funciona a flag "Não enviar EAN (GTIN)"?
A: Quando o cliente aciona essa flag no card de configuração, os skus são enviados para o Google com o campo “gtin”= null no Json. Mas existe uma regra no Google shopping sobre o envio de algumas propriedades. Quando não enviamos o "Gtin" no caso Gtin=null, o google exige que o campo "mpn" seja preenchido (mpn é o código do fabricante).
Se o mpn não estiver preenchido na VTEX, a integração também envia esse campo como “null”.
Estes produtos aparecem no Google Merchant com um alerta, quando enviamos assim, mas isso não invalida o produto e pode ser vendido normalmente, mas pode prejudicar a performance.
Documentação complementar:
https://support.google.com/merchants/answer/6324482?hl=pt-BR
Q: Quando a integração atualiza o feed de produtos?
A: A integração vai atualizar em duas situações:
- Carga inicial. (Quando o lojista configura a integração.)
- Sempre que existir uma alteração de catálogo. (SKU, preço e estoque.)
Q: Como funciona o fluxo para atualização de um SKU?
A: Sku reindexado > Sku entra em uma fila (esta fila é compartilhada com todas as outras contas) > Skus vão sendo reprocessados de acordo com a fila > Caso o Sku apresente um erro no reprocessamento, ou ele é re-enfileirado (no final da fila) ou descartado > Ele volta para o final da fila.
Q: É possível alterar imagem de um sku já integrado com sucesso?
A: Sim, a integração é notificada sempre que o sku é atualizado(re-indexado)
Q: Qual a média de tempo para atualização de um sku no GS?
A: Sobre o tempo medio, é dificil dizer, vai depender muito do tamanho da fila > É necessario analisar o log + data e entender se este sku voltou para o final da fila (pq recebeu algum erro ou foi reprocessado). Lembrando que caso o Sku apresente um erro no reprocessamento, ou ele é re-enfileirado (no final da fila) ou descartado. Query para analisar log: index=gsintegration account={{accountname}} {{idsku}}
QUESTIONS | SETTINGS
Q: Configuração de afiliados e andpoint para cenarios de conta principal e sub-account usando google.
A: Em resumo, no fluxo hoje as subaccounts herdam as integrações da conta principal pra isso funcionar ele teria que criar afiliado id diferente pra cada conta [ticket]
Por exemplo:
Principal mantem GSM
Sub-account - GSC
Q: Quando clico no link do sku disponivel no bridge estou recebendo erro 404
A: Este erro pode ocorrer quando a URL cadastrada no Google Merchant Center do cliente esta diferente, fora do padrão ou não foi verificada pelo GS.
Documentação Google pode ajudar com esta etapa de verificação: https://support.google.com/merchants/answer/176793?hl=pt-BR
Exemplo url cadastrada corretamente e verificada no Merchant Center:
INVESTIGATIONS | PRODUCTS
Cenário: "Sku não integra com o google shopping."
Como investigar: Primeiro Passo, realize uma simulação de checkout, aqui é possível entender qual a situação do sku no momento da integração.
Neste exemplo checkout retornou erro: "Ocorreu um erro de comunicação com o Catálogo - Acesso não autorizado do seller 1 para o sales channel "26".
Qual o significado deste erro?
Este erro normalmente esta relacionado a configuração do binding da loja. Precisa associar a politica comercial do Google Shopping (IdPoliticacomercial) no binding da {{Account}}. Após realizar este processo, indexa os produtos para serem atualizados/enviados para o GS.
Como funciona?
https://help.vtex.com/pt/tutorial/o-que-e-binding
Entenda mais sobre políticas comerciais e webstie binding
https://help.vtex.com/tutorial/como-funciona-a-relacao-entre-websites-e-politicas-comerciais
Cenário: "Preço do sku não foi atualizado no Marketplace."
Como investigar: Primeiro passo, avaliar se o sku possui preço fixo cadastrado no catalogo e se foi atualizado.
Sim, Preço fixo foi atualizado > Pular este passo e seguir com a próxima analise (Estoque/Preço não estão sendo atualizados (como investigar))
Não, não possui preço fixo > Neste caso a integração não é notificada sobre alteração de preço. Somente alterações de "Preço Fixo geram notificações ao broadcaster.
Regra de preço
https://help.vtex.com/pt/tracks/precos-101--6f8pwCns3PJHqMvQSugNfP/2rBirbpB7wLnei4dQ9KGMW
Atualizar preço para marketplace
https://help.vtex.com/pt/tutorial/atualizando-preco-para-marketplace--tutorials_384
Preço Fixo - Definição de conceito
https://help.vtex.com/pt/tracks/precos-101--6f8pwCns3PJHqMvQSugNfP/3HxF2u5VwidqnUGnFoKdDy?locale=pt
Mas o Seller não usa "Preço Fixo" o que fazer neste caso?
Caso o seller queira que os preços notifiquem para atualizações de preços não fixos, ele pode definir uma regra de preço, mesmo que vazia para essa política específica e o workflow do pricing de notificação de preços irá chamar o broadcaster.
Como configurar esta regra de preço:
Acesse o Admin > Produtos > Preços > Regras de Preço > Nova Regra >
Nova regra : Quais os dados gerais dessa regra? Selecione a politica comercial (recomendamos criar uma regra para cada politica comercial existente na loja). Em quais itens esta regra será aplicada? Selecione a opção "Aplicar em todos os produtos"
Importante: Após cadastrar preço fixo, solicitar uma atualização em massa para todos os skus.
Cenário: "Sku não integra. Mensagem de erro "insertion error: Ineligible Sku."
Como Investigar: Para melhor entender o status desse sku que está tentando integrar, o ideal é realizar uma simulação de fulfillment:
cURL
curl --location --request POST 'https://{{Accountname}}.vtexcommercestable.com.br/api/fulfillment/pvt/orderForms/simulation?sc={{Pol%C3%ADticaComercial}}&affiliateId={{Afiliado}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"items": [{
"id": "32309",
"quantity": 1,
"seller": "1"
}],
"marketingData": null,
"postalCode": "22250040",
"country": "BRA",
"selectedSla": null,
"clientProfileData": null,
"geoCoordinates": [],
"isCheckedIn": false,
"storeId": null
}'
“Price” para validar se o sku possui preço válido;No resultado dessa simulação, é necessário analisar os campos:
- “Stockbalance” para validar se o sku possui estoque;
- “Message” para validar a disponibilidade do sku.
Caso todas as informações estejam corretas, tente reprocessar o sku. Se a mensagem de erro persistir, é necessário abrir um chamado com o time de Connections, passando as análises feitas acima.
Cenário: "Seller White Label não atualiza preço no Google Shopping".
Como Investigar: É muito importante lembrar que a integração é passiva, ou seja, ela vai atualizar o GS com aquilo que o CHK retornar, então considerando este ponto o primeiro passo é e ntender como o seller foi configurado:
- Qual integradora o seller usa para notificar a VTEX?
-
Qual rota da VTEX a integradora usa pra notificar essas alterações de SKU, seja preço ou estoque?
Caso não tenha nenhuma integradora, entender com o seller como foi feita a integração e quais rotas estão sendo usadas para notificação de preço e estoque.
Nesta documentação o google explica os formatos aceitos:
doc google
Cenário: "Produtos não aparecem no Bridge".
Como Investigar: Normalmente este problema está relacionado a configurações do Google Shopping, para identificar a causa deste problema, é necessario seguir os seguintes passos:
Passo 1. Verificar se a conta está autenticada;
Passo 2. Verificar se o endpoint foi configurado corretamente para o afiliado do Google Shopping;
Passo 3. Verificar se as configurações do card estão condizentes com as informações do afiliado;
Passo 4. Verificar se o produto esta vinculado a politica comercial do GS;
Passo 5. Verificar as configurações de um sku de exemplo realizando a simulação de Checkout.
Cenário: "Mesmo com as configurações corretas, produto não atualiza preço".
Como Investigar: Antes de seguir com a investigação, é necessario entender como funciona o Fluxo de atualização de preço e estoque para o Marketplace:
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 = Time Merch
2. Segunda metade = Time Connections
FLUXO ESTOQUE
1. Catalogo Notifica Broadcaster sobre alteração de estoque
2. Broadcaster notifica a integração
3. Integração faz a simulação com checkout
4. Checkout consulta a rota de logistics /api/logistics/pvt/inventory/items/:skuId/v2?sc=1
5. Checkout devolve oq estava disponivel na rota de logistics
6. Integração atualiza o marketplace
É necessário investigar cada passo para identificar a falha no fluxo. Como no Google Shopping não há envio de quantidade de estoque (somente sku disponível ou indisponível), só iremos tratar a parte de atualização de preço:
1. Cliente altera preço no pricing:
Verificar histórico de alteração da informação no splunk. Assim, obter a informação de data e hora da última atualização de informação.
2. 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 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 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 “https://portal.vtexcommercestable.com.br/api/googleshoppingintegration/notification?accountName={{account}}” é 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 Connections, sendo imprescindível constar no ticket a query utilizada no splunk e o erro identificado
4. Integração altera o 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 do Google Shopping, é preciso verificar nos logs do splunk o envio dessa informação, pesquisar pela seguinte query: index=gsintegration accountName={{accountName}} idSku={{skuId}} workflow_type=UpdateStockKeepingUnit
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 Connections, 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 checkout 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 checkout para consultar os valores de estoque e preço que serão enviados ao marketplace.
API de checkout:
POST http://{{accountName}}.vtexcommercestable.com.br/api/checkout/pvt/orderForms/simulation?sc={{políticacomercial}}
- Se a simulação de checkout 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.
- Se a simulação de checkout 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.
INVESTIGATIONS | SETTINGS
Comentários