# PROC004 Registro Automático de Boletos

<table border="1" id="bkmrk-%C2%A0-projeto%2Fsistema%3Age" style="border-collapse: collapse; width: 100.123%; height: 68px;"><tbody><tr style="border-style: solid;"><td rowspan="3" style="width: 26.6667%; height: 68px; border-color: black; border-top-style: hidden; border-left-style: hidden; border-bottom-style: hidden;">  
 ![Softensistemas Logo](https://www.softensistemas.com.br/assets/img/logo.webp)

</td><td style="width: 49.9999%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Projeto/Sistema:**</span>  
Emissão de Boletos - SIEM

</td><td class="align-center" style="width: 23.3333%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do *Template:***</span>  
<span style="color: #000000;">1.1</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Processo:**</span>  
PROC004 Registro Automático de Boletos</td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do Documento:**</span>  
<span style="color: #000000;">1.0</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Responsável(eis):** </span>  
<span style="color: #000000;">Gustavo Fernandes</span></td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Data:** </span>

<span style="color: #000000;">11/02/2025</span>

</td></tr></tbody></table>

##### <span style="color: #000000;">**1. Introdução**</span>

<span style="color: #000000;">**Este processo visa exemplificar as formas em que podemos gerar os boletos via API Sicoob no sistema de forma automática, assim como é feito com remessa.**</span>

#### **Processos Relacionados** 

- - - - - -

[PROC003 Eventos do Boleto](https://docs.softensistemas.com.br/books/integracao-banco-sicoob-via-api/page/proc003-eventos-do-boleto "PROC003 Eventos do Boleto")

#### **Especificação Funcional**

- - - - - -

#### **PROC004 Registro Automático de Boletos:**

##### ***Protótipo de Tela:*** 

[![image-1739296809055.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-02/scaled-1680-/image-1739296809055.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-02/image-1739296809055.png)

*Imagem 1 - Emissão de Boleto no Pedido de Venda*

[![image-1739297121725.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-02/scaled-1680-/image-1739297121725.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-02/image-1739297121725.png)

*Imagem 2 - Emissão de Boleto na Nota Fiscal (config. 2)*

[![image-1739297386944.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-02/scaled-1680-/image-1739297386944.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-02/image-1739297386944.png)

*Imagem 3 - Emissão de Boleto pela tela de Duplicata a Receber*

[![image-1739298105406.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-02/scaled-1680-/image-1739298105406.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-02/image-1739298105406.png)

*Imagem 4 - Opção Reemitir Boleto*

##### ***Regras de Interface:***

***1. Regras do campo:*** Seguir o mesmo padrão já estabelecido no SIEM para remessas de boleto.

##### ***Regras de Negócio:***

***1. Pedido de venda (Imagem 1):***  
Será realizado o envio do boleto para registro quando o usuário marcar "**Boleto**" na opção **Emitir ao Finalizar** e selecionar uma carteira configurada com a opção **SCB2** para emissão.

Ao clicar em confirmar, deve ser realizada a requisição de [Registro dos boletos](https://docs.softensistemas.com.br/books/integracao-banco-sicoob-via-api/page/endpoints-producao-exemplos-json#bkmrk-2.1.1-servi%C3%A7o-para-a "Registro dos boletos") para cada parcela gerada.   
Caso sejam registrados com sucesso, deve ser gerado o PDF de cada boleto.  
**Se não** registrar alguma parcela, deve retornar o status e uma mensagem ao usuário:  
"Erro: uma das parecelas não foi registrada, retorno: **Retorno do banco**"

***2. Nota Fiscal (Imagem 2):*** Deve realizar o envio dos boletos para envio quando estiver habilitada a **configuração:**  
**"FATURAMENTO: GERAR BOLETO (A RECEBER) AO FINALIZAR NFE (0=NÃO/1=SIM):".**  
  
O usuário deve fazer o preenchimento das parcelas na NFe, finaliza-la, clicar em **"Sim"** na mensagem de confirmação **(conforme o exemplo abaixo)** e selecionar uma carteira configurada com a opção **SCB2** para emissão.

[![image-1739361601166.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-02/scaled-1680-/image-1739361601166.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-02/image-1739361601166.png)

 Ao clicar em confirmar, deve ser realizada a requisição de [Registro dos boletos](https://docs.softensistemas.com.br/books/integracao-banco-sicoob-via-api/page/endpoints-producao-exemplos-json#bkmrk-2.1.1-servi%C3%A7o-para-a "Registro dos boletos"), para cada parcela preenchida.   
 Caso sejam registrados com **sucesso**, deve ser gerado o PDF de cada boleto.  
 Caso **contrário**, deve-se retornar uma mensagem ao usuário:  
 "Erro: uma das parecelas não foi registrada, retorno: **Retorno do banco**"

 ****3. Duplicata a Receber (Imagem 3):**** Quando for selecionada uma carteira configurada com a opção **SCB2** para emissão e o usuário marcar a opção   
 **"Emitir Boleto"**, deve ser realizada a requisição de [Registro dos boletos.](https://docs.softensistemas.com.br/books/integracao-banco-sicoob-via-api/page/endpoints-producao-exemplos-json#bkmrk-2.1.1-servi%C3%A7o-para-a "Registro dos boletos.")

 Se estiver preenchido para repetir lançamentos para mais parcelas, deve ser realizado um envio para cada uma.  
 Após serem registrados, deve ser gerado o PDF de cada boleto.  
 Se **não** forem registradas, retornar mensagem ao usuário:  
 "Erro: uma das parecelas não foi registrada, retorno: **Retorno do banco**"  
  
 ***4. Tela de Consulta Duplicatas a Receber (Imagem 4):***  Quando o usuário clicar na opção **"Reemitir Boleto"** e selecionar uma carteira que esteja configurada com a opção **SCB2** para emissão, deve ser realizada a requisição para [registro dos boletos](https://docs.softensistemas.com.br/books/integracao-banco-sicoob-via-api/page/endpoints-producao-exemplos-json#bkmrk-2.1.1-servi%C3%A7o-para-a "registro dos boletos") selecionados.

 ***5.*** Para que as requisições de registro sejam realizadas, o status de cada Conta a Receber deve ser **"A enviar"**.

 ***6.*** Para que as requisições de geração do PDF sejam realizadas, os status devem estar como "Registrado".

 ***7.*** Quando se tratar de edição de alguma das formas mencionadas e o boleto já estiver registrado, deve ser realizada apenas a requisição de Geração do PDF novamente para o usuário.

##### ***Questões Técnicas:***

***1. Descrição de mudanças na base de dados, ou integração de API, ou arquivo que deva ser gerado.***

©SOFTEN SISTEMAS 2025