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 o Mercado Livre.
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.
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 | ORDERS
4. QUESTIONS | TRACKING
5. QUESTIONS | PRODUCTS
6. QUESTIONS | SETTINGS
7. INVESTIGATIONS | ORDERS
8. INVESTIGATIONS | PRODUCTS
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 | Match de anúncios - BuyBox
https://help.vtex.com/pt/tracks/configurar-integracao-do-mercado-livre--2YfvI3Jxe0CGIKoWIGQEIq/43uD4LPU5PLUWe11IaWwyR
https://help.vtex.com/pt/announcements/match-de-anuncios-mercado-livre--1RZPtcsPMSZd2VbNkvAqz9
Q: Essa questão de subir direto no buybox, não tem como subir o anuncio "normal" também?
A: Se o anuncio for restrito ao buybox, não.
Q: Quanto tempo um anuncio fica no status "Processando relevância"
A: Então, perguntamos ao Meli e eles disseram que não tem um prazo. Pode ficar alguns dias mesmo até eles processarem. Quando eles atualizam, a recebemos uma notificação e atualizamos a tela, ou seja, se esta em processamento é pq ainda nao fomos notificados pelo ML
Q: Existe um campo chamado catalog_listing
A: Seus valores possíveis são verdadeiro e falso:
1. Verdadeiro significa: catálogo (BuyBox)
2. Falso significa: tradicional
Q: Quem decide se vai ser um anuncio do tipo buybox ou tradicional vai ser o Mercado Livre com base nas regras de negocio definidas pelo marketplace.
A: Mercado Livre: As regras de buybox são definidas pelos times de negócio. Os produtos mais tradicionais e que já estão "produtizados" (ou seja, o nosso time de catalogo já tem toda a ficha técnica), além de outros critérios, eles tornam obrigátorio as categorias a serem de buybox.
Q: Nesse caso você disse que alguns domínios só integram como buybox mesmo e que esses produtos faziam parte desse domínio, por isso só subiam como buybox. Eu passei isso para o cliente, indicando que só subiriam como buybox mesmo e o cliente voltou me falando que quando ele alterou o EAN desse produto ele subiu normal também e é isso que eu gostaria de entender. Esse domínio tem relação com o EAN? Quando ele alterou o EAN alterou o domínio também fora do buybox?
A: Sim, o domínio tem a ver com o EAN, pois o EAN define a categoria e a categoria define o domínio no Meli. Então, quando ele trocou o EAN, a categoria pode ter mudado e o domínio tbm, consequentemente. Então, pode ter passado de um domínio obrigatório para um opcional, por exemplo
Q; Como eu consigo saber quais categorias estão nesse cenário?
A: Determinação do MELI que está sempre atualizando, seller tem que ver com eles
Q: Como é definido quais categorias são essas, é uma configuração do produto ou vem do Meli?
A: Vem do MELI, nós só enviamos os skus e especificações, categorias
Q: Pq anuncio buy box foi criado com sucesso mas o anuncio tradicional esta com erro no bridge? Este comportamento é normal?
A: Sim, quando um SKU pertence a uma categoria de domínio Opcional ou Aviso Prévio, a publicação no Meli do anúncio tradicional é feita automaticamente. Logo, pode ser gerada uma mensagem no Bridge sem o - Buybox com um erro ou exportado com sucesso. Ao mesmo tempo, é gerada uma outra mensagem com - Buybox informando que há um anúncio de catálogo disponível para ser publicado. Daí, se o seller publica ou não este anúncio de catálogo, pode ocorrer um fluxo de sucesso ou erro, independentemente do anúncio tradicional. Nesses casos, as mensagens podem de fato ser diferentes
Q: Como sei se o anuncio é buybox?
A: Existe um campo chamado catalog_listing , seus valores possíveis são verdadeiro e falso
- Verdadeiro significa: catálogo (BuyBox)
- Falso significa: tradicional
QUESTIONS | ORDERS
Q: Pedido no status "Cancelamento Solicitado" no OMS
A: Já levantamos esse ponto ao time de produto, e o entendimento foi que: Quando um pedido é cancelamento no MELI, vamos sempre enviar a o cancelamento para a VTEX, mas dependendo do status atual do pedido no OMS, eles exigem um segundo request que seria a "confirmação do cancelamento", e esse segundo request a nossa integração não vai fazer, pois entendemos que cabe ao seller decidir se ele realmente vai cancelar o pedido no OMS, pois podem ter cenários especificos onde a entrega já saiu, ou diversas outras situações. Então basicamente o "Cancelamento solicitado" é um cenário esperado, e cabe ao seller aceitar o cancelamento, lembrando que como eu disse antes tem cenários que o OMS exige somente um cancelamento e nesses casos o pedido será cancelado sem ação do Seller.
Q: Pedido criado com CPF = 11111111111
A: Quando comprador fecha um pedido sem preencher estas informações o marketplace disponibiliza o campo "document" = "null". Só que o OMS nao deixa criar um pedido com document=null entao pra conseguir criar o pedido o campo "document" é preenchido com "11111111111"
Então temos um erro? na verdade nao!
este tratamento existe exatamente pra que o pedido nao tenha erro na integração e seja criado com sucesso no OMS [ticket]
Q: Como acontece a reserva de estoque no Mercado Livre?
A: Só integramos pedidos do meli no status "Paid", ou seja, integramos o pedido no OMS assim que o mesmo for pago no MELI, mas não fazemos reserva de estoque no MELI antes de criar o pedido, a única integração que estamos fazendo reserva de estoque antes de integrar o pedido é a integração da Amazon.
Q: Pq o pedido não foi cancelado no Mercado Livre?
A: Quando a origem do cancelamento é VTEX nós não cancelamos no MELI
Ou seja, o fluxo só funciona:
MELI > VTEX = Pedido Cancelado ✅️
VTEX > MELI = Pedido não pode ser cancelado ❌️
Q: Pedido integrou cancelado ou pedido foi criado cancelado na VTEX (OMS)
A: Sobre as integrações, nós não integramos pedidos com status divergentes do fluxo incial de criação de pedidos, ou seja, se o pedido estiver cancelado, entregue, etc no marketplace nós não integramos. [Como investigar]
Q: Pedidos antigos sendo integrados
A: Vamos importar todos os pedidos que ainda estavam/estão com o status "Paid" no Mercado Livre, ou seja o status correto de importação dos pedidos.
Q: Pedidos duplicados
A: Isso acontece pq quando eles ligaram a integração nativa com a VTEX, a integração vai importar todos os pedidos que ainda estão com o status "Paid" no Mercado Livre, que é o status correto de importação dos pedidos. E se eles tinham importado um pedido já mas ele permaneceu no status "paid" no MELI após a migração, esse pedido foi importado novamente. [ticket]
Q: Existe alguma informação no produto que, caso seja alterada, faz com que a integração reconheça esse produto como "novo" e crie um novo anúncio ao invés de atualizar o antigo? Pelas informações de integração com marketplaces é dito que após a criação do anúncio são atualizadas apenas as informações de preço e estoque, correto? Dessa forma, existe um vínculo do produto com o marketplace feito pela VTEX ou algo do tipo?
A: Só vamos criar um novo anúncio se o antigo tiver sido deletado do MELI
Q: Por que os pedidos no MELi aparecem a mensagem no bridge: "Não é possível integrar esse pedido, pois ele foi criado manualmente no Mercado Livre. A plataforma VTEX recomenda fazer migração de anuncios para receber todos os pedidos da VTEX afim de manter as vendas, reputação e a posição orgânica de seus anúncios. Pedido: XXXXXXXXX
A: Essa mensagem foi ajustada para Warning no bridge, pois não é efetivamente um erro, mas um aviso que o a VTEX não pode importar o pedido pois o anúncio não foi criado pela VTEX.
Q: É possível receber as informações de parcelamento dos pedidos feitos no marketplace. No admin só aparece o valor inteiro, mesmo se o pedido for parcelado no marketplace (14/09/2021)
A: Por enquanto não trazemos essa informação de parcelamento do MELI, teria que entender com o Meli se é possível e se for o caso teria que ser implementado.
Q: É possível um mesmo pedido ter diferentes modalidades de entrega no Meli (me1 e me2). Exemplo: cliente foi comprar 2 itens no meli de um mesmo seller, mas um item é me1 e o outro me2, é possível? O pedido entra como um só ou é separado?
A: Não é possível, pois o pedido é agrupado em um envio (shipping) e nesse shipping tem o modo de envio (me1 ou me2...). Nesse shipping é possível ter mais de um pedido sim, mas aí todos vão ter o mesmo modo de entrega.
Q: Pedido não integrou e log mostra erro "Order with invalid fields. PickupId and ShipmentId are null or empty"
A: Normalmente este erro ocorre quando o pedido não possui nenhuma informação de entrega cadastrada.
Solução: Sugere-se que o vendedor entre em contato com a equipe do Mercado Livre para entender como adicionar informações de entrega a este pedido.S em esses dados, não poderíamos integrar adequadamente o pedido com a VTEX.
Exemplo
QUESTIONS | TRACKING
QUESTIONS | TEMPLATE MENSAGENS MERCADO LIVRE
Q: Quanto aos templates das mensagens de Pagamento Aprovado e Código de Rastreio, quais são os gatilhos exatos dos disparos destas mensagens? [ticket]
A invoice deve ter TrackingNumber.
A invoice deve ter TrackingUrl.Entregue:
Campo da invoice: invoice.CourierStatus.Finished deve ser true.
Q: Temos como customizar gatilhos para essas mensagens?
A: Não é possível customizar gatilhos para essas mensagens.
QUESTIONS | PRODUCTS
Q: Sobre erro: Variation attribute is duplicated. Allowed unique attributes combinations. Duplicates: COR=BEGE
A: Ver detalhes ticket
Q: Sobre o erro Os seguintes atributos precisam ser criados para configurar o me2: AGE_GROUP."
A: Ver detalhes ticket
Q: The attributes [GTIN] are required for category [MPE127757]. Check the attribute is present in the attributes list or in all variation's attributes_combination or attributes.
A: Ticket como referencia
Q: Sku não integrado pois o id da loja oficial configurado não é válido. Verifique com a equipe do Mercado Livre se você possui uma ou mais lojas oficiais atrelada a sua conta.
A: Possivel causa e solução ticket
Q: Integração skus com aviso shipping: User has not mode me1 e Free shipping is mandatory
A: Gravamos no bridge o aviso que o Meli retorna.
Free shipping is mandatory
Isso significa que a atualização foi bem-sucedida, mas, em alguns casos o seller não configurou o frete grátis mas o frete grátis é obrigatório, então Meli está dizendo: "seu anúncio foi publicado com frete grátis".
User has not mode me1
Aqui Meli diz que o seller não tem o me1 habilitado, porque na verdade ele não está configurado em suas preferências de envio. (Não sabemos pq o Meli retorna esta mensagem, mas na verdade o seller realmente nao tem m1 configurado como shipping_preferences, então de alguma forma faz sentido.
Q: Anuncios/skus que foram integrados pela ferramenta de "BuyBox" estão chegando sem o EAN (Código Universal)
A: O fluxo de exportação de Buybox não envia atributos não obrigatórios, por isso o GTIN não está sendo enviado (contexto)
Q: Sobre descrição no MELI
A: https://vtexhelp.zendesk.com/agent/tickets/1079850
Q: Log de criação sku?
A: Buscar por "CreateTraditionalAdOnMeliAsync" no OS
Q: Duvidas sobre migração de uma account
https://www.notion.so/vtexhandbook/MeLi-Listings-Migration-09a8febabdfa480180e48c1ad576a5ef
https://vtexhelp.zendesk.com/agent/tickets/1081420
https://vtexhelp.zendesk.com/agent/tickets/1081148
https://vtexhelp.zendesk.com/agent/tickets/1117183
Q: É possivel alterar imagem de um anuncio?
A: Não, isso pq o envio das imagens de um produto ocorre apenas uma vez, quando o anúncio é criado no Mercado Livre. Portanto, se o produto tiver sua imagem alterada na VTEX após ter sido integrado com Mercado Livre, esta informação não será atualizada.
Um possível workaround é excluir o anúncio no Mercado Livre e enviar as informações do produto novamente para o Mercado Livre, reindexando o produto na VTEX. No entanto, ao realizar esta ação, você deve saber que todo o histórico deste anúncio será excluído no Mercado Livre. Será criado um novo anúncio, sem nenhuma relação com as informações do anúncio anterior.
Q: Seller deseja criar vários anúncios para um único produto. Gostaria de saber se seria viável e como realizar essa configuração?
A: Nao é possivel, só um 1 classic e 1 premium
Q: Existe alguma forma de alterar a ordem em que as imagens são enviadas para o MeLi? Isso porque no MeLi há a obrigatoriedade da primeira imagem ter fundo branco, enquanto no site principal a primeira imagem dos produtos é ambientada. Conseguimos realizar isso?
A: Não é possivel, isso pq sempre vamos pegar a ordenação que o merchant fez no catalogo VTEX.
Q: Como realizar migração de anuncios?
A: Seguir os passos da seguinte documentação: https://www.notion.so/vtexhandbook/MeLi-Listings-Migration-09a8febabdfa480180e48c1ad576a5ef
Q: Caso um cliente queira deletar a integração e recomeçar ela do zero, temos de deletar informações aqui do nosso lado, ou basta somente desligar a integração e depois integrar novamente? Essa pergunta é porque o cliente já tomou esta ação outrora com Amazon, e o que ocorreu foi uma divergência de Produtos, uma vez que eles adotaram os mesmos skuIds para itens diferentes, e quando refizeram a integração o item no marketplace não era o mesmo do Catálogo atual.
A: Vejo que pra começar 100% do zero só se o seller deletar tudo direto no MELI, inativar aqui, e começar de novo. Ou oque já vi o pessoal fazer é criar um novo UserId do lado do MELI, porque ai sim começa tudo zero reputação e tal e configura esse novo userId aqui na integração.
Q: Como inativar o sku no marketplace? E qual comportamento do SKU no marketplace caso o seller apenas "Inative" o sku no catalogo VTEX?
A: O Sku pode se comportar das seguintes formas:
1. Produto removido da politica comercial: Produto pausado no Mercado Livre;
2. Sem estoque em todas as variantes: Produto pausado no Mercado Livre;
3. Produto inativo: Produto pausado no Mercado Livre;
Q: Porque a impressão de etiqueta no Mercado Livre retorna erro "404 not found"?
A: O Mercado Livre só permite a impressão da etiqueta em determinados status do shipping, pois entende que só nesse momento o seller está apto, status: ready_to_ship
Q: Por que alguns skus retornan erro na integração? “Your authorization code or refresh token may be expired or it was already used.”
A: O token pode expirar no Mercado Livre por alguns motivos, um deles é a mudança de senha no painel do cliente. Para corrigir, é necessário deletar o card de configuração e refazer todo o processo, inclusive a etapa de autenticação.
Q: Como inativar o sku no marketplace?
A: Produto removido da politica comercial: Produto pausado no Mercado Livre;
Q: Qual comportamento caso o seller apenas "Inative" o sku no catalogo VTEX?
A: Produto pausado no Mercado Livre;
Q: Qual comportamento o produto não tenha estoque em todas as variantes no catalogo VTEX?
A: Sem estoque em todas as variantes: Produto pausado no Mercado Livre;
Q: Porque o MELI sobe as imagens como miniatura das variações?
A: this happens due to a rule from MELI, which is: when the AD has different images for the SKUs, MELI will show the images itself, as they understand the seller may want to show that, and when ALL images are exactly the same then MELI will show the number of the sizes in the images, looking at this SKU the images might be the same, but MELI validates the images using the path inside it, and the path of this images are NOT the same for all SKUs, to fix that they can go directly to SKUs images in VTEX and upload the same for these 3 variations
QUESTIONS | SETTINGS
Q: O cliente fez a ativação do Mercado Envios full, porém, agora ele precisa desativar essa opção pois esta pendente de uma integração externa. Minha dúvida: Conseguimos apoiá-lo de alguma forma pela VTEX?
A: Este é um processo estritamente feito com o ML, infelizmente não temos como ajudar ativando ou desativando o full (não temos api outra forma de seguir por aqui)
Q: É possível termos uma tabela de frete específica na VTEX para o Mercado Livre? Posso fazer algo misto, como Mercado Envios para algumas categorias e frete dinâmico para outras?
A: A tabela de frete é subida diretamente no Mercado Livre, ele consulta de acordo com o que você preenche nela. Sobre fazer algo "misto" não é possivel, o FD funciona como uma camada acima da planilha, ele consulta todos os anúncios e retorna o frete. Caso de algum problema nessa consulta, ele retorna o que está na planilha.
Q: Estou recebendo o seguinte erro “Object Reference not set to an instance of an object.”
A: Essa mensagem de erro geralmente está relacionada a um problema no código. Uma das verificações a serem feitas antes de abrir um chamado com o time de Connections é validar se o país cadastrado na política comercial setada para o Mercado Livre é um país em que o Mercado Livre opera.
Q: Por que não consigo salvar meu card de configuração? Mensagem de erro: Erro! Ação com Erro!
A: Para identificar a origem da mensagem de erro, é preciso verificar o response via devTools. Exemplo, para o caso do erro: "Nome do afiliado não pode ser repetido" é preciso remover o afiliado do Meli, nas configurações de afiliado, e salvar a configuração novamente.
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 funciona assim:
Cliente altera estoque/preço no catálogo/pricing -> Catálogo/pricing notifica o Broadcaster -> Broadcaster notifica a integração -> Integração busca o valor atualizado - > Integração altera o estoque/preço no marketplace.
1. Primeira metade do fluxo = Merch(preço) ou Logistics(Catálogo)
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
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}} workflow_instance={{idSku}} workflow_type=NotifyAffiliatesAboutInventoryChangeAsync
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://meliintegration.vtexinternal.com/api/meliintegration/commercialcondition?an={{accountName}}<=gold_pro” para o caso de Meli Premium ou “http://meliintegration.vtexinternal.com/api/meliintegration/commercialcondition?an={{accountName}}<=gold_special” para o caso de Meli Classic é 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 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 do Mercado Livre, é preciso verificar nos logs do splunk o envio dessa informação:
Se for estoque, pesquisar pela seguinte query:
index=meliintegration account={{accountName}} workflow_instance={{skuId}} workflow_type=UpdateStockAsync
Se for preço, pesquisar pela seguinte query:
index=meliintegration account={{accountName}} workflow_instance={{skuId}} workflow_type=UpdatePriceAsync
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
1. Caso esse log esteja com um valor diferente do cadastrado no admin da VTEX ou no módulo de Pricing, é necessário buscar o log da simulação de fulfillment para analisar quais as informações de estoque e preço foram repassadas para a integração no momento da atualizaçã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.
Para buscar esse log, é necessário buscar pela seguinte query no exato momento do log anterior (UpdateStockAsync / UpdatePriceAsync): index=meliintegration account={{accountName}} workflow_instance={{skuId}} workflow_type=GetInfoAsync
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: "Sku não integra. Mensagem de erro: “The attributes [BRAND, MODEL] are required for category MLBXXXX”
Como Investigar: Essa mensagem significa que a categoria na qual o cliente está mapeando aquele sku exige o mapeamento de Marca e Modelo. Essas informações devem estar presentes na planilha de mapeamento e, para o caso de Modelo, nas especificações do sku. Formato de exemplo:
Cenário: "Sku não integra. Mensagem de erro: “Items in category MLXXXX cannot exceeds Y pictures.”
Como Investigar: Essa mensagem está relacionada com o seguinte comportamento da integração:
Existe o elemento principal do anúncio e ele contém as variações (que são os skus na VTEX). Sempre que um produto possui variações, todas as suas imagens são adicionadas nesse elemento principal.
Acontece que cada categoria tem sua especificação de quantidade de imagens que podem ser adicionadas.
Exemplo, para o caso da categoria MLA3697 são somente 12 imagens permitidas para esse elemento principal. Veja no link as condições dessa categoria:
https://api.mercadolibre.com/categories/MLA3697
Caso o sku esteja respeitando o limite de imagens e ainda assim apresenta esse erro, é necessário abrir um chamado com o time de Connections, apresentando as evidências mencionadas.
Cenário: "Sku não integra. Mensagem de erro: “Sku não integrado pois o mesmo não possui descrição.”
Como Investigar: Essa mensagem está relacionada com o seguinte comportamento da integração. Para os skus novos, ao enviarmos para o Meli a sua descrição o fluxo é:
1. Procurar se ele possui uma especificação de produto chamada plaintext_description_meli, se possuir enviamos ela como descrição;
2. Procurar se ele possui um template de Mercado Livre, se possuir enviamos ele como descrição (para garantir que o template está funcional, verificar se ele aparece no preview).
3. Procurar se ele possui uma descrição no catálogo, se possuir enviamos ela como descrição.
4. Caso não possua nenhum dos passos anteriores (ou eles estejam com erro), logamos o erro no Bridge de "Sku não integrado pois o mesmo não possui descrição." e o sku não é enviado.
Cenário: Por qual motivo meu anúncio BuyBox possui uma imagem diferente?
Como Investigar: Nos anúncios BuyBox não controlamos a imagem que aparece, justamente porque o mesmo item é vendido por mais de uma loja, essa informação vem do próprio Meli.
Para identificar se o anúncio é do tipo BuyBox, utilzar a seguinte API:
Se o campo “catalog_listing”=True então é um anúncio BuyBox.
GET https://api.mercadolibre.com/items/{{idAnúncio}}?include_attributes=all
Cenário: Sku enviado sem as informações de dimensões.
Como Investigar: Primeiro, é preciso analisar se, de fato, essas informações não foram enviadas pela integração. Para isso utilize essa query no splunk:
index=meliintegration account={{accountName}} workflow_instance={{skuId}} workflow_type={{ExportStockKeepingUnitAsync}}
Em seguida, analise a evidência do último envio do sku em questão no campo “dimensions”.
Caso este campo esteja preenchido, é preciso que o cliente entre em contato com o Meli para entender porque não estão mostrando as informações que foram enviadas.
Caso este campo não esteja preenchido, é preciso analisar se o campo “shipping_mode“ está preenchido com os valores “me1”, “me2” ou os dois. Se este campo estiver como “not_specified” é preciso orientar o cliente a ajustar essa informação pelo lado do Meli e, após o ajuste, forçar o reenvio do sku.
Sku não integra. Mensagem de erro: Mensagem de erro Mercado Livre: {
"message":"seller.unable_to_list",
"error":"User is unable to list.",
"status":403,"cause":["phone_pending"]
}
Este erro significa que os dados cadastrais na plataforma do Mercado Livre ainda não foram aprovados pela equipe. Ou então, que os dados cadastrais ainda não foram preenchidos por completo. (exemplo: Endereço incorreto, telefone etc).
Como Resolver?
Neste caso o Seller deve conferir se todos os dados estão cadastrados corretamente na plataforma do Mercado Livre. Assim que estiver tudo preenchido, reindexar a base para integrar os produtos novamente.
Somente o Mercado Livre pode resolver esse tipo de erro.
Revisão dados cadastrais - Mercado Livre
INVESTIGATIONS | ORDERS
Cenário: Pedidos com erro de SLA ou sku sem estoque
Como investigar: A integração sempre que identifica um novo pedido no marketplace que deve ser integrado para a loja realiza uma simulação de fulfillment, com o objetivo de selecionar o SLA do pedido, antes de efetivamente criar o pedido. Nesse momento, se a simulação retornar que o sku não possui estoque, está indisponível ou que não há SLA disponível para aquele item naquele CEP o pedido não será criado na loja e a integração irá logar um erro de SLA no bridge.
Para validar se o erro persiste, é necessário clicar em “Reprocessar pedido”. Caso o erro continue, para analisar o motivo específico (preço, estoque, SLA ou disponibilidade do item) é preciso realizar uma simulação de fulfillment.
cURL
curl --location --request POST 'https://.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
}'
No resultado dessa simulação, é necessário analisar os campos:
1. “Price” para validar seo sku possui preço válido;
2. “Sla” para validar se há algum retorno de SLA para o sku no CEP indicado;
3. “Stockbalance” para validar se o sku possui estoque;
4. “Message” para validar a disponibilidade do sku.
Caso alguma das informações acima não esteja válida, o pedido continuará com erro no Bridge. Neste caso deve-se analisar as configurações da loja ou verificar com o time de Checkout o motivo da informação não estar válida.
Após a correção, basta reprocessar o pedido. Caso o erro permaneça, a falha deverá ser tratada com o time de Connections, sendo imprescindível constar no ticket a simulação de fullfilment realizada e os detalhes identificados na análise.
Cenário: Por que meus pedidos estão caindo na tabela de contingência em vez do frete VTEX?
Como Investigar: Ao calcular o frete de um pedido a integração faz uma simulação de fulfillment. Esse retorno demora, geralmente, 200ms. O Mercado Livre possui um limite de tempo de espera de 400ms e se o retorno da simulação ultrapassar esse tempo o frete será através da tabela de contingência. Geralmente, esse tempo é longo quando a operação logística da account é complexa (ex: muitas transportadoras cadastradas).
Para verificar o tempo de retorno, utilizar a seguinte API de simulação de fulfillment:
cURL
curl --location --request POST 'https://.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
}'
Cenário: Pedido não aparece no bridge da VTEX.
Como Investigar: Antes de iniciar a investigação, é necessário frisar que para o Mercado Livre, os pedidos na VTEX são identificados através do ShippmentId e não do OrderId.
É necessário verificar, primeiramente, se há algum erro no splunk. Utilizar a seguinte query:
index=meliintegration account={{accountName}} {{orderId}} OR {{shippmentId}}
Caso não tenha erros evidentes (como tokens expirados, por exemplo) é necessário validar como está o pedido via API. Para isso é necessário a informação de OrderId.
API de GET order:
GET https://{{accountName}}.vtexcommercestable.com.br/api/meliintegration/order/internal/v2/{{orderId}}?lt=gold_special
Nessa API é necessário analisar se o pedido possui o campo “Shipping” preenchido com um Id válido. (Isso só se aplicar para pedidos que não são do tipo Pick-up-poiny)
Casos em que o pedido não possui shipping (como na imagem abaixo), geralmente ocorrem quando o seller deixa habilitado no Meli a opção de entrega "Entrega a combinar". Segundo nossos artigos do help essa opção faz com que os pedidos não sejam integrados na VTEX:
https://help.vtex.com/tutorial/mercado-livre-faq--3w4IgSgKZOocGee8cgSWW0
Cenário: Pedido aparece duplicado (com id de afiliado diferente) na account e subaccount.
Como Investigar: Antes de inicar a investigação é necessário validar se o pedido da subaccount está aparecendo na account (ou vice-versa) mas com Id's de afiliado diferentes. Se o Id de afiliado for igual, o pedido não está duplicado, é apenas uma configuração de visualização do OMS entre as contas.
No cenário do Id ser diferente:
O fluxo de integração do pedido leva em consideração, basicamente, 3 informações principais para saber de qual conta o pedido pertence:
- UserId
- Token
- Official_store_id
Se o officialStoreId do pedido (verificado diretamente na API de anúncio) não for o mesmo officialStoreId do storeConfig, a integração recoloca-o na fila de pedidos para ser consumido posteriormente por outra account, no caso a subaccount. Assim, pode ocorrer do pedido ficar duplicado.
INVESTIGATIONS | PRODUCTS
Cenário: Por que não consigo salvar meu Id de loja oficial? Mensagem de erro: Erro! Ação com Erro!
Como Investigar: Para identificar se o Id de loja oficial é válido, é preciso analisar a origem da mensagem de erro.
- Verificar o response do request de salvar as configurações em “DevTools” -> Network.
-
Caso a mensagem seja “Invalid Official Store Id” verificar se o User Id conectado aquele Official store Id é o mesmo cadastrado na VTEX. Para isso, utilizar as seguintes APIs:
API de configuração:
GET https://{{accountName}}.vtexcommercestable.com.br/api/meliintegration/store?lt={{listing_type}}
Obter a informação do “userId”
API de users:
GET https://api.mercadolibre.com/users/{{userId}}/brands
Obter a informação do Id da Loja oficial:
1. Se o userId estiver diferente daquele linkado ao Id da Loja oficial, é preciso repassar para o cliente o verdadeiro Id.
2. Se o userId estiver realmente linkado ao Id da loja oficial, é necessário abrir um chamado com o time de Connections, repassando as informações das APIs mencionadas.
Cenário: Rastreamento de pedidos MELI, abaixo as informações que são necessárias por tipo de logística:
Como Investigar: Cross_docking, Xd_drop_off, Self_service
- Shipment status: ready_to_ship
- Shipment SubStatus: invoice_pending
- Cfop preenchido
- InvoiceKey preenchido
- EmbeddedInvoice preenchido
Fulfillment
- Shipment SubStatus: invoice_pending
- EmbeddedInvoice preenchido
Drop_off
- EmbeddedInvoice preenchido
- Shipment Status: ready_to_shipdefault
Custom
- EmbeddedInvoice preenchido
Escolher o modo logístico do MELI quando o seller é híbrido, usa ME1 e ME2
Criar no produto uma especificação meli_shipping_mode com valor ME1 ou ME2.
Nós temos algumas palavras chaves que podem ser usadas como nome de especificação de produto: meli_title
meli_shipping_mode
officialstoreid_meli
plaintext_description_meli
Caso um produto tenha uma especificação com esses nomes, a integração usa o que tem escrito nela ao invés do padrão. Ex:
meli_title: Manda oque ta aqui ao invés do nome do produto.
meli_shipping_mode: Define o tipo logistico.
officialstoreid_meli: Define a loja oficial.
plaintext_description_meli: Manda oque ta aqui ao invés da descrição do produto
Limite estoque
MELI tem um limite de 2.000 de estoque por SKU, então se mandarmos 2.500 vai ficar sempre 2.000
Cenário: Item category MLBXXXXX domain MLB-AIR_FRYERS does not belong to catalog_product_id MLBXXXXXX domain: MLB-OIL_DEEP_FRYERS
Como resolver: Esse erro acontece por questões de GTIN/SKU significa que o GTIN informado é referente ao catalog_product MLBXXXXX. Entendo que a categoria pode ser parecida mas não é a mesma coisa.
Isso significa que o GTIN XXXXXXXXX não confere com o produto em catálogo.
Por isso peça ao seller para confirmar o código GTIN do produto para atualizar.
Comentários