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

Empresas (clientes)

Empresas (clientes)

Aplica a: NominaHQ Roles: Ver: todos los roles del personal (Acceso total, Captura de datos, Aprobador, Solo lectura). Crear, editar y eliminar: Acceso total, Captura de datos. Los administradores tienen acceso completo. Referencias regulatorias: Salario mínimo — Decreto Ejecutivo No. 13 de 2025 (Gaceta Oficial No. 30438, vigente desde el 16-ene-2026).

Resumen

La pantalla Empresas es el registro de las empresas cliente cuya planilla usted procesa en NominaHQ. Cada empresa guarda sus datos de identificación (código, nombre, RUC), contacto, logo para Reportes, la integración con CifraHQ y el distrito, actividad y categoría que determinan su Salario mínimo legal. La usa el personal del proveedor de servicios de planilla para dar de alta un cliente nuevo y mantener sus datos al día.

Navegación

Menú lateral: Maestra → Empresas (ruta /master/companies). La misma pantalla aparece también como Clientes en el menú de configuración.

Conceptos clave

  • Empresa (cliente): cada cliente cuya planilla usted procesa. El selector de empresa de la barra superior cambia entre las empresas activas registradas aquí; permite buscar por código o nombre y recuerda la última empresa que usted eligió.
  • Código: identificador corto de la empresa (por ejemplo, TRN). Se define al crear y no se puede cambiar después.
  • RUC y DV: Registro Único de Contribuyente y dígito verificador. Se imprimen en la certificación de salarios y retenciones de cada empleado.
  • Número patronal CSS: número de la empresa como empleador ante la Caja de Seguro Social. Se usa en el archivo SIPE y en la Planilla 03.
  • Distrito: distrito donde opera la empresa. La Región del Salario mínimo (Región 1 o Región 2) se deriva del distrito; nunca se elige a mano.
  • Actividad económica / Categoría: ubican la línea exacta de la tabla oficial de Salario mínimo (MITRADEL) que aplica a la empresa.
  • CifraHQ: sistema contable al que NominaHQ envía los asientos de planilla. La URL del endpoint, el código de empresa y la clave API identifican a la empresa en CifraHQ.
  • Empresa activa / inactiva: solo las empresas activas aparecen en el selector de empresa y cuentan para el límite del plan. Una empresa inactiva conserva todos sus datos.

Límite del plan: cada plan permite un número máximo de empresas activas. Si crea o reactiva una empresa por encima del límite, NominaHQ muestra el aviso "Su plan permite hasta N empresas activas. Mejore su plan o desactive una." y lo lleva a la página de suscripción.

Tarea 1 — Crear una empresa cliente

