Programar una recogida
Programa una recogida del transportista USPS en una dirección especificada
Programa una recogida del transportista para que USPS recoja paquetes en tu dirección. Actualmente solo se admite USPS.
Se requiere verificación de etiqueta
Debes tener al menos una etiqueta USPS activa (estado: generated o printed) cuya dirección de origen coincida con el código postal (ZIP) de la recogida. Las solicitudes sin etiquetas coincidentes devolverán un error NO_ACTIVE_LABELS.
Parámetros
Cuerpo de la solicitud
carrier
string (USPS)
Código del transportista. Actualmente solo se admite USPS. El valor predeterminado es USPS.
pickup_date
string
Obligatorio
Fecha de recogida en formato YYYY-MM-DD. Debe ser hoy o una fecha futura.
pickup_address
object
Obligatorio
Ubicación de recogida con name, street1, city, state, zip y phone.
package_count
integer
Número de paquetes a recoger. El valor predeterminado es el número de etiquetas activas coincidentes.
total_weight
number
Peso total de todos los paquetes en oz.
packages
array
Desglose por tipo de servicio. Cada elemento: { service_type, count, weight }.
pickup_time_window
object
Franja horaria preferida: { start_time, end_time } en formato HH:MM. El valor predeterminado es 08:00-18:00.
special_instructions
string
Instrucciones para el conductor del transportista (p. ej., "Paquetes en la recepción").
Devuelve
201
Recogida programada correctamente
400
Solicitud no válida o sin etiquetas USPS activas en la dirección de recogida
401
Se requiere autenticación
422
La validación de la recogida falló
Relacionado
pickup
usps
schedule
POST/api/v1/pickups