Ajuda › Finanças

Módulo Financeiro — Guia do Zero para o Caixa e a Contabilidade

Este guia foi escrito para quem nunca usou um programa de contabilidade. Você sabe contar dinheiro; o que vai aprender aqui é em qual documento cada movimento de dinheiro se transforma dentro do programa. Se entender uma única ideia, o resto é fácil: no HNR não existem movimentos de dinheiro, existem documentos. Se escolher o documento certo, o saldo sai certo sozinho.

1. Para que serve o módulo financeiro?

Em uma empresa há duas perguntas diferentes, e a maioria das pessoas as confunde: "quanto ganhamos?" e "quanto dinheiro temos?" Não são a mesma coisa. Uma empresa lucrativa pode quebrar por não conseguir pagar os salários por falta de dinheiro. A pergunta do lucro é assunto das notas fiscais; a pergunta do dinheiro é assunto do módulo financeiro.

O módulo financeiro responde a três perguntas: (1) onde está o meu dinheiro agora? (caixa, banco, carteira de cheques) (2) quando vai entrar ou sair dinheiro? (vencimentos) (3) de quem veio e para quem foi? (saldos das contas). Este é o único lugar que reúne os três ao mesmo tempo.

2. Os 6 conceitos que você precisa conhecer

2.1 Jargão financeiro ↔ linguagem do dia a dia

3. O que existe em cada janela?

Finanças não é uma única janela; são quatro janelas que se completam. A maior parte da confusão vem da pergunta "onde eu faço isso?", então aprenda primeiro o mapa:

📷 Tela real 🗺 Função de cada campo

Figura 2 — Caixa e Banco respondem "onde está o dinheiro"; Cheques e Borderôs respondem "quando".

4. Cenário de exemplo: cobrança de 50.000 TL

O cliente ARDA MOBİLYA está quitando uma dívida de 50.000 TL: trouxe 20.000 TL em dinheiro e, pelos outros 30.000 TL, entregou um cheque com 45 dias de vencimento. Parece um único acontecimento, mas no programa são dois documentos distintos — porque um é dinheiro hoje e o outro pode virar dinheiro em 45 dias.

5. Passo a passo: o seu primeiro recibo

1. Escolha o tipo de recibo certo

   A primeira e mais importante escolha no formulário do recibo é o tipo. Ele determina o sentido do dinheiro e em qual caixa ou banco ele será lançado:

   Tipo	Quando usar	Sentido
   Cobrança	O cliente trouxe dinheiro em mãos	→ entrada
   Pagamento	Você entregou dinheiro em mãos a um fornecedor	← saída
   Transferência/TED recebida	Entrou dinheiro na sua conta	→ entrada
   Transferência/TED enviada	Você enviou dinheiro da sua conta	← saída
   Depósito em banco	Você levou ao banco o dinheiro do caixa	caixa → banco
   Saque do banco	Você sacou dinheiro do banco	banco → caixa
   Nota de débito	Não há movimento de dinheiro, você está debitando o cliente (variação cambial, despesa)	somente saldo
   Nota de crédito	Não há movimento de dinheiro, você está creditando o cliente (desconto, correção)	somente saldo

   💡 Quando é preciso uma nota?

   O cliente devia 10.000 TL e depositou 9.980 TL, porque o banco descontou 20 TL de tarifa. Entram 9.980 no caixa; se você emitir uma Nota de débito pelos 20 TL restantes, o saldo fecha exatamente e ninguém sai procurando "onde estão os 20 reais".

2. Informe a conta, o caixa e o valor

   No campo Conta escolha o cliente (digite para buscar), no campo Caixa/Banco o lugar onde você colocou o dinheiro e no campo Valor digite 20.000. Deixe uma observação em Descrição, como "cobrança de agosto" — daqui a três meses você vai se agradecer.

   💡 Na cobrança, as notas fiscais em aberto são listadas

   No recibo de cobrança, ao escolher a conta, o formulário lista as notas fiscais em aberto daquela conta: se escolher uma, a descrição é preenchida no padrão e o valor restante é sugerido. A escolha é opcional — você também pode emitir uma cobrança livre, sem escolher nota fiscal.

   Se escolher uma nota fiscal, ela é quitada: o valor cobrado é abatido do saldo daquela nota fiscal. Quando é cobrada por inteiro, a nota fiscal fecha e não aparece mais na lista de notas em aberto — assim você nunca cobra o mesmo dinheiro duas vezes. Se apagar o recibo, o saldo reabre; se alterar o valor, a diferença é aplicada.

