> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/financeiro/controle-de-credito-boa-vista.md).

# Controle de Crédito Boa Vista

Integração | Financeiro

### Visão geral

A integração entre o Consistem ERP e o Controle de Crédito Boa Vista se baseia na Lei nº 12.414/2011 (Lei do Cadastro Positivo). Seu objetivo principal é permitir o intercâmbio automatizado e seguro de dados cadastrais e financeiros (adimplência e obrigações) dos clientes. Ela permite compor o *score* de crédito dos clientes junto à Boa Vista e realizar a importação do retorno desses dados diretamente para o ERP.

### Requisitos

<table><thead><tr><th width="461">Consistem ERP</th><th>Controle de Crédito Boa Vista</th></tr></thead><tbody><tr><td><p><strong>Compatibilidade:</strong> 7.6 ou superiores do Consistem ERP.</p><p><strong>Módulo:</strong> Financeiro - Contas a Receber</p><p><strong>Licença:</strong> <a href="https://movidesk.consistem.com.br/form/5801/">Aquisição de licença</a> <strong>CRBV</strong> ativa junto à Consistem.<br></p><p>Orientamos o acompanhamento da nossa equipe de consultores.</p></td><td>Aquisição de licença e implantação deve ser verificada com a empresa fornecedora.<br><a href="https://www.equifax.com.br/legal/fonte-positiva/">Saiba mais</a></td></tr><tr><td></td><td><strong>Credenciais SFTP:</strong> Disponibilização das credenciais exclusivas de comunicação para o servidor SFTP da Boa Vista (endereço do servidor, usuário e senha).</td></tr></tbody></table>

### Configuração da integração

#### No Consistem ERP:

1. **Dados do Responsável Técnico:** Acesse o programa [Configuração da Integração com Boa Vista - Cadastro Positivo (CCCRBV000)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/configuracoes-do-cadastro-positivo-boa-vista/configuracao-da-integracao-com-boa-vista-cadastro-positivo.md) e cadastre o e-mail de contato, telefone de atendimento e as definições iniciais do responsável.
2. **Protocolo de Comunicação SFTP:** Acesse a tela de [Configuração da Integração com Boa Vista - Cadastro Positivo - Tela 2 (CCCRBV001)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/configuracoes-do-cadastro-positivo-boa-vista/configuracao-da-integracao-com-boa-vista-cadastro-positivo-tela-2.md) e configure o protocolo SFTP informando o endereço (*sftp.boavista.com.br*), usuário, senha, diretórios remotos/locais e o campo **Data da Última Geração**.
3. **Empresas Autorizadas:** Acesse o programa [Empresas Boa Vista Cadastro Positivo (CCCRBV005)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/tabelas-gerais-do-cadastro-positivo-boa-vista/empresas-boa-vista-cadastro-positivo.md), vincule e parametrize as filiais e matrizes autorizadas a transacionar informações.
4. **Clientes Opt-Out (Exceções):** No programa [Cadastro de Clientes que Não Aderiram ao Serviço do Cadastro Positivo (CCCRBV010)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/tabelas-gerais-do-cadastro-positivo-boa-vista/cadastro-de-clientes-que-nao-aderiram-ao-servico-do-cadastro-positivo.md), cadastre os CPFs/CNPJs dos clientes que exerceram o direito de não participar do Cadastro Positivo, bloqueando o envio de seus dados.
5. **Tabela de Ocorrências:** Acesse o programa [Cadastro de Ocorrências do Boa Vista - Cadastro Positivo (CCCRBV015)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/tabelas-gerais-do-cadastro-positivo-boa-vista/cadastro-de-ocorrencias-do-boa-vista-cadastro-positivo.md), gerencie e cadastre os motivos e códigos de retorno disponibilizados pela Boa Vista (sucessos, erros e contestações).

#### No Controle de Crédito Boa Vista:

1. **Homologação Cadastral:** Alinhamento técnico junto ao suporte/consultoria da Boa Vista para validação do CNPJ contratante que receberá as cargas.
2. **Abertura de Permissões:** Configuração e liberação de acessos no ambiente de testes/produção para a recepção dos arquivos XML estruturados pela Consistem.

### Como a integração funciona

A troca de informações ocorre de forma assíncrona por meio de arquivos no formato XML estruturado, trafegados via protocolo SFTP. O envio e recebimento são estruturados em serviços mapeados nativamente pelo sistema:

**Dados Enviados pelo Consistem ERP:** O envio de dados para a Boa Vista ocorre em etapas sequenciais obrigatórias através dos leiautes do sistema:

1. **Posição de Cliente (Cadastro - Serviço 109 -** [**Envio de Posição de Cliente para Boa Vista - Cadastro Positivo (CCCRBV105)**](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/manutencoes-do-cadastro-positivo-boa-vista/envio-de-posicao-de-cliente-para-boa-vista-cadastro-positivo.md)**):**
   1. Informações Enviadas: Dados cadastrais atualizados do cliente (Razão Social/Nome, CPF/CNPJ, Endereço, Bairro, CEP, Cidade, UF e Telefone).
   2. Regra do Leiaute: A Boa Vista exige que o cliente esteja previamente cadastrado antes de receber seu histórico financeiro.
