# Pickup

## Programar recolección

 - [POST /api/shipment/pickup/add](https://docs.shipsaving.com/es/v2/openapi/pickup/addpickupbyshipment.md): 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.

## Cancelar recolección

 - [POST /api/shipment/pickup/cancel](https://docs.shipsaving.com/es/v2/openapi/pickup/cancelpickup.md): Cancela una recolección previamente programada con el transportista. Una vez cancelada, la recolección no puede actualizarse ni cancelarse de nuevo. No requiere parámetros adicionales más allá de pickup_no. Si la operación es exitosa, el estado cambiará a CANCELED.
Para conocer todos los posibles códigos de error que devuelve este endpoint, consulta Apéndice – Códigos de error de recolección.

## Obtener registros de recolección

 - [GET /api/shipment/pickup/list](https://docs.shipsaving.com/es/v2/openapi/pickup/getpickuplist.md): Recupera una lista paginada de los registros de recolección creados en el sistema.
Este endpoint admite filtros opcionales como el número de confirmación de USPS,
el estado de la recolección y el código del transportista. Los parámetros de paginación
(page y page_size) permiten controlar el tamaño del conjunto de resultados devueltos,
y el indicador order_by determina el orden de los resultados.

## Obtener ubicación del paquete

 - [GET /api/shipment/pickup/package/location/list](https://docs.shipsaving.com/es/v2/openapi/pickup/getpackagelocation.md): Devuelve la lista de valores enum válidos para la ubicación del paquete. Estos valores indican dónde se colocarán los paquetes en la dirección de recolección para que el transportista de USPS los recoja durante la recolección programada.