Dúvidas Frequentes: Meu ERP não está conseguindo enviar atualizações de estoque/produto/preço para a VTEX, como ajustar?

Este tópico visa esclarecer dúvidas com relação a um problema comum aos nossos lojistas, que ocorre quando o ERP não consegue enviar alguma atualização para a plataforma VTEX, seja essa atualização de produtos, preços ou estoque.

Primeiramente, gostaria de destacar que nós temos uma documentação na nossa página no Developers onde nós temos uma guia completo de integração com ERPs:

Como funciona essa integração?

Basicamente a integração da VTEX com os ERPs se dá por meio de APIs, caso você não saiba o que é uma API, recomendo a leitura do seguinte tópico aqui na nossa community:

O que isso quer dizer?

Que a VTEX é passiva nessas integrações, nós apenas recebemos as informações que o ERP envia para nós por meio das APIs.

Meu ERP não está conseguindo enviar atualizações para a VTEX, o que fazer?

1. Checar com o seu ERP qual endpoint ele está usando e qual resposta ele está recebendo ao executar o comando necessário, seja ele GET, POST ou PUT. Isso porque o problema pode ser algum errinho no endpoint ou mesmo na autenticação e saber a resposta que o seu ERP é crucial para entender o que pode estar ocasionando o problema no recebimento das informações na plataforma VTEX.

Obs¹.: Isso é válido inclusive para os casos onde esse tópico não seja suficiente para sanar todas as dúvidas, isso porque essas informações são de extrema importância para que o assunto seja tratado via chamado.

2. Em posse do endpoint fornecido pelo seu ERP vale sempre conferir se ele está de acordo com a nossa documentação que pode ser encontrada na nossa página do Developers: https://developers.vtex.com/

Geralmente os endpoints utilizados pela nossa plataforma possuem a seguinte formatação:

            https://{{accountName}}.{{environment}}.com.br/api/...

Onde:

  • {{accountName}} é nome da sua conta na plataforma VTEX, o mesmo utilizado para acessar o seu admin (https://{{accountName}}.myvtex.com/admin);
  • {{environment}} deverá ser sempre vtexcommercestable.

Ou seja, na prática, todas as APIs deverão ter o seguinte formato:

            https://{{accountName}}.vtexcommercestable.com.br/api/...

3. Conferi todos os fatores citados nos pontos anteriores e ainda assim…

  • 3.1. … meu estoque está errado;
  • 3.2. … meu produto está desativando/ativando sozinho;
  • 3.3. … o preço do meu produto altera todos os dias para um valor incorreto;

Como checar os casos citados acima?

3.1. O primeiro passo antes de abrir um chamado é checar quem ou qual app key está realizando as alterações de estoque, isso pode ser feito no seguinte local:

           https://{{accountName}}.myvtex.com/admin/inventory

Após acessar essa página, basta pesquisar pelo produto ou SKU que está apresentando problemas e clicar no número da coluna “Última atualização”:

Com isso será aberto o Registro de atualizações e nele será possível investigar por quem ou qual chave as alterações foram feitas, em qual dia e horário e qual a quantidade de inventário do SKU em questão antes e após as atualizações:

Com isso você já conseguirá todas as respostas necessárias para entender o que está acontecendo, caso as alterações tenham alterações intermitentes no seguinte formato:

Isso pode indicar a possibilidade de que exista algum outro produto cadastrado de maneira incorreta no seu ERP ou em algum outro lugar que utilize essa chave, fazendo com que valores incorretos cheguem a plataforma VTEX.

3.2. Já para este caso existem dois pontos principais que precisam ser verificados com o seu ERP.

O primeiro deles é como está sendo enviado o campo IsActive da API Update product.

O segundo é se existe alguma especificação obrigatória, isso porque o seu não preenchimento pode causa a inativação do produto. Isso pode ser verificado no admin acessando o produto com problemas e acessando a aba de especificações. Vale lembrar que essa verificação deve ser feita a nível de produto e de SKU:

3.3. Bom, caso o seu problema seja a intermitência de valores de um produto, vale verificar primeiramente com o seu ERP, mas para verificar os logs dessas alterações é necessário abrir um chamado com o nosso suporte técnico, informando o número do SKU com problemas e intervalo de tempo aproximado onde as mudanças têm ocorrido.

Espero que as informações trazidas aqui neste tópico tenham ajuda a compreender esse tipo de problema, e caso ainda tenha alguma dúvida sobre o assunto, sinta-se à vontade para perguntar por aqui! :smiling_face:

Karina Mota
Field Software Engineer | VTEX

3 Likes