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

Exportar Planilla 03 (DGI)

Exportar Planilla 03 (DGI)

Aplica a: NominaHQ Roles: Acceso total, Captura de datos, Aprobador (capacidad Exportar); los administradores tienen acceso automático. Solo lectura no puede exportar. Referencias regulatorias: DGI — Informe 03 / Planilla 03 V5 (e-Tax 2.0), declaración mensual de salarios e ISR retenido.

Resumen

La Planilla 03 (Informe 03) es el reporte mensual que el empleador presenta ante la Dirección General de Ingresos (DGI) en e-Tax 2.0, donde declara los salarios pagados a cada empleado y el ISR retenido en el mes. NominaHQ genera este reporte a partir de una planilla ya procesada y lo entrega como archivo .xlsx de 33 columnas (formato V5), listo para cargar en e-Tax 2.0. Lo usa el personal de nómina del proveedor que prepara y presenta las declaraciones de sus empresas clientes.

Navegación

Nómina → Planillas (/payroll/runs). Abra la planilla del período que va a declarar para ver su detalle.

Conceptos clave

  • Planilla 03 / Informe 03: declaración mensual ante la DGI de los ingresos pagados y el ISR retenido por empleado.
  • e-Tax 2.0: portal de la DGI donde se carga el archivo .xlsx.
  • ID Planilla: columna 1 del archivo. Corresponde al número del recibo de la planilla del Seguro Social/CSS (recibo SIPE) que se obtiene al presentar la planilla en SIPE. Si usted no lo indica, el sistema usa el Número patronal CSS registrado en la ficha de la empresa (Configuración → Clientes → empresa, sección Registro legal); si no hay uno registrado, la columna queda vacía.
  • Año/Mes CUOTA: período de la cuota en formato AAAAMM; se toma de la fecha de fin del período de la planilla.
  • DV (dígito verificador): último segmento de la Cédula panameña. Los extranjeros con Pasaporte (documentos que inician con "PAS") no llevan DV.
  • Renta neta gravable: suma de los ingresos gravables del mes menos las deducciones personales; en este archivo las deducciones personales son 0, salvo que correspondan a la declaración de diciembre.

Tarea 1 — Descargar la Planilla 03 de una planilla

Antes de empezar: la planilla debe tener Empleados y usted debe tener el rol Acceso total, Captura de datos o Aprobador. Si ya presentó la planilla en SIPE, tenga a mano el número del recibo que le dio la CSS.

  1. En el menú lateral, dentro de Nómina, haga clic en Planillas.

    Pantalla Planillas con el menú Nómina → Planillas resaltado

    La lista muestra las planillas de la empresa activa.

  2. Haga clic en el nombre de la planilla del mes que va a declarar (en el ejemplo, Quincena 1 - Julio 2026).

    Lista de planillas con el enlace Quincena 1 - Julio 2026 resaltado

    Se abre el detalle de la planilla.

  3. Ubique el campo ID Planilla (recibo SIPE), junto al botón Exportar.

    Encabezado del detalle de la planilla con el campo vacío ID Planilla (recibo SIPE) resaltado

    El campo es opcional y solo afecta la columna 1 del archivo.

  4. Escriba el número del recibo de la planilla de la CSS (en el ejemplo, 4567890).

    Campo ID Planilla (recibo SIPE) con el valor 4567890 resaltado

    El valor no se guarda: escríbalo cada vez que exporte.

  5. Haga clic en Exportar.

    Botón Exportar resaltado en el encabezado de la planilla

    Se abre el menú de exportación.

  6. Elija Planilla 03 (DGI).

    Menú Exportar abierto con la opción Planilla 03 (DGI) resaltada

    El navegador descarga el archivo de inmediato.

Resultado: se descarga Planilla03_AAAAMM.xlsx (en el ejemplo, Planilla03_202607.xlsx), donde AAAAMM es el año y mes del fin del período de la planilla. El libro tiene una hoja Planilla03 con una fila de encabezado y una fila por empleado, con el número de recibo en la columna 1. Cárguelo en e-Tax 2.0 de la DGI.

El botón Exportar y el campo ID Planilla (recibo SIPE) solo aparecen cuando la planilla tiene Empleados y su rol tiene permiso para exportar. Cada archivo corresponde a una planilla: si la empresa paga quincenal, cada quincena del mes produce su propio archivo con el mismo nombre; NominaHQ no las consolida en un solo archivo mensual.

Tarea 2 — Registrar el número patronal de la empresa

Si registra el número patronal CSS de la empresa, la Planilla 03 lo usa en la columna 1 cuando usted no escribe un recibo.

  1. En el menú lateral, dentro de Configuración, haga clic en Clientes y abra la empresa.
  2. En la sección Registro legal, escriba el Número patronal CSS (solo dígitos y guiones, hasta 32 caracteres; por ejemplo, 87-000-0000).
  3. Haga clic en Guardar en la parte superior de la ficha.

