Forma de Cobrança
Criado por Igor Ribeiro em 08 de setembro de 2026
Atualizado por Igor Ribeiro em 08 de setembro de 2026
Forma de Cobrança
Cadastro centralizado de modalidades de recebimento aceitas pela empresa no módulo Financeiro do ERP.
Visão Geral da Forma de Cobrança
A rotina “Forma de Cobrança” faz parte do módulo Financeiro do ERP, dentro do submódulo Cadastro. Ela centraliza o registro de todas as modalidades de recebimento aceitas pela empresa, como boleto bancário, cheque, PIX, cartão e outros meios de cobrança.
As formas cadastradas aqui servem de referência para diversas outras partes do sistema. Ao registrar uma venda, emitir um título no Contas a Receber, ou configurar a geração de boletos e cobranças via PIX, o sistema utiliza as formas de cobrança definidas nesta rotina. Por isso, manter esse cadastro atualizado e correto é essencial para o bom funcionamento dos processos financeiros da empresa.
O cadastro permite classificar cada forma com informações como: tipo de cobrança (boleto, cheque, PIX), qualificação para o SPED, se a forma emite boleto bancário, se está disponível para uso no Frente de Loja, e qual é o meio de pagamento conforme a tabela do Banco Central.
ℹ Informação Importante
Manter esse cadastro atualizado e correto é essencial para o bom funcionamento dos processos financeiros da empresa.
Vídeo Tutorial da Forma de Cobrança
▶ Tutorial em vídeo: ainda não disponível para esta rotina.
Pré-requisitos e Contexto de Acesso da Forma de Cobrança
Para acessar a tela de Forma de Cobrança, o usuário precisa ter a permissão “ListViewDeFormaCobranca” associada ao seu perfil de acesso. Sem essa permissão, o item de menu correspondente não aparece para o usuário.
Permissões Obrigatórias por Ação
Além do acesso à tela, cada ação dentro da rotina exige uma permissão específica:
- Incluir uma nova forma de cobrança: permissão “FormaCobranca/Novo”.
- Editar uma forma já existente: permissão “FormaCobranca/Editar”.
- Excluir uma forma: permissão “FormaCobranca/Excluir”.
- Exportar a lista de formas cadastradas: permissão “FormaCobranca/Exportar”.
Se o usuário não tiver a permissão correspondente a uma dessas ações, ele não consegue realizá-la, mesmo que tenha acesso à tela.
Dependências Técnicas
Não é necessário ter nenhum outro cadastro feito antes para acessar esta tela. Porém, existe uma condição especial: para cadastrar ou editar uma forma de cobrança do tipo “PB” (PIX/Boleto Híbrido), é necessário que o Parâmetro 5096 (“Liberado API PIX/BOLETO – Boleto Híbrido”) esteja configurado como “S” (Sim) no sistema. Essa configuração de parâmetro normalmente é feita por um usuário responsável pelas configurações gerais do sistema.
⚠ Atenção
Veja mais detalhes sobre o Parâmetro 5096 na seção “Regras de Negócio e Restrições da Forma de Cobrança”.
Processo de Criação: Passo a Passo da Forma de Cobrança
Acessar a tela de Forma de Cobrança
O usuário acessa o módulo Financeiro e localiza a rotina “Forma de Cobrança” no menu. O sistema exibe uma grade com todas as formas de cobrança já cadastradas.
Acionar a inclusão de uma nova forma de cobrança
O usuário clica no botão de inclusão (a ação “Novo”). O sistema abre o formulário de cadastro em branco, pronto para o preenchimento.
Preencher o campo Código
O usuário informa o código numérico que identificará a forma de cobrança. Esse código funciona como a chave de identificação única do registro e não poderá ser alterado depois que o cadastro for salvo.
Preencher o campo Nome
O usuário informa o nome descritivo da forma de cobrança, por exemplo: “BOLETO BANCÁRIO”, “CHEQUE À VISTA” ou “PIX”.
Selecionar o Tipo da Forma de Cobrança
O usuário escolhe o tipo no campo “Tipo da Forma de Cobrança”. Os valores identificados são: “BO” (Boleto), “CH” (Cheque), “CA” (Cheque à Vista), “CS” (Cheque a Prazo), “PX” (PIX), “PY” (PIX/Boleto variante) e “PB” (PIX/Boleto Híbrido). Se o usuário selecionar o tipo “PB” e o Parâmetro 5096 não estiver habilitado, o sistema bloqueia o salvamento e exibe uma mensagem de erro explicando o motivo.
Preencher os campos complementares
O usuário preenche os demais campos conforme a necessidade da empresa: Tipo Prazo/Vista, Qualificação SPED, Emite Boleto, Cobrança Bancária, Liberado Frente de Loja, Imprime Relatório Gerencial, Tipo Forma SPED e Meio de Pagamento. Todos esses campos são detalhados na seção “Descrição de Cada Campo da Tela da Forma de Cobrança”.
Salvar o registro
O usuário confirma o cadastro clicando em salvar. O sistema grava o registro imediatamente, registra a operação em um log de auditoria interno e exibe a mensagem de confirmação “Forma cobrança inserido com sucesso.”
Descrição de Cada Campo da Tela da Forma de Cobrança
Código
Descrição: Identificador único da forma de cobrança dentro do sistema. Deve ser um valor numérico que ainda não esteja em uso por outra forma de cobrança já cadastrada.
Comportamento: Depois que o registro é salvo pela primeira vez, este campo fica bloqueado e não pode mais ser alterado.
Impacto: Este código é usado como referência em títulos do Contas a Receber, em vendas e em outros módulos que utilizam forma de cobrança. É a informação que conecta o cadastro da forma de cobrança a essas outras partes do sistema.
Nome
Descrição: Nome descritivo da forma de cobrança, que aparece nas telas de seleção em todo o sistema.
Comportamento: Campo de texto livre. O sistema utiliza esse nome nas listas de seleção e na grade principal da rotina. A busca na grade filtra pelo nome informado, aceitando busca parcial (não é necessário digitar o nome completo).
Impacto: Aparece sempre que o usuário precisa selecionar uma forma de cobrança em outras telas e módulos do sistema.
Tipo da Forma de Cobrança
Descrição: Classifica a natureza da cobrança. Os valores identificados na documentação de origem são: “BO” (Boleto), “CH” (Cheque), “CA” (Cheque à Vista), “CS” (Cheque a Prazo), “PX” (PIX), “PY” (PIX/Boleto variante) e “PB” (PIX/Boleto Híbrido). [informação não disponível na documentação de origem, validar com analista responsável a lista completa de tipos disponíveis diretamente na interface]
Comportamento: A escolha deste campo determina em quais telas especializadas a forma aparecerá depois. Formas com tipo “CH”, “CA” ou “CS” aparecem nas listas de seleção de cheque recebido. Formas com tipo “PX” ou “PY” aparecem nas listas de geração de PIX. O tipo “PB” só pode ser selecionado e salvo quando o Parâmetro 5096 estiver habilitado como “S” (Sim).
Impacto: Controla em quais telas do sistema a forma de cobrança fica disponível para seleção (cheque recebido, geração de PIX), além de influenciar o comportamento de geração de boleto e de cobrança bancária.
Tipo Prazo/Vista
Descrição: Indica se a cobrança é realizada a prazo (parcelada, com vencimento futuro) ou à vista (pagamento imediato).
Comportamento: [informação não disponível na documentação de origem, validar com analista responsável quais são os valores exatos aceitos neste campo e como eles aparecem na tela]
Impacto: Utilizado em relatórios e em cálculos financeiros que precisam diferenciar cobranças a prazo de cobranças à vista.
Qualificação SPED
Descrição: Código que classifica a forma de cobrança para fins de geração do SPED (Sistema Público de Escrituração Digital), uma obrigação fiscal eletrônica exigida pelo governo.
Comportamento: [informação não disponível na documentação de origem, validar com analista responsável quais são os valores aceitos e como selecioná-los na tela]
Impacto: Utilizado na geração das obrigações acessórias fiscais (SPED Fiscal e SPED Contábil).
Emite Boleto
Descrição: Indica se esta forma de cobrança deve gerar boleto bancário quando utilizada.
Comportamento: Aceita apenas “S” (Sim) ou “N” (Não).
Impacto: Controla se o sistema tentará gerar um boleto bancário ao utilizar esta forma em um título do Contas a Receber.
Cobrança Bancária
Descrição: Indica se esta forma de cobrança está integrada ao processo de cobrança bancária, ou seja, à troca de arquivos de remessa e retorno com o banco.
Comportamento: Aceita apenas “S” (Sim) ou “N” (Não).
Impacto: Interfere diretamente no processamento dos arquivos de remessa e retorno bancário dentro do módulo Financeiro.
Liberado Frente de Loja
Descrição: Indica se esta forma de cobrança pode ser utilizada nas operações realizadas no módulo Frente de Loja (o ponto de venda usado no caixa).
Comportamento: Aceita apenas “S” (Sim) ou “N” (Não). Somente as formas marcadas como “S” ficam disponíveis para seleção dentro do Frente de Loja.
Impacto: Controla quais formas de cobrança o operador de caixa consegue selecionar ao registrar uma venda no Frente de Loja.
Imprime Relatório Gerencial
Descrição: Indica se esta forma de cobrança deve ser incluída nos relatórios gerenciais financeiros da empresa.
Comportamento: Aceita apenas “S” (Sim) ou “N” (Não).
Impacto: Controla se a forma de cobrança aparece ou não nos relatórios gerenciais do módulo Financeiro.
Tipo Forma SPED
Descrição: Código numérico do tipo de forma de cobrança exigido pelo SPED. Complementa a informação do campo “Qualificação SPED” quando alguma obrigação acessória exige esse detalhe adicional.
Comportamento: Aceita um valor numérico ou pode ficar em branco, caso não se aplique.
Impacto: Utilizado na geração de obrigações acessórias fiscais que exigem especificamente essa informação.
Meio de Pagamento
Descrição: Código do meio de pagamento conforme a tabela oficial do Banco Central do Brasil (por exemplo: “01” para Dinheiro, “03” para Boleto bancário, “10” para Cartão de Crédito).
Comportamento: Campo de texto livre, preenchido com o código correspondente da tabela do Banco Central.
Impacto: Utilizado em documentos fiscais e eletrônicos que exigem essa informação, como a Nota Fiscal Eletrônica (NF-e) e os registros do SPED.
Utilização e Consulta de Registros da Forma de Cobrança
Listagem Principal
O usuário localiza as formas de cobrança já cadastradas na grade principal da rotina. Essa grade exibe as colunas: Código, Nome, Tipo da Forma de Cobrança e Qualificação SPED.
Recursos de Busca e Filtro
O campo de pesquisa da grade aceita dois tipos de entrada:
- Busca por número: Se o usuário digitar um número, o sistema busca a forma de cobrança com o código exato informado, ou formas cujo nome contenha o número digitado.
- Busca por texto: Se o usuário digitar um texto, o sistema busca formas de cobrança cujo nome contenha o texto digitado. Essa busca é parcial (não é preciso digitar o nome completo) e não diferencia letras maiúsculas de minúsculas.
Ordenação e Paginação
A grade permite ordenar os resultados por qualquer uma das colunas exibidas e também oferece paginação para navegar entre os registros quando há muitos cadastros.
Consulta Detalhada
Existe ainda uma consulta mais detalhada, acessada pela ação “Consultar”, que exibe também os campos Emite Boleto, Cobrança Bancária, Liberado Frente de Loja, Imprime Relatório Gerencial e Tipo Prazo/Vista. Essa consulta detalhada retorna todos os registros, sem aplicar filtro de texto.
Processo de Edição da Forma de Cobrança
Para editar uma forma de cobrança já existente, o usuário seleciona o registro desejado na grade e aciona a ação de edição. O sistema carrega o formulário já preenchido com os valores atuais do registro.
Restrições de Edição
O campo “Código” fica bloqueado durante a edição e não pode ser alterado, pelo mesmo motivo explicado na seção de campos: ele é a identificação única do registro. Todos os demais campos (Nome, Tipo da Forma de Cobrança, Tipo Prazo/Vista, Qualificação SPED, Emite Boleto, Cobrança Bancária, Liberado Frente de Loja, Imprime Relatório Gerencial, Tipo Forma SPED e Meio de Pagamento) podem ser editados livremente.
Gravação e Confirmação
Ao salvar a edição, o sistema grava as alterações imediatamente e exibe a mensagem de confirmação “Forma cobrança editado com sucesso.” Um registro de auditoria interno é gerado automaticamente para essa operação, mas esse histórico não fica visível para o usuário dentro da própria tela.
Validação do Tipo PB
Assim como no cadastro, se o usuário tentar alterar o tipo da forma para “PB” (PIX/Boleto Híbrido) sem que o Parâmetro 5096 esteja habilitado, o sistema bloqueia o salvamento e exibe uma mensagem de erro explicando o motivo. Veja detalhes na seção “Regras de Negócio e Restrições da Forma de Cobrança”.
ℹ Informação Importante
O histórico de edições fica registrado automaticamente em um log interno do sistema para fins de auditoria, mesmo que não seja exibido na tela.
Estrutura Técnica e Comportamento do Sistema da Forma de Cobrança
A rotina de Forma de Cobrança funciona como um cadastro base que é referenciado automaticamente por outras partes do sistema. Isso significa que o que é definido aqui influencia diretamente o comportamento de outros módulos, sem que o usuário precise configurar nada adicionalmente neles.
Contas a Receber
A forma de cobrança cadastrada aqui é a mesma que fica disponível para seleção ao emitir títulos de cobrança.
Frente de Loja
O sistema mostra ao operador de caixa apenas as formas de cobrança marcadas com “Liberado Frente de Loja = S”.
Geração de Boleto Bancário
O sistema considera para a geração de remessas bancárias apenas as formas marcadas com “Emite Boleto = S” e “Cobrança Bancária = S”.
Geração de Cobrança via PIX
Nas telas de geração de PIX, o sistema lista automaticamente apenas as formas cadastradas com tipo “PX” ou “PY”.
Cheque Recebido
Nas telas de registro de cheque recebido, o sistema lista automaticamente apenas as formas cadastradas com tipo “CH”, “CA” ou “CS”.
SPED e Obrigações Acessórias
Os campos “Qualificação SPED”, “Tipo Forma SPED” e “Meio de Pagamento” são utilizados pelo sistema na geração de arquivos do SPED Fiscal e Contábil, bem como em documentos eletrônicos como a NF-e.
Log de Auditoria
Toda inclusão, edição ou exclusão realizada nesta rotina é registrada automaticamente em um log interno do sistema, na categoria “FormaCobranca”. Esse registro serve para fins de rastreabilidade, mesmo que o usuário não visualize esse histórico diretamente na tela.
Regras de Negócio e Restrições da Forma de Cobrança
Regra 1: Tipo PIX/Boleto Híbrido exige parâmetro habilitado
O tipo “PB” (Pagamento Instantâneo PIX/Boleto) só pode ser utilizado ao incluir ou editar uma forma de cobrança quando o Parâmetro 5096 (“Liberado API PIX/BOLETO – Boleto Híbrido”) estiver configurado como “S” (Sim). Se o parâmetro não estiver habilitado, o sistema bloqueia a operação e exibe uma mensagem de erro.
Mensagens ao tentar incluir forma com tipo “PB” sem o parâmetro habilitado:
- “Não foi possível cadastrar a Forma de Cobrança.”
- “O Tipo da Forma de Cobrança PB – Pagamento Instantâneo(PIX)/Boleto, somente ficará disponível Quando o Parâmetro 5096 – Liberado API PIX/BOLETO (Boleto Hibrido) estiver com o conteúdo igual a ‘S’ – Sim.”
- “Verifique o conteúdo do Parâmetro 5096 – Liberado API PIX/BOLETO (Boleto Hibrido) e tente novamente.”
Mensagens ao tentar editar forma para o tipo “PB” sem o parâmetro habilitado:
- “Não foi possível editar a Forma de Cobrança.”
- “O Tipo da Forma de Cobrança PB – Pagamento Instantâneo(PIX)/Boleto, somente ficará disponível Quando o Parâmetro 5096 – Liberado API PIX/BOLETO (Boleto Hibrido) estiver com o conteúdo igual a ‘S’ – Sim.”
- “Verifique o conteúdo do Parâmetro 5096 – Liberado API PIX/BOLETO (Boleto Hibrido) e tente novamente.”
Resolução: Para resolver essa restrição, um usuário com permissão de configuração precisa acessar o Parâmetro 5096 e alterar seu conteúdo para “S” (Sim).
Regra 2: O Código não pode ser alterado após o cadastro
O campo “Código” identifica a forma de cobrança de maneira única dentro do sistema. Depois que o registro é salvo pela primeira vez, esse campo fica bloqueado para edição. Caso seja necessário corrigir o código de uma forma já cadastrada, a única alternativa é excluir o registro e cadastrá-lo novamente, já com o código correto.
Regra 3: Formas especializadas para cheque e PIX são filtradas automaticamente pelo sistema
Nas telas que pedem uma forma de cobrança para registro de cheque recebido, o sistema mostra apenas as formas cadastradas com tipo “CH”, “CA” ou “CS”. Nas telas que pedem uma forma de cobrança para geração de PIX, o sistema mostra apenas as formas cadastradas com tipo “PX” ou “PY”. O usuário não precisa fazer nenhum filtro manual: o sistema já aplica essa filtragem automaticamente, de acordo com o contexto em que a forma de cobrança está sendo utilizada.
Regra 4: A exportação retorna no máximo 1000 registros
Ao exportar a lista de formas de cobrança, o sistema recupera no máximo 1000 registros para gerar o arquivo. Empresas que tenham mais de 1000 formas de cobrança cadastradas podem ter registros que ficam de fora do arquivo exportado.
Regra 5: A exclusão é imediata e irreversível pela tela
Ao confirmar a exclusão de uma forma de cobrança, o sistema remove o registro permanentemente do banco de dados. Não existe uma opção de desfazer essa operação pela tela. Antes de excluir uma forma de cobrança, é importante verificar se ela não está sendo utilizada em outros módulos (como títulos, vendas ou configurações), pois, caso existam registros dependentes dela, o sistema pode retornar um erro e impedir a exclusão.