Antes de empezar: necesita el rol Acceso total o Captura de datos, y tener a mano el RUC y los datos de contacto del cliente.

  1. En el menú lateral, dentro de Maestra, haga clic en Empresas.

    Pantalla Empresas con el menú Maestra → Empresas resaltado

    La lista muestra el código, nombre, moneda base, código Cifra y si la empresa está activa.

  2. Haga clic en Nuevo.

    Botón Nuevo resaltado en la parte superior de la lista de empresas

    Se abre el cuadro de diálogo Nueva Empresa.

  3. En Código, escriba el identificador corto de la empresa (en el ejemplo, TRN).

    Cuadro Nueva Empresa con el campo Código resaltado y el valor TRN

    El código no se podrá cambiar después de guardar.

  4. En Nombre, escriba la razón social (en el ejemplo, Transportes del Istmo, S.A.).

    Campo Nombre resaltado con el texto Transportes del Istmo, S.A.

    Código y Nombre son los dos únicos campos obligatorios.

  5. Revise Moneda Base (por defecto USD; también puede elegir PAB o EUR) y deje marcada la casilla Activo.

    Campo Moneda Base resaltado con el valor USD y la casilla Activo marcada

    Una empresa activa aparece en el selector de empresa de la barra superior.

  6. En la sección Contacto, escriba el RUC en el primer campo y el DV en el campo corto de la derecha (en el ejemplo, 155667788-2-2024 y 45).

    Campo RUC resaltado con el RUC 155667788-2-2024 y el DV 45

    El RUC y el DV se imprimen en las certificaciones de salarios y retenciones de los Empleados.

  7. Complete Correo, Teléfono, Dirección, Ciudad, Estado / Provincia y País. En Estado / Provincia puede escribir para filtrar la lista de provincias y comarcas.

    Datos de contacto completos con el campo Estado / Provincia resaltado en Panamá

    Todos los datos de contacto son opcionales.

  8. Si la empresa contabiliza en CifraHQ, complete URL del Endpoint, Código de Empresa Cifra y Clave de API en la sección Contabilización en CifraHQ. Si no, déjelos vacíos.

    Sección Contabilización en CifraHQ con el campo URL del Endpoint resaltado

    Puede completar la integración más adelante desde el detalle de la empresa.

  9. Haga clic en Guardar.

    Cuadro Nueva Empresa completo con el botón Guardar resaltado

    El botón queda deshabilitado mientras Código o Nombre estén vacíos.

  10. Revise el resultado: aparece el mensaje Empresa TRN creada y la nueva fila en la lista.

    Lista de empresas con la nueva fila TRN Transportes del Istmo, S.A.

    La nueva empresa ya aparece en la lista y en el selector de empresa.

Resultado: la empresa queda creada. NominaHQ configura automáticamente para ella el catálogo de conceptos de planilla (salario, Horas extras, Vacaciones, CSS, Seguro Educativo, ISR, etc.), departamentos, puestos y Centros de costo por defecto, los Bancos de Panamá con su ruta ACH, el mapeo de cuentas de CifraHQ y los parámetros de planilla de la empresa. Si esta configuración automática falla, verá un aviso; la empresa igual queda creada y usted debe comunicarse con soporte.

Tarea 2 — Completar el logo, el registro legal y el Salario mínimo

El cuadro Nueva Empresa no incluye el logo, el número patronal ni el Salario mínimo. Esos datos se completan en el detalle de la empresa.

  1. En la lista, haga clic en el Código de la empresa (en el ejemplo, TRN).

    Lista de empresas con el código TRN resaltado

    Se abre el detalle de la empresa con sus indicadores: Empleados activos, Última planilla, Corridas pendientes / borrador y Préstamos activos.

  2. En Logo (para Reportes), use el selector de archivo para elegir una imagen PNG o JPG de menos de 2 MB.

    Sección Logo (para reportes) resaltada con el logo de Transportes del Istmo cargado

    La vista previa aparece de inmediato. Para borrar el logo, haga clic en Quitar logo.

  3. En la sección Registro legal, revise o complete el RUC y el DV (en el ejemplo, 155667788-2-2024 y 45, capturados al crear la empresa).

    Sección Registro legal con el campo RUC resaltado, RUC 155667788-2-2024 y DV 45

    El RUC y el DV se imprimen en las certificaciones de salarios y retenciones de los Empleados.

  4. En Número patronal CSS, escriba el número patronal de la empresa ante la Caja de Seguro Social (en el ejemplo, 87-123-4567).

    Campo Número patronal CSS resaltado con el valor 87-123-4567

    Se usa en el archivo SIPE y como columna 1 de la Planilla 03 cuando no se ingresa el ID del comprobante.

  5. En la sección Salario mínimo (MITRADEL), elija o escriba el Distrito (en el ejemplo, Colón). La Región se calcula en ese momento.

    Sección Salario mínimo con el campo Distrito resaltado en Colón y la Región 1 calculada

    Mientras no haya distrito, la región muestra "Defina el distrito". El recuadro amarillo indica que aún faltan la actividad y la categoría.

  6. En Actividad económica, elija la actividad de la empresa (en el ejemplo, Transporte). La lista Categoría se llena con las categorías de esa actividad.

    Campo Actividad económica resaltado con el valor Transporte y el campo Categoría listo para elegir

    Si cambia la actividad, la categoría elegida antes se borra cuando no pertenece a la nueva actividad.

  7. En Categoría, elija la categoría que corresponde (en el ejemplo, Aeropuertos Internacionales (Nacional)). El recuadro se vuelve verde y muestra el Salario mínimo aplicable.

    Campo Categoría resaltado y el recuadro verde Salario mínimo aplicable B/. 3.84 por hora

    En el ejemplo: B/. 3.84 por hora (≈ B/. 798.72 al mes).

  8. Haga clic en Guardar, arriba a la derecha.

    Encabezado del detalle de la empresa con el botón Guardar resaltado

    El botón muestra Guardando... mientras procesa. Si el RUC, el DV o el número patronal tienen caracteres no permitidos, aparece un aviso y no se guarda.

  9. Revise el resultado: aparece el mensaje Empresa TRN actualizada.

    Detalle de Transportes del Istmo, S.A. con el mensaje Empresa TRN actualizada

    Los datos se recargan con los valores guardados.

