API de notas de débito electrónicas del SRI
Cobra valores adicionales sobre una factura ya emitida —intereses, mora o recargos— con notas de débito electrónicas. Indica el documento de origen y los motivos del cargo; la API valida, firma y autoriza ante el SRI y entrega el RIDE en PDF y el XML.
POST /api/comprobantes/nota_debito
X-Api-Key: sk_tu_clave
{
"comprobante": {
"info_tributaria": {
"ambiente": "2",
"tipo_emision": "1",
"razon_social": "MI EMPRESA S.A.",
"ruc": "1793207433001",
"clave_acceso": "1006202605179320743300110010010000000151234567812",
"cod_doc": "05",
"estab": "001",
"pto_emi": "001",
"secuencial": "000000015",
"dir_matriz": "Av. Principal 123"
},
"info_nota_debito": {
"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": "20.00",
"impuestos": { "impuesto": [
{ "codigo": "2", "codigo_porcentaje": "4", "tarifa": "15.00",
"base_imponible": "20.00", "valor": "3.00" } ] },
"valor_total": "23.00"
},
"motivos": { "motivo": [
{ "razon": "Interés por mora", "valor": "20.00" } ] },
"id": "comprobante",
"version": "1.0.0"
},
"email_receiver": "[email protected]"
}{
"id": "cmp_5d2a8f31",
"estado": "encolado",
"tipo": "nota_debito",
"clave_acceso": "1006202605179320743300110010010000000151234567812",
"mensaje": "Comprobante recibido y en proceso de autorización."
}Cuándo se usa
Cargos adicionales sobre una factura
La nota de débito incrementa el valor a cobrar de una factura ya autorizada por el SRI. Estos son los escenarios más comunes.
Intereses por mora
Cobra intereses por el pago atrasado de una factura ya autorizada.
Recargos y gastos
Agrega gastos administrativos, financieros u otros recargos posteriores a la venta.
Ajustes al alza
Corrige un importe facturado de menos en el comprobante original.
Conceptos adicionales
Cobra conceptos extra vinculados a una operación ya facturada.
Qué incluye
Emisión completa, sin escribir el XML a mano
- Referencia obligatoria al comprobante de origen (factura modificada).
- Detalle de motivos del cargo adicional, cada uno con su razón y valor.
- Con los SDKs, cálculo del IVA y del valor total.
- Firma electrónica y autorización ante el SRI, con reintentos automáticos.
- RIDE en PDF y XML firmado descargables, y envío por email al cliente.
Versiones y estructura
La nota de débito, campo por campo
La API valida la nota de débito contra el esquema oficial del SRI; declaras la versión en comprobante.version. Referencia la factura de origen y detalla los motivos del cargo adicional. Forma parte de la API de Facturación Electrónica.
Versiones soportadas
1.0.0
info_tributaria Ambiente, RUC, clave de acceso de 49 dígitos, tipo de documento (cod_doc 05) y secuencia.
info_nota_debito Comprador, documento modificado, impuestos y valor total del cargo.
motivos Razón y valor de cada cargo adicional (intereses, mora, recargos).
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 Notas de Crédito
Anula o disminuye facturas por devoluciones y descuentos.
API de Retenciones
Emite retenciones de IVA y Renta como agente de retención.
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é versión de nota de débito soporta la API? ▾
Actualmente se soporta la versión 1.0.0 del esquema de nota de débito del SRI. Declaras la versión en el campo comprobante.version y validamos el comprobante contra ese esquema antes de firmar.
¿Qué es una nota de débito electrónica? ▾
Es el comprobante con el que cobras valores adicionales sobre una factura ya emitida —intereses, mora, recargos o conceptos extra— referenciando el documento de origen. A diferencia de la nota de crédito (que disminuye o anula), la nota de débito aumenta el valor.
¿En qué se diferencia de la nota de crédito? ▾
La nota de crédito disminuye o anula el valor de una factura (devoluciones, descuentos); la nota de débito incrementa el valor a cobrar (intereses, recargos). Ambas referencian el comprobante de origen.
¿Debo referenciar la factura original? ▾
Sí. La nota de débito indica 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.
¿Cómo recibo el resultado? ▾
Tras el POST recibes un id y el estado «encolado». El resultado final (autorizado o rechazado) llega por webhook o consultando el estado por id, con el XML firmado y el RIDE en PDF.
Acceso y soporte
Empieza a emitir notas de débito 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