🔍 ¿Qué hace este endpoint?

Recupera una lista paginada de los periodos de nómina electrónica registrados para una empresa específica.

Para cada periodo expone:

Estado y fechas del periodo: Rango de fechas de la nómina electrónica (inicio y fin del mes).
Opciones de emisión ante la Dirección de Impuestos y Aduanas Nacionales (DIAN): Si la empresa está autorizada, si el periodo se puede emitir y si aún está dentro del plazo legal de emisión.
Resumen de nóminas electrónicas (contadores): Cuántas nóminas hay en cada estado (pendientes de emisión, emitidas, rechazadas por la DIAN, en proceso, canceladas, etc.).

🎯 ¿Cuándo usar este endpoint?

Cuando se requiere listar los periodos de nómina electrónica de una empresa.
Para filtrar periodos por mes y/o año específico.
Cuando necesitas obtener información sobre el estado de emisión de periodos.
Al necesitar validar si existe un periodo de nómina electrónica para una fecha específica.

Permisos y autenticación:

El usuario debe tener acceso a la empresa especificada en {company_id} con rol administrado (admin), contador (accountant) o revisor (reviewer).
Retorna 403 No autenticado si el usuario no tiene permisos para acceder a la empresa.
Retorna 404 No encontrado si la empresa no existe.

Paginación:

Usa el parámetro page para navegar entre páginas (por defecto: 1)
Usa el parámetro per_page para cambiar la cantidad de registros que se retornan por página (máximo: 50, por defecto: 20)
Los parámetros fuera de rango se ajustan automáticamente (no generan error)

Filtros:

Ordenamiento:

Los resultados se ordenan por fecha inicial descendente (periodos más recientes primero).
El ordenamiento no es configurable.