For the complete documentation index, see llms.txt. This page is also available as Markdown.

Cadastro Positivo Boa Vista

Integração | Financeiro

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

Consistem ERP
Cadastro Positivo Boa Vista

Compatibilidade: 7.6 ou superiores do Consistem ERP.

Módulo: Financeiro (Contas a Receber - Controle de Crédito Boa Vista).

Orientamos o acompanhamento da nossa equipe de consultores.

Aquisição de licença e implantação deve ser verificada com a empresa fornecedora. fornecedora. Saiba mais

Credenciais de Comunicação: Disponibilização de acessos exclusivos ao servidor SFTP da Boa Vista (Usuário, Senha e Endereço do Servidor).

Configuração da Integração

No Consistem ERP

  1. Acesse o programa Configuração da Integração com Boa Vista – Cadastro Positivo (CCCRBV000) 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.

  2. Através do botão Configurações de Envio (Configuração da Integração com Boa Vista - Cadastro Positivo - Tela 2 (CCCRBV001)) é 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).

  3. Acesse o programa Empresas Boa Vista Cadastro Positivo (CCCRBV005) para vinculação e parametrização das filiais e matrizes da organização autorizadas a transacionar dados com a Boa Vista.

  4. No Cadastro de Clientes que Não Aderiram ao Serviço do Cadastro Positivo (CCCRBV010) é 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.

  5. Acesso o Cadastro de Ocorrências do Boa Vista - Cadastro Positivo (CCCRBV015) para cadastro e gerenciamento da tabela de ocorrências/motivos disponibilizados pela Boa Vista (retornos de sucesso, erros ou contestações).

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.

        Regra de Periodicidade: 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 Data Última Geração. Recomenda-se que o usuário gere e envie esses arquivos semanalmente.

  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), 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). 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), onde o analista financeiro deve avaliar e responder (aceitando ou rejeitando a contestação) para regularizar a situação do cliente.

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.

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) ou Cadastro da Baixa de Cliente Negativado para a SCI (CCCCS035).

  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), 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). 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), 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). 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.

Esse conteúdo foi útil?

Sim Não

Atualizado