Potvrzení přijetí smlouvy se zákazníkem Microsoftu pomocí rozhraní API Partnerského centra

platí pro: Partnerské centrum

Nevztahuje se na: Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Partnerské centrum v současné době podporuje potvrzení přijetí smlouvy se zákazníkem Microsoftu pouze ve veřejném cloudu Microsoftu.

Tento článek popisuje, jak potvrdit nebo znovu potvrdit přijetí smlouvy se zákazníkem Microsoftu.

• Pokud používáte sadu .NET SDK partnerského centra, vyžaduje se verze 1.14 nebo novější.

• Přihlašovací údaje, jak jsou popsány v ověřování Partnerského centra. Tento scénář podporuje pouze ověřování aplikací a uživatelů.

• ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v partnerském centru tak, že vyberete pracovní prostor Zákazníci, pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v sekci Informace o zákaznickém účtu. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

• Datum (dateAgreed), kdy zákazník přijal Dohodu se zákazníkem společnosti Microsoft.

• Informace o uživateli z organizace zákazníka, která přijala smlouvu se zákazníkem Microsoftu. To zahrnuje:

  • Křestní jméno
  • Příjmení
  • E-mailová adresa
  • Telefonní číslo (volitelné)

• Pokud se pro zákazníka změní následující hodnoty, Partnerské centrum umožní vytvoření jiné smlouvy pro tohoto zákazníka: Telefonní číslo e-mailové adresy příjmení Jméno– Jinak partneři obdrží následující kód chyby, protože se vytvoří duplicitní zákazník.

{
"code": 600061,
"message": "A partner confirmed agreement already exists for the customer.",
"description": "A partner confirmed agreement already exists for the customer.",
"errorName": "PartnerConfirmedAgreementAlreadyExists",
"isRetryable": false,
"parameters": {},
"errorMessageExtended": "InternalErrorCode=600061"
}

Pro potvrzení nebo znovu potvrzení přijetí Smlouvy zákazníka Microsoftu:

1. Načtěte metadata smlouvy pro smlouvu se zákazníkem Microsoftu. Musíte získat templateId ze smlouvy společnosti Microsoft pro zákazníky. Další informace najdete v tématu Získání metadat smlouvy pro smlouvu se zákazníkem Microsoftu.

   // IAggregatePartner partnerOperations;
   
   string agreementType = "MicrosoftCustomerAgreement";
   
   var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();
   

2. Vytvořte nový Agreement objekt obsahující podrobnosti potvrzení.

3. Použijte kolekci IAggregatePartner.Customers a volejte metodu ById se zadaným identifikátorem zákaznického tenanta.

4. Použijte vlastnost Smlouvy a následně zavolejte Create nebo CreateAsync.

   // string selectedCustomerId;
   
   var agreementToCreate = new Agreement
   {
       DateAgreed = DateTime.UtcNow,
       TemplateId = microsoftCustomerAgreementDetails.TemplateId,
       PrimaryContact = new Contact
       {
           FirstName = "Tania",
           LastName = "Carr",
           Email = "someone@example.com",
           PhoneNumber = "1234567890"
       }
   };
   
   Agreement agreement = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Create(agreementToCreate);
   

Kompletní ukázku najdete ve třídě CreateCustomerAgreement projektu testovací konzolové aplikace.

Pro potvrzení nebo opětovné potvrzení přijetí zákazníkem Microsoft Smlouvy se zákazníkem:

1. Získejte metadata smlouvy Microsoft Customer Agreement. Musíte získat templateId smlouvy se zákazníkem Microsoftu. Další informace najdete v tématu Získání metadat smlouvy pro smlouvu se zákazníkem Microsoftu.
2. Vytvořte novou smlouvu prostředku, abyste potvrdili, že zákazník přijal smlouvu se zákazníkem Microsoftu. Použijte následující syntaxi požadavku REST .

Pomocí následujícího parametru dotazu určete zákazníka, kterého potvrzujete.

Další informace najdete v tématu hlavičky REST Partnerského centra.

Tato tabulka popisuje požadované vlastnosti v textu požadavku REST.

Tato tabulka popisuje minimální požadovaná pole pro vytvoření smlouvy prostředku.

POST https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements HTTP/1.1
Authorization: Bearer <token>
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}

V případě úspěchu tato metoda vrátízdroj smlouvy.

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění.

Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu kódy chyb ROZHRANÍ REST v Partnerském centru.

HTTP/1.1 201 Created
Content-Length: 261
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "userId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}