---
title: "Emitir retención ATS (07)"
method: POST
path: "/comprobantes/retencion"
tags: ["comprobantes"]
---

# Emitir retención ATS (07)

`POST /comprobantes/retencion`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/comprobantes/retencion`
- Auth: HTTP bearer

Asíncrono, igual que factura. `infoCompRetencion.fechaEmision` opcional (`YYYY-MM-DD`, hora Ecuador; solo la fecha de hoy, cualquier otra responde 400).

## Headers

- `Idempotency-Key` string

## Request body

- EmitirRetencion
  - `emisorId` string, uuid, required
  - `certificadoId` string, uuid, required
  - `establecimiento` string, required
  - `puntoEmision` string, required
  - `infoCompRetencion` InfoCompRetencion, required
    - `fechaEmision` string, date: Fecha ISO YYYY-MM-DD.
    - `dirEstablecimiento` string
    - `contribuyenteEspecial` string
    - `obligadoContabilidad` 'SI' | 'NO'
    - `tipoIdentificacionSujetoRetenido` '04' | '05' | '06' | '07' | '08' | '09', required: 04=RUC, 05=cédula, 06=pasaporte, 07=consumidor final, 08=id. exterior, 09=placa
    - `tipoSujetoRetenido` '01' | '02'
    - `parteRel` 'SI' | 'NO', required
    - `razonSocialSujetoRetenido` string, required
    - `identificacionSujetoRetenido` string, required
    - `periodoFiscal` string, required: mm/aaaa
  - `docsSustento` DocSustento[], required
    - `codSustento` string, required
    - `codDocSustento` string, required
    - `numDocSustento` string, required: 15 dígitos: estab(3)+ptoEmi(3)+secuencial(9).
    - `fechaEmisionDocSustento` string, date, required: Fecha ISO YYYY-MM-DD.
    - `fechaRegistroContable` string, date: Fecha ISO YYYY-MM-DD.
    - `numAutDocSustento` string
    - `pagoLocExt` '01' | '02', required: 01=local, 02=exterior
    - `tipoRegi` string
    - `paisEfecPago` string
    - `aplicConvDobTrib` 'SI' | 'NO'
    - `pagExtSujRetNorLeg` 'SI' | 'NO'
    - `pagoRegFis` 'SI' | 'NO'
    - `totalComprobantesReembolso` union: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
      - string
      - number
    - `totalBaseImponibleReembolso` union: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
      - string
      - number
    - `totalImpuestoReembolso` union: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
      - string
      - number
    - `totalSinImpuestos` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
      - string
      - number
    - `importeTotal` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
      - string
      - number
    - `impuestosDocSustento` ImpuestoDocSustento[], required
      - `codImpuestoDocSustento` '2' | '3' | '5', required
      - `codigoPorcentaje` string, required
      - `baseImponible` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
        - string
        - number
      - `tarifa` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
        - string
        - number
      - `valorImpuesto` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
        - string
        - number
    - `retenciones` RetencionLinea[], required
      - `codigo` '1' | '2' | '6', required: 1=Renta, 2=IVA, 6=ISD
      - `codigoRetencion` string, required
      - `baseImponible` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
        - string
        - number
      - `porcentajeRetener` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
        - string
        - number
      - `valorRetenido` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
        - string
        - number
    - `pagos` RetencionPago[], required
      - `formaPago` '01' | '15' | '16' | '17' | '18' | '19' | '20' | '21', required: 01=sin sistema financiero, 15=compensación, 16=t. débito, 17=dinero electrónico, 18=t. prepago, 19=t. crédito, 20=otros con sistema financiero, 21=endoso de títulos
      - `total` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
        - string
        - number
  - `infoAdicional` CampoAdicional[]
    - `nombre` string, required
    - `valor` string, required

## Response `202`

Encolado para firma y transmisión al SRI

- ResultadoEmision
  - `comprobanteId` string, uuid
  - `claveAcceso` string
  - `estado` 'BORRADOR' | 'FIRMADO' | 'ENVIADO' | 'AUTORIZADO' | 'DEVUELTA' | 'RECHAZADO' | 'CONTINGENCIA' | 'ANULADO'
  - `reutilizado` boolean: true si la Idempotency-Key ya tenía comprobante: se devuelve ese (con su estado real), sin re-emitir
  - `advertencias` string[]: Avisos no bloqueantes (p. ej. fecha de emisión con riesgo de error 65)

## Other responses

- `400`: Cuerpo inválido o validación de negocio (previene errores SRI 62/52/65/69/39)
- `402`: Cupo mensual del plan agotado (`upgrade: true`). En una cuenta bajo contrato OEM solo aplica al tope de Pruebas y llega con `upgrade: false`: no hay plan que comprar.
- `409`: La emisión de esta cuenta la gestiona un partner OEM y está en pausa: el régimen de emisión del contrato está pausado o el partner está suspendido. No se reserva secuencial ni se consume cupo. La cuenta no vuelve a su plan propio: vuelve a emitir cuando el régimen se reactiva.

---

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