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, se eliminan automáticamente cada hora, y no requieren firma electrónica P12 real (Factuplan simula la firma en pruebas). 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, validación local de RUC, reintentos automáticos con backoff exponencial, manejo de errores estructurado y verificación de firmas de webhooks. 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 acercarte al 80% del límite recibes notificación; al llegar al 100% el sistema rechaza con HTTP 429 hasta que renueves o subas de plan. El SDK oficial maneja los reintentos con backoff exponencial automáticamente.

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 (HMAC SHA-256 sobre el 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.

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 y firmas el XML por tu cuenta, Factuplan solo gestiona la transmisión al SRI. Los tres modos usan la misma API key y se eligen por endpoint o parámetro. 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), el modo contingencia automático permite seguir emitiendo localmente y la cola pendiente se procesa al restablecimiento del servicio del SRI.

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.