P4 Software P4 Software / NominaHQ

Agrega esta documentación a Claude

Hazle preguntas a Claude sobre esta documentación. Claude lee las páginas publicadas y te enlaza a ellas. Copia esta dirección:

https://docs.p4software.cloud/mcp

En claude.ai o Claude Desktop: abre Configuración, luego Conectores, elige Agregar conector personalizado y pega la dirección.

En Claude Code, ejecuta:

claude mcp add --transport http docs https://docs.p4software.cloud/mcp

Contratos de trabajo

Contratos de trabajo

Aplica a: NominaHQ Roles: Ver: todos los roles del personal (Acceso Total, Captura de Datos, Aprobador, Solo Lectura). Crear/Editar/Eliminar: roles con permiso de escritura (Acceso Total, Captura de Datos). Los administradores tienen acceso total. Referencias regulatorias: Código de Trabajo de Panamá — Art. 68 (contenido del contrato escrito), Art. 74/77 (tipos de contrato), Art. 78 (período de prueba), Art. 30/31 (jornada), Art. 33/49 (Horas extras), Art. 36 (máximo de tiempo extraordinario); registro de contratos ante el MITRADEL.

Resumen

El contrato de trabajo guarda las condiciones pactadas con cada colaborador: tipo de contrato, período de prueba, vigencia, salario mensual, jornada, servicios convenidos, lugar y horario de trabajo, forma y lugar de pago, y la referencia de registro en el MITRADEL. NominaHQ organiza estos datos según el Art. 68 del Código de Trabajo, para que la ficha respalde el documento firmado. Además, la jornada del contrato alimenta la Calculadora de Horas extras (divisor de la hora ordinaria y recargo nocturno). Lo usa el personal que administra la planilla de las empresas clientes.

Navegación

Menú lateral: Empleados → abra la ficha del colaborador (ruta /master/employees/{id}) → tarjeta Contratos de trabajo, debajo del formulario principal y antes de Documentos, Bitácora y Evaluaciones. No hay una opción de menú propia para contratos.

La jornada del contrato también se usa en Nómina → Horas extras (ruta /payroll/horas-extras), donde la Jornada del colaborador se preselecciona a partir de su contrato.

Conceptos clave

  • Tipo de contrato: Indefinido, Plazo definido (a término fijo) u Obra determinada.
  • Período de prueba: lapso inicial en que cualquiera de las partes puede terminar la relación sin responsabilidad. Máximo tres meses (Art. 78); 0 indica que no se pactó.
  • Estado (Vigente / Finalizado): NominaHQ lo calcula con las fechas. Un contrato está Vigente si su fecha de inicio ya llegó y no tiene fecha de fin, o su fecha de fin es hoy o posterior. En otro caso aparece Finalizado, incluido un contrato que aún no inicia.
  • Jornada: Diurna, Nocturna o Mixta. Fija la hora ordinaria (salario ÷ 30 ÷ 8 / 7 / 7.5 horas) y el recargo de las Horas extras nocturnas.
  • Horas semanales: NominaHQ sugiere 48 (diurna), 42 (nocturna) o 45 (mixta) al elegir la jornada; el valor se puede ajustar.
  • Servicios convenidos: descripción de la obra o los servicios que prestará el colaborador (Art. 68.3). Es obligatorio.
  • Referencia MITRADEL: número con que el contrato quedó registrado ante el Ministerio de Trabajo y Desarrollo Laboral.

Tarea 1 — Registrar un contrato nuevo