Resultado: el logo aparece en los recibos, pagarés y Reportes de la empresa; el RUC y el número patronal quedan listos para las certificaciones, el SIPE y la Planilla 03; y NominaHQ usa el Salario mínimo aplicable para detectar Empleados con salario por debajo del mínimo legal.

Tarea 3 — Desactivar una empresa

Desactive una empresa cuando deja de ser cliente o para liberar un cupo del plan. No se borra ningún dato.

  1. En el detalle de la empresa, desmarque la casilla Activo. La etiqueta del encabezado cambia a Inactivo.

    Detalle de la empresa con la casilla Activo desmarcada y resaltada, y la etiqueta Inactivo

    El cambio no se aplica hasta que usted guarde.

  2. Haga clic en Guardar.

    Encabezado con la etiqueta Inactivo resaltada y el mensaje Empresa TRN actualizada

    La empresa sale del selector de empresa de la barra superior.

Resultado: la empresa queda Inactivo, deja de contar para el límite del plan y conserva todos sus datos. Para reactivarla, marque Activo y guarde de nuevo.

Tarea 4 — Eliminar una empresa

Importante: eliminar una empresa no se puede deshacer. Si solo quiere dejar de usarla, desactívela (Tarea 3).

  1. En la lista, marque la casilla de la fila de la empresa y haga clic en Eliminar (1) en la barra superior. También puede eliminar varias empresas a la vez, o usar el menú contextual de la fila.

    Fila TRN seleccionada y el botón Eliminar (1) resaltado

    La barra superior indica cuántas filas hay seleccionadas.

  2. En el cuadro Eliminar, haga clic en Confirmar para eliminar la empresa, o en Cancelar para no hacer ningún cambio.

    Cuadro Eliminar con el texto ¿Está seguro de que desea eliminar TRN? y los botones Cancelar (resaltado) y Confirmar

    Al confirmar aparece el mensaje "Empresa TRN eliminada".

Resultado: la empresa se elimina de la lista.

Editar una empresa

Abra la empresa haciendo clic en su Código (Tarea 2), cambie los campos necesarios y haga clic en Guardar. El Código es de solo lectura. También puede editar desde el menú contextual de la fila (Editar), que abre el cuadro Editar Empresa con los mismos campos que Nueva Empresa. El Número patronal CSS solo se edita en el detalle de la empresa.

Referencia de campos

Cuadro Nueva Empresa / Editar Empresa

