Completar periodos

Desarrollando

Entorno desarrollo

https://dev-api.talentify.cr

GET

/api/planilla/calendario/{nomina}

Genera automáticamente los periodos faltantes de una nómina a partir de una fecha inicial, según los días laborables, el día de pago y la inclusión de feriados. No persiste nada: devuelve la propuesta de periodos para revisarla antes de crearlos.

Las reglas del día de pago dependen de la forma de pago de la nómina:

Forma de pago	`dia_pago`
Semanal / Bisemanal	1 valor (1–7, día de la semana).
Quincenal	2 valores (uno entre 1–15 y otro entre 16–30).
Mensual	1 valor (1–30).

Si la nómina paga por horas, use forma_pago para indicar la frecuencia (por defecto SEMANAL).

Solicitud

Autorización

Bearer Token

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros de ruta

Parámetros de consulta

Parámetros de Header

Respuestas

🟢200Éxito

application/json

Propuesta de periodos generados (no persistidos).

Bodyapplication/json

🟠401No autentificado

🟠406No encontrada

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://dev-api.talentify.cr/api/planilla/calendario/1386?dias_laborables[]=1&dias_laborables[]=2&dias_laborables[]=3&dias_laborables[]=4&dias_laborables[]=5&dia_pago[]=10&dia_pago[]=25&incluir_feriados=1&forma_pago=QUINCENAL&fecha_inicial=01%2F01%2F2025' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

Ejemplo de Respuesta

200 - Success

{
    "satisfactorio": true,
    "periodos": [
        {
            "id": null,
            "version": "QUINCENA I",
            "activo": false,
            "naturaleza": "SAL",
            "rigeDesde": "01/07/2025",
            "rigeHasta": "15/07/2025",
            "fechaCierre": "15/07/2025",
            "fechaPago": "15/07/2025",
            "tipoCambio": "1",
            "ultimoEnMes": false,
            "ultimoCalculo": "10/07/2025 12:00",
            "nomina": {
                "id": 1175,
                "nombre": "Quincenal",
                "formaDePago": "QUINCENAL",
                "moneda": "CRC",
                "simbolo": "₡",
                "estado": "activo",
                "incluidaEnSeguro": true
            },
            "mesCierre": null,
            "periodoPertenencia": null,
            "periodosExtrordinarios": [],
            "boletasDePagoDisponibles": false
        }
    ]
}

Modificado en 2026-06-13 02:22:10

Eliminar salario bruto

CuentasContables