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 nu stroomlijnen.
De nieuwe commerce-API's voor het dagelijks beoordelen van gebruik maken gebruik van geavanceerde technieken zoals valetsleutel en asynchrone aanvraag-antwoordpatronen . 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.
Onze API's gebruiken geoptimaliseerde technieken om uw efficiëntie te verbeteren, zodat u sneller resultaten kunt bereiken met minder inspanning. Gebruik deze API's om uw gegevenstoegang te vereenvoudigen en uw algehele efficiëntie te verbeteren.
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 alleen nu gebruiken voor de openbare/wereldwijde MS Graph-cloud. Ze zijn nog niet beschikbaar voor Azure Government of Azure China 21Vianet.
Belangrijk
Volg deze koppeling om uw app toegang te geven tot factureringsgegevens van partners en vertrouwd te raken met de basisbeginselen voor verificatie en autorisatie voor Microsoft Graph.
U kunt de machtiging PartnerBilling.Read.All toewijzen met behulp van de Azure-portal of het Entra-beheercentrum. U doet dit als volgt:
- Registreer uw app op de startpagina van Microsoft Entra onder de sectie App-registraties.
- Als u de benodigde machtigingen wilt verlenen, gaat u naar de pagina Microsoft Entra App in de sectie API-machtigingen. Selecteer Een machtiging toevoegen en kies het bereik PartnerBilling.Read.All.
Door deze stappen uit te voeren, moet u ervoor zorgen dat uw app beschikt over de vereiste toegang tot factureringsgegevens van partners.
Notitie
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.
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
API-overzicht
Om u te helpen bij het ophalen van gefactureerde nieuwe commerce dagelijks geclassificeerde gebruiksregelitems asynchroon, bieden we twee belangrijke API-eindpunten. Hier volgt een gestroomlijnde handleiding om u op weg te helpen:
Eindpunt van gebruiksregelitem
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.
Eindpunt van bewerkingsstatus
Controleer vervolgens 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.
Door deze stappen te volgen, kunt u uw factuurafstemmingsproces efficiënt beheren.
Sequentiediagram
Hier volgt een sequentiediagram met de stappen voor het downloaden van de afstemmingsgegevens.
Gebruikersactiereeks
Voer de volgende stappen uit om nieuwe artikelen voor het dagelijks beoordelen van gebruiksafstemming op te halen:
Stap 1: 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 nauwkeurige gegevens te garanderen, kunt u maximaal 24 uur voor beschikbaarheid zorgen. 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. Soms ziet u mogelijk niet de meest recente niet-gefactureerde dagelijkse gebruiksgegevens totdat de gefactureerde gebruiksgegevens van de vorige maand beschikbaar zijn. Zodra u de gefactureerde gebruiksgegevens ontvangt, kunt u alle bijgewerkte niet-gefactureerde gebruiksgegevens ophalen vanaf het begin van de maand.
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 | Gebruik 'current' of 'last' (hetzelfde als 'vorige' in de v1-API) om het dagelijkse geschatte gebruik voor de huidige of laatste kalendermaand of factureringsperiode op te halen. 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 | Beschrijving |
|---|---|
| 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 Statussen voor andere mogelijke statussen op basis van uw aanvragen.
| Code | Beschrijving |
|---|---|
| 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. |
Stap 2: Status van aanvraag controleren
Als u de status van een aanvraag wilt bijhouden, moet u ervoor zorgen dat u een HTTP 200-antwoord ontvangt dat '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
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 | Beschrijving |
|---|---|
| 410 – Weg | 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 | Beschrijving |
|---|---|---|
| id | Waar | Een unieke id voor elk antwoord. Vereist. |
| status | Waar | Waarden en acties: vereist: notstarted: Wacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na' en voer vervolgens nog een aanroep uit om de status te controleren. wordt uitgevoerd: Wacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na' en voer vervolgens een andere 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 | Beschrijving |
|---|---|
| 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. Stel geen vast aantal regelitems of bestandsgrootte in de code in, omdat deze waarden 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, 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": "0e195b37-4574-4539-bc42-0e539b9684c0",
"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"
}
\]
}
}
Stap 3: Regelitems voor dagelijkse afstemming van gebruiksgegevens downloaden uit Azure Blob Storage
Eerst moet u het SAS-token (Shared Access Signature) en de blobopslaglocatie ophalen. U vindt deze details in de eigenschappen 'sasToken' en 'rootDirectory' van het antwoord van de payload-API van het manifest. Gebruik vervolgens de Azure Storage SDK/het hulpprogramma om 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.
Standaard-API-antwoordstatussen
Mogelijk ontvangt u deze HTTP-statussen van het API-antwoord:
| Code | Beschrijving |
|---|---|
| 400 – Ongeldige aanvraag | De aanvraag ontbreekt of bevat onjuiste gegevens. Controleer de hoofdtekst van het antwoord op foutdetails. |
| 401 - Niet geautoriseerd | 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 – Weg | 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 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 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¤cyCode=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. |
Kenmerken van het dagelijkse afstemmingslijnitem voor gebruik
Raadpleeg de volgende tabel om de kenmerken te vergelijken die worden geretourneerd door de gefactureerde factuurafstemmings-API voor de 'volledige' of 'basis'-kenmerksets. Raadpleeg deze documentatie voor meer informatie over deze kenmerken.
| 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 van v2.
Elke kenmerknaam begint nu met een hoofdletter .
unitOfMeasure wordt bijgewerkt naar Unit. De betekenis en waarde blijven ongewijzigd.
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. 0,15 is nu bijvoorbeeld 15%.
rateOfCredit is nu CreditPercentage. Zowel de naam als de waarde zijn gewijzigd. 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
Als u deze API wilt gebruiken, raadpleegt u de volgende koppeling, die C#-voorbeeldcode bevat.
Voorbeelden van partnercentrum-API' s: factureringsgegevens ophalen.