---
title: "Emitir nota de crédito (04)"
method: POST
path: "/comprobantes/nota-credito"
tags: ["comprobantes"]
---

# Emitir nota de crédito (04)

`POST /comprobantes/nota-credito`

## Request

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

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

## Headers

- `Idempotency-Key` string

## Request body

- EmitirNotaCredito
  - `emisorId` string, uuid, required
  - `certificadoId` string, uuid, required
  - `establecimiento` string, required
  - `puntoEmision` string, required
  - `infoNotaCredito` InfoNotaCredito, required
    - `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: codDoc del comprobante que se modifica (p. ej. "01").
    - `numDocModificado` string, required: ###-###-#########
    - `fechaEmisionDocSustento` string, date, required: Fecha del documento que se modifica (ISO).
    - `totalSinImpuestos` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
      - string
      - number
    - `valorModificacion` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
      - string
      - number
    - `moneda` string
    - `totalConImpuestos` NotaCreditoTotalImpuesto[], required
      - `codigo` '2' | '3' | '5', required: 2=IVA, 3=ICE, 5=IRBPNR
      - `codigoPorcentaje` string, required
      - `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
    - `motivo` string, required
  - `detalles` DetalleNotaCredito[], required
    - `codigoInterno` string
    - `codigoAdicional` string
    - `descripcion` string, required
    - `cantidad` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
      - string
      - number
    - `precioUnitario` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
      - string
      - number
    - `descuento` union: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
      - string
      - number
    - `precioTotalSinImpuesto` union, required: Monto o cantidad; se recomienda string decimal ("100.00") para no perder precisión.
      - string
      - number
    - `detallesAdicionales` DetalleAdicional[]
      - `nombre` string, required
      - `valor` string, required
    - `impuestos` ImpuestoLinea[], 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
  - `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)