Integração com ERP Fone Ninja
Como conectar seu Fone Ninja e deixar a Verbix sincronizar estoque, preços e modelos automaticamente.
Se você já gerencia estoque no Fone Ninja, conectar à Verbix significa parar de cadastrar produto 2 vezes. Verbix passa a consultar o Fone Ninja periodicamente e mantém o catálogo dela em sincronia automática.
O que o sync traz pra Verbix
| Campo no Fone Ninja | Campo na Verbix | Notas |
|---|---|---|
| Modelo + capacidade + cor | Item no catálogo | Mapeamento canônico (Fone usa nomenclatura própria, Verbix normaliza) |
| Preço de venda | Preço por condição | Default importa pra "NOVO"; ajuste manual pra outras condições se diferente |
| Estoque (quantidade) | Disponibilidade real | Verbix consulta a cada interação — sempre alinhado |
| Status (ativo/inativo) | Visibilidade no catálogo | Item inativo no Fone = invisível pra IA |
| IMEI (quando aplicável) | Rastreamento individual | Item-level tracking pra usados/grade |
Como conectar (one-time setup)
No painel do Fone Ninja: gere credencial API
Vai em Configurações → Integrações → Tokens de API e cria um token nomeado "Verbix". Anota o token (não dá pra ver de novo depois). Recomendamos token com permissão read-only de estoque + preço — sync da Verbix não precisa de write.
No dashboard Verbix: Configurações → Sistema de Gestão
Aba mostra "Fone Ninja: não conectado". Clica em Conectar Fone Ninja.
Cola o token + ID da loja no Fone Ninja
Modal pede 2 campos: token (do passo 1) e ID da loja (visível no rodapé do painel Fone). Salva.
Verbix valida conectividade
Sistema faz uma chamada de teste no Fone Ninja, lista a primeira página de produtos, mostra "X itens encontrados". Se errar, mensagem de erro específica te diz o que checar (token expirado, ID errado, permissões insuficientes).
Primeiro sync manual
Botão Sincronizar agora. Demora ~30s-3min dependendo do tamanho do catálogo. Após, items aparecem na aba Catálogo com badge "Fone Ninja" indicando origem.
Sync automático
Depois do setup, Verbix executa o sync a cada 5-10 min (configurável em Configurações → Sistema de Gestão). Mudanças no Fone Ninja (preço, estoque, modelo novo) propagam automaticamente.
Conflitos e como Verbix resolve
Cenário: você edita preço na Verbix e edita no Fone Ninja ao mesmo tempo. Quem vence?
Fone Ninja sempre vence — é a fonte da verdade. No próximo sync, o preço do Fone sobrescreve o da Verbix. Por isso recomendamos:
Regra de ouro
Se você usa Fone Ninja, gerencia preço e estoque sempre no Fone, nunca na Verbix. A Verbix vira read-only pra esses campos.
Pra desativar edição de preço na Verbix (evitar confusão), tem flag em Configurações → Robô → Modo de preço:
- Sync (recomendado): Verbix lê do Fone. Edição na Verbix bloqueada
- Manual: Verbix usa só os preços dela. Fone só serve pra estoque/modelos
Mapeamento de condições
Fone Ninja categoriza com nomes próprios. Verbix mapeia:
| Fone Ninja | Verbix |
|---|---|
| "Novo Lacrado" | NOVO |
| "Seminovo" | SEMINOVO |
| "Usado" | USADO |
| "Vitrine" / "Demo" | VITRINE |
| "Grade A" | GRADE_A |
| "Grade B" | GRADE_B |
| "Grade C" | GRADE_C |
Se você usa categorias customizadas no Fone, abre Suporte que a gente extende o mapping.
Sync de IMEI (item-level tracking)
Pra modelos seminovos/usados, cada unidade individual tem IMEI próprio. Fone Ninja rastreia isso e a Verbix herda:
- Quando cliente compra um item específico, a Verbix marca aquele IMEI como
SOLD_VERBIXno banco dela - Próximo cliente pedindo o mesmo modelo+cor+condição vê uma unidade a menos disponível
- Reset de estoque (devolução) tem que ser feito no Fone Ninja — propaga via sync
Troubleshooting
Conectei mas sync diz '0 itens encontrados'
Provavelmente o token tem permissão errada. Volta no Fone Ninja, edita o token, marca Estoque (leitura) e Preços (leitura). Recria o token e cola na Verbix.
Sync rodou mas item específico não apareceu
Item pode estar com status Inativo ou Sem estoque no Fone — sync ignora esses por design. Ativa o item no Fone, próximo sync traz.
Editei preço na Verbix e ele voltou pro antigo em 5 min
Comportamento esperado quando modo é Sync. Sync sobrescreveu com o preço do Fone. Edita no Fone se quer mudança permanente.
Posso pausar o sync temporariamente?
Sim — botão Pausar sync na aba Configurações → Sistema de Gestão. Útil quando você tá fazendo mudança grande no Fone e não quer sync parcial. Lembra de reativar.
Sync atrasou (>1h sem rodar), o que aconteceu?
Algumas causas: API do Fone fora do ar, credencial expirou, throttle do Fone (muitas chamadas em pouco tempo). Aba Configurações → Sistema de Gestão mostra última execução + status. Se aparecer erro persistente, abre Suporte.
Próximo passo
Quer entender mais profundamente como a IA usa o catálogo: Como a IA da Verbix funciona.