Fakturerad och ej fakturerad avstämning av dagligt prissatt användning API v2 (GA)
gäller för: Partner Center (inte tillgängligt i Azure Government eller Azure China 21Vianet)
Förstå arkitekturen
Det nya asynkrona API:et erbjuder betydande framsteg i hur vi hanterar åtkomst till fakturerings- och avstämningsdata. Den här metoden löser utmaningar som är associerade med traditionella synkrona metoder, som att underhålla långvariga anslutningar och bearbeta stora databatch. Här är de viktigaste fördelarna och mekanismerna för det här API:et:
Viktiga komponenter
Säker åtkomst med valet-nyckelmönster
Mönstret betjäntnyckel ger säker och begränsad åtkomst till dina faktureringsuppgifter. På samma sätt som en betjäntnyckel gör det möjligt för någon att köra din bil utan att komma åt bagageutrymmet, garanterar det här mönstret detaljerad åtkomstkontroll. I stället för att dela autentiseringsuppgifter ger en SAS-token (signatur för delad åtkomst) begränsad, tidsbunden åtkomst till specifika resurser. Det här mönstret minskar risken för obehörig åtkomst genom att konfigurera exakta förfallotider och åtkomstbehörigheter.
Förbättrad effektivitet via asynkront mönster för begäran-svar
Tänk på det som att beställa på en upptagen restaurang. Istället för att stå och vänta vid disken får du en pockande enhet och kan göra andra saker medan din beställning förbereds. När data är klara meddelar systemet dig.
API:ets asynkrona karaktär innebär att du gör en begäran och systemet bearbetar den i bakgrunden. Det här asynkrona begärandesvar använder resurser effektivt, minskar serverbelastningen och minimerar timeouts och fel som är vanliga vid synkron datahämtning.
Flexibilitet i behörigheter för dataåtkomst
SAS-token ger flexibilitet när det gäller att hantera dataåtkomstbehörigheter. Du kan generera token som ger åtkomst till alla attribut för fakturerade fakturaavstämningsdata eller begränsa åtkomsten till specifika underuppsättningar. Den här kornigheten gör det möjligt för organisationer att skräddarsy dataåtkomst enligt interna principer och regelkrav, vilket förbättrar säkerhet och efterlevnad.
Förenklat arbetsflöde och förbättrade databehandlingstider
Det asynkrona mönstret för svar på begäran effektiviserar databearbetningen genom att tillåta dynamisk åtkomst i stället för fasta batchar med 2 000 radobjekt. Den här metoden leder till snabbare resultat och förbättrade bearbetningstider, vilket förenklar integreringen av fakturerings- och avstämningsdata i befintliga system och arbetsflöden.
Fördelar
Prestandafördelar
I stället för att underhålla långvariga anslutningar och bearbeta fasta batchar kan du med det nya systemet:
- Gör en snabb inledande begäran.
- Ta emot en säker åtkomsttoken.
- Bearbeta data i din egen takt.
- Få åtkomst till exakt det du behöver när du behöver det.
Säkerhetsförbättringar
Valetnyckelmönstret, som implementeras via SAS-token, tillhandahåller:
- Tidsbegränsad åtkomst.
- Begränsade behörigheter.
- Eliminering av delning eller lagring av permanenta autentiseringsuppgifter.
- Detaljerad åtkomstkontroll.
arkitektoniska fördelar
Det asynkrona mönstret för begäran-svar fungerar som en personlig assistent som:
- Tar din begäran.
- Hanterar uppgiften i bakgrunden.
- Meddelar dig när allt är klart.
Använda optimerade API:er för bättre prestanda
Om du använder de här optimerade API:erna effektiviseras arbetsflödet och den övergripande prestandan för datahantering förbättras. Med hjälp av säker åtkomstkontroll och effektiva hämtningsmekanismer får du bättre resultat med mindre ansträngning, vilket leder till bättre driftseffektivitet.
Sammanfattningsvis är det nya asynkrona API:et för åtkomst till fakturerings- och avstämningsdata via Azure-blobbar ett kraftfullt verktyg. Det ger säker och effektiv åtkomst till finansiella data, effektiviserar arbetsflöden, minskar serverbelastningen och förbättrar bearbetningstiderna, allt med hög säkerhet och efterlevnad.
Kommentar
De nya API:erna finns inte på API-värden för Partnercenter. I stället kan du hitta dem i MS Graph på Använd Microsoft Graph API för att exportera partnerfaktureringsdata. Om du vill komma åt dessa API:er kan du läsa följande information.
Du kan bara använda dessa API:er för det offentliga globala MS Graph-molnet för tillfället. De är ännu inte tillgängliga för Azure Government eller Azure China.
Tillåt att din app får åtkomst till partnerfaktureringsdata
Om du vill tillåta att din app får åtkomst till partnerfaktureringsdata följer du den här länken och bekantar dig med grunderna för autentisering och auktorisering för Microsoft Graph. Det här steget är avgörande eftersom det säkerställer att din app på ett säkert sätt kan komma åt nödvändiga data.
Tilldela PartnerBilling.Read.All-behörighet
Tilldela behörigheten "PartnerBilling.Read.All" med antingen Azure-portalen eller administrationscentret för Microsoft Entra. De här stegen säkerställer att din app har nödvändig åtkomst till partnerfaktureringsdata.
- Registrera din app på Microsoft Entra-startsidan under avsnittet Appregistreringar.
- Bevilja nödvändig behörighet genom att gå till sidan Microsoft Entra-app. Under avsnittet API-behörigheter väljer du Lägg till en behörighet och väljer omfattningen PartnerBilling.Read.All.
Förstå skillnaderna mellan betaversioner och GA-versioner
Om du har använt vår betaversion kommer du förmodligen att finna övergången till den allmänna tillgänglighetsversionen (GA) smidig och intuitiv. För att hjälpa dig att förstå uppdateringarna och förbättringarna rekommenderar vi att du jämför betaversioner och GA-versioner. Genom att förstå de här uppdateringarna kan du maximera de nya funktionerna och förbättringarna som är tillgängliga i GA-versionen.
Viktigt!
Den dagliga prissatta användningen för ny handel inkluderar inte avgifterna för dessa produkter:
- Azure reservation
- Azure-besparingsprenumeration
- Kontor
- Dynamik
- Microsoft Power Apps
- Permanent programvara
- Prenumeration på programvara
- SaaS-produkt från andra länder än Microsoft eller Marketplace
Förstå och använda API-slutpunkter
För att hjälpa dig att asynkront hämta fakturerade nya kommers dagligt beräknade användningsobjekt erbjuder vi två viktiga API-slutpunkter. Följ den här smidiga guiden för att komma igång snabbt.
Använd slutpunkten för radobjekt
Använd först det här API:et för att hämta nya dagliga användningsradobjekt för handel . När du gör en begäran får du HTTP-status 202 och en platsrubrik med en URL. Kontrollera den här URL:en regelbundet tills du får en framgångsstatus och en manifest-URL.
Använd åtgärdens statusslutpunkt
Genom att följa dessa steg kan du effektivt hantera fakturaavstämningsprocessen.
Fortsätt att kontrollera åtgärdsstatusen genom att anropa det här API:et med jämna mellanrum. Om data inte är klara innehåller svaret ett Retry-After-huvud som anger hur länge du ska vänta innan du försöker igen. När åtgärden är klar får du en manifestresurs med en länk till lagringsmappen för att ladda ned användningsdata. Svaret segmentar filerna för att förbättra dataflödet och möjliggöra I/O-parallellitet.
Granska datasekvensdiagrammet för avstämning
Här är ett sekvensdiagram som visar stegen för att ladda ned avstämningsdata.
Följ användaråtgärdssekvensen
Här följer stegen i användaråtgärdssekvensen för att hämta ny handel dagliga radobjekt för användningsavstämning:
- Skicka en begäran
- Kontrollera status för begäran
- Ladda ned avstämningsradobjekt från Azure Blob Storage
Skicka en begäran
Skicka en POST-begäran till API-slutpunkten.
Hämta poster för dagliga debiterade användningsrader
Hämta obetalda dagliga värderade användningsposter för nya handelsverksamheter för den aktuella eller senaste kalendermånaden eller faktureringsperioden.
Kommentar
Du kan komma åt dina ej fakturerade dagliga debiterade förbrukningsposter via API eller Partnercenter-portalen. För att säkerställa datanoggrannhet kan du tillåta upp till 24 timmar för tillgänglighet. Beroende på din plats och när mätarna rapporterar användningen kan det uppstå ytterligare fördröjningar.
Vi prioriterar tidsleverans av fakturerade dagliga användningsdata först. Ibland kanske den senaste ej fakturerade dagliga klassificerade användningsdata inte visas förrän föregående månads fakturerade data är tillgängliga. När du har fått de fakturerade data kan du sedan komma åt alla uppdaterade ej fakturerade användningsdata från början av månaden.
Viktiga punkter:
- Tillåt upp till 24 timmar för datatillgänglighet.
- Det kan uppstå ytterligare fördröjningar beroende på din plats och mätarrapporteringstider.
- Fakturerade dagliga användningsdata prioriteras framför ej fakturerade data.
Din förståelse och ditt tålamod uppskattas när vi strävar efter att tillhandahålla så exakt och snabb information som möjligt.
API-begäran
POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/unbilled/export
Accept: application/json
Content-Type: application/json
{
"currencyCode": "USD",
"billingPeriod": "current",
"attributeSet": "basic"
}
Begärandetext
Attribut | Obligatoriskt | Typ | Beskrivning |
---|---|---|---|
attributuppsättning | Falsk | Sträng | Välj "fullständig" för alla attribut eller "grundläggande" för en begränsad uppsättning. Om det inte anges är "full" standardvärdet. Kontrollera listan över attribut i det här avsnittet. Valfritt. |
faktureringsperiod | Sant | Sträng | Använd "aktuell" för den aktuella faktureringsperioden eller "sista" för den föregående faktureringsperioden (samma som "föregående" i v1-API:et för att hämta ej fakturerad daglig användning. Obligatoriska. |
valutakod | Sant | Sträng | Valutakod för partnerfakturering. Obligatoriska. |
Begärandehuvuden
Information om hur du begär huvuden för API :et finns i Tillförlitlighet och support.
API-svar
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14
API:et svarar vanligtvis med http 202-status. Du kan också stöta på andra statusar beroende på dina begäranden. Dessa statusar visas i avsnittet Standard-API-svarsstatusar .
Kod | Beskrivning |
---|---|
202 - Accepterad | Din begäran godkändes. För att kontrollera statusen för din begäran, använd URL:en som anges i adressradens location-header. |
Hämta fakturerade objektrader för dagligt användande
Hämta ny handel fakturerade linjeposter för daglig räknad användning för en faktura för den avslutade faktureringsperioden.
API-begäran
POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export
{
"invoiceId": "G00012345",
"attributeSet": "full"
}
Frågeparametrar
Ej tillämpligt
Begärandetext
Attribut | Obligatoriskt | Typ | Beskrivning |
---|---|---|---|
faktura-ID | Sant | Sträng | En unik identifierare för varje faktura. Obligatoriska. |
attributuppsättning | Falsk | Sträng | Välj "fullständig" för alla attribut eller "grundläggande" för en begränsad uppsättning. Om det inte anges är "full" standardvärdet. Kontrollera listan över attribut i det här avsnittet. Valfritt. |
Begärandehuvud
Begär rubriker för API:et. Mer information finns i tillförlitlighet och support.
API-svar
HTTP/1.1 202 Accepterad
Plats: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14
När du använder API:et returneras vanligtvis en HTTP 202-status. För andra möjliga statusar baserade på dina förfrågningar, se statusar.
Kod | Beskrivning |
---|---|
202 - Accepterad | Din begäran godkändes. För att kontrollera statusen för din begäran, använd URL:en som anges i location-headern. |
Kontrollera status för begäran
Om du vill hålla reda på status för en begäran ser du till att du får ett HTTP 200-svar som är en standardstatuskod som anger "lyckades" eller "misslyckades". Om det lyckas hittar du manifest-URL:en i attributet "resourceLocation". Det här attributet ger en slutpunkt för åtkomst till nödvändig information.
Hämta åtgärdsstatus
Hämtar status för en begäran.
API-begäran
Parametrar för begäran
Name | Inkludera i | Obligatoriskt | Typ | Beskrivning |
---|---|---|---|---|
operationId | URI för förfrågan | Sant | sträng | En unik identifierare för att kontrollera status för begäran. Obligatoriska. |
Begärandehuvud
Information om hur du begär huvuden för API :et finns i Tillförlitlighet och support.
Begärandetext
Saknas.
Svarsstatus
Förutom de standard-HTTP-statusar som anges i Standard API-svarsstatusar kan API:et också returnera följande HTTP-status:
Kod | Beskrivning |
---|---|
410 - Borta | Manifestlänken upphör att gälla efter en angiven tid. Om du vill hämta manifestlänken igen skickar du en ny begäran. |
Svarsnyttolast
API-svarsnyttolasten innehåller följande attribut:
Attribut | Obligatoriskt | Beskrivning |
---|---|---|
id | Sant | En unik identifierare för varje svar. Obligatoriska. |
status | Sant |
Värden och åtgärder: Krävs: inte startad: Vänta under den angivna varaktigheten i rubriken "Försök igen" och gör sedan ett nytt anrop för att kontrollera statusen. körs: Vänta tills den angivna varaktigheten i rubriken "Försök efter igen" och gör sedan ett nytt anrop för att kontrollera statusen. lyckades: Data är klara. Hämta manifestnyttolasten med hjälp av den URI som anges i resourceLocation. misslyckades: Åtgärden misslyckades permanent. Starta om den. |
createdDateTime | Sant | Den tid då begäran gjordes. Obligatoriska. |
senasteÅtgärdsDatumTid | Sant | Senaste gången statusen ändrades. Obligatoriska. |
resursplats | Falsk | URI:n för manifestets nyttolast. Valfritt. |
fel | Falsk | Information om eventuella fel, som anges i JSON-format. Valfritt. Attribut som ingår: message: Beskrivning av felet. kod: Typ av fel. |
Resurslokaliseringsobjekt
Attribut | Beskrivning |
---|---|
id | En unik identifierare för manifestet. |
schemaVersion | Version av manifestschemat. |
dataFormat | Format för faktureringsdatafilen. compressedJSON: dataformat där varje blob är en komprimerad fil som innehåller data i JSON-linjeformat . För att hämta data från varje blob dekomprimerar du den. |
createdDateTime | Datum och tid då manifestfilen skapades. |
eTag | Version av manifestdata. En ändring i faktureringsinformationen genererar ett nytt värde. |
partnerTenantId | Microsoft Entra-ID för partnerns klientorganisation. |
rootDirectory | Rotmappen för filen. |
sasToken | SAS-token (signatur för delad åtkomst) som gör att du kan läsa alla filer under katalogen. |
partitionstyp | Delar upp data i flera blobar baserat på attributet "partitionValue" . Systemet delar partitioner som överskrider det antal som stöds. Som standard partitioneras data baserat på antalet radobjekt i filen. Undvik att hårdkoda antal radobjekt eller filstorlekar när de kan ändras. |
blobCount | Totalt antal filer för det här partnerklient-ID:t. |
blobar | En JSON-matris med "blob"-objekt som innehåller filinformationen för partnerklient-ID:t. |
blob-objekt | Ett objekt som innehåller följande information: namn och partitionValue |
namn | Namnet på bloben. |
partitionsvärde | Partition som innehåller filen. Den stora partitionen är uppdelad i flera filer baserat på vissa kriterier, till exempel filstorlek eller antal poster, där varje fil innehåller samma "partitionValue". |
API-begäran
GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>
API-svar
Svaret rekommenderar att du väntar i 10 sekunder innan du försöker igen när du bearbetar data.
HTTP/1.1 200 OK
Retry-After: 10
{
"id": "9ab9cb54-d07f-4f52-9ea6-a09d7de52c14",
"createdDateTime": "2022-06-1T10-01-03.4Z",
"lastActionDateTime": "2022-06-1T10-01-05Z",
"status": "running"
}
API-begäran
(10 sekunder efter föregående begäran...)
GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>
API-svar
API:et returnerar statusen "lyckades" och URI:n för "resourceLocation".
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/\$metadata#reports/partners/billing/operations/\$entity",
"@odata.type": "#microsoft.graph.partners.billing.exportSuccessOperation",
"id": "f2170b13-6a8e-47d6-b481-6988490dc0cb",
"createdDateTime": "2023-12-05T21:17:29Z",
"lastActionDateTime": "2023-12-05T21:18:00.8897902Z",
"status": "succeeded",
"resourceLocation": {
"id": "44e8500b-ab92-490e-8ac3-90500a1d3427",
"createdDateTime": "2023-11-06T19:58:47.513Z",
"schemaVersion": "2",
"dataFormat": "compressedJSON",
"partitionType": "default",
"eTag": "RwDrn7fbiTXy6UULE",
"partnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"rootDirectory": "https://adlsreconbuprodeastus201.blob.core.windows.net/path_id",
"sasToken": "{token}",
"blobCount": 1,
"blobs": \[
{
"name": "part-00123-5a93fa5d-749f-48bc-a372-9b021d93c3fa.c000.json.gz",
"partitionValue": "default"
}
\]
}
}
Ladda ned avstämningsradobjekt från Azure Blob Storage
Först måste du hämta sas-token (signatur för delad åtkomst) och bloblagringsplatsen (kombinera rotkatalogen och blobnamnet). Du hittar den här informationen i egenskaperna sasToken
, rootDirectory
och blobs
för api-svaret för manifestnyttolasten.
Följ dessa steg för att fortsätta:
- Ladda ned blobfilen med hjälp av Azure Storage SDK/tool.
- Packa upp filen, som är i JSONLines format.
Tips
Kolla in exempelkod. Den visar hur du laddar ned och packar upp Azure-blobfilen till din lokala databas.
Förstå standardstatusen för API-svar
Du kan få dessa HTTP-statusar från API-svaret:
Code | Beskrivning |
---|---|
400 – felaktig begäran | Begäran saknas eller innehåller felaktiga data. Kontrollera svarsinnehållet för detaljer om fel. |
401 – Ej behörig | Autentisering krävs innan du gör det första anropet. Autentisera med partner-API-tjänsten. |
403 – Förbjudet | Du har inte den behörighet som krävs för att göra begäran. |
404 – Hittades inte | De begärda resurserna är inte tillgängliga med de angivna indataparametrarna. |
410 - Borta | Manifestlänken är inte giltig eller aktiv längre. Skicka en ny begäran. |
500 – Internt serverfel | API:et eller dess beroenden kan inte uppfylla begäran just nu. Försök igen senare. |
5000 – Inga tillgängliga data | Systemet har inga data för de angivna indataparametrarna. |
Jämför beta- och GA-versioner
Kolla in följande jämförelsetabell för att se skillnaderna mellan betaversionen och de allmänt tillgängliga (GA). Om du för närvarande använder betaversionen är övergången till GA-versionen förmodligen enkel och enkel.
Viktig information | Beta | Allmänt tillgängligt |
---|---|---|
API-värdslutpunkt | https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/ |
https://graph.microsoft.com/v1.0/reports/partners/billing/usage/ |
HTTP-metod | POST | POST |
Api-slutpunkt för ej fakturerad dagligt klassificerad användning | https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/v1/unbilledusage |
https://graph.microsoft.com/v1.0/reports/partners/billing/usage/unbilled/export |
Indataparametrar för API:et för ej fakturerad dagligen klassificerad användning | Om du vill ange parametrar i API-begäran tar du med dem i frågesträngen för begärande-URL:en. Om du till exempel vill ange parametrarna period och currencyCode, lägger du till ?period=current¤cyCode=usd i URL:en för begäran. |
Ange indata genom att inkludera ett JSON-objekt i begärandetexten. Din JSON bör ha följande egenskaper: * currencyCode: Din faktureringsvaluta. Till exempel USD. * billingPeriod: Faktureringsperioden för fakturan. Till exempel nuvarande. Här är ett JSON-exempelobjekt som innehåller egenskaperna currencyCode och billingPeriod: <br>{<br> "currencyCode": "USD",<br> "billingPeriod": "current"<br>} |
API-slutpunkt för dagligen beräknad fakturerad användning | https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/v1/billedusage/invoices/{InvoiceId} |
https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export |
Indataparametrar för API:et för fakturering av dagligt taxerad användning | Om du vill ange parametrar i API-begäran tar du med invoiceId i begärande-URL:en. Dessutom kan du inkludera en valfri fragmentparameter i frågesträngen för att hämta den fullständiga uppsättningen attribut. Om du till exempel vill hämta den fullständiga uppsättningen attribut lägger du till ?fragment=full till begärande-URL:en. |
Ange indata genom att inkludera ett JSON-objekt i begärandetexten. Din JSON bör ha följande egenskaper: * invoiceId: Den unika identifieraren för fakturan. Till exempel G00012345. * attributeSet: De attribut som ska finnas i svaret, till exempel fullständiga. Här är ett JSON-exempelobjekt som innehåller egenskaperna invoiceId och attributeSet: {<br> "invoiceId": "G00012345",<br> "attributeSet": "full"<br>} |
Manifestresurs | Använd en separat GET /manifest/{id}-metod för att hämta manifestresursen. | Använd metoden GET /operations/{Id} för att komma åt manifestresursen i resourceLocation. Den här metoden sparar tid genom att eliminera behovet av ett separat anrop till GET /manifest/{id}. |
Ändringar i manifestschemat | ||
"id": Inte tillgängligt | "id": En unik identifierare för manifestresursen. | |
"version": Tillgänglig | "version": har ändrats till "schemaversion". | |
"dataFormat": Tillgänglig | "dataFormat": Tillgänglig. | |
"utcCretedDateTime": Tillgänglig | "utcCretedDateTime": har ändrats till "createdDateTime". | |
"eTag": Tillgänglig | "eTag": Tillgänglig. | |
"partnerTenantId": Tillgänglig | "partnerTenantId": Tillgänglig | |
"rootFolder": Tillgänglig | "rootFolder": har ändrats till "rootDirectory". | |
"rootFolderSAS": Tillgänglig | "rootFolderSAS": har ändrats till "sasToken". Den här uppdateringen innehåller bara token utan rotkatalogsökvägen. Om du vill hitta katalogen använder du egenskapen "rootDirectory" i stället. | |
"partitionType": Tillgänglig | "partitionType": Tillgänglig. | |
"blobCount": Tillgänglig | "blobCount": Tillgänglig. | |
"sizeInBytes": Tillgänglig | "sizeInBytes": Inte tillgängligt. | |
"blobs": Tillgänglig | "Blobs": Tillgänglig. | |
"blob objekt": Tillgängligt | "blob-objekt": Tillgängligt. | |
"name": Tillgänglig | "name": Tillgänglig. | |
"partitionValue": Tillgänglig | "partitionValue": Tillgänglig. |
Jämför grundläggande och fullständiga attribut för den dagliga avstämningen av användningen
Om du vill jämföra attributen som returneras av api:et för fakturerad eller ej fakturerad användningsavstämning för attributuppsättningarna "full" eller "basic" läser du den här tabellen. Mer information om dessa attribut och deras betydelser finns i fältfilen för den dagliga klassificerade användningsavstämningen.
Attribut | Fullständig | Grundläggande |
---|---|---|
PartnerId | ja | ja |
PartnerName | ja | ja |
KundID | ja | ja |
CustomerName | ja | Ja |
Kunddomännamn | ja | nej |
Kundland | ja | nej |
MpnId | ja | nej |
Tier2MpnId | ja | nej |
Fakturanummer | ja | ja |
Produkt-ID | ja | ja |
SkuId | ja | ja |
TillgänglighetsId | ja | nej |
SkuName | ja | ja |
ProductName | ja | nej |
PublisherName | ja | ja |
UtgivareId | ja | nej |
Prenumerationsbeskrivning | ja | nej |
AbonnemangsId | ja | ja |
Laddningsstartdatum | ja | ja |
Debiteringsslutdatum | ja | ja |
Användningsdatum | ja | ja |
Metertyp | ja | nej |
Mätarkategori | ja | nej |
MeterId | ja | nej |
Mätarkategori | ja | nej |
Mätarnamn | ja | nej |
MeterRegion | ja | nej |
Enhet | ja | ja |
ResourceLocation | ja | nej |
ConsumedService | ja | nej |
ResourceGroup | ja | nej |
ResourceURI | ja | ja |
Laddningstyp | ja | ja |
Enhetspris | ja | ja |
Kvantitet | ja | ja |
Enhetstyp | ja | nej |
Fakturatotal före skatt | ja | ja |
Faktureringsvaluta | ja | ja |
Pris före skatt totalt | ja | ja |
Prissättningsvaluta | ja | ja |
ServiceInfo1 | ja | nej |
ServiceInfo2 | ja | nej |
Taggar | ja | nej |
Ytterligare information | ja | nej |
EffectiveUnitPrice | ja | ja |
PCToBCVäxelkurs | ja | ja |
PCToBCExchangeRateDate | ja | nej |
Rättighets-ID | ja | ja |
Rättighetsbeskrivning | ja | nej |
PartnerFörtjänadeKreditProcent | ja | nej |
Kreditprocent | ja | ja |
Kredittyp | ja | ja |
BenefitOrderID | ja | ja |
BenefitID | ja | nej |
Förmånstyp | ja | ja |
Viktigt!
Anteckna dessa ändringar när du flyttar från API v1 till v2.
- Varje attributnamn börjar med en versal bokstav för att säkerställa enhetlighet med filen och förbättra läsbarheten.
- unitOfMeasure uppdateras till enhet. Dess betydelse och värde förblir oförändrade, vilket förenklar attributnamnet.
- resellerMpnId är nu Tier2MpnId. Innebörden och värdet är desamma.
- rateOfPartnerEarnedCredit uppdateras till PartnerEarnedCreditPercentage. Det nya namnet och värdet återspeglar procent i stället för bråk, vilket gör det enklare att förstå. Till exempel är 0,15 nu 15 %.
- rateOfCredit är nu CreditPercentage. Både namnet och värdet har ändrats för att ge en tydligare förståelse. Till exempel är 1,00 nu 100 %.
Vi tror att dessa ändringar gör API:erna mer intuitiva och enklare att använda.
Exempelkod
Om du behöver hjälp med att migrera till det här API:et kan du läsa länken som innehåller C#-exempelkoden.
Exempel på Partner Center API: Hämta faktureringsavstämningsdata.