Como o app pensaHow the app thinks

Regras de negócio, com exemplos

Business rules, with examples

O Silica é opinativo: ele tem regras claras para calcular tudo de forma consistente. Aqui estão as principais, com exemplos práticos.

Silica is opinionated: it follows clear rules to calculate everything consistently. Here are the main ones, with practical examples.

Saldo livre & comprometimento

Free balance & commitment

  • Saldo livre = saldo anterior + renda do mês − despesas do mês.
  • Free balance = previous balance + month income − month expenses.
  • Comprometimento = despesas do mês ÷ (saldo anterior + renda do mês). Se não há saldo positivo mas há contas, é 100%.
  • Commitment = month expenses ÷ (previous balance + month income). With no positive balance but bills pending, it's 100%.
🔎 ExemploExample
  • Saldo anterior R$ 1.000 + renda R$ 4.000 = R$ 5.000. Despesas R$ 950.
  • Previous $200 + income $800 = $1,000. Expenses $190.
  • → Comprometimento = 950 ÷ 5.000 = 19%; saldo livre = R$ 4.050.
  • → Commitment = 190 ÷ 1,000 = 19%; free balance = $810.

O lucro só é real quando o dinheiro entra

Profit only counts when the money arrives

Nos perfis Vendas e Serviços, o lucro (ou a renda) não é contado quando a venda/serviço é registrado, e sim quando você marca como recebido. Isso mantém o Raio-X honesto: mostra caixa de verdade, não promessa.

In Sales and Services, profit (or income) isn't counted when the sale/service is recorded, but when you mark it as received. This keeps the X-Ray honest: it shows real cash, not a promise.

São duas perguntas diferentes, de propósito: o Vendas lança o lucro da venda (o que sobra depois do custo do produto); o Serviços lança o valor líquido que efetivamente chegou ao seu bolso (já descontados sinal recebido antes e eventual retenção de INSS). Quem usa os dois perfis não deve esperar que a renda de um baixe do mesmo jeito que a do outro.

These are two different questions, on purpose: Sales records the profit from the sale (what's left after the product's cost); Services records the net amount that actually reached your pocket (already net of any down payment received earlier and any INSS withholding). If you use both profiles, don't expect income to post the same way in each.

🔎 ExemploExample
  • Venda de R$ 100 (custo R$ 60) em 2×. Ao receber a 1ª parcela, metade do lucro entra como renda; ao receber a 2ª, o restante.
  • A $100 sale (cost $60) in 2×. When you receive the 1st installment, half the profit becomes income; the 2nd brings the rest.

Parcelas que somam exatamente o total

Installments that add up exactly

A divisão é feita por centavos e o resíduo vai para a última parcela.

The split is by cents and the remainder goes to the last installment.

🔎 ExemploExample
  • R$ 100 em 3× → 33,33 + 33,33 + 33,34 = 100,00.
  • $100 in 3× → 33.33 + 33.33 + 33.34 = 100.00.

Multa e juros: uma vez a multa, os juros por dia

Late fee and interest: fee once, interest per day

Quando o Vendas ou o Serviços ligam a cobrança, a multa incide uma única vez, no primeiro dia de atraso, e os juros do mês são divididos por 30 e cobrados por dia corrido. A conta usa o valor da parcela (Vendas) ou da OS (Serviços), nunca o total da venda, e o resultado é congelado no momento do pagamento/recebimento — mudar o percentual depois não mexe no que já foi cobrado.

When Sales or Services turn charging on, the fee applies once, on the first day of delay, and the monthly interest is divided by 30 and charged per calendar day. The math uses the installment amount (Sales) or the order's amount (Services), never the sale total, and the result is frozen at payment time — changing the percentage later doesn't touch what was already charged.

