Crea una solicitud de recolección de USPS (Carrier Pickup) utilizando la información de un envío existente. Este endpoint programa al cartero de USPS para recoger paquetes elegibles en el siguiente día hábil de USPS. Para conocer todos los posibles códigos de error que devuelve este endpoint, consulta Apéndice – Códigos de error de recolección.
Fecha de recolección programada en formato YYYY-MM-DD. Si se omite, el valor se establece automáticamente al siguiente día calendario según la zona horaria America/Los_Angeles, independientemente del momento en que se envíe la solicitud.
Esta es la ubicación de los paquetes listos para la recolección en la dirección de recolección.
Información adicional sobre dónde pueden recolectarse los paquetes. Es obligatorio cuando package_location es other. No se admiten caracteres chinos.
Código que identifica al transportista/proveedor de envío para la recolección. Este valor determina qué proveedor logístico debe gestionar la solicitud de recolección o de envío. Actualmente solo se admite USPS. En el futuro podrían incluirse códigos para otros transportistas (por ejemplo, UPS, FedEx).
- object
- object (2)
curl -i -X POST \
https://x-api.shipsaving.com/api/shipment/pickup/add \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"pickup_date": "string",
"pickup_location": {
"first_name": "Alice",
"last_name": "Green",
"company_name": "ShipSaving",
"phone": "1234567890",
"email": "it@shipsaving.com",
"street": "xxxx Olive Street",
"street2": "STE XXX",
"city": "San Francisco",
"state": "CA",
"zip_code": "941XX",
"country": "US",
"address_type": "residential"
},
"package_location": "front_door",
"package_location_ext": "string",
"carrier_code": "USPS",
"tracking_nos": [
"9234690381085700XXXXX"
]
}'{ "code": "ok", "msg": "ok", "data": { "pickup_no": "10000000000", "pickup_date": "2025-11-21", "package_total_num": 1, "package_total_weight": 0.1, "carrier_code": "USPS", "carrier_name": "USPS", "confirmation_number": "WTC65384000" } }