---
title: "Borrador del ATS del período en Excel"
method: GET
path: "/ats/borrador/excel"
tags: ["ats"]
---

# Borrador del ATS del período en Excel

`GET /ats/borrador/excel`

## Request

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

El mismo anexo del borrador en un `.xlsx` (`ATmmaaaa.xlsx`): una hoja de resumen por sección y una hoja por compras, retenciones de renta, ventas, establecimientos y anulados. Se calcula en el momento y no guarda nada. El resumen sirve para revisar el anexo antes de cargarlo; el talón resumen oficial lo entrega el SRI después de la carga. Lleva la identificación de todos los clientes y proveedores del período y se audita aparte. Requiere el módulo `ats`.

## Query parameters

- `emisorId` string, uuid, required
- `anio` integer, required
- `mes` integer, required
- `semestral` boolean
- `excluir332` boolean
- `excluirRetencionesElectronicas` boolean

## Response `200`

Libro de Excel (`Content-Disposition: attachment`)

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