Skip to main content
Antes de despachar paquetes reales puedes probar tu integración de punta a punta: cotizar, crear la entrega, recibir los webhooks de cada cambio de estado y la ubicación del repartidor, y manejar los casos de falla. Para eso, al crear el envío agregas el campo simulation: la entrega se crea igual que una real, pero en vez de ofrecerse a repartidores de verdad la atiende una flota simulada.
Un envío de prueba nunca se cobra, no exige saldo prepago y nunca se ofrece a un repartidor real. Las cotizaciones tampoco se cobran: puedes cotizar todo lo que necesites, con o sin simulación.

​
Qué necesitas

  • Una cuenta de pruebas. El modo simulación solo está disponible para cuentas que todavía no están activas en Justo. Si tu cuenta ya opera, pide a tu contacto en Justo una cuenta de pruebas: una cuenta inactiva con sus propios locales. Con una cuenta activa, simulation responde simulationNotAllowed.
  • Un token de esa cuenta con el permiso admin, igual que en producción (ver Autenticación).
  • Un local de retiro en la cuenta de pruebas. Lo creas con Crear un local de retiro.
  • El simulador encendido en la zona del local. Justo lo habilita por zona; si no está encendido, la entrega se queda buscando repartidor.

​
Cómo se pide

Cotiza como siempre y, al crear el envío, agrega simulation:
La respuesta es la de un envío real: la cotización aceptada en quote y la entrega en delivery, con isDev: true y el objeto simulation que pediste. Sin simulation el envío es real, también en una cuenta de pruebas. Si algún valor no es válido (un scenario que no existe, timings sin mode: "custom" o un tiempo fuera de rango), la creación responde invalidSimulation con el campo a corregir.

​
Qué pasa después

El repartidor simulado acepta, aparece cerca del local y avanza en línea recta reportando su GPS cada 30 segundos, retira, viaja hasta el cliente y entrega. Recibes los mismos webhooks deliveries.delivery.updated que con un envío real, con isDev: true para que los distingas. Los webhooks llegan en cada cambio de estado; la ubicación del repartidor entre un estado y otro la consultas con Obtener una entrega. También puedes consultar el estado con Obtener una entrega y cancelar con Cancelar una entrega. El repartidor simulado sale apenas creas la entrega, sin esperar la hora de retiro cotizada: así la prueba dura minutos, no horas. Con mode: "auto" un envío completo toma unos 4 a 6 minutos. Los escenarios de falla, los tiempos de cada paso y los límites de envíos simultáneos son los mismos de los despachos de prueba.

​
Recorrido sugerido

  1. Crea un local de retiro en tu cuenta de pruebas.
  2. Cotiza un envío y crea la entrega con simulation: {"mode": "auto"}. Revisa que lleguen los webhooks active, delivering y done. Mientras viaja, consulta su ubicación con Obtener una entrega.
  3. Repite con scenario: "driverCancels", "notDelivered" y "returnToStore", y revisa que tu sistema maneje cada caso.
  4. Cancela un envío de prueba antes de que lo acepte un repartidor, con Cancelar una entrega. Una vez aceptado ya no se puede cancelar.
  5. Cuando todo funcione, usa el token de tu cuenta real y quita simulation.