Cancelar uma etiqueta de remessa
Use esse método na API de Hardware da Microsoft para solicitar o cancelamento de uma etiqueta de remessa na Aprovação da Microsoft ou distribuição gradual. Antes de usar esse método, verifique se sua etiqueta de remessa está em Aprovação da Microsoft ou Distribuição Gradual. Para obter mais informações sobre como obter uma etiqueta de remessa, consulte Obter uma nova etiqueta de remessa.
Observação
Você não pode cancelar uma etiqueta de remessa compartilhada. No entanto, você pode revogar o compartilhamento após a conclusão do fluxo de trabalho.
Pré-requisitos
Se você ainda não fez isso, conclua todos os pré-requisitos para as APIs de Hardware da Microsoft antes de usar esse método.
Solicitação
Esse método tem a seguinte sintaxe. As outras seções neste tópico fornecem exemplos de uso e descrições do cabeçalho e do corpo da solicitação.
| Método | URI da solicitação |
|---|---|
| PUT | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/shippingLabels/{shippingLabelId}/cancel |
O productID, submissionID e shippingLabelId no método representam o produto, o envio e o rótulo de envio para cancelamento.
Cabeçalho da solicitação
| parâmetro | Tipo | Descrição |
|---|---|---|
| Autorização | String | Obrigatórios. O token de acesso Microsoft Entra ID no token> de portador<de formulário. |
| Aceitar | Cadeia de caracteres | Opcional. Especifica o tipo de conteúdo. O valor permitido é "application/json" |
Parâmetros da solicitação
Não forneça parâmetros de solicitação para esse método.
Corpo da solicitação
Não forneça o corpo da solicitação para esse método.
Exemplos de solicitação
O exemplo a seguir demonstra como solicitar o cancelamento de uma etiqueta de remessa.
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>
Resposta
A resposta estará vazia com um status HTTP de 204.
Após esta etapa, use o método em Obter uma etiqueta de remessa para obter os detalhes atualizados da etiqueta de remessa. Observe que o cancelamento real do driver nos sistemas de pré-lançamento do driver pode levar mais de um dia para ser concluído.
Códigos do Erro
Para obter mais informações sobre códigos de erro, consulte Códigos de erro.