API de rastreo de Urbano Express

Cómo se consulta una guía de Urbano Express

Su formato de guía es inconfundible, así que podemos detectarlo solos: puedes omitir el parámetro carrier.

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

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

Crear guías con Urbano Express

Todavía no. Sin adaptador de creación. El rastreo de Urbano Express sí funciona, y son integraciones separadas: que no se pueda crear una guía no dice nada sobre la otra.

Cobertura de Urbano Express: 265 agencias

El catálogo de Urbano Express nombra 265 puntos repartidos en 24 departamentos. Estos son los de mayor concentración:

Qué publica cada punto de Urbano Express

Ubigeo INEI

no lo publica

Coordenadas

en todos los puntos

Horario

en franjas parseadas

Servicios por punto

dropoff, pickup, home_delivery

Tipo de punto

no lo distingue

Catálogo de Urbano Express 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 Urbano Express

Cuándo elegir Urbano Express

• Urbano Express es el único que marca los tres servicios por punto —dropoff, pickup y entrega a domicilio—, así que es con el que mejor se arma un selector de punto de recojo.
• El horario de los 265 puntos de Urbano Express viene en franjas parseadas, no en texto libre: decidir si una agencia está abierta no te obliga a escribir un parser.
• Los 265 puntos de Urbano Express traen coordenadas, así que resolver «el más cercano» no te obliga a geocodificar nada.
• El número de guía de Urbano Express es inconfundible, así que puedes consultarlo sin mandar el parámetro carrier.
• El rastreo de Urbano Express está verificado en vivo: el mapeo sale de respuestas reales capturadas contra su servicio, con acierto y con fallo.

Limitaciones conocidas de Urbano Express

• Urbano Express llega a 24 de los 25 departamentos: no es cobertura nacional completa.
• La red de Urbano Express es de capitales, no capilar: sus 265 puntos cubren 53 provincias, menos de la mitad de las 154 del catálogo más extendido.
• El catálogo de Urbano Express no trae ubigeo INEI: nombra sus 24 departamentos y 53 provincias en texto, pero cruzarlos contra tablas oficiales queda de tu lado.
• Urbano Express no distingue el tipo de punto: oficina propia, agente o hub llegan todos como unknown.
• Todavía no se pueden crear guías de Urbano Express. Sin adaptador de creación.

Preguntas frecuentes sobre Urbano Express

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

No hace falta. El formato de guía de Urbano Express es inconfundible, así que el API lo reconoce solo: puedes llamar a GET /v1/tracking con el número y nada más. Mandarlo igual no molesta.

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

Todavía no. Sin adaptador de creación. El rastreo de Urbano Express sí funciona: son dos integraciones separadas, contra backends distintos del courier.

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

Parcialmente. Urbano Express nombra 24 departamentos y 53 provincias en texto, pero sin ubigeo INEI: cruzarlo contra tablas oficiales queda de tu lado. El 100 % de sus puntos sí trae coordenadas.

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

Sí. El horario de los 265 puntos de Urbano Express viene en franjas parseadas con día y hora, así que resolverlo es una comparación y no un parser.