Limite de Requisições Atingido
TOO_MANY_REQUESTS
Causa:
A API do Bling possui limites de requisições por período. Quando o limite é atingido, a API retorna este erro.
Solução:
- Aguarde alguns minutos (geralmente 1-5 minutos)
- O limite é renovado automaticamente pela API do Bling
- Tente a operação novamente após aguardar
- Evite múltiplas operações em sequência rápida
Prevenção:
Espaçie as operações de integração. Se precisar sincronizar muitos registros, faça em lotes com intervalos entre eles.
Exemplo de mensagem de erro na integração
Token Expirado
BITRIX24_TOKEN_EXPIRED
Causa:
O token de acesso do Bitrix24 expirou. Tokens têm validade limitada e precisam ser renovados.
Solução:
- Abra o aplicativo no Bitrix24 clicando no menu
- Ao abrir, o token será renovado automaticamente
- Tente a operação novamente
- Se persistir, desconecte e reconecte o aplicativo
Mensagem de token expirado - recarregue a página
Falha na Conexão com Bling
BLING_CONNECTION_FAILED
Causas possíveis:
- Autorização foi negada ou cancelada
- Sessão do Bling expirada
- Permissões insuficientes na conta Bling
- API V3 não habilitada
Solução:
- Clique em "Desconectar do Bling" (se disponível)
- Clique novamente em "Conectar ao Bling"
- Faça login no Bling se solicitado
- Clique em "Autorizar" na tela de permissões
Erro de conexão com o Bling
Pessoa de Contato Não Criada
Causas possíveis:
- A empresa não tem contatos vinculados no Bitrix24
- Erro ao criar o contato no Bling
- Campos obrigatórios do contato estão vazios
Solução:
- Verifique se a empresa tem pelo menos um contato vinculado no Bitrix24
- Certifique-se de que o contato tem nome preenchido
- A empresa será criada mesmo se a pessoa de contato falhar
- Você pode adicionar manualmente no Bling depois
Comportamento Esperado:
Se a criação da pessoa de contato falhar, a empresa ainda é criada normalmente. O sistema tenta criar o contato separadamente e depois vinculá-lo ao mapear Contato Principal.
Empresa vinculada com dados de contato
Sincronização Automática Não Funciona
Causas possíveis:
- Aplicativo não conectado ao Bling
- Opções de sincronização não habilitadas no aplicativo
- Licença expirada
- Token de autenticação expirado
Solução:
- Verifique se o aplicativo está conectado ao Bling na aba Configuração
- Confirme se as opções de sincronização estão habilitadas em Configuração → Produto
- Verifique se a licença está ativa na aba Financeiro
- Abra o aplicativo para renovar o token se necessário
- Consulte o guia completo de Sincronização Automática
Verifique as configurações de sincronização no aplicativo
Licença Expirada
LICENSE_EXPIRED
Causa:
O período da sua licença terminou e é necessário renovar para continuar usando a integração.
Solução:
- Acesse a aba "Financeiro" no aplicativo
- Selecione o plano desejado (Mensal, Trimestral ou Anual)
- Complete o pagamento via Stripe
- A licença será ativada automaticamente
Aba Financeiro para renovação da licença
Empresa/Contato Não Encontrado
Company/Contact not found
Causa:
Ao criar um pedido (negócio), a empresa ou contato vinculado não foi encontrado no Bitrix24 ou não existe.
Solução:
- Verifique se o negócio tem uma empresa ou contato vinculado
- Se estiver configurado para criar empresa automaticamente, verifique o mapeamento
- Certifique-se de que a empresa ainda existe no Bitrix24 (não foi deletada)
Verifique se a empresa está vinculada ao Bling