Este manual está em construção. Portanto, alguns links podem direcionar para páginas com conteúdo em desenvolvimento.

Configuração de cobrança bancária - ERP UAU

A funcionalidade de Configuração de Cobrança Bancária permite parametrizar os dados utilizados pelo ERP UAU para emissão, registro, manutenção e controle de cobranças bancárias. Por meio dessa configuração, são definidos os padrões de cobrança que serão utilizados nas vendas, propostas e demais processos financeiros que envolvem geração de boletos.

Nessa tela, o usuário informa os dados necessários para a comunicação com a instituição financeira, como banco, conta corrente, carteira, modalidade de cobrança, tipo de transmissão, regras de juros, multa, protesto e demais parâmetros exigidos pelo banco. Essas informações orientam o sistema na geração correta dos boletos e no tratamento das operações relacionadas à cobrança.

A configuração pode atender diferentes modelos de cobrança, como boletos registrados por arquivos CNAB, cobranças digitais via API e modelos híbridos, conforme a disponibilidade do banco e o contrato firmado com a instituição financeira.

Acesse o menu: Gestão de construção | UAU XT > Venda > Utilitários > Configurações > Configuração de Cobrança Bancária


O que você pode fazer

Cadastrar novo padrão de cobrança
  1. Acesse o menu: Vendas > Utilitários > Configuração de cobrança bancária.

  2. Clique no botão Novo para iniciar o cadastro de um novo padrão de cobrança.

  3. Preencha o campo Descrição do padrão de cobrança, informando um nome para identificação.

  4. No campo Banco, selecione a instituição financeira e, em seguida, informe a conta bancária vinculada.

  5. Defina o Tipo de emissão de boleto, conforme a forma de geração adotada.

  6. No campo Tipo de cobrança, selecione a modalidade contratada e a respectiva Carteira.

  7. Preencha os campos Mensagem impressa pelo banco e Mensagem impressa pelo UAU, conforme necessário.

  8. Complete os demais campos disponíveis de acordo com as informações e o layout fornecidos pelo banco.

  9. Clique em Gravar para salvar o padrão de cobrança.

Importante

As informações e campos disponíveis podem variar conforme o banco e o tipo de cobrança selecionado. Utilize sempre os dados fornecidos pela instituição financeira para garantir o correto processamento das cobranças.

Instruções para utilizar API

Cobrança digital do Banco ABC (246)

A integração API com o Banco ABC Brasil (246) permite utilizar a modalidade Digital para registro e manutenção de boletos diretamente pela API do banco, sem necessidade de geração de arquivos de remessa para essas operações. Com essa modalidade, o UAU passa a registrar boletos de vendas e propostas diretamente na API do banco.

Após o registro, o sistema grava automaticamente na parcela as informações retornadas pelo banco, como linha digitável, código de barras e Nosso Número.

A integração também permite realizar operações de manutenção pela API, como cancelamento, baixa e alteração de vencimento, mantendo o status da parcela atualizado no UAU conforme o retorno do Banco ABC.

Para utilizar essa funcionalidade, confira se:

  • A conta corrente do Banco ABC Brasil (246) está cadastrada no UAU;
  • As credenciais de API foram fornecidas pelo banco; client_id, client_secret e ambiente (Produção ou Homologação);
  • O padrão de cobrança foi configurado com a modalidade Digital;
  • Os parâmetros de emissão, como carteira, juros, multa e protesto, foram preenchidos conforme orientação bancária;
  • O padrão de cobrança foi vinculado às obras, vendas ou propostas que utilizarão a integração;
  • Rotina Processar retorno de cobrança (10) no ProUAU (seção Cobrança), esteja configurada e executando automaticamente.

Importante

  • A geração de QR Code PIX está temporariamente indisponível na API do Banco ABC. O recebimento ocorre somente pelo código de barras tradicional.
  • Boletos já registrados pelo fluxo CNAB não são migrados automaticamente para a modalidade Digital.
  • A integração API vale apenas para novas emissões realizadas com o padrão de cobrança Digital do Banco ABC.
Como Preparar seu Ambiente para a Migração de APIs do Itaú

O Itaú realizou uma atualização de segurança nas APIs utilizadas pelo UAU para emissão de boletos e cobranças via PIX. O tipo de ação que você precisa executar depende de onde seu UAU está instalado.

UAU na Cloud Senior

Se seu UAU está hospedado na Cloud Senior, não é necessário fazer nada de infraestrutura. A Senior já cuida de:

  • Nova cadeia de certificados;
  • Liberações de IP;
  • Configurações de ambiente.

Ação necessária: Manter o UAU atualizado na versão que contempla os novos endereços das APIs do Itaú.

