Colección Postman facturación SRI: API de Factuplan

Hay tres formas: 1) Desde esta página, haz clic en el botón 'Descargar colección Postman' del hero — descarga el archivo factuplan-developer.postman_collection.json directamente; 2) Desde el dashboard de Factuplan, anda a Developer → Recursos → Postman Collection; 3) Desde la documentación técnica en /docs/api hay un link de descarga al inicio. El archivo pesa menos de 1 MB y contiene todos los endpoints de la API REST: comprobantes, catálogos, configuración, webhooks. Es la misma colección oficial mantenida por el equipo de Factuplan y se actualiza con cada cambio de la API.

Todos los endpoints de la API REST de Factuplan organizados en 3 secciones: 1) Comprobantes: facturas, notas de crédito, notas de débito, guías de remisión, comprobantes de retención y liquidaciones de compra (POST para crear, GET para listar y obtener); 2) Catálogos: clientes (GET, POST, PATCH) y productos (GET, POST, PATCH); 3) Configuración: puntos de emisión configurados, uso actual del workspace (cuota mensual), gestión de webhooks. En total son aproximadamente 25 endpoints documentados con ejemplos de request y response.

Sí. La colección está estructurada con variables ({{apiKey}}, {{taxpayerRuc}}, {{baseUrl}}) que se completan al configurar tu environment en Postman. Para obtener tu API key gratis: crea cuenta en app.factuplan.com.ec (sin tarjeta de crédito, 2 minutos), anda a Developer → Create API key, copia la clave generada (solo se muestra una vez). El prefijo indica el ambiente: ak_test_* para pruebas (comprobantes ficticios que se eliminan cada hora) y ak_live_* para producción (facturas reales firmadas y enviadas al SRI).

Después de importar la colección: 1) Clic en el ícono de engranaje (esquina superior derecha) → 'Manage Environments' → 'Add'; 2) Nombra el environment (ej: 'Factuplan Sandbox'); 3) Agrega las variables: baseUrl=https://api.factuplan.com.ec, apiKey=tu_ak_test_xxx, taxpayerRuc=0993378150001 (o tu RUC real); 4) Opcionalmente: establishmentCode=001, emissionPointCode=001 si tienes más de un punto de emisión; 5) Guarda y selecciona el environment en el dropdown superior derecho antes de ejecutar requests. Para producción crea otro environment con tu ak_live_* y RUC real.

Sí, si usas una API key de producción (ak_live_*) con un RUC con firma electrónica P12 vigente cargada en tu workspace. Cuidado: las facturas emitidas desde Postman con ak_live_* son REALES, se firman, se envían al SRI y se autorizan oficialmente. Después no se pueden borrar sin emitir nota de crédito (excepto consumidor final que desde 2026 ni siquiera con NC). Para developers que están probando la integración, recomendamos fuertemente usar primero ak_test_* (sandbox) hasta que el flujo esté validado, y solo después cambiar a ak_live_*. Esto evita errores costosos en producción real.

No automáticamente — debes descargar la nueva versión cuando publiquemos cambios. El changelog en /desarrolladores documenta cambios técnicos de la API y avisa cuando hay una nueva versión de la colección. Cambios mayores (versión 2.x) son raros y se anuncian con margen de tiempo. Cambios menores son aditivos (nuevos endpoints, nuevos campos opcionales) y no rompen integraciones existentes. Si configuraste tus webhooks correctamente, también recibes notificación de los cambios relevantes para tu integración por email del workspace.

Sí, es una de las features más útiles. Una vez que tienes una request configurada con tu environment, abre el panel derecho de Postman → ícono '</>' (Code). Postman te genera el snippet equivalente en aproximadamente 20 lenguajes: cURL, Node.js (vanilla y axios), Python (requests, http.client), PHP (cURL y Guzzle), Go, Ruby, Java, C#, Swift, etc. Es la forma más rápida de empezar tu integración: pruebas con Postman primero, copias el snippet generado y lo pegas en tu código real. Aclaración: para Node.js/TypeScript la opción ideal sigue siendo el SDK oficial (paquete factuplan en npm) por el tipado completo y el manejo de errores estructurado.

Sí, con Postman Collection Runner. Selecciona la colección de Factuplan, clic en 'Run' → te abre Runner. Ahí puedes seleccionar requests específicas en orden, configurar iteraciones, agregar delays entre requests y pasar variables entre ellas (ej: el accessKey de la factura creada se pasa automáticamente a la nota de crédito). Crear scripts en la pestaña 'Tests' de cada request permite validar el response antes de pasar a la siguiente. Es la forma estándar de armar suites de regression para tu integración. Para CI/CD, puedes ejecutar Runner desde línea de comandos con Newman (CLI de Postman) integrado en GitHub Actions, GitLab CI o Jenkins.