Tu paquete EH123456789ES está en reparto hoy en Madrid. Entrega prevista 12:00-14:00. Si no estás, lo dejaremos en oficina Atocha. Consulta: correos.es/t/EH123456789ES
Tracking de envíos Correos en tiempo real, SMS y email automáticos
Correos es el operador postal nacional español con la mayor cobertura rural y la integración estándar para envíos < 2 kg. 4notify consume los eventos del API de Correos (admitido, en tránsito, en entrega, intento fallido, entregado) y los traduce en notificaciones al destinatario sin que tu equipo tenga que tocar la API.
Visión general
Correos es el operador postal nacional español con la mayor cobertura rural y la integración estándar para envíos < 2 kg. 4notify consume los eventos del API de Correos (admitido, en tránsito, en entrega, intento fallido, entregado) y los traduce en notificaciones al destinatario sin que tu equipo tenga que tocar la API.
Caso de uso
Tu sistema crea el envío en Correos. Correos publica los estados del envío en su API. 4notify sondea o recibe el push, y en cada cambio relevante (`ADMITTED`, `OUT_FOR_DELIVERY`, `DELIVERED`, `FAILED_ATTEMPT`) dispara la plantilla correspondiente al móvil/email del destinatario, con tracking number y enlace al portal Correos.
Mensaje de ejemplo
Esto es lo que recibe tu cliente final cuando se dispara el flujo. Texto verificado en producción — puedes copiarlo y adaptarlo.
Webhook payload
Payload entrante del proveedor. 4notify valida la firma original (cuando aplica), normaliza el contenido y dispara el flujo configurado.
json { "event": "correos.shipment.out_for_delivery", "tracking_number": "EH123456789ES", "service": "PaqPremium", "status_code": "OUT_FOR_DELIVERY", "estimated_delivery": "2026-05-21T13:00:00+02:00", "destination": { "city": "Madrid", "postal_code": "28013", "recipient_phone": "+346XXXXXXXX", "recipient_email": "[email protected]" } }
Curl + endpoints
Si prefieres disparar la notificación tú mismo en vez de enrutar el webhook, también puedes llamar directamente a la API.
bash
# Polling o webhook nativo de Correos según contrato:
# 1. Correos API > Mi cuenta > Webhook subscriptions
# 2. Apunta a https://api.4notify.net/webhooks/correos/{merchant_id}
# 3. Activa eventos: shipment.admitted, .in_transit,
# .out_for_delivery, .delivered, .failed_attempt
# Para clientes sin webhook, 4notify hace polling cada 15 min.Pasos de setup
5 pasos, normalmente entre 30 minutos y una tarde. Cada paso se puede deshacer sin afectar al resto.
- 01Obtener credenciales API CorreosSolicita acceso al API de Correos desde tu panel de cliente o a través de tu comercial Correos.
- 02Conectar Correos a 4notifyPegar las credenciales en el panel; 4notify valida el acceso y empieza a recibir/sondear eventos.
- 03Mapear estados a plantillasADMITTED → SMS de confirmación. OUT_FOR_DELIVERY → SMS «Hoy te llega». DELIVERED → email de satisfacción. FAILED_ATTEMPT → SMS con instrucciones (oficina, CityPaq, redelivery).
- 04Activar gestión de CityPaq (opcional)Si activas CityPaq como punto de recogida, el SMS incluye el código de apertura del armario.
- 05Configurar la ventana horariaPor defecto los SMS de tracking se envían 8:00-21:00 hora España. Configurable por tipo de evento.
Conformidad legal
Cada notificación tranzaccional cumple por defecto el marco RGPD/LSSI-CE/AEPD aplicable. Estos son los anclajes específicos de esta integración.