2. **Histórico de Crédito (Financeiro - Serviço 111 -** [**Envio de Informações do Histórico para Boa Vista - Cadastro Positivo (CCCRBV100)**](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/manutencoes-do-cadastro-positivo-boa-vista/envio-de-informacoes-do-historico-para-boa-vista-cadastro-positivo.md)**):**
   1. Informações Enviadas: Lote de movimentações contendo títulos em aberto e títulos pagos.
   2. Regra do Leiaute: O campo *Número Único* exigido no padrão da Boa Vista é preenchido pela Consistem com a chave **CCCDU** (parcela/título do Contas a Receber), impedindo a rejeição de notas fiscais com múltiplas parcelas.
   3. Periodicidade: Cada remessa financeira contém, no máximo, 10 dias de movimento, controlado automaticamente pelo campo *Data da Última Geração*.
3. **Tratamento de Contestações (Serviço 113):**
   1. Informações Enviadas: Envio da resposta de aceite ou rejeição emitida pelo analista financeiro quando um consumidor abre uma contestação referente a uma informação enviada.

**Dados Recebidos pelo Consistem ERP:** Ao acionar a consulta, o ERP dispara uma tarefa em segundo plano que se conecta ao diretório remoto do SFTP e processa os arquivos de retorno:

1. **Confirmação/Rejeição de Arquivo (Serviços 110 e 112):** Resposta gerada pela Boa Vista confirmando o processamento do lote enviado. Se houver erro técnico/cadastral (ex.: CPF inválido ou CEP incorreto), o motivo alimenta o [Cadastro de Ocorrências do Boa Vista - Cadastro Positivo (CCCRBV015)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/tabelas-gerais-do-cadastro-positivo-boa-vista/cadastro-de-ocorrencias-do-boa-vista-cadastro-positivo.md) para posterior correção pelo usuário.
2. **Contestações de Clientes (Serviço 115):** Atualizações de reclamações ou divergências abertas pelos consumidores na Boa Vista.

{% hint style="info" %}
O arquivo de retorno serve exclusivamente para validar a transmissão, apontar erros ou trazer contestações. Ele **não altera** saldos, baixas ou dados financeiros internos do Consistem ERP.
{% endhint %}

### Fluxo do processo

O fluxo operacional de trabalho é executado pelo usuário final através dos seguintes passos operacionais:

1. **Geração dos dados operacionais:** O usuário realiza a gestão financeira rotineira de faturamentos e baixas no ERP utilizando as rotinas operacionais do Contas a Receber.
2. **Geração do arquivo de remessa no leiaute Consistem:**
   1. Para enviar os dados cadastrais, o operador aciona o programa [Envio de Posição de Cliente para Boa Vista - Cadastro Positivo (CCCRBV105)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/manutencoes-do-cadastro-positivo-boa-vista/envio-de-posicao-de-cliente-para-boa-vista-cadastro-positivo.md) e clica em **Gerar Arquivo**.
   2. Para enviar o histórico financeiro, o operador acessa o programa [Envio de Informações do Histórico para Boa Vista - Cadastro Positivo (CCCRBV100)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/manutencoes-do-cadastro-positivo-boa-vista/envio-de-informacoes-do-historico-para-boa-vista-cadastro-positivo.md) e clica em **Gerar Arquivo**.
   3. O ERP formata automaticamente as informações no leiaute XML aceito pela Boa Vista.
3. **Transmissão da Remessa:** O sistema executa o upload automático do arquivo XML para a pasta de remessa configurada no servidor SFTP da Boa Vista, dispensando a movimentação manual do arquivo.
4. **Captura do Retorno:** Na tela [Consulta de Histórico de Crédito do Cadastro Positivo - Boa Vista (CCCRBV600)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/manutencoes-do-cadastro-positivo-boa-vista/consulta-de-historico-de-credito-do-cadastro-positivo-boa-vista.md), o usuário clica no botão **Consultar**. O ERP conecta-se ao SFTP e realiza o download dos arquivos de retorno disponibilizados pela Boa Vista.
5. **Tratamento de Inconsistências:** Caso o retorno aponte rejeição por erro cadastral, o operador consulta a ocorrência no programa [Consulta de Histórico de Crédito do Cadastro Positivo - Boa Vista (CCCRBV600)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/manutencoes-do-cadastro-positivo-boa-vista/consulta-de-historico-de-credito-do-cadastro-positivo-boa-vista.md), realiza a correção cadastral do cliente no ERP e o registro entra automaticamente no próximo lote de envio.
6. **Gerenciamento de Contestações:** Se houver contestação pendente (exibida em tela via alerta do Serviço 115), o analista financeiro avalia o histórico interno do título diretamente na tela [Consulta de Histórico de Crédito do Cadastro Positivo - Boa Vista (CCCRBV600)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/manutencoes-do-cadastro-positivo-boa-vista/consulta-de-historico-de-credito-do-cadastro-positivo-boa-vista.md) e emite a resposta (aceite ou rejeição), que será transmitida no próximo lote de envio no leiaute do Serviço 113.

<p align="center">Esse conteúdo foi útil?</p>

<p align="center"><a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-up">Sim</a> <a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-down">Não</a></p>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/financeiro/controle-de-credito-boa-vista.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
