Gefactureerde en niet-gefactureerde dagelijkse afstemmings-API voor gebruik v2 (GA)

Van toepassing op: Partnercentrum (niet beschikbaar in Azure Government of Azure China 21Vianet.)

Onze nieuwe asynchrone API biedt een snellere en efficiëntere manier om toegang te krijgen tot uw facturerings- en afstemmingsgegevens via Azure-blobs. In plaats van een verbinding uren open te houden of batches van 2000 regelitems te verwerken, kunt u uw werkstroom stroomlijnen, de belasting van de server verminderen en de verwerkingstijden van gegevens verbeteren.

De nieuwe commerce-API's voor het dagelijks beoordelen van gebruik maken gebruik van geavanceerde technieken zoals valetsleutel en asynchrone aanvraag-antwoordpatronen . Het valetsleutelpatroon ondersteunt beveiligde toegang tot resources zonder referenties te delen, terwijl het asynchrone aanvraagantwoordpatroon een efficiënte communicatie tussen systemen mogelijk maakt.

Deze API's bieden u een SAS-token (Shared Access Signature) dat u kunt gebruiken voor toegang tot alle kenmerken of een subset van de dagelijkse afstemmingsgegevens voor gebruik. Dit token verbetert de beveiliging door beperkte toegang te verlenen en biedt flexibiliteit bij het beheren van machtigingen voor gegevenstoegang.

Door gebruik te maken van onze geoptimaliseerde API's, kunt u sneller resultaten bereiken met minder inspanning, de toegang tot uw gegevens vereenvoudigen en de algehele efficiëntie verbeteren. Gebruik deze hulpprogramma's om uw werkstroom te stroomlijnen en machtigingen effectiever te beheren.

Notitie

De nieuwe API's worden niet gehost op de Partner Center API-host. In plaats daarvan kunt u ze vinden in MS Graph op De Microsoft Graph API gebruiken om factureringsgegevens van partners te exporteren - Microsoft Graph v1.0 | Microsoft Learn. Raadpleeg de volgende details om toegang te krijgen tot deze API's.

U kunt deze API's voorlopig alleen gebruiken voor de openbare wereldwijde MS Graph-cloud. Ze zijn nog niet beschikbaar voor Azure Government of Azure China.

Uw app toegang geven tot factureringsgegevens van partners

Volg deze koppeling om uw app toegang te geven tot factureringsgegevens van partners en vertrouwd te raken met de basisbeginselen voor verificatie en autorisatie van voor Microsoft Graph. Deze stap is van cruciaal belang omdat uw app veilig toegang heeft tot de benodigde gegevens.

De machtiging PartnerBilling.Read.All toewijzen

Wijs de machtiging PartnerBilling.Read.All toe met behulp van de Azure-portal of het Microsoft Entra-beheercentrum. Deze stappen zorgen ervoor dat uw app de vereiste toegang heeft tot de factureringsgegevens van de partner.

1. Registreer uw app op de startpagina van Microsoft Entra onder de sectie App-registraties.
2. Verleen de benodigde machtigingen door naar de Microsoft Entra App-pagina te gaan. Selecteer in de sectie API-machtigingen Een machtiging toevoegen en kies het bereik PartnerBilling.Read.All.

Inzicht in de verschillen tussen de bèta- en GA-versies

Als u onze bètaversie gebruikt, zult u waarschijnlijk de overgang naar de algemene beschikbaarheidsversie (GA) soepel en intuïtief vinden. Om u inzicht te geven in de updates en verbeteringen, raden we u aan bèta- en GA-versies te vergelijken. Als u deze updates begrijpt, kunt u de nieuwe functies en verbeteringen die beschikbaar zijn in de GA-versie maximaliseren.

Belangrijk

Het nieuwe dagelijkse gebruik van de handel omvat niet de kosten voor deze producten:

• Azure-reservering
• Azure-besparingsplan
• Office
• Dynamics
• Microsoft Power Apps
• Eeuwigdurende software
• Softwareabonnement
• SaaS-product dat niet van Microsoft of marketplace is

De API-eindpunten begrijpen en gebruiken

