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

Hay dos 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 la documentación técnica en /docs/api hay un link de descarga al inicio. El archivo pesa menos de 1 MB y contiene los endpoints principales de la API para desarrolladores: comprobantes, catálogos, uso y certificado. Los webhooks se configuran desde el panel, no con la API key. Es la misma colección oficial mantenida por el equipo de Factuplan.

45 peticiones de la API REST de Factuplan organizadas en 8 carpetas (dentro de v1 → developer): 1) invoices: POST /invoices (emitir, Modo A: XML + firma + SRI + PDF), GET /invoices (listar facturas), POST /invoices/import (importar por clave de acceso), PATCH /invoices/sequential y, para una factura por su ID, GET /receipts/:id, GET /receipts/:id/status, GET /receipts/:id/xml, GET /receipts/:id/pdf y POST /receipts/:id/void; 2) credit-notes y 3) debit-notes: emitir, listar, actualizar el secuencial y las mismas consultas por ID; 4) withholdings: emitir, listar y las consultas por ID; 5) customers y 6) products: CRUD completo (POST, GET listar, GET por id, PATCH, DELETE); 7) usage: GET /usage; 8) certificate: GET /certificate/status y POST /certificate (subir P12). No incluye los Modos B y C (POST /sign-and-authorize y POST /sign), validate-xml, verify, authorize-signed, liquidaciones de compra, compras, contribuyentes ni los reintentos. Tampoco trae peticiones de guías de remisión, porque la API no tiene endpoint para emitirlas ni listarlas: se emiten desde el panel o enviando tu propio XML a /sign-and-authorize (sin firmar) o /authorize-signed (ya firmado). Las peticiones de emisión traen un body de ejemplo y 15 de las 45 incluyen respuestas de ejemplo guardadas.

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 y el de taxpayerRuc con un RUC de tu workspace. 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-rest.factuplan.com.ec, apiKey (vacía), taxpayerRuc=0950194407001 (de ejemplo). 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 un RUC registrado en tu workspace (con el de ejemplo la API responde 400); 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.

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.