Legislación de nóminas: guía desde cero

La ventana de Personal guarda a la persona y la cifra bruta. Esta ventana se apoya en ella y hace los cálculos que exige la legislación del país: cotizaciones a la seguridad social, impuesto sobre la renta, paga obligatoria de fiesta religiosa, indemnización por salida, registro de contratos, salario mínimo regional e informes oficiales. Una sola regla lo gobierna todo: ningún tipo, tope ni tramo está escrito en el código. Cada cifra es un parámetro, y la pantalla muestra el nombre del parámetro y su estado de confirmación junto al cálculo.

1. ¿Para qué sirve esta ventana y quién la necesita?

La diferencia entre dos países no está en las cifras, sino en los conceptos. En Turquía hay un único organismo de seguridad social; en Indonesia hay dos organismos y cinco programas distintos. En Turquía no hay paga obligatoria; en Indonesia hay una paga que debe abonarse antes de una fiesta religiosa, y su fecha depende de la religión del trabajador. En Turquía el salario mínimo es una cifra única nacional; en Indonesia cada distrito fija la suya. Esta ventana lleva esos conceptos.

LA REGLA MÁS IMPORTANTE: esta ventana NO escribe deducciones en la nómina. Los cálculos de cotizaciones e impuestos son informativos: sirven para conciliar con su nómina oficial, comprobar una cifra e informar. No son una orden de pago. En la parte superior de cada pantalla hay una nota de alcance escrita por el servidor; léala.

2. Conozcamos la pantalla: nueve pestañas

Los TABS, en breve: Contribuciones (seguridad social) · Impuesto (reporte de impuestos de ingresos + tabla de bracket) · Bonus (THR) · Derecho de salida (compensación / pesangon) · PKWT (Aviso de registro y expiración) · Miembros de la familia · WLKP (Raporte anual de empleo) OHS (P2K3 El informe semanual) · Parámetros.

En la fila superior aparecen el código de país y la moneda. Junto a ellos pueden salir dos insignias: "faltan n parámetros" (una cifra que el cálculo necesita está vacía) y "La tabla de tramos está vacía". Con la insignia visible los cálculos se ejecutan igualmente, pero la partida que falta sale 0 y la pantalla se lo dice: no hay ceros silenciosos.

3. La regla de los parámetros y la insignia CONFIRMAR

Bajo cada cálculo hay una fila "Parámetros utilizados"; al pulsarla se despliega. Allí figuran la clave, el valor y la fuente de cada cifra que entró en el cálculo. Si en la fuente pone CONFIRMAR, ese valor procede de una investigación y debe ser verificado por su asesor fiscal local. Para corregir valores use la ventana de Personal → pestaña Legislación; el cálculo de aquí leerá el valor nuevo en su próxima ejecución, sin necesidad de una versión nueva.

4. Pestaña Cotizaciones: la seguridad social

Escriba el periodo (AAAA-MM) y pulse Calcular. Para cada persona salen por separado los cinco programas (JKK accidente laboral, JKM fallecimiento, JHT ahorro por antigüedad, JP jubilación, JKP desempleo) y la cotización sanitaria; las partes de la empresa y del trabajador van aparte. Dos matices: la base de la JP está limitada por un tope salarial (si en la columna "base JP" aparece la insignia "tope", a esa persona se le aplicó el tope) y la cotización sanitaria es por unidad familiar: si el trabajador más los familiares asegurados superan cierto número, se calcula una cotización adicional por cada miembro de más.

5. Pestaña Impuesto: primero la tabla de tramos

Esta pestaña nace con la tabla vacía, y es a propósito: las tablas oficiales de retención mensual (TER A/B/C) son largas y pueden cambiar cada año; el programa no se las inventa. Elija la categoría en la tabla inferior e introduzca las filas del anexo oficial, o cargue la lista que le dio su asesor. Para los tramos progresivos anuales, el botón Sugerir plantilla trae una propuesta, y ninguna propuesta entra en un cálculo hasta que usted la apruebe.

El cálculo mensual es sencillo: se localiza la categoría fiscal de la persona (que viene de su situación familiar) y se aplica el tipo del tramo en el que cae el bruto. En el mes de regularización (diciembre por omisión) el cálculo cambia: del bruto anual se restan la deducción por gastos profesionales, las cotizaciones a cargo del trabajador y la reducción por situación familiar; al resto se le aplican los tramos progresivos y se compensan los importes retenidos a lo largo del año. Ese mes la tabla muestra dos columnas más.

6. Paga extra (THR): la fecha depende de la religión

Escriba el año y pulse Calcular. También tiene derecho quien lleve menos de un año: el importe es proporcional, meses ÷ 12. La fecha límite de pago se obtiene contando hacia atrás desde la fiesta que corresponde a la religión de la persona. Si la fecha ya pasó, la fila se marca con una insignia roja de "vencido" y los días transcurridos. No se calcula recargo por demora: el recargo es una sanción oficial y este programa no inventa su importe.

