---
title: "Emitir nota de débito (05)"
method: POST
path: "/comprobantes/nota-debito"
tags: ["comprobantes"]
---

# Emitir nota de débito (05)

`POST /comprobantes/nota-debito`

## Request

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

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

## Headers

- `Idempotency-Key` string

## Request body

- EmitirNotaDebito
  - `emisorId` string, uuid, required
  - `certificadoId` string, uuid, required
  - `establecimiento` string, required
  - `puntoEmision` string, required
  - `infoNotaDebito` InfoNotaDebito, required: Sin detalles de producto: impuestos de cabecera + lista de motivos (razón + valor).
    - `fechaEmision` string, date: Fecha ISO YYYY-MM-DD.
    - `dirEstablecimiento` string
    - `tipoIdentificacionComprador` '04' | '05' | '06' | '07' | '08' | '09', required: 04=RUC, 05=cédula, 06=pasaporte, 07=consumidor final, 08=id. exterior, 09=placa
    - `razonSocialComprador` string, required
    - `identificacionComprador` string, required
    - `contribuyenteEspecial` string
    - `obligadoContabilidad` 'SI' | 'NO'
    - `rise` string
    - `codDocModificado` string, required
    - `numDocModificado` string, required
    - `fechaEmisionDocSustento` string, date, required: Fecha ISO YYYY-MM-DD.
    - `totalSinImpuestos` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
      - string
      - number
    - `impuestos` NotaDebitoImpuesto[], required
      - `codigo` '2' | '3' | '5', required: 2=IVA, 3=ICE, 5=IRBPNR
      - `codigoPorcentaje` string, required
      - `tarifa` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
        - string
        - number
      - `baseImponible` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
        - string
        - number
      - `valor` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
        - string
        - number
      - `valorDevolucionIva` union: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
        - string
        - number
    - `valorTotal` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
      - string
      - number
    - `pagos` Pago[]
      - `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
      - `plazo` union: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
        - string
        - number
      - `unidadTiempo` string: Unidad del plazo, hasta 10 caracteres. Solo `dias` se convierte en vencimiento
  - `motivos` MotivoNotaDebito[], required
    - `razon` string, required
    - `valor` 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)