¶ Integração com boleto Sicredi (748) via API
Este tutorial cobre o processo completo para configurar a emissão de boletos pelo banco Sicredi (748) no EmiteFácil, utilizando a API de cobrança direta (registro instantâneo).
Com essa integração, cada boleto emitido é registrado em tempo real no banco — sem necessidade de enviar arquivos de remessa ou aguardar retorno D+1.
¶ Pré-requisitos
Antes de começar, certifique-se de que:
- Você possui conta corrente no Sicredi com o serviço de API de cobrança habilitado. Se ainda não solicitou esse serviço, entre em contato com o gerente da sua agência.
- Você tem acesso ao Portal Sicredi Developers (
developer.sicredi.com.br) — o cadastro é gratuito. - Você tem acesso ao Internet Banking da conta corrente do Sicredi.
¶ Parte 1 — Configurações no lado do Sicredi
¶ 1.1 Criar conta no Portal Sicredi Developers
Se você ainda não tem cadastro no portal, acesse developer.sicredi.com.br e clique em Criar Conta.
O cadastro deve ser feito com os dados do titular da conta corrente (CNPJ/CPF, e-mail e senha).
¶ 1.2 Criar uma nova aplicação e obter o Token
Após fazer login no portal:
- Clique no seu nome ou no menu de perfil e acesse Minha Conta → Minhas Apps
- Clique em Nova App (ou equivalente no portal)
- No formulário, selecione o produto OPEN API - COBRANCA - PARCEIROS 1.0.0
- Conclua a criação da aplicação
- Volte em Minhas Apps, clique em Detalhes na aplicação criada
- Copie o valor do campo KEY — este é o Token que você vai inserir no EmiteFácil
Atenção: Em alguns casos, o token pode demorar até 24 horas para aparecer na tela de detalhes após a criação da aplicação. Se isso ocorrer, abra um chamado pelo próprio portal do Sicredi solicitando a geração do token para sua aplicação.
¶ 1.3 Gerar o Password no Internet Banking
O Password (também chamado de "Código de Acesso" ou "ApiSecret") é gerado pelo próprio titular da conta no Internet Banking:
- Acesse o Internet Banking do Sicredi com as credenciais da conta corrente
- Localize a opção Código de Acesso (o caminho pode variar conforme a versão do Internet Banking — consulte o suporte Sicredi se não encontrar)
- Gere o código e copie o valor — este será o Password informado no EmiteFácil
¶ Parte 2 — Configuração no EmiteFácil
¶ 2.1 Cadastrar a Integração Bancária
A integração bancária armazena as credenciais de acesso à API do Sicredi.
Caminho: Financeiro → Configuração de integração com bancos
-
Clique em + Nova configuração
-
No campo Banco, selecione 748-BANCO COOPERATIVO SICREDI S.A.
Os campos mudam para os específicos do Sicredi:
-
Preencha os campos:
- Token de acesso obtido no portal Sicredi Developers (usuário TC SOFTWARE): cole o valor da chave KEY obtida no passo 1.2
- Password gerado no Internet Banking: cole o Código de Acesso obtido no passo 1.3
-
Clique em Salvar
¶ 2.2 Cadastrar a Conta Bancária
Caminho: Financeiro → Contas Bancárias
-
Clique em + Nova Conta Bancária
-
Preencha os campos:
- Apelido: nome de identificação da conta (ex.: "Sicredi Cobrança")
- Banco: selecione 748-BANCO COOPERATIVO SICREDI S.A.
- Agência e Dígito: número da agência da conta corrente
- Conta Corrente e Dígito: número da conta corrente
-
Marque a opção Esta conta possui emissão de boletos
-
Clique em Salvar
¶ 2.3 Configurar a Carteira de Cobrança
A carteira de cobrança vincula a conta bancária à integração configurada e define os parâmetros padrão dos boletos.
-
Na listagem de contas bancárias, clique sobre a conta Sicredi que você acabou de criar
-
Na tabela de carteiras, clique na linha vazia (ou clique em + Nova carteira se disponível) para abrir a configuração
-
Preencha os campos obrigatórios:
Campo O que preencher Código da carteira Letra da carteira fornecida pelo Sicredi (geralmente A) Codigo do Cedente/Beneficiário Código do cedente fornecido pelo Sicredi ao abrir a conta. Dica: gere um boleto avulso no Internet Banking e consulte o campo "Beneficiário" para encontrar esse código CNPJ/CPF do cedente CNPJ (ou CPF) da empresa/pessoa titular da conta Tipo de arquivo Selecione WEBSERVICE (registro instantâneo via API) Integração bancária Selecione a integração Sicredi cadastrada no passo 2.1 -
Configure as informações padrão dos boletos (opcional — podem ser sobrescritas individualmente):
Campo Descrição Gerar Boleto c/ PIX Marque para incluir QR Code PIX em todos os boletos Juros diários Percentual ou valor de juros por dia de atraso Multa Percentual ou valor de multa por atraso Desconto Valor de desconto padrão Limite de dias para pagamento do boleto Quantos dias o boleto ficará válido para pagamento após o vencimento Protestar automaticamente Se marcado, o título é protestado após o número de dias configurado (o Sicredi aceita entre 3 e 99 dias) -
Clique em Salvar
¶ Verificação
Após concluir a configuração, emita um boleto de teste pela tela de Contas a Receber:
- O boleto deve ser registrado instantaneamente (sem filas de remessa)
- O status do título deve aparecer como REGISTRADO logo após a emissão
- Se houver erro, verifique se o Token e o Password estão corretos e se a API de cobrança está habilitada pelo gerente da agência
¶ Perguntas frequentes
Onde encontro o Código do Cedente/Beneficiário?
O código do cedente é informado pelo Sicredi no momento da contratação do serviço de cobrança. Você também pode encontrá-lo em qualquer boleto emitido manualmente pelo Internet Banking, no campo "Cedente" ou "Beneficiário" (geralmente com 6 dígitos, ex.: 938106).
Qual letra usar no campo "Código da carteira"?
A carteira padrão do Sicredi para cobrança é a A. Confirme com o gerente da sua cooperativa qual carteira está habilitada para a sua conta.
O Token não aparece no portal após criar a aplicação. O que fazer?
Em alguns casos o Sicredi demora para ativar o token. Acesse o suporte dentro do próprio portal em developer.sicredi.com.br e abra um chamado solicitando a ativação do token para a aplicação criada.
O boleto foi emitido mas deu erro ao registrar. O que verificar?
- Confirme que o Token (chave KEY) e o Password (Código de Acesso) estão corretos
- Verifique se a API de cobrança está habilitada para a sua conta — entre em contato com o gerente da agência
- Certifique-se de que o Código do Cedente está correto (6 dígitos)
- Verifique se a agência e conta corrente no EmiteFácil estão corretas
Posso usar a mesma integração para mais de uma conta corrente Sicredi?
Não. Cada conta corrente precisa de um Password (Código de Acesso) próprio gerado no Internet Banking. Cadastre uma integração bancária separada para cada conta.