API de notas de crédito electrónicas del SRI
Anula o ajusta facturas autorizadas con notas de crédito electrónicas. Indica el documento de origen y los ítems a reversar; la API valida, firma y autoriza ante el SRI y entrega el RIDE en PDF y el XML.
POST /api/comprobantes/nota_credito
X-Api-Key: sk_tu_clave
{
"comprobante": {
"info_tributaria": {
"ambiente": "2",
"tipo_emision": "1",
"razon_social": "MI EMPRESA S.A.",
"ruc": "1793207433001",
"clave_acceso": "0410202504179320743300110010020000000121234567813",
"cod_doc": "04",
"estab": "001",
"pto_emi": "001",
"secuencial": "000000012",
"dir_matriz": "Av. Principal 123"
},
"info_nota_credito": {
"fecha_emision": "10/06/2026",
"tipo_identificacion_comprador": "04",
"razon_social_comprador": "CLIENTE EJEMPLO S.A.",
"identificacion_comprador": "1790012345001",
"cod_doc_modificado": "01",
"num_doc_modificado": "001-001-000000001",
"fecha_emision_doc_sustento": "01/06/2026",
"total_sin_impuestos": "50.00",
"valor_modificacion": "57.50",
"total_con_impuestos": { "total_impuesto": [
{ "codigo": "2", "codigo_porcentaje": "4",
"base_imponible": "50.00", "valor": "7.50" } ] },
"motivo": "Devolución parcial de mercadería"
},
"detalles": { "detalle": [{
"codigo_interno": "P-001",
"descripcion": "Producto X",
"cantidad": "1.00",
"precio_unitario": "50.00",
"precio_total_sin_impuesto": "50.00",
"impuestos": { "impuesto": [
{ "codigo": "2", "codigo_porcentaje": "4", "tarifa": "15.00",
"base_imponible": "50.00", "valor": "7.50" } ] }
}] },
"id": "comprobante",
"version": "1.1.0"
},
"email_receiver": "[email protected]"
}{
"id": "cmp_8c1d4e22",
"estado": "encolado",
"tipo": "nota_credito",
"clave_acceso": "0410202504179320743300110010020000000121234567813",
"mensaje": "Comprobante recibido y en proceso de autorización."
}Cuándo se usa
Casos típicos de una nota de crédito
La nota de crédito modifica una factura ya autorizada por el SRI. Estos son los escenarios más frecuentes en los que tu sistema necesita emitirla.
Devoluciones
El cliente devuelve total o parcialmente la mercadería y necesitas reversar el valor y el IVA correspondiente.
Descuentos posteriores
Aplicas un descuento o bonificación sobre una factura ya emitida y autorizada.
Anulación de la venta
La operación se cancela y debes dejar sin efecto el valor de la factura de origen.
Corrección de valores
Ajustas importes facturados de más por un error de precio, cantidad o impuesto.
Qué incluye
Emisión completa, sin escribir el XML a mano
- Referencia obligatoria al comprobante de origen (factura modificada).
- Con los SDKs, cálculo del valor de modificación y del IVA reversado.
- Firma electrónica y autorización ante el SRI.
- RIDE en PDF y XML firmado descargables.
- Envío por email al cliente y disponibilidad por webhook o consulta.
Versiones y estructura
La nota de crédito, campo por campo
La API valida la nota de crédito contra el esquema oficial del SRI según la versión que declares en comprobante.version. Siempre referencia la factura de origen y reversa su valor e IVA. Forma parte de la API de Facturación Electrónica.
Versiones soportadas
1.1.0 · 1.0.0
info_tributaria Ambiente, RUC, clave de acceso de 49 dígitos, tipo de documento (cod_doc 04) y secuencia.
info_nota_credito Comprador, documento modificado (cod_doc_modificado y num_doc_modificado), motivo y valor de modificación.
detalles Ítems y valores a reversar, con sus impuestos por línea.
Sigue explorando la API de facturación electrónica
API de Facturación Electrónica
La API completa: todos los comprobantes, firma, RIDE, XML y webhooks.
API de Facturas
Emite facturas electrónicas de venta con IVA y autorización del SRI.
API de Retenciones
Emite retenciones de IVA y Renta como agente de retención.
API de Guías de Remisión
Respalda el traslado de la mercadería de tus facturas.
Portal de Comprobantes
Consulta y descarga comprobantes ya emitidos ante el SRI.
APIs de datos (RUC y Cédula)
Valida datos del comprador antes de emitir.
FAQ
Preguntas frecuentes
Resolvemos las dudas más comunes sobre la emisión de comprobantes electrónicos del SRI mediante la API, la firma electrónica, los ambientes y la integración.
¿Qué versiones de nota de crédito soporta la API? ▾
Soportamos las versiones 1.0.0 y 1.1.0 del esquema de nota de crédito del SRI. Declaras la versión en el campo comprobante.version y validamos el comprobante contra ese esquema. Para nuevas integraciones recomendamos la 1.1.0, la más reciente.
¿Cuándo se emite una nota de crédito? ▾
Se emite para anular o disminuir el valor de una factura ya autorizada: devoluciones de mercadería, descuentos posteriores, anulaciones o correcciones de importes. La nota de crédito siempre referencia el comprobante de origen.
¿Necesito referenciar la factura original? ▾
Sí. La nota de crédito debe indicar el documento modificado: código, número y fecha de emisión de la factura de origen. La API valida esa referencia contra el esquema del SRI antes de firmar.
¿La nota de crédito reversa el IVA? ▾
Sí. Indicas los ítems y valores a reversar; los SDKs calculan el IVA correspondiente y el valor de modificación total, y la API valida el comprobante contra el esquema del SRI. Queda listo para tu conciliación tributaria.
¿Puedo emitir una nota de crédito parcial? ▾
Sí. Puedes reversar solo una parte de la factura original indicando únicamente los ítems o el valor que corresponda a la devolución o ajuste.
Acceso y soporte
Empieza a emitir notas de crédito hoy
Cuéntanos tu caso de uso y volumen estimado. Te damos acceso al ambiente de pruebas, las credenciales y el acompañamiento para integrar la API en tu sistema. Respondemos por WhatsApp en minutos.
Respuesta promedio en menos de 15 minutos en horario laboral. +593 99 083 3993