Om u te helpen bij het ophalen van gefactureerde nieuwe commerce dagelijks geclassificeerde gebruiksregelitems asynchroon, bieden we twee belangrijke API-eindpunten. Volg deze gestroomlijnde handleiding om snel aan de slag te gaan.

Het eindpunt van het regelitem gebruiken

Gebruik eerst deze API om nieuwe dagelijkse verbruiksartikelen op te halen. Wanneer u een aanvraag indient, ontvangt u een HTTP-status van 202 en een locatieheader met een URL. Peil deze URL regelmatig totdat u de status geslaagd en een manifest-URL krijgt.

Gebruik het eindpunt voor de bewerkingsstatus

Door deze stappen te volgen, kunt u uw factuurafstemmingsproces efficiënt beheren.

Controleer de bewerkingsstatus door deze API regelmatig aan te roepen. Als de gegevens niet gereed zijn, bevat het antwoord een header Opnieuw proberen na die aangeeft hoe lang moet worden gewacht voordat u het opnieuw probeert. Zodra de bewerking is voltooid, ontvangt u een manifestresource met een koppeling naar de opslagmap om de gebruiksgegevens te downloaden. Het antwoord segmenteren de bestanden om de doorvoer te verbeteren en I/O parallellisme mogelijk te maken.

Afstemmingsgegevens downloaden

Hier volgt een sequentiediagram met de stappen voor het downloaden van de afstemmingsgegevens.

Volg de actiereeks van de gebruiker

Hier volgen de stappen voor de gebruikersactie om nieuwe commerce- dagelijkse afstemmingsregelitems voor gebruik op te halen:

• een aanvraag indienen
• De status van de aanvraag controleren
• Dagelijkse gebruiksafstemmingsregelitems downloaden uit Azure Blob Storage

Een aanvraag indienen

Dien een POST-aanvraag in bij het API-eindpunt.

Niet-gefactureerde dagelijkse verbruiksregelitems ophalen

Ontvang nieuwe handelsverkeer niet-gefactureerde dagelijkse verbruiksregelitems voor de huidige of laatste kalendermaand of factureringsperiode.

Notitie

U hebt toegang tot uw niet-gefactureerde dagelijkse verbruiksregelitems via de API- of Partnercentrum-portal. Om de nauwkeurigheid van gegevens te garanderen, kunt u maximaal 24 uur beschikbaar zijn. Afhankelijk van uw locatie en wanneer de meters het gebruik rapporteren, kunnen er verdere vertragingen optreden.

We prioriteren eerst de levering van gefactureerde dagelijkse gebruiksgegevens. Af en toe worden de meest recente niet-gefactureerde gegevens over dagelijks gebruik mogelijk niet weergegeven totdat de gefactureerde gegevens van de vorige maand beschikbaar zijn. Zodra u de gefactureerde gegevens hebt ontvangen, hebt u vanaf het begin van de maand toegang tot alle bijgewerkte niet-gefactureerde gebruiksgegevens.

belangrijkste punten:

• Het kan tot 24 uur duren voordat de gegevens beschikbaar zijn.
• Er kunnen verdere vertragingen optreden, afhankelijk van de rapportagetijden van uw locatie en meter.
• Gefactureerde dagelijkse gebruiksgegevens krijgen prioriteit boven niet-gefactureerde gegevens.

Uw begrip en geduld worden gewaardeerd omdat we ernaar streven om de meest nauwkeurige en tijdige informatie te bieden.

API-aanvraag

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"

}

Aanvraagtekst

Kenmerk	Vereist	Type	Description
attributeSet	Onwaar	String	Kies 'volledig' voor alle kenmerken of basic voor een beperkte set. Als dit niet is opgegeven, is 'volledig' de standaardwaarde. Controleer de lijst met kenmerken in deze sectie. Optioneel.
billingPeriod	Waar	String	Als u niet-gefactureerd dagelijks gebruik wilt ophalen, gebruikt u 'current' voor de huidige factureringsperiode of 'laatste' voor de vorige factureringsperiode (hetzelfde als 'vorige' in v1 API). Vereist.
currencyCode	Waar	String	Valutacode voor partnerfacturering. Vereist.

Aanvraagheaders

Als u headers voor de API wilt aanvragen, raadpleegt u Betrouwbaarheid en ondersteuning.

API-reactie

HTTP/1.1 202 Accepted  
Location: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

De API reageert meestal met een HTTP 202-status. U kunt ook andere statussen tegenkomen, afhankelijk van uw aanvragen. Deze statussen worden weergegeven in de sectie Statussen van standaard-API-antwoorden.

Code	Description
202 - Geaccepteerd	Uw aanvraag is geaccepteerd. Als u de status van uw aanvraag wilt controleren, voert u een query uit op de URL die is opgegeven in de locatieheader.

Gefactureerde dagelijkse verbruiksregelitems ophalen

Ontvang nieuwe commerce gefactureerde dagelijkse verbruiksregelitems voor een factuur voor de gesloten factureringsperiode.

API-aanvraag

POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export

{  
"invoiceId": "G00012345",  
"attributeSet": "full"  
}

Queryparameters

N.v.t.

Aanvraagtekst

Kenmerk	Vereist	Type	Description
InvoiceId	Waar	String	Een unieke id voor elke factuur. Vereist.
attributeSet	Onwaar	String	Kies 'volledig' voor alle kenmerken of basic voor een beperkte set. Als dit niet is opgegeven, is 'volledig' de standaardwaarde. Controleer de lijst met kenmerken in deze sectie. Optioneel.

Aanvraagheader

Aanvraagheaders voor de API. Zie de betrouwbaarheid en ondersteuning voor meer informatie.

API-reactie

HTTP/1.1 202 Geaccepteerd
Locatie: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

Wanneer u de API gebruikt, wordt doorgaans een HTTP 202-status geretourneerd. Zie statussenvoor andere mogelijke statussen op basis van uw aanvragen.

Code	Description
202 - Geaccepteerd	Uw aanvraag is geaccepteerd. Als u de status van uw aanvraag wilt controleren, voert u een query uit op de URL die is opgegeven in de locatieheader.

De aanvraagstatus controleren

Als u de status van een aanvraag wilt bijhouden, moet u ervoor zorgen dat u een HTTP 200-antwoord ontvangt. Dit is een standaardstatuscode die 'geslaagd' of 'mislukt' aangeeft. Als dit lukt, vindt u de manifest-URL in het kenmerk resourceLocation. Dit kenmerk biedt een eindpunt voor toegang tot de vereiste informatie.

Bewerkingsstatus ophalen

Haalt de status van een aanvraag op.

API-aanvraag

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

Aanvraagparameters

Naam	Opnemen in	Vereist	Type	Description
operationId	Aanvraag-URI	Waar	String	Een unieke id om de aanvraagstatus te controleren. Vereist.

Aanvraagheader

Als u headers voor de API wilt aanvragen, raadpleegt u Betrouwbaarheid en ondersteuning.

Aanvraagtekst

N.v.t.

Antwoordstatus

Naast de standaard HTTP-statussen die worden vermeld in de standaard-API-antwoordstatussen, kan de API ook de volgende HTTP-status retourneren:

Code	Description
410 - Verdwenen	De manifestkoppeling verloopt na een ingestelde tijd. Als u de manifestkoppeling opnieuw wilt ophalen, verzendt u een nieuwe aanvraag.

Nettolading van antwoord

De nettolading van het API-antwoord bevat de volgende kenmerken:

Kenmerk	Vereist	Description
id	Waar	Een unieke id voor elk antwoord. Vereist.
status	Waar	Waarden en acties: vereist: niet gestart: wacht op de opgegeven duur in de header 'Opnieuw proberen-na', en voer vervolgens nog een aanroep uit om de status te controleren. wordt uitgevoerd: wacht op de opgegeven duur in de header 'Opnieuw proberen-na', en voer vervolgens nog een aanroep uit om de status te controleren. geslaagd: de gegevens zijn gereed. Haal de nettolading van het manifest op met behulp van de URI die is opgegeven in resourceLocation. mislukt: de bewerking is permanent mislukt. Start het opnieuw op.
createdDateTime	Waar	Het tijdstip waarop de aanvraag is ingediend. Vereist.
lastActionDateTime	Waar	De laatste keer dat de status is gewijzigd. Vereist.
resourceLocation	Onwaar	De URI voor de nettolading van het manifest. Optioneel.
error	Onwaar	Details over eventuele fouten, opgegeven in JSON-indeling. Optioneel. Kenmerken zijn opgenomen: bericht: Beschrijving van de fout. code: Het type fout.

