Pular para o conteúdo principal
Você sabe como o dinheiro se move e como ele é registrado. Mas quem decide as regras? Quando um pagamento acontece, algo precisa garantir que os tipos certos de conta estejam envolvidos e que as partes certas sejam registradas — toda vez, da mesma forma. E quando uma taxa aparece, de onde ela realmente vem? Esta página desmistifica os dois. Pense em um formulário de papel feito para um tipo de solicitação. Alguém o projetou uma vez — os campos que ele tem, a linha de quem está autorizado a assinar, a regra de como ele é arquivado. Depois disso, qualquer atendente apenas preenche os detalhes, e toda solicitação desse tipo sai idêntica — sem adivinhação. Essa é a ideia por trás de uma rota: defina a regra uma vez, e ela é aplicada da mesma forma toda vez.

​
Uma rota é uma regra reutilizável para um tipo de movimentação

Uma rota é uma regra reutilizável para um tipo de movimentação. Ela responde a três perguntas, uma vez, para que você não as responda de novo a cada transação:
  • Quem pode ser a origem? Quais contas têm permissão para enviar.
  • Quem pode ser o destino? Quais contas têm permissão para receber.
  • Quais partes são registradas? Quais débitos e créditos a movimentação deve produzir.
Defina a regra uma vez, e toda transação desse tipo a segue. Uma rota de “pagamento de cliente” especifica que uma conta de cliente envia, uma conta de comerciante recebe, e exatamente quais operações registrar. Por que isso existe? Para que o mesmo tipo de movimentação seja sempre registrado corretamente, e apenas contas válidas participem. Nenhum atendente preenche o formulário errado, porque o formulário não permite.
Uma rota é como um template de formulário para um tipo de transação. Ela define quem está autorizado e como a movimentação é registrada, para que toda movimentação desse tipo saia idêntica. Uma taxa, como você verá, é apenas uma linha extra nesse formulário.

​
Taxas são apenas mais operações

As taxas parecem misteriosas, mas não são mágica — e não são “subtrair um número e seguir em frente”. Lembre-se de que uma transação é feita de operações (cada uma uma parte — um único débito ou crédito). Uma taxa é simplesmente mais operações na mesma transação, enviando valor para uma conta de taxas ou de receita. Pegue o exemplo um-para-muitos de antes. Um cliente paga R$103:
  • R$100 chegam ao comerciante.
  • R$3 chegam a uma conta de taxas.
Isso é uma transação com três operações. Os R$103 saindo do cliente balanceiam exatamente contra R$100 + R$3 chegando. Nada é inventado ou perdido — a taxa é dinheiro real se movendo para uma conta real, registrado como qualquer outra parte. Como a taxa é parte da mesma transação, ela também é tudo ou nada: o comerciante é pago e a taxa é cobrada juntos, ou nenhum dos dois acontece.

​
Quando você recorreria a rotas e taxas

Você não precisa de uma rota para uma movimentação pontual. Você recorre a uma quando um tipo de movimentação se repete e deve sempre ser registrado da mesma forma — pagamentos, transferências, liquidações. E você adiciona uma taxa sempre que uma movimentação também deve enviar uma fatia de valor para uma conta de receita ou de custo. Definir isso deliberadamente desde o início é parte do planejamento do seu Ledger, que vem a seguir.

​
Em resumo

  • Uma rota é uma regra reutilizável para um tipo de movimentação: quem pode enviar, quem pode receber e quais partes são registradas.
  • As rotas mantêm toda movimentação de um tipo registrada corretamente, com apenas contas válidas participando.
  • Uma taxa não é mágica — é apenas mais operações movendo valor para uma conta de taxas ou de receita (cliente R$103 = comerciante R$100 + taxa R$3).
  • Como a taxa é parte da mesma transação, ela é tudo ou nada junto com o resto.
Veja na LerianVeja essas ideias na prática: Entidades de roteamento de transações e o Plugin de Taxas.