🔎 ExemploExample
  • R$ 100, 16 dias de atraso, 2% + 1%/mês → 2,00 + (100 × 1% ÷ 30 × 16) = R$ 102,53.
  • $100, 16 days late, 2% + 1%/month → 2.00 + (100 × 1% ÷ 30 × 16) = $102.53.
  • Pagamento parcial de parcela atrasada quita primeiro os encargos e só depois abate o principal. O que faltar vira uma parcela nova, sem juros sobre juros.
  • A partial payment on an overdue installment clears the charges first and only then reduces the principal. What is left becomes a new installment, with no interest on interest.
  • Desligar a cobrança não apaga o histórico: parcelas já recebidas com encargo continuam registradas.
  • Turning charging off doesn't erase history: installments already received with charges stay on the record.
  • No Serviços, orçamento e OS cancelada nunca geram encargo: só a OS de serviço realizado, em aberto e atrasada, acumula multa e juros.
  • In Services, quotes and canceled orders never carry a charge: only a completed, open and overdue order accrues fee and interest.

Quitar dívida parcelada: como no banco, sem volta

Settling an installment debt: like at a bank, no going back

Dívidas parceladas fora do cartão (empréstimo, financiamento, carnê) podem ser quitadas de uma vez. O app mostra o somatório das parcelas em aberto e pergunta se houve redução pela quitação antecipada; se sim, você informa o valor final negociado e o Silica mostra a economia. As parcelas em aberto são substituídas por um único lançamento pendente no mês atual, com vencimento hoje.

Installment debts outside the card (loan, financing, payment book) can be settled at once. The app shows the total of the open installments and asks whether the amount was reduced for settling early; if so, you enter the negotiated final amount and Silica shows the savings. The open installments are replaced by a single pending entry in the current month, due today.

Sem volta, como no banco: as parcelas originais não são restauráveis; excluir o lançamento de quitação depois não as traz de volta. As parcelas já pagas ficam intocadas no histórico. No cartão de crédito, o caminho continua sendo a antecipação de parcelas.

No going back, like at a bank: the original installments cannot be restored; deleting the settlement entry later will not bring them back. Installments already paid stay untouched in your history. On credit cards, the path remains installment anticipation.

🔎 ExemploExample
  • Empréstimo com 8 parcelas de R$ 600 em aberto (R$ 4.800). O banco ofereceu quitação por R$ 4.200 → você informa o valor final e o app registra a economia de R$ 600; nasce um lançamento único de R$ 4.200 pendente no mês atual.
  • A loan with 8 open installments of $600 ($4,800). The bank offered a $4,200 settlement → you enter the final amount and the app records the $600 savings; a single $4,200 pending entry is created in the current month.

Faturas de cartão

Card invoices

  • Ciclo da fatura: compra a partir do dia de fechamento (inclusive) entra no ciclo do mês seguinte.
  • Invoice cycle: a purchase on/after the closing day goes into next month's cycle.
  • Mês do vencimento: o vencimento cai no mesmo mês do fechamento quando o dia de vencimento é maior que o dia de fechamento. Quando o dia de vencimento é igual ou menor que o dia de fechamento — o caso mais comum no Brasil, como fechar dia 25 e vencer dia 5 —, o vencimento vai para o mês seguinte ao fechamento. A fatura aparece na timeline no mês em que vence, que é quando o dinheiro sai.
  • Due month: the due date falls in the same month as the closing when the due day is greater than the closing day. When the due day is equal to or less than the closing day — the most common case in Brazil, like closing on the 25th and due on the 5th —, the due date moves to the month after the closing. The invoice shows up on the timeline in the month it's due, which is when the money leaves.
  • Fatura reaberta: se você compra de novo após pagar, a timeline mostra só o valor não pago.
  • Reopened invoice: if you buy again after paying, the timeline shows only the unpaid amount.
  • Limite disponível = limite − despesas não pagas.
  • Available limit = limit − unpaid expenses.
🔎 ExemploExample
  • Cartão fecha dia 25 e vence dia 5: uma compra em 09/09/2026 entra na fatura que fecha em 25/09/2026 e vence em 05/10/2026.
  • Card closes on the 25th and is due on the 5th: a purchase on 2026-09-09 goes into the invoice that closes on 2026-09-25 and is due on 2026-10-05.

Recorrência protege seu histórico

