Een overdracht maken voor nieuwe commerce met behulp van REST API's van Partner center
Partners kunnen nieuwe commerce-abonnementen overdragen van de ene transacterende partner naar de andere. Een doelpartner maakt de overdrachtsaanvraag. De bronpartner werkt de overdracht bij met regelitemgegevens. In dit onderwerp wordt uitgelegd welke API een doelpartner zou aanroepen om de overdrachtsaanvraag te maken. Dit onderwerp is alleen relevant voor reserveringen, spaarplannen en abonnementen en nieuwe abonnementen op basis van commercelicenties. Meer waardevolle informatie vindt u in de documentatie voor het overdragen van abonnementen.
Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
Een klant-id (
customer-tenant-ID
). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-ID
).Juiste rollen: Beheerdersagent
Wijze | Aanvraag-URI |
---|---|
POST | {baseURL}/v1/customers/{customer-ID}/transfers HTTP/1.1 |
Gebruik de volgende padparameter om de klant te identificeren.
Name | Type | Vereist | Beschrijving |
---|---|---|---|
klant-id | tekenreeks | Ja | Een door DE GUID opgemaakte klant-id die de klant identificeert. |
Zie Rest-headers in Partnercentrum voor meer informatie.
In deze tabel worden de eigenschappen van TransferEntity in de aanvraagbody beschreven voor het maken van een nieuwe commerce-overdrachtsaanvraag.
Eigenschap | Type | Vereist | Beschrijving |
---|---|---|---|
sourcePartnerTenantId | tekenreeks | Ja | Een met GUID opgemaakte partner-id waarmee de partner wordt geïdentificeerd die de overdracht initieert. |
sourcePartnerName | tekenreeks | Ja | De naam van de organisatie van de partner die de overdracht initieert. |
customerEmailId | tekenreeks | Ja | Een tekenreeks van de klant om meldingen te ontvangen van het maken van de overdracht. |
customerName | tekenreeks | Nee | Optioneel. De naam van de klant van wie de abonnementen worden overgedragen. |
targetPartnerTenantId | tekenreeks | Nee | Een tenant-id met GUID-indeling voor partners waarmee de partner wordt geïdentificeerd waarop de overdracht is gericht. De autorisatiecontext van de partner wordt omgezet in de tenant-id van de partner als u dit weglaat. |
targetPartnerEmailId | tekenreeks | Nee | Een tenant-id met GUID-indeling voor partners waarmee de partner wordt geïdentificeerd waarop de overdracht is gericht. De autorisatiecontext van de partner wordt omgezet in de tenant-id van de partner als u dit weglaat. |
transferType | tekenreeks | Ja | Een tekenreeks die het type overdracht definieert. 3 vertegenwoordigt NewCommerce en moet worden gebruikt voor abonnementen op basis van een Azure-abonnement en nieuwe commercelicenties. |
{
"id": "43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"status": "InProgress",
"transferType": 3,
"customerEmailId": "",
"createdTime": "2024-04-30T18:31:41.5133355Z",
"lastModifiedTime": "2024-05-01T00:51:55Z",
"expirationTime": "2024-05-31T00:00:00Z",
"customerName": "ipdbtrans2",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"partnertenantid": "a94dcde1-ecd7-wace-a6ef-ef73ba6b8ba5",
"sourcePartnerName": "Test_Test_IP4_AG",
"sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"targetPartnerName": "Test_Test_DB_AG",
"targetPartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"transferDirection": 2,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "1671774b-679f-4543-a152-1f8b14006c0e",
"lineItems": [{
"id": 0,
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"billingCycle": "unknown",
"quantity": 0,
"productType": 5,
"status": "InProgress"
}],
"links": {
"self": {
"uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"method": "GET",
"headers": []
}
}
}
Als dit lukt, retourneert deze methode de ingevulde TransferEnity-resource in de hoofdtekst van het antwoord.
Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het succes of de fout optreedt en meer informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en meer parameters te lezen. Zie Foutcodes voor de volledige lijst.
HTTP/1.1 201 Created
Content-Length: 138
Content-Type: application/json; charset=utf-8
MS-RequestId: 4fa6dad6-a89f-4875-8247-7294a10ae1cf
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US,en-US
{
"id": "43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"status": "Pending",
"transferType": 3,
"customerEmailId": "",
"createdTime": "2024-04-30T18:31:41.5133355Z",
"lastModifiedTime": "2024-04-30T18:31:41Z",
"expirationTime": "2024-05-31T00:00:00Z",
"customerName": "ipdbtrans2",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"partnertenantid": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"sourcePartnerName": "Test_Test_IP4_AG",
"sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"targetPartnerName": "Test_Test_DB_AG",
"targetPartnerTenantId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"transferDirection": 1,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "7ffdaa28-3b1c-4a61-b580-e1aa6ecf833c",
"links": {
"self": {
"uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"method": "GET",
"headers": []
}
}
}