Confirmar la aceptación del cliente del Contrato de cliente de MicrosoftConfirm customer acceptance of Microsoft Customer Agreement

Se aplica a:Applies to:

  • Centro de partnersPartner Center

Actualmente, el Centro de partners solo admite la confirmación de la aceptación por parte del cliente del Contrato de cliente de Microsoft en la nube pública de Microsoft.Partner Center currently supports confirmation of customer acceptance of the Microsoft Customer Agreement only in the Microsoft public cloud. Esta funcionalidad no se aplica actualmente a lo siguiente:This functionality doesn't currently apply to:

  • Centro de partners operado por 21VianetPartner Center operated by 21Vianet
  • Centro de partners para Microsoft Cloud AlemaniaPartner Center for Microsoft Cloud Germany
  • Centro de partners para Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Obtén información sobre cómo confirmar la aceptación por parte del cliente del Contrato de cliente de Microsoft.This article describes how to confirm or re-confirm customer acceptance of the Microsoft Customer Agreement.

Requisitos previosPrerequisites

  • Si usas el SDK de .NET del Centro de partners, se requiere la versión 1.14 o posterior.If you are using the Partner Center .NET SDK, version 1.14 or newer is required.

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners.Credentials as described in Partner Center authentication. Este escenario solo es compatible con la autenticación con el usuario y la aplicación.This scenario only supports App+User authentication.

  • Un id. de cliente (customer-tenant-id).A customer ID (customer-tenant-id). Si no conoces el identificador del cliente, puedes buscarlo en el panel del Centro de partners.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Selecciona CSP en el menú del Centro de partners, seguido de Clientes.Select CSP from the Partner Center menu, followed by Customers. En la lista de clientes, selecciona el cliente y, a continuación, elige Cuenta.Select the customer from the customer list, then select Account. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. El identificador de Microsoft es el mismo que el de cliente (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • La fecha (dateAgreed) del momento en que el cliente aceptó el Contrato de cliente de Microsoft.The date (dateAgreed) when the customer accepted the Microsoft Customer Agreement.

  • Información sobre el usuario de la organización del cliente que aceptó el Contrato de cliente de Microsoft.Information about the user from the customer organization that accepted the Microsoft Customer Agreement. Esto incluye:This includes:

    • NombreFirst name
    • ApellidoLast name
    • Dirección de correo electrónicoEmail address
    • Número de teléfono (opcional)Phone number (optional)

.NET.NET

Para confirmar o volver a confirmar la aceptación por parte del cliente del Contrato de cliente de Microsoft:To confirm or re-confirm customer acceptance of the Microsoft Customer Agreement:

  1. Recupera los metadatos del Contrato de cliente de Microsoft.Retrieve the agreement metadata for the Microsoft Customer Agreement. Debes obtener el valor de templateId del Contrato de cliente de Microsoft.You must obtain the templateId of the Microsoft Customer Agreement. Para obtener más información, consulta Obtención de los metadatos del Contrato de cliente de Microsoft.For more details, see Get agreement metadata for Microsoft Customer Agreement.

    // IAggregatePartner partnerOperations;
    
    string agreementType = "MicrosoftCustomerAgreement";
    
    var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();
    
  2. Crea un nuevo objeto Agreement que contenga los detalles de la confirmación.Create a new Agreement object containing details of the confirmation.

  3. Usa la colección IAgreggatePartner.Customers y llama al método ById con el elemento customer-tenant-id especificado.Use the IAgreggatePartner.Customers collection and call the ById method with the specified customer-tenant-id.

  4. Usa la propiedad Agreements, seguida de una llamada a Create o CreateAsync.Use the Agreements property, followed by calling Create or 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);
    

Se puede encontrar un ejemplo completo en la clase CreateCustomerAgreement del proyecto de la aplicación de prueba de la consola.A complete sample can be found in the CreateCustomerAgreement class from the console test app project.

Solicitud RESTREST request

