> 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/cadastro-positivo-boa-vista.md).

# Cadastro Positivo Boa Vista

#### Visão Geral

A integração de dados entre o Consistem ERP e a Boa Vista Serviços é totalmente embasada na Lei nº 12.414 de 09 de junho de 2011 (Lei do Cadastro Positivo). O objetivo principal desta funcionalidade é permitir o intercâmbio automatizado de informações cadastrais e financeiras (adimplência) dos clientes, viabilizando o envio dessas informações à Boa Vista para a composição do score de crédito e possibilitando a importação do retorno desses dados diretamente no ERP.

#### Requisitos

<table><thead><tr><th width="474">Consistem ERP</th><th>Cadastro Positivo Boa Vista</th></tr></thead><tbody><tr><td><p><strong>Compatibilidade:</strong> 7.5 ou superiores do Consistem ERP.</p><p><strong>Módulo:</strong> Financeiro (Contas a Receber - Controle de Crédito Boa Vista).</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. fornecedora.<br><a href="https://consumidor.boavistaservicos.com.br/">Saiba mais</a></td></tr><tr><td></td><td><strong>Credenciais de Comunicação:</strong> Disponibilização de acessos exclusivos ao servidor SFTP da Boa Vista (Usuário, Senha e Endereço do Servidor).</td></tr></tbody></table>

#### Configuração da Integração

**No Consistem ERP**

1. Acesse o programa [Configuração da Integração com Boa Vista – Cadastro Positivo (CCCRBV000)](/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/configuracoes-do-cadastro-positivo-boa-vista.md) para inserir os dados do responsável técnico da empresa, e-mail de contato, telefone de atendimento e definições iniciais da integração.<br>

   <figure><img src="/files/d8CNuuvvrvRyr2raDekz" alt=""><figcaption></figcaption></figure>
2. Através do botão **Configurações de Envio** ([Configuração da Integração com Boa Vista - Cadastro Positivo - Tela 2 (CCCRBV001)](/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)) é necessária a configuração dos protocolos de comunicação via SFTP (Endereço (`sftp.boavista.com.br`), usuário, senha, diretórios remotos/locais e Data da Última Geração).<br>

   <figure><img src="/files/vAMaVjeRss4FjfesvimH" alt=""><figcaption></figcaption></figure>
3. Acesse o programa [Empresas Boa Vista Cadastro Positivo (CCCRBV005)](/financeiro/manuais-de-telas/financeiro-cadastro-positivo-boa-vista/tabelas-gerais-do-cadastro-positivo-boa-vista/empresas-boa-vista-cadastro-positivo.md) para vinculação e parametrização das filiais e matrizes da organização autorizadas a transacionar dados com a Boa Vista.<br>

   <figure><img src="/files/aq8oUuOYGof6OjAJlHVb" alt=""><figcaption></figcaption></figure>
4. No [Cadastro de Clientes que Não Aderiram ao Serviço do Cadastro Positivo (CCCRBV010)](/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) é realizada a exceção para cadastro dos clientes (CPFs/CNPJs) que exerceram o direito legal de não participar do Cadastro Positivo, bloqueando o envio de suas informações.<br>

   <figure><img src="/files/XPuGmaWHWe4wsiPt3hBP" alt=""><figcaption></figcaption></figure>
