Por qué se necesita una API de cálculo de impuestos específica
El sistema tributario de Brasil ha sido calificado por organismos financieros internacionales (IMF / OECD) como uno de los más complejos del mundo. Solo la circulación de mercancías implica:
- ICMS · Impuesto estatal sobre la circulación de mercancías, con legislación independiente en los 27 estados, alícuota habitual del 7-25%
- ICMS-ST · Sustitución tributaria, en la que el fabricante o distribuidor retiene por anticipado el impuesto a pagar aguas abajo
- DIFAL · Diferencial del impuesto estatal en transacciones interestatales, que hay que complementar o reembolsar
- IPI · Impuesto federal sobre productos industrializados, con una alícuota específica por código de mercancía NCM (más de 10000 tipos)
- PIS / COFINS · Contribuciones sociales federales (sustituidas gradualmente por la CBS desde 2026)
- ISS · Impuesto sobre servicios (municipal, sustituido gradualmente por el IBS desde 2026)
- CBS / IBS 2026 · Nuevos tributos tras la reforma fiscal; coexisten los antiguos y nuevos durante el período de transición
Que un ERP implemente estos cálculos por su cuenta es prácticamente imposible: solo el ICMS exige mantener una base de alícuotas multidimensional de 27 estados × categoría de mercancía × tipo de cliente, y las alícuotas pueden ajustarse cada mes. La tasa de error del cálculo manual supera el 30%, y un cálculo erróneo lleva al rechazo de la factura, a una devolución de impuestos compleja y a un alto riesgo de cumplimiento.
Capacidades principales de la API de cálculo de impuestos de TF Fiscal
1. Soporte para todos los tributos
En una sola llamada, devuelve el detalle de todos los tributos a pagar. Sin necesidad de consultas múltiples.
2. Vinculación con el código NCM de la mercancía
Introduzca el código NCM de la mercancía (clasificación de mercancías de Brasil, compatible con el código HS aduanero) y se aplican automáticamente las alícuotas correspondientes de IPI y PIS / COFINS. ¿No conoce bien el código NCM? Puede ayudarse de la función de coincidencia aproximada de NCM por nombre de la mercancía de TF Fiscal.
3. Determinación automática del DIFAL interestatal
Cuando el estado de envío ≠ estado de recepción, determina automáticamente si procede incluir el DIFAL y calcula el importe a complementar / a reembolsar según la diferencia de alícuotas con el estado de destino.
4. Base de reglas nacional del ICMS-ST
¿Qué mercancías requieren ICMS-ST? ¿Cuál es el porcentaje de retención? ¿Qué es el valor base (MVA)? — Todo incorporado en la base de reglas y aplicado automáticamente.
5. Identificación del tipo de cliente
El algoritmo de cálculo de la alícuota difiere si una misma mercancía se vende a un "distribuidor", a un "consumidor final" o a una "pequeña empresa acogida al régimen Simples Nacional". La API admite el envío del tipo de cliente para ajustarlo automáticamente.
6. Cálculo de doble vía CBS / IBS
Durante el período de transición de la reforma fiscal coexisten los tributos antiguos y nuevos. La API devuelve a la vez el "importe del impuesto antiguo" y el "importe del impuesto nuevo", para que usted elija la forma de declaración o la conciliación.
Ejemplo de la API
POST /v1/tax/calculate
{
"ncm": "8517.12.31",
"valor": 1000.00,
"uf_origem": "SP",
"uf_destino": "RJ",
"tipo_cliente": "PJ_consumidor_final",
"regime_emit": "Lucro_Real"
}
Response:
{
"icms": { "aliquota": 0.18, "valor": 180.00 },
"icms_st": null,
"difal": { "aliquota": 0.02, "valor": 20.00 },
"ipi": { "aliquota": 0.15, "valor": 150.00 },
"pis": { "aliquota": 0.0165, "valor": 16.50 },
"cofins": { "aliquota": 0.076, "valor": 76.00 },
"cbs_simulacao_2026": { "valor": 87.00 },
"valor_total_com_impostos": 1442.50
}
Escenarios de uso típicos
- Cotizaciones en el ERP: cálculo de impuestos incluido en tiempo real al fijar el precio de la mercancía, evitando descuadres posteriores en el importe de la factura
- Fijación de precios en comercio electrónico: mostrar precios con impuestos distintos según el estado de destino
- Conciliación financiera: comparar con el importe real de impuestos de las NF-e ya emitidas para detectar anomalías
- Conciliación transfronteriza: cálculo de la diferencia de impuestos al liquidar entre la entidad china y la entidad brasileña
Precios
- Facturación por llamada: R$ 0,10 / llamada
- Solución personalizada para grandes empresas: para clientes con un alto volumen de llamadas, cálculo masivo entre regiones o requisitos de SLA dedicado, ofrecemos una personalización individualizada: precios por paquete anual / por línea de negocio, con gestor de cuentas dedicado, pool de recursos independiente y soporte técnico prioritario. Contacte con ventas para obtener una cotización →
Preguntas frecuentes
P: ¿Qué hago si no conozco el código NCM?
Proporcione el nombre de la mercancía y el sistema realizará una coincidencia aproximada de los candidatos de NCM más probables. La recomendación final debe confirmarla usted o el área financiera de su empresa.
P: ¿Con qué frecuencia se actualiza la base de alícuotas?
Cada mes se realiza un escaneo y actualización de los anuncios de alícuotas de los 27 estados; en caso de una reforma fiscal urgente, se sincroniza en un plazo de 48 horas.
P: ¿Se puede usar para la planificación fiscal?
Se pueden hacer comparaciones y simulaciones básicas, pero para una planificación concreta se recomienda consultar a un asesor fiscal profesional. Esta API solo realiza el cálculo conforme y no ofrece recomendaciones de elusión.
Soluciones relacionadas