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.

26 endpoints de la API REST de Factuplan organizados en 4 secciones: 1) Emisión y firma: POST /invoices (Modo A: XML + firma + SRI + PDF), POST /invoices/import (importar por clave), POST /sign-and-authorize (Modo B), POST /sign (Modo C), POST /validate-xml, GET /verify/:accessKey, PATCH /invoices/sequential; 2) Comprobantes: POST /receipts/query, GET /receipts/:id, GET /receipts/:id/status, GET /receipts/:id/xml, GET /receipts/:id/pdf, POST /receipts/:id/void; 3) Catálogos: CRUD completo de customers y products (POST, GET listar, GET por id, PATCH, DELETE); 4) Cuenta y certificado: GET /usage, GET /certificate/status, POST /certificate (subir P12). Cada endpoint trae body de ejemplo, response esperado y códigos de error documentados.

Sí. La colección usa variables ({{baseUrl}}, {{apiKey}}, {{taxpayerRuc}}) ya declaradas a nivel de colección — solo tienes que reemplazar el valor de apiKey con tu key real. Para obtenerla 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). La colección la envía como header X-API-Key automáticamente.

La colección viene con 3 variables a nivel de colección, ya pre-creadas: baseUrl=https://api.factuplan.com.ec, apiKey=ak_test_xxx (placeholder), taxpayerRuc=0993378150001 (placeholder). Para usarla: 1) Abre la colección 'Factuplan API' en el panel izquierdo; 2) Pestaña 'Variables'; 3) Reemplaza la columna 'Current value' del apiKey con tu key real y del taxpayerRuc con tu RUC; 4) Ctrl/Cmd + S para guardar. Si prefieres separar pruebas y producción, crea environments adicionales con las mismas tres claves y usa el dropdown superior derecho para alternar.

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.