Sandbox y simulador

Construye y prueba tu integración sin conductores, destinatarios ni dinero.

Envíos de sandbox

Un token de prueba (atk_test_…) solo ve y solo crea envíos de sandbox, aunque la empresa ya opere en real. Lo impone la base de datos, no solo la API.
Una empresa todavía en revisión crea envíos de sandbox con cualquier token.
Los envíos de sandbox son gratis, no se ofrecen a conductores y no envían nada a los destinatarios. Todo lo demás es real: validaciones, precios, números de seguimiento, etiquetas, eventos y webhooks.
Los mensajes de webhook de envíos de sandbox llevan "livemode": false y solo van a endpoints de prueba.
Un token de prueba lee la libreta de direcciones compartida pero solo cambia o archiva las ubicaciones que él creó, y nunca ve etiquetas ni endpoints reales.

Un envío de sandbox avanza un paso a la vez por la misma máquina de estados que usan las entregas reales:

POST /v1/sandbox/shipments/{id}/advance
Authorization: Bearer atk_test_…
Idempotency-Key: 3f1c…
Content-Type: application/json

{ "to": "picked_up" }

La respuesta es el envío. Cada paso envía los mismos eventos y webhooks que uno real.

Desde	`to`
`ready`	`pickup_assigned`, `at_hub` (entrega del cliente en el hub, niveles con hub)
`pickup_assigned`	`picked_up`
`picked_up`	`out_for_delivery` (niveles directos), `at_hub` (niveles con hub)
`at_hub`	`out_for_delivery`, `return_in_transit` (sin intentos restantes)
`out_for_delivery`	`delivered`, `attempt_failed`
`attempt_failed`	`out_for_delivery` (con intentos restantes), `at_hub`, `return_in_transit` (sin intentos)
`return_in_transit`	`returned`
cualquier estado abierto	`exception`
`exception`	`closed_exception`

Confirma primero (POST /v1/shipments/{id}/confirm): los borradores no se simulan; confirmar le pone precio y número de seguimiento.
Un paso que las reglas no permiten responde 409 con el código de la máquina de estados (por ejemplo shipment.hub_required o shipment.attempts_remaining).
Los tokens reales reciben 403 sandbox.live_token; los envíos reales 409 sandbox.live_shipment.
Solo se mueve el envío (su estado, intentos e historial); las tareas de conductor no cambian.