Cancelar una etiqueta de envío
Use este método en la API de hardware de Microsoft para solicitar la cancelación de una etiqueta de envío en aprobación de Microsoft o lanzamiento gradual. Antes de usar este método, asegúrese de que la etiqueta de envío está en aprobación de Microsoft o lanzamiento gradual. Para obtener más información sobre cómo obtener una etiqueta de envío, consulta Obtener una nueva etiqueta de envío.
Nota:
No se puede cancelar una etiqueta de envío compartida. Sin embargo, puede revocar el uso compartido una vez completado el flujo de trabajo.
Requisitos previos
Si aún no lo ha hecho, complete todos los requisitos previos para las API de hardware de Microsoft antes de usar este método.
Solicitud
Este método tiene la siguiente sintaxis. En las demás secciones de este tema se proporcionan ejemplos de uso y descripciones del encabezado y el cuerpo de la solicitud.
| Método | URI de la solicitud |
|---|---|
| PUT | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/shippingLabels/{shippingLabelId}/cancel |
El productID, submissionID y shippingLabelId en el método representan el producto, el envío y la etiqueta de envío para la cancelación.
Encabezado de solicitud
| Encabezado | Tipo | Descripción |
|---|---|---|
| Authorization | String | Necesario. Token de acceso de identificador de Microsoft Entra en el formulario Token de portador<>. |
| Aceptar | String | Opcional. Especifica el tipo de contenido. El valor permitido es "application/json" |
Parámetros de solicitud
No proporcione parámetros de solicitud para este método.
Cuerpo de la solicitud
No proporcione el cuerpo de la solicitud para este método.
Ejemplos de solicitud
En el ejemplo siguiente se muestra cómo solicitar la cancelación de una etiqueta de envío.
PUT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964156/submissions/1152921504621467600/shippingLabels/1152921504606980300/cancel HTTP/1.1
Authorization: Bearer <your access token>
Response
La respuesta estará vacía con un estado HTTP de 204.
Después de este paso, use el método en Obtener una etiqueta de envío para obtener los detalles actualizados de la etiqueta de envío. Tenga en cuenta que la cancelación real del conductor en los sistemas de vuelo del conductor puede tardar más de un día en completarse.
Códigos de error
Para obtener más información sobre los códigos de error, consulta Códigos de error.