3. Salve — o saldo muda na hora

   No instante em que você clica em [Salvar], o recibo é gravado no HNR: o saldo do caixa fica +20.000 e a dívida de ARDA MOBİLYA fica −20.000. Não há etapa intermediária nem fila de aprovação. Por isso, releia o valor uma vez antes de salvar.

4. Lance o cheque por um borderô

   Agora o cheque de 30.000 TL. Na janela Borderôs de Cheques clique em [Novo borderô]; o tipo do borderô será Entrada de conta (CG) — ou seja, "recebemos cheques de um cliente". Inclua o cheque: vencimento, valor, banco/agência, emitente. Ao salvar, o cheque nasce com a situação Em carteira e o saldo da conta é quitado.

   💡 Por que um borderô mesmo para um único cheque?

   Porque um cheque é sempre recebido de alguém ou entregue a alguém. O borderô é a capa que carrega esse "quem" e a data. Quando o cheque é lançado sozinho, esse vínculo se rompe e a pergunta "de quem recebemos este cheque" fica sem resposta.

📷 Tela real 🗺 Função de cada campo

Figura 3 — O recibo produz ao mesmo tempo "movimento de dinheiro + saldo + linha de extrato". Por isso não é preciso corrigir saldo à mão.

6. A linha de vida de um cheque

O cheque que você recebe não fica parado; ele sai em viagem. No HNR cada parada dessa viagem é uma situação, e você pode vê-las pelo filtro da janela Cheques.

📷 Tela real 🗺 Função de cada campo

Figura 4 — O filtro Situação na janela Cheques lista exatamente estas caixas. Se você não encontra um cheque, está procurando na situação errada.

7. Datas de valor automáticas: o sistema lança por você

Em operações de cartão de crédito (POS) e DBS o dinheiro cai na sua conta no vencimento, do lado do banco, sem que você faça nada. Lançar isso à mão é desnecessário e sujeito a erro. Por isso o HNR verifica a cada hora e lança automaticamente como cobrança/pagamento os registros V (cartão) e D (DBS) já vencidos.

8. Quatro erros frequentes

9. Rotina diária por função

10. Perguntas frequentes

11. Glossário

12. Impressão do recibo: o papel que você entrega em mãos

Você salvou o recibo, o dinheiro entrou no caixa, o saldo ficou certo — mas a pessoa à sua frente ainda diz "me dá um papel". O HNR resolve isso sem um segundo programa, sem editor de modelos e sem arquivo do Word: ao lado de cada recibo salvo há um pequeno botão 🖨. No instante em que você clica, abre-se a janela de impressão do navegador com um recibo que traz o cabeçalho da empresa, o valor por extenso e os campos de assinatura prontos.

Onde fica o botão 🖨?

Abra a janela Lançamento de Recibos. Abaixo do formulário há a lista "Son Makbuzlar" (Últimos recibos) — os recibos emitidos hoje e nos últimos dias. À direita de cada linha, logo depois do valor, está o 🖨. Esse botão é somente leitura: não altera, não apaga e não regrava nada — apenas produz a versão em papel daquele recibo. Por isso o 🖨 funciona até nos recibos que não podem ser editados por estarem vinculados a um cheque ou a uma nota fiscal (com a etiqueta "Bağlı / vinculado").

Esse layout vem do formulário de recibo do Baskı Tasarımcısı (Desenhador de Impressão) (Ayarlar › Baskı Formları — tahsilat, kasamakbuz, bankamakbuz): a posição das linhas, o corpo da fonte e os rótulos se alteram por lá. Se nenhum formulário tiver sido desenhado, é impresso o formulário pronto de fábrica. O "Baixar como PDF" do menu do documento usa o mesmo formulário — o 🖨 e o PDF não se separam.

O que quer dizer "valor por extenso" e por que isso importa?

É fácil acrescentar um dígito à frente de um valor escrito em algarismos; já alterar um valor escrito por extenso, não. Por isso, em recibos, cheques e notas promissórias o valor é escrito duas vezes. O HNR faz a segunda parte por você: quando você digita 12.500,00 TL, sai no papel "on iki bin beş yüz TL, sıfır kuruş" (doze mil e quinhentas liras, zero kuruş). Com centavos é igual: 1.250,75 TL → "bin iki yüz elli TL, yetmiş beş kuruş".

13. Lançamento de recibos em lote: trinta cobranças, uma única tela

Segunda-feira de manhã, o cobrador esvazia a sacola: veio dinheiro de 28 clientes. Escrever um recibo por vez significa escolher 28 vezes o mesmo caixa, o mesmo tipo e a mesma data. O lançamento em lote elimina exatamente essa repetição: você escolhe o caixa/banco, o tipo e a data uma vez só no formulário de cima, e na tabela de baixo informa apenas conta + valor + descrição.