Antes de empezar: el colaborador debe existir en Empleados (vea Empleados). Necesita el rol Acceso Total o Captura de Datos; los demás roles no ven el botón Nuevo contrato. En el ejemplo se registra el contrato de María Fernanda Castillo Rodríguez (E126).

  1. Abra la ficha del colaborador, desplácese hasta la tarjeta Contratos de trabajo y haga clic en Nuevo contrato.

    Tarjeta Contratos de trabajo sin contratos registrados y el botón Nuevo contrato resaltado

    Si el colaborador aún no tiene contratos, la tarjeta muestra "Sin contratos registrados.".

  2. En Tipo de contrato, deje Indefinido o elija Plazo definido u Obra determinada. En Período de prueba (meses), deje 3 o escriba los meses pactados.

    Campos Tipo de contrato (Indefinido) y Período de prueba (3) resaltados en el cuadro Nuevo contrato

    Art. 78: máximo 3 meses; 0 = sin período de prueba.

  3. En Fecha de inicio, indique desde cuándo rige (en el ejemplo, 09/16/2026). Deje Fecha de fin vacía en un contrato indefinido.

    Campos Fecha de inicio (09/16/2026) y Fecha de fin vacía resaltados

    En un contrato de Plazo definido la Fecha de fin es obligatoria y no puede ser anterior al inicio.

  4. Revise el Salario Mensual. Viene con el salario vigente del colaborador; cámbielo si el contrato pacta otro.

    Campo Salario Mensual resaltado con $1,400.00

    Debe ser mayor que cero.

  5. En Jornada, elija Diurna, Nocturna o Mixta. Las Horas semanales se ajustan solas (48, 42 o 45); corríjalas si el contrato pacta otras.

    Campos Jornada (Diurna) y Horas semanales (48.0) resaltados

    Máximo 48 horas semanales.

  6. En Ref. de registro MITRADEL, escriba el número de registro si ya lo tiene (en el ejemplo, MIT-2026-004512).

    Campo Ref. de registro MITRADEL resaltado con MIT-2026-004512

    Puede completarlo más tarde editando el contrato.

  7. En Servicios convenidos (Art. 68.3), describa la obra o los servicios contratados.

    Campo Servicios convenidos resaltado con la descripción del puesto

    Es obligatorio: sin él, Guardar queda deshabilitado.

  8. Complete Lugar de trabajo (Art. 68.4) y Horario de trabajo (Art. 68.6).

    Campos Lugar de trabajo y Horario de trabajo resaltados y completados

    Ejemplo de horario: L–V 7:00–16:00; sábados 7:00–11:00.

  9. En Forma de pago, deje Transferencia bancaria o elija Efectivo o Cheque, y describa el Día y lugar de pago (Art. 68.7).

    Campos Forma de pago (Transferencia bancaria) y Día y lugar de pago resaltados

    Por ejemplo: "Los días 15 y último de cada mes, por transferencia".

  10. Registre el Lugar de celebración y la Fecha de celebración (Art. 68.8), es decir, dónde y cuándo se firmó.

    Campos Lugar de celebración (Ciudad de Panamá) y Fecha de celebración (09/15/2026) resaltados

    La fecha de celebración se propone como hoy.

  11. En Personas que viven con el trabajador y dependen de él (Art. 68.2), liste los dependientes declarados.

    Campo de dependientes resaltado con Sofía Castillo (hija, 6 años)

    Es opcional.

  12. Haga clic en Guardar.

    Cuadro Nuevo contrato completo con el botón Guardar resaltado

    Guardar queda deshabilitado si el salario es cero, faltan los Servicios convenidos o, en Plazo definido, falta la Fecha de fin.

  13. Revise la tabla: NominaHQ confirma con el aviso Contrato guardado y el contrato aparece como Vigente.

    Tarjeta Contratos de trabajo con el contrato Indefinido del 16/09/2026, MIT-2026-004512, en estado Vigente

    La tabla se ordena por fecha de inicio, del más reciente al más antiguo.

Resultado: el contrato queda registrado en la ficha y su jornada se usa desde ese momento en la Calculadora de Horas extras. Si el colaborador tiene un contrato anterior, regístrele la Fecha de fin para que pase a Finalizado y quede en el histórico.

Tarea 2 — Consultar el detalle de un contrato

  1. En la tarjeta Contratos de trabajo, haga clic en cualquier parte de la fila del contrato.

    Fila del contrato resaltada en la tabla de contratos

    La tabla resume tipo, fechas, salario, jornada, MITRADEL y estado.

  2. Lea el detalle que se despliega debajo de la fila: servicios convenidos, lugar y horario de trabajo, horas semanales, forma y día de pago, dependientes, período de prueba y datos de firma. Vuelva a hacer clic para plegarlo.

    Detalle desplegado del contrato con servicios convenidos, lugar, horario, pago, dependientes y firma

    Las líneas sin dato no se muestran.

