Condição de Pagamento

Documentação Técnica Condição de Pagamento Rotina do módulo Financeiro que define as regras para dividir automaticamente o valor de documentos em parcelas financeiras, configurando quantidade de parcelas, prazos, vencimentos e desdobramentos condicionais. 01. VISÃO GERAL DA CONDIÇÃO DE PAGAMENTO Visão Geral da Condição de Pagamento A rotina “Condição de Pagamento” faz parte do módulo Financeiro do ERP, dentro do grupo de Cadastros. Ela define as regras que o sistema usa para dividir automaticamente o valor de um documento, como um pedido de venda, um pedido de compra ou uma nota fiscal, em uma ou mais parcelas financeiras (títulos a receber ou a pagar). Ao cadastrar uma condição de pagamento, o usuário define quantas parcelas serão geradas, o prazo médio entre elas, se o valor de cada parcela é igual ou proporcional, e como o sistema deve calcular a data de vencimento de cada parcela, incluindo regras especiais para vencimentos que caem em sábado, domingo ou feriado, e regras condicionais baseadas em faixas de dias (chamadas de “Vencimento Condicional”). Depois de cadastrada, essa condição passa a estar disponível para ser selecionada em pedidos de venda, pedidos de compra e outros documentos financeiros do sistema, evitando que o usuário precise calcular manualmente as parcelas de cada documento. Objetivo principal: Automatizar a divisão de valores em parcelas com regras de vencimento, evitando cálculos manuais em cada documento. 02. VÍDEO TUTORIAL DA CONDIÇÃO DE PAGAMENTO Vídeo Tutorial da Condição de Pagamento ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03. PRÉ-REQUISITOS E CONTEXTO DE ACESSO DA CONDIÇÃO DE PAGAMENTO Pré-requisitos e Contexto de Acesso da Condição de Pagamento Para acessar a listagem e a consulta da rotina “Condição de Pagamento”, o usuário precisa ter o perfil vinculado à permissão “ListViewDeCondicaoPagamento” no módulo Financeiro. Sem essa permissão, o item de menu da rotina não fica disponível. Permissões específicas por ação Incluir uma nova condição de pagamento: CondicaoPagamento/Novo Alterar uma condição existente: CondicaoPagamento/Editar Excluir uma condição existente: CondicaoPagamento/Excluir Exportar a listagem: CondicaoPagamento/Exportar Gerar parcelas automaticamente: CondicaoPagamento/GerarParcelasAutomaticos As demais operações de consulta (listar, pesquisar, simular parcelas, listar itens e desdobramentos) não exigem permissão própria: ficam liberadas para qualquer usuário que já tenha acesso à rotina. Não é necessário nenhum cadastro prévio em outra rotina para criar uma condição de pagamento. Ela é um cadastro auxiliar de base, usado depois por outras rotinas (pedidos de venda, pedidos de compra etc.), e não depende delas. 04. PROCESSO DE CRIAÇÃO: PASSO A PASSO DA CONDIÇÃO DE PAGAMENTO Processo de Criação: Passo a Passo da Condição de Pagamento Passo 1 Acessar a rotina O usuário acessa o menu Financeiro > Cadastros > Condição de Pagamento e aciona a opção de novo cadastro. Passo 2 Preencher dados principais O usuário informa o código, o nome, a quantidade de parcelas, o tipo de vencimento, a regra de arredondamento de valor, se as parcelas devem ser iguais, o prazo médio entre parcelas e a classificação (compra, venda ou ambos). O detalhamento de cada um desses campos está na Seção 5. Passo 3 Definir distribuição de parcelas Havendo mais de uma parcela, o usuário informa, para cada parcela, o percentual (ou valor fixo) e o prazo em dias, ou aciona o recurso de geração automática de parcelas, que calcula e grava essa distribuição sozinho a partir da quantidade de parcelas e do prazo médio informados (ver Seção 8). O sistema não permite salvar a condição com a soma dos percentuais das parcelas incompleta ou incoerente com a regra de arredondamento escolhida. Passo 4 Configurar desdobramento (se VC) Se o tipo de vencimento escolhido for “Vencimento Condicional” (VC), o usuário precisa, para cada parcela, cadastrar ao menos uma faixa de desdobramento, informando se a faixa é por dia do mês ou por dia da semana, os limites inicial e final da faixa, e para qual dia a parcela deve ser deslocada quando a data cair dentro dessa faixa. Passo 5 Salvar Ao confirmar o cadastro, o sistema grava a condição de pagamento e retorna a mensagem “Condição de pagamento inserida com sucesso.”. A condição criada já passa a ficar disponível para seleção em outras rotinas do sistema. 05. DESCRIÇÃO DE CADA CAMPO DA TELA DA CONDIÇÃO DE PAGAMENTO Descrição de Cada Campo da Tela da Condição de Pagamento Código da Condição de Pagamento Tipo: Texto Obrigatoriedade: Obrigatório Descrição: Identificador único da condição de pagamento no sistema. Comportamento: Usado como chave do cadastro; é o valor exibido e selecionado por outras rotinas ao referenciar esta condição. Impacto: Aparece em pedidos de venda, pedidos de compra e demais documentos que referenciam a condição de pagamento. Nome Tipo: Texto Obrigatoriedade: Obrigatório Descrição: Nome/descrição da condição de pagamento, exibido nas listas de seleção do sistema (por exemplo, “30/60/90 DIAS”). Comportamento: Usado nos filtros de busca da listagem (a busca funciona tanto pelo código quanto pelo nome). Impacto: Aparece em telas de seleção de condição de pagamento em outras rotinas e em relatórios. Quantidade de Parcelas Tipo: Número Obrigatoriedade: Obrigatório Descrição: Quantidade de parcelas em que o valor do documento será dividido ao aplicar esta condição de pagamento. Comportamento: Usado como base para o recurso de geração automática de parcelas (Seção 8) e para validar se a distribuição de percentuais entre as parcelas está completa. Impacto: Determina quantos títulos financeiros são gerados quando a condição é aplicada a um documento. Tipo de Condição de Pagamento Tipo: Seleção Obrigatoriedade: Obrigatório Descrição: Define a regra usada para calcular a data de vencimento de cada parcela, por exemplo, dia fixo dentro do mês, dia fixo fora do mês (mês seguinte) ou vencimento condicional por faixa de dias. Comportamento: Quando o tipo selecionado é “Vencimento Condicional” (VC), o sistema passa a exigir o cadastro de desdobramentos por faixa de vencimento para cada parcela (ver Passo 4 da Seção 4 e Seção 9, Regras 5 a 7). Para os tipos “dia fixo fora do mês” e “dia fixo dentro do mês”, o prazo informado é aplicado igualmente a todas as parcelas; para os demais tipos, o prazo é somado a cada parcela (por

Forma de Cobrança

Documentação Técnica Forma de Cobrança Cadastro centralizado de modalidades de recebimento aceitas pela empresa no módulo Financeiro do ERP. 01. VISÃO GERAL DA FORMA DE COBRANÇA 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. 02. VÍDEO TUTORIAL DA FORMA DE COBRANÇA Vídeo Tutorial da Forma de Cobrança ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03. PRÉ-REQUISITOS E CONTEXTO DE ACESSO DA FORMA DE COBRANÇA 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”. 04. PROCESSO DE CRIAÇÃO: PASSO A PASSO DA FORMA DE COBRANÇA Processo de Criação: Passo a Passo da Forma de Cobrança Passo 1 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. Passo 2 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. Passo 3 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. Passo 4 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”. Passo 5 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. Passo 6 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”. Passo 7 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.” 05. DESCRIÇÃO DE CADA CAMPO DA TELA DA FORMA DE COBRANÇA Descrição de Cada Campo da Tela da Forma de Cobrança Código Tipo: número inteiro Obrigatório 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 Tipo: texto Obrigatório 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 Tipo: seleção (texto) Obrigatório 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

Forma de Pagamento

📋 Documentação Técnica Forma de Pagamento Mantém o cadastro das modalidades que a empresa utiliza para efetuar pagamentos, como dinheiro, cheque, cartão de crédito, boleto, PIX e outras opções. 01. VISÃO GERAL DA FORMA DE PAGAMENTO Visão Geral da Forma de Pagamento A rotina “Forma de Pagamento” faz parte do módulo Financeiro do ERP, dentro do grupo de Cadastros. Ela mantém o cadastro das modalidades que a empresa utiliza para efetuar pagamentos, como dinheiro, cheque, cartão de crédito, cartão de débito, boleto, PIX, vale alimentação, entre muitas outras opções. Esse cadastro é o correspondente da “Forma de Cobrança”, mas voltado para o lado dos pagamentos feitos pela empresa (a fornecedores e despesas em geral), e não para os recebimentos. As formas de pagamento cadastradas aqui ficam disponíveis para seleção em outras telas do sistema onde é preciso indicar como um pagamento será realizado. 02. VÍDEO TUTORIAL DA FORMA DE PAGAMENTO Vídeo Tutorial da Forma de Pagamento ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03. PRÉ-REQUISITOS E CONTEXTO DE ACESSO DA FORMA DE PAGAMENTO Pré-requisitos e Contexto de Acesso da Forma de Pagamento Para acessar a listagem da rotina, o usuário precisa ter a permissão “ListViewDeFormaPagamento” associada ao seu perfil de acesso no sistema. Além disso, cada ação de manutenção dentro da rotina exige uma permissão própria: Incluir Permissão: FormaPagamento/Novo Editar Permissão: FormaPagamento/Editar Excluir Permissão: FormaPagamento/Excluir ⚠ Observação: Existe uma permissão chamada “FormaPagamento/Exportar” cadastrada no sistema, mas não foi encontrada nenhuma funcionalidade de exportação correspondente nesta tela. É possível que essa permissão esteja reservada para uma funcionalidade ainda não disponibilizada. [informação não disponível na documentação de origem, validar com analista responsável] Dependências: Não há dependência de nenhuma outra rotina ou cadastro prévio para que o usuário consiga criar uma forma de pagamento. 04. PROCESSO DE CRIAÇÃO: PASSO A PASSO DA FORMA DE PAGAMENTO Processo de Criação: Passo a Passo da Forma de Pagamento Passo 1 Acessar a rotina O usuário acessa o caminho Financeiro > Cadastros > Forma de Pagamento e aciona a opção de novo cadastro. Passo 2 Preencher código e nome O usuário informa o código e o nome (com até 50 caracteres) da forma de pagamento que está cadastrando. Os dois campos são obrigatórios. Passo 3 Selecionar tipo O usuário seleciona o tipo que melhor representa essa forma de pagamento (por exemplo: dinheiro, cheque, cartão, PIX). A lista completa está na Seção 5. Passo 4 Qualificação e meio (opcional) O usuário pode informar a qualificação SPED e uma descrição complementar do meio de pagamento. Esses campos são opcionais. Passo 5 Salvar O usuário confirma o cadastro e o sistema grava a nova forma de pagamento, deixando-a disponível para uso em outras telas do sistema. 05. DESCRIÇÃO DE CADA CAMPO DA TELA DA FORMA DE PAGAMENTO Descrição de Cada Campo da Tela da Forma de Pagamento Código Tipo: Número Obrigatoriedade: Obrigatório Descrição: Número que identifica de forma única essa forma de pagamento dentro do sistema. Comportamento: Funciona como a chave desse cadastro, ou seja, é o número usado para localizar e referenciar essa forma de pagamento específica. Impacto: Esse código é usado por outras rotinas do sistema que trabalham com formas de pagamento, como as telas de pagamento a fornecedores e de despesas. Nome Tipo: Texto Obrigatoriedade: Obrigatório Descrição: Nome descritivo da forma de pagamento, com até 50 caracteres, usado para identificá-la facilmente nas telas do sistema. Comportamento: Esse campo é considerado na busca por texto disponível na listagem da rotina, ou seja, o usuário consegue localizar um registro digitando parte do nome. Impacto: Esse nome aparece nas telas de seleção de forma de pagamento em outras rotinas do sistema, sempre que o usuário precisar escolher uma forma de pagamento. Tipo da Forma de Pagamento Tipo: Seleção Obrigatoriedade: Opcional Descrição: Classifica a natureza dessa forma de pagamento. As opções disponíveis são: Dinheiro, Cheque, Cheque com consulta, Cartão de crédito, Cartão de débito, Tickets, Boleto bancário, Vale funcionário, Cartão próprio, Outros, Crédito em Conta Corrente, Cheque Administrativo, Crédito em Conta Poupança, Ordem de Pagamento, Liquidação de Títulos, TED CIP Outra Titularidade, TED CIP Mesma Titularidade, DOC, TED CIP (Transf. via Câmara de Pagamentos), TED STR (Transf. via Bacen), Pagamento Instantâneo (PIX), Programa de fidelidade/cashback/crédito virtual, Crédito Loja, Vale Alimentação, Vale Refeição, Vale Presente, Vale Combustível, Sem Pagamento, POS Cartão de Crédito, POS Cartão de Débito, e Pagamento Instantâneo (PIX) – Dinâmico. Comportamento: Se, por algum motivo externo à tela (como uma integração), for informado um valor de tipo que o sistema não reconheça, o sistema grava o campo em branco em vez de impedir o cadastro, e não exibe nenhum aviso ao usuário sobre isso. Impacto: Esse campo é usado para filtrar quais formas de pagamento aparecem disponíveis em telas que só devem oferecer um tipo específico (por exemplo, uma tela que só deve mostrar formas de pagamento do tipo PIX). Qualificação SPED Tipo: Seleção Obrigatoriedade: Opcional Descrição: Código que classifica essa forma de pagamento para fins de geração do SPED (obrigação fiscal acessória), com até 2 caracteres. Comportamento: Se for informado um valor que o sistema não reconheça como válido, o campo é gravado em branco em vez de impedir o cadastro. Impacto: Esse código é utilizado internamente pelo sistema no momento de gerar as obrigações fiscais acessórias relacionadas ao SPED. Meio de Pagamento Tipo: Texto Obrigatoriedade: Opcional Descrição: Campo de texto livre para complementar a descrição ou o código do meio de pagamento, com até 60 caracteres. Comportamento: Aceita qualquer texto digitado pelo usuário, sem validação de formato específico. Impacto: [informação não disponível na documentação de origem, validar com analista responsável] não foi possível confirmar em quais outras telas ou relatórios esse campo é exibido além do próprio cadastro. 06. UTILIZAÇÃO E CONSULTA DE REGISTROS DA FORMA DE PAGAMENTO Utilização e Consulta de Registros da Forma de Pagamento O usuário localiza formas de pagamento já cadastradas na grade principal da rotina, digitando parte do código ou do nome no campo de busca disponível na tela. Essa grade é paginada (os registros aparecem divididos em

Cadastro

Adiantamento de Cliente

Documentação Técnica AdiantamentoCliente Rotina do módulo Financeiro responsável por registrar o “Adiantamento de cliente” — um lançamento de contas a receber que antecipa valores recebidos de um participante (cliente) antes da geração/vinculação de um título formal, gerando automaticamente os lançamentos financeiros e contábeis correspondentes. 01. VISÃO GERAL Visão Geral Rotina do módulo Financeiro responsável por registrar o “Adiantamento de cliente” — um lançamento de contas a receber que antecipa valores recebidos de um participante (cliente) antes da geração/vinculação de um título formal, gerando automaticamente os lançamentos financeiros e contábeis correspondentes. É uma tela filha do grupo de menu “Transferências” (recurso pai 1554). 02. ENDPOINTS Endpoints [POST] /AdiantamentoCliente/Salvar Registra um novo adiantamento de cliente a partir dos dados informados na tela. Internamente, delega para o serviço de inclusão de título (IServicoDeInclusaoDeTitulo), sempre com o módulo fixado em “Contas a Receber” (ListaAtualizarModulo.tcReceber) e sempre com o indicador “é adiantamento de cliente” fixado em verdadeiro — ou seja, este endpoint nunca gera adiantamento de fornecedor (Contas a Pagar); esse é um fluxo tratado por outra rotina. Permissão: “AdiantamentoCliente/Salvar” (ID 3007) Parâmetros: Nome Tipo Obrigatório Descrição dto DTOCabecalhoDeOperacoes (corpo da requisição) Sim Cabeçalho da operação, contendo a filial, a lista de títulos a processar (apenas o primeiro item da lista é considerado), os cheques de terceiros informados, a forma de cobrança, a data de lançamento, o documento e a observação Exemplo de request: “` POST /AdiantamentoCliente/Salvar { “IDDaFilial”: “01”, “IDDaFormaDeCobranca”: 12, “DataDeLancamento”: “2026-09-08”, “Documento”: “12345”, “Observacao”: “Adiantamento recebido em espécie”, “TitulosAProcessar”: [ { “IDDaCarteira”: 3, “IDDoParticipante”: 456, “Valor”: 1500.00, “ValorMoeda”: 1500.00, “IDDaMoeda”: 1 } ], “ChequesDeTerceiros”: [] } “` Exemplo de response (sucesso): “`json { “success”: true, “listaDeCheques”: [], “listaDeOperacoesFinanceiras”: [], “listaDeOperacoesContabeis”: [] } “` Se dto.TitulosAProcessar vier vazio ou nulo, a ação não chama o serviço de negócio e apresenta a mensagem “Não foi possível Salvar. Alguns dados podem estar incorretos. Verifique se os dados informados estão corretos.” (ver Regras de Negócio). [POST] /AdiantamentoCliente/Imprimir Prepara o arquivo-modelo do comprovante de adiantamento (Crystal Reports) para impressão. Não executa nenhuma regra de negócio nem grava dados de adiantamento — apenas garante que a pasta de destino exista e copia o arquivo-modelo “ComprovanteCaixaAdiantamento.rpt” da pasta padrão para a pasta específica do cliente, caso ainda não exista lá. Permissão: “AdiantamentoCliente/Imprimir” (ID 3008) Parâmetros: nenhum Exemplo de request: “` POST /AdiantamentoCliente/Imprimir “` Exemplo de response: “`json { “success”: true } “` 03. MODELOS DE DADOS Modelos de Dados DTOCabecalhoDeOperacoes (cabeçalho enviado pela tela) Campo Tipo Descrição IDDaFilial string Filial informada na tela (é sobrescrita internamente pela filial logada do usuário — ver Regras de Negócio) DataDeLancamento DateTime Data de lançamento da operação Documento string Número/identificação do documento informado Observacao string Observação livre digitada pelo usuário IDDaFormaDeCobranca int Forma de cobrança selecionada (obrigatória para o fluxo de contas a receber) TitulosAProcessar List[DTODeTituloAProcessar] Lista de títulos a processar — apenas o primeiro item é efetivamente utilizado pelo fluxo de adiantamento de cliente ChequesDeTerceiros List[DTODeChequesDeTerceiros] Cheques de terceiros usados para pagar o adiantamento (opcional — determina qual dos dois sub-fluxos internos é executado, ver Regras de Negócio) DTODeTituloAProcessar (campos relevantes ao fluxo de adiantamento de cliente) Campo Tipo Descrição IDDaFilial string Filial do título (sobrescrita pela filial logada) IDDaCarteira int Carteira (conta bancária/caixa) usada na operação — obrigatória junto com a filial IDDoParticipante int Participante (cliente) do adiantamento Valor decimal Valor do adiantamento (moeda corrente) — usado quando não há cheques de terceiros ValorMoeda decimal Valor do adiantamento na moeda informada — usado quando não há cheques de terceiros IDDaMoeda int Moeda da operação (0 assume a moeda padrão do sistema) SerieDoDocumento string Série do documento — gerada automaticamente pela sequência de numeração da filial/tipo de documento NumeroDoDocumento int Número do documento — gerado automaticamente NumeroDaParcela int Sempre forçado para 1 neste fluxo QuantidadeDeParcelas int Sempre forçado para 1 neste fluxo DataDeVencimento / DataDeVencimentoUtil DateTime Sempre forçadas para a data atual (adiantamento não tem vencimento futuro) IDDoTipoDeDocumento string Se não informado, assume um tipo de documento padrão de configuração NaturezaDoTitulo, NumeroDoTituloAuxiliar, CodigoDeBarras, NossoNumero string Sempre zerados/forçados para vazio neste fluxo ValorDaCotacao decimal Sempre forçado para 0 IDDoVendedor int? Sempre forçado para nulo Os demais campos de DTODeTituloAProcessar pertencem a outros fluxos (boleto, remessa bancária, negativação Serasa, tributos, PIX etc.) e não são utilizados pela rotina de Adiantamento de cliente. 04. REGRAS DE NEGÓCIO Regras de Negócio Regra 1 — Filial e carteira são obrigatórias. Se a filial ou a carteira não forem informadas, a operação é bloqueada. Mensagem exibida: “Não foi possível incluir Adiantamento, Para gerar um título de adiantamento é obrigatório informar filial e carteira” Regra 2 — Carteira deve pertencer à mesma filial do título. A carteira informada precisa pertencer à mesma filial informada para o título, a menos que a carteira seja do tipo Caixa (nesse caso a validação é dispensada). Mensagem exibida: “Não foi possível incluir Adiantamento, A carteira informada pertence a uma filial diferente da que foi informada para o título” Regra 3 — A filial informada na tela é substituída pela filial logada do usuário. Independentemente do que for digitado no campo de filial, o sistema sempre grava a filial do usuário logado no momento da operação. Regra 4 — Forma de cobrança é obrigatória. Como este fluxo sempre opera em Contas a Receber, é obrigatório informar uma forma de cobrança; caso contrário a operação é bloqueada. Mensagem exibida: “Não foi possível incluir Adiantamento” — “Para gerar um título de adiantamento é obrigatório informar uma forma de cobrança.” — “Código informado: [ID da forma de cobrança informada]. Favor informe uma forma de cobrança para operação” Regra 5 — Toda a operação ocorre dentro de uma transação única. O sistema abre uma transação (BeginTran) antes de processar o adiantamento e só confirma (Commit/FinalizeTran) ao final — se qualquer etapa falhar, nada é persistido. Regra 6 — Existem dois sub-fluxos de persistência, conforme o adiantamento é pago com cheque de terceiro ou não. Com cheque(s) de terceiro(s) informado(s): para cada cheque, o sistema gera a numeração do documento e, por este ser um adiantamento de cliente,

Transferencias

Moeda

Documentação Técnica Moeda Cadastro e gerenciamento de moedas com histórico de cotações. Essencial para conversão automática de valores em transações que envolvem moedas estrangeiras. 01. VISÃO GERAL DA MOEDA Visão Geral da Moeda A rotina Moeda faz parte do módulo Financeiro do ERP, dentro do grupo Cadastros. Ela é o lugar onde o sistema guarda as moedas que a empresa utiliza (por exemplo, Dólar Americano, Euro, Real) e o histórico de cotações de cada uma dessas moedas ao longo do tempo. Essas informações não servem apenas para consulta: elas são usadas automaticamente por outras rotinas do ERP sempre que é preciso converter um valor lançado em moeda estrangeira para a moeda padrão da empresa, ou o caminho inverso. Isso acontece, por exemplo, em documentos financeiros e operações que envolvem valores em dólar, euro ou qualquer outra moeda diferente da moeda padrão utilizada pela empresa. Em resumo: cadastrar corretamente as moedas e manter as cotações atualizadas nesta rotina garante que os valores convertidos automaticamente em outras partes do sistema estejam corretos. Observação Importante As informações de moedas e cotações são fundamentais para o funcionamento correto de outras rotinas do sistema que dependem de conversão de valores automática. 02. VÍDEO TUTORIAL DA MOEDA Vídeo Tutorial da Moeda ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03. PRÉ-REQUISITOS E CONTEXTO DE ACESSO DA MOEDA Pré-requisitos e Contexto de Acesso da Moeda Para visualizar a listagem e consultar as moedas cadastradas, o usuário precisa ter a permissão “ListViewDeMoeda” associada ao seu perfil de acesso no sistema. Permissões de Manutenção Além dessa permissão de visualização, cada ação de manutenção sobre o cadastro de moedas exige uma permissão própria: Para incluir uma nova moeda: “Moeda/Novo” Para editar uma moeda já existente: “Moeda/Editar” Para excluir uma moeda: “Moeda/Excluir” Para exportar a listagem de moedas: “Moeda/Exportar” Para importar moedas: “Moeda/Importar” Dependências Anteriores Não existe nenhuma rotina ou cadastro anterior que precise ser feito antes de criar uma moeda: o cadastro de moeda pode ser o primeiro passo. Porém, para que as cotações lançadas aqui sejam efetivamente usadas em outras rotinas do sistema (como conversões de valores), é necessário que a moeda já esteja cadastrada previamente. 04. PROCESSO DE CRIAÇÃO: PASSO A PASSO DA MOEDA Processo de Criação: Passo a Passo da Moeda Passo 1 Acessar a rotina O usuário acessa o caminho Financeiro > Cadastros > Moeda e aciona a opção de novo cadastro. Como alternativa a preencher tudo manualmente, também é possível trazer moedas já prontas de um catálogo interno do próprio sistema, usando o recurso de importação (os detalhes desse recurso estão descritos na Seção 8, “Estrutura Técnica e Comportamento do Sistema da Moeda”). Passo 2 Preencher os dados principais O usuário informa o código, o nome e o símbolo da moeda, além de selecionar a classificação do tipo de moeda. A explicação detalhada de cada um desses campos está na Seção 5, “Descrição de Cada Campo da Tela da Moeda”. Passo 3 Informar cotações (etapa opcional) Ainda durante a criação, o usuário pode incluir uma ou mais cotações da moeda, cada uma com sua respectiva data e o valor correspondente naquela data. Essa etapa não é obrigatória no momento da criação: as cotações também podem ser incluídas depois, quando o usuário editar a moeda já cadastrada. Passo 4 Salvar Ao confirmar o cadastro, o sistema grava a moeda e, se houver, também grava as cotações que foram informadas. Em seguida, o sistema exibe a mensagem de confirmação “Moeda inserida com sucesso.” 05. DESCRIÇÃO DE CADA CAMPO DA TELA DA MOEDA Descrição de Cada Campo da Tela da Moeda Código Tipo: Número Obrigatoriedade: OBRIGATÓRIO Descrição: É o número que identifica de forma única cada moeda dentro do sistema. É por meio desse código que o sistema reconhece qual moeda está sendo referenciada em outras telas e rotinas. Comportamento: Funciona como a chave do cadastro, ou seja, é o valor principal usado para localizar e referenciar essa moeda a partir de outras partes do sistema. Por ser a chave do cadastro, não pode ser alterado depois que a moeda é criada (ver Seção 7, “Processo de Edição da Moeda”). Impacto: Esse código aparece internamente em documentos e lançamentos financeiros que utilizam a moeda cadastrada, servindo de referência para o sistema localizar as informações corretas dessa moeda. Nome Tipo: Texto Obrigatoriedade: OBRIGATÓRIO Descrição: É o nome da moeda propriamente dito, como por exemplo “DÓLAR AMERICANO” ou “EURO”. Comportamento: Esse campo é usado pelo sistema quando o usuário faz uma busca na grade principal de moedas: ao digitar um texto no campo de busca, o sistema retorna as moedas cujo nome contém o texto digitado. O nome também é o que aparece nas telas de outras rotinas do sistema em que o usuário precisa escolher uma moeda. Impacto: Esse nome é exibido em todas as listas de seleção de moeda espalhadas pelo sistema, ajudando o usuário a identificar visualmente qual moeda está escolhendo. Símbolo Tipo: Texto Obrigatoriedade: OBRIGATÓRIO Descrição: É a sigla ou símbolo que representa a moeda, como “USD” para dólar americano ou “EUR” para euro. Comportamento: O sistema exibe esse símbolo junto ao valor da cotação em algumas telas, ajudando a identificar rapidamente a que moeda aquele valor se refere. Impacto: Aparece em conjunto com valores convertidos em outras partes do sistema, facilitando a identificação de qual foi a moeda de origem daquele valor. Tipo de Moeda Tipo: Seleção Obrigatoriedade: OBRIGATÓRIO Descrição: Campo usado para classificar a moeda de acordo com um tipo pré-definido pelo sistema. ⚠ Informação incompleta: Comportamento e Impacto não disponíveis na documentação de origem. Validar com analista responsável quanto às opções disponíveis nesse campo e ao efeito prático no comportamento do sistema. Data da Cotação Tipo: Data Obrigatoriedade: OBRIGATÓRIO (em item de cotação) (item da grade de cotações) Descrição: É a data em que o valor de cotação informado junto a ela é considerado válido. Cada moeda pode ter várias cotações cadastradas, uma para cada data. Comportamento: Se o usuário salvar uma edição da moeda com uma cotação cuja data

Forma de Pagamento

📋 Documentação Técnica Forma de Pagamento Cadastro de modalidades de pagamento do módulo Financeiro; ponto de partida para outras operações do sistema que envolvem pagamentos feitos pela empresa. 01. VISÃO GERAL DA FORMA DE PAGAMENTO Visão Geral da Forma de Pagamento A rotina “Forma de Pagamento” faz parte do módulo Financeiro do ERP, dentro do grupo “Cadastros”. Ela é usada para manter o cadastro das modalidades que a empresa utiliza para efetuar pagamentos, como dinheiro, cheque, cartão de crédito, cartão de débito, boleto, PIX, vale alimentação, entre muitas outras opções. Esse cadastro é o ponto de partida para diversas outras telas do sistema que envolvem pagamentos feitos pela empresa, como pagamentos a fornecedores e o registro de despesas em geral. Sempre que o usuário precisa informar “como” um pagamento foi ou será feito, é neste cadastro que as opções disponíveis são configuradas. ⚠ Diferença importante: Forma de Pagamento vs. Forma de Cobrança É importante não confundir esta rotina com a “Forma de Cobrança”. Embora as duas tenham estrutura parecida, a “Forma de Pagamento” trata dos valores que saem da empresa (pagamentos a terceiros), enquanto a “Forma de Cobrança” trata dos valores que entram na empresa (recebimentos de clientes). 02. VÍDEO TUTORIAL DA FORMA DE PAGAMENTO Vídeo Tutorial da Forma de Pagamento ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03. PRÉ-REQUISITOS E CONTEXTO DE ACESSO DA FORMA DE PAGAMENTO Pré-requisitos e Contexto de Acesso da Forma de Pagamento Permissão de visualização: Para visualizar a listagem de formas de pagamento, o usuário precisa ter a permissão “ListViewDeFormaPagamento” associada ao seu perfil de acesso no sistema. Sem essa permissão, a tela não fica disponível para o usuário. Permissões de ação: Além da permissão de visualização, cada ação de manutenção do cadastro exige uma permissão própria, concedida separadamente pelo administrador do sistema: Para incluir uma nova forma de pagamento, o usuário precisa da permissão FormaPagamento/Novo. Para editar uma forma de pagamento já existente, o usuário precisa da permissão FormaPagamento/Editar. Para excluir uma forma de pagamento existente, o usuário precisa da permissão FormaPagamento/Excluir. Permissão de exportação: Existe ainda uma permissão chamada “FormaPagamento/Exportar” registrada no sistema. No entanto, não foi identificada, na análise realizada, nenhuma funcionalidade de exportação correspondente disponível nesta tela, o que é diferente do padrão observado em outras rotinas do módulo Financeiro. É possível que essa permissão esteja reservada para uma funcionalidade de exportação ainda não disponibilizada na tela ao usuário. ✓ Sem dependências prévias Não há dependência de outra rotina ou de nenhum cadastro prévio para que o usuário consiga criar uma nova forma de pagamento. Ou seja, a rotina pode ser utilizada de forma independente, desde que o usuário tenha as permissões necessárias. 04. PROCESSO DE CRIAÇÃO: PASSO A PASSO DA FORMA DE PAGAMENTO Processo de Criação: Passo a Passo da Forma de Pagamento PASSO 1 Acessar a rotina O usuário acessa o caminho Financeiro > Cadastros > Forma de Pagamento e aciona a opção de novo cadastro para abrir a tela de inclusão de uma nova forma de pagamento. PASSO 2 Preencher o código e o nome O usuário informa o código e o nome da forma de pagamento, sendo que o nome pode ter até 50 caracteres. Esses dois campos são de preenchimento obrigatório: sem eles, o sistema não permite salvar o cadastro. PASSO 3 Selecionar o tipo da forma de pagamento O usuário seleciona, em uma lista de opções, o tipo que melhor representa a forma de pagamento que está sendo cadastrada (por exemplo: dinheiro, cheque, cartão de crédito, PIX, entre outras). A lista completa de opções disponíveis está detalhada na Seção 5 deste documento, no campo “Tipo da Forma de Pagamento”. PASSO 4 Preencher a qualificação SPED e o meio de pagamento (opcional) O usuário pode, se desejar, informar a qualificação usada na geração do SPED (obrigação fiscal acessória) e uma descrição complementar do meio de pagamento. Esses dois campos não são obrigatórios para salvar o cadastro. PASSO 5 Salvar Ao confirmar o cadastro, o sistema grava a forma de pagamento com as informações preenchidas e ela passa a ficar disponível para uso em outras telas do sistema que envolvem pagamentos. 05. DESCRIÇÃO DE CADA CAMPO DA TELA DA FORMA DE PAGAMENTO Descrição de Cada Campo da Tela da Forma de Pagamento Código Tipo: número Obrigatoriedade: obrigatório Descrição: número que identifica de forma única a forma de pagamento dentro do sistema. É por meio desse número que o cadastro é localizado e referenciado internamente. Comportamento: funciona como a chave principal do cadastro, ou seja, cada forma de pagamento precisa ter um código próprio e diferente das demais. Impacto: esse código é referenciado por outras rotinas do sistema que utilizam formas de pagamento, como as telas de pagamento a fornecedores e de registro de despesas. Nome Tipo: texto Obrigatoriedade: obrigatório Descrição: nome descritivo que identifica a forma de pagamento para o usuário, com até 50 caracteres (por exemplo, “Cartão de Crédito Loja” ou “PIX Instantâneo”). Comportamento: esse campo é usado nos filtros de busca da listagem da rotina, permitindo localizar o cadastro tanto pelo código quanto pelo nome. Impacto: o nome cadastrado aqui é o texto exibido para o usuário nas telas de seleção de forma de pagamento em outras partes do sistema. Tipo da Forma de Pagamento Tipo: seleção Obrigatoriedade: opcional Descrição: campo usado para classificar a natureza do pagamento, entre as seguintes opções disponíveis: Dinheiro, Cheque, Cheque com consulta, Cartão de crédito, Cartão de débito, Tickets, Boleto bancário, Vale funcionário, Cartão próprio, Outros, Crédito em Conta Corrente, Cheque Administrativo, Crédito em Conta Poupança, Ordem de Pagamento, Liquidação de Títulos, TED CIP Outra Titularidade, TED CIP Mesma Titularidade, DOC, TED CIP (Transferência via Câmara de Pagamentos), TED STR (Transferência via Bacen), Pagamento Instantâneo (PIX), Programa de fidelidade/cashback/crédito virtual, Crédito Loja, Vale Alimentação, Vale Refeição, Vale Presente, Vale Combustível, Sem Pagamento, POS Cartão de Crédito, POS Cartão de Débito e Pagamento Instantâneo (PIX) – Dinâmico. Comportamento: caso um valor de tipo inválido seja informado no cadastro (por exemplo, através de alguma integração externa ao

Condição de Pagamento

Documentação Técnica Condição de Pagamento Rotina do módulo Financeiro que define as regras para divisão automática de valores em parcelas financeiras. 01. VISÃO GERAL DA CONDIÇÃO DE PAGAMENTO Visão Geral da Condição de Pagamento A rotina “Condição de Pagamento” faz parte do módulo Financeiro do ERP, dentro do grupo “Cadastros”. Ela define as regras que o sistema usa para dividir automaticamente o valor de um documento, como um pedido de venda, um pedido de compra ou uma nota fiscal, em uma ou mais parcelas financeiras (títulos a receber ou a pagar). Ao cadastrar uma condição de pagamento, o usuário define quantas parcelas serão geradas, o prazo médio entre elas, se o valor de cada parcela é igual ou proporcional, e como o sistema deve calcular a data de vencimento de cada parcela, incluindo regras especiais para vencimentos que caem em sábado, domingo ou feriado, e regras condicionais baseadas em faixas de dias (chamadas de “Vencimento Condicional”). Uma vez cadastrada, essa condição passa a estar disponível para ser selecionada em pedidos de venda, pedidos de compra e outros documentos financeiros do sistema, evitando que o usuário precise calcular manualmente as parcelas de cada documento. 02. VÍDEO TUTORIAL DA CONDIÇÃO DE PAGAMENTO Vídeo Tutorial da Condição de Pagamento ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03. PRÉ-REQUISITOS E CONTEXTO DE ACESSO DA CONDIÇÃO DE PAGAMENTO Pré-requisitos e Contexto de Acesso da Condição de Pagamento Acesso Básico Para acessar a listagem e a consulta da rotina “Condição de Pagamento”, o usuário precisa ter, no seu perfil de acesso, a permissão “ListViewDeCondicaoPagamento” no módulo Financeiro. Sem essa permissão, o item de menu da rotina nem aparece disponível para o usuário. Permissões de Manutenção Além do acesso básico à rotina, cada ação de manutenção exige uma permissão própria e independente das demais: Incluir uma nova condição de pagamento exige a permissão “CondicaoPagamento/Novo”. Alterar uma condição existente exige a permissão “CondicaoPagamento/Editar”. Excluir uma condição existente exige a permissão “CondicaoPagamento/Excluir”. Exportar a listagem exige a permissão “CondicaoPagamento/Exportar”. Gerar parcelas automaticamente (recurso de apoio ao cadastro, explicado na Seção 8) exige a permissão “CondicaoPagamento/GerarParcelasAutomaticos”. As demais operações de consulta (listar, pesquisar, simular parcelas, listar itens e desdobramentos) não exigem nenhuma permissão adicional: ficam liberadas para qualquer usuário que já tenha acesso básico à rotina. Dependências Prévias Não é necessário nenhum cadastro prévio em outra rotina para criar uma condição de pagamento. Ela é um cadastro auxiliar de base, usado depois por outras rotinas (pedidos de venda, pedidos de compra etc.), e não depende delas para existir. 04. PROCESSO DE CRIAÇÃO: PASSO A PASSO DA CONDIÇÃO DE PAGAMENTO Processo de Criação: Passo a Passo da Condição de Pagamento 1 Acessar a rotina O usuário acessa o menu Financeiro > Cadastros > Condição de Pagamento e aciona a opção de novo cadastro. 2 Preencher os dados principais O usuário informa o código, o nome, a quantidade de parcelas, o tipo de vencimento, a regra de arredondamento de valor, se as parcelas devem ser iguais, o prazo médio entre parcelas e a classificação da condição (Compra, Venda ou Ambos). O detalhamento de cada um desses campos está descrito na Seção 5. 3 Definir a distribuição das parcelas Havendo mais de uma parcela, o usuário informa, para cada parcela, o percentual (ou o valor fixo) e o prazo em dias, ou então aciona o recurso de geração automática de parcelas, que calcula e grava essa distribuição sozinho, a partir da quantidade de parcelas e do prazo médio já informados (ver Seção 8). O sistema não permite salvar a condição se a soma dos percentuais das parcelas estiver incompleta ou incoerente com a regra de arredondamento escolhida (ver Seção 9, Regras 2 a 4). 4 Configurar desdobramento por vencimento Se o tipo de vencimento escolhido para a condição for “Vencimento Condicional” (VC), o usuário precisa, para cada parcela, cadastrar ao menos uma faixa de desdobramento. Nessa faixa, ele informa se a contagem é por dia do mês ou por dia da semana, os limites inicial e final da faixa, e para qual dia a parcela deve ser deslocada quando a data cair dentro dessa faixa. O sistema não permite salvar a condição sem esse detalhamento quando o tipo escolhido é “Vencimento Condicional” (ver Seção 9, Regras 5 a 7). 5 Salvar Ao confirmar o cadastro, o sistema grava a condição de pagamento e exibe a mensagem “Condição de pagamento inserida com sucesso.”. A partir desse momento, a condição criada já fica disponível para ser selecionada em outras rotinas do sistema. 05. DESCRIÇÃO DE CADA CAMPO DA TELA DA CONDIÇÃO DE PAGAMENTO Descrição de Cada Campo da Tela da Condição de Pagamento Código da Condição de Pagamento Tipo: texto Obrigatoriedade: obrigatório Descrição: identificador único desta condição de pagamento dentro do sistema. Comportamento: funciona como a chave do cadastro; é o valor exibido e selecionado por outras rotinas sempre que elas precisam referenciar esta condição. Impacto: aparece em pedidos de venda, pedidos de compra e demais documentos que utilizam esta condição de pagamento. Nome Tipo: texto Obrigatoriedade: obrigatório Descrição: nome ou descrição da condição de pagamento, exibido nas listas de seleção do sistema (por exemplo, “30/60/90 DIAS”). Comportamento: é usado nos filtros de busca da listagem, que localizam a condição tanto pelo código quanto pelo nome. Impacto: aparece nas telas de seleção de condição de pagamento em outras rotinas e em relatórios. Quantidade de Parcelas Tipo: número Obrigatoriedade: obrigatório Descrição: quantidade de parcelas em que o valor do documento será dividido ao aplicar esta condição de pagamento. Comportamento: serve de base para o recurso de geração automática de parcelas (Seção 8) e também é usado para validar se a distribuição de percentuais entre as parcelas está completa. Impacto: determina quantos títulos financeiros são gerados quando a condição é aplicada a um documento. Tipo de Condição de Pagamento Tipo: seleção Obrigatoriedade: obrigatório Descrição: define a regra usada para calcular a data de vencimento de cada parcela. Por exemplo: dia fixo dentro do mês, dia fixo fora do mês (mês seguinte) ou vencimento

Forma de Cobrança

Documentação Técnica Forma de Cobrança Cadastro e gerenciamento de modalidades de recebimento, integrado com vendas, títulos e processamento financeiro. 01. VISÃO GERAL DA FORMA DE COBRANÇA Visão Geral da Forma de Cobrança A rotina Forma de Cobrança faz parte do módulo Financeiro, dentro de Cadastros, do ERP. Ela reúne o cadastro de todas as modalidades de recebimento que a empresa aceita, como boleto bancário, cheque, PIX, cartão e outros meios de cobrança. As formas cadastradas aqui servem de referência para outras rotinas 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 usa exatamente as formas de cobrança definidas nesta tela. 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. Importante O cadastro de Forma de Cobrança é fundamental para o correto funcionamento dos processos de venda, recebimento e geração de documentos fiscais. Qualquer alteração aqui impacta imediatamente as rotinas que dependem dessas definições. 02. VÍDEO TUTORIAL DA FORMA DE COBRANÇA Vídeo Tutorial da Forma de Cobrança ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03. PRÉ-REQUISITOS E CONTEXTO DE ACESSO DA FORMA DE COBRANÇA Pré-requisitos e Contexto de Acesso da Forma de Cobrança Para acessar a rotina Forma de Cobrança, o usuário precisa ter a permissão correspondente à visualização da lista de formas de cobrança associada ao seu perfil de acesso. Sem essa permissão, o item não aparece no menu do sistema. Além disso, cada ação dentro da rotina exige uma permissão específica: Incluir uma nova forma de cobrança: permissão para criar novas formas de cobrança. Editar uma forma existente: permissão para editar formas de cobrança. Excluir uma forma: permissão para excluir formas de cobrança. Exportar a lista: permissão para exportar formas de cobrança. Se o usuário não tiver a permissão correspondente, o sistema não exibe o botão ou a ação da tela. Não é necessário ter cadastrado nenhuma outra informação previamente para acessar esta tela. Porém, para cadastrar ou editar uma forma do tipo “PB” (PIX/Boleto Híbrido), é necessário que o parâmetro do sistema responsável por liberar essa modalidade (“Liberado API PIX/BOLETO – Boleto Híbrido”) esteja configurado como “S” (Sim). Veja mais detalhes na seção Regras de Negócio e Restrições da Forma de Cobrança. 04. PROCESSO DE CRIAÇÃO: PASSO A PASSO DA FORMA DE COBRANÇA Processo de Criação: Passo a Passo da Forma de Cobrança 1 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 de Cadastros. O sistema exibe uma grade com todas as formas de cobrança já cadastradas. 2 Acionar a opção de nova forma de cobrança O usuário clica no botão de inclusão (Novo). O sistema abre o formulário de cadastro em branco, pronto para ser preenchido. 3 Preencher o campo Código O usuário informa o código numérico que vai identificar essa forma de cobrança. Esse número é a identificação única do registro e não pode ser alterado depois que o cadastro for salvo. 4 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”. Esse é o nome que vai aparecer sempre que essa forma for selecionada em outras telas do sistema. 5 Selecionar o Tipo da Forma de Cobrança O usuário escolhe, no campo “Tipo da Forma de Cobrança”, a classificação que melhor representa essa forma. Alguns exemplos de valores possíveis: “BO” (Boleto), “CH” (Cheque), “CA” (Cheque à Vista), “CS” (Cheque a Prazo), “PX” (PIX), “PY” (variante de PIX/Boleto) e “PB” (PIX/Boleto Híbrido). Se o usuário selecionar o tipo “PB” e o parâmetro que libera essa modalidade não estiver habilitado no sistema, o cadastro é bloqueado e uma mensagem de erro é exibida na tela. 6 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. Cada um desses campos está detalhado na seção Descrição de Cada Campo da Tela da Forma de Cobrança. 7 Salvar o registro O usuário clica em salvar para confirmar o cadastro. O sistema grava o registro imediatamente, mantém um registro interno da operação para fins de auditoria, e exibe a mensagem de confirmação “Forma cobrança inserido com sucesso.” 05. DESCRIÇÃO DE CADA CAMPO DA TELA DA FORMA DE COBRANÇA Descrição de Cada Campo da Tela da Forma de Cobrança Código Tipo: número inteiro Obrigatoriedade: Obrigatório Descrição: Número que identifica de forma única essa forma de cobrança dentro do sistema. Não pode se repetir: cada forma de cobrança precisa ter um código diferente de todas as outras já cadastradas. Comportamento: Depois que o registro é salvo pela primeira vez, esse campo fica bloqueado e não pode mais ser alterado. Impacto: Esse código é usado internamente para conectar a forma de cobrança a títulos do Contas a Receber, vendas e outras rotinas do sistema que dependem dela. Nome Tipo: texto Obrigatoriedade: Obrigatório Descrição: Nome que identifica a forma de cobrança de maneira fácil de reconhecer, como “BOLETO BANCÁRIO” ou “PIX”. É esse nome que aparece nas telas de seleção em todo o sistema. Comportamento: Campo de texto livre. O sistema usa o valor digitado tanto nas listas de seleção quanto na grade principal da rotina. A busca por nome na grade aceita busca parcial (não é necessário digitar o nome completo). Impacto: Esse nome aparece sempre que o usuário precisar escolher uma forma de cobrança em outras telas do sistema, como no lançamento de um título ou de uma venda. Tipo da Forma de Cobrança Tipo: seleção (texto) Obrigatoriedade: Obrigatório Descrição: