Recuperar el estado de validación de un cliente

Un asociado puede recuperar el estado de una validación del cliente a petición.

Requisitos previos

• Credenciales establecidas como se describe en Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.

• Un identificador de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners seleccionando el área de trabajo Clientes , luego el cliente de la lista de clientes y, a continuación , Cuenta. En la página Cuenta del cliente, busque el identificador 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).

C#

Para recuperar el estado de validación de un cliente para su cuenta, cree primero una enumeración que represente validationType que se va a recuperar. A continuación, llame al método IAggregatePartner.Customers.ById con el identificador de cliente. A continuación, use la propiedad ValidationStatus para recuperar una interfaz IValidationStatus. Por último, llame a GetValidationStatus() o GetValidationStatusAsync() con la variable de enumeración de tipo de validación como parámetro de entrada.

var validationTypeToFetch = ValidationType.Account;
var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).ValidationStatus.GetValidationStatus(validationTypeToFetch);

Ejemplo: Aplicación de ejemplo de consola. Project: SdkSamples (Clase): GetValidationStatus.cs

Solicitud REST

Sintaxis de la solicitud

Método	URI
GET	{baseURL}/v1/customers/{customer-id}/validationStatus?type=account

Parámetro de URI

Use el siguiente parámetro de consulta para especificar el cliente para el que está recuperando el estado de validación.

Nombre	Type	Obligatorio	Descripción
{customer-id}	guid	Y	El valor es un GUID con formato CustomerTenantId que permite especificar un cliente.
type	cadena	Y	Tipo de estado de validación que se va a recuperar.

Encabezados de solicitud

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

Respuesta REST

Cada respuesta incluye un código de estado HTTP que indica éxito o error y otra 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, consulta Códigos de error de REST del Centro de partners.

Campos de respuesta

Campo	Tipo	Description	Notas
Tipo	Enum	Tipo de información de validación	Mismos datos que el tipo de validación. El tipo de validación devuelve la cuenta como el tipo de respuesta.
Estado	string	Estado de validación	Estados disponibles: Unknown, UnderReview, Allowed, NotAllowed, Not Ready
Hora de actualización más reciente	string	hora de actualización del último estado en UTC	La fecha y hora ya no se rellena y será una cadena vacía.

Ejemplos de respuesta

Estado permitido

{
    "type": "account",
    "status": "Allowed",
    "lastUpdateDateTime": ""
}

En estado de revisión

{
    "type": "account",
    "status": "UnderReview",
    "lastUpdateDateTime": ""
}

Estado NotAllowed

{
    "type": "account",
    "status": "NotAllowed",
    "lastUpdateDateTime": ""
}

Estado Desconocido

{
    "type": "account",
    "status": "Unknown",
    "lastUpdateDateTime": ""
}

Estado No listo

{
    "type": "account",
    "status": "Not Ready",
    "lastUpdateDateTime": ""
}

Error 404 no encontrado

{
    "code": 600074,
    "message": "Account Status for the customer, {customer-id} was not found.",
    "description": "Account Status for the customer, {customer-id} was not found.",
    "errorName": "AccountStatusNotFound",
    "isRetryable": false,
    "errorMessageExtended": "InternalErrorCode=600074"

Elegibilidad de compra

Las transacciones del cliente se bloquean si su cuenta tiene alguno de los estados siguientes:

• UnderReview
• No permitidos
• Unknown

Las transacciones del cliente no se bloquean cuando cumplen las condiciones siguientes:

• El cliente tiene el estado Permitido
• El cliente no tiene el estado de la cuenta