Resultado: consulta todas las condiciones del Art. 68 sin abrir el cuadro de edición. Todos los roles pueden consultar.

Tarea 3 — Editar un contrato

  1. Haga clic en el ícono de lápiz al final de la fila del contrato.

    Ícono de lápiz (Editar) resaltado en la fila del contrato

    Solo aparece para roles con permiso de escritura.

  2. Modifique los campos en el cuadro Editar contrato y haga clic en Guardar. Se aplican las mismas reglas que al crear.

    Cuadro Editar contrato con los datos actuales del contrato

    Un uso típico: registrar la Ref. MITRADEL cuando llega, o la Fecha de fin al terminar un contrato a plazo.

Resultado: el contrato queda actualizado y el aviso Contrato guardado lo confirma.

Tarea 4 — Eliminar un contrato registrado por error

  1. Haga clic en el ícono de papelera al final de la fila.

    Ícono de papelera (Eliminar) resaltado en la fila del contrato

    Use esta opción solo para registros creados por error.

  2. En el cuadro Eliminar ("¿Está seguro de que desea eliminar este contrato?"), haga clic en Confirmar para borrarlo o en Cancelar para conservarlo.

    Cuadro de confirmación Eliminar con la pregunta ¿Está seguro de que desea eliminar este contrato? y los botones Cancelar y Confirmar

    La eliminación no se puede deshacer.

Resultado: al confirmar, el contrato se borra definitivamente y aparece el aviso "Contrato eliminado". Cuando un contrato simplemente termina, no lo elimine: registre su Fecha de fin para conservar el histórico.

Referencia de campos

Tabla de contratos

Columna Descripción
Tipo de contrato Indefinido, Plazo definido u Obra determinada.
Fecha de inicio Inicio de la vigencia. La tabla se ordena por esta columna, de la más reciente a la más antigua.
Fecha de fin Fin de la vigencia; muestra "—" en los contratos indefinidos.
Salario Mensual Remuneración mensual pactada.
Jornada Diurna, Nocturna o Mixta.
MITRADEL Referencia de registro ante el MITRADEL; muestra "—" si no se capturó.
Estado Vigente o Finalizado, calculado con las fechas del contrato frente a la fecha de hoy.

Diálogo Nuevo contrato / Editar contrato

Campo Tipo Obligatorio Descripción Validación
Tipo de contrato Lista (Indefinido / Plazo definido / Obra determinada) Sí Clasificación del contrato según el Código de Trabajo. Valor predeterminado: Indefinido.
Período de prueba (meses) Número entero No Meses de período de prueba pactados (Art. 78). De 0 a 3. Valor predeterminado: 3. 0 significa sin período de prueba.
Fecha de inicio Fecha Sí Inicio de la vigencia del contrato. Valor predeterminado: la fecha de hoy.
Fecha de fin Fecha Solo en Plazo definido Fin de la vigencia. No puede ser anterior a la Fecha de inicio. En los contratos Indefinido se guarda siempre vacía.
Salario Mensual Monto (decimal) Sí Remuneración mensual pactada. Se precarga con el salario vigente del colaborador. Debe ser mayor que 0.
Jornada Lista (Diurna / Nocturna / Mixta) No Turno de trabajo; fija el divisor de la hora ordinaria y el recargo nocturno de Horas extras. Valor predeterminado: Diurna. Al cambiarla se ajustan las Horas semanales.
Horas semanales Número (decimal) No Horas contratadas por semana. De 1 a 48. Se sugieren 48 (Diurna), 42 (Nocturna) o 45 (Mixta).
Ref. de registro MITRADEL Texto No Número de registro del contrato ante el MITRADEL. Máximo 64 caracteres.
Servicios convenidos (Art. 68.3) Texto largo Sí Determinación específica de la obra o los servicios convenidos. Máximo 512 caracteres.
Lugar de trabajo (Art. 68.4) Texto No Lugar o centro donde se prestan los servicios. Máximo 256 caracteres.
Horario de trabajo (Art. 68.6) Texto No Horario pactado, p. ej. L–V 8:00–17:00. Máximo 256 caracteres.
Forma de pago Lista (Transferencia bancaria / Efectivo / Cheque) No Medio con que se paga el salario. Valor predeterminado: Transferencia bancaria.
Día y lugar de pago (Art. 68.7) Texto No Periodicidad y lugar del pago del salario. Máximo 256 caracteres.
Lugar de celebración (Art. 68.8) Texto No Localidad donde se firmó el contrato. Máximo 128 caracteres.
Fecha de celebración (Art. 68.8) Fecha No Fecha de firma del contrato. Valor predeterminado: la fecha de hoy.
Personas que viven con el trabajador y dependen de él (Art. 68.2) Texto largo No Dependientes declarados por el colaborador. Máximo 512 caracteres.

