Obter uma folha de preços
Este artigo explica como obter uma folha de preços para um determinado mercado e vista. Este método suporta filtros para obter o histórico por mês.
Pré-requisitos
- Credenciais conforme descrito em Autenticação da API de Parceiros. Este cenário só suporta a autenticação do utilizador da aplicação. A aplicação apenas ainda não é suportada. Os parceiros com o erro http:400 devem consultar a documentação de autenticação da API de Parceiros .
- Atualmente, esta API suporta apenas o acesso de utilizadores em que os parceiros têm de estar numa das seguintes funções: Administração Global, Agente Administração ou Agente de Vendas.
Detalhes
- Atual devolve dados apenas para consumo e reservas de planos do Azure, Baseado em licenciamento (nova experiência comercial) e produtos do Marketplace.
- Os preços atuais incluem todos os medidores e produtos disponíveis durante o mês atual até à data em que a API é chamada. Os meses anteriores incluem todos os medidores e produtos disponíveis para o mês especificado.
- Os preços do medidor de consumo estão apenas em USD, os parceiros têm de utilizar a API de taxas de câmbio para calcular os custos da moeda local.
- Os preços dos medidores de consumo são estimados nos preços de retalho. Os descontos de parceiros estão disponíveis através do crédito ganho pelo parceiro.
- Os preços do medidor de reservas incluem os descontos de parceiro CSP. Os preços estimados de revenda das reservas podem ser encontrados nos serviços partilhados de reservas transferíveis a partir da página "Preços e ofertas" do Centro de Parceiros.
- Pode encontrar mais informações sobre os preços do plano do Azure na documentação de preços do plano do Azure.
- Os preços dos parceiros e as APIs de taxa de câmbio externa não fazem parte do SDK do Centro de Parceiros.
- Este método devolve a lista de preços como um fluxo de ficheiros. O fluxo de ficheiros é um ficheiro .csv ou uma versão comprimida com zip do .csv. Os detalhes sobre como pedir ficheiros comprimidos estão incluídos abaixo.
Pedido REST
Sintaxe do pedido
| Método | URI do pedido |
|---|---|
| GET | https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value |
Parâmetros necessários do URI
Utilize os seguintes parâmetros de caminho para pedir o mercado e o tipo de folha de preços que pretende.
| Nome | Tipo | Necessário | Descrição |
|---|---|---|---|
| Mercado | string | Yes | Código de país de duas letras para o mercado que está a ser solicitado |
| Vista de Folha de Preços | string | Yes | O tipo de folha de preços que está a ser pedida, que pode ser azure_consumption, azure_reservations, atualizada, marketplace ou software. |
Nota
Updatedlicensebased PriceSheetView está atualmente disponível apenas para parceiros que fazem parte da pré-visualização técnica da nova experiência comercial M365/D365.
Nota
A lista de preços do software estará disponível através da API a partir de 1 de abril de 2022.
Parâmetros de filtro de URI
Utilize os seguintes parâmetros de filtro.
| Nome | Tipo | Necessário | Descrição |
|---|---|---|---|
| Linha cronológica | cadeia (de carateres) | No | A predefinição é atual se não for transmitida. Os valores possíveis são histórico, atual e futuro. |
| Mensal | cadeia (de carateres) | No | Só é necessário se o histórico for pedido, tem de cumprir o YYYYMM para a folha de preços que está a ser pedida. |
Nota
Os preços futuros não são suportados no Marketplace. A partir de 1 de abril de 2022, os parceiros poderão ver o histórico da lista de preços de software através da API, a partir do histórico de março de 2022.
Cabeçalhos do pedido
- Para obter mais informações, veja Cabeçalhos REST de parceiros.
Além dos cabeçalhos acima, os ficheiros de preços podem ser obtidos como comprimidos, reduzindo a largura de banda e os tempos de transferência. Por predefinição, os ficheiros não são comprimidos. Para obter versões comprimidas dos ficheiros, pode incluir o valor de cabeçalho abaixo. Tenha em atenção que as folhas comprimidas 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 comprimidas.
| Cabeçalho | Tipo de Valor | Valor | Descrição |
|---|---|---|---|
| Accept-Encoding | string | esvaziar | Opcional. Se a transmissão de ficheiros omitida não for comprimida. |
Exemplo de pedido
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 pedido para novo comércio
Nota
Updatedlicensebased PriceSheetView está atualmente disponível apenas para parceiros que fazem parte da pré-visualização técnica da nova experiência comercial M365/D365.
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 do REST
Se for bem-sucedido, este método devolve a lista de preços como um fluxo de ficheiros. O fluxo de ficheiros é um ficheiro .csv ou uma versão comprimida com zip do .csv.
Exemplo de resposta para novo comércio
Nota
Updatedlicensebased PriceSheetView está atualmente disponível apenas para parceiros que fazem parte da pré-visualização técnica da nova experiência comercial M365/D365.
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 erro e êxito da resposta
Cada resposta inclui um código de estado HTTP que indica êxito ou falha e outras informações de depuração. Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e outros parâmetros. Para obter a lista completa, veja Códigos de Erro.
Se não forem esperadas alterações para a nova lista de preços futuros com base em licenças comerciais, não será devolvida nenhuma lista de preços futura. Ao transmitir o futuro para a Linha Cronológica pedida para o PriceSheetView atualizado, os parceiros verão o seguinte código de resposta da API: 404 Não Encontrado.