Introducción al Sandbox
El sandbox permite probar la integración completa del ciclo de vida de una guía sin mensajero real, usando autenticación y datos reales del sistema.
¿Para qué sirve?
Cuando una empresa externa integra su sistema con AVE para consultar el estado de los envíos, necesita poder simular todo el flujo antes de salir a producción:
- Ver cómo luce la respuesta de cada estado posible
- Probar que su polling detecta correctamente los cambios de estado
- Verificar que su sistema dispara el flujo interno cuando un estado cambia
El sandbox resuelve esto sin necesidad de que haya un mensajero físico moviendo el paquete.
Credenciales de prueba
El sandbox está habilitado para dos empresas de prueba dentro de AVE:
| Empresa | ID |
|---|---|
| Sandbox #1 | 6077 |
| Sandbox #2 | 25505 |
Las credenciales (usuario y clave) son las mismas que se usan en Autenticación.
caution
avanzarEstado solo funciona con estas dos empresas. Cualquier otro id recibirá un error 403.
Roles en el flujo
┌──────────────────────────┬────────────────────────────────────────────────┐
│ Empresa externa │ AVE (interno) │
├──────────────────────────┼────────────────────────────────────────────────┤
│ │ │
│ Pedido llega al cliente │ │
│ ↓ │ │
│ Cliente llama AVE con │ Guía creada en el sistema │
│ noGenerarEnvio=1 │ (sin mensajero real) │
│ │ ↓ │
│ │ AVE llama avanzarEstado │
│ │ → estado actualizado en el sistema │
│ │ │
│ Polling cada minuto │ │
│ → obtenerEstadoAuth │ │
│ → detecta el cambio ←────────────────────────────────────────────── │
│ → dispara flujo cliente │ │
└──────────────────────────┴────────────────────────────────────────────────┘
Flujo de estados
Los estados se avanzan en este orden. No hay saltos:
(sin estado) → GENERADA → PRODUCIDA → EN DESPACHO → EN REPARTO → ENTREGADA
↓
EN NOVEDAD (forzado)
| Estado | Descripción |
|---|---|
GENERADA | Guía registrada, sin procesar |
PRODUCIDA | Etiqueta impresa, lista para despacho |
EN DESPACHO | Paquete entregado a la transportadora |
EN REPARTO | Mensajero en camino al destinatario |
ENTREGADA | Entregado exitosamente |
EN NOVEDAD | Inconveniente en la entrega (forzado con parámetro) |
ANULADA | Guía anulada, estado terminal |
Endpoints del sandbox
| Endpoint | Descripción |
|---|---|
obtenerEstadoAuth | Retorna ejemplos de todos los estados posibles. Sin consulta real a guías. |
avanzarEstado | Avanza el estado real de una guía de empresa sandbox. |