Een overdracht weigeren

Notitie

Dit onderwerp is alleen van toepassing op traditionele services op basis van licenties en niet op nieuwe commerce-ervaringen. Zie het onderwerp nieuwe commerceoverdracht voor meer informatie over het overdragen van nieuwe commercelicentieabonnementen.

Vereisten

  • Referenties zoals beschreven in Partner Center-authenticatie. 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).

  • Een overdrachts-id voor een bestaande overdracht.

    Juiste rollen: Beheerdersagent | Verkoopagent

REST-aanvraag

Aanvraagsyntaxis

Wijze Aanvraag-URI
PATCH {baseURL}/v1/customers/{customer-id}/transfers/{transfer-id} HTTP/1.1

URI-parameter

Gebruik de volgende padparameter om de klant te identificeren en de overdracht op te geven die moet worden geaccepteerd.

Name Type Vereist Beschrijving
klant-id tekenreeks Ja Een GUID-geformatteerde klant-ID die de klant identificeert.
transfer-id tekenreeks Ja Een met GUID opgemaakte overdrachts-id die de overdracht 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.

Eigendom Type Vereist Beschrijving
id tekenreeks Nee Een transferEntity-identificator die wordt verstrekt na succesvolle creatie van de transferEntity.
status tekenreeks Nee De status van de transferentiteit. Als u een overdracht wilt weigeren, moet de waarde worden ingesteld als 'weigeren'

Aanvraagvoorbeeld

PATCH /v1/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/ac4a9d22-ba07-444e-890f-cfe084eed498 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 5b46e795-b661-428e-a2e7-f208b8d0d25c
Connection: keep-alive
Content-Length: 63

{"id":"ac4a9d22-ba07-444e-890f-cfe084eed498","status":"reject"}

REST-antwoord

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

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of het succesvol of mislukt is, samen met aanvullende foutopsporingsinformatie. 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 200 OK
Content-Length: 1069
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 5b46e795-b661-428e-a2e7-f208b8d0d25c
X-Locale: en-US
Date: Fri, 27 Mar 2020 17:50:33 GMT

{
  "id": "ac4a9d22-ba07-444e-890f-cfe084eed498",
  "status": "Reject",
  "createdTime": "2020-03-25T22:05:25.1057725Z",
  "lastModifiedTime": "2020-03-27T17:50:32Z",
  "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
  "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
  "sourcePartnerName": "Test_Test_09092019GBL",
  "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "targetPartnerName": "Test_Test_09032019GBL",
  "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
  "lastModifiedUser": "01a7548d-1136-4cf0-ba9a-300f921ffb22",
  "lineItems": [
    {
      "id": 0,
      "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "offerId": "13D32E13-A1B0-400D-96C0-4EAAA14DCED5",
      "billingCycle": "monthly",
      "friendlyName": "Dynamics 365 for Supply Chain Management Attach to Qualifying Dynamics 365 Base Offer (Qualified Offer)",
      "quantity": 20,
      "partnerIdOnRecord": "5139005",
      "addonItems": [

      ]
    }
  ],
  "links": {
    "self": {
      "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/ac4a9d22-ba07-444e-890f-cfe084eed498",
      "method": "GET",
      "headers": [

      ]
    }
  },
  "attributes": {
    "objectType": "TransferEntity"
  }
}
  • Last updated on