---
title: "Borrador del ATS del período: qué saldría, si valida y qué falta"
method: GET
path: "/ats/borrador"
tags: ["ats"]
---

# Borrador del ATS del período: qué saldría, si valida y qué falta

`GET /ats/borrador`

## Request

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

Devuelve conteos por sección, los totales de la cabecera, el informe de validación, el resultado de validar el XML contra el XSD oficial del SRI, las filas excluidas con su motivo y las brechas que dejan filas incompletas. **No devuelve el XML**: lleva la identificación de todos los clientes y proveedores del período. 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`

Borrador del anexo

- object
  - `periodo` object
    - `anio` integer
    - `mes` integer
    - `semestral` boolean
  - `cabecera` object
    - `numEstabRuc` string
    - `totalVentas` string
  - `secciones` object: Conteos por sección: compras, ventas (`registros` = grupos, `comprobantes` = documentos detrás), ventasEstablecimiento y anulados.
  - `opciones` object: Opciones de generación con las que se armó el anexo.
    - `excluir332` boolean
    - `excluirRetencionesElectronicas` boolean
  - `informe` object: Informe de las reglas V1-V17 (de la ficha técnica) y N1-N9 (criterio de Contadeo).
    - `valido` boolean
    - `hallazgos` object[]
      - `regla` string
      - `severidad` 'error' | 'advertencia'
      - `ruta` string
      - `mensaje` string
  - `xsd` object: `{ valido: true }` o `{ valido: false, errores: [{ mensaje, linea }] }` del XSD oficial del anexo.
  - `exclusiones` object[]: Filas que se quedaron FUERA del anexo, con su motivo.
    - `seccion` string
    - `referencia` string
    - `motivo` string
  - `brechas` object[]: Lo que le falta al producto (no al anexo): cada brecha con cuántas filas del período deja incompletas.
    - `codigo` string
    - `campo` string
    - `efecto` string
    - `filas` integer

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