Recurrence protects your history

  • Uma série ativa por descrição em cada perfil: o app impede duplicar a mesma conta.
  • One active series per description in each profile: the app prevents duplicating the same bill.
  • Encerrar nunca apaga o pago: ao encerrar uma recorrência, cobranças futuras somem, mas as parcelas já pagas viram avulsas e permanecem no histórico.
  • Ending never erases the paid: when you end a recurrence, future charges disappear, but already-paid entries stay in history.
  • 12 meses à frente: a série é sempre mantida com ~12 meses projetados.
  • 12 months ahead: the series is always kept with ~12 months projected.

Orçamento não entra nos números

A quote doesn't enter the numbers

Um orçamento é uma proposta: não conta como faturamento nem lucro até ser convertido em serviço. Ao converter, o número da OS é mantido e o app registra a conversão (métrica de taxa de conversão no Raio-X).

A quote is a proposal: it doesn't count as revenue or profit until converted into a service. On conversion, the order number is kept and the app records it (conversion-rate metric in the X-Ray).

Numeração de OS e de recibo: AAMMDD-NNNN

Order and receipt numbering: YYMMDD-NNNN

Cada ordem recebe um número no formato ano-mês-dia + uma sequência que reinicia a cada dia. É atribuído na criação (mesmo em orçamento) e nunca muda, nem na conversão para recibo. Se a OS estiver parcelada, o número é do documento: todas as parcelas do grupo carregam o mesmo número.

Each order gets a number as year-month-day + a sequence that restarts each day. It's assigned on creation (even for quotes) and never changes, not even when converted to a receipt. If the order is split into installments, the number belongs to the document: every installment in the group carries the same number.

🔎 ExemploExample
  • 2ª OS criada em 26/04/2026 → 260426-0002.
  • 2nd order created on 2026-04-26 → 260426-0002.

O recibo de venda do perfil Vendas passou a usar o mesmo formato: ganha um número na emissão, e todas as parcelas do grupo carregam esse número. Vendas registradas antes desta novidade ficam sem número — nada é inventado para o passado.

Sale receipts in the Sales profile now use the same format: a number is assigned when issued, and every installment in the group carries it. Sales recorded before this update are left without a number — nothing is invented for the past.

OS e venda pagas não se excluem: cancelam

Paid orders and sales aren't deleted: they're canceled

Uma ordem de serviço nunca é apagada. Ela é cancelada: o número e o histórico ficam guardados, ela sai dos totais, do Raio-X, dos avisos da Sentinela e do Relatório de recebimentos, e a repetição (se houver) é encerrada. Um orçamento também não entra no relatório: ele ainda é proposta, não cobrança confirmada. Se mudar de ideia, você pode reativar: a OS volta exatamente ao estado em que estava (serviço ou orçamento). Se a OS estiver parcelada, cancelar ou reativar vale para o documento inteiro — todas as parcelas do grupo mudam juntas. Qualquer parcela paga trava o cancelamento do documento inteiro, mesmo acionando Cancelar a partir de outra parcela — reabra o pagamento antes. Se já houver sinal recebido, o cancelamento também trava; nesse caso, estorne ou zere o sinal antes.

A work order is never erased. It is canceled: its number and history are kept, it leaves the totals, the X-Ray, Sentinel alerts and the Receivables report, and any recurrence is ended. A quote doesn't enter the report either: it's still a proposal, not a confirmed charge. If you change your mind, you can reactivate it: the order returns to exactly the state it was in (service or quote). If the order is split into installments, canceling or reactivating applies to the whole document — every installment in the group changes together. Any paid installment locks cancellation for the whole document, even if you tap Cancel from a different installment — reopen the payment first. If a down payment was already received, cancellation locks too; in that case, refund or clear the down payment first.

Uma OS já recebida é imutável: editar ou cancelar exige reabrir antes (o valor sai do "Recebido" ao reabrir). E um orçamento não aceita sinal nem recorrência: esses recursos passam a valer quando ele é convertido em serviço.