Resourcelocatieobject

Kenmerk	Description
id	Een unieke id voor het manifest.
schemaVersion	Versie van het manifestschema.
dataFormat	Indeling van het factureringsgegevensbestand. compressedJSON: gegevensindeling waarbij elke blob een gecomprimeerd bestand is dat gegevens in JSON-regelsindeling bevat. Als u de gegevens uit elke blob wilt ophalen, moet u deze decomprimeren.
createdDateTime	Datum en tijd waarop het manifestbestand is gemaakt.
eTag	Versie van de manifestgegevens. Een wijziging in factureringsgegevens genereert een nieuwe waarde.
partnerTenantId	Microsoft Entra-id van de tenant van de partner.
rootDirectory	Hoofdmap van het bestand.
sasToken	SAS-token (Shared Access Signature) waarmee u alle bestanden in de map kunt lezen.
partitionType	Verdeelt gegevens in meerdere blobs op basis van het kenmerk partitionValue . Het systeem splitst partities die het ondersteunde aantal overschrijden. Standaard worden gegevens gepartitioneerd op basis van het aantal regelitems in het bestand. Vermijd hardcodering van regelitems of bestandsgrootten, omdat deze kunnen veranderen.
blobCount	Totaal aantal bestanden voor deze partnertenant-id.
blobs	Een JSON-matrix van 'blob'-objecten die de bestandsgegevens voor de tenant-id van de partner bevatten.
blobobject	Een object met de volgende details: naam en partitionValue
naam	Naam van de blob.
partitionValue	Partitie die het bestand bevat. De grote partitie wordt gesplitst in meerdere bestanden op basis van bepaalde criteria, zoals de bestandsgrootte of het aantal records, waarbij elk bestand dezelfde "partitionValue"bevat.

API-aanvraag

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

API-reactie

Het antwoord raadt aan om 10 seconden te wachten voordat u het opnieuw probeert bij het verwerken van gegevens.

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

(10 seconden na de vorige aanvraag...)

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

API-reactie

De API retourneert de status Geslaagd en de URI voor 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"

            }

        \]

    }

}

Dagelijkse afstemmingsregelitems voor gebruik downloaden uit Azure Blob Storage

Eerst moet u het SAS-token (Shared Access Signature) en de blobopslaglocatie ophalen. U kunt deze details vinden in de sasToken en rootDirectory eigenschappen van de manifest payload API-response. Gebruik vervolgens de Azure Storage SDK/toolom het blobbestand te downloaden en uit te pakken. Deze heeft de JSONLines-indeling .

Tip

Zorg ervoor dat u onze voorbeeldcode bekijkt. U ziet hoe u het Azure-blobbestand downloadt en uitpakt naar uw lokale database.

Inzicht in de standaard-API-antwoordstatussen

Mogelijk ontvangt u deze HTTP-statussen van het API-antwoord:

Code	Beschrijving
400 - Foute aanvraag	De aanvraag ontbreekt of bevat onjuiste gegevens. Controleer de hoofdtekst van het antwoord op foutdetails.
401 - Onbevoegd	Verificatie is vereist voordat u de eerste aanroep doet. Verifiëren met de partner-API-service.
403 - Verboden	U hebt niet de benodigde autorisatie om de aanvraag te doen.
404 - Niet gevonden	De aangevraagde resources zijn niet beschikbaar met de opgegeven invoerparameters.
410 - Verdwenen	De manifestkoppeling is niet meer geldig of actief. Dien een nieuwe aanvraag in.
500 - Interne serverfout	De API of de bijbehorende afhankelijkheden kunnen momenteel niet voldoen aan de aanvraag. Probeer het later opnieuw.
5000 - Geen gegevens beschikbaar	Het systeem heeft geen gegevens voor de opgegeven invoerparameters.

Bèta- en GA-versies vergelijken