5. Acesso o [Cadastro de Ocorrências do Boa Vista - Cadastro Positivo (CCCRBV015)](/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 cadastro e gerenciamento da tabela de ocorrências/motivos disponibilizados pela Boa Vista (retornos de sucesso, erros ou contestações).<br>

   <figure><img src="/files/5tdsqjKmA692iGmSuz2S" alt=""><figcaption></figcaption></figure>

**No Cadastro Positivo Boa Vista**

1. **Homologação Cadastral:** Alinhamento técnico para a homologação dos arquivos e validação do CNPJ contratante que receberá as cargas.
2. **Liberação de Permissões:** Configuração e abertura de permissões no ambiente de testes/produção para o recebimento dos arquivos XML estruturados pela Consistem.

#### Como a Integração Funciona

A troca de informações é realizada de forma assíncrona por meio de arquivos no formato XML estruturado, trafegados de maneira segura através do protocolo SFTP. O processo não exige intervenção manual diária do usuário para mover os arquivos, uma vez que o próprio sistema manipula as pastas configuradas.

O envio de dados é dividido em duas etapas obrigatórias e sequenciais, uma vez que a Boa Vista exige que o cliente exista na base deles antes de receber seus respectivos títulos:

1. **Fluxo de Envio (O que a Consistem envia)**
   1. **Envio de Posição de Cliente (Cadastro):** Realizado através do programa Envio de Posição de Cliente para Boa Vista - Cadastro Positivo (CCCRBV105). O ERP gera um lote com os dados cadastrais atualizados do cliente (Razão Social/Nome, CPF/CNPJ, Endereço, Bairro, CEP, Cidade, UF e Telefone).
   2. **Envio do Histórico de Crédito (Financeiro):** Realizado através do programa Envio de Informações do Histórico para Boa Vista - Cadastro Positivo (CCCRBV100). O ERP gera o lote de movimentações financeiras contendo o histórico de adimplência do cliente.
      1. **O que é enviado:** Informações de títulos em aberto e títulos pagos.
      2. **Adaptação do Leiaute para Atacado:** Como o leiaute padrão da Boa Vista foi originalmente projetado para o varejo/financiamentos, a Consistem adaptou o campo **Número Único** exigido pela Boa Vista para transmitir o número da CCCDU (parcela/título do Contas a Receber). Isso evita a rejeição de notas fiscais com múltiplas parcelas.

         <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Regra de Periodicidade:</strong> A Boa Vista estipula que cada remessa de histórico financeiro deve conter, no máximo, 10 dias de movimento. O ERP controla isso automaticamente através do campo <strong>Data Última Geração</strong>. Recomenda-se que o usuário gere e envie esses arquivos semanalmente.</p></div>
2. **Fluxo de Retorno (O que a Consistem recebe)**\
   Ao acionar o botão **Consultar** na tela [Consulta de Histórico de Crédito do Cadastro Positivo - Boa Vista (CCCRBV600)](/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 sistema dispara uma tarefa em segundo plano que busca esses arquivos e processa duas respostas principais:
   1. **Confirmação/Rejeição de Arquivo (Serviços 110 e 112):** O ERP lê o arquivo de retorno da Boa Vista e alimenta o [Cadastro de Ocorrências do Boa Vista - Cadastro Positivo (CCCRBV015)](/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). O sistema indica se o registro foi aceito com sucesso ou o código do erro técnico/cadastral que gerou a rejeição (ex: CPF inválido, CEP incorreto), permitindo ao usuário corrigir e retransmitir o dado.
   2. **Contestações de Clientes (Serviço 115):** Caso um consumidor discorde de alguma informação enviada e abra uma reclamação na Boa Vista, essa informação retorna ao ERP. O sistema exibe um alerta de **Contestações Pendentes** no programa [Consulta de Histórico de Crédito do Cadastro Positivo - Boa Vista (CCCRBV600)](/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), onde o analista financeiro deve avaliar e responder (aceitando ou rejeitando a contestação) para regularizar a situação do cliente.

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

**Leiautes de Transmissão (Formatos dos Arquivos)**

A comunicação é dividida em serviços específicos mapeados pelo sistema:

* **Serviço 109 (Remessa):** Fonte informa as configurações e dados de cadastro dos clientes.
* **Serviço 111 (Remessa):** Envio das informações do Histórico de Crédito e Obrigações Financeiras.
* **Serviço 110 (Retorno):** Resposta gerada pela Boa Vista referente ao processamento da configuração.
* **Serviço 113 (Remessa):** Envio/Tratamento do arquivo de Contestações de clientes.
* **Serviço 115 (Retorno):** Resposta ou atualização referente a contestações enviadas.

#### Fluxo do Processo

O fluxo operacional e de negócio de ponta a ponta segue as seguintes etapas e passos de trabalho dentro do sistema, utilizando o padrão de leiaute estabelecido pela Consistem:

1. **Geração dos Dados na Origem:** O usuário realiza a gestão diária de faturamentos e liquidações através dos programas especializados do ERP, tais como [Geração do Arquivo para SCI/Boa Vista (CCCCS030)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/geracao-do-arquivo-para-a-sci/geracao-do-arquivo-para-sci-boa-vista.md) ou [Cadastro da Baixa de Cliente Negativado para a SCI (CCCCS035)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/geracao-do-arquivo-para-a-sci/cadastro-da-baixa-de-cliente-negativado-para-a-sci.md).
2. **Processamento do Leiaute:** Ao acionar o botão **Gerar Arquivo** dentro de um desses programas operacionais, o ERP executa automaticamente a filtragem interna e o tratamento de download, convertendo os dados financeiros em arquivos XML formatados de acordo com o leiaute exigido.
3. **Transmissão da Remessa:** O sistema realiza o upload automático do arquivo XML para a pasta remota de remessa estabelecida no servidor SFTP do sistema Cadastro Positivo Boa Vista.
4. **Captura do Retorno:** Ao acionar o botão **Consultar** na tela de gerenciamento [Consulta de Histórico de Crédito do Cadastro Positivo - Boa Vista (CCCRBV600)](/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 ERP dispara uma tarefa em segundo plano que conecta ao diretório de retorno do SFTP e busca os arquivos de resposta processados pelo parceiro.
5. **Tratamento de Inconsistências:** O ERP realiza a leitura do arquivo de retorno e alimenta o [Cadastro de Ocorrências do Boa Vista - Cadastro Positivo (CCCRBV015)](/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). Se houver registros rejeitados por erro técnico ou cadastral (ex: CPF inválido ou CEP incorreto), o operador visualiza o motivo na [Consulta de Histórico de Crédito do Cadastro Positivo - Boa Vista (CCCRBV600)](/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), efetua a correção cadastral correspondente e o registro entra no próximo lote de envio baseado no leiaute padrão.
6. **Gerenciamento de Contestações:** Caso um consumidor abra uma contestação de informações, o registro do serviço 115 é baixado e exibe um alerta de *Contestações Pendentes* no painel do programa [Consulta de Histórico de Crédito do Cadastro Positivo - Boa Vista (CCCRBV600)](/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 analista financeiro avalia o histórico interno do título e, na própria tela, realiza a resposta de aceite ou rejeição da contestação, o que gera uma nova remessa automática do leiaute de contestação (Serviço 113) para regularizar a situação do cliente.

<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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
