Een overdracht maken voor verouderde abonnementen

Artikel
05/08/2024

Notitie

In dit artikel wordt alleen beschreven hoe verouderde abonnementen worden overgedragen. Zoals eerder aangekondigd, moeten CSP-partners hun abonnementen migreren naar nieuwe commerce. Stappen voor partneroverdracht voor nieuwe commerce-abonnementen vindt u in het onderwerp onderwerp nieuwe commerceabonnementen overdragen.

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 | Beheer agent | 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 hoofdtekst van de aanvraag beschreven.

Eigenschap	Type	Vereist	Beschrijving
Id	tekenreeks	Nee	Een transferEntity-id die wordt opgegeven bij het maken van de transferEntity
createdTime	Datum en tijd	Nee	De datum waarop de transferEntity is gemaakt, in datum-tijdnotatie. Toegepast bij het maken van de overdrachtEntity
lastModifiedTime	Datum en tijd	Nee	De datum waarop de transferEntity voor het laatst is bijgewerkt, in datum-tijdnotatie. Toegepast bij het maken van de overdrachtEntity
lastModifiedUser	tekenreeks	Nee	De gebruiker die de transferEntity het laatst heeft bijgewerkt. Toegepast bij het maken van transferEntity
customerName	tekenreeks	Nee	Optioneel. De naam van de klant waarvan de abonnementen worden overgedragen
customerTenantId	tekenreeks	Nee	Een door DE GUID opgemaakte klant-id waarmee de klant wordt geïdentificeerd. Toegepast bij het maken van de overdrachtEntity
partnertenantid	tekenreeks	Nee	Een met GUID opgemaakte partner-id waarmee de partner wordt geïdentificeerd
sourcePartnerName	tekenreeks	Nee	Optioneel. De naam van de organisatie van de partner die de overdracht initieert
sourcePartnerTenantId	tekenreeks	Ja	Een met GUID opgemaakte partner-id waarmee de partner wordt geïdentificeerd die de overdracht initieert
targetPartnerName	tekenreeks	Nee	Optioneel. De naam van de organisatie van de partner aan wie de overdracht is gericht
targetPartnerTenantId	tekenreeks	Ja	Een met GUID opgemaakte partner-id die de partner identificeert aan wie de overdracht is gericht
lineItems	Matrix van objecten	Ja	Een matrix van TransferLineItem-resources
status	tekenreeks	Nee	De status van de transferEntity. Mogelijke waarden zijn Actief (kan worden verwijderd/verzonden) en Voltooid (is al voltooid). Toegepast bij het maken van de transferEntity.

In deze tabel worden de eigenschappen TransferLineItem in de hoofdtekst van de aanvraag beschreven.

Eigenschap	Type	Vereist	Beschrijving
Id	tekenreeks	Nee	Een unieke id voor een overdrachtsregelitem. Toegepast bij het maken van de transferEntity.
subscriptionId	tekenreeks	Ja	De abonnements-id
quantity	int	Nee	Het aantal licenties of exemplaren
billingCycle	Object	Nee	Het type factureringscyclus dat is ingesteld voor de huidige periode
Friendlyname	tekenreeks	Nee	Optioneel. De beschrijvende naam voor het item dat door de partner is gedefinieerd om te helpen ondubbelzinnig te zijn
partnerIdOnRecord	tekenreeks	Nee	PartnerID on Record (voorheen MPN-id) bij de aankoop die plaatsvindt wanneer de overdracht wordt geaccepteerd
offerId	tekenreeks	Nee	De aanbiedings-id
addonItems	Lijst met TransferLineItem-objecten	Nee	Een verzameling transferEntity-regelitems voor invoegtoepassingen die worden overgedragen, samen met het basisabonnement dat wordt overgedragen. Toegepast bij het maken van de transferEntity.
transferError	tekenreeks	Nee	Toegepast nadat transferEntity is geaccepteerd als er een fout optreedt
status	tekenreeks	Nee	De status van de lineitem in de transferEntity

Aanvraagvoorbeeld

POST /v1/customers/d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d/transfers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 4fa6dad6-a89f-4875-8247-7294a10ae1cf
MS-CorrelationId: 0e93c70c-977c-4a88-9580-7cf084c73286
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Expect: 100-continue

{
    "sourcePartnerTenantId": "da6c51b5-1246-4a42-b4ab-cbf38df54537",
    "targetPartnerTenantId": "656218b1-80c9-40b2-83ae-3a2703b55271",
    "lineItems": [
        {
            "subscriptionId": "7291BFBF-1772-4C5B-A624-18B6152CD8CB",
            "partnerIdOnRecord": "517285"
        },
        {
            "subscriptionId": "6C0B221B-8DF9-4F4A-A5BB-4C9CBB7B27B0",
            "partnerIdOnRecord": "517285"
        }
    ]
}

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 de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende 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": "67c5b05b-09b5-47ba-9047-5056fe2afa4f",
    "status": "Active",
    "createdTime": "2020-03-24T20:44:14.9602781Z",
    "lastModifiedTime": "2020-03-24T20:44:15Z",
    "customerTenantId": "823c6c3f-9259-4d51-bae2-5dd06743177f",
    "partnertenantid": "da6c51b5-1246-4a42-b4ab-cbf38df54537",
    "sourcePartnerTenantId": "da6c51b5-1246-4a42-b4ab-cbf38df54537",
    "targetPartnerTenantId": "656218b1-80c9-40b2-83ae-3a2703b55271",
    "lastModifiedUser": "d0648481-b615-45c9-8cd1-ff87940dbdc4",
    "lineItems": [
        {
            "id": 0,
            "subscriptionId": "7291BFBF-1772-4C5B-A624-18B6152CD8CB",
            "offerId": "50E9A47A-7B4D-4970-9D90-CAE927F53753",
            "billingCycle": "annual",
            "friendlyName": "Dynamics 365 for Sales Enterprise Attach to Qualifying Dynamics 365 Base Offer",
            "quantity": 1,
            "addonItems": [
                {
                    "id": 0,
                    "subscriptionId": "D738C6C9-DDBD-46E9-B316-65F9D9B3ECB4",
                    "offerId": "2BCF9FE8-8B65-4FCF-9240-419203FB8CF4",
                    "billingCycle": "annual",
                    "friendlyName": "Dynamics 365 - Additional Production Instance (Qualified Offer)",
                    "quantity": 4
                }
            ]
        },
        {
            "id": 0,
            "subscriptionId": "6C0B221B-8DF9-4F4A-A5BB-4C9CBB7B27B0",
            "offerId": "455DDD41-32ED-4E2D-B3A2-BBCB22CAA467",
            "billingCycle": "annual",
            "friendlyName": "Dynamics 365 Customer Engagement Plan Patch",
            "quantity": 8,
            "addonItems": []
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/823c6c3f-9259-4d51-bae2-5dd06743177f/transfers/67c5b05b-09b5-47ba-9047-5056fe2afa4f",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "TransferEntity"
    }
}

Delen via