1. Primeiro ajuste o formulário de cima

   Escolha a espécie (Caixa / Banco / Conta-Nota), o tipo (ex.: Cobrança), a conta de caixa ou banco e a data. Se quiser, informe também a Data de valor — tudo isso é aplicado igualmente a cada linha da tabela. É por isso que a tabela não pergunta esses campos de novo.

2. Clique no botão "Toplu giriş" (Lançamento em lote)

   O botão fica ao lado da etiqueta do tipo. Quando é ativado, o texto passa a "Toplu giriş: AÇIK" (lançamento em lote: LIGADO), os campos do recibo único (conta, valor, descrição) somem e no lugar deles vem uma tabela com três linhas vazias. Com + Satır ekle você abre quantas linhas quiser; com × remove as sobrando. Ao mesmo tempo, o botão Salvar de baixo é desativado — porque agora quem grava é o Hepsini Yaz.

3. Preencha as linhas

   Cada linha tem três campos: o seletor de conta (comece a digitar e a lista é filtrada), o valor e a descrição (opcional, no máximo 250 caracteres). Você pode digitar o valor no formato turco — "12.500,00", "12500.00" e "12500" são todos aceitos. Na faixa inferior você vê na hora quantas linhas estão preenchidas e o valor total: "3 satır · 41.250,00 ₺". Linhas sem conta escolhida ou com valor zero/vazio não contam — você não precisa apagá-las, elas são ignoradas em silêncio.

4. "Hepsini Yaz" (Gravar tudo) e o resultado linha a linha

   No botão está escrito quantas linhas serão gravadas: "Hepsini Yaz (3)". Ao clicar, as linhas são gravadas uma após a outra — não todas de uma vez — e cada linha mostra o próprio resultado ali mesmo. Ao terminar, a lista é atualizada; os recibos gravados aparecem em "Son Makbuzlar", abaixo, e de lá podem ser impressos com o 🖨.

   O que você vê na linha	Significado	O que você deve fazer
   ✓ Makbuz #1482	Gravado. Este é o número do recibo.	Nada. A linha é travada e não será gravada de novo.
   ✓ Makbuz #1483 (uyarı)	O recibo foi gravado, mas uma tarefa secundária (ex.: a data de valor) não pegou.	Passe o mouse sobre o texto e leia o aviso; o recibo é válido.
   ✗ …	Não foi gravado; o texto em vermelho diz o motivo (ex.: conta não encontrada).	Corrija a linha e clique de novo em Hepsini Yaz — só as linhas pendentes e com erro são tentadas outra vez.
   yazılıyor… (gravando)	Chegou a vez desta linha.	Aguarde; não feche a janela.

14. O campo data de valor e o saldo "na data de hoje"

Na seção 7 explicamos o que é a data de valor: o dia em que o dinheiro está efetivamente disponível. Agora você pode escrevê-la no próprio recibo. No formulário do recibo, logo ao lado da data, há o campo "Valör (opsiyonel)" — data de valor (opcional). Pode deixar em branco, nada quebra.

Três regras

O segundo saldo nas telas de Banco e Caixa

Na faixa de totais no alto das janelas Banco e Caixa, em alguns dias aparece uma segunda linha abaixo do total: "bugün itibarıyla …" (na data de hoje …). Essa linha recalcula o mesmo total deixando de fora os recibos cuja data ou data de valor ainda não chegou. Ou seja, o primeiro responde "o que os nossos registros dizem que há nesta conta" e o segundo responde "o que eu posso realmente usar hoje".

15. Cobrança de cheque em moeda estrangeira: sem cotação não dá

Seu cliente entregou um cheque de 1.000 USD. Ele fica na sua carteira em dólares, mas, quando você o cobra, o dinheiro que entra no caixa/banco é em liras turcas. O único número que une esses dois mundos é a cotação do dia da cobrança — e o HNR não faz a cobrança sem pedi-la a você.

1. Escolha o cheque na janela Cheques e clique em "Tahsil Et"

   A janela que se abre tem o título "Çeki Tahsil Et" (Cobrar o cheque). (Se for um título emitido por você, o título passa a "Firma Evrakını Öde" e o dinheiro sai; o fluxo é o mesmo.) Na caixa de resumo do alto, ao lado do valor, a sigla da moeda aparece em amarelo: 1.000,00 USD. Se você viu isso, é sinal de que a cotação será pedida.

