P4 Software / NominaHQ

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: roles con permiso de escritura (Acceso total, Captura de datos) y administradores. Referencias regulatorias: Salario mínimo — Decreto Ejecutivo No. 13 de 2025 (Gaceta Oficial No. 30438, vigente 16-ene-2026). Otras referencias: ninguna en esta pantalla.

Resumen

La pantalla Empresas es el registro maestro de las empresas cliente que usted administra desde NominaHQ. Cada empresa concentra sus datos de identificación, contacto, logo para Reportes, los parámetros de integración con CifraHQ y el distrito/actividad que determinan el Salario mínimo legal aplicable. La usa el personal del proveedor de servicios de planilla para dar de alta a un nuevo cliente y mantener sus datos actualizados.

Navegación

Maestra → Empresas (ruta /master/companies). La misma pantalla está disponible en Configuración → Clientes.

Conceptos clave

  • Empresa (cliente): cada uno de los clientes cuya planilla usted procesa. El selector de empresa en la parte superior de la aplicación cambia entre las empresas registradas aquí.
  • Código: identificador corto de la empresa. Se define al crear y no se puede cambiar después.
  • Distrito: distrito donde opera la empresa. Determina automáticamente la región del Salario mínimo (Región 1 o Región 2); nunca se elige la región a mano.
  • Región 1 / Región 2: las dos zonas del Salario mínimo del Decreto Ejecutivo No. 13 de 2025. La región se deriva del distrito.
  • Actividad económica / Categoría: combinación que ubica la línea exacta de la tabla oficial de Salario mínimo (MITRADEL) que aplica a la empresa.
  • CifraHQ: sistema de contabilidad al que NominaHQ envía los asientos de planilla. El código, la URL del endpoint y la clave API identifican a la empresa en CifraHQ.
  • Logo: imagen (PNG o JPG) que aparece en recibos, pagarés y Reportes de la empresa.

Selector de empresas (barra superior)

El selector de empresa en la parte superior de la aplicación ahora permite buscar, escribiendo el código o el nombre para filtrar la lista, lo cual resulta útil cuando usted administra muchas empresas cliente. Además, la aplicación recuerda la última empresa que usted seleccionó y se la muestra de nuevo al iniciar sesión, en lugar de mostrar siempre la primera empresa en orden alfabético; esta preferencia se guarda por usuario en el servidor, no en el navegador, por lo que no se comparte entre distintas personas que usan el mismo equipo.

Nota de plan: administrar más de una empresa bajo la misma cuenta requiere el plan Enterprise. Consulte los planes disponibles en /suscripcion.

Paso a paso

A. Crear una empresa

  1. Vaya a Maestra → Empresas.
  2. Presione Nuevo.
  3. Código: escriba el identificador de la empresa. Obligatorio. No podrá modificarse después de crear la empresa.
  4. Nombre: escriba el nombre de la empresa. Obligatorio.
  5. Moneda Base: seleccione la moneda (USD, PAB o EUR; admite otro valor). Opcional; el valor por defecto es USD.
  6. Activo: marque la casilla si la empresa está activa. Opcional; viene marcada por defecto.
  7. Contacto: complete Correo, Teléfono, Dirección, Ciudad, Estado / Provincia y País. Todos opcionales (el país por defecto es Panamá).
  8. En Contabilización en CifraHQ, complete URL del Endpoint, Código de Empresa Cifra y Clave de API si la empresa se integra con CifraHQ. Opcionales.
  9. Presione Guardar. El botón permanece deshabilitado mientras el Código o el Nombre estén vacíos.

Nota: el cuadro de creación no incluye el logo ni la sección de Salario mínimo. Esos datos se completan abriendo la empresa (sección B).

Al crear una empresa, NominaHQ configura automáticamente el catálogo de conceptos de planilla (salario, Horas extras, Vacaciones, CSS, Seguro Educativo, ISR, etc.), departamentos, puestos, Centros de costo y Bancos de referencia, para que la empresa quede lista para procesar planilla sin configuración manual adicional. Si esta configuración automática falla, verá un aviso indicándolo — la empresa igual queda creada; comuníquese con soporte para completarla.

B. Completar logo y Salario mínimo

  1. En la tabla, haga clic en el Código de la empresa para abrir su detalle.
  2. En Logo (para Reportes), use el selector de archivo para cargar un PNG o JPG. El archivo debe pesar menos de 2 MB. Para borrar un logo cargado, presione Quitar logo.
  3. En Salario mínimo (MITRADEL):
    • Distrito: seleccione o escriba el distrito. La Región se calcula y se muestra automáticamente.
    • Actividad económica: seleccione la actividad de la empresa.
    • Categoría: seleccione la categoría dentro de la actividad.
    • El recuadro Salario mínimo aplicable muestra el valor por hora (y el equivalente mensual aproximado) cuando las tres selecciones identifican una línea de la tabla.
  4. Presione Guardar (botón superior derecho).

