Para desarrolladores
API de lockers inteligentes
La API de LockOn para integrar la red de lockers a tu tienda online o a tu operación logística.
Estado: en desarrollo. Lo que sigue es lo que ya está definido. La referencia completa, con endpoints, esquemas y ejemplos, se comparte junto con las credenciales de acceso.
Qué vas a poder hacer
- Buscar lockers por cercanía. Encontrar los lockers de la red más cercanos al destino del envío.
- Cotizar un envío. Saber el costo antes de reservar.
- Reservar un casillero. La reserva devuelve el código de depósito que viaja con el envío hasta el repartidor.
- Consultar el envío. El estado del depósito en cada momento, con sus fechas.
- Recibir webhooks firmados. Un aviso a tu sistema con cada cambio de estado, con firma verificable.
Autenticación
Cada integración es un cliente de API con sus propias credenciales, que se intercambian por un token con el flujo de credenciales de cliente de OAuth 2.0. Cada cliente tiene sus permisos acotados y un límite de requests.
Una superficie aparte
La API de integraciones está versionada y separada de la que usa el back office y de la que usan los lockers. Un cliente externo solo ve lo que su integración necesita.
El ciclo de un envío
Cada envío es un depósito en un casillero y pasa por estos estados:
Reservado
Hay un casillero asignado y un código de depósito vigente.
Depositado
El repartidor dejó el paquete y la cerradura volvió a trabarse.
Retirado
El destinatario ingresó su código y retiró el paquete.
Cancelado
La reserva se canceló antes del depósito.
Vencido
Terminó el plazo de guarda sin que se retirara el paquete.
Del lado del destinatario el retiro es el mismo que en cualquier locker de LockOn: un código que se ingresa en la pantalla. Más detalle en cómo funciona.
Pedí acceso a la API
Contanos qué querés integrar y cuál es tu volumen. Te sumamos a las primeras pruebas.