Dela via


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

  1. 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.
  2. 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.
  3. 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.

  1. Registrera din app på Microsoft Entra-startsidan under avsnittet Appregistreringar.
  2. 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.

Ett diagram 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

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

GET https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

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, rootDirectoryoch blobs för api-svaret för manifestnyttolasten.

Följ dessa steg för att fortsätta:

  1. Ladda ned blobfilen med hjälp av Azure Storage SDK/tool.
  2. 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&currencyCode=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.