API de rastreo de Shalom

Cómo se consulta una guía de Shalom

No hay forma de reconocerlo por el número de guía. El parámetro carrier es obligatorio.

curl -H "X-API-Key: $API_KEY" \
    "https://api.tracking-peru.com/v1/tracking?carrier=shalom&number=TU-NUMERO-DE-GUIA&code=TU-CODIGO-DE-ORDEN"

Shalom pide un segundo factor: además del número de guía, el code (código de orden) que figura en el comprobante del envío. Es credencial —prueba que el envío es tuyo—, y sin él el rastreo responde 422.

El formato exacto de guía de Shalom lo publica GET /v1/carriers en id_format y requires_code, junto con un ejemplo real. No lo escribimos acá para que no envejezca en dos lugares.

Crear guías con Shalom

Además de rastrear, el API genera guías de Shalom con POST /v1/shipments. Envía Ya, con la cuenta Shalom Pro del cliente. Sólo agencia a agencia; falta la primera guía real desde el binario.

Evidencia de la creación: code_derived — Extraído de una integración que corre en producción, sin captura de tráfico. Es un nivel INDEPENDIENTE del de rastreo: son dos integraciones distintas, contra backends distintos de Shalom.

Cobertura de Shalom: 554 agencias

El catálogo de Shalom nombra 554 puntos repartidos en 25 departamentos, o sea el país entero. Estos son los de mayor concentración:

Qué publica cada punto de Shalom

Ubigeo INEI

no lo publica

Coordenadas

en el 96 % de los puntos

Horario

en texto libre, sin parsear

Servicios por punto

air, home_delivery

Tipo de punto

no lo distingue

Catálogo de Shalom sincronizado el 2026-09-18. Estas cifras se miden contra GET /v1/agencies en cada despliegue, así que no envejecen acá sin envejecer también en el API.

Evidencia y webhooks de Shalom

Cuándo elegir Shalom

• Es el catálogo más grande de los cinco: Shalom publica 554 puntos, 127 más que el siguiente.
• Shalom nombra puntos en los 25 departamentos del país, Callao incluido, y baja hasta 116 provincias.
• Shalom es el único que marca qué puntos aceptan envío aéreo, que en Perú es la diferencia entre horas y días hacia selva y sierra.
• El rastreo de Shalom está verificado en vivo: el mapeo sale de respuestas reales capturadas contra su servicio, con acierto y con fallo.

Limitaciones conocidas de Shalom

• El catálogo de Shalom no trae ubigeo INEI: nombra sus 25 departamentos y 116 provincias en texto, pero cruzarlos contra tablas oficiales queda de tu lado.
• El horario de Shalom viene en texto libre —así lo publica: «LUNES A VIERNES - 8:00 AM A 8:00 PM»—, no en franjas parseadas: interpretarlo queda de tu lado.
• Shalom no distingue el tipo de punto: oficina propia, agente o hub llegan todos como unknown.
• No hay forma de reconocer un número de guía de Shalom por su formato: el parámetro carrier es obligatorio.
• Rastrear un envío de Shalom exige el código de orden además del número de guía, y ese código lo tiene el comprador, no tu sistema: hay que preverlo en tu propia interfaz.
• Las guías de Shalom que crea el API son sólo de agencia a agencia: no cubren entrega a domicilio.

Preguntas frecuentes sobre Shalom

¿Hay que mandar el parámetro carrier para rastrear un envío de Shalom?

Sí, es obligatorio. No hay forma de reconocer un número de guía de Shalom por su formato, así que sin carrier=shalom el API no sabe a quién preguntarle.

¿Se pueden crear guías de Shalom desde el API?

Sí, pero con la cuenta del cliente en Shalom, no con tu API key: el usuario final tiene que conectarla antes. Envía Ya, con la cuenta Shalom Pro del cliente. Sólo agencia a agencia; falta la primera guía real desde el binario.

¿Qué se necesita además del número de guía para rastrear en Shalom?

El código de orden que figura en el comprobante del envío. Shalom es el único de los cinco que exige ese segundo factor, y sin él el rastreo responde 422. Ese código lo tiene el comprador y no tu sistema, así que hay que preverlo en tu propia interfaz.

¿El catálogo de agencias de Shalom sirve para filtrar por ubicación?

Parcialmente. Shalom nombra 25 departamentos y 116 provincias en texto, pero sin ubigeo INEI: cruzarlo contra tablas oficiales queda de tu lado. El 96 % de sus puntos sí trae coordenadas.

¿Se puede saber si una agencia de Shalom está abierta?

No directamente. El horario de Shalom llega en texto libre —así lo publica: «LUNES A VIERNES - 8:00 AM A 8:00 PM»—, así que interpretarlo queda de tu lado.