C. Editar una empresa

  1. En la tabla, haga clic en el Código, o use el menú contextual de la fila y elija la acción de edición.
  2. Modifique los campos necesarios. El Código es de solo lectura.
  3. Presione Guardar.

D. Eliminar una empresa

  1. Seleccione una o varias filas y presione Eliminar, o use el menú contextual de la fila.
  2. Confirme en el cuadro de diálogo. La operación no se puede deshacer.

Referencia de campos

Datos de la empresa

Campo Tipo Obligatorio Descripción Validación
Código Campo de texto Identificador de la empresa. Requerido para guardar. Solo lectura al editar.
Nombre Campo de texto Nombre de la empresa. Requerido para guardar.
Moneda Base Lista desplegable (USD, PAB, EUR; admite otro valor) No Moneda de la empresa. Valor por defecto USD.
Activo Casilla de verificación No Indica si la empresa está activa. Marcada por defecto.
Logo (para Reportes) Carga de archivo (PNG/JPG) No Imagen que aparece en recibos, pagarés y Reportes. Disponible solo en el detalle. Máximo 2 MB.

Contacto

Campo Tipo Obligatorio Descripción Validación
Correo Campo de texto No Correo de contacto.
Teléfono Campo de texto No Teléfono de contacto.
Dirección Campo de texto No Dirección de la empresa.
Ciudad Campo de texto No Ciudad.
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. Valor por defecto Panamá.

Integración CifraHQ

Campo Tipo Obligatorio Descripción Validación
Código Cifra / Código de Empresa Cifra Campo de texto No Código de la empresa en CifraHQ.
URL del endpoint Cifra / URL del Endpoint Campo de texto No Dirección del servicio de CifraHQ.
Clave API Cifra / Clave de API Campo de texto (oculto en el detalle) No Clave de acceso a CifraHQ.

Salario mínimo (MITRADEL) — solo en el detalle

Campo Tipo Obligatorio Descripción Validación
Distrito Lista desplegable (distritos; admite otro valor) No Distrito de operación. Determina la región. Si no se define, la región se muestra como "Defina el distrito".
Región Texto calculado (solo lectura) No Región 1 o Región 2, derivada del distrito. No se edita a mano.
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. Las opciones dependen de la actividad seleccionada.
Salario mínimo aplicable Texto calculado (solo lectura) No Muestra el valor por hora y el mensual aproximado. Requiere distrito, actividad y categoría que coincidan con una línea de la tabla.

El detalle de la empresa también muestra indicadores informativos de solo lectura: Empleados activos, Última planilla, Corridas pendientes / borrador y Préstamos activos.

Roles y permisos

Rol Ver Crear Editar Eliminar Aprobar
Acceso total N/A
Captura de datos N/A
Aprobador No No No N/A
Solo lectura No No No N/A

Los administradores tienen acceso completo a esta pantalla. La acción de aprobar no aplica al registro de empresas.

Notas de cumplimiento

  • El Salario mínimo se basa en el Decreto Ejecutivo No. 13 de 2025 (Gaceta Oficial No. 30438, vigente desde el 16-ene-2026). La Región se deriva del Distrito; nunca se selecciona a mano.
  • El Salario mínimo aplicable se resuelve por la combinación de distrito (región), actividad económica y categoría según la tabla oficial de MITRADEL.
  • El número patronal del Seguro Social/CSS usado en el SIPE, 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 y se establecen durante la implementación.
  • La moneda de la empresa sí se edita en esta pantalla, en el campo de moneda base (Base Currency).

Solución de problemas

Síntoma Causa probable Solución
El botón Guardar está deshabilitado El Código o el Nombre están vacíos (ambos obligatorios). Complete ambos campos.
Mensaje "El logo debe pesar menos de 2 MB." El archivo del logo supera 2 MB. Cargue una imagen PNG o JPG de menor tamaño.
El Salario mínimo aplicable muestra "Seleccione distrito, actividad y categoría…" Falta alguna de las tres selecciones o esa combinación no existe en la tabla. Seleccione distrito, actividad y categoría que correspondan a una línea de la tabla.
La Región muestra "Defina el distrito" No se ha seleccionado distrito. Seleccione el distrito de la empresa.
No se puede cambiar el Código El código es de solo lectura una vez creada la empresa. Comportamiento esperado; cree una empresa nueva si necesita otro código.
Mensaje "No se encontraron empresas" Aún no hay empresas registradas. Presione Nuevo para agregar la primera.

Funciones relacionadas

¿Te resultó útil esta página?