📮 Colección Postman — MATIAS API Sandbox
Para acelerar la integración técnica y las pruebas de comportamiento en el sandbox, disponemos de una Colección Postman oficial con 43 solicitudes preconfiguradas que cubren tanto el flujo exitoso (happy path) como todos los escenarios de error simulables (Magic Values).
📥 Descarga e Importación
Pasos para importar en Postman:
- Abre tu aplicación Postman (Web o Desktop).
- Haz clic en Import (esquina superior izquierda).
- Arrastra o selecciona el archivo
sandbox-quickstart.postman_collection.json. - Selecciona el Environment de Sandbox y comienza a realizar tus peticiones.
📁 Estructura de la Colección (43 Requests)
La colección se encuentra estructurada en 11 carpetas lógicas:
| Carpeta | Requests | Descripción |
|---|---|---|
| 1. Producción | 1 | Registro de cuenta en ambiente productivo. |
| 2. Sandbox — Auth | 2 | Login y generación de tokens de acceso (PAT) para el Sandbox. |
| 3. Sandbox — Facturación | 14 | Happy Path y 13 simulaciones de error (Magic Values) para facturas. |
| 4. Sandbox — PDF & Status | 3 | Consulta asíncrona de estado, descarga de PDF y metadatos. |
| 5. Sandbox — Notas Crédito/Débito | 2 | Pruebas de notas y validaciones de fechas desfasadas. |
| 6. Sandbox — Documento Soporte | 2 | Documento Soporte electrónico y tributos no permitidos. |
| 7. Sandbox — Nómina Electrónica | 3 | Simulación de nómina, CUNE alterado y validación territorial. |
| 8. Sandbox — Auto-Increment | 2 | Pruebas de emisión con series y consecutivos automáticos. |
| 9. Sandbox — POS Electrónico | 5 | Documento Equivalente POS y notas de ajuste (NC/ND). |
| 10. Sandbox — DS No Residente | 2 | Documentos Soporte y notas para proveedores del exterior. |
| 11. Sandbox — Eventos RADIAN | 7 | Envío y consulta de eventos de factura (030, 031, 032, 033). |
⚙️ Variables de Entorno Recomendadas
Configura un Environment en Postman con las siguientes variables para operar de forma dinámica:
| Variable | Tipo | Valor Sugerido | Descripción |
|---|---|---|---|
url | default | URL entregada al contratar | URL base de producción (en el sandbox: https://sandbox-api.matias-api.com/api/ubl2.1). |
sandbox_url | default | https://sandbox-api.matias-api.com/api/ubl2.1 | URL base del Sandbox. |
access_token | secret | eyJ... | Token JWT obtenido en /auth/login. |
pat_token | secret | 1|eyJ... | Personal Access Token (PAT) persistente. |
Scripts Automatizados en Tests
La colección incluye scripts en la pestaña Tests del Login y Creación de PAT que extraen y guardan automáticamente los tokens en tus variables de entorno para que no tengas que copiarlos manualmente.