[Bling] Migração para a API v3: Erros comuns e como corrigi-los

Com a recente migração para a API V3 do Bling, muitas regras e validações foram atualizadas, garantindo maior controle e segurança nas integrações. 

No entanto, essas mudanças podem gerar alguns erros para os sellers. Aqui, explicamos os problemas mais comuns, suas causas e como você pode resolvê-los de forma simples.

ÍNDICE

• Erro:  Código dos itens a serem cadastrados já existem.
• Erro:  A data para geração das parcelas é inválida.
• Erro: Informações idênticas a última venda salva, altere alguma informação caso deseje prosseguir.
• Erro: Não há transições definidas para esta entidade.
• Erro: Informe o número do pedido de venda a ser lançado.
• Erro: A loja informada não existe ou está desativada
• Erro: Não foi possível salvar o contato. O valor do campo cidade não foi encontrado no sistema.
• Erro: Os SKUs não foram encontrados no Bling
• Erro: Produto não encontrado, ID inválido
• Erro: Problemas ao configurar o módulo do Bling

Erro:  Código dos itens a serem cadastrados já existem.

* Somente para conta principal

Esse problema ocorre porque o produto não está vinculado com o ANYMARKET, possivelmente por ter sido cadastrado direto na plataforma, mas deveria ser importado pela configuração da integração Bling no ANY.

Como corrigir:

1. No ANY, acesse o menu esquerdo Configurações - Configurações de Integrações.
2. Busque pela integração Bling! e clique em Configurar.
3. Na aba Importação de Produtos realize a importação do produto (ou dos produtos) que estão no alerta do Painel de Monitoramento. Nessa etapa, mesmo que seu produto já esteja no ANY, será criado o vínculo internamente, ele não será duplicado
4. Após ajustar a configuração, retente o envio do pedido pelo "Painel de monitoramento".

OBS: Caso o botão de retentativa não esteja disponível, acesse o menu Vendas do lado esquerdo do ANY, selecione o pedido e clique no botão ERP / Plataforma: 

Erro:  A data para geração das parcelas é inválida.

Esse problema ocorre devido a uma configuração no Bling que define qual campo será usado como data para geração das parcelas de pagamento. Dependendo da configuração escolhida pelo seller, o ANYMARKET não consegue enviar o pedido, pois não possui essa informação para repassar ao Bling.

Por exemplo, alguns sellers configuram o campo como "Data de saída". No entanto, a "Data de saída" pode variar, sendo:

• Data de saída da nota: disponível apenas se o pedido estiver faturado.
• Data prevista: disponível apenas se o pedido estiver enviado.

Como a maioria das integrações do ANYMARKET envia pedidos pendentes ou pagos, essa informação não está disponível no momento da criação do pedido.

Como corrigir:

1. Acesse as configurações de venda no Bling.
2. No campo "Data para geração de parcelas", selecione a opção "Data de venda".
3. Após ajustar a configuração, retente o envio do pedido pelo "Painel de monitoramento".

Erro: Informações idênticas a última venda salva, altere alguma informação caso deseje prosseguir.

Esse problema ocorre porque o ANYMARKET conseguiu criar o pedido no Bling, mas, devido a uma instabilidade, essa informação não foi registrada corretamente no sistema. 

Como corrigir:

1. Entre em contato com o suporte do ANYMARKET para que os ajustes necessários sejam feitos internamente e o pedido seja removido do processo de monitoramento.
2. Atenção: Não realize a retentativa de envio do pedido, pois isso resultará na duplicação do pedido no Bling.

Erro: Não há transições definidas para esta entidade.

Esse problema ocorre porque no Bling existe um fluxo de transição definido para cada status, e ele é utilizado para atualizar os pedidos. No fluxo padrão, sem status personalizados criados pelo seller, o ANYMARKET consegue atualizar o pedido sem problemas.

Porém, quando o seller personaliza os status no Bling, é necessário configurar o fluxo de transição entre os status.

Na imagem:

• Marcado em verde: o status atual do pedido no Bling.
• Marcado em roxo: o status atual do pedido no ANYMARKET.

Nesse caso, o pedido foi cancelado pelo marketplace, mas o status personalizado no Bling não possui uma transição configurada para "Cancelado". Por isso, não foi possível realizar o cancelamento automaticamente. 

