Compartilhar via

Gerenciar etiquetas de remessa

  • Artigo

Use os métodos a seguir para gerenciar etiquetas de remessa para seus envios de painel de hardware do Windows. Para ver uma introdução às APIs de Painel de Hardware da Microsoft, incluindo os pré-requisitos para usar a API, consulte API de Painel de Hardware.

https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels

Métodos para gerenciar etiquetas de remessa

Descrição Método URI
Criar uma nova etiqueta de remessa POSTAR https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels
Atualizar uma etiqueta de remessa PATCH https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels/{shippingLabelId}
Cancelar uma etiqueta de remessa PUT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels/{shippingLabelId/cancel}

Criar uma nova etiqueta de remessa

  1. Se você ainda não fez isso, conclua todos os pré-requisitos das APIs de Hardware da Microsoft.

  2. Obtenha um token de acesso do Microsoft Entra ID. Você deve passar esse token de acesso para os métodos na API de envio da Microsoft Store. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar. Depois que o token expirar, você poderá obter um novo.

  3. É preciso que você tenha criado um produto e um envio para criar uma etiqueta de remessa. Consulte Gerenciar envios de produtos para ver detalhes sobre como criar um produto e um envio.

  4. Crie uma nova etiqueta de remessa para esse envio executando o método a seguir. Use o ProductID e o SubmissionID criados em Gerenciar envios de produtos durante a etapa anterior.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels

    O corpo da resposta contém um recurso de etiqueta de remessa que inclui a ID da etiqueta de remessa recém-criada e outros detalhes.

Exemplos de código

O exemplo de código a seguir demonstra como usar a API de Hardware da Microsoft:

Recursos de dados

Os métodos de APIs de Hardware da Microsoft para criar e gerenciar dados de produtos usam o seguinte recurso de dados JSON:

Códigos do Erro

Para obter informações sobre os códigos de erro, consulte Códigos de erro.

Confira também