UAU em servidor próprio, datacenter ou infraestrutura gerenciada

Você deve executar os 4 passos abaixo:

  • Passo 1: Atualizar o UAU (obrigatório): a versão mais recente já contém os novos endereços das APIs do Itaú. Após a atualização, você não precisa alterar nada manualmente — o sistema passa a usar os novos endereços automaticamente.

    Importante

    Os próximos passos são necessários apenas se você encontrar erros de comunicação com o Itaú.

  • Passo 2: Instalar a cadeia de certificados GlobalSign:

    • Baixe os certificados:

      1. Acesse o Portal do Desenvolvedor do Itaú

      2. Faça o download dos três certificados:

        • GlobalSign Root R46.
        • GlobalSign GCC R46 OV TLS CA 2025.
        • GlobalSign GCC R46 EV TLS CA 2025.
      3. Salve os arquivos .cer em uma pasta acessível no seu servidor

    • Instale os certificados (Windows): Abra o PowerShell como Administrador e execute os comandos abaixo (substitua o caminho conforme onde você salvou os arquivos):

      • Import-Certificate -FilePath "C:\caminho\GlobalSign Root R46.cer" -CertStoreLocation Cert:\LocalMachine\Root

      • Import-Certificate -FilePath "C:\caminho\GlobalSign GCC R46 OV TLS CA 2025.cer" -CertStoreLocation Cert:\LocalMachine\CA

      • Import-Certificate -FilePath "C:\caminho\GlobalSign GCC R46 EV TLS CA 2025.cer" -CertStoreLocation Cert:\LocalMachine\CA

      Importante

      Use LocalMachine (repositório da máquina), não por perfil de usuário. O UAU é executado por uma conta de serviço que reconhece apenas certificados do repositório da máquina.

    • Valide a instalação: Verifique se os certificados aparecem no Gerenciador de Certificados do Windows. Tente estabelecer uma conexão com o Itaú novamente. Confirme se os erros de SSL desapareceram.

  • Passo 3: Liberar IPs do Itaú no seu Firewall: Necessário quando o firewall controla o tráfego de saída por endereço de IP. e quando existem regras que bloqueiam comunicação com IPs externos

    • O que você pode fazer: Autorize a comunicação de saída pela porta 443 (HTTPS) para os seguintes endereços de IP do Itaú:
      • 200.196.155.117/32<br/>

      • 138.59.163.117/32<br/>

      • 138.59.163.69/32<br/>

      • 3.44.192.200/29<br/>


      Exemplo de regra de firewall:
      • Protocolo: HTTPS (443)
      • Destino: IPs listados acima
      • Direção: Saída
      • Ação: Permitir
        Teste a comunicação entre seu servidor e as APIs do Itaú para confirmar que a liberação funcionou.
  • Passo 4: se você executou o Passo 2 é necessário reiniciar IIS e Serviços do UAU.

    • Abra o PowerShell como Administrador e execute:

      • iisreset
    • manualmente:

      1. Abra Serviços no Windows (services.msc);
      2. Localize os serviços do UAU;
      3. Reinicie cada um deles.

Importante

Certificado da empresa:
O certificado que a empresa usa para se autenticar junto ao Itaú não precisa ser substituído. A alteração do Itaú diz respeito apenas aos certificados de segurança do lado da infraestrutura do Itaú.

Instalação de certificados:
A instalação manual é uma recomendação preventiva — você a executa principalmente em caso de erros de conexão SSL. A maioria dos servidores Windows atualizados reconhece automaticamente a cadeia GlobalSign.

Dúvidas ou Problemas?: Consulte a documentação técnica oficial do Itaú

Bancos homologados

Banco Fibra (224)

