Condividi tramite

Confermare l'accettazione del Contratto del cliente Microsoft con le API del Centro per i partner

  • Articolo

si applica a: Partner Center

Non si applica a: Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

Il Centro per i partner supporta attualmente la conferma dell'accettazione del Contratto del cliente Microsoft solo nel cloud pubblico Microsoft.

Questo articolo descrive come confermare o riconfermare l'accettazione del Contratto del cliente Microsoft da parte del cliente.

Prerequisiti

  • Se si usa .NET SDK del Centro per i partner, è necessaria la versione 1.14 o successiva.

Importante

A partire da giugno 2023, la versione più recente di .NET SDK del Centro per i partner 3.4.0 è ora archiviata. È possibile scaricare la versione dell'SDK da GitHub, insieme a un file leggimi che contiene informazioni utili.

I partner sono invitati a continuare a usare le API REST del Centro per i partner .

  • Credenziali come descritto in autenticazione del Partner Center. Questo scenario supporta solo l'autenticazione app+utente.

  • ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo in Centro per i partner selezionando l'area di lavoro clienti, quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente, cercare il ID Microsoft nella sezione Informazioni sull'Account Cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).

  • La data (dateAgreed) in cui il cliente ha accettato l'Accordo con il cliente Microsoft.

  • Informazioni sull'utente dell'organizzazione del cliente che ha accettato il Contratto del cliente Microsoft. Sono inclusi:

    • Nome di battesimo
    • Cognome
    • Indirizzo email
    • Numero di telefono (facoltativo)

  • Se i valori seguenti cambiano per un cliente, il Centro per i partner consentirà la creazione di un altro contratto per il cliente: nome cognome Indirizzo di posta elettronica Numero di telefono. In caso contrario, i partner riceveranno il codice di errore seguente, a causa della creazione di un cliente duplicato

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

Per confermare o riconfermare l'accettazione del Contratto del cliente Microsoft da parte del cliente:

  1. Recuperare i metadati del contratto per il Contratto del cliente Microsoft. È necessario ottenere il templateId del Contratto cliente Microsoft. Per ulteriori informazioni, consulta Ottieni i metadati per il Microsoft Customer Agreement.

    // IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();

  2. Creare un nuovo oggetto contratto contenente i dettagli della conferma.

  3. Usare la raccolta IAgreggatePartner.Customers e chiamare il metodo ById con l'id-tenant-del-cliente specificato.

  4. Usare la proprietà Contratti, seguita dalla chiamata a Create o 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);

Un esempio completo è disponibile nella classe CreateCustomerAgreement dal progetto di app di test della console .

Richiesta REST

Per confermare o riconfermare l'accettazione del Contratto del cliente Microsoft da parte del cliente:

  1. Recuperare i metadati del contratto per il Contratto del cliente Microsoft. È necessario ottenere il templateId del Contratto cliente Microsoft. Per ulteriori informazioni, consulta Ottieni i metadati per il Microsoft Customer Agreement.
  2. Creare un nuovo contratto di risorsa per verificare che un cliente abbia accettato il Contratto del cliente Microsoft. Usare la seguente sintassi della richiesta REST .

Sintassi della richiesta

Metodo URI della richiesta
INSERISCI {baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

Parametro URI

Usare il parametro di query seguente per specificare il cliente che si desidera confermare.

Nome Digitare Obbligatorio Descrizione
ID cliente-inquilino GUID Sì Il valore è un customer-tenant-idformattato come GUID, che è un identificatore che consente di specificare un cliente.

Intestazioni della richiesta

Per ulteriori informazioni, vedere intestazioni REST del Partner Center.

Corpo della richiesta

Questa tabella descrive le proprietà necessarie nel corpo della richiesta REST.

Nome Digitare Descrizione
Accordo oggetto Dettagli forniti dal partner per confermare l'accettazione del Contratto del cliente Microsoft da parte del cliente.

Accordo

Questa tabella descrive i campi minimi necessari per creare una risorsa accordo.

Proprietà Tipo Descrizione
contatto principale Contatto Informazioni sull'utente dell'organizzazione del cliente che ha accettato il Contratto del cliente Microsoft, tra cui: firstName, lastName, posta elettronicae phoneNumber (facoltativo)
dateAgreed stringa di testo nel formato data e ora UTC Data in cui il cliente ha accettato il contratto.
ID del modello corda Identificatore univoco del tipo di contratto accettato dal cliente. È possibile ottenere il templateId per il Contratto del cliente Microsoft recuperando i metadati del contratto per il Contratto del cliente Microsoft. Vedere Ottenere i metadati del contratto per il Contratto del cliente Microsoft per informazioni dettagliate.
digitare corda Tipo di contratto accettato dal cliente. Usare "MicrosoftCustomerAgreement" se il cliente ha accettato il Contratto del cliente Microsoft.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, questo metodo restituisce una risorsa Accordo.

Codici di errore e esito positivo della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug.

Usare uno strumento di traccia di rete per leggere il codice, il tipo di errore e i parametri aggiuntivi. Per l'elenco completo, vedere codici di errore REST del Centro partner.

Esempio di risposta

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