Compartilhar via

Obter uma tabela de preços

  • Artigo

Este artigo explica como obter uma tabela de preços para um determinado mercado e visualização. 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 Global, Agente Administrativo ou Agente de Vendas.

Detalhes

  • Current retorna dados somente para consumo e reservas do plano do Azure, baseado em licenciado (nova experiência de comércio) e produtos do Marketplace.
  • O preço atual inclui todos os medidores e produtos disponíveis durante o mês atual até a data em que a API é chamada. Os meses anteriores incluem todos os medidores e produtos disponíveis para o mês determinado.
  • Os preços dos medidores de consumo são apenas em dólares americanos, os parceiros devem usar a API de taxas de câmbio para calcular os custos em moeda local.
  • Os preços dos medidores de consumo são preços estimados de varejo. Os descontos para parceiros estão disponíveis por meio do crédito ganho pelo parceiro.
  • Os preços do medidor de reservas incluem os descontos do parceiro CSP. Os preços de varejo estimados para reservas podem ser encontrados nos serviços compartilhados de reservas que podem ser baixados na página "Preços e ofertas" do Partner Center.
  • Mais informações sobre os preços do plano do Azure podem ser encontradas na documentação de preços do plano do Azure.
  • As APIs de preços e taxas de câmbio do parceiro não fazem parte do SDK do Partner Center.
  • Esse método retorna a lista de preços 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/pricesheets(Market='{market}',PricesheetView='{view}')/$value

Parâmetros necessários de URI

Use os parâmetros de caminho a seguir para solicitar o mercado e o tipo de tabela de preços desejado.

Nome Digitar Obrigatória Descrição
Mercado string Sim Código de país/região de duas letras para o mercado que está sendo solicitado
Folha de preçosExibir string Sim O tipo de tabela de preços que está sendo solicitada, que pode ser azure_consumption, azure_reservations, updatedlicensebased, marketplace ou software.

Observação

updatedlicensebased PriceSheetView está atualmente disponível apenas para parceiros que fazem parte da visualização técnica da nova experiência de comércio do Microsoft 365/Microsoft Dynamics 365.

Observação

A lista de preços do software estará disponível via API a partir de 1º de abril de 2022.

Parâmetros de filtro de URI

Use os seguintes parâmetros de filtro.

Nome Digitar Obrigatória Descrição
Linha do tempo string Não O padrão é atual se não for passado. Os valores possíveis são histórico, atual e futuro.
Mês string Não Necessário apenas se o histórico for solicitado, deve aderir a AAAAMM para a tabela de preços que está sendo solicitada.

Observação

Não há suporte para preços futuros no Marketplace. A partir de 1º de abril de 2022, os parceiros poderão visualizar o histórico da lista de preços de software por meio da API, começando com o histórico de março de 2022.

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 do cabeçalho abaixo. 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 o fluxo de arquivos omitido não for compactado.

Exemplo de solicitação

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='ad',PricesheetView='azure_consumption')/$value?timeline=history&month=201909 HTTP/1.1
Authorization: Bearer
Host: api.partner.microsoft.com

Exemplo de solicitação para novo comércio

Observação

updatedlicensebased PriceSheetView está atualmente disponível apenas para parceiros que fazem parte da visualização técnica da nova experiência de comércio do Microsoft 365/Microsoft Dynamics 365.

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=history&month=202101 HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

Resposta REST

Se for bem-sucedido, esse método retornará a lista de preços como um fluxo de arquivos. O fluxo de arquivos é um arquivo .csv ou uma versão compactada zip do .csv.

Exemplo de resposta para novo comércio

Observação

updatedlicensebased PriceSheetView está atualmente disponível apenas para parceiros que fazem parte da visualização técnica da nova experiência de comércio do Microsoft 365/Microsoft Dynamics 365.

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

"ProductTitle","ProductId","SkuId","SkuTitle","Publisher","SkuDescription","UnitOfMeasure","TermDuration","BillingPlan","Market","Currency","UnitPrice","PricingTierRangeMin","PricingTierRangeMax","EffectiveStartDate","EffectiveEndDate","Tags","ERP Price"
"Advanced Communications","CFQ7TTC0HDK0","0001","Advanced Communications","Microsoft Corporation","Advanced meetings, calling, workflow integration, and management tools for IT.","","P1Y","Annual","US","USD","115.2","","","2/1/2019 12:00:00 AM","2/4/2021 8:35:31 PM","License","144"
======= Truncated ==============

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 outras informações de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e outros parâmetros. Para obter a lista completa, confira Códigos de Erro.

Se não houver alterações esperadas para a nova lista de preços futura baseada em licença de comércio, não haverá nenhuma lista de preços futura retornada. Ao passar o futuro para a linha do tempo solicitada para o PriceSheetView baseado em licença atualizada, os parceiros verão o seguinte código de resposta da API: 404 Não encontrado.

Conteúdo relacionado