# 预约取件

## 预约取件

 - [POST /api/shipment/pickup/add](https://docs.shipsaving.com/zh-hans/v2/openapi/%E9%A2%84%E7%BA%A6%E5%8F%96%E4%BB%B6/addpickupbyshipment.md): 使用已有的发货信息创建 USPS 承运商取件请求。该接口会安排 USPS 快递员在下一个 USPS 投递日上门取走符合条件的包裹。
该接口可能返回的全部错误码，请参见附录 — 预约取件错误码。

## 取消预约取件

 - [POST /api/shipment/pickup/cancel](https://docs.shipsaving.com/zh-hans/v2/openapi/%E9%A2%84%E7%BA%A6%E5%8F%96%E4%BB%B6/cancelpickup.md): 取消先前已预约的承运商取件。取件一旦被取消，将无法再次更新或取消。该接口除 pickup_no 外不需要提供任何其他参数。取消成功后，取件状态将变更为 CANCELED。
该接口可能返回的全部错误码，请参见附录 — 预约取件错误码。

## 查询历史预约取件记录

 - [GET /api/shipment/pickup/list](https://docs.shipsaving.com/zh-hans/v2/openapi/%E9%A2%84%E7%BA%A6%E5%8F%96%E4%BB%B6/getpickuplist.md): 获取系统中已创建的取件记录分页列表。该接口支持按USPS确认号、取件状态以及承运商代码等条件进行可选筛选。分页参数（page和page_size）用于控制返回数据集的大小，order_by参数用于指定结果的排序方式。

## 查询包裹位置

 - [GET /api/shipment/pickup/package/location/list](https://docs.shipsaving.com/zh-hans/v2/openapi/%E9%A2%84%E7%BA%A6%E5%8F%96%E4%BB%B6/getpackagelocation.md): 返回有效的包裹放置位置枚举值列表。这些枚举值用于指示在预约取件时，包裹将被放置在取件地址的具体位置，供USPS邮政投递员上门取件。