Bekijk de volgende vergelijkingstabel om de verschillen tussen de bètaversie en de algemeen beschikbare (GA)-versies te bekijken. Als u momenteel de bètaversie gebruikt, is de overgang naar de GA-versie waarschijnlijk eenvoudig en eenvoudig.

Belangrijke informatie	Bèta	Algemeen beschikbaar
API-hosteindpunt	https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/	https://graph.microsoft.com/v1.0/reports/partners/billing/usage/
HTTP-methode	POSTEN	POSTEN
Niet-gefactureerd dagelijks geclassificeerd gebruiks-API-eindpunt	https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/v1/unbilledusage	https://graph.microsoft.com/v1.0/reports/partners/billing/usage/unbilled/export
Invoerparameters voor de niet-gefactureerde dagelijkse gebruiks-API	Als u parameters in de API-aanvraag wilt opgeven, neemt u deze op in de querytekenreeks van de aanvraag-URL. Als u bijvoorbeeld de parameters periode en currencyCode wilt opgeven, voegt u deze toe aan ?period=current&currencyCode=usd de aanvraag-URL.	Als u invoer wilt opgeven, neemt u een JSON-object op in de aanvraagbody. Uw JSON moet de volgende eigenschappen hebben: * currencyCode: uw factureringsvaluta. Bijvoorbeeld USD. * billingPeriod: De factureringsperiode voor de factuur. Bijvoorbeeld huidige. Hier volgt een voorbeeld van een JSON-object dat de eigenschappen currencyCode en billingPeriod bevat:<br>{<br> "currencyCode": "USD",<br> "billingPeriod": "current"<br>}
Gefactureerd dagelijks geclassificeerd api-eindpunt voor gebruik	https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/v1/billedusage/invoices/{InvoiceId}	https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export
Invoerparameters voor de gefactureerde dagelijkse gebruiks-API	Als u parameters in de API-aanvraag wilt opgeven, neemt u de invoiceId op in de aanvraag-URL. Daarnaast kunt u een optionele fragmentparameter in de querytekenreeks opnemen om de volledige set kenmerken op te halen. Als u bijvoorbeeld de volledige set kenmerken wilt ophalen, voegt u deze toe ?fragment=full aan de aanvraag-URL.	Als u invoer wilt opgeven, neemt u een JSON-object op in de aanvraagbody. Uw JSON moet de volgende eigenschappen hebben: * invoiceId: de unieke id van de factuur. Bijvoorbeeld G00012345. * attributeSet: de kenmerken die in het antwoord moeten staan, zoals volledig. Hier volgt een voorbeeld van een JSON-object dat de eigenschappen invoiceId en attributeSet bevat: {<br> "invoiceId": "G00012345",<br> "attributeSet": "full"<br>}
Manifestresource	Gebruik een afzonderlijke METHODE GET /manifests/{id} om de manifestresource op te halen.	Gebruik de methode GET /operations/{Id} om toegang te krijgen tot de manifestresource in resourceLocation. Deze methode bespaart tijd door de noodzaak van een afzonderlijke aanroep naar GET /manifests/{id} te elimineren.
Wijzigingen in het manifestschema
	"id": niet beschikbaar	'id': een unieke id voor de manifestresource.
	"versie": Beschikbaar	"version": gewijzigd in "schemaversion.".
	"dataFormat": Beschikbaar	"dataFormat": Beschikbaar.
	"utcCretedDateTime": Beschikbaar	"utcCretedDateTime": gewijzigd in "createdDateTime.".
	"eTag": Beschikbaar	"eTag": Beschikbaar.
	"partnerTenantId": Beschikbaar	"partnerTenantId": Beschikbaar
	"rootFolder": Beschikbaar	"rootFolder": gewijzigd in "rootDirectory."
	"rootFolderSAS": Beschikbaar	'rootFolderSAS': gewijzigd in 'sasToken'. Deze update biedt alleen het token zonder het pad naar de hoofdmap. Als u de map wilt zoeken, gebruikt u in plaats daarvan de eigenschap rootDirectory.
	"partitionType": Beschikbaar	"partitionType": Beschikbaar.
	"blobCount": Beschikbaar	"blobCount": Beschikbaar.
	"sizeInBytes": Beschikbaar	"sizeInBytes": Niet beschikbaar.
	"blobs": Beschikbaar	"blobs": Beschikbaar.
	"blob-object": Beschikbaar	"blobobject": Beschikbaar.
	"name": Beschikbaar	"name": Beschikbaar.
	"partitionValue": Beschikbaar	"partitionValue": Beschikbaar.