Para confirmar o volver a confirmar la aceptación por parte del cliente del Contrato de cliente de Microsoft:To confirm or re-confirm customer acceptance of the Microsoft Customer Agreement:

  1. Recupera los metadatos del Contrato de cliente de Microsoft.Retrieve the agreement metadata for the Microsoft Customer Agreement. Debes obtener el valor de templateId del Contrato de cliente de Microsoft.You must obtain the templateId of the Microsoft Customer Agreement. Para obtener más información, consulta Obtención de los metadatos del Contrato de cliente de Microsoft.For more details, see Get agreement metadata for Microsoft Customer Agreement.

  2. Crea un nuevo recurso Agreement para confirmar que un cliente ha aceptado el Contrato de cliente de Microsoft.Create a new Agreement resource to confirm that a customer has accepted the Microsoft Customer Agreement. Usa la siguiente sintaxis de solicitud de REST.Use the following REST request syntax.

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
POSTPOST {baseURL} /v1/customers/{customer-tenant-id}/agreements HTTP/1.1{baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

Parámetro de URIURI parameter

Usa el siguiente parámetro de consulta para especificar al cliente tu confirmación.Use the following query parameter to specify the customer that you're confirming.

NombreName TipoType RequeridoRequired DescripciónDescription
customer-tenant-idcustomer-tenant-id GUIDGUID Yes El valor es un elemento customer-tenant-id con formato de GUID, que es un identificador que te permite especificar un cliente.The value is a GUID-formatted customer-tenant-id, which is an identifier that allows you to specify a customer.

Encabezados de solicitudRequest headers

Para obtener más información, consulta Encabezados REST del Centro de partners.For more information, see Partner Center REST headers.

Cuerpo de la solicitudRequest body

En esta tabla se describen las propiedades necesarias del cuerpo de la solicitud REST.This table describes the required properties in the REST request body.

NombreName TipoType DescripciónDescription
ContratoAgreement objectobject Detalles que proporciona el partner para confirmar la aceptación por parte del cliente del Contrato de cliente de Microsoft.Details provided by partner to confirm customer acceptance of the Microsoft Customer Agreement.

ContratoAgreement

En esta tabla se describen los campos obligatorios mínimos para crear un recurso Agreement.This table describes the minimum required fields to create an Agreement resource.

PropiedadProperty TipoType DescripciónDescription
primaryContactprimaryContact ContactContact Información sobre el usuario de la organización del cliente que aceptó el Contrato de cliente de Microsoft, que incluye lo siguiente: firstName, lastName, email and phoneNumber (opcional).Information about the user from the customer organization who accepted the Microsoft Customer Agreement, including: firstName, lastName, email and phoneNumber (optional)
dateAgreeddateAgreed cadena en formato de fecha y hora UTCstring in UTC date time format Fecha en la que el cliente aceptó el contrato.The date when the customer accepted the agreement.
templateIdtemplateId cadenastring Identificador único del tipo de contrato aceptado por el cliente.Unique identifier of the agreement type accepted by the customer. Puedes obtener el valor de templateId para el Contrato de cliente de Microsoft mediante la recuperación de los metadatos del Contrato del cliente de Microsoft.You can obtain the templateId for Microsoft Customer Agreement by retrieving the agreement metadata for Microsoft Customer Agreement. Para obtener información, consulta Obtención de los metadatos del Contrato de cliente de Microsoft.See Get agreement metadata for Microsoft Customer Agreement for details.
tipotype cadenastring Tipo de contrato aceptado por el cliente.Agreement type accepted by the customer. Usa "MicrosoftCustomerAgreement" si el cliente aceptó el Contrato de cliente de Microsoft.Use "MicrosoftCustomerAgreement" if customer accepted the Microsoft Customer Agreement.

Ejemplo de solicitudRequest example

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: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}

Respuesta RESTREST response

Si se realiza correctamente, este método devuelve un recurso Agreement.If successful, this method returns an Agreement resource.

Códigos de error y de respuesta correctosResponse success and error codes

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional.Each response comes with an HTTP status code that indicates success or failure and additional debugging information.

Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, error type, and additional parameters. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.For the full list, see Partner Center REST error codes.

Ejemplo de respuestaResponse example

HTTP/1.1 201 Created
Content-Length: 261
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "userId": "3d6f2c09-eb40-48ca-a4b3-d24c9c007531",
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}