Een overdracht maken voor nieuwe commerce met behulp van REST API's van Partner center

Artikel
07/20/2024

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.

Vereisten

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: globale beheerder | Beheerderagent | Verkoopagent

REST-aanvraag

Aanvraagsyntaxis

Wijze	Aanvraag-URI
POST	{baseURL}/v1/customers/{customer-ID}/transfers HTTP/1.1

URI-parameter

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.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

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. NewCommerce moet worden gebruikt voor Abonnementen op basis van een Azure-abonnement en nieuwe commercelicentieabonnementen.

Aanvraagvoorbeeld

{
    "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": "a624f7f8-408b-49d0-9320-df79e56bed55",
    "partnertenantid": "a94dcde1-ecd7-wace-a6ef-ef73ba6b8ba5",
    "sourcePartnerName": "Test_Test_IP4_AG",
    "sourcePartnerTenantId": "a94dcde1-ecd7-4ace-a6ef-ef73ba6b8ba5",
    "targetPartnerName": "Test_Test_DB_AG",
    "targetPartnerTenantId": "817512dd-0689-47a0-bbf2-a7f11ae1fc11",
    "targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
    "transferDirection": 2,
    "ignoreEligibilityCheck": false,
    "lastModifiedUser": "1671774b-679f-4543-a152-1f8b14006c0e",
    "lineItems": [{
        "id": 0,
        "subscriptionId": "d0df8837-6db3-49d8-c2b3-1d94bc1ab42d",
        "billingCycle": "unknown",
        "quantity": 0,
        "productType": 5,
        "status": "InProgress"
    }],
    "links": {
        "self": {
            "uri": "/customers/a624f7f8-408b-49d0-9320-df79e56bed55/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
            "method": "GET",
            "headers": []
        }
    }
}

REST-antwoord

Als dit lukt, retourneert deze methode de ingevulde TransferEnity-resource in de hoofdtekst van het antwoord.

Geslaagde antwoorden en foutcodes

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.

Responsvoorbeeld

HTTP/1.1 201 Created
Content-Length: 138
Content-Type: application/json; charset=utf-8
MS-RequestId: 4fa6dad6-a89f-4875-8247-7294a10ae1cf
MS-CorrelationId: 0e93c70c-977c-4a88-9580-7cf084c73286
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": "a624f7f8-408b-49d0-9320-df79e56bed55",
"partnertenantid": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"sourcePartnerName": "Test_Test_IP4_AG",
"sourcePartnerTenantId": "a94dcde1-ecd7-4ace-a6ef-ef73ba6b8ba5",
"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/a624f7f8-408b-49d0-9320-df79e56bed55/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
        "method": "GET",
        "headers": []
    }
}
}

Share via