API de Shalom para ecommerce y sistemas de ventas.
Integra Shalom con tu tienda, ERP o flujo de n8n: crea guías en Shalom Pro, cotiza tarifas, consulta agencias y rastrea pedidos por API. Ideal para el ecommerce peruano y la venta con pago contra entrega (COD): cada entrega, rechazo o cambio de estado llega por webhook, sin polling. REST + JSON sobre HTTPS con tu API key.
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 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 sus estados de tracking en una sola llamada.
POST /trackCatálogo de agencias
Lista, busca y filtra agencias por departamento, provincia, nombre o servicio aéreo. Con latitud y longitud listas para dibujar en un mapa.
GET /agenciesUbigeos del Perú
Departamentos, provincias y distritos con sus códigos. Datos siempre actualizados para tus formularios.
GET /locations/departmentsCrear envíos con tu cliente
Genera guías reales en pro.shalom.pe con las credenciales de tu cliente final. Registro individual o masivo, cotización y validación de DNI.
POST /account/registerTodas las agencias.
Las agencias de Shalom con la latitud y longitud que devuelve GET /public/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ú.
Acercá el mapa a una ciudad y cualquier agencia te queda a un toque. Para ordenar por cercanía desde código usá ?near=lat,lng en una sola llamada.
Dónde hay más agencias
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 health en vivo que podés leer desde tu propio código.
Webhooks de tracking
En vez de pollear el estado cada pocos segundos, registrás tu URL una vez y te empujamos un POST firmado cada vez que el envío cambia de estado. Cero polling, cero cron: el mismo envío que antes te costaba miles de requests ahora son solo los cambios reales.
- ▸Firma HMAC-SHA256
- ▸Timeline completo en el payload
- ▸Reintentos + idempotencia
- ▸Suscribí guías una por una
Estado del servicio
Monitoreamos la disponibilidad del backend en tiempo real. Consultá el estado actual, la latencia y el uptime del servicio cuando quieras — con total transparencia.
- ▸Ping de salud del servicio
- ▸Latencia medida por request
- ▸Uptime del proceso en vivo
3 pasos. Así de simple.
Solicita tu API key
Escríbenos por WhatsApp para obtener tu key. Te la entregamos listo para usar.
WhatsAppAgrega el header a tus requests
Tu key viaja en el header de cada petición. Nada más que recordar.
X-API-Key: tu-api-keyConsulta lo que necesites
Tracking, agencias, ubigeos, cotizaciones y envíos. Todo con los mismos headers.
curl -X POST "https://api.shalom-api.lat/track" \
-H "x-api-key: tu-api-key" \
-H "Content-Type: application/json" \
-d '{"orderNumber":"01234567","orderCode":"1234"}'API o proceso manual: la diferencia es el tiempo.
Lo mismo que haces a mano en Shalom Pro, hecho por máquina en una fracción del esfuerzo.
| Tarea | Con Shalom API | A mano en Shalom Pro |
|---|---|---|
| Crear una guía en Shalom Pro | 1 llamada POST con JSON, sin navegador | Login + formulario completo |
| Envíos masivos | Hasta un lote por petición con auto-completado de agencias y tarifas | Uno por uno, copiando dirección por dirección |
| Cotizar una tarifa | GET/POST con origen y destino, respuesta en JSON | Seleccionar agencias en la web hasta ver el precio |
| Rastrear pedidos | Consultas por API o lote de hasta 50 guías | Pegar número y código de cada guía en el formulario |
| Enterarte de un cambio de estado | Webhook firmado (HMAC) con reintentos automáticos | No disponible en la web |
| Enterarte de una entrega o rechazo (pago contra entrega) | Webhook automático con el estado exacto: en reparto, entregado o rechazado | Llamar a la agencia y preguntar pedido por pedido |
| Automatizar con n8n, Zapier o IA | Endpoints REST + nodo oficial de n8n | No disponible en la web |
Tu tienda vende, Shalom entrega, la API conecta.
Guías de integración de Shalom con WooCommerce, Shopify, n8n, Zapier, Make y agentes de IA. Pensada para el ecommerce peruano, incluida la venta con pago contra entrega (COD).
n8n
Nodo oficial n8n-nodes-shalom: tracking, agencias, cotizaciones y creación de envíos dentro de tus flujos de automatización.
Ver integración →WooCommerce
API de Shalom para WooCommerce: genera la guía al confirmar el pedido, ideal para COD, y muestra el rastreo al cliente sin salir de WordPress.
Ver integración →Shopify
API de Shalom para Shopify: cotiza envíos, crea guías con el número de orden y notifica al comprador por webhook, incluidos pedidos contra entrega.
Ver integración →Zapier y Make
Conecta Shalom con miles de apps vía webhooks firmados y HTTP. Un POST por cada cambio de estado del envío.
Ver integración →Agentes de IA
Documentación en HTML y llms.txt lista para Claude, ChatGPT o agentes propios que cotizan y rastrean por conversación.
Ver integración →Tu propio código
cURL, JavaScript, PHP o Python: endpoints REST con respuestas JSON y autenticación por x-api-key.
Ver integración →Qué puedes consultar.
Todos tus endpoints reales: tracking, agencias, ubigeos, cuentas, instancias y webhooks. Docs completos →
Tracking
4 endpointsAgencias
4 endpointsUbicaciones
3 endpointsCuentas e Instancias
13 endpointsCrea envíos reales en pro.shalom.pe con las credenciales de tu cliente final: registros individuales o masivos, cotización, valida DNI y maneja sesiones persistentes por instancia.
- POST/account/registerCrear envío individual
- POST/account/register-bulkCrear envíos masivos
- POST/account/pending-shipmentsEnvíos pendientes
- POST/account/get-userInformación del usuario
- POST/account/quoteCotizar envío
- GET/account/dni/{dni}Consultar DNI
- GET/validateValidar API key
- POST/instancesCrear instancia
- GET/instancesListar instancias
- DELETE/instancesEliminar instancia
- POST/instances/statusEstado de sesión
- POST/instances/loginIniciar sesión
- POST/instances/logoutCerrar sesión
Webhooks de tracking
6 endpointsRegistra tu URL, suscribe las guías a vigilar y recibe un POST firmado cada vez que un envío cambia de estado. Sin polling.
Shalom API Perú, claro y simple.
Integración de Shalom con n8n, Zapier, agentes de IA o tu propio código: respuestas a las dudas más comunes.
¿Qué es Shalom API Perú?+
Shalom API Perú es una API REST para consultar el tracking de envíos de Shalom (shalom.com.pe), listar y buscar agencias, obtener los ubigeos del Perú y crear envíos reales en pro.shalom.pe con las credenciales de tu cliente. Todo en JSON sobre HTTPS.
¿Cómo obtengo una API key de Shalom?+
Escríbenos por WhatsApp para solicitar tu API key. La recibes de inmediato y la envías en el header x-api-key de cada petición. Es el único paso de configuración que necesitas.
¿Cómo integrar Shalom API con n8n?+
Con los nodos de HTTP Request de n8n apuntas a los endpoints de Shalom API: POST /track para el estado de un envío, GET /agencies para listar agencias o POST /account/quote para cotizar. Agregas el header x-api-key, parseas el JSON y automatizas el flujo. También puedes dejar de pollear usando webhooks (PUT /webhooks + POST /tracking/subscriptions).
¿Qué endpoints ofrece Shalom API?+
Tracking (GET y POST /track con estados, lote, voucher y etiqueta), Agencias (/agencies, /agencies/search y la demo pública /public/agencies), Ubicaciones (/locations/departments y sus provincias y distritos), Cuentas e Instancias (crear envíos individuales o masivos, cotizar, validar DNI y manejar sesiones) y Webhooks de tracking. Son 30 endpoints documentados con rate limit de 1000 requests por minuto.
¿Puedo crear envíos en Shalom Pro con la API?+
Sí. Con las credenciales de tu cliente final puedes generar guías reales en pro.shalom.pe, registrar envíos individuales o masivos, consultar pendientes, cotizar y validar DNI, con sesiones persistentes por instancia.
¿Sirve para venta con pago contra entrega (COD)?+
Sí, es uno de los usos más comunes en el ecommerce peruano. Creas la guía por API cuando el pedido se paga, y con los webhooks de tracking te enteras al instante de cada estado del pedido: en reparto, entregado o rechazado. Así concilias tus pedidos COD sin llamar a ninguna agencia.
¿Dónde encuentro las agencias y sedes de Shalom en el Perú?+
El directorio /agencias reúne todas las sedes devueltas por el catálogo público de Shalom, organizadas por departamento y provincia. Cada agencia tiene dirección, referencia, horario, teléfono y mapa.
¿"Shalom API" es lo mismo que "api de shalom" o "shalon api"?+
Sí. "Shalom API", "api de shalom", "api shalom", "shalom api peru" y el error frecuente "shalon api" se refieren a esta plataforma de integración para tracking, agencias, ubicaciones y envíos de Shalom.
Listo para integrar.
Solicita tu API key y empieza a consultar tracking, agencias y ubigeos, o a crear envíos reales desde tu aplicación.