Fiscal brasileño nativo — no es adaptación de extranjero.
NFS-e vía NFe.io o provider propio. 4 regímenes tributarios cubiertos. 8 tipos de tributo. RBT12 + Factor R para Simples. Retenciones automáticas. Cierre mensual.
Funcionalidad
4
regímenes tributarios
8
tipos de tributo
∞
municipios (vía NFe.io)
RBT12
calculado automáticamente
Regímenes soportados en TaxationRegime
Simples Nacional
Para empresas hasta R$ 4,8 mi/año. RBT12 calculado mensualmente (Rbt12Record). Factor R para servicios (Anexo III o V).
- Anexos III, IV, V
- factorR = nómina / ingresos
- DAS estimado por factura
- Worker simples-rbt12 mensual
Lucro Presumido
Para empresas hasta R$ 78 mi/año. Base presumida sobre facturación (default 32%).
- presumptionRate configurable (default 32%)
- PIS + COFINS acumulativos
- IRPJ + CSLL trimestrales
Lucro Real
Para empresas por encima de R$ 78 mi/año. Base en el lucro contable real. PIS + COFINS no acumulativos.
- Lucro contable real
- PIS + COFINS no acumulativos
- Soporte completo
MEI
Microemprendedor individual hasta R$ 81 mil/año. Valor fijo mensual. Exento de NFe entre PJ.
- Valor fijo mensual
- Exento de NFe entre PJ
- Soporte completo
Qué hace el motor fiscal
NFS-e Automática
Emisión post-pago vía NfeService. Provider NFe.io o Kobana propio. Worker nfe-retry (30min) reprocesa fallos.
- nfeIssuancePolicy: disabled, on_finalization, on_full_payment, per_installment
- NfeRequestTry registra cada intento
- PDF + XML disponibles para descarga
Motor Tributario (TaxRule)
Reglas con scope (organization, company, service), prioridad y período de vigencia. TaxRuleItem detalla cada tributo aplicado.
- 8 tipos: ISS, PIS, COFINS, CSLL, IRPJ, IRRF, CSRF, INSS
- isWithheld determina retención en la fuente
- isExempt + exemptionReason para exenciones
- BaseType: service_value | service_value_minus_iss | presumed_base
Retenciones en la Fuente
Withholding registrado por factura/NFe. WithholdingStatus: retained | compensated | partially_compensated. Cierre mensual para compensación.
- IRRF (1,5% – 15%)
- CSRF: PIS + COFINS + CSLL = 4,65%
- INSS (11% en cesión de mano de obra)
- ISS retenido (2% – 5% según municipio)
Simples Nacional (RBT12 + Factor R)
Rbt12Record acumula ingresos brutos de los últimos 12 meses. Factor R = nómina / ingresos determina migración Anexo V → III.
- Actualización mensual automática
- Alícuota efectiva: (RBT12 × alícuota − deducción) / RBT12
- DAS estimado por factura
- Soporte a Anexo III, IV, V
Cierre por Período (TaxPeriod)
TaxPeriod mensual o trimestral por Company. Consolida ingresos brutos, tributables, retenciones y tributo debido.
- Worker tax-period (mensual, día 5) crea período
- TaxComputation detalla por tributo
- Informes listos para contabilidad
ServiceItem (Códigos Fiscales)
Cada servicio con código LC 116/2003, código municipal, NBS, CNAE. Determina alícuota ISS automáticamente.
- DataLc116 (tabla completa)
- DataNbs (Nomenclatura Brasileña de Servicios)
- DataCst (Código de Situación Tributaria)
- SimplesAnnex por ítem
Certificado Digital A1
Certificate model almacena certificado A1 (PFX/PEM) cifrado. Validez registrada, alerta de vencimiento.
- AES-256-GCM en reposo
- Contraseña cifrada separadamente
- Notificación 30 días antes del vencimiento
Providers de NFS-e
NFe.io (cobertura nacional) o provider propio Kobana para municipios específicos. NfseAdn + NfseBarueri implementados nativamente.
- NfeProviderType: mock | nfe_io
- Configuración por organización (NfeConfig)
- Sandbox aislado para pruebas
Configurar fiscal por empresa vía API
bash
curl -X POST https://api.billing.kobana.com.br/v1/companies/co_123/fiscal-profile \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"taxation_regime": "simple_national",
"simples_annex": "annex_iii",
"iss_municipality": "3550308",
"iss_rate": 2.5,
"factor_r": 0.32,
"cpp_inside_das": true
}'response
{
"id": "fp_xyz",
"taxation_regime": "simple_national",
"simples_annex": "annex_iii",
"current_rbt12_cents": 48000000,
"effective_rate": 6.0,
"das_estimate_cents": 14400
}