---
title: "Generaciones del ATS de un emisor"
method: GET
path: "/ats/historial"
tags: ["ats"]
---

# Generaciones del ATS de un emisor

`GET /ats/historial`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/ats/historial`
- Auth: HTTP bearer

Una entrada por generación, de la más reciente a la más antigua (hasta 200). Regenerar un período no borra la anterior: queda con `estado: "reemplazado"` y `vigente: false`, y se descarga con su `id`. El `estado` de la vigente es el del período en el asesor (`borrador`, `listo`, `presentada`). Requiere el módulo `ats`.

## Query parameters

- `emisorId` string, uuid, required

## Response `200`

Historial de generaciones

- object[]
  - `id` string, uuid: Identificador de la generación; se pasa como `generacion` a la descarga.
  - `periodo` string
  - `estado` string: `borrador`, `listo` o `presentada` en la generación vigente; `reemplazado` si hubo otra después.
  - `vigente` boolean: La última generación del emisor para ese período.
  - `generadoAt` string, date-time, nullable
  - `hashXml` string, nullable
  - `bytes` integer, nullable
  - `forzado` boolean
  - `informeValido` boolean
  - `archivoZip` string, nullable

## Other responses

- `400`: Cuerpo inválido o validación de negocio (previene errores SRI 62/52/65/69/39)
- `402`: El plan del tenant no incluye el módulo `ats` (`upgrade: true`)
- `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)
