Solicitar la recolección de un envío propio
Solicita que la paquetería pase por el paquete al domicilio del remitente, en lugar de que el remitente lo lleve a sucursal.
Esto es una solicitud, no una reserva. No agendamos con la paquetería de forma automática: el equipo de Enviadores la gestiona y avisa por correo al solicitante cuando queda. Por eso la respuesta siempre regresa status: awaiting_confirmation — nunca reportes al usuario que ya hay mensajero confirmado. Consulta GET /pickups/{id} para el estado final, o espera el correo.
Por qué. Un 200 de una paquetería no es prueba de que el mensajero vaya a llegar, y el peor error posible aquí es decirle a alguien que su recolección está confirmada y dejarlo esperando. Preferimos ser lentos y ciertos.
Disponible sólo para Estafeta, DHL, FedEx y Paquetexpress (422 PICKUP_CARRIER_NOT_ELIGIBLE para el resto; el paquete siempre puede entregarse en sucursal). Una sola recolección abierta por envío.
pickup_date, ready_time y close_time son hora local de México (America/Mexico_City); la respuesta devuelve las ventanas en UTC (Z).
La recolección no cobra saldo; cualquier cargo de la paquetería llega después por la vía de sobrecargos, igual que en el carril web.
La dirección de recolección es la del propio envío — este endpoint no la cambia. Requiere scope pickups:write.
Request
- Base URL: https://api.enviadores.com.mx/api/v1
- URL: https://api.enviadores.com.mx/api/v1/pickups
- Auth: HTTP bearer
Request body
Response
Solicitud registrada — status siempre es awaiting_confirmation. Un 201 significa que recibimos la solicitud, NO que haya mensajero confirmado.
Changes
No recorded changes to this operation across all 1 revision of this API.