# Cancelar recolección

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](https://docs.shipsaving.com/v2/appendix#post-apishipmentpickupcancel).

Endpoint: POST /api/shipment/pickup/cancel
Version: v2
Security: BearerAuth

## Request fields (application/json):

  - `pickup_no` (string, required)
    Número interno del registro de recolección utilizado para identificar una solicitud de recolección de USPS previamente programada. Este valor se devuelve durante el proceso de creación de la recolección y debe proporcionarse para cancelar la orden de recolección correspondiente.
    Example: 10000000000

## Response 200 fields (application/json):

  - `code` (string)
    Example: ok

  - `msg` (string)
    Example: ok

  - `data` (object)
    Example: {}

## Response 400 fields (application/json):

  - `code` (string)
    Código de error en formato separado por puntos.

  - `msg` (string)
    Mensaje de error legible para humanos.

  - `data` (any)
    Example: null