2. Preencha o campo "TL Kuru" (cotação em TL)

   O rótulo do campo traz também a moeda: TL Kuru (USD) *. O asterisco quer dizer obrigatório. Você pode digitar com vírgula: 41,25. No instante em que digita, a conta aparece logo abaixo:

   🧮 A linha que você vê na tela

   Makbuz TL karşılığıyla yazılır: 1.000,00 USD × 41,25 = 41.250,00 TL

   Enquanto a cotação estiver vazia, no lugar dessa linha fica um aviso e o botão Tahsil Et permanece desativado. Se por engano uma requisição sair sem cotação, o servidor também a recusa.

3. Escolha a conta de destino — só contas em TL são listadas

   Se o cheque está com você (ou voltou sem fundos), quem escolhe Bankaya / Kasaya (para o banco / para o caixa) e a conta é você. Se o cheque já foi entregue a um banco para compensação, ou se é um título de cartão/DBS, o destino não é perguntado — o sistema já sabe a qual conta o título pertence. As contas em moeda estrangeira estão propositalmente fora da lista: um cheque em moeda estrangeira entra em uma conta em TL pelo seu equivalente em TL.

4. Confirme duas vezes

   O primeiro clique deixa o botão vermelho e com o texto "Onayla — Tahsil Et" (Confirmar — cobrar); acima dele aparece o aviso "a cobrança é gravada na contabilidade AO VIVO e gera movimento de dinheiro". O segundo clique executa. Se você alterar a cotação ou a conta, a confirmação se desfaz sozinha — assim você não consegue dar o segundo clique com um número desatualizado.

17. Cartão do Banco — extrato da conta e dados de acesso

Objetivo e caminho de abertura: em Banco › Bancos, clique na linha da conta (Enter/Espaço no teclado também funcionam). O Cartão do Banco que se abre tem duas abas: o Extrato mostra, somente leitura, o movimento contábil ao vivo; os Dados guardam as anotações de internet banking, cartões e usuários autorizados. Qualquer funcionário que enxergue o módulo Banco pode abrir o cartão; por conter senhas e dados de cartão, dentro da empresa somente o pessoal de finanças designado deve preencher a aba Dados.

18. Lançamento de Cheque / Cartão — um cheque, nota promissória ou cobrança no cartão

Quem e por onde: o funcionário de cobrança/contabilidade com permissão de lançamento de cheques usa o caminho Cheques › + Novo Cheque/Cartão. O mesmo formulário pode ser aberto por Cartão da Conta/Conta Extra › Extrato › Lançamento de Cheque/Cartão, já com a conta selecionada, ou procurando “Çek / KK Girişi” no Ctrl+K. Pré-requisito: o cartão da conta precisa existir; no cartão de crédito é preciso ter uma conta POS/cartão adequada definida.

16. Impressão do borderô de cheques

Um borderô é a lista dos cheques que você recebeu de uma conta (ou entregou a um banco) de uma só vez. Quando for preciso um papel dizendo à outra parte "recebi/entreguei estes cheques": abra a janela Çek Bordroları (Borderôs de cheques), selecione o borderô à esquerda e clique no botão 🖨 Yazdır que aparece acima do detalhe, à direita.

No papel constam: o cabeçalho da empresa; "ÇEK BORDROSU — <nome da operação>"; o número e a data do borderô; a razão social da conta e a descrição; em seguida uma tabela numerada — Nº do Cheque · Banco · Emitente · Vencimento · Valor. No rodapé, quantos cheques há, o vencimento médio e o total; abaixo do total, o valor por extenso; e bem no fim, o usuário que emitiu e os campos de assinatura. Esse layout vem do formulário cekbodro do Baskı Tasarımcısı (Desenhador de Impressão) (Ayarlar › Baskı Formları); se nenhum formulário tiver sido desenhado, é impresso o formulário pronto de fábrica. O "Baixar como PDF" também usa o mesmo formulário — papel e PDF não se separam.

19. Banco › Ayarlar › "Aviso de saldo negativo / limite mínimo"

Quando uma conta bancária fica negativa ou cai abaixo do limite mínimo que você definiu, quem deve ficar sabendo é a pessoa responsável por aquela conta — e não todo mundo que vê a etiqueta de "conta com saldo negativo" no dock. A terceira seção da janela ⚙ Ayarlar do módulo Banco configura isso. Por padrão vem DESLIGADO; nenhuma mensagem é gerada enquanto um administrador não marcar a caixa "ativo" e salvar.

