Dela via

Hämta ett prisdokument

  • Artikel

Den här artikeln förklarar hur du får ett prisdokument för en viss marknad och vy. Den här metoden stöder filter för att hämta historik per månad.

Förutsättningar

  • Autentiseringsuppgifter enligt beskrivningen i Partner-API-autentisering. Det här scenariot stöder endast autentisering av programanvändare. Endast program stöds inte ännu. Partner som upplever http-fel:400 bör läsa dokumentationen för partner-API-autentisering.
  • Det här API:et stöder för närvarande endast användaråtkomst där partner måste ha någon av följande roller: Global administratör, administratörsagent eller försäljningsagent.

Details

  • Aktuella returnerar endast data för förbrukning och reservationer för Azure-plan, Licensierad baserad (ny handelsupplevelse) och Marketplace-produkter.
  • Den aktuella prissättningen inkluderar alla mätare och produkter som är tillgängliga under den aktuella månaden till det datum då API:et anropas. Föregående månader inkluderar alla mätare och produkter som är tillgängliga för den angivna månaden.
  • Priserna för förbrukningsmätare är endast i USD, partner ska använda API:et för utländska växelkurser för att beräkna kostnader för lokal valuta.
  • Förbrukningsmätarepriser är uppskattade detaljhandelspriser. Partnerrabatter är tillgängliga via partnerintjänad kredit.
  • Reservationsmätarens priser inkluderar CSP-partnerrabatterna. Uppskattade detaljhandelspriser för reservationer finns i de reservationer som delade tjänster kan laddas ned från sidan "Priser och erbjudanden" i Partnercenter.
  • Mer information om priser för Azure-plan finns i prisdokumentationen för Azure-plan.
  • Partnerpriser och API:er för utländsk växelkurs ingår inte i PartnerCenter SDK.
  • Den här metoden returnerar prislistan som en filström. Filströmmen är antingen en .csv fil eller en komprimerad zip-version av .csv. Information om hur du begär komprimerade filer finns nedan.

REST-begäran

Syntax för begäran

Metod URI för förfrågan
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value

Obligatoriska URI-parametrar

Använd följande sökvägsparametrar för att begära den marknad och typ av prisdokument som du vill använda.

Namn Typ Obligatoriskt Beskrivning
Marknad sträng Ja Lands-/regionkod med två bokstäver för den marknad som begärs
PricesheetView sträng Ja Den typ av prisdokument som begärs, som kan azure_consumption, azure_reservations, uppdateradlicensibaserad, marknadsplats eller programvara.

Kommentar

updatedlicensebased PriceSheetView är för närvarande endast tillgängligt för partner som ingår i Microsoft 365/Microsoft Dynamics 365 new commerce experience technical preview.

Kommentar

Listan över programvarupriser kommer att vara tillgänglig via API från och med den 1 april 2022.

URI-filterparametrar

Använd följande filterparametrar.

Namn Typ Obligatoriskt Beskrivning
Tidslinje sträng Nej Standardvärdet är aktuellt om det inte skickas. Möjliga värden är historik, aktuell och framtida.
Månad sträng Nej Krävs endast om historik begärs, måste följa YYYYMM för prisdokumentet som begärs.

Kommentar

Framtida priser stöds inte för Marketplace. Från och med den 1 april 2022 kommer partner att kunna visa historik över programvarupriser via API:et från och med mars 2022.

Begärandehuvuden

Förutom ovanstående rubriker kan prisfiler hämtas som komprimerade, vilket minskar bandbredden och nedladdningstiderna. Som standard komprimeras inte filerna. Om du vill hämta komprimerade versioner av filerna kan du inkludera rubrikvärdet nedan. Observera att komprimerade blad endast är tillgängliga från april 2020 och framåt, alla blad före april 2020 är endast tillgängliga som inte komprimerade.

Header Värdetyp Värde beskrivning
Accept-Encoding sträng Tömma Valfritt. Om den utelämnade filströmmen inte komprimeras.

Exempel på begäran

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

Exempel på begäran för ny handel

Kommentar

updatedlicensebased PriceSheetView är för närvarande endast tillgängligt för partner som ingår i Microsoft 365/Microsoft Dynamics 365 new commerce experience technical preview.

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

REST-svar

Om det lyckas returnerar den här metoden prislistan som en filström. Filströmmen är antingen en .csv fil eller en komprimerad zip-version av .csv.

Svarsexempel för ny handel

Kommentar

updatedlicensebased PriceSheetView är för närvarande endast tillgängligt för partner som ingår i Microsoft 365/Microsoft Dynamics 365 new commerce experience technical preview.

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 ==============

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och annan felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och andra parametrar. Den fullständiga listan finns i Felkoder.

Om inga ändringar förväntas för den nya handelslicensbaserade framtida prislistan returneras ingen framtida prislista. När du skickar framtiden till tidslinjen som begärts för den uppdateradelicensbaserade PriceSheetView ser partner följande API-svarskod: 404 Hittades inte.

Nästa steg