Los campos de texto no avisan en pantalla cuando se excede el largo permitido: el aviso aparece como error al guardar. Recorte el texto y vuelva a intentarlo.

Detalle expandible de la fila

Línea Contenido
Servicios convenidos Descripción de la obra o los servicios (Art. 68.3).
Lugar de trabajo Lugar donde se prestan los servicios (Art. 68.4).
Horario de trabajo Horario pactado (Art. 68.6).
Horas semanales · Forma de pago Horas contratadas por semana y medio de pago; si se capturó, se agrega el día y lugar de pago (Art. 68.7).
Dependientes Personas que dependen del trabajador (Art. 68.2).
Período de prueba (meses) · Firmado Meses de prueba y, si se capturó la fecha de celebración, el lugar y la fecha de firma (Art. 68.8).

Roles y permisos

Rol Ver Crear Editar Eliminar Aprobar
Acceso Total Sí Sí Sí Sí N/A
Captura de Datos Sí Sí Sí Sí N/A
Aprobador Sí No No No N/A
Solo Lectura Sí No No No N/A
Administrador Sí Sí Sí Sí N/A

Notas: el contrato es dato maestro por empresa y no tiene flujo de aprobación. Los roles sin permiso de escritura ven la tabla y el detalle de cada contrato, pero no los botones Nuevo contrato, Editar ni Eliminar. Todos los cambios quedan registrados en la auditoría del sistema.

Notas de cumplimiento

  • Contenido del contrato escrito (Art. 68): los campos del diálogo cubren los numerales del Art. 68 que dependen de lo pactado: dependientes del trabajador (68.2), servicios convenidos (68.3), lugar de trabajo (68.4), horario (68.6), forma, día y lugar de pago (68.7) y lugar y fecha de celebración (68.8). Los datos de identidad de las partes (68.1) no se capturan aquí: se toman de la información de la empresa y de la ficha del colaborador. La firma del contrato es física; NominaHQ conserva los datos y la referencia de registro, no el documento firmado. Si necesita archivar el contrato escaneado, cárguelo en la tarjeta Documentos de la ficha.
  • Tipos de contrato: el Código de Trabajo reconoce el contrato por tiempo indefinido, por tiempo definido y por obra determinada. Los contratos a plazo definido requieren una fecha de fin, y su causa y duración deben ajustarse a los supuestos legales; los indefinidos se guardan siempre sin fecha de fin.
  • Período de prueba (Art. 78): no puede exceder los tres meses y debe constar por escrito para ser exigible. NominaHQ limita el campo a 3 y acepta 0 cuando no se pactó.
  • Jornada y hora ordinaria: el valor de la hora ordinaria es salario ÷ 30 ÷ horas de jornada (8 diurna, 7 nocturna, 7.5 mixta), conforme a los Art. 30/31. Esta jornada es la base de los recargos de Horas extras (Art. 33/49): +25 % en período diurno; +50 % en período nocturno cuando prolonga una jornada diurna; +75 % cuando prolonga una jornada nocturna o mixta; día de descanso o domingo +50 %; feriado o duelo nacional +150 %, con un máximo de 3 h/día y 9 h/semana (Art. 36).
  • Máximo de horas semanales: la jornada ordinaria no puede exceder 48 horas semanales en jornada diurna, 42 en nocturna y 45 en mixta; el campo Horas semanales admite hasta 48.
  • Registro MITRADEL: los contratos de trabajo deben registrarse ante el MITRADEL; la Ref. de registro MITRADEL conserva ese número para control. NominaHQ no realiza el registro ni valida el número contra el MITRADEL.
  • Salario: el salario mensual del contrato no puede ser inferior al Salario mínimo aplicable por actividad, región y tamaño de empresa (Decreto Ejecutivo No. 13 de 2025, vigente 16-ene-2026). NominaHQ no valida ese mínimo en el contrato; la advertencia se muestra en la ficha del colaborador.

