> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como gerar boletos do Sicredi pelo Groner ERP (por arquivo ou pela API)

Se a sua empresa tem um **convênio de cobrança no Sicredi**, o Groner ERP gera o boleto registrado na carteira da própria empresa, direto da parcela do Contas a Receber. Você escolhe, na carteira, como os boletos chegam ao banco:

- **Arquivo de remessa** (CNAB 240): você gera o arquivo no ERP, envia no internet banking do Sicredi e depois importa o arquivo de retorno para dar baixa nos pagos. É o mesmo caminho do Santander.
- **API do Sicredi (na hora)**: o ERP registra cada boleto no Sicredi no momento em que você gera, e o pagamento dá baixa sozinho. Não há arquivo para subir.

## Onde fica

Menu **Financeiro** → **Cobrança no banco**. Também dá para abrir pelo botão **Cobrança no banco**, no topo do Contas a Receber.

Cadastrar ou alterar a carteira é do **Administrador**. Gerar boleto, remessa, importar retorno e conferir pagamentos fica para Administrador, Supervisor e Operador ERP.

## Antes de começar

1. Cadastre a **conta do Sicredi** em Financeiro → Contas bancárias, com o banco **748** e a **agência** com 4 dígitos. No Sicredi a agência é a **cooperativa**.
2. Peça à cooperativa os dados do **convênio de cobrança**: o **posto** (2 dígitos) e o **código do beneficiário** (5 dígitos).
3. Para usar a API, tenha também:
   - a **chave de API** (X-API-KEY), gerada pelo titular da conta no portal **Developers do Sicredi**;
   - o **código de acesso**, gerado no **internet banking** do Sicredi.

## 1. Cadastrar a carteira do Sicredi

1. Abra **Cobrança no banco** e vá na aba **Carteira**. Se já existir uma carteira, clique em **Cadastrar outra carteira**.
2. Em **Conta bancária**, escolha a conta do Sicredi. O **Banco** muda sozinho para **748 · Sicredi**, a carteira fica **1 · Cobrança simples com registro** e o código de transmissão (que é do Santander) some.

<!-- PRINT 01-caminho-carteira-nova-sicredi.png: Carteira nova com a conta do Sicredi: banco 748, modo de registro, cooperativa, posto e beneficiário -->

3. Confira a **Cooperativa** (vem da agência da conta) e preencha o **Posto** e o **Código do beneficiário**.
4. Preencha o **Nome** e o **CNPJ do beneficiário**, como devem sair no boleto.
5. Em **Próximo nosso número**, continue a numeração que você já usava no Sicredi (no primeiro uso, deixe 1). Com o posto e o beneficiário preenchidos, a dica embaixo do campo mostra como o próximo boleto vai sair, no formato **AA/BNNNNN-D** (ano, byte, sequência e dígito).
6. Se quiser, preencha **Juros ao mês (%)**, **Multa (%)** e até 4 linhas de **Instruções no boleto**. O Sicredi só aceita **multa em percentual**.
7. Escolha **Como os boletos são registrados no banco** e siga a seção do modo escolhido abaixo.

Se faltar o posto ou o beneficiário estiver com outro tamanho, a tela marca o campo e não grava nada:

<!-- PRINT 02-validacao-posto-e-beneficiario.png: Mensagens no campo: posto com 2 dígitos e beneficiário do Sicredi com 5 dígitos -->

## 2. Modo "Arquivo de remessa"

### Salvar a carteira

Com **Arquivo de remessa** marcado, clique em **Cadastrar carteira**.

<!-- PRINT 03-arquivo-carteira-sicredi-salva.png: Carteira do Sicredi por arquivo cadastrada, com a prévia do próximo nosso número -->

### Gerar o boleto

1. No **Contas a Receber**, abra o título e clique em **Boleto do banco** na linha da parcela.
2. Escolha a carteira do Sicredi (se houver mais de uma) e clique em **Gerar boleto pelo banco**.
3. O boleto nasce **A enviar**: ele só vale depois de ir ao banco na remessa.

### Gerar a remessa e enviar ao Sicredi

1. Na aba **Boletos a enviar**, escolha a carteira do Sicredi no seletor **Carteira**, no topo.
2. Marque os boletos e clique em **Gerar remessa (N)**. O arquivo baixa sozinho, com o nome que o Sicredi espera (código do beneficiário, mês e dia, terminado em **.CRM**).
3. Entre no internet banking do Sicredi, na área de cobrança, e **envie esse arquivo**.

<!-- PRINT 04-arquivo-remessa-sicredi-gerada.png: Remessa gerada, com o aviso para enviar o arquivo no internet banking do Sicredi -->

Precisou do arquivo de novo? Use **Baixar arquivo de novo** na aba **Remessas**.

### Importar o retorno

