---
title: "Listar roles de pago del emisor"
method: GET
path: "/nomina/rol"
tags: ["nomina"]
---

# Listar roles de pago del emisor

`GET /nomina/rol`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/nomina/rol`
- Auth: HTTP bearer

## Query parameters

- `emisorId` string, uuid, required
- `periodo` string: Filtrar por período YYYY-MM

## Response `200`

Lista de roles de pago

- RolPagosResumen[]
  - `id` string, uuid
  - `tenantId` string, uuid
  - `emisorId` string, uuid
  - `empleadoId` string, uuid
  - `periodo` string: Período YYYY-MM
  - `totalIngresos` string
  - `totalEgresos` string
  - `neto` string
  - `aportePersonal` string
  - `provisionPatronal` string
  - `provisionFondoReserva` string
  - `provisionDecimoTercero` string
  - `provisionDecimoCuarto` string
  - `provisionVacaciones` string
  - `detalle` object: Desglose completo del cálculo (ResultadoRolPagos)
  - `estado` 'borrador' | 'aprobado' | 'pagado': Ciclo de vida del rol. Solo avanza: no hay transición inversa.
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `aprobadoAt` string, date-time, nullable: Cuándo pasó a 'aprobado'.
  - `pagadoAt` string, date-time, nullable: Cuándo se marcó 'pagado'.
  - `aprobadoPorUserId` string, uuid, nullable: Usuario que aprobó el período.
  - `pagadoPorUserId` string, uuid, nullable: Usuario que marcó el pago.

## Other responses

- `403`: Rol insuficiente o acceso denegado

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)