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. Este método suporta filtros para obter o histórico por mês.

Pré-requisitos

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

Detalhes

  • Current retorna dados apenas para produtos atualizados baseados em licença de novo comércio.
  • Os preços atuais incluem produtos disponíveis durante o mês atual até a data em que a API é chamada. Os meses anteriores incluem a data 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 a seguir.

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 de filtro de URI

Use os seguintes parâmetros de filtro.

Nome Digitar Obrigatória Descrição
Mês string Não Deve aderir a AAAAMM para a tabela de preços solicitada.

Cabeçalhos da solicitação

Além desses cabeçalhos, 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 seguinte valor de cabeçalho. Perceba que as planilhas compactadas só estão disponíveis a partir de abril de 2020, todas as planilhas anteriores a abril de 2020 estão disponíveis apenas como não compactadas.

Cabeçalho Tipo de valor Valor Descrição
Codificação aceita string deflate 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 REST

Se for bem-sucedido, esse método retornará 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 ==============

Conteúdo relacionado