1. No internet banking do Sicredi, baixe o **arquivo de retorno** da cobrança.
2. Na aba **Importar retorno**, clique em **Escolher arquivo de retorno**.
3. O ERP mostra a **prévia** antes de gravar: cada pagamento, o valor e o que o ERP vai fazer (dar baixa, marcar registrado, nada a fazer…).
4. Confira e clique em **Confirmar N baixa(s)**.

<!-- PRINT 05-arquivo-previa-do-retorno.png: Prévia do retorno do Sicredi: uma baixa e um boleto que não é do sistema -->

Importar o mesmo arquivo de novo não baixa nada outra vez.

## 3. Modo "API do Sicredi (na hora)"

### Salvar a carteira

1. Marque **API do Sicredi (na hora)**. No fim do formulário aparecem a **Chave de API**, o **Código de acesso** e o botão **Testar conexão**.

<!-- PRINT 06-api-campos-de-credencial.png: Campos de acesso à API do Sicredi no fim do formulário -->

2. Preencha os dois e clique em **Testar conexão**. O ERP confere as credenciais com o Sicredi e já cadastra o **aviso de pagamento** (é por ele que o banco avisa o ERP quando o cliente paga).
3. Com a mensagem **"Conexão com o Sicredi confirmada"**, clique em **Cadastrar carteira**. O ERP só salva a carteira depois de um teste que deu certo.

A chave e o código ficam guardados com segurança e **não voltam para a tela**. Quando você abre a carteira de novo, os campos mostram "salvo"; só digite se for trocar.

### Gerar o boleto

Gere pela parcela, no Contas a Receber, como no modo arquivo. A diferença: o boleto já nasce **Registrado** no Sicredi, com o nosso número, a linha digitável e o PDF do banco.

<!-- PRINT 09-api-conexao-ok-e-boleto-registrado.png: Carteira pela API salva e o boleto da parcela já Registrado -->

### Sem remessa nem retorno

Na carteira pela API não há arquivo para enviar: a aba **Remessas** avisa isso.

<!-- PRINT 10-api-remessas-sem-arquivo.png: Aba Remessas de uma carteira pela API: não há arquivo para enviar -->

### Pagamentos

Na aba **Pagamentos**, o cartão **Pagamentos chegam sozinhos** explica o que acontece:

- o Sicredi avisa o ERP a cada pagamento e a parcela recebe a baixa na hora;
- antes de baixar, o ERP confere o boleto no próprio Sicredi, e o mesmo pagamento nunca baixa duas vezes;
- todo dia às 06:00 o ERP confere os pagamentos de ontem e de hoje, caso algum aviso tenha se perdido.

Quer conferir na hora? Clique em **Conferir pagamentos agora**. O cartão mostra a última conferência e o resumo.

<!-- PRINT 11-api-pagamentos-chegam-sozinhos.png: Cartão "Pagamentos chegam sozinhos" com o resumo da conferência -->

### Cancelar um boleto

Na lista de boletos, use **Cancelar**. O ERP pede a baixa ao Sicredi na hora; o boleto só muda para **Baixado** depois que o banco aceita. Se o Sicredi recusar (por exemplo, boleto já pago), a mensagem do banco aparece e o boleto continua como estava.

### Trocar de modo

Uma carteira que já tem boletos não troca entre arquivo e API. Cadastre outra carteira: assim a numeração e as baixas não se misturam.

## Erros comuns

| Mensagem | O que fazer |
| --- | --- |
| Informe o posto com 2 dígitos. | O posto vem no convênio da cooperativa (ex.: 07). |
| O código do beneficiário do Sicredi tem 5 dígitos. | Use o código do convênio de cobrança, não o número da conta corrente. |
| A agência da conta do Sicredi é a cooperativa, com 4 dígitos. | Corrija a agência na conta bancária e volte à carteira. |
| O Sicredi recusou a chave de API ou o código de acesso. | Confira a chave, o código, a cooperativa, o posto e o beneficiário, e teste de novo. |
| Teste a conexão com o Sicredi antes de salvar. | Clique em **Testar conexão** e espere a confirmação. |
| No Sicredi o próximo nosso número vai de 1 a 99999. | O ano entra na frente do número: use só a sequência de 5 dígitos. |

<!-- PRINT 07-api-credencial-recusada.png: Teste de conexão com credencial recusada: a mensagem diz o que conferir -->

## Perguntas frequentes

**Posso ter uma carteira do Santander e outra do Sicredi?** Sim. Escolha a carteira no seletor **Carteira**, no topo da tela; boletos, remessas e retornos aparecem por carteira.

**O boleto do Sicredi aparece no Contas a Receber?** Sim. O botão **Boleto do banco** da parcela mostra o banco da carteira e a situação do boleto.

**Os lembretes de vencimento funcionam com o Sicredi?** Sim, na aba **Lembretes**, do mesmo jeito que no Santander.