Descargar el RIDE de una factura
El mismo PDF que recibe tu cliente, para que lo muestres en tu sistema.
GET /v1/ec/invoices/0f6c8f4e-…/pdf
Authorization: Bearer fb_live_…200 OK
Content-Type: application/pdfRIDE del SRI en PDF, generado por API
El RIDE es la representación impresa de un comprobante autorizado. Generamos el de los seis tipos con el formato del SRI y lo enviamos por correo junto con el XML.
Sandbox gratis, sin RUC ni tarjeta
Qué es el RIDE
El papel de un documento que ya es electrónico.
RIDE significa representación impresa del documento electrónico. El comprobante en sí es el XML autorizado; el RIDE es lo que tu cliente imprime o guarda para leerlo.
La ficha técnica define su contenido: los datos del emisor, el tipo y el número, la clave de acceso, el ambiente, los datos del comprador, el detalle y los totales. El código de barras es opcional.
Cómo lo generamos
Un PDF A4, el mismo que viaja por correo.
- Un PDF A4 para cada uno de los seis tipos de comprobante.
- Tu logo en el encabezado; todo lo demás es tinta y gris, así que imprime igual en blanco y negro.
- El emisor se identifica con «RUC» y su número; el comprador y las demás partes, solo con su número.
- La clave de acceso en un código de barras Code 128 con sus dígitos debajo.
- En Sandbox y Pruebas, una etiqueta «sin validez tributaria» bajo el número.
- Disponible cuando el SRI autoriza; antes, la API responde 409 not_ready.
- El correo al receptor lo lleva adjunto con el XML autorizado.
En la API
La misma solicitud que enviarías desde tu sistema.
Preguntas frecuentes
Lo que suelen preguntar antes de integrar.
¿Qué diferencia hay entre el RIDE y el XML?
El XML autorizado es el comprobante electrónico; el RIDE es su representación impresa. Tu cliente recibe los dos por correo.
¿Puedo poner mi logo?
Sí. Tu logo aparece en el encabezado; el resto del RIDE no lleva colores para imprimir igual en blanco y negro.
¿Cuándo puedo descargar el RIDE?
En cuanto el SRI autoriza y se termina de generar. Un instante antes, la API responde 409 not_ready.
¿El RIDE de pruebas vale como factura?
No. Los de Sandbox y Pruebas llevan una etiqueta «sin validez tributaria» bajo el número.
Sigue leyendo
Otras guías para la misma integración.
API de facturación electrónica
Emite facturas, notas de crédito, retenciones y guías del SRI con una API REST. Firmamos, enviamos al SRI, reintentamos y avisamos con webhooks. Sandbox gratis.
Nota de crédito
Emite notas de crédito electrónicas del SRI por API: devoluciones y descuentos sobre una factura, con su número, su clave de acceso y su RIDE.
Guía de remisión
Emite guías de remisión electrónicas del SRI por API antes de mover tu mercadería: transportista, placa, destinatarios y la factura que respalda cada envío.
Webhooks
Recibe un webhook firmado cuando el SRI autoriza, devuelve o no autoriza un comprobante. Standard Webhooks, reintentos durante tres días y secreto rotable.