Resultado: las Planillas 03 de la empresa que se exporten sin recibo llevan el número patronal en la columna 1.

Referencia de campos

Campo Tipo Obligatorio Descripción Validación
ID Planilla (recibo SIPE) Campo de texto No Número del recibo de la planilla CSS; se usa en la columna 1 (ID Planilla) del archivo. Si se omite, se usa el número patronal registrado o la columna queda vacía. No se guarda con la planilla. Sin validación; los espacios al inicio y al final se descartan.

Estructura del archivo generado

El archivo contiene una fila de encabezado y una fila por empleado, con 33 columnas en el orden de la DGI. Las principales:

# Columna Origen en NominaHQ
1 ID Planilla Recibo de la planilla CSS indicado, o el número patronal registrado
2 Año/Mes CUOTA Período de la planilla (AAAAMM)
3 Tipo de documento "Cédula" o "Pasaporte" según el empleado
4 Número de documento Cédula (sin DV) o número de pasaporte
5 DV Dígito verificador de la Cédula (vacío para extranjeros)
6 Nombre del empleado Nombre y apellido
7 Salario Salario mensual de contrato del empleado
8 Sueldo Sueldo efectivamente pagado: el salario menos los descuentos por ausencia
9–18 Horas extras, Vacaciones, Comisiones, Bonificaciones, Salario en especie, Dieta, Prima de producción, Décimo tercer mes, Gratificaciones/aguinaldos, Gasto de representación Conceptos de la planilla
19–23 Deducciones personales (deducción conjunta, intereses hipotecarios, intereses educativos, primas de seguro, aportes a fondos de jubilación) Solo para diciembre; se emiten en 0
24 Total de deducciones Suma de columnas 19–23 (0 aquí)
25 Renta neta gravable Suma de ingresos gravables menos deducciones, si es positiva
26–27 Impuesto sobre la renta (ISR) e ISR de gasto de representación ISR del concepto de la planilla
28–29 Retenciones del mes en salarios y en gastos de representación ISR retenido en el mes
30–33 Liquidación-terminación laboral, ISR de Liquidación, A favor del fisco, A favor del empleado Se emiten en 0

Roles y permisos

Rol Ver planilla Exportar Planilla 03
Acceso total Sí Sí
Captura de datos Sí Sí
Aprobador Sí Sí
Solo lectura Sí No

No aplican las acciones Crear, Editar, Eliminar ni Aprobar: la función solo genera y descarga un archivo a partir de la planilla; no modifica datos. El acceso a la descarga queda restringido a las empresas asignadas al usuario.

Notas de cumplimiento

  • La Planilla 03 declara, por empleado, los ingresos pagados y el ISR retenido en el mes; se presenta en e-Tax 2.0 de la DGI. El sistema genera el archivo, pero no calcula ni recuerda el plazo de presentación, que define la DGI.
  • El Décimo tercer mes se reporta en su propia columna (16) y no genera ISR por separado.
  • Las columnas de deducciones personales (19–23) aplican a la declaración de diciembre y dependen de datos que aporta el operador; NominaHQ las emite en 0.
  • El ISR retenido se basa en los tramos vigentes: 0% hasta B/.11,000; 15% de B/.11,000 a B/.50,000; 25% sobre el excedente. El valor de retención proviene del cálculo de la planilla.

Solución de problemas

Síntoma Causa probable Solución
No aparece el botón Exportar ni el menú Planilla 03 La planilla no tiene Empleados, o su rol no tiene permiso para exportar Verifique que la planilla tenga registros; solicite a un administrador un rol con capacidad de exportar (Acceso total, Captura de datos o Aprobador).
La columna 1 (ID Planilla) sale vacía o con el número patronal en vez del recibo No se escribió el recibo en el campo ID Planilla (recibo SIPE) antes de exportar, y la empresa no tiene Número patronal CSS Escriba el número del recibo en el campo y vuelva a exportar, o registre el número patronal en la ficha de la empresa.
Las columnas 19–23 (deducciones personales) salen en 0 Son exclusivas de diciembre y las aporta el operador Comportamiento esperado; complete esas columnas en la presentación de diciembre según corresponda.
Un empleado extranjero aparece como "Pasaporte" y sin DV El documento inicia con "PAS" Comportamiento esperado: los pasaportes no llevan dígito verificador.
La descarga muestra acceso denegado El rol no tiene capacidad de exportar, o la planilla pertenece a una empresa no asignada al usuario Use un rol con permiso de exportación y verifique que la empresa de la planilla esté asignada a su usuario.

Funciones relacionadas

  • Exportar SIPE (Carga Masiva) — archivo .xlsx de 25 columnas para el CSS.
  • Planillas (procesar y revisar una corrida de nómina).
  • Documentos de la planilla: Resumen PDF, Cuadre CSS, Aportes CSS, Recibos (ZIP).

¿Te resultó útil esta página?