Vergelijk de attributen van de regelitems voor dagelijkse gebruiksafstemming

Raadpleeg deze tabel om de kenmerken te vergelijken die worden geretourneerd door de gefactureerde of niet-gefactureerde gebruiksafstemmings-API voor de 'volledige' of 'basis'-kenmerksets. Zie de Velden in het bestand met dagelijkse afstemming van het geschatte gebruik voor meer informatie over deze kenmerken en hun betekenissen.

Kenmerk	Volledig	Basis
PartnerId	ja	ja
PartnerName	ja	ja
CustomerId	ja	ja
CustomerName	ja	Ja
CustomerDomainName	ja	nee
CustomerCountry	ja	nee
MpnId	ja	nee
Tier2MpnId	ja	nee
InvoiceNumber	ja	ja
Product-id	ja	ja
SkuId	ja	ja
AvailabilityId	ja	nee
SkuName	ja	ja
ProductName	ja	nee
PublisherName	ja	ja
PublisherId	ja	nee
SubscriptionDescription	ja	nee
SubscriptionId	ja	ja
ChargeStartDate	ja	ja
ChargeEndDate	ja	ja
UsageDate	ja	ja
MeterType	ja	nee
MeterCategory	ja	nee
MeterId	ja	nee
MeterSubCategory	ja	nee
MeterName	ja	nee
MeterRegion	ja	nee
Eenheid	ja	ja
ResourceLocation	ja	nee
ConsumedService	ja	nee
ResourceGroup	ja	nee
ResourceURI	ja	ja
ChargeType	ja	ja
UnitPrice	ja	ja
Hoeveelheid	ja	ja
UnitType	ja	nee
BillingPreTaxTotal	ja	ja
BillingCurrency	ja	ja
PricingPreTaxTotal	ja	ja
PricingCurrency	ja	ja
ServiceInfo1	ja	nee
ServiceInfo2	ja	nee
Tags	ja	nee
AdditionalInfo	ja	nee
EffectiveUnitPrice	ja	ja
PCToBCExchangeRate	ja	ja
PCToBCExchangeRateDate	ja	nee
EntitlementId	ja	ja
EntitlementDescription	ja	nee
PartnerEarnedCreditPercentage	ja	nee
CreditPercentage	ja	ja
CreditType	ja	ja
BenefitOrderID	ja	ja
BenefitID	ja	nee
BenefitType	ja	ja

Belangrijk

Noteer deze wijzigingen wanneer u overstapt van API v1 naar v2.

• Elke kenmerknaam begint nu met een hoofdletter letter om de consistentie met het bestand te behouden en de leesbaarheid te verbeteren.

• unitOfMeasure wordt bijgewerkt naar Unit. De betekenis en waarde blijven ongewijzigd, waardoor de kenmerknaam wordt vereenvoudigd.

• resellerMpnId is nu Tier2MpnId. De betekenis en waarde zijn hetzelfde.

• rateOfPartnerEarnedCredit wordt bijgewerkt naar PartnerEarnedCreditPercentage. De nieuwe naam en waarde weerspiegelen nu het percentage in plaats van de breuk, waardoor het gemakkelijker te begrijpen is. 0,15 is nu bijvoorbeeld 15%.

• rateOfCredit is nu CreditPercentage. Zowel de naam als de waarde zijn gewijzigd om een duidelijker begrip te bieden. 1,00 is nu bijvoorbeeld 100%.

We geloven dat deze wijzigingen ervoor zorgen dat de API's intuïtiever en eenvoudiger te gebruiken zijn.

Voorbeeldcode ophalen

Als u deze API wilt gebruiken, raadpleegt u de volgende koppeling, die C#-voorbeeldcode bevat.

Voorbeelden van partnercentrum-API' s: factureringsgegevens ophalen.