Obtenha uma matriz de ofertas

  • Artigo

Este artigo explica como obter uma matriz de ofertas para um determinado mês. A matriz de ofertas inclui propriedades e regras de compra para os produtos e skus. Este método suporta filtros para obter histórico por mês.

Pré-requisitos

  • Credenciais conforme descrito na autenticação da API do parceiro. Este cenário suporta apenas a autenticação do usuário do aplicativo. Somente aplicativo ainda não é suportado. Os parceiros que apresentam erro http:400 devem consultar a documentação de autenticação da API do parceiro.
  • Atualmente, essa API suporta apenas o acesso de usuários em que os parceiros devem estar em uma das seguintes funções: Administrador Global, Agente de Administração ou Agente de Vendas.

Detalhes

  • Atual retorna dados apenas para novos produtos baseados em licença de comércio atualizados.
  • O preço atual inclui produtos disponíveis durante o mês atual até a data em que a API é chamada. Os meses anteriores incluem a data a partir do último dia do mês selecionado.
  • Esse método retorna dados como um fluxo de arquivo. O fluxo de arquivos é um arquivo .csv ou uma versão compactada zip do .csv. Detalhes sobre como solicitar arquivos compactados estão incluídos abaixo.

Pedido REST

Sintaxe da solicitação

Método URI do pedido
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value

Parâmetros do filtro URI

Use os seguintes parâmetros de filtro.

Nome Type Obrigatório Description
Month string Não Deve aderir a AAAAMM para a folha de preços que está sendo solicitada.

Cabeçalhos do pedido

Além dos cabeçalhos acima, os arquivos de preços podem ser recuperados como compactados, reduzindo a largura de banda e os tempos de download. Por padrão, os arquivos não são compactados. Para obter versões compactadas dos arquivos, você pode incluir o valor de cabeçalho abaixo. Perceba que as folhas compactadas só estão disponíveis a partir de abril de 2020, todas as folhas anteriores a abril de 2020 só estão disponíveis como não compactadas.

Cabeçalho Tipo de valor valor Description
Accept-Encoding string deflacionar Opcional. Se omitido, o fluxo de arquivos não será compactado.

Exemplo de solicitação

GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='202101')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

Resposta do REST

Se bem-sucedido, esse método retorna uma matriz de oferta como um fluxo de arquivos. O fluxo de arquivos é um arquivo .csv ou uma versão compactada zip do .csv.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte Códigos de erro.

Exemplo de resposta

HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=updatedoffice.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT

"ProductTitle","ProductId","SkuId","SkuTitle","ProvisioningId","ProvisioningString","MinLicenses","MaxLicenses","AssetOwnershipLimit","AssetOwnershipLimitType","ProductSkuPreRequisites","ProductSkuConversion","Description","AllowedCountries" 
"Microsoft 365 Business Basic","CFQ7TTC0LH18","0001","Microsoft 365 Business Basic","3b555118-da6a-4418-894f-7df1e2096870","O365_BUSINESS_ESSENTIALS","1","300","2","ConcurrentCount","","CFQ7TTC0LDPB/0001,CFQ7TTC0LF8Q/0001","Best for businesses that need professional...","AD;AE;AF;AG;AI;AL;AM;AO..."
======= Truncated ==============

Próximos passos