Compartir a través de

Obtener el estado de la firma directa de un cliente (aceptación directa) del Contrato de cliente de Microsoft

  • Artículo

Se aplica a: Centro de partners

No se aplica a: Centro de socios operado por 21Vianet | Centro de socios para la nube de Microsoft para el gobierno de EE. UU.

El recurso DirectSignedCustomerAgreementStatus actualmente solo es compatible con el Centro de partners en la nube pública de Microsoft.

En este artículo se explica cómo recuperar el estado de la aceptación directa de un cliente del Contrato de cliente de Microsoft.

Prerrequisitos

  • Credenciales como se describen en Autenticación del Centro de partners. Este escenario solo admite la autenticación con credenciales de App+User.

  • Identificador de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en Centro de partners seleccionando el área de trabajo Clientes, luego el cliente de la lista de clientes y, finalmente, Cuenta. En la página Cuenta del cliente, busque el id. de Microsoft en la sección información de la cuenta de cliente. El identificador de Microsoft es el mismo que el identificador de cliente (customer-tenant-id).

  • El proveedor indirecto o el asociado de factura directa deben tener una relación activa de reventa con el cliente para recuperar el estado de firma directa del contrato.

C#

Para recuperar el estado de la aceptación directa de un cliente del Contrato de cliente de Microsoft, llame al método IAggregatePartner.Customers.ById con el identificador de cliente. A continuación, use la propiedad Agreements para recuperar una interfaz ICustomerAgreementCollection. Por último, llame a GetDirectSignedCustomerAgreementStatus() o GetDirectSignedCustomerAgreementStatusAsync() para recuperar el estado.

// IAggregatePartner partnerOperations;
// string customerId;
var customerDirectSigningStatus = partnerOperations.Customers.ById(selectedCustomerId).Agreements.GetDirectSignedCustomerAgreementStatus();

Ejemplo: Aplicación de ejemplo de consola. Proyecto: Clase SdkSamples: GetDirectSignedCustomerAgreementStatus.cs

Solicitud REST

Para obtener el estado de la aceptación directa de un cliente del Contrato de cliente de Microsoft, cree una solicitud REST para recuperar DirectSignedCustomerAgreementStatus del cliente.

Sintaxis de solicitud

Use la siguiente sintaxis de solicitud:

Método URI de solicitud
GET {baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

Parámetros de URI

Puede usar los siguientes parámetros de URI con la solicitud:

Nombre Tipo Obligatorio Descripción
identificación de cliente-inquilino GUID Sí El valor es un CustomerTenantId con formato GUID que permite especificar el identificador de inquilino de un cliente.

Encabezados de solicitud

Para obtener más información, consulte Encabezados REST del Centro de partners.

Cuerpo de la solicitud

Ninguno.

Ejemplo de solicitud

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Respuesta REST

Si se ejecuta correctamente, este método devuelve un recurso DirectSignedCustomerAgreementStatus en el cuerpo de la respuesta.

El recurso tiene un propiedad isSigned que indica el estado de firma directa (aceptación directa) del cliente.

  • Un valor de verdadero indica que el cliente firmó (aceptó) directamente el contrato.

  • Un valor de false indica que el cliente no ha firmado (aceptado) directamente el contrato.

Códigos de éxito y error de respuesta

Cada respuesta incluye un código de estado HTTP que indica éxito o error y más información de depuración.

Use una herramienta de seguimiento de red para leer este código, tipo de error y otros parámetros. Para obtener la lista completa, consulte Códigos de error REST del Centro de partners.

Ejemplo de respuesta

HTTP/1.1 200 OK
Content-Length: 20
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

{"isSigned":true}