Fone Ninja instável — o que fazer
Diagnóstico quando o banner amarelo "Fone Ninja está instável" aparece, ou o vermelho "credenciais não funcionam mais". Causas, fixes e quando você precisa agir.
A Verbix monitora a saúde da sincronização com o Fone Ninja em tempo real. Quando algo trava, aparece um banner no topo do dashboard com diagnóstico curto e ação sugerida. Esse artigo explica os 2 cenários e o que fazer em cada um.
Cenário 1 — Banner amarelo: "O Fone Ninja está instável agora"
Você vê:
⚠️ O Fone Ninja está instável agora. Última sincronização bem-sucedida foi há X minutos. Seu estoque pode estar desatualizado. Isto é problema do Fone Ninja, não do Verbix. Tente novamente em alguns minutos ou confira direto no painel deles. [Abrir painel do Fone Ninja ↗]
Causa
API do Fone Ninja não está respondendo ou retorna dados inesperados. A Verbix detecta e classifica como falha externa — o sistema deles tá fora do ar (parcial ou total), não tem nada quebrado do nosso lado.
O que fazer
Abre o painel do Fone Ninja (link do banner)
Confere se você consegue logar e ver o estoque normalmente lá. Se eles também tão fora, o cenário é do lado deles e basta aguardar.
Espera 5-10 min
O sistema tenta sincronizar de novo automaticamente. Se voltar, banner some sozinho.
Se passou de 30 min e ainda tá no ar
Abre o chat de Suporte do Fone Ninja pra confirmar se é instabilidade conhecida do lado deles. Em paralelo, pode operar com estoque manualmente (ver "Enquanto tá fora" abaixo).
Por que esse banner existe
Sem ele, você descobriria que o estoque tá desatualizado quando um cliente reclamasse. Com ele, você sabe na hora — e tem a transparência de que o problema não é do Verbix.
Cenário 2 — Banner vermelho: "Credenciais não funcionam" ou "Identificador da loja mudou"
Você vê uma de duas versões:
🔑 Suas credenciais do Fone Ninja não funcionam mais. Parece que a senha foi alterada no painel deles. Seu estoque não está sincronizando. Reconecte pra voltar ao ar. [Reconectar agora →]
OU:
🔑 O identificador da loja no Fone Ninja mudou. O identificador da loja não bate mais com o que está cadastrado no Fone Ninja. Seu estoque não está sincronizando. Reconecte pra voltar ao ar. [Reconectar agora →]
Causa
- "Credenciais não funcionam": o e-mail/senha que a Verbix usa pra acessar o Fone Ninja não vale mais. Geralmente alguém da equipe trocou a senha no painel deles sem atualizar aqui.
- "Identificador da loja mudou": o identificador que aponta pra sua loja no Fone Ninja mudou. Acontece se você reorganizou unidades, mudou o nome cadastrado, ou criou uma loja nova.
O que fazer
Clica em Reconectar agora
O banner já te leva direto pra Configurações → Sistema de Gestão.
Confirma as credenciais atuais
Se a senha do Fone Ninja foi trocada: usa a senha nova. Se o identificador da loja mudou: copia o identificador atual (é o nome da loja na URL do painel do Fone Ninja).
Preenche na Verbix e salva
E-mail do Fone Ninja + Senha + Identificador da loja. O sistema valida na hora — se aceitar, o banner some e o sync volta nos próximos minutos.
Confere que voltou
Na mesma tela, a última sincronização atualiza com horário recente.
Procedimento completo de conexão tá em Integração com ERP Fone Ninja.
Enquanto a sincronização tá fora — como operar
| Risco | O que pode acontecer | Como mitigar |
|---|---|---|
| Estoque inflado | A IA oferece item que já vendeu (vendido no Fone, não atualizado aqui) | Confere o aparelho no painel do Fone antes de confirmar a venda; se um PIX cair de item já vendido, o fluxo de troca cobre |
| Estoque escondido | Item novo cadastrado no Fone ainda não apareceu aqui | Aguarda o Fone voltar — o item propaga no primeiro sync bem-sucedido |
| Preço desatualizado | Mudança de preço no Fone não propagou | Com o ERP como dono do preço, a edição local fica bloqueada de propósito — corrige no painel do Fone, propaga no próximo sync |
Pra editar preço na Verbix durante a falha
Quando o ERP é o dono do preço, qualquer edição local seria sobrescrita pelo sync — por isso ela fica bloqueada. Se o ajuste é urgente E o Fone também está fora, dá pra trocar o dono do preço em Configurações → Integração e Pedidos (de preço do ERP pra preço na Verbix) e editar a Tabela de Preços.
Cuidado: ao devolver o controle pro ERP, os preços dele voltam a valer e sobrescrevem os ajustes locais. Garante que você replicou as mudanças no Fone antes de voltar.
Como dispensar o banner
Botão "X" no canto direito. Some pela sessão (próxima vez que abrir o dashboard, volta se o problema persistir). Não some pra sempre — é proteção: você não pode esconder permanentemente um aviso de integração quebrada.
Se o erro mudar de categoria (ex: era "instável" e agora é "credenciais erradas"), o banner reaparece mesmo dispensado — são problemas diferentes que exigem ações diferentes.
FAQ
O banner é só pra mim ou todos da equipe veem?
Todo usuário da loja vê. Banner é por loja, não por usuário individual. Útil pra equipe saber que tem operação manual rolando.
Aparece o banner amarelo, mas eu consigo acessar normal o painel do Fone Ninja
Pode ser que o problema esteja num endpoint específico que o Fone usa internamente pra API mas não pro painel. Espera 5-10 min e confere se voltou. Se persistir, abre Suporte deles informando que o painel funciona mas a API tá retornando erro.
Reconectei mas o banner vermelho voltou em 1 min
Confere com calma os 3 campos: e-mail, senha e identificador da loja — o erro mais comum é identificador antigo. Se os dados estão certos e o banner insiste, abre um chamado no suporte da Verbix.
Posso pausar a integração até resolver?
Pelo painel você pode Desconectar a integração (em Sistema de Gestão) e reconectar depois — o estoque para de sincronizar nesse meio-tempo. Pra uma pausa temporária sem desconectar, fale com o suporte.
Como sou avisado se a integração travar?
Pelo banner no topo do dashboard — ele aparece pra todo mundo da loja enquanto o problema persistir.
Banner some, eu reconecto, mas sync nunca acontece
Pode ser cache. Na aba Sistema de Gestão, clica em Sincronizar agora pra forçar uma rodada manual. Se essa não retornar nada em 5 min, abre Suporte.
Configurar do zero
Se a integração ainda não tá configurada: Integração com ERP Fone Ninja — setup passo a passo.
PIX não confirmou — o que fazer
Diagnóstico passo a passo quando o cliente afirma que pagou mas a venda continua como Fechada. A maioria dos casos resolve em minutos.
Esqueci o PIN — como recuperar
Por que a Verbix não tem auto-recuperação de PIN, como solicitar reset pelo suporte, o que fica bloqueado enquanto espera, e como evitar esquecer de novo.