API de rastreo de Olva Courier

Cómo se consulta una guía de Olva Courier

Su formato se parece al de otros couriers. Conviene mandar el carrier explícito para evitar una detección equivocada.

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

El formato exacto de guía de Olva Courier 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 Olva Courier

Además de rastrear, el API genera guías de Olva Courier con POST /v1/shipments. Cuatro guías reales creadas. Se paga en destino o en tienda; hasta 10 bultos, una guía por bulto.

Evidencia de la creación: live — Respuestas reales capturadas contra el upstream, con hit y miss. Es un nivel INDEPENDIENTE del de rastreo: son dos integraciones distintas, contra backends distintos de Olva Courier.

Cobertura de Olva Courier: 427 agencias

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

Qué publica cada punto de Olva Courier

Ubigeo INEI

en todos los puntos, a nivel distrito

Coordenadas

en el 97 % de los puntos

Horario

en franjas parseadas en el 97 %

Servicios por punto

no los publica

Tipo de punto

agent (269), office (158)

Catálogo de Olva Courier 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 Olva Courier

Cuándo elegir Olva Courier

• Olva Courier es el único de los cinco que trae ubigeo INEI de distrito en todos sus puntos. Si vas a cruzar direcciones contra tablas oficiales, o a calcular cobertura por distrito, es el único que te lo da resuelto.
• Olva Courier nombra puntos en los 25 departamentos del país, Callao incluido, y baja hasta 154 provincias.
• Es la red más capilar de las cinco: los puntos de Olva Courier se reparten en 154 provincias, no se concentran en las capitales.
• El 97 % de los puntos de Olva Courier trae el horario en franjas parseadas, no en texto libre.
• Olva Courier distingue el tipo de punto: 269 de sus 427 son agentes de terceros y 158 son oficinas propias. No es lo mismo lo que puedes esperar de unos y de otros.

Limitaciones conocidas de Olva Courier

• Olva Courier no publica qué hace cada punto, así que no puedes filtrar por recojo ni por entrega a domicilio.
• El rastreo de Olva Courier está verificado sólo contra el contrato: nunca obtuvimos de él una respuesta con datos reales. Es el único de los cinco en esa situación, y lo decimos acá antes de que lo descubras integrando.
• El formato de guía de Olva Courier se parece al de otros couriers. Conviene mandar el carrier explícito para no arriesgar una detección equivocada.

Preguntas frecuentes sobre Olva Courier

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

Conviene mandarlo. El formato de guía de Olva Courier se parece al de otros couriers peruanos, así que una detección equivocada es posible: con carrier=olva explícito no hay ambigüedad.

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

Sí, con POST /v1/shipments y tu propia API key: Olva Courier no le pide credenciales a tu usuario final. Cuatro guías reales creadas. Se paga en destino o en tienda; hasta 10 bultos, una guía por bulto.

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

Sí, y es el único de los cinco que lo resuelve del todo: los 427 puntos de Olva Courier traen ubigeo INEI a nivel distrito, así que puedes cruzarlos contra tablas oficiales sin normalizar nada.

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

En el 97 % de sus puntos sí: ahí el horario viene en franjas parseadas. En el resto llega como texto y hay que interpretarlo.