Como usar
- Base de homologação. Confirme com
SELECT DATABASE(), (SELECT codicfj FROM parametros LIMIT 1)em qual tenant está:centralé o Brasil (004) efjfrigo_concepcioné o Paraguai (001). Várias telas deste roteiro só existem de verdade no Paraguai (22B, 22F, 22G, 22H); cada tela diz qual tenant usar. - Reinicie o backend antes de começar (há rotas novas; compilar não reinicia).
- Siga os casos na ordem. Marque ok ou falhou e escreva a observação (mensagem que apareceu, id do registro, o que viu). O estado fica guardado neste navegador; o botão Exportar resultado no fim da página monta o texto para copiar e mandar.
- Em caso de falha anote: a opção, o passo, a mensagem exata (inclusive o código de ocorrência de 8 caracteres, quando o erro for inesperado), e anexe um print.
- Use sempre registros de teste: Excluir, Estornar e Aplicar gravam de verdade. Antes de cada caso que mexe em dado, anote o id e o estado anterior.
- Recusas chegam como HTTP 200 com
statuscode400 e a frase na faixa de erro da janela; perguntas como 409 (caixa Continuar/Cancelar); token como 428 (caixa de token). Algumas frases do servidor vêm em espanhol porque são as frases do legado. - Casos com a etiqueta Mudou em 04/10/2026 são das mudanças dos dias 02 a 04/10: 22H (Resumo e centro padrão das taxas), 22R (float editável e sem a trava EMPRESTIMO_FIDC), 228 (Impressão cheque), 22B (recibo em português/espanhol por país) e 224 (acesso só pela permissão da opção).
Travas comuns de lançamento
As quatro travas que quase toda tela de lançamento aplica. Preparar o dado uma vez e reaproveitar nos casos de cada tela.
- Mês fechado. É o
parametros.udf(não ofilial.udf):SELECT udf FROM parametros WHERE filial_ativa = <filial>. Também aparece no rodapé do sistema. A data menor ou igual ao udf está fechada (o próprio dia do udf já está fechado). A mensagem varia por tela ("Essa data já está fechada.", "Período já fechado: a data precisa ser posterior a …"); a data de referência também varia (emissão no título, data da baixa na baixa, data do adiantamento/prestação no 228, data da retenção na exclusão do 22F/22G). O fechamento do 22P é o da filial do título. A 22A só confere o mês fechado na variante avulsa; o 22O não confere. - Já baixado. Título com baixa viva (valor pendente diferente do valor da parcela). Trava alterar e excluir no 221 ("Este título não pode ser alterado: já possui baixa"), alterar no 226/22R ("Este empréstimo já tem parcela baixada…"), exclusão do 228 com baixa de fora e exclusão da 22A com título baixado. O 22P e o 22O não conferem baixa.
- Já contabilizado. No 221,
financeiro_emissao.numelan > 0trava a maior parte dos campos (escapam ADM/GER/FIM no Brasil; fora dele, uma lista de logins fixa no código). No 224, 226/22R e 22H a trava é a de "já conferido pela contabilidade", sem escape. No 223 não há trava de contabilizado (só mês fechado e conciliado); no 22P e no 22O também não. - Documento eletrônico vivo. Nenhuma das fontes destas telas aplica a trava de NF-e/DE vivo (
DocumentoEletronicoVivo), que é das telas de faturamento. O equivalente nesta lista é a retenção de IVA viva contra o título no 221 ("existe retenção de IVA gerada contra ele") e a retenção já conferida pela contabilidade no 22F/22G. Não há caso de NF-e/DE vivo neste roteiro. - Permissão. Regras nomeadas existentes aqui: as três do 21, VENCOL (22P), EXPPAG (22L), TITULOBAIXA_AUTORIZAR e TITULOBAIXA_EDITAR_PERC_COMISSAO (221). Telas sem regra nomeada: 223, 225, 226, 228, 22A, 22B, 22F, 22G, 22H, 22N, 22O. Em 04/10/2026 o 224 e o 22R passaram a depender só da permissão da opção.
Índice das telas
| Opção | Tela | Status (status-porte.csv) | Casos |
|---|---|---|---|
| 21 | Moedas (Câmbio) | FECHADO_100% (conferido 14/09/2026) | 23 |
| 221 | Títulos a Pagar/Receber | FECHADO_100% (25/09/2026) | 31 |
| 222 | Baixa Coletiva de Títulos | FECHADO_100% (01/10/2026) | 14 |
| 223 | Lançamentos Bancários Manuais | FECHADO_100% (17/09/2026; câmbio 02/10/2026) | 10 |
| 224 | Transferências entre Contas | FECHADO_100% (04/10/2026) | 16 |
| 225 | Conciliação Bancária | FECHADO_100% (17/09/2026) | 10 |
| 226 | Empréstimos (Captação) | FECHADO_100% (04/10/2026) | 12 |
| 228 | Adiantamentos/Prestação de Contas | FECHADO_100% (04/10/2026) | 16 |
| 22A | Facturas Avulsas | FECHADO_100% (16/09/2026) | 13 |
| 22B | Recibos | FECHADO_100% (04/10/2026) | 10 |
| 22F | Emissão Retenção IVA | FECHADO_100% (16/09/2026) | 8 |
| 22G | Ajustes Retenção IVA | FECHADO_100% (26/09/2026) | 6 |
| 22H | Cobrança Exportação | FECHADO_100% (04/10/2026) - falta teste de tela | 12 |
| 22L | Exportar Pagamentos Bancos | FECHADO_100% (17/09/2026) | 7 |
| 22M | Central de Boletos | FECHADO_100% (26/09/2026) | 9 |
| 22N | Central SISPAG | FECHADO_100% (17/09/2026) | 6 |
| 22O | Estorno Coletivo de Baixas | FECHADO_100% (17/09/2026) | 6 |
| 22P | Dados Financeiro Coletivo | PARCIAL (26/09/2026): ainda não exercitado com dado real nem na tela | 11 |
| 22R | Empréstimos FIDC/Fomento | FECHADO_100% (04/10/2026) | 14 |
21 — Moedas (Câmbio)
23 casosCaminho no menu: 2-Lançamentos › 1-Moedas (Câmbio) (21)
Doc técnico: validacoes-cotacao-moedas-21.html · Ajuda: botão ? da janela
- Regras nomeadas: HABILITA_CAMPOS_VALORES_COMPRA_VENDA_MOEDA_CAMBIO (câmbio contábil), AUTORIZAR_CONTAB_MOEDA_CAMBIO (Autorizar contábil e Atualizar lançamentos) e IMPORTAR_PLANILHA_PARA_INSERIR_MOEDA_CAMBIO (Importar). Grupo ADM vale para as duas primeiras; master passa em todas. Tenha dois usuários: um com as regras e um sem.
- Um usuário de grupo tipo CON ou GCO (contabilidade) para os casos de valor zero e de reescrita.
- Uma moeda estrangeira com id 112 ou maior (a regra de "pular data" não vale para a moeda local) e a data da última cotação dela anotada.
- Saber o fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial>. É o mesmo "mês fechado" de todas as telas deste roteiro (aparece no rodapé do sistema).
- Em central (Brasil) só a moeda local tem cotação: a reescrita de lançamentos ali não muda número. Para ver reescrita de verdade use um tenant com moeda estrangeira (fjfrigo_concepcion, Paraguai).
21-01 Abrir a grade e ajustar o período
- Abra a opção 21.
- Confira o período padrão nos campos De e Até.
- Apague os dois campos e atualize.
Abre com os últimos 30 dias. Com De/Até em branco aparece tudo. Colunas: Data, Moeda, Valor, Compra Contábil, Venda Contábil, Câmbio Desconto, Câmbio IFRS, Autorização Contábil (Sim/Não) e Atualizou (Sim/Não).
Compare a quantidade com SELECT COUNT(*) FROM moeda_valores no mesmo período.
21-02 Incluir uma cotação nova (dia seguinte à última da moeda)
- Incluir.
- Escolha a Moeda (id 112 ou maior) e a Data = dia seguinte à última cotação dela.
- Informe o Valor e o Câmbio Desconto; deixe Compra/Venda contábil como estão.
- Gravar.
A cotação aparece na grade com o valor digitado. Se havia lançamentos do dia com câmbio aberto, o aviso diz "Câmbio gravado nos lançamentos do dia: N linha(s) reescrita(s)." e a coluna Atualizou vira Sim.
SELECT * FROM moeda_valores WHERE idmoeda = <moeda> ORDER BY data DESC LIMIT 3.
21-03 Moeda ou Data em branco
- Incluir.
- Deixe a Moeda em branco e tente Gravar.
- Escolha a moeda, apague a Data e tente Gravar.
A tela exige os dois campos. Por chamada fora da tela as frases do servidor são "Campo [Moeda] em Branco !" e "Campo [Data] em Branco !" (em português ou espanhol: são as frases do legado).
Nada novo na grade.
21-04 Valor zerado: recusa para quem não é da contabilidade
- Com usuário comum, Incluir com Valor = 0.
- Repita com usuário de grupo CON ou GCO.
Usuário comum: "Campo [Valor] em Branco !" (a frase diz "em branco" mas dispara também com zero). CON/GCO grava sem valor (lança só o câmbio contábil).
Grade: a linha só existe no caso do CON/GCO.
21-05 Câmbio Desconto vazio recebe o valor da cotação
- Incluir com Valor preenchido e Câmbio Desconto vazio ou zero.
- Gravar.
Grava sem recusa e o Câmbio Desconto fica igual ao Valor, para qualquer grupo.
Coluna Câmbio Desconto da grade.
21-06 Ano fora de 2000–2050
- Incluir com Data em 1999 (ou 2051) e Valor preenchido.
- Gravar.
"Ano da data Incorreto !"
Nada gravado.
21-07 Trava de mês fechado na inclusão
- Incluir com Data menor ou igual ao parametros.udf da filial (o próprio dia do fechamento já está fechado).
- Gravar.
"Período já fechado: a data precisa ser posterior a <udf>." A frase traz a data do fechamento.
SELECT udf FROM parametros WHERE filial_ativa = <filial>.
21-08 Não é permitido pular data
- Incluir uma moeda de id 112 ou maior com Data mais de 1 dia depois da última cotação dela.
- Gravar.
"Não é permitido pular data ! A última cotação desta moeda é de AAAA-MM-DD." A data da frase é a da última linha da moeda na grade. Moeda local fica de fora da regra.
Filtre a grade pela moeda; a última linha é a data da frase.
21-09 Cotação duplicada na mesma data
- Incluir uma moeda com a Data já existente (ou a data da última cotação).
- Gravar.
"Já existe valor de cambio lancado para esta data !" Observação do doc técnico: em central a última cotação da moeda local está em 10/09/2029 (digitada adiante).
SELECT COUNT(*) FROM moeda_valores WHERE idmoeda = <moeda> AND data = '<data>'.
21-10 Câmbio compra/venda contábil só com a regra
- Com usuário sem a regra HABILITA_CAMPOS…, abra Incluir.
- Repita com usuário com a regra (ou grupo ADM ou master).
Sem a regra: Câmbio Compra Contábil e Câmbio Venda Contábil nascem desabilitados (cinza). Com a regra: editáveis. Por chamada fora da tela a frase é "Câmbio compra/venda contábil só se altera com a regra HABILITA_CAMPOS_VALORES_COMPRA_VENDA_MOEDA_CAMBIO (ou no grupo ADM)."
Visual dos campos na janela.
21-11 Alterar valor: moeda e data travadas; reescrita dos lançamentos
- Selecione uma cotação e Alterar.
- Confira que Moeda e Data estão travadas.
- Mude o Valor e Gravar.
Moeda e Data não se trocam (para corrigir, exclua e inclua). Se o câmbio contábil não mudou e quem grava não é CON/GCO, o aviso mostra as linhas reescritas e Atualizou = Sim. Se mexeu no contábil ou é CON/GCO: "Cotação gravada. Os lançamentos não foram reescritos (câmbio contábil alterado, ou gravado pela contabilidade)."
Grade e, em tenant com moeda estrangeira, o câmbio dos lançamentos do dia (compra, venda, títulos, baixas) com câmbio aberto.
21-12 Lançamento com câmbio fechado não é reescrito
- Tenha um lançamento do dia com cambio_fechado = 'T' na moeda da cotação.
- Altere a cotação e grave.
O lançamento com câmbio fechado fica como estava; só os com cambio_fechado = 'F' mudam.
SELECT cambio_fechado, valor_cambio FROM financeiro_emissao WHERE id = <id> antes e depois.
21-13 Alterar em mês fechado
- Alterar uma cotação com data menor ou igual ao udf, com usuário comum.
- Repita com CON/GCO.
Fora do Brasil, para quem não é CON/GCO: recusa "Período já fechado…". No Brasil, ou CON/GCO, passa (precedência do legado).
Valor da cotação na grade.
21-14 Regravar sem mexer em nada
- Abra uma cotação e Gravar sem alterar campo algum.
Os campos da cotação continuam com os mesmos valores. A reescrita (quando roda) grava o mesmo câmbio, sem mudar nenhum número.
SELECT * FROM moeda_valores da linha antes e depois.
21-15 Excluir uma cotação
- Selecione uma cotação de teste e Excluir.
A cotação some da grade. A exclusão não confere se algum lançamento já usou a cotação (como o legado).
SELECT COUNT(*) FROM moeda_valores da moeda/data = 0.
21-16 Autorizar Contábil
- Selecione uma cotação com Autorização Contábil = Não e clique Autorizar Contábil (usuário sem a regra, depois com a regra).
- Procure um jeito de desautorizar.
Sem a regra: "Usuário não tem permissão [AUTORIZAR_CONTAB_MOEDA_CAMBIO]!" (na tela os botões ficam cinza). Com a regra: aviso "Câmbio <moeda> — <data> autorizado.", coluna Autorização Contábil = Sim e o botão Atualizar Lançamentos fica disponível. Não existe desautorizar (só liga, como o legado).
Coluna Autorização Contábil.
21-17 Atualizar Lançamentos
- Numa cotação ainda não autorizada, clique Atualizar Lançamentos.
- Autorize e clique de novo.
Não autorizada: "O câmbio precisa estar autorizado para atualizar os lançamentos." Autorizada: aviso "Câmbio gravado nos lançamentos do dia: N linha(s) reescrita(s)." e Atualizou = Sim. Sem a regra: "Usuário não tem permissão [AUTORIZAR_CONTAB_MOEDA_CAMBIO]!"
Coluna Atualizou; câmbio dos lançamentos do dia.
21-18 Cotação excluída por outra pessoa
- Abra a grade em duas sessões.
- Numa sessão exclua a cotação; na outra, sem atualizar, clique Autorizar ou Atualizar nela.
"Cotação não encontrada." Atualize a grade.
21-19 Importar: botão só para quem tem a regra
- Entre com usuário sem IMPORTAR_PLANILHA_PARA_INSERIR_MOEDA_CAMBIO.
- Entre com usuário que tem (ou master).
Sem a regra o botão Importar nem aparece. Grupo ADM não dispensa: só a regra ou o master.
21-20 Importar planilha válida
- Monte uma planilha no leiaute do ceif: linha 1 cabeçalho; da linha 2: Data, Id moeda, Sigla, Valor, Desconto, Compra, Venda, IFR (o modelo antigo imp_moeda na A1, dados da linha 3, também é aceito).
- Importar > Escolher arquivo (.xlsx/.xls).
- Confira a prévia (Nova ou Substitui) e Gravar.
Aviso "Importação gravada: N nova(s), M substituída(s)." As cotações entram já autorizadas e com Atualizou = Não: a importação não reescreve lançamento algum (para isso use Atualizar Lançamentos).
SELECT data, idmoeda, aut_contab FROM moeda_valores nas datas importadas.
21-21 Importar planilha com erro
- Inclua na planilha uma linha com moeda inexistente (ex.: 999), outra com a mesma moeda e data repetidas, e importe.
- Importe também um arquivo que não é planilha.
Prévia mostra "Moeda 999 não cadastrada." e "Moeda e data repetidas na planilha." em vermelho; o botão Gravar fica desabilitado. Arquivo errado: "Arquivo inválido ou vazio." Na gravação, havendo erro, nada entra ("Linha 7: Moeda 999 não cadastrada.").
Nenhuma linha nova em moeda_valores.
21-22 Importar não confere mês fechado nem "pular data"
- Importe uma planilha com data dentro do mês fechado.
A importação grava (como o ceif e o legado): não há recusa de mês fechado nem de pular data. Registre o comportamento.
Linha em moeda_valores com data ≤ udf.
21-23 Buscar cotações oficiais
- Com a regra de Importar, clique Buscar cotações oficiais.
- Escolha o período (até 62 dias) e o que preencher (compra/venda contábil, IFRS, valor financeiro).
- Teste Repetir nos dias sem publicação e Só o que muda.
- Gravar.
Prévia marca cada linha como Nova, Altera (laranja, valor atual → novo) ou Igual; nada é gravado antes do Gravar. Brasil: PTAX de fechamento do Banco Central; Paraguai: DNIT (e BCP no IFRS). A cotação nova nasce sem autorização contábil e a que teve compra/venda alterada volta a precisar de autorização. Lançamentos já feitos não são atualizados.
Depende de acesso à internet; se a fonte estiver fora do ar, registre a mensagem.
221 — Títulos a Pagar/Receber
31 casosCaminho no menu: 2-Lançamentos › 1-Financeiros › Títulos (221)
Doc técnico: validacoes-titulo-221.html · Ajuda: botão ? da janela
- Tenant Brasil (central, codicfj 004) e tenant Paraguai (fjfrigo_concepcion, 001): as regras mudam por país e estão marcadas em cada caso.
- Usuários: um de grupo tipo ADM, um FIM, um GER e um comum (as travas por grupo usam o tipo do grupo; grupo cadastrado como FIN não destrava nada). Um usuário com a regra TITULOBAIXA_EDITAR_PERC_COMISSAO e um com TITULOBAIXA_AUTORIZAR; master passa sem elas.
- Um token de liberação gerado pelo ADM na tela Token (46) para cada caso de token (uso único).
- Dados: emitente comum, emitente bloqueado, centro de custo que aceita lançamento manual e outro que não aceita, título livre (sem baixa), título com baixa, título contabilizado (financeiro_emissao.numelan > 0), título de faturamento (idfaturamento > 0), título com retenção de IVA gerada.
- Fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial> (rodapé do sistema).
A tela repete parte das validações só para responder na hora; quem manda é o servidor. Mensagens do servidor são fixas em português mesmo no tenant paraguaio. Recusa chega como HTTP 200 com statuscode 400; pergunta como 409; token como 428.
221-01 Grade: pagar/receber, filtros e rodapé
- Abra a 221 e alterne entre Pagar e Receber.
- Filtre por período de emissão, de vencimento, conta, cheque, valor, tipo e Pendentes / Baixadas.
- Confira as colunas Protestado, Aut, Cont e o rodapé.
Cada filtro restringe a lista; o rodapé soma os valores da grade filtrada. Pendentes/Baixadas olham o que falta pagar, não a data.
Some a coluna de uma página pequena à mão e compare com o rodapé.
221-02 Incluir título a pagar (Brasil)
- Grade em Pagar. Incluir.
- Emitente, Data de emissão, Data da fatura, Vencimento (confira o dia da semana ao lado), Centro de custo, Valor da parcela, Histórico, Tipo de título e Tipo de pagamento.
- Gravar.
O título aparece na grade com Valor Pendente igual ao Valor Parcela (nada baixado).
SELECT * FROM financeiro_emissao WHERE id = <id> (excluido = 'F').
221-03 Incluir título (Paraguai): comprovante e timbrado
- No tenant paraguaio, Incluir título a pagar.
- Informe tipo de comprovante e documento no formato 999-999-9999999 de um timbrado cadastrado.
Grava com o documento no formato do timbrado. Documento sem hífen é formatado como 999-999-9999999.
Título na grade; tabela timbrado/emitente_timbrado com a faixa do documento.
221-04 Sugestão do emitente (centro de custo e histórico)
- Incluir e escolha um emitente que já tem títulos.
- Troque o centro de custo sugerido antes de gravar.
Centro de custo (e centro II e histórico padrão, quando houver) já vêm preenchidos, com uma faixa dizendo em quantos títulos o fornecedor foi usado. É só sugestão: o que foi escolhido nunca é trocado.
221-05 Campos obrigatórios
- Incluir e tente Gravar deixando, um de cada vez: Emitente, Centro de custo, Valor (zero), Data de emissão, Histórico (só espaços); no Brasil, Tipo de título e Tipo de pagamento.
A tela marca o campo em vermelho. As frases do servidor: "Campo [Emitente] em branco.", "Campo [Centro de Custo] em branco.", "Campo [Valor Original da Parcela] em branco." (vale para zero e negativo), "Campo [Data de Emissão] em branco.", "Campo [Histórico] em branco.", "Campo [Tipo de Título] em branco." e "Sem Tipo de pagamento selecionado." (os dois últimos só no Brasil).
Nada gravado.
221-06 Trava de mês fechado na emissão
- Incluir título com Data de emissão menor ou igual ao parametros.udf.
- Gravar.
"Essa data já está fechada." (o dia da própria U.D.F. já está fechado).
SELECT udf FROM parametros WHERE filial_ativa = <filial>.
221-07 Vencimento menor que a fatura e fatura muito avançada
- Incluir com Vencimento anterior à Data da fatura.
- Incluir com Data da fatura mais de 30 dias depois da emissão.
"Data de vencimento não pode ser menor que a data da fatura." e "Data de fatura muito avançada."
221-08 Avisos só da tela (valor alto em moeda estrangeira; recuperação judicial)
- Incluir título em moeda diferente da moeda local com parcela acima de 10.000.
- Marcar Recuperação Judicial com emissão ou fatura em 03/08/2026 ou depois.
A tela pergunta "Valor alto em moeda estrangeira — deseja continuar?" e, na segunda situação, pergunta sobre a recuperação judicial. Confirmando, grava normalmente: não há checagem equivalente no servidor.
221-09 Emitente inexistente ou bloqueado
- Incluir com emitente bloqueado (emitente.bloqueado).
- Digite um id de emitente que não existe.
"Emitente bloqueado, procure o gerente." Id inexistente: a tela limpa o campo ao sair; por fora da tela o servidor diz "Emitente não encontrado."
Cadastro do emitente (15).
221-10 Centro de custo que não aceita lançamento manual
- Incluir com centro de custo com lanc_manual desligado.
- Alterar um título antigo mudando o centro para esse mesmo centro.
"Este Centro de Custo não aceita lançamento manual, procure o gerente." Vale na inclusão e na alteração em que o centro mudou; alterar outro campo de título antigo não redispara.
Cadastro do centro de custo.
221-11 Brasil: emitente sem CPF/CNPJ ou sem cidade
- No Brasil, Incluir com emitente cujo documento é vazio ou começa por 000.000.
- Repita com emitente sem cidade.
"CPF/CNPJ inválido no cadastro do emitente." e "Cidade inválida no cadastro do emitente." Escapam: emitente do exterior (UF = EX), fantasia com DIRETORIA e FUNCIONARIOS em centro de FOLHA/SALARIO/ADIANTAMENTO/VALE AL/VALE TRA.
Cadastro do emitente (15).
221-12 Brasil: competência no histórico, documento obrigatório e tipo de pagamento
- Incluir em centro de custo cuja descrição tem IMPOST, COFINS, ICMS ou PIS, histórico sem barra.
- Repita com histórico "ICMS 03/2026".
- Incluir sem número de documento.
- Incluir com tipo de pagamento que tem DEPOSITO na descrição.
Sem barra: "Colocar a competência no histórico."; ano velho demais (mais de 4 anos): "Colocar a competência no histórico [AAAA]."; "ICMS 03/2026" é aceito. Sem documento: "Proibido gravar sem número de documento." (só inclusão; alterar título antigo sem documento é permitido). DEPOSITO: "Tipo de pagamento inválido."
221-13 Token: prazo curto e fim de semana (Brasil)
- Título a pagar, valor acima de 50, prazo de até 2 dias entre emissão e vencimento, em centro de custo que não dispensa token. Gravar.
- Título a pagar com vencimento em sábado ou domingo. Gravar.
- Informe um token gerado na tela 46; depois tente reutilizar o mesmo token.
"Prazo de vencimento menor que 3 dias - informe um token de liberação." e "Data de vencimento cai num fim de semana - informe um token de liberação." (a tela abre a caixa de token). Título que cai nas duas regras pede dois tokens em sequência. Token usado de novo: "Token inválido ou já utilizado." Centro com dispensa_token_prazo ligado não pede o primeiro token.
Tela Token (46) para gerar; só tipo de grupo ADM gera ("Sem permissão para gerar token." para os demais).
221-14 Paraguai/Bolívia: comprovante, IVA e certificado de não retenção
- Incluir com tipo de comprovante SC e base de IVA 10% ou 5% maior que zero.
- Paraguai: SC com documento que não começa por 000-000.
- Paraguai, a pagar, documento sem timbrado cadastrado.
- Percentual de retenção em emitente com validade_no_retencion posterior à emissão.
"Não é possível lançar Sem Comprovante com IVA."; "Sin comprovante não deve ter prefixo, deve ser 000-000."; "Timbrado não encontrado." (ou "Timbrado vencido."; para timbrado do fornecedor: "Timbrado não encontrado para o emitente."); "% de retenção não permitido: emitente com certificado de não retenção ainda válido." No Brasil o comprovante PN dá "Tipo de comprovante inválido."
Tabela timbrado ou emitente_timbrado.
221-15 Alterar título livre e regravar sem mexer
- Abra um título livre (sem baixa, sem contabilizar, fora do mês fechado) e altere o histórico; Gravar.
- Abra outro título livre e clique Gravar sem alterar nada.
Alteração aparece na grade. Regravar sem mexer não muda nenhum campo (confira com a SQL antes e depois). Título antigo sem histórico passa a exigir histórico ao gravar.
SELECT * FROM financeiro_emissao WHERE id = <id> antes e depois.
221-16 Alterar título travado: baixado, contabilizado, lançamento automático, mês fechado
- Abra um título com baixa, outro contabilizado (numelan > 0), um de faturamento (idfaturamento > 0) e um com emissão ≤ udf.
- Tente alterar histórico, valor e moeda; depois vencimento, centro de custo e cabeçalho com usuário comum, FIM e ADM.
Campos travados na tela. Quando só campos travados são enviados: "Este título não pode ser alterado: já possui baixa; já contabilizado (numelan N)." (todos os motivos na mesma frase). Liberados com o título travado: vencimento (ADM e FIM), centro de custo e cabeçalho (ADM); o resto é ignorado em silêncio. Ajuste de IVA continua liberado em título de faturamento. Já contabilizado: no Brasil escapa ADM/GER/FIM; fora do Brasil só a lista de logins fixa no código (athayde, marcos, aurora).
Coluna Cont da grade; financeiro_emissao.numelan.
221-17 Excluir título livre
- Selecione um título de teste livre.
- Clique Excluir (o formulário abre travado, com o botão Excluir).
- Confirme.
O título some da grade. Exclusão lógica em cascata: o título, o asiento, o lançamento bancário e os títulos filhos (idfinanceiro_pai) ficam com excluido = 'T'.
SELECT excluido FROM financeiro_emissao WHERE id = <id> ou idfinanceiro_pai = <id>.
221-18 Excluir título travado
- Tente excluir: título de faturamento, título já baixado, título com emissão ≤ udf e título com retenção de IVA gerada contra ele (22F/22G).
Recusa na janela com "Este título não pode ser excluído: <motivo>." Motivos: lançamento automático (faturamento N), já possui baixa, emissão dentro do período fechado, "existe retenção de IVA gerada contra ele". Título de faturamento nunca se exclui, nem como ADM. Nota: o doc técnico diz que só faturamento bloqueia a exclusão; o código e o histórico de 17/09 incluem fechamento, baixa e retenção viva. Registre o que acontecer.
Título continua com excluido = 'F'.
221-19 Clonar
- Selecione um título e Clonar.
Cria título novo a partir do outro. Só o título vindo de faturamento não pode ser clonado (o clone não confere mês fechado nem baixa).
Novo id na grade.
221-20 Autorizar, % Comiss. e autorização multifilial
- Clique Autorizar num título e depois de novo.
- Com usuário sem a regra, use % Comiss. e o botão de autorização multifilial; repita com a regra.
Autorizar liga/desliga a coluna Aut. Sem regra: "Usuário sem permissão para alterar o percentual de comissão." (TITULOBAIXA_EDITAR_PERC_COMISSAO) e "Usuário sem permissão para autorizar a visualização multi-filial." (TITULOBAIXA_AUTORIZAR). Master passa. Conceder TITULOBAIXA_NOVA_BAIXA etc. não muda nada nesta tela.
221-21 Dados Fatura, Dados Pagamento, Importar e XLS
- Abra Dados Fatura e Dados Pagamento de um título gravado e grave.
- Importar uma planilha pequena de títulos.
- Clique XLS na grade filtrada.
Dados Fatura grava documento, timbrado e cancelamento; Dados Pagamento grava conta, agência/conta e forma (PIX, boleto…). Importar inclui em lote. XLS baixa a grade filtrada. No Brasil, chave PIX fora do formato e dígito de agência/conta (BB, Bradesco, Itaú) fora do certo dão apenas aviso e gravam assim mesmo.
Planilha aberta; títulos importados na grade.
221-22 Baixa: incluir total e parcial
- Em um título livre, clique Baixa > Incluir.
- Data da baixa, Conta bancária da mesma moeda do título, Valor integral; Gravar.
- Em outro título, baixe parcial.
Rodapé da janela mostra total baixado e pendente: quitação total deixa pendente zero; parcial deixa o resto. Na grade o título ganha baixa.
SELECT * FROM financeiro_baixas WHERE idfinanceiro_emissao = <id> AND excluido = 'F'.
221-23 Baixa: obrigatórios, soma zero e excesso
- Gravar baixa sem data, sem valor e sem conta.
- Baixa cujo Valor + Desconto + Devolução + Retenção = 0 (só juros).
- Baixa com líquido maior que o pendente.
A tela diz "campo obrigatório"; servidor: "Campo [Conta Bancária] em branco.", "Valor pago + Desconto + Devolução + Retenção não pode ser igual a zero.", "Valor líquido (Valor + Desconto + Devolução − Acréscimo − Juros + Retenção) não pode ser maior que o valor pendente do título."
Rodapé da janela de baixas.
221-24 Baixa: datas e mês fechado
- Baixa com data menor que a fatura, menor que a emissão, menor que a emissão do cheque.
- Baixa com data ≤ udf.
"Data da baixa não pode ser menor que a data da fatura do título." / "…da data de emissão do título." / "…da data de emissão do cheque." / "Essa data já está fechada." (o fechado aqui é a data da baixa).
SELECT udf FROM parametros WHERE filial_ativa = <filial>.
221-25 Baixa: conta bancária e câmbio
- Baixa com conta de outra moeda.
- Baixa com conta desativada (data da baixa depois de data_desativacao).
- Baixa em moeda estrangeira em dia sem cotação.
"A moeda da conta bancária não corresponde à moeda do título."; "Conta bancária desativada."; "Não há cotação cadastrada para a moeda da conta bancária na data da baixa." (ou "Conta bancária sem moeda cadastrada: <id>").
SELECT * FROM moeda_valores WHERE idmoeda = <moeda> AND data = '<data da baixa>'.
221-26 Baixa Paraguai: cheque em fim de semana, feriado, teto diário e chequeira
- No Paraguai, título a pagar, conta de banco com controla_feriados: baixa em sábado/domingo e em feriado futuro.
- Conta com controla_limite_salarios e valor_diario: baixa que estoura o teto em dia de folha (5 e 20, ou segunda seguinte).
- Cheque que não pertence à chequeira da conta, ou já emitido/cancelado.
"Não é possível pagar um cheque em sábado ou domingo."; "Não é possível pagar em data de feriado (<nome>)." (feriado já passado não bloqueia); "Valor acumulado do dia (X) passa do limite diário da conta (Y) em dia de folha." (centro marcado como salário escapa); mensagens da conferência de cheque. Não valem no Brasil nem na Bolívia.
Conta bancária (173): marcadores e valor_diario; tabela feriados.
221-27 Baixa: perguntas (fornecedor com contas a receber; conciliação futura)
- Paraguai/Bolívia: baixa de título a pagar de fornecedor que tem contas a receber pendentes.
- Título a pagar numa conta que já tem baixa conciliada em data igual ou posterior.
Pergunta "Esse fornecedor possui contas a receber pendentes, valor X." com botões invertidos: "Continuar sem desconto" / "Lançar desconto" (lançar desconto cancela a gravação). Segunda: "Já existe conciliação bancária com data futura nessa conta." Confirmando, no Brasil só ADM e FIM passam: "Usuário sem permissão para lançar baixa com conciliação futura já existente."
221-28 Baixa: retenção, exportação, recuperação judicial e compra de gado
- Título a pagar com % retenção em emitente com certificado válido.
- Título a receber de venda de exportação (tipo 113) baixado aqui, com usuário comum e com ADM.
- Título marcado recuperação judicial: incluir baixa.
- Título de compra de gado: baixa antes do vencimento e com faturamento sem as duas autorizações.
"Percentual de retenção não permitido — o fornecedor tem certificado de não-retenção válido até AAAA-MM-DD."; "Baixa de exportação, somente pelo módulo de cobrança." (ADM e tipo/emitente liberados escapam); "Título em recuperação judicial - informe um token de liberação para pagar."; "Data da baixa não pode ser menor que a data de vencimento."; "Não é permitido fazer o pagamento — esse faturamento de compra de gado não está autorizado." / "…não contém todas as faturas." (ADM escapa).
221-29 Excluir baixa
- Exclua uma baixa de título a pagar sem cheque e sem conciliação.
- Tente excluir baixa com data ≤ udf, baixa com cheque (a pagar), baixa de cobrança de exportação e baixa conciliada (usuário comum e ADM/FIM).
Baixa livre: some e o pendente volta. Recusas: "Essa data já está fechada."; "Este pagamento possui cheque, não será permitido excluir."; "Essa baixa só pode ser excluída pela cobrança exterior."; pergunta "Essa baixa já tem conciliação, deseja continuar?" e depois "Usuário sem permissão, baixa já conciliada." (só ADM/FIM); no Paraguai, "Somente o usuário que lançou a baixa pode excluí-la (<nome>)." (ADM escapa). Recuperação judicial pede token. A exclusão alcança o lote da baixa coletiva inteiro.
SELECT excluido, numero_cheque FROM financeiro_baixas WHERE id = <id>.
221-30 Manutenção das baixas (só Paraguai)
- No Paraguai, use Trocar data do cheque, Trocar data da baixa, Remetente e Marcar cheque vencido numa baixa de lote.
- Num tenant brasileiro, tente os mesmos botões.
A mudança vale para a baixa coletiva inteira. "Operação disponível apenas no Paraguai." nos outros países. Trocar data da baixa só para a lista fixa de logins (athayde, marcos, pedro, adao, domingo, laura, cynthya): "Usuário sem permissão para trocar a data da baixa." Mês fechado: "Essa data já está fechada." (escapam ADM/GCO/CON só na data do cheque). "Data do cheque superior à data da baixa." Feriado: pede token (master dispensa na data da baixa). Remetente não valida data.
221-31 Recuperação judicial: tirar a marca exige token
- Em filial com em_recuperacao_judicial ligado, abra título marcado e desmarque a recuperação judicial.
"Para tirar da recuperação judicial é necessário um token de liberação."
filial.em_recuperacao_judicial.
222 — Baixa Coletiva de Títulos
14 casosCaminho no menu: 2-Lançamentos › 1-Financeiros › 2-Baixa Coletiva de Títulos (222)
Doc técnico: validacoes-baixa-coletiva-222.html · Ajuda: botão ? da janela
- Conta bancária ativa com moeda definida, e títulos em aberto na mesma moeda da conta (um título em dólar não aparece com conta em guarani, e não é erro).
- Para os casos de retenção/documento: tenant paraguaio. Para teto diário e dia útil: conta de banco do tipo banco com os marcadores ligados.
- Um título em recuperação judicial e um token (tela 46) para o caso do token.
- Saber o fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial>.
A gravação é tudo ou nada: se um título falhar, nenhum é gravado, e a mensagem traz o documento do título para saber qual desmarcar. Não há trava de "já contabilizado" descrita nas fontes desta tela; a baixa em lote usa as regras da baixa individual (221).
222-01 Buscar títulos: conta obrigatória e filtros
- Escolha Contas a Pagar ou Receber e clique Buscar sem Conta bancária.
- Informe a conta e Buscar; depois aplique emitente, centro de custo, centro de custo 2, grupo (incluir e excluir), tipo de faturamento e vencimento.
- Marque Todas Filiais.
Sem conta: "Campo [Conta Bancária] em branco." Com conta: só títulos em aberto na moeda da conta, com o Valor Pendente. Sem Todas Filiais só a filial atual. Conta sem moeda, inexistente ou desativada recusam ("Conta bancária sem moeda definida.", "Conta bancária não encontrada.", "Conta bancária desativada.").
Compare a lista com os títulos pendentes em 221.
222-02 Baixa total de vários títulos
- Marque 3 títulos (a caixa da linha sugere o pendente inteiro).
- Data da baixa; Baixar.
A tela limpa e mostra quantos títulos foram baixados. Em 221 o pendente dos três está zerado.
SELECT COUNT(*) FROM financeiro_baixas das baixas novas (excluido = 'F').
222-03 Baixa parcial: desconto e acréscimo automáticos
- Reduza o valor a baixar de uma linha; em outra aumente (dentro do pendente permitido pela regra).
Diminuir o valor lança a diferença como desconto; aumentar lança como acréscimo. Linha que passa do pendente fica em vermelho.
Colunas valor, desconto e acréscimo da baixa gravada.
222-04 Nenhum título marcado e título excluído por outra pessoa
- Clique Baixar sem marcar nada.
- Marque títulos, exclua um deles em outra sessão e clique Baixar.
"Nenhum lançamento foi selecionado." e "Título <id> não encontrado ou excluído." (nada gravado).
222-05 Mês fechado e datas por título
- Baixar com Data da baixa ≤ udf.
- Baixar com data menor que a emissão do título ou do cheque.
"Data da baixa dentro do período já fechado (AAAA-MM-DD)." e "Data da baixa menor que a data de emissão do título <documento>." / "…do cheque."
SELECT udf FROM parametros WHERE filial_ativa = <filial>.
222-06 Assumir vencimento e Agrupar
- Marque Assumir vencimento e observe Agrupar.
- Com um título sem vencimento marcado, Baixar.
- Desmarque Assumir vencimento, ligue Agrupar e baixe 3 títulos.
Assumir vencimento desliga Agrupar e a conferência de mês fechado passa a ser por título (cada um na data do vencimento). Título sem vencimento: "Título <documento> não tem vencimento para assumir como data da baixa." Com Agrupar as baixas recebem o mesmo identificador de coletivo (na conciliação 225 aparecem como um valor só).
SELECT idcoletivo FROM financeiro_baixas das baixas novas (mesmo valor nas 3).
222-07 Baixar zerado
- Marque Baixar zerado e baixe um título.
A baixa sai sem dinheiro: tudo vira desconto, sem movimento de caixa. Junto com retenção ou devolução dá "Não é possível ratear sem valor a baixar."
Baixa com valor 0 e desconto = pendente.
222-08 Cheque, Descontado e conferência de cheque
- Informe número e data de emissão do cheque e marque Descontado; baixe.
- Use um cheque que não é da chequeira ou já emitido.
Baixa grava o cheque. Cheque inválido: mensagens da conferência de cheque (iguais às da 221). Na coletiva a baixa em fim de semana/feriado/teto segue as regras da baixa individual.
financeiro_baixas.numero_cheque e descontado.
222-09 Rateio de retenção e devolução
- Informe Retenção (ou Devolução) maior do que os títulos comportam.
- Informe valor válido e baixe.
"A retenção é X, mais do que os títulos selecionados comportam (sobra Y)." / "A devolução é X…" (a sobra é quanto não coube). Com valor válido o sistema reparte entre os títulos. Título que recebe mais que o pendente: "Valor (X) maior que o pendente (Y) no título <documento>."
Soma da retenção/devolução das baixas = valor informado.
222-10 Notas de Crédito abatem a baixa
- Na aba Notas de Crédito, busque as notas do fornecedor filtrado e marque algumas.
O campo Valor Devolução trava e mostra a soma das notas marcadas; a baixa abate esse valor.
Soma das notas marcadas = Valor Devolução.
222-11 Paraguai: abas Fatura e Retenção
- No Paraguai, preencha a aba Retenção com documento e data com todos os títulos do mesmo emitente.
- Repita com títulos de dois emitentes.
- Documento de retenção fora do formato 000-000-0000000.
Cada aba mostra ● quando ligada. Dois emitentes: "Não é possível fazer retenção para mais de um emitente na mesma operação." Formato: "Documento de retenção deve ter o formato 000-000-0000000." / "…deve terminar com o número sequencial." Fora do Paraguai as abas não aparecem ("Documento complementar e retenção de IVA só valem no Paraguai." por fora da tela).
222-12 Contra-partida
- Ligue Contra-partida sem Centro de Custo.
- Informe o centro e baixe.
- Repita com título cuja emissão está no período fechado.
"Centro de custo da contra-partida é obrigatório quando ela está ligada." Com centro: para cada título é gerado um segundo título espelhado (pagar vira receber e vice-versa). Título anterior ao fechamento: "Título <documento> tem emissão anterior à data de fechamento (contra-partida)." A contra-partida nasce desligada.
Quantidade de títulos novos em financeiro_emissao = quantidade de baixados.
222-13 Recuperação judicial, compra de gado e teto diário
- Marque um título em recuperação judicial e baixe.
- Baixe título de compra de gado sem as duas autorizações ou sem todas as faturas (como ADM também).
- Em conta com valor_diario, baixe vários títulos cuja soma passa do teto em dia de folha.
Recuperação judicial pede token (428). Compra de gado: "Não é permitido fazer o pagamento — esse faturamento de compra de gado não está autorizado." / "…não contém todas as faturas." (na coletiva valem sempre, ADM não escapa). Teto: "Valor acumulado do dia (X) passa do limite diário da conta (Y) em dia de folha." conferido contra o total da operação inteira.
222-14 Tudo ou nada
- Marque 5 títulos, sendo um deles inválido (ex.: pendente menor que o valor).
- Baixar.
Nenhum dos cinco é baixado. A mensagem traz o documento do título culpado.
COUNT em financeiro_baixas não mudou.
223 — Lançamentos Bancários Manuais
10 casosCaminho no menu: 2-Lançamentos › 1-Financeiros › 3-Lançamentos Bancários Manuais (223)
Doc técnico: validacoes-lancamento-banco-223.html · Ajuda: botão ? da janela
- Conta bancária ativa, tipos de lançamento bancário cadastrados (o tipo decide se o valor entra ou sai da conta), moeda estrangeira com e sem cotação do dia.
- Um lançamento já conciliado (data de conciliação preenchida) e um não conciliado.
- Fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial>.
- Observação: o doc técnico validacoes-lancamento-banco-223.html está desatualizado em dois pontos (diz que não há trava de conciliado e que o câmbio nasce 1); vale o comportamento abaixo, do código e da ajuda.
223-01 Grade por período
- Abra a 223 e filtre por De/Até.
Lista data, conta, valor original, câmbio, valor em moeda local, moeda, histórico, tipo, centro de custo e data de conciliação. Data em formato inválido: "Data inicial inválida." / "Data final inválida."
COUNT em financeiro_lancamento_banco no período (excluido = 'F').
223-02 Incluir lançamento em moeda local
- Incluir: Conta bancária, Data, Valor, Moeda (local), Tipo de lançamento bancário, Histórico.
- Gravar.
Aparece na grade; o Câmbio vem sozinho (1 na moeda local) e o valor em moeda local é calculado.
SELECT * FROM financeiro_lancamento_banco WHERE id = <id>.
223-03 Incluir em moeda estrangeira: câmbio da cotação do dia
- Incluir com Moeda estrangeira e data com cotação cadastrada na 21.
- Repita com data sem cotação.
O câmbio traz a cotação financeira do dia e o valor em moeda local é convertido. Sem cotação: "Sem cotação da moeda <sigla> em dd/mm/aaaa - cadastre a cotação (tela 21) antes de gravar."
SELECT valor FROM moeda_valores WHERE idmoeda = <moeda> AND data = '<data>'.
223-04 Campos obrigatórios
- Tente gravar deixando, um de cada vez: Conta, Data, Valor, Histórico, Moeda, Tipo de lançamento.
A tela exige Conta, Data, Valor e Histórico (a tela marca o campo). Por chamada fora da tela o servidor recusa "Campo [Moeda] em branco.", "Campo [Tipo de lançamento] em branco." e "Campo [Valor original] em branco." (zero também). Valor negativo é aceito: o sinal vem do tipo.
Nada gravado.
223-05 Trava de mês fechado
- Incluir com data ≤ udf.
- Alterar um lançamento antigo de período fechado.
"Essa data já está fechada." nos dois (o dia do udf já está fechado).
SELECT udf FROM parametros WHERE filial_ativa = <filial>.
223-06 Alterar e regravar sem mexer
- Altere o histórico de um lançamento livre e grave.
- Abra outro e clique Gravar sem mexer.
Alteração aparece. Regravar sem mexer não muda valor, câmbio nem demais campos.
SELECT * da linha antes e depois.
223-07 Lançamento já conciliado não se altera nem exclui
- Tente Alterar e Excluir um lançamento com data de conciliação preenchida.
"O lançamento <id> já está conciliado em dd/mm/aaaa - desfaça a conciliação antes de alterar." (ou "…excluir."). A conciliação é desfeita na 225.
Coluna Conciliado da grade.
223-08 Perna de transferência e variação cambial ficam fora
- Tente alterar/excluir pela 223 um lançamento de transferência (tipo 113/114) e um "Variacion cambial…".
"O lançamento <id> é de transferência entre contas (tipo 113) - alterar pela tela de Transferências (224)." e "…é de variação cambial, gerado automaticamente, e não pode ser alterado por esta tela." Incluir com tipo 113/114 também é recusado.
223-09 Excluir lançamento livre
- Selecione um lançamento de teste não conciliado, Excluir (janela travada) e confirme.
Some da grade. Exclusão lógica com o usuário registrado. Nesta tela não há trava de "já contabilizado": só mês fechado e conciliado.
SELECT excluido, idusuario_excluiu FROM financeiro_lancamento_banco WHERE id = <id>.
223-10 Sugestão de classificação
- Incluir, escolha conta e tipo ou digite parte do histórico de um lançamento antigo.
O sistema procura lançamentos dos últimos 2 anos nesta filial e preenche o que estiver vazio (centro de custo, centro II, tipo e histórico). Uma faixa diz o que foi sugerido; o que foi digitado nunca é trocado.
224 — Transferências entre Contas
16 casosCaminho no menu: 2-Lançamentos › 1-Financeiros › 4-Transferências entre Contas (224)
Doc técnico: validacoes-transferencia-224.html · Ajuda: botão ? da janela
- Duas contas na mesma moeda e duas contas em moedas diferentes (uma delas a local), uma conta de banco com chequeira e uma com valor_diario preenchido.
- Uma transferência já contabilizada e conferida pela contabilidade (contabilidade_analitico.idusuario_conferiu na tabela ftb) e uma livre. Token da tela 46 para o teto diário.
- Fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial>.
- Acesso: só pela permissão da opção no menu. Não há mais trava por grupo, filial ou login (decisão de 04/10/2026).
224-01 Acesso só pela permissão da opção Mudou em 04/10/2026
- Com um usuário que tem a opção 224 no menu, de grupo qualquer e filial qualquer, abra a tela e inclua, altere e exclua.
- Com um usuário sem a opção, tente abrir.
Quem tem a opção usa a tela inteira, sem recusa por grupo, filial ou login. Quem não tem não vê o item no menu.
Acesso dos Grupos (444).
224-02 Grade: filtros e colunas
- Abra a 224 (últimos 45 dias).
- Filtre por período, por conta (filtra saída e entrada) e ligue Multi Filial.
Colunas: duas contas, valor de saída, câmbio, valor em moeda local, valor de entrada, dados do cheque, Cont/Asiento, conferido e conciliado.
COUNT de financeiro_lancamento_banco com idtransferencia preenchido no período.
224-03 Incluir transferência na mesma moeda
- Incluir: Data, Tipo, Conta de saída (a moeda aparece ao lado), Câmbio e Valor de saída, Conta de entrada, Histórico.
- Confira que câmbio/valor de entrada vêm calculados.
- Gravar.
Aparece na grade com as duas pontas e um id de transferência. A diferença entre entrada e saída (moeda local) abaixo do formulário fica perto de zero; destacada em vermelho se o câmbio estiver errado.
SELECT id, idconta_bancaria, valor, idtransferencia FROM financeiro_lancamento_banco WHERE idtransferencia = '<id>' (duas linhas, tipos 113 e 114).
224-04 Incluir entre moedas diferentes
- Conta de saída em dólar e de entrada na moeda local (ou o inverso); informe os câmbios.
- Gravar.
Cada perna leva seu valor e câmbio; as duas dão o mesmo valor em moeda local. Diferença de 0,50 ou mais: "Os 2 valores devem coincidir em moeda local (diferença: X)".
Duas linhas com o mesmo idtransferencia.
224-05 Campos obrigatórios
- Tente gravar sem Moeda, sem Data, com Valor zerado (saída e entrada), com câmbio zerado e sem Histórico.
"Campo [Moeda] em branco.", "Campo [Data] em branco.", "Campo [Valor] em branco." (serve às duas pernas), "Campo [Valor do Câmbio] em branco.", "Campo [Histórico] em branco." Também "Conta de entrada incorreta." e "Emitente incorreto." quando faltam.
224-06 Trava de mês fechado
- Incluir transferência com data ≤ udf.
- Alterar uma transferência dentro do período fechado.
"Essa data já está fechada." na inclusão e na alteração.
SELECT udf FROM parametros WHERE filial_ativa = <filial>.
224-07 Contas: desativada e moeda incompatível
- Use conta desativada (data da transferência depois de data_desativacao) como saída e como entrada.
- Informe moeda diferente da cadastrada na conta.
"Conta desativada." e "Moeda incompatível com a conta." (cada perna é conferida contra a sua conta).
conta_bancaria.data_desativacao.
224-08 Fim de semana com conta de banco
- Transferência em sábado ou domingo com conta de saída do tipo banco (Brasil e Paraguai).
- Confira também a conta de ENTRADA do tipo banco.
"Não é possível pagar um cheque em sábado ou domingo." Não vale na Bolívia e só olha sábado e domingo (não usa feriados). A checagem confere as duas contas (correção de 17/09).
224-09 Cheque na conta de banco
- Informe número de cheque que não pertence à chequeira da conta, depois um já emitido ou cancelado.
- Transferência sem número de cheque (TED/DOC).
Mensagens da conferência de cheque. Sem cheque não passa por essa conferência. Cheque tem tipo (normal ou diferido) e data de emissão.
Chequeira da conta de saída.
224-10 Teto diário da conta de saída (token)
- Conta com valor_diario > 0: faça transferências que somadas às baixas a pagar e saídas de transferência do dia passem do limite.
- Gere o token (46) e grave de novo com ele.
Sem token: pedido de token com "Valor acumulado de los cheques son mayor que lo limite diario ! Vlr. acumulado X Teto: Y". Token válido grava e é consumido; reutilizar: "Token inválido ou já utilizado." O doc técnico diz que o teto não foi portado; o código e a ajuda dizem que foi — registre o que ocorrer.
Tela Token (46).
224-11 Alterar regrava as duas pernas; regravar sem mexer
- Altere o histórico de uma transferência livre e grave.
- Abra outra e clique Gravar sem alterar nada.
As duas linhas são regravadas juntas com as mesmas validações da inclusão. Regravar sem mexer não muda valores, câmbios nem cheque. Alterar valor de transferência conciliada desfaz o casamento com o extrato (a tela não impede).
SELECT * da transferência (duas linhas) antes e depois.
224-12 Trava de já contabilizado e conferido
- Tente alterar e excluir uma transferência contabilizada e conferida pela contabilidade.
- Tente com uma contabilizada mas ainda não conferida.
Conferida: "Este lançamento foi contabilizado, não será permitido alterar." / "…excluir." (sem escape por grupo; a contabilidade tem de retirar a conferência). Não conferida: continua editável.
contabilidade_analitico.idusuario_conferiu da tabela ftb.
224-13 Excluir transferência livre
- Selecione uma transferência livre, Excluir (janela travada) e confirme.
Some da grade; as duas pernas ficam excluídas juntas. Cheque em conta de banco: algumas combinações recusam na exclusão.
SELECT excluido FROM financeiro_lancamento_banco WHERE idtransferencia = '<id>'.
224-14 Contabilizar liga/desliga
- Clique Contabilizar numa transferência livre e depois de novo.
Liga e desliga se a transferência (as duas pernas) entra na contabilidade; a coluna Cont/Asiento acompanha.
224-15 Imprimir: cheque, cópia, recibo, carta e planilhas
- Selecione uma transferência com cheque e abra Imprimir.
- Gere Cheque, Cópia, Recibo do cheque e Carta de transferência.
- Gere os relatórios em planilha: transferências pendentes e contab.
Os cinco impressos saem sem erro: cheque no formulário de cheque, cópia, recibo, carta (documento assinável) e duas planilhas (pendentes = não compensadas; contab = para a contabilidade).
Abra os arquivos e confira conta, valor, nominal e datas.
224-16 Digitalizar
- Anexe a imagem do comprovante.
O anexo fica ligado à transferência e pode ser reaberto.
225 — Conciliação Bancária
10 casosCaminho no menu: 2-Lançamentos › 1-Financeiros › 5-Conciliação Bancária (225)
Doc técnico: (sem documento validacoes próprio; ver validacoes-lancamentos-financeiros-22.html) · Ajuda: botão ? da janela
- Conta bancária com movimentos num dia (baixas, lançamentos, transferências) e o extrato desse dia em mãos (ou um saldo de extrato inventado).
- Um movimento já conciliado em outra data, uma baixa coletiva ou cheque agrupado.
- Tenant Brasil (excluir só existe no Brasil) e um tenant fora do Brasil.
- Fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial>.
- Fonte desta tela: ajuda 225 e status-porte.csv; não há doc técnico de regras, então os casos seguem a ajuda.
225-01 Grade e período
- Abra a 225.
Cada linha é uma conciliação por conta + data, com o saldo digitado do extrato. Período padrão: últimos 15 dias.
Compare com as datas conciliadas em financeiro_baixas/financeiro_lancamento_banco.
225-02 Nova conciliação: Abrir não grava
- Novo, escolha Data e Conta bancária, clique Abrir.
- Feche sem Gravar.
Abrir não cria registro; a conciliação só passa a existir quando gravada com pelo menos um movimento marcado.
Nenhuma linha de conciliação nova para a conta/data.
225-03 Marcar movimentos e conferir o rodapé
- Digite o saldo do extrato.
- Marque movimentos clicando na linha ou na caixa.
- Observe saldo do sistema, não compensados, compensados, extrato calculado e diferença.
- Gravar.
A diferença fica verde quando bate (menor que meio centavo) e vermelha quando não bate. Ao gravar, a conciliação sai da lista de pendentes.
SELECT data_conciliacao FROM financeiro_baixas (ou lançamento) dos marcados.
225-04 Movimentos agrupados por cheque ou coletivo
- Marque uma baixa que pertence a um cheque agrupado ou a uma baixa coletiva.
Todos os movimentos do grupo são marcados juntos (compensam como um só no banco).
225-05 Movimento já conciliado em outra data
- Localize uma linha em cinza com data diferente na última coluna e tente clicar.
A linha não pode ser mexida nesta conciliação (pertence a outra data).
225-06 Marcar Todos nunca desmarca
- Marque alguns movimentos à mão e clique Marcar Todos.
Marca tudo o que ainda não está marcado e nunca desmarca nada.
225-07 Trava de data fechada
- Abra uma conciliação com data ≤ udf (data de fechamento contábil).
O Gravar fica desabilitado e a tela avisa "Data fechada".
SELECT udf FROM parametros WHERE filial_ativa = <filial>.
225-08 Regravar sem mexer
- Abra uma conciliação existente e clique Gravar sem alterar marcas nem saldo.
As marcas e as datas de conciliação ficam iguais.
SELECT data_conciliacao dos movimentos antes e depois.
225-09 Excluir conciliação (só Brasil)
- No Brasil, selecione uma conciliação e Excluir.
- Fora do Brasil tente o mesmo.
Brasil: a conciliação daquele dia/conta é apagada e os movimentos voltam a não compensados. Fora do Brasil a exclusão não é permitida.
data_conciliacao dos movimentos volta a nula.
225-10 Digitalizar
- Anexe a imagem do extrato.
O anexo fica ligado à conciliação.
226 — Empréstimos (Captação)
12 casosCaminho no menu: 2-Lançamentos › 1-Financeiros › 6-Empréstimos (Captação) (226)
Doc técnico: validacoes-emprestimos-226-22r.html · Ajuda: botão ? da janela
- Banco/financeira cadastrado como emitente, conta bancária, tipo de faturamento de empréstimo cadastrado.
- Um empréstimo livre, um com parcela já baixada por outra tela e um já conferido pela contabilidade.
- Fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial>.
- Observação: a seção H do doc técnico (cronograma) está desatualizada: o gerador de parcelas já foi portado (reconferido em 04/10/2026, sem mudança). Decisão do usuário em 04/10: Tipo Título nasce DUP, Tipo Captação BAN e a grade exige período (90 dias); não são defeitos.
226-01 Grade: período e Multi Filial
- Abra a 226.
- Mude o período e ligue Multi Filial.
Últimos 90 dias por padrão. Não lista os empréstimos FIDC/Fomento (esses são da 22R). Colunas incluem documento, emitente, conta, moeda, bruto, líquido, Cont/Asiento e conferido.
Compare com financeiro de empréstimo no período.
226-02 Incluir e Gerar o cronograma
- Incluir.
- Data, Data de entrada, Documento, Tipo de captação (Bancário), Tipo de título, Tipo de taxa, Emitente, Conta, Moeda, Tipo de faturamento, % juros, Valor bruto, Número de parcelas, Prazo, Data da 1ª parcela e Data final.
- Clique Gerar e confira a grade de parcelas; Gravar.
Gerar monta o cronograma (taxa mensal sobre 30 dias; anual sobre 360 no Brasil e tipos 1162/1163, senão 365); nada é gravado até o Gravar. Gravar cria o empréstimo e as parcelas viram títulos a pagar na 221, com juros e IVA. Rodapé soma bruto, líquido e total.
SELECT * FROM financeiro_emissao dos títulos do empréstimo (idfaturamento = <id>, idtipo_faturamento = <tipo>).
226-03 Campos obrigatórios e valor zero
- Gravar sem Data, sem Emitente, sem Conta bancária, sem Data final, com Valor bruto/líquido zerado.
"Campo [Data] em branco.", "Campo [Emitente] em branco.", "Campo [Conta Bancária] em branco.", "Informe o valor bruto e o total de crédito líquido - não é possível gravar com valor zerado." e Data final em branco é recusada na tela.
Nada gravado.
226-04 Trava de mês fechado
- Incluir empréstimo com data ≤ udf.
"Período já fechado: a data do empréstimo precisa ser posterior a <udf>."
SELECT udf FROM parametros WHERE filial_ativa = <filial>.
226-05 Empréstimo de Terceiros só aceita cheque
- Tipo de captação = Terceiros e Tipo de título diferente de Cheque.
A tela trava o campo com aviso; por fora o servidor recusa "Empréstimo de terceiros só aceita título CHQ (cheque)".
226-06 Grade de parcelas: editar o prazo (com e sem Livre)
- Sem Livre, edite o prazo de uma linha.
- Marque Livre e edite valores à mão.
Sem Livre: o servidor recalcula vencimento, juros, IVA e líquido da linha (e o saldo das seguintes quando "juros sobre saldo" está ligado). Com Livre: valores digitados, sem recálculo.
Totais do rodapé.
226-07 Caixas de marcar e Refinanciado
- Teste Valor captado última parcela, Juros sobre saldo, Soma IVA, Comissão desconto/financeira, Desconta IVA/juros e Refinanciado.
Cada caixa muda o cálculo como descrito na ajuda. Refinanciado pede o id do empréstimo refinanciado.
226-08 Alterar e regravar sem mexer
- Abra um empréstimo livre, altere uma parcela e grave.
- Abra outro e clique Gravar sem mexer.
Alterar apaga e refaz os títulos do empréstimo na mesma transação. Regravar sem mexer deixa valores iguais.
Compare os títulos em financeiro_emissao antes e depois.
226-09 Trava: já tem parcela baixada ou paga por outra tela
- Tente alterar um empréstimo cuja parcela (ou comissão) já foi baixada na 221 ou 222.
"Este empréstimo já tem parcela baixada - não é possível alterá-lo, porque regravar desfaria a baixa lançada por outra pessoa." Para baixa que não é automática a recusa lista as baixas encontradas.
financeiro_baixas dos títulos do empréstimo.
226-10 Trava: já conferido pela contabilidade; sem tipo de faturamento
- Tente alterar um empréstimo conferido.
- Tente alterar ou excluir um empréstimo antigo sem tipo de faturamento gravado.
"Não é possível alterar: o empréstimo já foi conferido na contabilidade." (sem escape por grupo). Sem tipo: "Empréstimo sem tipo de faturamento - não é possível regravar o financeiro com segurança." / "…desfazer o financeiro…"
226-11 Excluir empréstimo livre
- Excluir (janela travada) um empréstimo de teste sem baixa e confirme.
O empréstimo e os títulos dele somem (exclusão lógica). Valem as mesmas travas de mês fechado, baixada e conferida.
SELECT excluido FROM financeiro_emissao dos títulos.
226-12 Botões Imprimir, Tipo Fat., Digitalizar, Conciliação e Contab
- Imprimir > Demonstrativo (PDF) e planilha Tasas.
- Tipo Fat. em empréstimo gravado.
- Conciliação: grave a data.
- Contab: ligue e desligue.
Demonstrativo e planilha saem sem erro; Tipo Fat. troca o tipo de faturamento; Conciliação grava a data em que foi conciliado no banco; Contab liga/desliga a ida para a contabilidade.
228 — Adiantamentos/Prestação de Contas
16 casosCaminho no menu: 2-Lançamentos › 1-Financeiros › 8-Adiantamentos/Prestação de Contas (228)
Doc técnico: validacoes-adiantamento-228.html · Ajuda: botão ? da janela
- Emitente que recebe adiantamento (funcionário/prestador), conta de saída (banco ou caixa) e conta de entrada na mesma moeda, centro de custo de quitação da filial e tipo de faturamento da prestação cadastrados.
- Um adiantamento pendente (sem data de quitação) e um quitado; um com baixa feita por outra tela.
- No Paraguai: tipo de documento e timbrado para as despesas; chequeira na conta de saída para a Impressão cheque (tenant fjfrigo_concepcion).
- Fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial>.
228-01 Grade
- Abra a 228 (período opcional).
Lista data, emitente, moeda, valor, quitação ("Pendente" enquanto não prestou contas), valor de faturas, devolvido, saldo e as contas de saída/entrada com o número do cheque.
COUNT em adiantamento da filial.
228-02 Novo adiantamento
- Novo Adiantamento.
- Emitente, Data, Conta de saída (a moeda vem sozinha), Conta de entrada, Valor, Histórico (e cheque com número, tipo e Nominal, se for o caso).
- Gravar.
O adiantamento aparece com "Pendente" na Quitação. Grava o registro e o movimento bancário da saída e da entrada.
SELECT * FROM financeiro_lancamento_banco WHERE idadiantamento = <id> (saída 113 e entrada 114).
228-03 Campos obrigatórios do adiantamento
- Tente gravar com Valor zero, sem Data, sem conta de saída, sem conta de entrada e sem Emitente.
"Valor incorreto.", "Data incorreta.", "Conta de saída incorreta.", "Conta de entrada incorreta.", "Emitente incorreto." Conta de saída sem moeda: "Conta de saída sem moeda cadastrada."
Nada gravado.
228-04 Moeda e câmbio
- Escolha conta de entrada de moeda diferente da conta de saída.
- Use moeda estrangeira sem cotação do dia.
"Moeda da conta de entrada diferente da moeda do lançamento." e "Sem cotação da moeda X em AAAA-MM-DD - cadastre o cambio do dia antes de gravar."
moeda_valores da data.
228-05 Trava do adiantamento em aberto (7 dias)
- Para um emitente com adiantamento sem quitação de mais de 7 dias na mesma moeda, lance outro com data diferente.
- Repita no mesmo dia do aberto, em outra moeda, e com o anterior já quitado.
Primeira: "Existe adiantamento sem prestação de contas [<id>], de AAAA-MM-DD." Não dispara: mesmo dia, aberto há 7 dias ou menos, outra moeda, já quitado.
Coluna Quitação do adiantamento anterior.
228-06 Trava de mês fechado nas três etapas
- Novo Adiantamento com data ≤ udf.
- Gravar Quitação com data de prestação ≤ udf.
- Excluir adiantamento cuja data de adiantamento ≤ udf.
"Período já fechado: a data do adiantamento precisa ser posterior a <udf>." e "…a data da prestação precisa ser posterior a <udf>." Na exclusão vale a data do adiantamento, não a da quitação. O botão Gravar Quitação fica desabilitado.
SELECT udf FROM parametros WHERE filial_ativa = <filial>.
228-07 Prestação de contas: despesas e saldo
- Prestação de Contas (ou duplo clique na linha).
- Confira Data de quitação, Conta de quitação (nasce com a conta de entrada) e Centro de custo de quitação (nasce com o tipo do adiantamento).
- Nova Despesa: fornecedor, data, tipo de documento, número, timbrado, moeda, valor e, no Paraguai, bases de IVA e imposto.
- Total Devolvido se sobrou; Gravar Quitação.
Saldo = -adiantado + faturas + devolvido, deve fechar em zero quando tudo foi explicado. A grade passa a mostrar a data da quitação e Valor de Faturas/Devolvido/Saldo. Sobra não devolvida ou gasto por inteiro grava saldo sem estourar (saldo com sinal negativo foi corrigido em 17/09).
SELECT * FROM adiantamento (valor, valor_faturas, valor_devolvido) e financeiro_emissao das despesas.
228-08 % IVA da despesa travado e bases no Paraguai/Bolívia
- Na janela de despesa, tente editar o % IVA (10%/5%).
- Na Bolívia confira Base IVA5 e Ret. IVA.
% IVA vem travado (client e server). Na Bolívia Base IVA5 e Ret. IVA também travam. Valor devolvido negativo é recusado.
228-09 Centro de custo sem lançamento manual e cadastros faltando
- Lance despesa com centro de custo que não aceita lançamento manual.
- Se possível, em filial sem centro de quitação ou sem tipo de faturamento da prestação, grave a quitação.
"Esse centro de custo nao aceita lancamentos manuais."; "Sem centro de custo de quitacao."; "Nenhum tipo de faturamento marcado como … - sem ele nao da pra lancar a prestacao no financeiro." (é cadastro, não lançamento).
228-10 Regravar sem mexer
- Abra um adiantamento pendente e clique Gravar sem alterar.
- Abra uma prestação já gravada e clique Gravar Quitação sem alterar.
Valores, contas e datas ficam iguais; as faturas da prestação são apagadas e regravadas com o mesmo conteúdo.
SELECT * das tabelas do adiantamento antes e depois.
228-11 Excluir adiantamento: movimento inteiro
- Excluir um adiantamento de teste com prestação gravada e confirme.
Some o adiantamento inteiro: cabeçalho, lançamentos bancários, baixas, títulos, faturas e registro contábil. Não é só o cabeçalho.
SELECT excluido FROM financeiro_lancamento_banco WHERE idadiantamento = <id>; financeiro_emissao dos títulos.
228-12 Excluir com baixa de fora
- Baixe por outra tela (221/222) um título gerado pela prestação e tente excluir o adiantamento.
Recusa listando as baixas encontradas, para não desfazer pagamento registrado noutro lugar.
financeiro_baixas do título.
228-13 Transferência vinculada ausente (registro antigo)
- Em adiantamento antigo gravado sem vínculo, abra a transferência do adiantamento.
"Esse adiantamento não tem transferência vinculada." ou "Transferência do adiantamento não encontrada."
228-14 Impressão cheque Mudou em 04/10/2026
- Selecione um adiantamento pago com cheque e abra Imprimir > Impressão cheque.
- Repita num adiantamento sem lançamento bancário.
Abre o cheque para o formulário de cheque com o valor do adiantamento (não o do lançamento), nominal e datas nas posições do modelo da chequeira da conta de saída. Sem lançamento bancário: recusa com 400. O legado não exige número de cheque (botão habilitado com cheque 0).
Confira valor por extenso, nominal, datas e modelo da chequeira (ex.: modelo 014).
228-15 Imprimir: cópia, recibo, carta e Demonstrativo
- Imprimir > Cópia do cheque, Recibo do cheque, Carta de transferência e Demonstrativo (rendição em PDF).
Os impressos saem sem erro. A carta chega à transferência pelo vínculo do adiantamento (o legado procurava a transferência pelo id errado).
228-16 Digitalizar e XLS
- Anexe um comprovante.
- XLS da grade filtrada.
Anexo ligado ao adiantamento; planilha com a grade filtrada.
22A — Facturas Avulsas
13 casosCaminho no menu: 2-Lançamentos › 1-Financeiros › A-Facturas Avulsas (22A)
Doc técnico: validacoes-fatura-avulsa-22a.html · Ajuda: botão ? da janela
- Fornecedor com títulos abertos na mesma moeda, próximos à data da fatura; moeda estrangeira com cotação e a moeda local.
- Paraguai/Bolívia: tipo de documento do país, timbrado do emitente e filial com controla_timbrado. Central (Brasil) não passa por timbrado nem por gravarIVA (codicfj 004): esses casos exigem tenant paraguaio.
- Fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial>.
- Observação: o doc técnico diz que a avulsa não confere U.D.F.; o código confere (só na 22A, não nas variantes 254/255). Vale o código.
22A-01 Grade: período e documento
- Abra a 22A, filtre por período e por Documento.
Últimos 30 dias por padrão. Colunas: documento, tipo, emissão, vencimento, emitente, moeda, valor, retenção e asiento. Filtro e ordenação usam a data da fatura.
COUNT em faturamento avulso no período.
22A-02 Incluir factura e carregar títulos
- Incluir.
- Fornecedor (e Emitente da Fatura se diferente), Documento, Data de emissão, Data da fatura, Vencimento, Valor, Moeda, Tipo de documento.
- Em Títulos, Carregar dados e marque os títulos do rateio.
- Gravar.
A factura aparece na grade; o resumo por centro de custo mostra a soma dos títulos marcados. A fatura e seus títulos são uma transação só.
Registro da fatura e títulos vinculados.
22A-03 Câmbio na moeda local e estrangeira
- Escolha a moeda local; depois uma moeda estrangeira com e sem cotação do dia.
Moeda local: câmbio travado em 1. Estrangeira: o câmbio vem da cotação. Sem câmbio por fora da tela: "Sem tipo de câmbio."; sem cotação cadastrada o servidor também recusa.
moeda_valores.
22A-04 Campos obrigatórios
- Gravar sem Fornecedor, sem Data de emissão, sem Data da fatura, sem Documento, sem Moeda e com Valor zero.
A tela exige todos. Servidor: "Data incorreta." e "Valor da fatura incorreto."
22A-05 Mês fechado (só na 22A)
- Gravar fatura avulsa com Data (do asiento) ≤ udf.
"Essa data já está fechada." Não vale nas variantes 254/255.
SELECT udf FROM parametros WHERE filial_ativa = <filial>.
22A-06 Retém IVA e seção de IVA (Paraguai/Bolívia)
- Marque Retém IVA, preencha base 10%, % retenção 10%, base 5%, % retenção 5%.
Valores de IVA e base isenta são calculados sozinhos; título de retenção de IVA é gerado conforme parâmetros da filial. No Brasil a seção fica zerada.
Títulos de retenção gerados.
22A-07 Timbrado do emitente (Paraguai)
- Em filial com controla_timbrado, grave com documento fora da faixa do timbrado do emitente.
Recusa por timbrado (não encontrado/vencido para o emitente).
Tabela emitente_timbrado.
22A-08 Dados Contáb. (Paraguai)
- Abra Dados Contáb. e grave os códigos do Livro 120 e o tipo de operação para exportador.
Os dados contábeis ficam gravados e a factura entra nos livros fiscais conforme eles.
22A-09 Sugestão de classificação
- No Incluir, escolha um fornecedor que já teve fatura nos últimos 2 anos.
Preenche o que está no valor inicial: emitente da fatura, moeda, tipo de documento (o mais usado), timbrado, retém IVA, percentuais. Faixa mostra a fatura de origem; o digitado nunca é trocado.
22A-10 Vínculo com faturamento que já tem pagamento
- Grave factura vinculada a faturamento que já tem pagamento.
A fatura entra sem lançar o título financeiro; o aviso "Existe um pagamento referente a esse faturamento" não é recusa.
22A-11 Alterar e regravar sem mexer
- Altere o documento de uma factura e grave.
- Abra outra e grave sem mexer.
Alteração aparece; regravar sem mexer não muda valores, títulos nem resumo de centro de custo. Factura já excluída: "Este lançamento foi excluído".
22A-12 Excluir factura
- Exclua uma factura de teste; tente também uma com título baixado.
Exclusão em cascata para o financeiro e a contabilidade; com título baixado a exclusão é recusada.
financeiro_emissao dos títulos da fatura.
22A-13 Digitalizar e Imprimir
- Anexe a imagem; clique no ícone de imprimir da grade.
Anexo gravado. Não há demonstrativo próprio: o impresso é a grade filtrada.
22B — Recibos
10 casosCaminho no menu: 2-Lançamentos › 1-Financeiros › B-Recibos (22B)
Doc técnico: validacoes-recibos-22b.html · Ajuda: botão ? da janela
- financeiro_recibo não tem movimento em central: é tela dos tenants do Paraguai (fjfrigo_concepcion). O recibo em português só se vê com codicfj 004 (use um login de filial brasileira).
- Emitente cliente com títulos a receber, incluindo uma baixa coletiva; um título já marcado em outro recibo; dados de cheque (número, vencimento, valor, titular, conta, banco).
- Esta tela não tem regra nomeada a conceder no Acesso dos Grupos (444).
22B-01 Grade e busca
- Abra a 22B e filtre período e busca livre.
Últimos 30 dias. Colunas: data, emitente, tipo (A cobrar ou Cobrado) e valor.
22B-02 Incluir recibo com cheque, dinheiro e transferência
- Incluir.
- Emitente, Data, Tipo (Cobrado), período de baixa inicial/final.
- Carregar Dados; na seção Cheques inclua um cheque.
- Preencha Dinheiro, Transferência, Descontos e Retenção.
- Marque os títulos cobertos; Gravar.
O recibo aparece na grade; o Total Geral do rodapé (cheques + dinheiro + transferência + retenção) bate com o digitado.
SELECT * FROM financeiro_recibo WHERE id = <id>; financeiro_recibo_cheque e financeiro_recibo_fe.
22B-03 Baixa coletiva marca junto
- Marque um título que veio de uma baixa coletiva.
Os outros títulos da mesma baixa coletiva ficam marcados juntos.
22B-04 Coluna Uso: título em outro recibo
- Observe um título já marcado em outro recibo.
Continua na lista, com a coluna Uso avisando; normalmente não deve ser marcado de novo.
22B-05 Obrigatórios e valor zero
- Gravar sem Emitente e sem Data.
- Gravar com cheques, dinheiro e transferência somando zero e só retenção ou desconto.
"Campo obrigatório." na tela. Servidor: "Data incorrecta!" e "Valor incorreto!" (e a tela: "Informe ao menos um valor em cheque, dinheiro ou transferência — a retenção sozinha não forma o recibo.") Retenção e desconto não contam como valor recebido.
Nada gravado.
22B-06 Alterar preserva vínculos que a tela não mostra
- Abra um recibo com título já baixado por inteiro ou fora do período, grave sem mexer.
- Clique Carregar Dados e desmarque de propósito.
Regravar não desfaz os vínculos invisíveis (o legado apagava e reinseria só a grade). Alterar é em transação: cabeçalho, cheques e títulos juntos ou nenhum.
financeiro_recibo_fe antes e depois.
22B-07 Regravar sem mexer
- Abra um recibo e Gravar sem alterar.
Cheques, valores e vínculos ficam iguais.
SELECT das três tabelas do recibo antes e depois.
22B-08 Excluir recibo
- Excluir (a janela abre com o recibo inteiro, travada) e confirme.
- Tente excluir um recibo com título já vinculado/conferido.
Exclusão lógica (excluido = 'T'); o recibo some da grade. Mesma trava das demais telas para título vinculado/conferido. A janela diz "Confira os dados abaixo. Ao confirmar, o registro é apagado e não há como desfazer."
SELECT excluido FROM financeiro_recibo WHERE id = <id>.
22B-09 Imprimir: recibo em espanhol (Paraguai/Bolívia/Chile) Mudou em 04/10/2026
- Em tenant com codicfj diferente de 004, gere o PDF do recibo com cheque, transferência e retenção.
Rótulos em espanhol (Fecha, Recibimos de :, RUC:, Valor:, la suma de Guaranies/Dólares:, Concepto: Referente al cobro de las facturas, Total titulos, Descuentos, Cobrado, Retenciones, Neto) e valor por extenso em espanhol. Descuentos e Retenciones saem negativos. Grade de formas de cobro com Efetivo, Transferencia e uma linha por cheque; títulos em duas colunas; moeda do primeiro título; duas assinaturas.
Compare com o recibo equivalente do legado.
22B-10 Imprimir: recibo em português (Brasil, codicfj 004) Mudou em 04/10/2026
- Com login brasileiro (codicfj 004), gere o PDF de um recibo.
Rótulos em português (Data, Página, CNPJ…) e valor por extenso em português; mesmo conteúdo do recibo em espanhol.
Compare com o PDF em espanhol do mesmo recibo.
22F — Emissão Retenção IVA
8 casosCaminho no menu: 2-Lançamentos › 2-Financeiros › Emissão Retenção IVA (22F)
Doc técnico: validacoes-emissao-retencao-22f.html · Ajuda: botão ? da janela
- Tela só do Paraguai (fjfrigo_concepcion): nos outros países não tem uso.
- Documentos de compra com IVA de várias origens (compra de carne, compra de almoxarifado, despacho, fatura avulsa, compra de gado, comissão, título lançado no financeiro) e RUC do fornecedor com dígito depois do hífen.
- Um documento sem % de retenção cadastrado, um com RUC sem hífen, um com retenção já gerada e um CSV de retorno do Tesaka (modelo 1 com cabeçalho "estado" ou modelo 2 com "sep=,").
- Esta tela não tem regra nomeada a conceder no Acesso dos Grupos (444).
- Fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial>.
22F-01 Grade, Origem e filtros
- Abra a 22F, período de/até.
- Teste o combo Origem (Todas e cada fonte), Documento, Somente com retenção e Todas as filiais.
Lista todo documento de compra com IVA do período. Documento com tipo de comprovante nota de crédito, nota de débito ou sem comprovante não aparece. Cada linha: RUC, moeda, bases 10% e 5%, IVA, renda, total, número da retenção e asiento se já gerada.
Compare com a origem (compra de carne, almoxarifado etc.).
22F-02 Gerar retenção e arquivo Tesaka
- Marque documentos sem retenção e clique Gerar (n).
Aviso com quantos documentos entraram no arquivo e quantas retenções novas foram gravadas; baixa o arquivo de texto (ex.: TK.txt). Bases e percentuais saem da origem.
SELECT * FROM retencao_iva WHERE documento = '<doc>'.
22F-03 Recusas ao gerar
- Clique Gerar sem marcar linha.
- Marque documento sem % de retenção (10%, 5% e renta somam zero).
- Marque documento com RUC sem hífen.
"Nenhum documento foi selecionado."; "Fat. [<doc>] Tabela [<tabela>] Id [<id>] sem % de retenção 10% e 5% - não é permitido prosseguir."; "[<ruc>] Sin RUC (o RUC precisa ter o dígito depois do hífen) - não é permitido prosseguir." Documento removido da origem: "Documento <doc> nao foi encontrado para gerar o arquivo."
Cadastro do emitente (15) e do percentual de retenção.
22F-04 Gerar de novo não duplica
- Marque documento que já tem retenção e Gerar.
Entra no arquivo como reemitido (a mensagem lista), sem criar outra linha em retencao_iva.
SELECT COUNT(*) FROM retencao_iva WHERE documento = '<doc>' (não aumenta).
22F-05 Importar retorno da SET
- Importar retorno > escolha o CSV > Importar.
A janela mostra quantas linhas foram aplicadas; as que não casam por RUC + factura vão para "Não encontradas". O número oficial vai para o documento de origem só na primeira importação; retenção que volta com outro número renumera e o asiento do número anterior sai.
retencao_iva.numero e o título de origem carimbado.
22F-06 Retorno inválido
- Importe arquivo vazio.
- Importe arquivo sem o cabeçalho esperado.
- Importe CSV com data inválida.
- Importe retorno de retenção cuja anterior já foi conferida pela contabilidade.
"Arquivo invalido! O arquivo está vazio."; "Arquivo invalido! A primeira linha tem de ser o cabeçalho "estado" ou "sep=,": id,descricao"; "Data inválida […] na retenção … (factura …)."; "Actual […] Retencion anterior […] já conferida pela contabilidade ! (asiento …)" (o arquivo inteiro é recusado antes de gravar).
22F-07 Excluir retenção: mês fechado, sem número e conferida
- Marque retenção numerada em mês fechado e Excluir.
- Marque retenção ainda sem número do Tesaka.
- Marque retenção com asiento ri conferido.
- Exclua uma retenção numerada e livre.
"A retenção do documento <doc> é de AAAA-MM-DD, em mês já fechado (<udf>)."; "A retenção do documento <doc> ainda não tem número do Tesaka - só se exclui retenção já numerada."; "Retenção <nº> já conferida pela contabilidade (asiento N)." Livre: sai o asiento ri não conferido e todas as linhas com o mesmo número; a exclusão fica registrada.
SELECT parametros.udf; retencao_iva.excluido.
22F-08 Atualizar e XLS
- Atualizar e XLS.
Atualizar recarrega com os filtros; o XLS sai com cada coluna no lugar certo (cabeçalho e valores alinhados, Asiento preenchido).
Abra a planilha.
22G — Ajustes Retenção IVA
6 casosCaminho no menu: 2-Lançamentos › 2-Financeiros › Ajustes Retenção IVA (22G)
Doc técnico: validacoes-ajustes-retencao-22g.html · Ajuda: botão ? da janela
- Tela só do Paraguai (fjfrigo_concepcion).
- Retenções geradas pela 22F (numeradas e sem número), uma com asiento conferido e uma em mês fechado.
- Esta tela não tem regra nomeada a conceder no Acesso dos Grupos (444).
- Fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial>.
22G-01 Grade, Tabela e busca por documento
- Abra a 22G, período; troque o combo Tabela (Compra Carne, Almox. Compra, Financeiro Emissão, Fatura Avulsa, Compra Gado, Todas); busque por Documento.
O combo filtra a grade pela origem; colunas corrigidas (base, % e valor retido "c") populadas; % Renta nasce 0,00.
retencao_iva por tabela de origem.
22G-02 Incluir retenção à mão
- Incluir.
- Fornecedor, Data retenção, Data fatura, Documento, Nº Retenção, Moeda, bases 10%, 5%, isenta, percentuais e % Renta.
- Gravar.
A retenção aparece na grade com IVA e renda retidos recalculados pelo servidor a partir de bases e percentuais (o valor final digitado não vale). Casas decimais: zero na moeda de id 111, duas nas demais.
SELECT * FROM retencao_iva WHERE documento = '<doc>'.
22G-03 Campos obrigatórios
- Gravar sem Data, sem Emitente e sem Moeda.
"Campo obrigatório." na tela; servidor: "data: Data incorrecta!", "idEmitente: Informe o emitente.", "idMoeda: Informe a moeda."
22G-04 Alterar bases e percentuais; regravar sem mexer
- Altere uma base numa retenção gerada pela 22F e grave.
- Abra outra e grave sem mexer.
Valores retidos são recalculados (renta em todos os casos). Regravar sem mexer não muda nada.
retencao_iva antes e depois.
22G-05 Excluir retenção
- Excluir (janela travada, botão trocado para confirmar) retenção numerada e livre.
- Tente excluir retenção sem número.
- Tente com asiento conferido.
- Tente com data ≤ udf.
Livre: some, junto com o asiento ri não conferido e todas as linhas com o mesmo número, em transação. Recusas: "A retenção <nº> é de AAAA-MM-DD, em mês já fechado (<udf>)."; "A retenção ainda não tem número do Tesaka - só se exclui retenção já numerada." (corrigido em 11/09: antes marcava como excluídas todas as sem número); "Retenção já conferida pela contabilidade - não pode ser excluída."
SELECT excluido FROM retencao_iva WHERE numero = '<nº>'.
22G-06 Impressão da grade
- Clique Imprimir (PDF e Planilha).
Gera o arquivo com a grade filtrada sem erro (POST /cadastro/impressao-grade).
Abra o arquivo.
22H — Cobrança Exportação
12 casosCaminho no menu: 2-Lançamentos › 2-Financeiros › Cobrança Exportação (22H)
Doc técnico: validacoes-cobranca-exportacao-22h.html · Ajuda: botão ? da janela
- Tela principalmente do Paraguai: financeiro_exportacao não tem movimento em central. Use fjfrigo_concepcion (abre em dólar e centro 113 como o legado) e, para o Brasil, um tenant sem a chave configurada.
- Cliente com "Caixa Exp." cadastrado e em moeda igual à da conta caixa; conta bancária de entrada; contratos de exportação em aberto e faturas de venda de exportação em aberto na mesma moeda; cotação da moeda no dia.
- Config. Globais (41), aba Financeiro, chave IDCENTRO_CUSTO_TAXA_COBRANCA_EXTERIOR (para testar a sugestão por configuração, com e sem a chave).
- Uma cobrança já contabilizada e conferida (asiento cex).
- Esta tela não tem regra nomeada a conceder no Acesso dos Grupos (444).
- Fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial>.
22H-01 Grade
- Abra a 22H e filtre por período.
Lista cliente, moeda, valor bruto, taxa exterior, contrato, fatura, banco de entrada, Cont (Sim/Não) e asiento.
COUNT em financeiro_exportacao no período.
22H-02 Moeda e centro de custo das taxas já sugeridos Mudou em 04/10/2026
- Incluir uma cobrança nova e olhe Moeda e Centro de custo taxas.
- Troque a chave IDCENTRO_CUSTO_TAXA_COBRANCA_EXTERIOR no 41 e abra Incluir de novo.
- Abra uma cobrança antiga gravada sem centro.
Moeda segue o país (Brasil: moeda local; Paraguai: dólar; a chave de moeda saiu), e pode ser trocada. O centro vem da chave no 41; sem a chave vale o centro padrão do país se ele existir na empresa (senão fica em branco). Cobranças antigas sem centro abrem com o centro sugerido. Em central o 1176 não existe: abre em R$ com o centro vazio.
SELECT chave, valor FROM system_config WHERE chave = 'IDCENTRO_CUSTO_TAXA_COBRANCA_EXTERIOR'.
22H-03 Incluir cobrança distribuída em faturas
- Incluir: Data, Cliente, Banco de entrada, Moeda, Valor bruto.
- Na lista Distribuição marque faturas e informe o valor aplicado (o sistema sugere a parcela).
- Gravar.
A cobrança aparece na grade; cada título marcado mostra o valor recebido baixado. O sistema lança sozinho a transferência para a conta de entrada e as baixas.
financeiro_exportacao e _dist; financeiro_baixas e lançamento de transferência ligados.
22H-04 Adiantamento contra contrato e recebimento em aberto
- Marque um contrato na lista de adiantamento e informe quanto entrou (o saldo do contrato é sugerido).
- Deixe parte do valor bruto sem destino e grave.
Grava o adiantamento por contrato. Parte do bruto pode ficar em aberto para aplicar numa alteração posterior desta mesma cobrança.
financeiro_exportacao_dist.
22H-05 Grade Resumo: recebimento, aplicado, Rec. Atual e saldo Mudou em 04/10/2026
- Com cliente e moeda escolhidos, observe o Resumo (uma linha por contrato).
- Marque um contrato e informe o valor; marque uma fatura do contrato; desmarque.
- Troque o cliente e Recarregue.
Recebimento = soma das cobranças do contrato; Aplicado = quanto já foi baixado em faturas; Rec. Atual começa em zero, muda ao marcar e informar o valor (substitui, não soma) e volta a zero ao desmarcar; Saldo = Recebimento − Aplicado + Rec. Atual. O Resumo é refeito ao abrir, ao trocar o cliente e ao recarregar. Conferido em homologação no contrato 751/2026: Recebimento 83.475,70, Aplicado 41.175,35, Saldo 42.300,35.
SELECT das cobranças do contrato; baixas das faturas aplicadas.
22H-06 Taxas: centro de custo obrigatório e título de taxa
- Preencha Taxa exterior e/ou Taxa local sem Centro de custo taxas.
- Informe o centro e grave.
Taxa sem centro é recusada (C.Custo Taxas obrigatório). Com centro, é gerado título a pagar à parte para a taxa.
Título a pagar da taxa em financeiro_emissao.
22H-07 Recusas ao gravar
- Tente gravar sem Data, Cliente ou Moeda.
- Sem conta de entrada.
- Valor negativo numa fatura ou adiantamento da distribuição.
- Fatura em moeda diferente da do recebimento.
- Nada distribuído.
- Moeda sem cotação no dia.
- Cliente sem Caixa Exp. ou com conta caixa de outra moeda.
- Valor numa fatura que não é de contrato de exportação.
"Campo obrigatório." (tela); "Sem conta de entrada !"; "Valor inválido !"; "Moneda del recebimiento es diferente de la factura !"; "Nada eligido !"; "Sem cotacao da moeda para AAAA-MM-DD - cadastre o cambio do dia antes de gravar."; "Cliente sem conta caixa de exportacao (campo "Caixa Exp." no cadastro do emitente)."; "A moeda do recebimento e diferente da moeda da conta caixa do cliente."; "Titulo <id> nao esta ligado a um contrato de exportacao - nao e possivel distribuir valor nele." (várias frases vêm em português no lugar do espanhol do legado).
Nada gravado.
22H-08 Trava de mês fechado
- Gravar cobrança com data ≤ udf.
- Excluir cobrança com data ≤ udf.
"Período já fechado: a data precisa ser posterior a <udf>." na gravação e na exclusão.
SELECT udf FROM parametros WHERE filial_ativa = <filial>.
22H-09 Já contabilizada e conferida
- Abra cobrança cujo asiento cex está conferido; tente alterar e excluir.
A tela abre só para consulta (Gravar desligado). "Lançamento já contabilizado e conferido — alteração não permitida." e "…exclusão não permitida."
Contabilidade (251) pelo número do asiento.
22H-10 Alterar recarrega as listas e preserva conciliação
- Abra uma cobrança e Alterar; confira as duas listas marcadas.
- Regrave sem mexer.
As listas de adiantamento e distribuição são recarregadas do zero, com o que já está marcado aparecendo marcado. A regravação preserva a conciliação das pernas da transferência (o legado recria sem ela). Cap de pendente na regravação exclui a própria baixa. Regravar sem mexer não muda nada.
Baixas, transferência e título de taxa antes e depois.
22H-11 Excluir desfaz a cobrança inteira
- Exclua uma cobrança de teste com baixas, taxa e transferência.
Somem a cobrança, as baixas dos títulos, a transferência bancária, o título de taxa e o asiento; os títulos voltam ao pendente anterior.
financeiro_baixas e título de taxa excluidos = 'T'.
22H-12 Digitalizar e XLS
- Anexe comprovante (SWIFT, extrato); clique XLS.
Anexo gravado; planilha com a grade do período.
22L — Exportar Pagamentos Bancos
7 casosCaminho no menu: 2-Lançamentos › 2-Financeiros › Exportar Pagamentos para Bancos (22L)
Doc técnico: validacoes-remessa-pagamentos-22l.html · Ajuda: botão ? da janela
- Tela principalmente do Brasil: remessa só para Santander (033) e Sicoob (756). Conta bancária com convênio de pagamento e baixas a pagar do tipo PIX ou Transferência (boleto sai pela 22M).
- Regra de acesso EXPPAG (cadastrada em 17/09): um usuário sem ela e um com ela (master passa).
- Um arquivo de retorno do banco para o caso de importar retorno.
- Observação: o doc técnico diz que fora do Brasil a planilha não foi portada; ela foi portada em 14/09 (gerarPY) e é o que a ajuda descreve.
22L-01 Acesso: regra EXPPAG
- Abra a 22L com usuário sem a regra EXPPAG e depois com ela.
Sem a regra a tela avisa para pedir a permissão; com ela (ou master) abre normalmente.
Acesso dos Grupos (444) / usuário (443).
22L-02 Atualizar a lista e conta obrigatória
- Atualizar sem Conta da baixa.
- Escolha a conta, ajuste De/Até, marque ou não Com retorno e Atualizar.
Sem conta: "Informe a conta bancária da baixa" (servidor: "Campo [Conta Bancária] em branco!"). Com conta: grade só com PIX ou Transferência; pagamentos do mesmo lote de cheque, ou do mesmo documento/parcela/fornecedor, aparecem somados numa linha. Com retorno mostra a ocorrência de retorno anterior.
Some as baixas do mesmo documento/parcela e compare com a linha.
22L-03 Gerar remessa (Santander/Sicoob)
- Marque linhas (ou Marcar/desmarcar todos).
- Gerar remessa e confirme a quantidade.
O arquivo baixa automaticamente; aviso com o nome. As baixas incluídas ficam marcadas com o número do lote. O valor vem do banco de dados na hora (a tela só manda quais foram marcadas). A numeração da conta avança e nunca é reaproveitada, mesmo se a geração falhar depois.
SELECT * FROM remessa_pagamentos do lote gerado.
22L-04 Gerar remessa: recusas
- Gerar sem marcar nada.
- Conta de outro banco (ex.: 341).
- Conta sem convênio de pagamento.
- Favorecido sem banco válido.
"Marque ao menos um pagamento para gerar a remessa." (ou "…um título…"/"Sem pagamentos selecionados."); "Banco 341 não homologado para remessa de pagamento — só Santander (033) e Sicoob (756)."; "Banco sem código de convênio de pagamento. Corrija e gere nova remessa."; "Banco de crédito inválido [...] no título <doc>. Corrija o cadastro e gere nova remessa."
Conta bancária (173) e dados bancários do emitente (15).
22L-05 Fora do Brasil: planilha
- No tenant paraguaio, Gerar.
Não gera arquivo de banco: baixa a planilha "Exportación de Datos de Pagos" com os mesmos pagamentos.
Abra a planilha.
22L-06 Importar retorno
- Importar retorno e escolha um ou mais arquivos.
- Importe sem escolher arquivo.
Aviso com quantos registros foram lidos e importados e os ignorados. Sem arquivo: "Escolha ao menos um arquivo de retorno." A linha enviada e a recebida ficam gravadas em cada pagamento.
Coluna Ocorrência da grade com Com retorno ligado.
22L-07 Com retorno: baixa isolada e grupo marcado
- Com Com retorno ligado, marque só a segunda baixa de um grupo (mesmo documento/parcela) e gere.
O pagamento do grupo inteiro entra na remessa (o grupo entra se qualquer baixa dele foi marcada; correção de 17/09).
Linha na remessa para o grupo.
22M — Central de Boletos
9 casosCaminho no menu: 2-Lançamentos › 2-Financeiros › Central de Boletos (22M)
Doc técnico: validacoes-central-boletos-22m.html · Ajuda: botão ? da janela
- Tela principalmente do Brasil. Conta bancária com código do banco preenchido e boletos emitidos pela venda (2333), um já registrado no banco (boleto_registrado = 'T'), um já enviado em remessa e um ainda sem remessa.
- Arquivo de retorno do banco para o caso de importar retorno. O 208 BTG não gera remessa de propósito.
- Observação: o doc técnico (seções A e F) ainda diz que remessa e retorno não foram portados; foram portados em 09/09/2026 (17 leiautes de remessa, 18 de retorno) e a ajuda os descreve. A ajuda diz que alterar vencimento de boleto registrado funciona; o código recusa (caso 22M-03).
22M-01 Grade, filtros e colunas
- Abra a 22M.
- Filtre período, Por vencimento e Conta bancária.
Colunas: emissão, vencimento, data da baixa, documento, cliente, valor, saldo, descontos, nosso número, Registrado, Recebido, arquivo de remessa, ocorrência e banco.
faturamento_venda_boleto.
22M-02 Alterar vencimento
- Selecione um boleto sem remessa e Alterar vencimento com data futura.
- Tente data retroativa.
- Tente data em branco.
A data é gravada no título (financeiro_emissao.data_vencimento) por trás do boleto; aviso "vencimento alterado". Retroativa: "Data inválida! O vencimento não pode ser retroativo." Em branco: "Informe a data de vencimento".
SELECT data_vencimento FROM financeiro_emissao do título.
22M-03 Boleto já registrado/enviado: vencimento não muda aqui
- Selecione boleto já registrado (ou já enviado em remessa) e Alterar vencimento.
"Boleto já enviado — a alteração tem de ser feita no aplicativo do banco." (código e doc técnico; a ajuda diz o contrário — registre o que ocorrer).
faturamento_venda_boleto.boleto_registrado.
22M-04 Excluir boleto (apaga o nosso número)
- Exclua um boleto sem remessa.
- Tente excluir um já enviado em remessa.
Livre: apaga o nosso número; o título continua e pode receber boleto novo ("nosso número apagado"). Enviado: "Boleto já enviado na remessa <nº> — a exclusão tem de ser feita no aplicativo do banco." Sem nosso número: "Boleto sem nosso número."
nosso_numero nulo no boleto; título intacto.
22M-05 Trocar carteira em lote
- Marque 2 ou mais boletos, escolha Carteira e Conta de destino (e Descontado) e grave.
- Tente sem seleção e sem conta.
"n boleto(s) alterado(s)". Recusas: "Marque ao menos um boleto." e "Informe a conta bancária."
Conta e carteira dos boletos.
22M-06 Várias linhas marcadas: Vencimento/Excluir/Boleto desabilitados
- Marque 2 ou mais linhas.
Os botões Vencimento, Excluir e Boleto ficam desabilitados (só agem com exatamente 1 linha); Trocar Carteira e Remessa aceitam várias.
22M-07 Boleto: segunda via
- Selecione um boleto com nosso número e clique Boleto.
- Repita com um sem nosso número.
Imprime a segunda via do boleto da venda; sem nosso número o sistema gera um na hora.
Abra o PDF.
22M-08 Remessa: conferir candidatos e gerar
- Escolha a Conta bancária no filtro.
- Remessa… > Conferir candidatos.
- Gerar remessa (com e sem reenviar já enviados/registrados).
Conferir mostra quantos boletos entram e o valor total antes de gerar. Gerar baixa o arquivo com nome próprio e aviso. Sem conta: "Selecione a conta bancária". Conta sem código de banco e nome ambíguo: aviso "bancoNaoPortado" pedindo cadastrar o código do banco.
Nome e conteúdo do arquivo; coluna remessa dos boletos.
22M-09 Importar retorno
- Na mesma janela, escolha o arquivo de retorno e Importar retorno.
O aviso mostra movimentos lidos, boletos registrados e baixas lançadas automaticamente; a coluna ocorrência se atualiza.
Baixas novas em financeiro_baixas.
22N — Central SISPAG
6 casosCaminho no menu: 2-Lançamentos › 2-Financeiros › Central SISPAG (22N)
Doc técnico: validacoes-central-sispag-22n.html · Ajuda: botão ? da janela
- Conta Bradesco (237) com código de convênio de pagamento; títulos em aberto por vencimento (fornecedores com dados de pagamento PIX/TED/boleto).
- Um usuário com acesso restrito a filiais (a lista respeita as filiais do usuário). Um arquivo de retorno do Bradesco.
- Esta tela não tem regra nomeada a conceder no Acesso dos Grupos (444).
- Observação: a decisão de 17/09 foi que bloqueio (não só aviso) para conta fora do Bradesco é divergência deliberada do legado.
22N-01 Listar: conta e datas obrigatórias
- Atualizar sem conta, sem vencimento inicial e sem final.
- Informe tudo e Atualizar.
"Informe a conta bancária." (tela) / "Campo [Conta Bancária] em branco!" (servidor), "Informe a data inicial.", "Informe a data final.", "Conta bancária não encontrada." Com tudo: lista títulos em aberto por vencimento, valor = saldo do título.
Saldo do título = parcela − baixas vivas.
22N-02 Filtros: Somente PIX, Filial, Centro de Custo e Excluir C. de Custo
- Alterne Somente PIX.
- Preencha Filial, Centro de Custo e Excluir C. de Custo com ids separados por vírgula.
Somente PIX muda o tipo de arquivo (PIX × TED/boleto). Campos em branco valem "todos". A lista respeita só as filiais do usuário: interseção vazia não mostra o banco inteiro.
22N-03 Data do pagamento
- Informe Data do pagamento no passado.
- Informe hoje ou futura.
Data retroativa é recusada (validação de data não retroativa no campo e no servidor); hoje ou futura é aceita. Sem data: "Informe a data de pagamento."
22N-04 Gerar remessa PIX e TED/boleto
- Marque títulos (ou Marcar/desmarcar todos) e Gerar remessa; confirme "Gerar a remessa de n título(s)?".
- Repita com Somente PIX desligado.
O arquivo baixa com nome BRPAG_PIX_… ou BRPAG_OUT_…; a sequência da conta avança e cada título fica registrado na remessa. O lote quebra por tipo de pagamento e pelo banco do boleto (45 PIX, 30 boleto próprio, 31 outro banco, 03 TED). PIX sem tipo de chave reconhecido gera aviso sem travar o arquivo.
SELECT * FROM remessa_pagamentos.
22N-05 Gerar remessa: recusas
- Gerar sem marcar nada.
- Conta de outro banco que não Bradesco.
- Conta sem convênio de pagamento.
- Título cujo banco do favorecido não é utilizável.
"Marque ao menos um título para gerar a remessa."; "A Central SISPAG é do Bradesco (237); a conta escolhida é do banco 033…"; "Banco sem código de convênio de pagamento. Corrija e gere nova remessa."; "Banco de crédito inválido [000] no título <id> — INDEFINIDO 000. Corrija o cadastro e gere nova remessa." (a remessa inteira para); "Sem pagamentos selecionados." se os títulos mudaram.
22N-06 Importar retorno baixa só o efetivado
- Importar retorno, confirme o aviso e escolha o(s) arquivo(s).
Aviso com pagamentos respondidos e baixas lançadas. Só ocorrência 00 ou 03 baixa; o valor pago é rateado pelas parcelas em aberto (sobra de saldo vira desconto, pago a mais vira juros). Sem arquivo: "Escolha ao menos um arquivo de retorno." Pagamento que não casa: "Não encontrados: <doc> (emitente <id>)".
financeiro_baixas novas; um arquivo inteiro numa transação.
22O — Estorno Coletivo de Baixas
6 casosCaminho no menu: 2-Lançamentos › 2-Financeiros › Estorno Coletivo de Baixas (22O)
Doc técnico: validacoes-estorno-coletivo-22o.html · Ajuda: botão ? da janela
- Conta bancária com baixas vivas no período, incluindo uma com cheque conciliado, uma de lote coletivo e uma em mês fechado (para ver que não há trava).
- Esta tela não tem regra nomeada a conceder no Acesso dos Grupos (444).
- Anote o id e o número de cheque das baixas antes de estornar (use baixas de teste).
22O-01 Listar baixas vivas
- Atualizar sem Conta bancária.
- Informe a conta; período com data final anterior à inicial; depois um período válido.
"Informe a conta bancária."; "A data final não pode ser anterior à inicial."; "Informe a data inicial." / "…final." Período válido: lista fornecedor/cliente, documento, id da baixa, data, valor, lote e histórico.
COUNT de financeiro_baixas da conta no período (excluido = 'F'); a data usa faixa meio-aberta (último dia entra).
22O-02 Estornar baixas marcadas
- Marque 2 baixas de teste; clique Estornar e confirme "Estornar 2 baixa(s)? A operação apaga a baixa e zera o número do cheque.".
Aviso com quantas foram estornadas; elas somem da grade e o título volta a Pendente em 221.
SELECT excluido, numero_cheque, idusuario_excluiu FROM financeiro_baixas WHERE id IN (...) — T, 0 e o usuário.
22O-03 Sem baixa marcada
- Clique Estornar sem marcar nada.
"Marque ao menos uma baixa para estornar."
22O-04 Estorno zera o cheque e desfaz a compensação
- Estorne uma baixa com cheque já marcada como compensada na 225.
O número do cheque é zerado e o cheque deixa de aparecer como compensado na conciliação.
225 na conta/data.
22O-05 Não há trava de mês fechado nem de conciliação
- Estorne uma baixa com data ≤ udf e uma conciliada.
O estorno é feito sem recusa (como no legado). Confira antes de marcar. Registre o comportamento.
SELECT udf FROM parametros WHERE filial_ativa = <filial>.
22O-06 Tudo ou nada
- Marque baixas em que uma não pode ser desfeita (ex.: já estornada em outra sessão) e Estornar.
Se alguma não puder ser desfeita, nenhuma é alterada. Baixa estornada por outra tela entre a listagem e o clique não conta no total devolvido.
excluido das demais permanece 'F'.
22P — Dados Financeiro Coletivo
11 casosCaminho no menu: 2-Lançamentos › 2-Financeiros › Dados Financeiro Coletivo (22P)
Doc técnico: validacoes-dados-financeiro-coletivo-22p.html · Ajuda: botão ? da janela
- Regra nomeada VENCOL (usuário com e sem; master passa). O legado menu22p.prg é vazio: a tela veio do ceif.
- Títulos em aberto a pagar e a receber, de filiais diferentes (usuário com acesso a mais de uma filial), emitente com compra de gado (parcela 1 ou 4, tipo de faturamento com gado = 'S') sem as duas autorizações e outro sem todas as faturas.
- Fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial> (a U.D.F. financeira da filial do título).
- Use títulos de teste: o Aplicar grava de verdade.
22P-01 Acesso: regra VENCOL
- Abra a 22P com usuário sem VENCOL e depois com ela (e master).
Sem a regra aparece no lugar da grade o aviso "Você não tem permissão para acessar esta tela. Peça ao administrador a regra "VENCOL"."; listar/aplicar por fora da tela: "Você não tem permissão para acessar Dados Financeiro Coletivo." Com a regra (ou master) a tela abre normal.
GET /lancamento/dados-financeiro-coletivo/permissoes; Acesso dos Grupos (444).
22P-02 Buscar títulos: filtros
- Escolha Pagar ou Receber.
- Filtre Emitente, Tipo de faturamento, Centro de custo, Centro de custo 2, Grupo de C.C. (incluir) e Excluir grupo de C.C.
- Teste vencimento com as duas datas, só a inicial e só a final.
- Marque Todas as filiais.
Só títulos em aberto, em ordem de vencimento, com a coluna Pendente. Duas datas: entre (inclusive); só inicial: depois dela; só final: antes dela. Excluir grupo mantém título cujo centro não tem grupo. Por padrão só a filial da sessão; Todas as filiais = as do usuário, nunca o banco inteiro. Vazio: "Nenhum título em aberto para esses filtros."
Compare com SELECT de financeiro_emissao com pendente > 0.
22P-03 Marcar
- Marque linhas com Ctrl/Shift+clique e Marcar/desmarcar todos.
A linha acima da grade mostra quantos títulos há e o total marcado.
22P-04 Aplicar novo vencimento
- Em O que alterar escolha Vencimento, informe o Novo vencimento, Aplicar e confirme "Alterar o vencimento de N título(s)?".
"N título(s) atualizado(s)." e a grade é buscada de novo com o vencimento novo; grava idusuario_alterou e data_alteracao.
SELECT data_vencimento, idusuario_alterou, data_alteracao FROM financeiro_emissao dos títulos.
22P-05 Aplicar novo centro de custo
- Escolha Centro de custo, o novo centro e Aplicar.
Altera idcentro_custo (o centro de custo 2 não muda). O novo centro não é conferido contra a filial do título; a conferência de compra de gado não roda neste modo.
financeiro_emissao.idcentro_custo.
22P-06 Recusas do Aplicar
- Aplicar sem título marcado, sem escolher o que alterar, sem a nova data e sem o novo centro.
"Marque ao menos um título para alterar."; "Escolha o que alterar: Vencimento ou Centro de custo."; "Informe a nova data de vencimento."; "Escolha o novo centro de custo."
22P-07 Trava: novo vencimento antes do fechamento
- Aplique um vencimento menor que o parametros.udf da filial do título, incluindo um título na lista que a passa.
"Título <id>: a data de vencimento não pode ser menor que a data do fechamento da filial <n> (AAAA-MM-DD)." A data igual ao fechamento passa. Tudo ou nada: um título barrado impede todos.
SELECT udf FROM parametros WHERE filial_ativa = <filial do título>.
22P-08 Trava: filial fora do usuário e título excluído
- Chame o Aplicar com id de título de filial fora das filiais do usuário (por API).
- Exclua um título marcado em outra sessão e Aplicar.
"Título <id> é da filial <n>, que não está entre as suas filiais." e "Título <id> não encontrado ou já excluído." Nenhum título muda.
22P-09 Trava de compra de gado (só no modo Vencimento)
- Aplique novo vencimento em título de compra de gado sem as duas autorizações.
- Em outro com faturas que não cobrem o valor bruto (mais de 50).
- Em compra excluída.
"Não é permitido realizar o pagamento — esse faturamento de compra de gado (<id>) não está autorizado!"; "…não contém todas as faturas!"; "Compra de gado (faturamento <id>) não encontrada ou excluída." Sem exceção de grupo.
faturamento_compra_gado: idusuario_aut e idusuario_aut2; soma das faturas.
22P-10 Sem trava de baixa parcial, conciliação, contabilizado
- Aplique em título com baixa parcial e em um contabilizado.
Aplica sem recusa (a tela não confere baixa nem contabilização, só a data nova contra o fechamento). A ajuda manda conferir os marcados antes. Registre o comportamento.
22P-11 Tudo ou nada
- Marque 3 títulos, um deles barrado por uma das travas, e Aplicar.
Nenhum dos três muda.
Vencimentos iguais aos de antes.
22R — Empréstimos FIDC/Fomento
14 casosCaminho no menu: 2-Lançamentos › 2-Financeiros › Empréstimos FIDC/Fomento (22R)
Doc técnico: validacoes-emprestimos-226-22r.html · Ajuda: botão ? da janela
- Tenant Brasil (central tem 781 FIDCs; fjfrigo_concepcion não tem FIDC). Banco/fundo como Cliente e conta bancária que recebe.
- Planilha de borderô do banco/fundo (a coluna H precisa ter o número da NF), remessa de boletos já enviada (22M) e tarifas cadastradas (casadas por descrição).
- Um FIDC com dias_float = 0 gravado (29 FIDCs, 807 títulos em central) e um com baixa feita por fora.
- Acesso: só pela permissão da opção no menu. A regra EMPRESTIMO_FIDC saiu do Demonstrativo (decisão de 04/10/2026).
- Fechamento: SELECT udf FROM parametros WHERE filial_ativa = <filial>.
22R-01 Acesso só pela permissão da opção (sem EMPRESTIMO_FIDC) Mudou em 04/10/2026
- Com usuário que tem a opção 22R no menu mas não tem a regra EMPRESTIMO_FIDC, abra a tela, inclua, altere, exclua e clique Demonstrativo.
Todos os botões funcionam, inclusive o Demonstrativo: não há mais regra nomeada nem recusa por falta de EMPRESTIMO_FIDC.
Acesso dos Grupos (444).
22R-02 Grade
- Abra a 22R (período de 90 dias).
Lista data, documento, banco/fundo, conta, moeda, bruto e líquido, só de FIDC/Fomento (a 226 não os lista).
22R-03 Incluir importando o borderô
- Incluir: Data, Tipo de captação, Tipo de título, Documento, Cliente (banco/fundo), Conta bancária e Dias de float.
- Importar planilha com o borderô.
- Confira a lista de títulos e as Tarifas; Gravar.
A importação não grava: preenche a lista (valor de face, deságio e vencimento; float e % vêm da planilha, fim de semana passa para segunda). Tarifa que não casa por descrição volta sem vínculo (aviso). Gravar mostra a operação na grade com bruto e líquido. Campos data de entrada, moeda, câmbio e tipo de taxa não aparecem de propósito (moeda local, câmbio 1, taxa mensal).
SELECT * FROM financeiro_emissao dos títulos e o empréstimo (tipo de faturamento do FIDC).
22R-04 Incluir pela Buscar Remessa
- Em Buscar Remessa digite o(s) número(s) da remessa e o % Juros calc.; Gravar.
A lista é substituída pelos boletos da remessa; o sistema calcula float e % de juros. O % gravado é sempre a taxa mensal.
22R-05 Float editável e recalculado só na linha confirmada Mudou em 04/10/2026
- Edite o vencimento de uma linha e confirme.
- Digite o vencimento com float à mão numa linha.
- Edite os dias de float e o vencimento na mesma edição.
- Mude a data ou os dias de float do cabeçalho.
Ao mudar o vencimento, o vencimento com float é refeito (vencimento + dias de float; fim de semana passa para segunda, e float no fim de semana vai para terça) ao confirmar a linha; se o float foi digitado na mesma edição vale o digitado. O % de juros e o líquido são refeitos a cada linha confirmada pelo float dela. Mudar o cabeçalho não mexe nos títulos já na lista.
Conferência por linha: vencimento com float = vencimento + dias.
22R-06 Dias de float = 0 é válido Mudou em 04/10/2026
- Abra um FIDC com dias_float = 0 e regrave sem mexer.
Os floats e a média de dias ficam iguais (antes o porte trocava 0 por 2). Só nulo/vazio vale 2.
SELECT dias_float, vencimento_float dos títulos antes e depois (não pode mudar).
22R-07 Gravar guarda exatamente o que está na grade Mudou em 04/10/2026
- Abra uma operação existente, não edite nada e Gravar.
- Edite o float de uma linha e Gravar.
Sem edição nenhum título muda (float e % idênticos, ida e volta em 39.619 títulos). Com edição, grava float e % da grade, sem refazer.
Compare os títulos da operação antes e depois.
22R-08 Sem a trava EMPRESTIMO_FIDC em incluir, alterar e excluir Mudou em 04/10/2026
- Com usuário sem a regra, inclua, altere e exclua uma operação de teste.
Todas as operações são permitidas pela permissão da opção.
22R-09 Resumo e confere dos números
- Abra uma operação e confira bruto, juros, tarifas, líquido, % juros calculado e efetivo.
Líquido do título = bruto − juros; líquido do cabeçalho = bruto − juros − tarifas. Em central batem: líquido do título 39.608 de 39.619, bruto do cabeçalho 774 de 781, líquido do cabeçalho 773 de 781 (as exceções são remessa/ceif ou edição manual).
Compare com o Demonstrativo e com o extrato do banco/fundo.
22R-10 Obrigatórios, sem título e trava de mês fechado
- Gravar sem Cliente e sem Conta bancária.
- Gravar sem nenhum título com valor.
- Incluir com data ≤ udf.
"Campo [Emitente] em branco." / "Campo [Conta Bancária] em branco." (e Data); "Nenhum título encontrado na planilha - confira se é o borderô de fomento (a coluna H precisa ter o número da NF)." para planilha errada; sem título com valor a gravação é recusada; "Período já fechado: a data do empréstimo precisa ser posterior a <udf>."
SELECT udf FROM parametros WHERE filial_ativa = <filial>.
22R-11 Alterar com baixa por fora, já conferido; sem tipo de faturamento
- Altere uma operação cuja baixa foi feita por fora do sistema.
- Altere uma já conferida pela contabilidade.
- Altere/exclua uma antiga sem tipo de faturamento.
"Este empréstimo já tem parcela baixada - não é possível alterá-lo, porque regravar desfaria a baixa lançada por outra pessoa."; "Não é possível alterar: o empréstimo já foi conferido na contabilidade."; "Empréstimo sem tipo de faturamento - não é possível regravar/desfazer o financeiro com segurança."
22R-12 Alterar e Excluir
- Alterar reabre com a mesma lista e tarifas; ajuste e Gravar.
- Excluir abre o mesmo formulário travado e confirme.
Alterar refaz os títulos na mesma transação; Excluir some a operação e os títulos (exclusão lógica).
excluido dos títulos.
22R-13 Demonstrativo
- Selecione uma operação e clique Demonstrativo.
Baixa uma planilha com data, valor de face, valor líquido, vencimento (com e sem float), prazo, deságio e tarifas por título, mais o total geral.
Confira o total com o extrato do banco/fundo.
22R-14 Digitalizar e Gerencial
- Anexe um documento.
- Marque o checkbox Gerencial e grave; combo Tipo Faturamento.
Digitalizar anexa à operação. Gerencial grava; o combo Tipo Faturamento lista só os tipos filtrados de empréstimo (o mesmo endpoint da 226).
Exportar resultado
Gera um texto com caso, ok/falhou e observação, só dos casos marcados ou com observação. Copie e mande.