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-marketplace-out
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 | PRODUCTSQUAIS 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 - BuyBoxhttps://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
- Se o SKU for um anúncio tradicional sem Buy Box, ele poderá ter 2 anúncios: um para a versão premium e outro para a versão clássica.
- Se o SKU for um anúncio tradicional com Buy Box, ele poderá ter 4 anúncios: um para a versão premium + Buy Box e outro para a versão clássica + Buy Box.
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 | ORDERSQ: Pedido com erro "An error with Workflow System has occurred"
A: Isso ocorre porque a conta está utilizando o SOS, sendo este o comportamento esperado (Team OMS).
Com a conta configurada em SOS, o pedido passa a ser criado no OMS mesmo quando há falha de SLA. Nesses casos, todos os erros devem ser gerenciados diretamente na interface do OMS. Especificamente para erros de SLA, uma restrição é exibida na tela, e o pedido permanece pendente até que o merchant realize as ações necessárias para dar continuidade ao processamento.
Já temos uma melhoria mapeada para a mensagem exibida no Bridge. Enquanto isso, o merchant deve ajustar o pedido conforme necessário e, em seguida, prosseguir com o processamento.
Em caso de dúvidas sobre o fluxo ou a documentação, recomendamos entrar em contato com o time de Orders, que poderá fornecer mais detalhes.
Ticket referencia: https://vtexhelp.zendesk.com/agent/tickets/1383288
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 sem customData
A: Ver 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
Q: Pedidos não atualizam para o status status 'entregue' / "delivered" no Mercado Livre
A: Investigação completa https://vtexhelp.zendesk.com/agent/tickets/1377930
Q: Pedidos faturados não refletem no Mercado livre / Invalid fields
A: Investigação completa https://vtexhelp.zendesk.com/agent/tickets/1294781
1: EnqueueInvoiceNotificationPvtAsync - essa é a notificação recebida do OMS contendo os dados da nota fiscal
2: PostCustomMe1Me2dropoffOrderInvoiceAsync - Esse é o fluxo que de fato envia as informações da nota para o Mercado Livre.Q: Pedidos com erro "Emit state from XML is different to shipment origin address state"
A: Ticket referencia 1244734
Q: Pedidos com erro "Malformed XML"
A: Ticket referencia 1245480
QUESTIONS | TEMPLATE MENSAGENS MERCADO LIVREQ: 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 | PRODUCTSQ: Razão: Era idêntica a outra das suas opções de venda.
A: Não permitimos anúncios de um mesmo produto com as mesmas condições de venda.
Investigação: https://vtexhelp.zendesk.com/agent/tickets/1401857
Q: Gestão estoque
A: Logistics: nem toda mudança em Logistics gera notificação, por exemplo inativar/excluir warehouse ou doca não dispara evento pro Broadcaster. Thread com o time de logistics: https://vtex.slack.com/archives/C040NRB2G0Y/p1741874514144649
neste caso, entender como o cliente ta zerando o estoque destes skus, se estiver manipulando direto nas configurações de warehouse ou doca nós como integração nao vamos saber das alterações.
Q: Atualização estoque KIT usando Multi-origem
A: A regra de SKU se aplica para KIT a diferença é que o estoque do kit vai depender do estoque dos itens existir e pra "existir" no multi origem, o estoque não precisa somente estar na mesma política comercial através da doca, como também ter um mapeamento daquele estoque para que o valor seja considerado ao enviar para o Meli.
os SKUs que são kits no catálogo da VTEX são tratados como os outros SKUs e não tem nenhuma diferença nos fluxos de exportação e update. Já no caso do estoque, o valor é calculado de acordo com os estoques dos componentes daquele kit.
Por exemplo: Um SKU 10 é um kit composto por:
2 unidades do SKU 9
1 unidade do SKU 8
se o estoque dos componentes for:
SKU 9: 20
SKU 8: 100
o estoque do SKU 10 (kit) é 10
quando tem uma atualização do estoque dos componentes no catálogo, a integração também já atualiza o anúncio do kit no meli
Ticket referencia: https://vtexhelp.zendesk.com/agent/tickets/1392918
Q: Skus com erro: O modo de envio me2 não é permitido para o SKU 310128339 devido às regras de convivência ME1 - ME2 ou acordos comerciais entre o vendedor e o marketplace. Os modos de envio habilitados para este SKU são: custom, not_specified. Para mais detalhes, entre em contato com seu assessor comercial do Mercado Livre.
A: Este tipo de restrição não é resolvido via API. É necessário que entrem em contato com o consultor comercial do Mercado Livre Brasil para solicitar a habilitação do ME2 para as categorias de produtos volumosos. Uma vez gerenciado o acordo comercial, o ME2 aparecerá como modo disponível e a publicação poderá ser realizada sem alterações na integração.
Ticket refrencia: https://vtexhelp.zendesk.com/agent/tickets/1380021
Q: Skus com erro: Os atributos seller_package_height, seller_package_width, seller_package_length e seller_package_weight são obrigatórios.
A: O Mercado Livre tornou obrigatórios os atributos de dimensão para itens ME2 em algumas categorias. No entanto, essa obrigatoriedade pode ser estendida para novas categorias sem aviso prévio. Por isso, é importante considerar as dimensões como obrigatórias para qualquer categoria dos produtos que tem entrega ME2.
Para que o recurso funcione corretamente, o merchant deve configurar:
- Especificação ME2 no nível de produto
- Informar as dimensões no nível de SKU.
- As dimensões devem refletir valores reais (ex: L 20, A 30, C 10, P 5) e só são aceitos valor em centímetros e gramas
Importante
- Caso não sejam aceitas pelo Mercado Livre, o item será moderado e o produto não será publicado.
- A integração lê os atributos de dimensão diretamente do catálogo VTEX, no nível de SKU.
- Qualquer mapeamento desses campos no mapper será ignorado. Essa regra se aplica a todos os SKUs configurados como ME2.
Q: Possivel divergencia de estoque
A: https://vtexhelp.zendesk.com/agent/tickets/1234809
https://vtexhelp.zendesk.com/agent/tickets/1348895
Q: Erro The attributes [seller_package_height, seller_package_length, seller_package_weight, seller_package_width] are in the wrong format - Only integers are accepted for dimensions and weight, with centimeters 'cm' as the unit for dimension
A: https://vtexhelp.zendesk.com/agent/tickets/1340081
Q: O modo de envio me1 não é permitido para o SKU 1963 devido às regras de convivência ME1 - ME2 ou acordos comerciais entre o vendedor e o marketplace. Os modos de envio habilitados para este SKU são: me2. Para mais detalhes, entre em contato com seu assessor comercial do Mercado Livre.
A: https://vtexhelp.zendesk.com/agent/tickets/1293757
Q: Estou estudando um caso aqui no time de marketplace e queria ver com vocês se teriam como ajudar a gente. Basicamente, o nosso cenário pede que a gente consiga atualizar dados relacionados a SLA no marketplace quando o merchant faz alguma atualização aqui na VTEX (tempo que um SKU pode ficar na warehouse, por exemplo). Acontece que hoje esse update só ocorre quando há alguma atualização no estoque do SKU e isso trigga uma notificação via broadcaster e ai a nossa integração faz a simulação e atualiza no marketplace. Minha dúvida aqui é se existiria algum hook ou notificação que a nossa integração (a da Amazon, mais especificamente), conseguiria se inscrever? Assim a gente não ficaria dependendo exclusivamente dos updates de estoque para fazer essa atualização no marketplace também
A: Thread referencia com logistics: https://vtex.slack.com/archives/C040NRB2G0Y/p1741874514144649
Q: Sobre divergencia de estoque, importante saber sobre escopo de logistics | Quando um Warehouse é inativado ou excluído, é enviada alguma notificação para que o Broadcaster envie notificações por SKU?
Exemplo: Inativo o WH ABC, isso vai triggar uma notifição ao Broadcaster que enviará uma notificação para cada SKU que estava vinculado a esse WH?
A: Não é enviado notificação pra o broadcaster nesse cenário. Momentos em que envia (dos que vi aqui, podem não ser todos) (thread referencia)
Atualização de estoque;
Criação de reserva;
Q: Com base nas regras que conhecemos:
- Um item tradicional sem variações pode ser vinculado a apenas um item de catálogo.
- Cada variação de um item tradicional também pode ser vinculada a apenas um item de catálogo.
- O array item_relations deve conter apenas um ID de item de catálogo
Q: Erro ao enviar a especificação ao Mercado Livre, a especificação ARO é um campo obrigatório no Mercado Livre.
A: Ver detalhes ticket
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, o Meli informa que o seller não tem o ME1 habilitado, quando na verdade ele não está configurado nas suas preferências de envio. Não sabemos exatamente por que o Meli retorna essa mensagem, mas o fato é que o seller realmente não possui o ME1 configurado em shipping_preferences, então, de certa forma, a mensagem 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: O id de variação é de preenchimento obrigatorio na planilha de migração?
A: Se o anúncio tem variacao no Meli, TEM que ter na planilha tbm. Se nao tiver, não preenche.
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: É possivel alterar imagem de um anuncio no Mercado Livre?
A: Pela integração da VTEX com o Mercado Livre, não é possível alterar as imagens de um anúncio já criado as imagens são enviadas apenas uma vez, no momento da criação do anúncio.
Como alterar a imagem do SKU no catálogo VTEX depois da publicação não atualiza o anúncio no Mercado Livre.
1: ajustar manualmente no painel do Mercado Livre. Você pode entrar no anúncio e trocar a imagem principal/ordem direto no ML, quando necessário.
2: recriar o anúncio. Excluir o anúncio no ML e reenviar a partir da VTEX (reindexar) gera um novo anúncio, mas todo o histórico do anterior é perdido (reputação, vendas, posicionamento etc.).
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 | SETTINGSQ: Arquitetura usando subaccounts
A: O mesmo userId para duas contas não é problema, desde que cada conta VTEX tenha um officialStoreId distinto
1. Se só uma conta VTEX usa o userId, não é necessário officialStoreId
2. Se duas contas VTEX usa o mesmo userId, cada uma deve ter um officialStoreId diferente.
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
FLUXO ESTOQUE | 1267588
1. Catalogo Notifica Broadcaster sobre alteração de estoque (catalog)
2. Broadcaster notifica a integração (Catalog)
3. Integração faz a simulação com checkout (Connections)
4. Checkout consulta a rota de logistics /api/logistics/pvt/inventory/items/:skuId/v2?sc=1 (Checkout)
5. Checkout devolve oq estava disponivel na rota de logistics (logistics)
6. Integração atualiza o marketplace (Connections)
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