Como corrigir:

1. Configure o fluxo de transição no Bling para permitir a atualização para o status "Cancelado".
2. Após realizar essa configuração, retente o envio do pedido através do "Painel de monitoramento".

Para mais informações sobre como cadastrar o fluxo de transição no Bling, siga este artigo de ajuda.

Erro: Informe o número do pedido de venda a ser lançado.

Esse problema ocorre devido a uma configuração ativa no Bling que interfere no funcionamento da API V3, já que o ANYMARKET não possui controle sobre a numeração de pedidos. 

Como corrigir:

1. Acesse as configurações de venda no Bling.
2. Desative a opção "Editar número do pedido de venda".
3. Após ajustar a configuração, retente o envio do pedido pelo "Painel de monitoramento".

Erro: A loja informada não existe ou está desativada

Esse erro acontece quando o código da loja configurado no ANYMARKET não bate com o código da multiloja cadastrada no Bling. Isso pode ocorrer devido a erros de cadastro ou falta de validação.

Como corrigir:

1. Valide as multilojas cadastradas no Bling com os códigos configurados no ANYMARKET.
2. Confirme se cada loja está vinculada corretamente ao marketplace correspondente. 
   Por exemplo: se a loja no Bling corresponde à Shopee, certifique-se de que o código correto esteja preenchido no campo correspondente ao marketplace Shopee no ANYMARKET.
3. Após realizar as correções, retente o envio do pedido através do "Painel de monitoramento".
4. Caso a retentativa não funcione e você possua múltiplos CNPJs, tente realizar a reautenticação da conta para garantir que autorizou as contas certas no ANYMARKET. Para isso, siga o passo a passo aqui.

Erro: Não foi possível salvar o contato. O valor do campo cidade não foi encontrado no sistema.

Esse erro ocorre porque o consumidor preencheu o campo “cidade” com o nome de um distrito em vez da cidade correta (ex.: Trancoso, que é distrito de Porto Seguro - Bahia). Como o Bling utiliza a API dos Correios para validações, ele rejeita informações incorretas nesse campo. Essa validação é uma novidade na API V3, inexistente na versão anterior.

Como corrigir:

1. Edite o cadastro do cliente para substituir o distrito pelo nome correto da cidade.
2. Após a alteração, tente reenviar o pedido através do "Painel de monitoramento".

Erro: Os SKUs não foram encontrados no Bling

Esse erro pode indicar que o produto relacionado ao pedido não está cadastrado na conta adicional do Bling. Isso acontece devido à obrigatoriedade de envio do ID do produto, uma validação exclusiva da API V3.

Como corrigir:

1. Cadastre o produto na conta adicional do Bling.
2. Informe o SKU mencionado no aviso do monitoring para garantir que ele está correto.
3. Retente o envio do pedido pelo monitoring após a correção.

Dica: Verifique periodicamente se todos os produtos estão devidamente cadastrados em todas as contas.

Erro: Produto não encontrado, ID inválido

Esse erro pode ocorrer por várias razões, mas uma situação comum é ter a callback de estoque ativa tanto na conta principal quanto na adicional. Isso faz com que o ANYMARKET atualize o ID do produto de forma errada, pois os IDs diferem entre contas.

Como corrigir:

1. Desative a callback de estoque na conta adicional, mantendo-a ativa apenas na conta vinculada à configuração principal.
2. Após ajustar as configurações, entre em contato com o suporte do ANYMARKET, informando a situação. Nossa equipe realizará os ajustes necessários para que seja possível reenviar o pedido.

Erro: Problemas ao configurar o módulo do Bling

Esse erro pode ocorrer caso o módulo de integração do Bling não esteja carregando corretamente durante o processo de configuração.

Como corrigir:

1. Limpe o cache do navegador:
   • No navegador, acesse as configurações e limpe o histórico de navegação, incluindo o cache.
   • Atualize a página e tente acessar o módulo novamente.

Precisa de Ajuda?

Se você ainda tiver dúvidas sobre a integração entre o Bling e o ANYMARKET, nossa equipe está aqui para ajudar! Entre em contato pelo canal de atendimento disponível no seu plano e um especialista em integrações estará à disposição para auxiliar você.