Compartilhar via

Obter 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. Esse método oferece suporte a filtros para obter o histórico por mês.

Pré-requisitos

  • Credenciais conforme descrito em Autenticação de API do Partner. Esse cenário oferece suporte apenas à autenticação do usuário do aplicativo. Ainda não há suporte para somente aplicativos. Os parceiros que apresentarem erro http:400 devem consultar a documentação de autenticação da API do parceiro.
  • Atualmente, essa API oferece suporte apenas ao acesso de usuários em que os parceiros devem estar em uma das seguintes funções: Administrador Global, Agente Administrativo ou Agente de Vendas.

Detalhes

  • Current 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 arquivos. 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.

Solicitação REST

Sintaxe da solicitação

Método URI da solicitação
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value

Parâmetros do filtro de URI

Use os seguintes parâmetros de filtro.

Nome Digitar Obrigatória Descrição
Mês string Não Deve aderir a YYYYMM para a folha de preços que está sendo solicitada.

Cabeçalhos da solicitação

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 Descrição
Codificação aceita string deflate Opcional. Se o fluxo de arquivos omitido não for 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 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 êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira 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óximas etapas