Hace falta un calendario. Las fechas de las fiestas vienen de Personal → calendario de festivos y su tipo debe ser "religiosa". Si el calendario está vacío el cálculo se ejecuta igualmente, pero no sale la fecha límite; la pantalla muestra el aviso "TAKVIM_YOK" (no hay calendario).

7. Indemnización por salida: el tipo de contrato lo cambia todo

Escriba el número de personal, elija el tipo de contrato si hace falta y pulse Calcular. En el contrato de duración determinada (PKWT), al finalizar nace la uang kompensasi: mín(1, meses ÷ 12) × salario mensual. El punto crítico es este: ese derecho nace también con menos de un año de antigüedad. El cálculo antiguo anulaba las antigüedades inferiores a 12 meses; ahora la antigüedad mínima es un parámetro y en el conjunto indonesio vale 1 mes. En el contrato indefinido (PKWTT) se usa una tabla escalonada: el número de salarios mensuales que corresponde al año de antigüedad (pesangon) y, si procede, el premio por servicio (UPMK) salen como partidas separadas. La compensación por vacaciones no disfrutadas (UPH) se añade en ambos casos.

Turquía no cambia. En el conjunto turco las tablas escalonadas se dejan vacías; cuando la tabla está vacía el cálculo recae en la vía lineal antigua (años de antigüedad × días de indemnización × salario diario) y reproduce exactamente la cifra actual.

8. Pestaña PKWT: el riesgo jurídico silencioso

Un contrato de duración determinada debe registrarse ante la autoridad dentro de un plazo desde la firma. Un contrato sin registrar puede convertirse en indefinido, y eso ocurre sin que nadie se dé cuenta. Esta pestaña genera dos avisos: registro fuera de plazo y vencimiento próximo. Con el botón "Introducir registro" de la fila de registro se guardan el número y la fecha; el dato se escribe tanto en el contrato como en la ficha de personal, y el aviso desaparece de la lista.

9. Familiares: alimentan dos cálculos a la vez

Escriba el número de personal, pulse Traer y con Añadir miembro registre al cónyuge, a los hijos o a los progenitores. Esta lista se usa en dos sitios: el número de personas de la unidad familiar en la cotización sanitaria y la categoría de reducción en el impuesto sobre la renta (si hay cónyuge y cuántas personas a cargo). En una empresa sin registros de familiares, la cotización sanitaria sale corta y la categoría fiscal sale con la reducción más baja.

10. Informes WLKP y PRL: cifras, no un fichero oficial

El WLKP tab produce la tabla anual de empleo: género, educación, tipo de contrato, tipo de empleo, departamento y divisións de edad; la lista de trabajadores extranjeros; el control de cuota de discapacidad; el OHS miembros del comité (en base al patrón de certificado que define). El OHS La tab permite elegir un período (half año por defecto, o un cuarto) y proporciona los cálculos de accidente / casi error, días de trabajo perdidos, frecuencia y tasa de gravedad, un resumen de las pruebas médicas y exposiciones, y el número de certificados expirando / PPE.

El P2K3 El informe es semanual (Permenaker) 13/2025). El periodo picker en el OHS Por lo tanto, la tab se abre Años de trabajo (6 meses) por default y muestra el semestre actual: 1st medio año de enero a junio, 2nd Semana de julio a diciembre. El cuarto (3 meses) Se puede elegir para el seguimiento interno; pero cuando se elige un cuarto, un aviso en la parte superior de la pantalla dice que este resultado es cuartal y que medio año debe elegirse para el informe oficial.

No se genera ningún fichero oficial. Formatos oficiales como SIPP, Edabu, e-Bupot XML, 1721-A1 o el fichero de registro NO se generan en este programa: adivinar un esquema es más peligroso que no generar nada. Lo que se genera son datos y CSV; las cifras las introduce usted a mano en el portal oficial o las importa en su software contable.

11. Salario mínimo regional

Una única cifra nacional no basta. El programa mira primero el distrito del trabajador, luego su provincia y por último el valor general de la empresa. El patrón de claves es asgari.brut.<CÓDIGO DE DISTRITO> → asgari.brut.<CÓDIGO DE PROVINCIA> → asgari.brut. El código se escribe en ASCII y MAYÚSCULAS: "Bekasi" → BEKASI, "Şanlıurfa" → SANLIURFA. La clave utilizada se ve fila a fila en la tabla de cotizaciones, de modo que una persona asignada a la región equivocada se detecta al instante.

12. Permisos: ¿quién ve y quién escribe?