A paid order is immutable: editing or canceling requires reopening it first (the amount leaves "Received" when you do). And a quote takes no down payment or recurrence: those apply once it's converted into a service.

🔎 ExemploExample
  • A OS 260426-0002 foi cancelada por desistência do cliente. O número não é reaproveitado; a OS fica na seção "Canceladas". Semanas depois o cliente voltou → Reativar e ela volta como estava.
  • Order 260426-0002 was canceled because the client backed out. The number isn't reused; the order sits under "Canceled". Weeks later the client returned → Reactivate and it's back as it was.

A mesma regra vale para o perfil Vendas: enquanto a venda está toda em aberto, editar e excluir funcionam normalmente. Assim que qualquer parcela é paga, a venda fica protegida — editar e excluir exigem desfazer o pagamento primeiro. Cancelar continua disponível para venda sem parcela paga; a venda cancelada some dos totais mas continua na lista, de onde pode ser reativada. Uma venda com parcela paga não pode ser cancelada diretamente — cancelar apagaria receita de um mês possivelmente já fechado, o mesmo motivo pelo qual a OS recebida é protegida.

The same rule applies to the Sales profile: while the sale is fully open, editing and deleting work as usual. As soon as any installment is paid, the sale becomes protected — editing and deleting require undoing the payment first. Canceling stays available for a sale with no paid installment; a canceled sale disappears from totals but stays in the list, from where it can be reactivated. A sale with a paid installment cannot be canceled directly — canceling would erase revenue from a month that might already be closed, the same reason a paid order is protected.

Uma vez cancelada, a venda também para de gerar cobrança — inclusive nos avisos da Sentinela — e sai do relatório de comissão do Gerente. Isso vale em todas as telas: a venda cancelada não aparece como pendência em nenhuma delas.

Once canceled, the sale also stops generating charges — including Sentinel alerts — and drops out of the Manager's commission report. That applies across every screen: a canceled sale shows up as outstanding nowhere.

Home conta por vencimento, Raio-X conta pela data da venda

Home counts by due date, X-Ray counts by sale date

No perfil Vendas, a Home soma as parcelas que vencem no mês — é fluxo de caixa: o que precisa entrar de dinheiro agora, não importa quando a venda foi fechada. O Raio-X soma pela data da venda — é desempenho comercial: quanto você vendeu naquele mês, não importa quando as parcelas vencem. Nenhum dos dois está errado: são perguntas diferentes, e por isso as duas telas mostram um rótulo dizendo qual critério cada uma usa.

In the Sales profile, the Home screen sums installments due in the month — that's cash flow: what needs to come in now, regardless of when the sale was closed. The X-Ray sums by sale date — that's commercial performance: how much you sold that month, regardless of when the installments are due. Neither is wrong: they answer different questions, which is why both screens show a label stating which criterion each one uses.

🔎 ExemploExample
  • Venda de R$ 300,00 em 3×, fechada em janeiro. A Home mostra R$ 100,00 em cada um dos três meses (jan, fev, mar), acompanhando cada parcela que vence. O Raio-X mostra os R$ 300,00 inteiros em janeiro, o mês em que a venda foi feita.
  • A $300.00 sale in 3×, closed in January. The Home screen shows $100.00 in each of the three months (Jan, Feb, Mar), following each due installment. The X-Ray shows the full $300.00 in January, the month the sale happened.

Sinal e a data certa da renda

Down payment and the right income date

Se você recebe um sinal, ele vira renda na data do sinal; o saldo restante vira renda na data em que você quita o serviço. Assim, cada valor aparece no mês em que o dinheiro realmente entrou. Numa OS à vista, o sinal nunca passa do total; numa OS parcelada, o teto é o valor da 1ª parcela.

If you take a down payment, it becomes income on the down-payment date; the remaining balance becomes income on the day you settle the service. So each amount shows up in the month the money actually arrived. On a cash order, the down payment never exceeds the total; on a split order, the cap is the amount of the first installment.

Retenção de INSS (RPA): o recibo cobra o líquido

INSS withholding (RPA): the receipt charges the net