Solución de problemas

Síntoma Causa probable Solución
No aparecen los botones Nuevo contrato, Editar ni Eliminar Su rol no tiene permiso de escritura (Aprobador y Solo Lectura solo consultan) Solicite al administrador un rol con permiso de escritura.
El botón Guardar del diálogo está deshabilitado Falta un dato obligatorio: el Salario Mensual es cero o menos, los Servicios convenidos están en blanco, o el tipo es Plazo definido y falta la Fecha de fin Complete los tres datos y el botón se habilita.
Guardé una fecha de fin en un contrato Indefinido y no quedó registrada Por diseño: un contrato indefinido se guarda siempre sin fecha de fin Si el contrato tiene término, cambie el Tipo de contrato a Plazo definido u Obra determinada.
Un contrato que empieza el mes próximo aparece como Finalizado El estado se calcula con la fecha de hoy: un contrato que aún no inicia no está vigente Es el comportamiento esperado; pasará a Vigente el día de su fecha de inicio.
Al guardar aparece un error y el contrato no se registra Algún campo de texto excede el largo permitido Recorte los Servicios convenidos (512), el Lugar de trabajo o el Horario (256), el Día y lugar de pago (256), el Lugar de celebración (128) o los Dependientes (512).
La jornada del colaborador no aparece en la Calculadora de Horas extras El colaborador no tiene ningún contrato registrado Registre el contrato. Sin contrato, la calculadora asume jornada Diurna.
La Calculadora de Horas extras toma una jornada que no corresponde El colaborador tiene varios contratos con jornadas distintas y la calculadora no siempre elige el vigente Verifique la Jornada en la calculadora antes de calcular y corríjala allí si es necesario; el cambio solo afecta ese cálculo.
El valor de la hora ordinaria no coincide con lo esperado La jornada del contrato no corresponde a la real (diurna/nocturna/mixta) Confirme la jornada del contrato; el divisor depende de ella (8/7/7.5).
El salario del contrato queda por debajo del mínimo Salario mensual menor al mínimo de la matriz Ajuste el salario al mínimo de la actividad/región/tamaño aplicable. El contrato no valida este mínimo.
Eliminé un contrato por error La eliminación es definitiva y no tiene papelera Vuelva a capturarlo. Para conservar el histórico, cierre los contratos con su Fecha de fin en lugar de eliminarlos.

Funciones relacionadas

  • Empleados (ficha del colaborador): salario mensual, fecha de ingreso, frecuencia de pago y estado del colaborador. La tarjeta Contratos de trabajo vive en esta ficha. Vea Empleados.
  • Expediente digital (tarjeta Documentos de la ficha): archivo del contrato firmado y escaneado, con control de vigencias. Vea Expediente digital y evaluaciones.
  • Calculadora de Horas extras (Nómina → Horas extras): usa la jornada del contrato. Vea Horas extras.
  • Salario mínimo (matriz MITRADEL): referencia para validar el salario del contrato.
  • Liquidación y Vacaciones: prestaciones que dependen del salario y la antigüedad pactados.

¿Te resultó útil esta página?