Retenções na Fonte
Retenções são impostos retidos pelo pagador (cliente) que devem ser rastreados, reportados e compensados.
Tipos de Retenção
| Imposto | Descrição |
|---|---|
| ISS | Retido pelo tomador do serviço |
| IRRF | Imposto de renda retido na fonte |
| CSRF | PIS + COFINS + CSLL combinados (4,65%) |
| INSS | Contribuição previdenciária |
Campos da Retenção
| Campo | Descrição |
|---|---|
| Fatura | Fatura de origem |
| NF-e | Nota fiscal relacionada |
| Tipo de imposto | Qual imposto foi retido |
| Base (centavos) | Base de cálculo |
| Alíquota | Percentual retido |
| Valor (centavos) | Montante retido |
| Retentor | Entidade que reteve (geralmente a conta de cobrança) |
| Mês/Ano de competência | Período contábil |
| Status | Estado da retenção |
| Compensado (centavos) | Valor já utilizado para abater impostos |
Status da Retenção
| Status | Descrição |
|---|---|
retained | Registrada, ainda não compensada |
compensated | Totalmente compensada |
partially_compensated | Parcialmente compensada |
Fluxo
- Criação: Gerada automaticamente a partir do cálculo de impostos de cada fatura
- Retenção: O valor é retido pelo cliente no momento do pagamento
- Rastreamento: Armazenada por mês/ano de competência
- Compensação: Aplicada para reduzir a obrigação tributária nos períodos seguintes
- Reconciliação: Reportada nas declarações fiscais
Configuração por Cliente
Cada conta de cobrança pode ter flags individuais de retenção:
withholdIss— Reter ISSwithholdIrrf— Reter IRRFwithholdCsrf— Reter CSRF (PIS/COFINS/CSLL)withholdInss— Reter INSS
Essas flags sobrescrevem o comportamento padrão das regras fiscais.
Captura de tela
A tela /dashboard/withholdings lista todas as retenções da organização, com filtros por tipo de imposto, status, mês/ano de competência, empresa retentora e busca por fatura ou NF-e. Cada linha mostra base, alíquota, valor retido, valor já compensado e ações para abrir a fatura/NF-e de origem.
