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

Článek
08/02/2024

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í Smlouva se zákazníkem Microsoftu zákazníka pouze ve veřejném cloudu Microsoftu.

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

Předpoklady

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

Důležité

Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Vydání sady SDK si můžete stáhnout z GitHubu spolu se souborem readme, který obsahuje užitečné informace.

Doporučujeme, aby partneři dál používali rozhraní REST API Partnerského centra.

Přihlašovací údaje popsané v ověřování v Partnerském centru 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 části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).
Datum (dateAgreed), kdy zákazník přijal Smlouva se zákazníkem Microsoftu.
Informace o uživateli z organizace zákazníka, která přijala Smlouva se zákazníkem Microsoftu Sem patří:
- Křestní jméno
- Příjmení
- E-mailová adresa
- Telefon čí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: E-mailová adresa příjmení jméno Telefon číslo, 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"
}

.NET

Potvrzení nebo potvrzení přijetí Smlouva se zákazníkem Microsoftu zákazníkem:

Načtěte metadata smlouvy pro Smlouva se zákazníkem Microsoftu. Je nutné získat id šablony Smlouva se zákazníkem Microsoftu. Další informace najdete v tématu Získání metadat smlouvy pro Smlouva se zákazníkem Microsoftu.
```
// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();
```
Vytvořte nový objekt smlouvy obsahující podrobnosti o potvrzení.
Použijte kolekci IAgreggatePartner.Customers a volejte metodu ById se zadaným ID tenanta zákazníka.

Použijte vlastnost Agreements následovanou voláním 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 z projektu testovací aplikace konzoly.

Požadavek REST

Potvrzení nebo potvrzení přijetí Smlouva se zákazníkem Microsoftu zákazníkem:

Načtěte metadata smlouvy pro Smlouva se zákazníkem Microsoftu. Je nutné získat id šablony Smlouva se zákazníkem Microsoftu. Další informace najdete v tématu Získání metadat smlouvy pro Smlouva se zákazníkem Microsoftu.
Vytvořte nový prostředek smlouvy, abyste potvrdili, že zákazník přijal Smlouva se zákazníkem Microsoftu. Použijte následující syntaxi požadavku REST.

Syntaxe požadavku

metoda	Identifikátor URI žádosti
POST	{baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

Parametr identifikátoru URI

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

Name	Typ	Požaduje se	Popis
customer-tenant-id	Identifikátor GUID	Ano	Hodnota je IDENTIFIKÁTOR GUID formátovaný id tenanta zákazníka, což je identifikátor, který umožňuje zadat zákazníka.

Záhlaví žádosti

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

Text požadavku

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

Name	Typ	Popis
Smlouva	objekt	Podrobnosti poskytnuté partnerem k potvrzení přijetí Smlouva se zákazníkem Microsoftu zákazníkem

Smlouva

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

Vlastnost	Typ	Popis
primaryContact	Kontakt	Informace o uživateli z organizace zákazníka, který přijal Smlouva se zákazníkem Microsoftu, včetně: firstName, lastName, email a phoneNumber (volitelné)
dateAgreed	řetězec ve formátu data a času UTC	Datum, kdy zákazník smlouvu přijal.
templateId	řetězec	Jedinečný identifikátor typu smlouvy přijatého zákazníkem. Id šablony pro Smlouva se zákazníkem Microsoftu můžete získat načtením metadat smlouvy pro Smlouva se zákazníkem Microsoftu. Podrobnosti najdete v tématu Získání metadat smlouvy pro Smlouva se zákazníkem Microsoftu.
type	řetězec	Typ smlouvy přijal zákazník. Pokud zákazník přijal Smlouva se zákazníkem Microsoftu, použijte MicrosoftCustomerAgreement.

Příklad požadavku

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"
}

Odpověď REST

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

Kódy úspěšnosti a chyb odpovědi

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 REST v Partnerském centru.

Příklad odpovědi

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"
}

Sdílet prostřednictvím