API REST
Referencia de la API pública v1 de Factunexo: autenticación, servidores y endpoints.
La API REST v1 te permite integrar Factunexo con tus propios sistemas: emitir comprobantes electrónicos, gestionar clientes y catálogo, y consultar el estado de autorización ante el SRI.
Autenticación
Todas las rutas /api/v1/** requieren API Key y API Secret en headers:
| Header | Descripción |
|---|---|
X-API-Key | Identificador público de la credencial |
X-API-Secret | Secreto de la credencial (solo visible al crearla) |
Las credenciales se crean en la app merchant: Configuración → Credenciales API.
No compartas el X-API-Secret. Si se filtra, revoca la credencial y genera una nueva.
Servidores
| Entorno | URL base |
|---|---|
| Sandbox | https://api-stg.factunexo.com.ec |
| Producción | https://api.factunexo.com.ec |
En cada página de endpoint puedes probar la llamada con el playground (elige el servidor en el selector).
Alcance actual (v1)
- Billing: facturas, notas de crédito/débito, retenciones, guías de remisión, liquidaciones y bitácora de eventos
- Workflow: clientes y catálogo de ítems
- Setup: perfil tributario, establecimientos y puntos de venta
Empezar
- Crea una credencial API en la app.
- Elige un punto de venta (
posId) — lo necesitas al emitir comprobantes. - Revisa la referencia por módulo en el menú lateral.