Cómo funciona
- Creas la factura con un POST — tu sistema envía cliente, ítems y la referencia de tu pedido; Seles arma el XML, lo firma con tu firma electrónica y lo envía al SRI.
- Emisión asíncrona — la API acepta la solicitud y te devuelve el ID de la factura; con ese ID consultas su estado hasta que el SRI la autoriza o la rechaza.
- Sin duplicados — repetir la solicitud con la misma referencia_externa devuelve la factura existente; puedes reintentar sin riesgo.
- RIDE y XML — descargas el PDF con código QR y el XML autorizado, y Seles se los envía por correo a tu cliente.
- Si el SRI está caído — el comprobante queda en cola y Seles reintenta el envío automáticamente.
Endpoints de la API v1
Base: https://seles-backend.onrender.com/api/v1 · Autenticación: Authorization: Bearer <tu-api-key>
| Método | Ruta | Para qué sirve |
|---|---|---|
| GET | /ping | Verifica tu API key |
| POST | /facturas | Crea y emite una factura (asíncrona) |
| GET | /facturas?referencia_externa=X | Busca por el ID de tu pedido |
| GET | /facturas/{id} | Estado de la factura |
| GET | /facturas/{id}/pdf · /xml | RIDE en PDF y XML autorizado |
| POST | /facturas/{id}/nota-credito | Nota de crédito sobre una factura |
| GET · POST | /retenciones | Lista y emite comprobantes de retención |
| GET · POST | /clientes | Lista y crea clientes |
curl -X POST https://seles-backend.onrender.com/api/v1/facturas \
-H "Authorization: Bearer <tu-api-key>" \
-H "Content-Type: application/json" \
-d '{
"cliente": { "razon_social": "Juan Perez", "numero_id": "0999999999", "tipo_id": "CEDULA" },
"items": [
{ "descripcion": "Producto", "cantidad": 2, "precio_unitario": 10, "tarifa_iva": 15 }
],
"referencia_externa": "pedido-123"
}'El sandbox usa el mismo contrato en /api/sandbox/v1/facturas: cambias la key y la URL base al pasar a producción.
Precio por documento autorizado
Sandbox
Cuenta developer
Recargas el saldo desde tu panel developer eligiendo el monto. Si el SRI rechaza un comprobante, el valor vuelve a tu saldo.
Partners por volumen
Si tu plataforma emite en nombre de muchos negocios (marketplaces, sistemas de reservas, ERPs), puedes integrarte como partner: tus usuarios activan su facturación desde tu sistema y tú recibes el resultado de cada comprobante por webhook (factura autorizada o rechazada, con el motivo y los enlaces al PDF y XML). El precio depende del volumen mensual:
Start
Growth
Scale
Enterprise
Los precios de cada nivel se acuerdan al aprobar la solicitud.
Preguntas frecuentes
¿Necesito firma electrónica para probar la API?
No para el sandbox: es simulado, no emite nada ante el SRI y no pide certificado. Para emitir en producción necesitas una cuenta developer con tu RUC verificado y tu firma electrónica (.p12) cargada.
¿Cómo evito facturar dos veces el mismo pedido?
Envía siempre el ID de tu pedido en referencia_externa. Si repites la solicitud con la misma referencia, la API devuelve la factura que ya existe en lugar de crear otra.
¿Cuándo se descuenta el saldo?
Al aceptar la solicitud se reserva $0.05. Si el SRI rechaza el comprobante o hay un error del sistema, se devuelve al saldo; solo pagas los documentos autorizados.
El uso de la API se rige por los Términos de uso de la API.