Campo Tipo Obligatorio Descripción Validación
Código Campo de texto Sí Identificador corto de la empresa. Solo lectura al editar.
Nombre Campo de texto Sí Nombre o razón social. —
Moneda Base Lista desplegable (USD, PAB, EUR; admite otro valor) No Moneda de la empresa. Por defecto USD.
Activo Casilla No Si la empresa está activa. Marcada por defecto. Sujeta al límite de empresas activas del plan.
Correo Campo de texto No Correo de contacto. —
RUC y DV Dos campos de texto No RUC y dígito verificador; se imprimen en la certificación de salarios y retenciones. RUC: letras, dígitos y guiones, máximo 32 caracteres. DV: uno o dos dígitos, y solo junto con el RUC.
Teléfono, Dirección, Ciudad Campos de texto No Datos de contacto. —
Estado / Provincia Lista desplegable (provincias y comarcas de Panamá; admite otro valor) No Provincia o comarca. —
País Lista desplegable (Panamá, Costa Rica, Colombia, Estados Unidos; admite otro valor) No País. —
URL del Endpoint, Código de Empresa Cifra, Clave de API Campos de texto No Integración con CifraHQ. —

Detalle de la empresa

Campo Tipo Obligatorio Descripción Validación
Logo (para Reportes) Carga de archivo No Imagen de recibos, pagarés y Reportes. PNG o JPG, menos de 2 MB.
RUC y DV (Registro legal) Dos campos de texto No Los mismos datos del cuadro Nueva Empresa. Mismas reglas que en el cuadro.
Número patronal CSS (Registro legal) Campo de texto No Número patronal ante la CSS; se usa en el archivo SIPE y como columna 1 de la Planilla 03 cuando no se ingresa el ID del comprobante. Solo dígitos y guiones, máximo 32 caracteres.
Código Cifra, URL del endpoint Cifra, Clave API Cifra Campos de texto No Integración con CifraHQ. La clave se muestra oculta. —
Distrito Lista desplegable (admite otro valor) No Distrito de operación. Determina la región.
Región Texto calculado — Región 1 o Región 2. No se edita.
Actividad económica Lista desplegable No Actividad de la tabla de Salario mínimo. —
Categoría Lista desplegable No Categoría dentro de la actividad. Depende de la actividad.
Salario mínimo aplicable Texto calculado — Valor por hora y mensual aproximado. Requiere distrito, actividad y categoría que coincidan con una línea de la tabla.

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

Los administradores tienen acceso completo.

Notas de cumplimiento

  • El Salario mínimo se basa en el Decreto Ejecutivo No. 13 de 2025 (vigente desde el 16-ene-2026). La Región se deriva del Distrito; nunca se elige a mano.
  • El Número patronal CSS se registra en el detalle de la empresa (sección Registro legal) y se usa en el archivo SIPE y en la Planilla 03. El código CIIU y la tasa de Riesgos Profesionales no se configuran en esta pantalla; pertenecen a la configuración de planilla de la empresa.

Solución de problemas

Síntoma Causa probable Solución
El botón Guardar del cuadro está deshabilitado. Código o Nombre están vacíos. Complete ambos campos.
"Su plan permite hasta N empresas activas…" y la aplicación lo lleva a la suscripción. Ya alcanzó el límite de empresas activas del plan. Desactive otra empresa o cambie de plan.
"El logo debe pesar menos de 2 MB." El archivo del logo es muy grande. Use un PNG o JPG más liviano.
"El RUC solo puede contener letras, dígitos y guiones." o "El DV debe tener uno o dos dígitos." El RUC o el DV tienen caracteres no permitidos. Corrija el valor y guarde de nuevo.
"Ingrese el RUC junto con su DV." Escribió el DV sin el RUC. Complete el RUC o borre el DV.
"El número patronal solo puede contener dígitos y guiones." El número patronal tiene letras u otros caracteres. Escríbalo solo con dígitos y guiones (por ejemplo, 87-123-4567).
La Región muestra "Defina el distrito". No hay distrito seleccionado. Elija el distrito de la empresa.
El recuadro dice "Seleccione distrito, actividad y categoría para determinar el Salario mínimo legal." Falta alguna selección o la combinación no existe en la tabla. Elija distrito, actividad y categoría.
La empresa no aparece en el selector de empresa. La empresa está inactiva. Marque Activo en su detalle y guarde.
No se puede cambiar el Código. El código es de solo lectura después de crear. Comportamiento esperado.

Páginas relacionadas

¿Te resultó útil esta página?