Para abrir la ventana necesita el permiso del módulo de Personal/RR. HH. Las operaciones de escritura (añadir un familiar, introducir un tramo fiscal, registrar el alta del contrato, fijar el nivel de estudios) exigen el rol de Director de RR. HH. Sin él la ventana se abre en modo solo lectura y lo indica en la fila superior; los botones quedan desactivados. La decisión se toma en el servidor: desactivar un botón en el navegador no es seguridad, solo cortesía.

13. Situaciones frecuentes

Lo que ve	Causa y solución
Todos los importes de cotización salen 0	Si la persona no tiene un contrato en vigor, el bruto es 0. Introduzca el salario desde Personal → pestaña Contrato; en la fila aparece el aviso "El contrato no tiene salario bruto".
La línea JKK siempre sale 0	El tipo de accidente laboral depende de la clase de riesgo de la empresa; como no hay una única cifra correcta, nace vacío. Introduzca el tipo de su clase en el parámetro `sosyal.jkk_oran`.
"VERGI_DILIM_YOK"	La tabla de tramos está vacía. Elija la categoría en la tabla inferior de la pestaña Impuesto e introduzca las filas; para los tramos anuales, "Sugerir plantilla" ofrece un punto de partida.
No se aplica el salario mínimo regional	El código de la clave no coincide exactamente con el nombre del distrito. Mire el texto "fuente" de la tabla de cotizaciones: indica qué clave se usó. El código va en ASCII y mayúsculas (Bekasi → BEKASI).
La indemnización por salida salió 0	La antigüedad está por debajo del parámetro `tazminat.asgari_kidem_ay`, o no hay salario bruto. La nota de la línea le dice cuál de las dos cosas es.
No se calculó el índice de frecuencia/gravedad	Los índices se dividen entre las horas trabajadas; si en el periodo no hay horas de parte de trabajo, no se puede dividir. Introduzca el parte o revise los parámetros multiplicadores.

14. Exportaciones oficiales: SIPP, Edabu, e-Bupot, 1721-A1

La pestaña Exportación oficial convierte las filas producidas por los cálculos de cotizaciones e impuestos al orden de columnas que pide cada portal. Hay cuatro salidas: SIPP (BPJS Ketenagakerjaan), Edabu (BPJS Kesehatan, por unidad familiar: el trabajador más los familiares asegurados), e-Bupot 21/26 (mensual) y Formulir 1721-A1 (anual).

Los nombres de columna no se inventan. Las plantillas de SIPP y Edabu están detrás del acceso al portal, y e-Bupot pasó al XML de Coretax en enero de 2025 sin que se publicara un esquema legible por máquina. Por eso HNR no inventa una lista de columnas: usted define como esquema de declaración las cabeceras de la plantilla que descargó del portal, y la salida las sigue. Si exporta un CSV sin definir esquema, las cabeceras serán los nombres de campo propios de HNR y al final del archivo habrá una línea de aviso que lo indica.

Tres reglas de e-Bupot sí están en el código, porque no son un esquema sino restricciones publicadas por la DJP: el nombre del archivo empieza por el NPWP de 15 dígitos, el archivo contiene como máximo 10.000 filas y no supera 2 MB. El NPWP del empleador viene del parámetro vergi.npwp_isveren; si no tiene 15 dígitos, la exportación se detiene. Si se supera el límite de filas o de tamaño, se le pide que divida el archivo.

El 1721-A1 es solo un BORRADOR. El certificado anual de retenciones pide el importe "efectivamente retenido durante el año"; en HNR el PPh 21 es un informe y no escribe deducciones en la nómina, es decir, no existe un libro real de retenciones. Por eso cada registro de la salida nace con la marca taslak (borrador) y el documento lleva en la cabecera la advertencia "generado con valores TER calculados; no presentar sin conciliar con los registros oficiales de retención". Por el mismo motivo, mientras la tabla de tramos TER esté vacía las salidas fiscales no se generan en absoluto: HNR no inventa la tabla oficial.

Dos puertas. En Ajustes › Puertas de seguridad, vergi.resmi_disa_aktarim está desactivada por omisión; mientras lo esté, estos cuatro puntos de acceso se rechazan y los informes de cotizaciones e impuestos existentes no se ven afectados en absoluto. La segunda puerta es el país: si el conjunto de legislación activo no es Indonesia (ID), los puntos de acceso se detienen con el mensaje "estas exportaciones son para el conjunto de legislación de Indonesia". En una empresa que trabaja con el conjunto turco no cambia ningún comportamiento.

Por qué el Excel se genera en el navegador. En este proyecto está prohibido añadir bibliotecas nuevas al servidor, y el generador de hojas de cálculo ya existe en el navegador. Por eso el servidor le entrega las filas y los nombres de columna, y el botón "Descargar Excel" escribe el archivo en su propio equipo. El CSV y (si hay esquema definido) el XML vienen del servidor.

Guías relacionadas: Recursos Humanos · Ajustes · Seguridad.