Na OS você define quem paga. Se for uma empresa ou condomínio que, sem nota fiscal, retém por lei os 11% de INSS (RPA), o Recibo mostra o total, a linha "Referência RPA, INSS 11%" e o valor líquido. O QR Pix e o Pix copia e cola já cobram o líquido, e a renda registrada no app também é a líquida. É um cálculo de referência, sem valor fiscal; a guia do INSS é responsabilidade de quem retém.

On the order you set who pays. If it's a company or condo association that, without a tax invoice, legally withholds the 11% INSS (RPA), the Receipt shows the total, the "RPA reference, 11% INSS" line and the net amount. The Pix QR and the copy-and-paste Pix code already charge the net, and the income recorded in the app is the net too. It's a reference calculation with no tax validity; the INSS payment slip is the withholder's responsibility.

🔎 ExemploExample
  • Serviço de R$ 285,00 para uma administradora de condomínios → INSS retido R$ 31,35 → o recibo destaca o líquido de R$ 253,65 e o QR Pix cobra exatamente esse valor.
  • A $285.00 service for a condo management company → $31.35 INSS withheld → the receipt highlights the $253.65 net and the Pix QR charges exactly that.

Período de relatórios: o que incluir?

Report period: what to include?

Ao gerar um relatório cujo período alcança datas futuras, aparece o interruptor "Incluir o que ainda vai vencer". Quando desligado, o relatório vai até hoje (e o que vence hoje continua dentro). Quando ligado, inclui também datas futuras do período escolhido. A regra varia conforme o tipo de relatório:

When generating a report whose period reaches future dates, a toggle appears for "Include what is not due yet". When off, the report runs through today (and what's due today stays included). When on, it also includes future dates in the chosen period. The rule varies by report type:

  • Extrato (Pessoal, Negócios): Padrão é desligado — extrato é histórico, mostra o que já ocorreu.
  • Statement (Personal, Business): Default is off — a statement is history, showing what has already happened.
  • Vendas por vendedor & Recebimentos: Padrão é ligado — o assunto é justamente o que ainda precisa entrar no caixa.
  • Sales by salesperson & Receivables: Default is on — the point is what still needs to come into the till.

O relatório sempre declara qual recorte está valendo — na tela, no PDF e no texto para o WhatsApp, você verá "até hoje" ou "com o que ainda vai vencer" juntamente com as datas do período.

The report always states which cutoff is in effect — on screen, in the PDF and in the WhatsApp text, you'll see "up to today" or "including what is not due yet" next to the period dates.

O Quem está devendo não tem esse interruptor, e é de propósito: ele é uma foto de agora — há quanto tempo cada cobrança está em aberto, contada até hoje. Um recorte de período ali produziria a pergunta sem sentido "quem estava devendo em março".

Who owes you has no such toggle, on purpose: it is a snapshot of right now — how long each charge has been outstanding, counted up to today. A period filter there would answer the meaningless question "who owed me back in March".

Grátis vs PRO (e o que acontece ao perder o PRO)

Free vs PRO (and what happens if PRO ends)

Sem PRO, você usa só o perfil Pessoal, o tema do Sistema e nada de texturas, backup ou exportação CSV. Se o PRO expira, nenhum dado é apagado: o app apenas volta ao modo gratuito e reativa tudo quando você renova.

Without PRO you use only the Personal profile, the System theme and no textures, backup or CSV export. If PRO expires, no data is deleted: the app simply returns to free mode and reactivates everything when you renew.

Uma exceção: na Central de Relatórios, o Extrato do período do perfil Pessoal é livre mesmo sem PRO — sempre foi. Os demais relatórios (Negócios, Vendas, Serviços e os relatórios novos, como o Quem está devendo) são PRO, liberados também durante o teste grátis de 7 dias.

One exception: in the Reports Hub, the Personal profile's period Statement is free even without PRO — it always was. The other reports (Business, Sales, Services and the new ones, like Who owes you) are PRO, also unlocked during the 7-day free trial.

Comparar Grátis e PROCompare Free and PRO