API facturación electrónica REST para Ecuador

Son dos páginas complementarias con audiencias distintas. /api (esta página) es la landing comercial del API: presenta el valor, casos de uso, comparativa con otras APIs del mercado y CTA para crear API key. /docs/api es la referencia técnica detallada: endpoints, payloads completos, códigos de error, schemas, ejemplos exhaustivos. Si estás evaluando si Factuplan API encaja con tu proyecto, empieza aquí; si ya decidiste integrar y necesitas la referencia, salta a /docs/api. Ambas están cross-linked.

No. Crea tu cuenta en app.factuplan.com.ec sin tarjeta y genera tu primera API key de pruebas (prefijo ak_test_*) en 2 minutos. Los comprobantes emitidos en sandbox son ficticios y se eliminan automáticamente cada hora; con el contribuyente de pruebas que trae tu cuenta nueva (RUC 9999999990001) no requieren firma electrónica P12 (Factuplan omite la firma y simula la respuesta del SRI). Cuando estés listo para producción, cargas tu firma electrónica vigente y reemplazas la API key por una ak_live_*. El plan freemium incluye 25 facturas reales/mes en producción también sin tarjeta.

Cualquiera que pueda hacer HTTP POST con JSON. La API REST es estándar: cabeceras X-API-Key + x-taxpayer-ruc, body JSON, respuestas con sobre data/meta. Tenemos snippets oficiales en cURL, Node.js, TypeScript, Python, PHP, Go, Ruby y .NET. Para Node.js/TypeScript publicamos un SDK oficial tipado en npm (paquete factuplan) que añade autocompletado, manejo de errores estructurado y verificación de firmas de webhooks. El SDK no reintenta por su cuenta (timeout de 30 segundos): si reintentas una emisión, envía el mismo devReference para no duplicar el comprobante. Para otros lenguajes la integración es directa con la API REST.

Sí, todo API serio los tiene. Factuplan publica los rate limits en headers HTTP (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) en cada response, así tu cliente puede ajustarse automáticamente. Hay también una cuota mensual de comprobantes según tu plan (25 el primer mes en Free, 10/mes en Start desde USD 9, mayor en planes superiores), visible en tu dashboard. Al agotar el cupo de tu plan (y el excedente, si tu plan lo incluye) la API rechaza las emisiones con HTTP 403 hasta que renueves o subas de plan: código SUB_12002, o SUB_12008 cuando también se agotó el excedente. El HTTP 429 es para cuando superas el límite de peticiones por segundo. El SDK no reintenta por su cuenta: ante un 429 lanza RateLimitError y tú decides cuándo volver a intentar.

Configuras un endpoint HTTPS público en tu app en Dashboard → Developer → Webhooks. Factuplan envía eventos POST con body JSON y header x-factuplan-signature con el formato t=<timestamp>,v1=<firma> (HMAC SHA-256 sobre el texto <timestamp>.<body> con tu webhook secret). Los eventos principales son invoice.authorized, invoice.rejected, credit_note.authorized, waybill.authorized, withholding.authorized y sus contrapartes rejected. Tu endpoint verifica la firma, procesa el evento (idealmente async/encolado) y responde 200 OK rápido. Si tu endpoint falla o tarda, Factuplan reintenta con backoff exponencial: hasta 8 intentos en cerca de una hora. Tras 10 entregas fallidas seguidas el webhook se desactiva y te avisamos por correo. Cuando lo reactives en Dashboard → Developer → Webhooks, puedes reenviar desde su historial las entregas que no llegaron: ahí quedan registrados también los eventos de los 7 días siguientes a la desactivación.

Los tres modos definidos por la Ficha Técnica de Comprobantes Electrónicos v2.32: Modo A (recomendado, default): Factuplan genera el XML, lo firma con tu P12, lo autoriza ante el SRI, genera el RIDE PDF y envía el email al cliente. Modo B: tú generas el XML según el schema del SRI, nos lo envías sin firmar, nosotros lo firmamos y autorizamos. Modo C: tú generas el XML, Factuplan solo lo firma con tu P12 y el envío al SRI lo haces tú. Los tres modos usan la misma API key y se eligen por endpoint. La mayoría de integraciones usan Modo A porque resuelve todo el flujo end-to-end.

Para planes pagos Factuplan ofrece SLA documentado en el contrato comercial estándar, típicamente 99.9% mensual con compensaciones por incumplimiento. Para el plan gratuito el SLA es best-effort sin compromiso contractual, aunque la infraestructura es la misma. La disponibilidad real se monitorea continuamente y los incidentes se publican en el status page. Para caídas del SRI (que no son responsabilidad del proveedor), la API sigue aceptando emisiones: el comprobante queda en ERROR (recibes el webhook invoice.error) y Factuplan lo reintenta automáticamente cuando el SRI vuelve a responder.

Sí. Las API keys son por workspace en Factuplan, y un workspace puede tener múltiples RUCs configurados (cada uno con su firma electrónica P12). En cada request envías el header x-taxpayer-ruc indicando con qué RUC emitir el comprobante. Esto es ideal para SaaS verticales, marketplaces y plataformas que facturan en nombre de múltiples clientes finales. Cada RUC tiene su catálogo de productos, clientes, secuenciales y reportes independientes, pero todo bajo una sola API key y un solo dashboard.