A funcionalidade de cobrança bancária para o Banco Fibra (224) permite realizar o gerenciamento completo de boletos utilizando a Carteira 110 e o padrão CNAB 400. Por meio dela, é possível configurar os parâmetros exigidos pelo banco, gerar remessas, emitir boletos, processar arquivos de retorno e realizar manutenções como cancelamento e alteração de vencimento.


  • Antes de configurar o padrão de cobrança para o Banco Fibra, certifique-se de que:
    • Conta bancária do banco Fibra já está cadastrada (agência e conta corrente).
    • Cadastro de empresas, aba Cobrança bancária com os dados corretos para emissão de boletos.

  1. Acesse o menu: Vendas > Utilitários > Configuração de cobrança bancária.
  2. Selecione a Empresa para qual irá cadastrar o padrão de cobrança.
  3. Clique no botão Novo para iniciar o cadastro de um novo padrão de cobrança.
  4. Preencha a Descrição do padrão de cobrança com um nome que facilite a identificação do cadastro.
  5. Em Banco, informe ou selecione 224 - Banco Fibra.
  6. Em Conta, selecione a conta bancária do Fibra que será utilizada na emissão dos boletos.
  7. Na aba Boleto, selecione o Tipo de cobrança CNAB 400.
  8. A Carteira é preenchida de forma automatica assim que selecionado o tipo de cobrança.
  9. Em Código da Empresa, informe o código da sua conta no Fibra, sem o dígito verificador. O campo aceita valores alfanuméricos e substitui o campo anteriormente chamado Convênio.
  10. Em Cód. do cedente, informe o código fornecido pelo Banco Fibra. Esse preenchimento é obrigatório.
  11. Em Número da Operação, informe o número fornecido pelo Banco Fibra. Código utilizado pelo banco para identificar a modalidade da conta bancária, como conta corrente ou poupança, quando aplicável.
  12. Em Cód. Faixa de nosso número, informe a faixa numérica fornecida pelo banco. O sistema utilizará essa faixa com sequencial único, sem duplicidade entre remessas.
  13. Em Tipo modalidade, informe ou selecione 110, modalidade específica do Fibra.
  14. Revise as informações e clique em Gravar para salvar o padrão de cobrança.

Importante

Os campos Código da Empresa, Código do Cedente/Beneficiário, Número de Operação, Faixa do Nosso Número e Número Sequencial Inicial da Remessa devem ser preenchidos com os dados oficiais fornecidos pelo Banco Fibra.

C6 Bank (336)

A funcionalidade de cobrança bancária para o C6 Bank (336) permite realizar o gerenciamento de boletos utilizando o layout CNAB 400. Antes de começar, tenha em mãos os dados fornecidos pelo C6 Bank para o contrato de cobrança:

  • A conta corrente e o dígito verificador são obrigatórios. A conta deve estar cadastrada com até 12 posições.

  • Tipo de cobrança e carteira;

  • Código de escrituração, tipo de modalidade, conta correspondente e prazo para protesto, quando exigidos pelo banco;

  • O contrato com o banco informa a carteira, a modalidade e os demais códigos necessários para a geração da remessa CNAB 400.

  1. Acesse o menu: Vendas > Utilitários > Configuração de cobrança bancária.

  2. Selecione a Empresa para a qual irá cadastrar o padrão de cobrança.

  3. Clique no botão Novo para iniciar um novo padrão de cobrança ou selecione um padrão existente para edição.

  4. Preencha a Descrição do padrão de cobrança com um nome identificador.

  5. No campo Banco, selecione 336 - C6 Bank.

  6. Selecione a Conta corrente com DV (Dígito verificador) que foram previamente cadastrados. O DV é validado antes da geração da remessa CNAB 400.

  7. Selecione o Tipo de cobrança e a Carteira contratado.

  8. Marque Imprimir boleto para imprimir o boleto após a geração.

  9. Selecione as mensagens conforme necessário:

    • Mensagem impressa pelo banco: mensagem que o banco imprimirá no boleto, quando aplicável.
    • Mensagem impressa pelo UAU: mensagem que o UAU imprimirá no boleto.
  10. Preencha os demais campos obrigatórios conforme a orientação do C6 Bank:

    • Código escrituração Código utilizado pelo banco para identificar a modalidade de escrituração da cobrança, determinando como os títulos serão registrados e controlados na instituição financeira.

    • Tipo de modalidade Identifica a modalidade de cobrança utilizada junto ao C6 Bank, conforme parametrização e contrato firmado com o banco para registro e processamento dos boletos (por exemplo, cobrança registrada, emissão pelo banco ou emissão pelo cliente.)

    • Conta correspondente Informa a conta bancária vinculada à operação de cobrança, utilizada pelo banco para recepção dos créditos e processamento dos títulos registrados.

    • Prazo para protesto Quantidade de dias após o vencimento em que o boleto poderá ser encaminhado para protesto, de acordo com as regras definidas junto ao banco.

    • Conferir sequencial remessa Define se o sistema deve validar a sequência numérica das remessas geradas, garantindo o envio dos arquivos na ordem esperada pelo banco.

    • Cód. faixa nosso número Código utilizado para identificar a faixa de Nosso Número cadastrada para a cobrança bancária. Essa informação é utilizada pelo sistema para gerar os boletos dentro da faixa numérica disponibilizada pelo banco, garantindo a emissão sequencial e evitando duplicidades.

  11. Revise as informações e clique em Gravar para salvar o padrão de cobrança.

Importante

A conta corrente e o dígito verificador devem ser iguais aos dados informados pelo C6 Bank. O sistema utiliza essas informações para gerar a remessa CNAB 400 e bloqueia a geração quando houver dados ausentes ou inválidos.

Este artigo ajudou você?