API de facturación electrónica del SRI para desarrolladores
La API REST de Factio te permite emitir facturas y notas de crédito electrónicas autorizadas por el SRI desde tu propio software, sin implementar la firma ni el envío al SRI. Autenticas tus solicitudes con claves de API y trabajas primero en el ambiente de pruebas.
Esta página resume qué resuelve la API y qué necesitas antes de integrarla. El detalle de los endpoints está en la documentación.
Crear cuentaQué resuelve la API
- Firma XAdES-BES con el certificado .p12 del emisor.
- Generación de la clave de acceso de 49 dígitos.
- Envío al SRI en los ambientes de pruebas y producción.
- RIDE en PDF y XML autorizado de cada comprobante.
- Envío de comprobantes por email.
- Reintentos automáticos acotados cuando el SRI no responde.
Cómo se integra
Autenticación con claves de API
La API usa claves de API para autenticar tus solicitudes. La referencia de la API en la documentación explica cómo obtenerlas y enviarlas.
Ambientes de pruebas y producción
Los emisores empiezan en el ambiente de pruebas del SRI. Construye y valida tu integración allí, y pasa a producción cuando tu emisor esté listo.
Documentos soportados
Hoy la API emite facturas (01) y notas de crédito (04). No emite otros tipos de comprobante.
Qué necesita el emisor antes de emitir
- Una cuenta en Factio, creada con email o con Google.
- Los datos de la empresa: razón social, RUC y dirección.
- Al menos un establecimiento y un punto de emisión.
- El certificado de firma electrónica .p12 del emisor, emitido por una entidad autorizada.
Qué debe contemplar tu integración
Si el SRI no responde, Factio reintenta de forma automática un número acotado de veces y, si no hay respuesta, el documento queda para revisión manual. Tu integración debe contemplar que un documento puede quedar pendiente de revisión.
Los requisitos oficiales de los comprobantes electrónicos los define el SRI. Consúltalos en su sitio oficial.
Documentación
La documentación de Factio incluye guías y la referencia de la API REST. Empieza por ahí para ver los endpoints disponibles y cómo se envía cada solicitud.
Plan Free de lanzamiento
Durante el lanzamiento, el plan Free incluye sandbox ilimitado, hasta 50 documentos al mes en producción y 1 emisor (RUC). Los planes comerciales aún no están definidos.
Preguntas frecuentes
¿Qué es la API de Factio?
Es una API REST para emitir facturas y notas de crédito electrónicas autorizadas por el SRI. Se encarga de la firma XAdES-BES, la clave de acceso, el envío al SRI y la entrega del RIDE y el XML autorizado.
¿Cómo me autentico?
Con claves de API. La documentación de Factio detalla cómo obtenerlas y usarlas.
¿Puedo probar la integración sin emitir en producción?
Sí. Los emisores empiezan en el ambiente de pruebas del SRI, y el plan Free de lanzamiento incluye sandbox ilimitado.
¿Qué tipos de documento soporta la API?
Facturas (01) y notas de crédito (04).
¿Qué pasa si el SRI no responde?
Factio reintenta de forma automática un número acotado de veces. Si no hay respuesta, el documento queda para revisión manual.
¿Dónde está la documentación?
En https://docs.factioapp.com/, con guías y la referencia de la API REST.
Empieza a integrar con Factio
Crea tu cuenta, completa el onboarding y empieza a integrar en el ambiente de pruebas.
Crear cuenta