pickups

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.

post/pickups

Request

  • Base URL: https://api.enviadores.com.mx/api/v1
  • URL: https://api.enviadores.com.mx/api/v1/pickups
  • Auth: HTTP bearer

Request body

shipment_idstring required

Id de un envío propio con guía, no entregado ni cancelado.

pickup_datestring required

Fecha local (America/Mexico_City). Hoy o después.

ready_timestring required

HH:MM 24h local — desde cuándo está listo el paquete.

close_timestring required

HH:MM 24h local — hasta cuándo puede pasar el mensajero. Debe ser posterior a ready_time.

notesstring

Indicación para el mensajero.

Response

Solicitud registrada — status siempre es awaiting_confirmation. Un 201 significa que recibimos la solicitud, NO que haya mensajero confirmado.

successunknown required
requestIdstring required

Correlación de logs; también en el header X-Request-Id.

Changes

No recorded changes to this operation across all 1 revision of this API.