Impuestos y cumplimiento¶
4Geeks Payroll aplica las tasas de un país por workspace: el que eliges en Configuración → Negocio. Esta página explica los packs propuestos, la firma del cliente que habilita el pago y el checklist que verifica la consola.
En resumen
Para: administradores de planilla y quien firma las tasas de la empresa.
Tiempo: 10 minutos para revisar y firmar; editar una tasa toma un minuto.
Resultado: planilla en el país correcto, con las tasas que firmó la empresa.
El país de cumplimiento¶
La consola toma el país de Configuración → Negocio (company_profiles.country) y lo replica en la configuración de planilla. No hay un selector de país aparte en Impuestos y cumplimiento: lo que ves es el país de cumplimiento.
- Solo el dueño y los administradores del workspace pueden cambiarlo.
- Se admiten 18 países de LATAM: Argentina, Bolivia, Brasil, Chile, Colombia, Costa Rica, Ecuador, El Salvador, Guatemala, Honduras, México, Nicaragua, Panamá, Paraguay, Perú, República Dominicana, Uruguay y Venezuela.
- Un país fuera de LATAM deja el país de cumplimiento vacío. La planilla muestra el aviso “define el país del negocio” y no puede aplicar tasas.
- Los empleados nuevos heredan el país por trigger de base de datos, incluidos los imports CSV y las escrituras por API. Los empleados existentes no se reescriben en silencio: la consola muestra la diferencia y ofrece Alinear N empleados, una acción explícita y auditada.
- El cambio de país se bloquea mientras el workspace tenga empleados, filas de impuestos, tablas de renta o borradores del país anterior (
PAYROLL_COMPLIANCE_COUNTRY_LOCKED, con los conteos en el detalle). Alinea los empleados, elimina la configuración del país anterior (Impuestos y cumplimiento muestra las filas inactivas) y vuelve a guardar.
Los packs propuestos¶
Cada país trae un pack propuesto de régimen general. Las tasas son un punto de partida que la empresa revisa, edita si hace falta y firma; 4Geeks no las certifica.
| País | Empleado | Empleador | Tabla de renta |
|---|---|---|---|
| Argentina | 17,00% | 25,11% | 2025 |
| Bolivia | 11,71% | 6,71% | 2025 (RC-IVA) |
| Brasil | 7,5–14% (INSS, progresivo) | 35,80% | 2025 |
| Chile | 20,20% | 10,30% | 2025 |
| Colombia | 8,00% | 30,02% | 2025 |
| Costa Rica | 10,83% | 26,83% | 2026 (Hacienda) |
| Ecuador | 7,20% | 22,48% | 2025 |
| El Salvador | 10,25% | 9,75% | 2025 |
| Guatemala | 4,83% | 14,67% | 2025 |
| Honduras | 3,50% | 9,50% | 2025 |
| México | 2,295% | 18,275% | 2025 |
| Nicaragua | 7,00% | 23,50% | 2025 |
| Panamá | 9,00% | 18,35% | 2025 |
| Paraguay | 9,00% | 23,80% | 2025 |
| Perú | 12,50% | 10,15% | 2025 |
| República Dominicana | 5,91% | 16,34% | 2025 |
| Uruguay | 18,00% | 14,50% | 2025 |
| Venezuela | 5,50% | 15,00% | Manual |
Cada pack se desglosa en líneas individuales (por ejemplo CCSS/IVM en Costa Rica, IMSS/INFONAVIT en México, AFP/ISAPRE en Chile, INSS/FGTS en Brasil) que puedes revisar, editar o eliminar.
Techos y aportes progresivos
Una fila puede tener un techo de aporte (max_base): el bruto por encima no cotiza (México, Chile, Panamá, Honduras, El Salvador, República Dominicana). El INSS obrero de Brasil es progresivo: cada tasa aplica a su tramo. Ambos campos son opcionales y quedan vacíos en Costa Rica, así que su cálculo no cambia.
Impuesto sobre la renta¶
La consola retiene renta salarial cuando el país tiene una tabla vigente:
- 17 tablas incluidas (Argentina, Bolivia, Brasil, Chile, Colombia, Costa Rica, Ecuador, El Salvador, Guatemala, Honduras, México, Nicaragua, Panamá, Paraguay, Perú, República Dominicana, Uruguay). Venezuela no trae propuesta: agrega la tuya y fírmala.
- Base después de cargas sociales: en la mayoría de los países la base es el bruto menos las cargas del empleado del mismo pago. Costa Rica mantiene la base bruta.
- Cargas familiares: pueden ser un crédito fiscal sobre el impuesto calculado (Costa Rica) o una deducción de la base (Argentina).
- Moneda: la tabla solo aplica cuando su moneda coincide con la moneda de la planilla. La pantalla avisa cuando difieren (por ejemplo, un workspace de Costa Rica pagando en USD) y no se retiene hasta que coincidan.
Edita o agrega una tabla en Impuestos y cumplimiento → Impuesto sobre la renta. Las versiones nuevas conservan el historial: una tabla aplica desde su fecha de vigencia y no reescribe recibos anteriores.
Instalar o restaurar el pack¶
Al definir o cambiar el país del negocio, la consola instala el pack propuesto automáticamente: filas de cargas sociales, tabla de renta y feriados del año. Nunca sobrescribe filas que ya existan para ese país.
Si editaste las filas y quieres la propuesta de vuelta, usa Restaurar tasas propuestas. La tarjeta del país muestra la versión del pack, sus fuentes públicas y el salario mínimo de referencia.
El cliente firma las tasas¶
El pago queda bloqueado hasta que la empresa firme las tasas que va a usar.
- Haz clic en Revisar y firmar.
- Revisa cada tasa, techo, tramo progresivo y la tabla de renta.
- Escribe el nombre completo de quien firma, agrega una nota opcional y confirma la declaración de responsabilidad.
- La consola guarda la firma con el hash calculado en el servidor de las filas exactas, el nombre, el usuario, el email, el rol y la fecha. También queda en la auditoría.
Si después cambia cualquier tasa o tabla, la firma queda obsoleta y la consola pide una nueva. El hash lo calcula la base de datos (payroll_compliance_config_hash), nunca el navegador, así que la firma cubre exactamente lo que usa la planilla.
Bloqueo de pago
Una corrida puede ser borrador o enviarse a aprobación sin firma, pero no puede aprobarse, pasar a Processing/Completed ni pagarse —y un recibo no puede marcarse Pagado— hasta que la firma coincida con las tasas vigentes (PAYROLL_COMPLIANCE_NOT_SIGNED).
El checklist de cumplimiento¶
El checklist se calcula con los datos del workspace, no está fijo. Marca:
- el país de cumplimiento ausente o no soportado;
- el pack no instalado, o sin filas obreras/patronales;
- sin tabla de renta para el país;
- la moneda de la tabla de renta no coincide con la de la planilla;
- empleados activos de otro país (con la acción Alinear);
- feriados del año sin cargar;
- tasas sin firmar o firma obsoleta.
Los errores bloquean el pago; las advertencias son recomendaciones. Resuélvelos antes de correr planilla.
Presentaciones electrónicas¶
La misma pantalla lista las presentaciones periódicas del país: vencimientos, estado, referencia de la agencia y constancia. El archivo CCSS SICERE de Costa Rica lo genera la consola (registros 25, 35 y 15) y el INS tiene conector por API. Consulta Presentaciones electrónicas para el paso a paso y el canal por país.
Solución de problemas¶
| Síntoma | Causa y solución |
|---|---|
PAYROLL_COMPLIANCE_COUNTRY_LOCKED | Quedan empleados, filas de impuestos, tablas de renta o borradores del país anterior. Alinea los empleados, elimina la configuración anterior y vuelve a guardar el país. |
PAYROLL_COMPLIANCE_NOT_SIGNED | Las tasas nunca se firmaron o cambiaron después de la firma. Abre Revisar y firmar y firma de nuevo. |
PAYROLL_COMPLIANCE_COUNTRY_FORBIDDEN | Solo el dueño y los administradores del workspace pueden cambiar el país. |
| La tarjeta del país dice “sin configurar” | El país del negocio está vacío o no es de LATAM. Defínelo en Configuración → Negocio. |
| No se retiene renta | No hay tabla para el país, la moneda de la tabla no coincide con la de la planilla o los salarios están por debajo del primer tramo. |
| “Sin cargas obreras/patronales” | El pack no está instalado o se borraron todas las filas. Instala o restaura el pack propuesto. |
Preguntas frecuentes¶
¿Puedo tener empleados en varios países en un workspace?
No. La planilla tiene un país de cumplimiento por workspace, igual que la moneda única. Los empleados de otro país deben alinearse (o pasar a su propio workspace) antes de pagar.
¿Puedo cambiar el país después?
Sí, cuando el workspace no tenga empleados, filas de impuestos, tablas de renta ni borradores del país anterior. Los recibos pasados conservan su snapshot; el cambio solo afecta lo que viene.
¿Las tasas propuestas son oficiales?
Son la propuesta de régimen general que incluye la consola, con fuentes públicas. La empresa las revisa y las firma; los regímenes especiales (SIMPLES, monotributo, servicio doméstico, convenios colectivos) y las presentaciones legales quedan fuera del alcance.
¿4Geeks presenta ante la agencia por mí?
No. La consola genera el archivo oficial y guarda su evidencia; el cliente lo sube y registra la constancia. La única API directa hoy es el INS de Costa Rica, y el cliente siempre aporta el certificado y la autorización.
¿Por qué mi firma quedó obsoleta?
Cualquier cambio en una tasa, un techo, un tramo progresivo o la tabla de renta cambia el hash. Es deliberado: la firma cubre los valores exactos que usa la planilla.
Relacionado¶
¿Aún tienes dudas? Pregunta en Discord o explora los tutoriales.