Alternativa a la API de Contifico: REST + SDK TypeScript
API REST moderna para emitir facturas electrónicas autorizadas por el SRI Ecuador. SDK oficial para Node/TypeScript, sandbox completo, webhooks firmados y colección Postman. Sin contratos comerciales para empezar.
- Node.js
- TypeScript
- PHP
- Python
- Go
- Ruby
- .NET
// Emite una factura electrónica autorizada por el SRI en 10 líneas
import { Factuplan } from "factuplan"
const factuplan = new Factuplan(process.env.FACTUPLAN_API_KEY!, {
ruc: "0993378150001",
})
const factura = await factuplan.invoices.create({
customer: {
identificationType: "RUC",
identification: "0950194407001",
legalName: "Cliente Demo S.A.",
email: "facturas@cliente.ec",
},
items: [
{
description: "Servicio mensual",
quantity: 1,
unitPrice: 500,
taxType: "IVA_RATE",
tax: 15,
},
],
sendEmail: true,
})
// → factura.accessKey (49 dígitos), factura.pdfUrl, factura.xmlUrl
console.log(factura.accessKey)Por qué developers eligen Factuplan sobre Contifico API
Diferenciadores concretos pensados para equipos de ingeniería que necesitan integrar facturación electrónica del SRI Ecuador en su stack.
SDK oficial TypeScript
Cliente tipado de punta a punta con autocompletado, validación local y manejo de errores estructurado. Único en el mercado ecuatoriano.
Sandbox de pruebas real
Crea API keys de pruebas (ak_test_*) sin tarjeta. Comprobantes ficticios que se eliminan cada hora, ideales para CI/CD y staging.
Webhooks firmados
Recibe eventos invoice.authorized, invoice.rejected y más con firma HMAC SHA-256. Sin polling, sin reintentos manuales.
Postman Collection completa
Importa la colección oficial con todos los endpoints, ejemplos de request y response. Prueba la API en minutos sin escribir código.
Modos A / B / C del SRI
Soporte de los 3 modos de operación: Factuplan firma y autoriza (A), tú generas el XML (B), o solo firmamos (C). Flexibilidad total.
Documentación moderna
Referencia completa con snippets en Node, Python, PHP, Go, Ruby y .NET. Cambios versionados, sin sorpresas en producción.
Factuplan API vs Contifico API
Comparativa enfocada en developer experience. Información de proveedores a mayo 2026.
| Característica | Factuplan API | Contifico API |
|---|---|---|
| SDK oficial TypeScript | ✓ Tipado completo (npm install factuplan) | — |
| Documentación pública | ✓ Referencia REST + SDK + Postman | Acceso restringido por solicitud |
| Sandbox sin tarjeta | ✓ ak_test_* en 2 minutos | Trámite comercial previo |
| Webhooks firmados HMAC | ✓ invoice.authorized / invoice.rejected | Limitados |
| Tipos de comprobante | Factura, NC, ND, retención, guía remisión, liquidación | Cobertura similar |
| Modos de operación SRI | A (full) + B + C | Modo único |
| Idempotency keys | ✓ Header X-Idempotency-Key | — |
| Reintentos automáticos | ✓ Backoff exponencial en SDK | Manual |
| Errores estructurados | JSON con code, statusCode, sriCode, details | Respuestas heterogéneas |
| Rate limits visibles | ✓ Headers X-RateLimit-* + cuota mensual en dashboard | Sin documentación pública |
| Pricing por uso | Plan freemium con 25 el primer mes + planes pagos | Cotización comercial |
| Contratos / permanencia | Sin contratos. Cancela cuando quieras | Acuerdos comerciales |
Comparativa basada en documentación pública y observación del ecosistema. Contifico es marca registrada de sus respectivos titulares; esta página es informativa y no representa una afiliación comercial.
Migración guiada en 5 pasos
Una migración típica toma 1-3 días para un equipo developer. Estos son los pasos clave.
Paso 1. Crea cuenta Factuplan y API key
Registro gratuito en 2 minutos. Genera tu primera API key de pruebas (ak_test_*) desde Developer → Create API key.
Paso 2. Instala el SDK o usa cURL
npm install factuplan para Node/TypeScript. Para PHP, Python, Go, Ruby, .NET usa la API REST directa con la Postman Collection.
Paso 3. Mapea endpoints
Los endpoints de Factuplan siguen REST estándar (/v1/developer/invoices, /v1/developer/credit-notes). Mapeamos los principales endpoints de Contifico API al equivalente en Factuplan.
Paso 4. Prueba en sandbox
Emite facturas ficticias en ambiente de pruebas. Verifica webhooks, errores y casos límite sin tocar producción.
Paso 5. Cambia a producción
Reemplaza ak_test_* por ak_live_* en tu variable de entorno. El código del SDK no cambia. Listo.
Recursos para developers
Documentación, snippets y tutoriales actualizados para arrancar rápido.
Referencia completa de la API REST
Endpoints, headers, payloads, códigos de error y catálogos del SRI. Con snippets en cURL.
Abrir docsSDK oficial Node/TypeScript
Instalación, autenticación, emisión de comprobantes, webhooks y manejo de errores tipados.
Abrir referencia SDKTutorial Node.js paso a paso
Pre-requisitos, instalación, primera factura, webhooks, manejo de errores, testing.
Leer tutorialTutorial PHP / Guzzle
Cliente cURL nativo y con Guzzle, webhooks con verificación HMAC, integración WooCommerce.
Leer tutorialColección Postman oficial
Todos los endpoints con ejemplos de request y response. Importa en Postman en 30 segundos.
Descargar JSONDeep-dive: SDK TypeScript
Por qué TypeScript, type safety, comparativa con cURL directo, patrones de error.
Leer postPreguntas frecuentes
- ¿Qué diferencia tiene la API de Factuplan frente a la API de Contifico?
- Tres diferencias clave para developers: 1) Factuplan publica un SDK oficial tipado en TypeScript (paquete factuplan en npm) con validación local, autocompletado y manejo de errores estructurado; Contifico no tiene SDK oficial publicado; 2) Factuplan expone documentación pública completa de la API REST, sandbox sin tarjeta, Postman Collection oficial y webhooks firmados con HMAC SHA-256; Contifico requiere acuerdo comercial previo para acceder a documentación detallada; 3) Factuplan soporta los 3 modos de operación del SRI (A, B, C) con un mismo API key, permitiendo flexibilidad para diferentes arquitecturas. Ambos están autorizados por el SRI y emiten comprobantes con la misma validez tributaria.
- ¿Puedo migrar mi integración de Contifico API a Factuplan sin reescribir todo?
- La migración requiere ajustes en los nombres de endpoints, estructura de payload y campos de respuesta porque ambas APIs son REST pero no comparten esquema. Sin embargo, los conceptos son los mismos (customer, items, taxes, payments) y el modelo mental no cambia. En la práctica, una migración típica toma 1-3 días para un equipo developer: 1 día para mapear endpoints y datos, 1 día para implementar y testear en sandbox de Factuplan, 1 día para coexistencia gradual o cutover. El SDK oficial de Factuplan ahorra mucho boilerplate si tu stack es Node.js o TypeScript.
- ¿Es necesario tener una cuenta comercial con Factuplan para usar la API?
- No. A diferencia de algunas APIs corporativas, Factuplan permite crear cuenta gratuita y API key sin contrato comercial previo, sin formularios largos, sin tarjeta de crédito. El plan Free incluye 25 facturas reales/mes en producción para developers que están construyendo MVPs o sistemas de bajo volumen. Para volumen mayor, los planes pagos arrancan desde precios accesibles y se contratan auto-servicio desde el dashboard. Solo necesitas cuenta comercial si requieres SLAs específicos, soporte dedicado o features enterprise.
- ¿Qué pasa con mis datos históricos en Contifico al migrar?
- Tus comprobantes históricos emitidos en Contifico siguen siendo válidos y registrados en el SRI; no se borran al migrar de proveedor porque el SRI es la fuente autoritativa, no Contifico ni Factuplan. Recomendaciones: 1) Descarga del SRI o desde Contifico los XML autorizados de tu histórico (típicamente 7 años de prescripción tributaria) y archívalos en tu propio almacenamiento; 2) Si tu sistema legacy referencia datos de clientes, productos o secuenciales de Contifico, exporta esos catálogos antes del cutover; 3) En Factuplan importa el catálogo de clientes y productos vía API masiva o CSV para evitar recapturar manualmente.
- ¿Factuplan tiene rate limits o cuotas en su API?
- Sí, todos los servicios bien diseñados los tienen. Factuplan publica los rate limits en headers HTTP (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) en cada response, así tu cliente puede ajustar el ritmo automáticamente. Adicionalmente hay una cuota mensual de comprobantes según el plan (25 el primer mes en Free, 10/mes en Start desde USD 9, mayor en planes superiores), visible en el dashboard. Al acercarte al 80% del límite recibes notificación por email; al llegar al 100% el sistema rechaza con HTTP 429 y mensaje claro hasta que renueves o subas de plan. El SDK oficial maneja los reintentos con backoff exponencial automáticamente.
- ¿La API de Factuplan soporta los Modos A, B y C del SRI?
- Sí. La API y el SDK soportan los tres modos definidos por la Ficha Técnica de Comprobantes Electrónicos del SRI: Modo A: Factuplan genera el XML, lo firma con tu certificado P12, lo autoriza ante el SRI, genera el RIDE PDF y envía email al cliente; es el modo recomendado y más simple para la mayoría de integraciones. Modo B: Tú generas el XML sin firmar y se lo entregas a Factuplan, que lo firma y autoriza por ti. Útil cuando tu sistema legacy ya genera XMLs propios. Modo C: Factuplan solo firma el XML que tú generaste; el envío al SRI lo gestionas por tu cuenta. Útil para arquitecturas con control total. Los tres modos usan el mismo API key y se eligen por endpoint o parámetro según convenga.
- ¿Hay un SLA o garantía de disponibilidad de la API?
- 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 de la API de Factuplan se monitorea continuamente y los incidentes se publican en el status page. Para casos de caída del SRI (que no son responsabilidad del proveedor de facturación), el modo contingencia permite seguir emitiendo y la cola pendiente se procesa al restablecimiento del servicio del SRI.
Empieza a facturar electrónicamente hoy
1 mes gratis al comprar tu firma electrónica con FirmaOK. Sin tarjeta de crédito.
- Empresas activas
- +1.000
- Calificación clientes
- 4.9/5
- Tiempo de onboarding
- <1 día
- Disponibilidad SRI
- 24/7
- Configuración en minutos
- Cancela cuando quieras
- Soporte en español ecuatoriano