1. Na janela Banco, abra ⚙ Ayarlar › seção "Aviso de saldo negativo / limite mínimo" (só o administrador edita).
2. Em cada linha de conta, informe opcionalmente um limite mínimo (₺) e os destinatários. O destinatário pode ter três formas: o nome de um modelo de perfil (finans, muhasebe…), o prefixo bolum: seguido do nome do setor no cartão do usuário, ou diretamente um nome de usuário. Separe por vírgulas.
3. Se nenhuma regra tiver sido escrita para a conta, usam-se os destinatários padrão. Um nome que não puder ser resolvido é listado como "não resolvido" na resposta do Salvar — não é engolido em silêncio.
4. Marque a caixa "ativo" e clique em Salvar. Se não quiser esperar, o botão Varrer agora executa uma rodada imediatamente e mostra quantos avisos, quantos envios e quantas omissões houve.

Regras: se o saldo estiver abaixo de zero, a mensagem tem prioridade urgente; se estiver entre zero e o limite mínimo, importante. Para a mesma conta e o mesmo destinatário não é escrita uma segunda mensagem no mesmo dia. Contas inativas são puladas. As contas de cartão de crédito, por natureza, operam no negativo e por isso são puladas, a menos que um limite mínimo seja escrito explicitamente. A varredura roda sozinha 90 segundos depois do boot e a cada hora cheia; quando um recibo ou uma cobrança de cheque é gravada, a conta afetada é verificada na hora. As mensagens chegam como mensagens internas do HNROS (com o remetente "sistema").

A etiqueta do dock também ficou pessoal: havendo regras definidas, o número de "contas com saldo negativo" na etiqueta do Banco conta apenas as contas sob a sua responsabilidade; se não houver regra nenhuma, o comportamento antigo (todas as contas) continua.

20. Cheques › a faixa "Risco de vencimento" — os próximos 30/60/90 dias

Na janela Cheques, a faixa Risco de vencimento acima da lista é uma única linha quando está recolhida: total a cobrar / a pagar dentro da janela, líquido, quantidade de contas com histórico de cheque sem fundos e quantidade de cheques em atraso. Ao expandir, aparecem o seletor de 30 / 60 / 90 dias, as caixas de números, as faixas de vencimento (0–7, 8–15, 16–30, 31–60, 61–90, 91+), um calendário dia a dia e a tabela de concentração por conta. O conjunto: cheques em mãos ou em compensação bancária, com vencimento entre hoje e hoje+N; os cheques em moeda estrangeira são convertidos para TL pela cotação do lançamento.

Permissão: módulo Cheques. A faixa fica 60 segundos em cache; para ver um cheque que você acabou de lançar, clique no botão ↻ (atualizar). A quantidade de dias vai de 1 a 365; fora disso, 422. O filtro "região" funciona pelo campo cidade do cartão da conta.

21. O aviso "Cobrança: X%" no lançamento de recibos

Ao salvar um recibo vinculado a uma nota fiscal, o aviso de sucesso agora traz uma linha como "Cobrança: 15,2% (50 / 330)": valor da nota fiscal, o total cobrado até hoje e o percentual. Se a nota fiscal foi totalmente quitada, ele também informa isso. Se o valor da nota fiscal for zero ou negativo, em vez de mostrar um falso 100% a linha simplesmente não vem. Essa informação existe apenas no aviso e na resposta da API; não é gravada no registro do recibo.

22. Conciliação de fim de dia: o saldo derivado (não grava nada)

Para a pergunta "o saldo do cartão no caixa está certo?" existe um segundo cálculo: o saldo derivado = o efeito total dos recibos de caixa e banco (excluídos os cancelados) gravados até uma determinada data. A resposta traz o saldo do cartão, o saldo derivado, a diferença entre os dois e o veredito "está conciliado?"; havendo diferença, uma linha de explicação arrisca a causa (ex.: um saldo de abertura fora dos movimentos). Este endpoint não grava nada; a decisão de corrigir é sua. Por enquanto ele existe só na API (GET /api/kasa/<conta>/turetilmis-bakiye?tarih=AAAA-MM-DD, mesmo caminho para banco); o cartão "Conciliação de fim de dia" na janela Banco/Caixa virá em uma rodada seguinte. Uma data que não existe no calendário (30 de fevereiro) retorna 422 e uma conta desconhecida, 404.

23. Contabilidade: o diário desses movimentos

As entradas de diário de receitas, transferências, transferências de caixa ↔banca e cheques/notas são geradas automaticamente no Contabilidade Fonte (Financial / Grupo Bancário); dinheiro (100), Banco de Portugal (102), Avaliação de dados (101/103) e as contas de partes chegam ao balanço de prova, balanço e fluxo de caixa a partir daí. Detalhes : Guia de Contabilidade.