# Contador de Nosso Número  

## Introdução  

O **Contador de Nosso Número** é uma funcionalidade do sistema para gerenciar a numeração de documentos em boletos bancários. Essa ferramenta é essencial para garantir a organização e a unicidade dos números gerados, especialmente em transações com instituições financeiras, como bancos físicos (**Sicoob, Sicredi, etc.**).  

## Funcionalidades Principais  

### 1. Criação de Número de Documento Específico  
O sistema permite a criação de um número de documento específico para boletos, conhecido como **Contador do Nosso Número**.  

> [!NOTE] Aplicação Comum  
> Essa funcionalidade é utilizada nas carteiras de cobrança e **é obrigatória** para o banco **Sicredi**.  

### 2. Configuração Personalizada  

O contador pode ser configurado com os seguintes parâmetros:  

| Parâmetro                 | Descrição                                      |
|---------------------------|------------------------------------------------|
| **Filial**                | Seleção da filial da conta.                     |
| **Descrição**             | Breve descrição do contador.                    |
| **Próximo Número de Boleto** | Numeração inicial para emissão de boletos.       |
| **Numeração do Lote**     | Geralmente configurado como "0".                |
| **Contador Sicredi**      | Opção para carteiras **Sicredi** convencionais. |

### 3. Geração Automática de Numeração  
O sistema gera automaticamente a numeração para novas cobranças, seguindo a sequência numérica definida no contador.  

### 4. Prevenção de Duplicidade  
Impede a criação de cobranças duplicadas em casos em que a carteira já possui um contador **Sicredi** configurado.  

### 5. Limite de Numeração  
O sistema não permite a geração de números superiores a **999999**, evitando problemas com limites bancários.  

> [!WARNING] Aviso!  
> Caso esse limite seja atingido antes da virada do ano vigente, será necessário abrir um **novo convênio bancário** para emissão de boletos, o que exigirá a criação de uma **nova carteira de cobrança**.  

### 6. Alerta de Limite Atingido  
Quando o limite máximo de numeração é atingido, ao tentar gerar novos títulos, o sistema exibe a seguinte mensagem:  

> [!DANGER] Erro  
> Ops! A informação do nosso número excedeu a quantidade de dígitos permitida.  
> Por favor, entre em contato com nosso suporte para maiores informações.  

Nesse caso, entre em contato com o **banco** para solicitar um **novo convênio**. Após isso, configure uma **nova carteira de cobrança** no sistema com esse convênio para continuar emitindo boletos.  

### 7. Flexibilidade para Diferentes Bancos  
Embora seja obrigatório para o **Sicredi**, o contador também pode ser adaptado para outros bancos, desde que validado com a instituição financeira.  

## Configurando o Contador de Nosso Número  

1. Acesse o menu **Sistema**.  
2. Entre na opção **Cadastros**.  
3. Acesse a pasta **Financeiro**.  
4. Em **Carteira de Cobrança**, selecione a carteira desejada e clique em **Editar**.  
5. Na aba **Configurações Bancárias**, clique na lupa do campo **Contador do Nosso Número**.  
6. Para cadastrar um novo contador, clique em **Novo**.  

### Campos  

No novo contador, preencha as seguintes informações:  

- **Filial**: Selecione a filial da conta.  
- **Descrição**: Insira uma breve descrição, como **Contador Nosso Número Sicredi**.  
- **Próximo Número de Boleto**: Coloque a numeração do **Nosso Número** que será usada na emissão do boleto. O primeiro número deve ser o **byte** (fornecido pelo banco) + 5 dígitos do **Nosso Número Sicredi**.  
  - **Exemplo**: Se o **byte for 2**, o número a ser inserido será **200001**.  

## Fluxograma  

```mermaid  
graph TD  
    A[Início] --> B[Menu Sistema]  
    B --> C[Cadastros]  
    C --> D[Financeiro]  
    D --> E[Em Carteira de Cobrança, selecione a carteira desejada]  
    E --> F[Clicar em Editar]  
    F --> G[Aba Configurações Bancárias, clicar na lupa do campo Contador do Nosso Número]  
    G --> H[Clicar em Novo]  
    H --> I[Preencher os Dados]  
    I --> J[Selecionar a Filial da conta]  
    I --> K[Inserir uma breve Descrição]  
    I --> L[Informar o Próximo Número de Boleto]  
    J & K & L --> M[Salvar]  
    M --> N[Fim]  
```

## Considerações Finais  

Essa documentação fornece uma visão geral das funcionalidades do **Contador de Nosso Número** no sistema, destacando sua importância na organização sequencial da numeração dos boletos.  

- O **uso do contador** é recomendado principalmente quando ajustes na numeração são necessários e **o auto incremento via banco de dados não pode ser ajustado**.  
- Para **bancos além do Sicredi**, é importante verificar quantos dígitos são aceitos no **Nosso Número** dos boletos.  
- Caso o limite de **999999** seja atingido, será **obrigatório** solicitar um **novo número de convênio** ao banco e configurar uma nova carteira de cobrança no sistema.

## Etiquetas
#ContadorDoNossoNumero #NNBoleto #DuplicidadeDeBoletos #NossoNumero #CarteiraDeCobranca #IntegracaoBancaria #API #APIBancaria

## Leia Também
* [[carteira de cobranca|Carteira de Cobrança]]
* [[integracoes bancarias - remessa e retorno manual|Integrações Bancárias - Remessa e Retorno Manual]]
* [[integracoes bancarias - api|Integrações Bancárias - API]]
* [[public/conceitos/gerais/api banco sicoob|API Banco Sicoob]]
* [[api banco sicredi|API Banco Sicredi]]
* [[api banco santander|API Banco Santander]]