---
title: "Aprobar el rol del período"
method: POST
path: "/nomina/rol/aprobar"
tags: ["nomina"]
---

# Aprobar el rol del período

`POST /nomina/rol/aprobar`

## Request

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

Pasa a 'aprobado' todas las filas en 'borrador' del período. Se aprueba el período completo, no fila a fila. NO hay transición inversa: un rol aprobado ya no se regenera ni vuelve a borrador. Idempotente: una segunda llamada devuelve `cambiados: 0`.

## Request body

- object
  - `emisorId` string, uuid, required
  - `periodo` string, required: Período YYYY-MM, ej. 2026-06

## Response `201`

Período aprobado

- TransicionRolResultado: Resultado de aprobar o de marcar pagado el rol de un período
  - `emisorId` string, uuid
  - `periodo` string
  - `estado` 'aprobado' | 'pagado'
  - `cambiados` integer: Filas que cambiaron de estado
  - `omitidos` RolOmitido[]
    - `empleadoId` string, uuid
    - `estadoActual` string
    - `motivo` string

## Other responses

- `400`: Cuerpo inválido o validación de negocio (previene errores SRI 62/52/65/69/39)
- `403`: Rol insuficiente o acceso denegado
- `404`: Recurso inexistente (o de otra cuenta — aislamiento multi-tenant)

---

[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)