Conceptos

Lista paginada de los conceptos salariales visibles para la unidad de negocio del usuario autenticado.

Se devuelven tanto los conceptos propios de la unidad de negocio como los conceptos de sistema (sin unidad de negocio), excluyendo siempre los marcados como eliminados. El listado viene ordenado por nombre ascendente.

Filtros (query string)

Todos los filtros son opcionales y se aplican por presencia del parámetro:

Parámetro	Efecto
`factor`	Filtra por sentido del concepto: `1` = ingresos, `-1` = egresos.
`editable`	Si está presente, limita el resultado a los conceptos editables por la unidad de negocio (excluye los de sistema).
`cargables`	Si está presente, limita el resultado a los conceptos "cargables" (con alguna de las opciones de pago: por monto, por horas o por factor-hora).

El tamaño de página de este endpoint es fijo en 100 registros (el controlador lo fuerza). Use pagina para recorrer las páginas. La respuesta es el paginador estándar de Laravel.

Bearer Token

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

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

application/json

Página de conceptos en el formato del paginador de Laravel. El arreglo data contiene los conceptos; el resto de campos describen la paginación.

Bodyapplication/json

curl --location 'https://dev-api.talentify.cr/api/planilla/conceptos?factor=1&editable=1&cargables=1&pagina=1' \ --header 'Accept: application/json' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json'

{ "current_page": 1, "data": [ { "id": 649, "nombre": "Salario base", "factor": 1, "pais": "CRC", "subperiodo": null, "clasificacion": "CRC_INGRESO_SALARIO", "unidadNegocio": 181, "monto": "0.00", "porcentaje": "0.00", "escalaId": null, "escalaNombre": null, "fechaCreacion": "05/06/2025 10:32:11", "fechaActualizacion": "05/06/2025 10:32:11", "clasificacionNombre": "Salario" }, { "id": 763, "nombre": "Comisiones", "factor": 1, "pais": "CRC", "subperiodo": null, "clasificacion": "CRC_INGRESO_BONO", "unidadNegocio": 181, "monto": "1000.00", "porcentaje": "0.00", "escalaId": 12, "escalaNombre": "Escala comisiones", "fechaCreacion": "05/06/2025 11:01:54", "fechaActualizacion": "10/06/2025 09:14:02", "clasificacionNombre": "Bono" } ], "first_page_url": "https://api.talentify.cr/api/planilla/conceptos?pagina=1", "from": 1, "last_page": 1, "last_page_url": "https://api.talentify.cr/api/planilla/conceptos?pagina=1", "next_page_url": null, "path": "https://api.talentify.cr/api/planilla/conceptos", "per_page": 100, "prev_page_url": null, "to": 2, "total": 2 }

Filtros (query string)

Solicitud

Respuestas

Conceptos

Filtros (query string)#

Solicitud

Respuestas

Filtros (query string)