Módulo: Financeiro
Versão Mínima: [N/D]
Caminho de Acesso: Configurações > Rotinas > Assistente de Melhores Práticas
Sumário
Descrição e Usabilidade
1. Descrição da Funcionalidade
Este artigo explica como obter e cadastrar as credenciais bancárias necessárias para ativar o Boleto Rápido via API nos principais bancos integrados ao sistema Sankhya.
Com esse cadastro, você garante a emissão, o registro e a gestão automática dos boletos, tornando a rotina financeira mais rápida, segura e com menos erros manuais.
2. Pré-requisitos
- Permissões necessárias: acesso de administrador ou responsável financeiro pela empresa.
- Parâmetros essenciais: convênio de cobrança ativo junto ao banco.
- Configurações relacionadas: cadastro da conta bancária no sistema; acesso ao portal de desenvolvedores do banco correspondente.
3. Jornada de Uso
Para adquirir as credenciais e ativar a funcionalidade de Boleto Rápido, siga as instruções abaixo.
| Banco do Brasil | Sicoob |
| Itaú (Boleto Híbrido/PIX) | Sicredi |
| Santander | Bradesco, Caixa e Safra (EDI Automático) |
Banco do Brasil
- Acesse o Portal Developers BB e faça login com a conta do representante legal da empresa.
- Crie uma "Nova Aplicação" e preencha os dados obrigatórios (nome e descrição).
- Selecione a API de "Cobranças" na aba "APIs com contratação online pelo Portal Developers BB" e clique em "Criar" no final da página; isso o redirecionará para a homepage do site, onde você poderá continuar o processo de contratação.
- Escolha a aplicação criada e, no menu lateral, clique em "Produção".
- Informe o CNPJ e clique em "Pesquisar CNPJ" para que o nome da empresa seja exibido, então pressione "Próximo".
- Revise as informações e solicite o envio para a produção no botão "Solicitar Produção".
- Após aprovação, acesse novamente a aplicação em produção e clique na conta configurada, e depois em "Credenciais".
- Copie os códigos das credenciais "client_id" e "Client_secret", geradas para inserir no cadastro da conta bancária no Sankhya.
Itaú (Boleto Híbrido/PIX)
- Acesse o Bankline Itaú e faça login.
- Vá em "Cobrança" > "Ir para a página de cobrança".
- Em "Pagamento Instantâneo", acesse a opção "Integradores PIX".
- Selecione ou cadastre uma chave PIX.
- Clique em "Ação" e selecione a chave desejada.
- Clique em "Conectar com Integrador Pix".
- Escolha o parceiro "Sankhya Gestão de Negócios" como integrador e selecione "Acesso completo".
- Finalize com a autenticação e aguarde a homologação.
- Ao finalizar, será exibida a mensagem de solicitação confirmada. Em seguida, é necessário aguardar a conclusão dos processos de homologação e compartilhamento de chaves junto ao banco.
- Consulte as credenciais homologadas em "Conta Corrente" > "Minhas Chaves".
- Copie as credenciais geradas para configurar no cadastro da conta bancária no Sankhya.
Santander
Acesse o Portal do Desenvolvedor Santander e faça login com a conta PJ.
Nota: para utilizar esse serviço, é necessário ter um convênio de cobrança ativo.
Caso ainda não tenha, acesse o Internet Banking Pessoa Jurídica ou o aplicativo Santander Empresas e siga o caminho: Cobrança e Recebimentos > Convênio de Cobrança > Contratar Convênio.
Se preferir, também é possível selecionar a opção "Falar diretamente com o gerente".- Acesse "Aplicações".
- Crie uma nova aplicação em "Produção".
- Selecione "Utilizo um parceiro", escolha "Sankhya" e preencha os dados para criação da "Aplicação".
Após aprovação, as credenciais estarão disponíveis em até 5 minutos na seção "Minhas Aplicações".
Observação: caso surja algum problema nesta fase, acione o seu gerente da conta.
- Acesse "Minhas solicitações" e selecione a aplicação para obter as chaves "ClientID" e "ClientSecret".
- Copie as credenciais e cadastre-as no Sankhya.
Sicoob
- Acesse o Portal do Sicoob para desenvolvedores, cadastre-se e faça login.
- Crie uma nova aplicação acessando o menu Meus aplicativos > Nova aplicação.
- Faça o login no Sicoobnet e autorize a autenticação da conta clicando em "Aprovar".
- Preencha nome (ex.: nome da empresa + registro de boleto + conexão Kobana) e descrição (ex.: registro de boletos via integração Kobana) da aplicação.
Selecione as APIs desejadas. É aconselhável selecionar todas as APIs para que as credenciais possam ser usadas em serviços futuros.
É importante que essa conta seja vinculada a alguma carteira de recebimento cadastrada na Kobana.
Selecione o número da conta que pretende realizar a conexão e, na sequência, vincule a conta e escolha "Kobana" como empresa parceira e finalize o cadastro.
Nota: a Kobana é a parceira homologada da Sankhya Fintech para a integração bancária. Nesse modelo, não é necessária nenhuma relação direta entre o cliente Sankhya e a Kobana, pois toda a intermediação ocorre de forma interna.
- Certifique-se que a credencial foi gerada para o ambiente de Produção. Copie o "Client ID" gerado e cadastre no Sankhya.
Sicredi
- Acesse o Portal do Desenvolvedor Sicredi e faça login.
Crie uma nova aplicação para produção, nomeando conforme padrão sugerido (prefixo API Sankhya + o seu código de beneficiário + o final com o nome Produção).
Exemplo: APISankhya123456Produção.
3. Selecione todas as APIs necessárias.
4. Após criação, obtenha o "Client ID".
5. Para gerar o Token de acesso, abra chamado em Suporte > Abrir chamado. Preencha o "Client ID ou Nome da App" com o nome da aplicação que você criou; após a aprovação, o Token de Acesso estará disponível no menu Minhas Apps > Ver detalhes.
- 6. Para gerar a password, acesse o Internet Banking > Cobrança > Código de Acesso > Gerar.
Certifique-se que as credenciais foram geradas para o ambiente de Produção.
7. Cadastre Client ID, Token e Password no Sankhya.
Bradesco, Caixa e Safra (EDI Automático)
- Preencha os dados para gerar a carta de autorização do EDI automático via sistema.
- Envie a carta ao banco (Kobana faz o envio automático).
- Contate o gerente para agilizar a ativação.
- Aguarde confirmação do banco por e-mail.
- Após confirmação, informe os dados bancários solicitados (agência, conta, CNPJ, convênio).
- Clique em "Habilitar" no sistema para finalizar o credenciamento.
4. Pontos de Atenção
- O cadastro deve ser feito pelo representante legal da empresa.
- Utilize sempre as credenciais do ambiente de produção.
- Para bancos com EDI, a Kobana faz a intermediação – não é necessário contratar ou configurar manualmente.
- Após ativação do EDI, o acesso manual a arquivos CNAB pode ser restrito pelo banco.
- No Sicredi, a password só é gerada para beneficiários com API de cobrança habilitada.
5. Dicas de Usabilidade
- Tenha em mãos todos os dados bancários e de convênio antes de iniciar o processo.
- Revise atentamente os dados antes de solicitar produção, pois não será possível editar depois.
- Para dúvidas sobre integração, consulte o suporte do banco ou do ERP.
6. Casos de Uso
✅ Exemplo Real: cadastro de credenciais do Banco do Brasil para emissão automática de boletos via API.
❌ Erro Comum: tentar usar credenciais do ambiente de homologação em produção, resultando em falha na emissão.
Manutenções e Ajustes Técnicos
FAQ – Dúvidas Frequentes
1. Preciso contratar a Kobana para integração?
Não. A Sankhya Fintech já possui parceria com a Kobana, não sendo necessário contrato direto.
2. Posso cadastrar credenciais de homologação?
Não. Utilize apenas credenciais do ambiente de produção para emissão real de boletos.
3. Como saber se a integração foi ativada?
Você receberá um e-mail de confirmação do banco e poderá finalizar o credenciamento no sistema.
4. O que fazer se não encontrar a opção de gerar password no Sicredi?
Verifique se a API de cobrança está habilitada no convênio.
5. É possível editar os dados após solicitar produção?
Não. Após o envio para produção, os dados não podem ser alterados.
Artigos Relacionados
- Boleto Rápido API
Comentários
0 comentário
Escreva seu comentário aqui
Por favor, entre para comentar.