Consulta y crea envíos
de Shalom.
Tracking, agencias y ubicaciones de shalom.com.pe, más creación de envíos en pro.shalom.pe con las credenciales de tu cliente. Solicita tu API key y empieza a integrar.
- 0
- endpoints
- 60
- req · por minuto
- JSON
- respuestas
- HTTPS
- encriptado
- 24/7
- disponible
Data de Shalom
desde tu app.
Shalom API Perú te permite consultar tracking, agencias y ubicaciones de shalom.com.pe, y además crear envíos en pro.shalom.pe (Shalom Pro) usando las credenciales de tu cliente final. Tú solo haces requests — nosotros nos encargamos del resto.
Tracking de envíos
Busca por número de orden, código u ose_id. Obtén la orden completa con estados de tracking en una sola llamada.
Catálogo de agencias
Lista, busca y filtra agencias por departamento, provincia, nombre o servicio aéreo.
Ubigeos del Perú
Departamentos, provincias y distritos. Datos siempre actualizados.
Crear envíos (Shalom Pro)
Genera guías reales en pro.shalom.pe con las credenciales de tu cliente final. Lista, borra y consulta el catálogo de productos en una sola integración.
Todas las agencias.
548 agencias en los 25 departamentos, con
la latitud y longitud que devuelve GET /v1/agencies.
Acercate a una ciudad y aparecen una por una — el mismo catálogo que consultás desde tu app,
dibujado sobre el mapa del Perú.
- 548
- agencias
- 25
- departamentos
- 483
- también aéreo
Acercá el mapa a una ciudad y hacé clic en cualquier punto: te decimos qué agencia
queda más cerca — es lo que resuelve
?near=lat,lng en una sola llamada.
Dónde hay más agencias
- 190
- 34
- 32
- 31
- 27
- 25
- 24
- 22
Nada que
vigilar.
El estado del envío y el estado de la API son las dos cosas que normalmente te obligan a estar encima de la integración. Las dos te llegan solas: un POST firmado cuando el envío cambia, y un monitor público que puedes leer desde tu propio código.
Webhooks de tracking
En vez de pollear el estado cada pocos segundos, registras tu URL una vez y te empujamos un POST firmado cada vez que el envío cambia de estado — con el timeline completo adentro. Cero polling, cero cron: el mismo envío que antes te costaba miles de requests ahora son solo los cambios reales.
por el mismo envío
- ▸Firma HMAC-SHA256
- ▸Timeline completo
- ▸Reintentos + idempotencia
- ▸track:true al crear la orden
Estado del servicio
Monitoreamos cada endpoint en tiempo real. Consultá el estado actual, la disponibilidad de 90 días y la latencia de cada servicio cuando quieras — con total transparencia.
- ▸Uptime 90 días
- ▸Latencia por endpoint
- ▸Incidencias en vivo
- —
- uptime 90 d
- —
- latencia
- —
- monitoreados
Datos reales de GET /status — se actualiza solo
3 pasos.
Así de simple.
Qué puedes consultar.
Docs completosTracking
4 endpointsAgencias
3 endpointsUbicaciones
3 endpointsCrear pedido (Shalom Pro)
5 endpointsGenera guías reales en pro.shalom.pe con las credenciales de tu cliente final. Token efímero opcional para no exponer el password en cada request.
/v1/shalom/sessions Token efímero GET /v1/products Catálogo de productos POST /v1/orders Crear guía GET /v1/orders Listar pedidos DELETE /v1/orders/{id} Borrar pedido Webhooks de tracking
5 endpointsRegistra tu URL, suscribe las guías a vigilar y recibe un POST firmado cada vez que un envío cambia de estado. También podés suscribir automáticamente con track:true al crear la orden.
/v1/webhooks Registrar URL GET /v1/webhooks Ver configuración POST /v1/webhooks/rotate Rotar el secreto POST /v1/tracking/subscriptions Suscribir una guía GET /v1/tracking/subscriptions Listar suscripciones 23 endpoints documentados · rate limit 60 requests por minuto · respuestas JSON sobre HTTPS
Listo para
integrar.
Solicita tu API key y empieza a consultar data de Shalom desde tu aplicación.