Há diversas razões pelas quais um pedido entre um marketplace e sua loja VTEX pode não integrar, e para cada uma delas existe uma notificação que indica a natureza do erro. Você encontra a mensagem de erro no Admin VTEX, no módulo Marketplace > Conexões > Pedidos. Para visualizar a mensagem, basta clicar sobre o pedido.
Na Dafiti, há erros de integração de pedidos que ocorrem com mais frequência que outros. Este artigo seleciona os mais comuns e indica como resolvê-los.
Mensagem de erro
Não é possível integrar um pedido composto por produtos criados manualmente
Este erro acontece quando um item do pedido foi cadastrado diretamente na plataforma da Dafiti. Mesmo que o item esteja também cadastrado na VTEX, essa duplicação de cadastro faz com que o ID do SKU não seja reconhecido pelo sistema VTEX, e o pedido não é integrado. A solução é deletar o cadastro do item na plataforma Dafiti, e, após se certificar de que o SKU está cadastrado no seu ambiente VTEX, reprocessar o pedido manualmente. No seu Admin, no módulo Marketplace > Conexões > Pedidos, clique sobre o pedido com erro. Feito isso, o botão Ações se torna visível, clique sobre ele e escolha a opção Reprocessar.
Mensagens de erro
Não foi possível integrar o pedido, pois um ou mais itens não possuem estoque suficiente para o canal de vendas do Marketplace
Não foi possível integrar o pedido, pois um ou mais itens não estão disponíveis
Há diversas causas para erros relacionados à falta ou insuficiência de estoque. Para identificar a origem do erro e corrigi-lo, confira Erros de falta de estoque na integração de pedidos de marketplace.
Mensagem de erro
Não foi possível integrar o pedido, pois um ou mais itens não possui preço vigente para o canal de vendas configurado
Este erro indica inconsistência no preço do SKU, que pode estar com data de vigência expirada, ou ter algum erro de cadastro. Confira se é necessário alterar o preço do SKU e, em seguida, reprocesse manualmente o pedido. No seu Admin VTEX, no módulo Marketplace > Conexões > Pedidos, clique sobre o pedido com erro, e depois clique em Ações. Selecione a opção Reprocessar.
Mensagem de erro
This api call "SetStatusToShipped" is currently not allowed
Na Dafiti, há uma configuração do sistema logístico que, por padrão, é marcada com o valor “sim” (verdadeira). Isso permite que os fretes tipo FOB e Milk Run funcionem corretamente. No entanto, quando o seller não configurou nenhum destes fretes na Dafiti, é possível que este erro ocorra. Para corrigi-lo, é necessário entrar em contato com a Dafiti, que então muda a configuração do sistema de “sim” para “não”, resolvendo o problema.
Mensagem de erro
Valor de variação inválido
A mensagem indica que a planilha de mapeamento de categorias e atributos não foi preenchida corretamente, ou seja, em um ou mais campos foram inseridos valores incorretos. Por exemplo, preencher uma especificação de tamanho com o numeral zero, que não é um valor admissível. Se necessário, consulte a orientação de preenchimento da planilha de mapeamento em Envio dos produtos para a Dafiti.
Mensagens de erro
Pedido não integrado pois o mesmo não está pendente
Não é possível integrar um pedido que ja tenha passado do status Pendente na Dafiti
Os erros citados ocorrem quando o status de um pedido foi alterado diretamente pelo portal da Dafiti. Isso faz com que o sistema da VTEX não mais consiga identificar o status desse pedido, o que impossibilita sua integração, pois um pedido da Dafiti só é integrado quando está no status Pending (pendente). Os outros status que existem são Ready to ship (pronto para despacho), Shipped (despachado), Delivered (entregue), Return shipped by customer (devolvido pelo consumidor) e Canceled (cancelado). Não existe uma solução para erros desta natureza, a orientação é que um pedido do marketplace nunca seja processado diretamente pela plataforma do marketplace, e sim pelo Admin VTEX.
Mensagem de erro
OMS Api Error Occurred
Na configuração da integração com a Dafiti, existe a opção de ativar o campo FOB (Free on Board), um tipo de frete no qual a entrega do produto ao consumidor é realizada pelo marketplace. A mensagem de erro citada ocorre quando o usuário habilitou a opção FOB no conector, mas não tem esse tipo de frete cadastrado na Dafiti. A solução é primeiro desabilitar o campo FOB no conector. Para isso, acesse seu Admin VTEX, no módulo Marketplace > Conexões > Integrações. No card da Dafiti, clique sobre o ícone engrenagem e selecione a opção Editar configuração, o que vai abrir uma nova tela, na qual, o campo FOB deve ser marcado com a opção Não. Feito isso, clique no botão Salvar configuração. Com o campo FOB desabilitado no conector, o próximo passo é entrar em contato com a Dafiti, solicitando a habilitação do frete tipo FOB. A Dafiti então fornece as instruções sobre como o usuário deve proceder.