A conexão com o Sankhya é feita por credenciais em três partes, todas geradas na sua própria conta: o Client ID e o Client Secret do Componente de Integração criado na Área do Desenvolvedor Sankhya, e o Token do Gateway gerado no Sankhya Om.
Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.
Antes de começar
- Na Área do Desenvolvedor Sankhya, crie uma Solução e um Componente de Integração e copie o Client ID e o Client Secret de produção.
- No Sankhya Om, em Configurações Gateway, gere e ative o token.
- Use as três partes do mesmo Componente e do mesmo ambiente (produção): misturar partes de Componentes diferentes, ou de sandbox com produção, é o erro mais comum.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Sankhya e clique no botão de conexão.
- Preencha os três campos:
- Client ID — do Componente de Integração criado na Área do Desenvolvedor.
- Client Secret — o segredo correspondente ao mesmo Componente.
- Token do Gateway — gerado e ativado em Configurações Gateway, no Sankhya Om.
- Salve. O card fica marcado como conectado e a Toca já consegue consultar o ERP.
O que a Toca acessa
Com a conexão ativa, a Toca lê notas e pedidos de venda, financeiro (contas a receber e a pagar), produtos, estoque e parceiros (clientes e fornecedores) do Sankhya. O acesso é somente de leitura: a Toca não altera dados no seu ERP. Conectar o Sankhya não desativa a integração da sua loja virtual ou marketplace — as conexões convivem, e a Toca cruza os dados do ERP com os da loja.
Manutenção da conexão
As credenciais permanecem válidas até serem revogadas ou regeneradas no Sankhya. Se o
token do Gateway ou o Componente de Integração for regenerado, atualize os campos pelo
mesmo card em Configurações → Integrações. Para prazos de validade e detalhes de
expiração, confirme na documentação oficial do Sankhya.
Problemas comuns
- Erro de autenticação logo após conectar — as três partes precisam ser do mesmo Componente de Integração e do mesmo ambiente. Partes de Componentes diferentes, ou de sandbox misturado com produção, não autenticam juntas.
- Consulta recusada por permissão — a integração respeita as permissões configuradas no Sankhya: o que o administrador não liberou para a integração volta recusado. Revise as permissões no ERP.
- Consultas demoradas — o processamento roda no servidor do próprio ERP. A Toca faz uma chamada por vez para não disputar recursos com os usuários da sua empresa.