Partilhar via


Perguntas frequentes sobre a ferramenta de atestado em massa do Contrato de Cliente da Microsoft

Funções apropriadas: Agente administrativo | Agente de vendas

A Ferramenta de Atestado em Massa do Contrato de Cliente da Microsoft é um aplicativo de console projetado para permitir que os parceiros forneçam atestados da aceitação do Contrato de Cliente Microsoft por seus clientes. Este documento descreve algumas das perguntas frequentes que os usuários da ferramenta podem ter.

Geral

Quem pode realizar operações com a ferramenta?

Qualquer usuário com a função de administrador global ou agente administrativo no Partner Center pode usar a ferramenta.

Se estiver usando a ferramenta em massa para atestar um cliente, em quanto tempo verei o atestado refletido para um cliente do Partner Center?

O tempo para ver um atestado refletido no Partner Center varia dependendo do número de clientes processados por operação de atualização da ferramenta. No entanto, todos os atestados bem-sucedidos devem ser refletidos no Partner Center dentro de quatro horas.

Qual é o número máximo de registos de clientes que posso atualizar de cada vez?

Não há limite para o número de registros de clientes que podem ser atualizados de uma só vez no arquivo CSV. A ferramenta processa todos os registros acionáveis ao acionar a operação de atualização. Ele atende até 500 clientes por chamada de API para o Partner Center. Ele continua esse comportamento de envio em lote até que todos os registros acionáveis de contrato do cliente sejam enviados para o Partner Center.

Meu cliente ainda receberá uma notificação por e-mail dizendo que eu certifiquei para ele se eu usar a ferramenta em massa para atestar?

Sim, o cliente recebe uma notificação por e-mail que você atestou para ele. A notificação por e-mail é enviada para o endereço de e-mail de contato principal.

Cometi um erro num dos meus atestados. Como faço para corrigir os dados, já que o registro do cliente não aparece mais nos meus dados buscados?

Você pode usar o Partner Center ou a API Create Agreement do Partner Center para atualizar os detalhes do atestado. A ferramenta não seria mais capaz de buscar/atualizar com êxito o registro do cliente afetado depois que ele for processado.

Eu tentei a ferramenta em massa para recuperar meus clientes e não vejo alguns deles. Porquê?

Nem todos os clientes precisam de ação. Os seus clientes que aceitaram um Contrato de Cliente Microsoft antes de 1 de abril de 2023 devem rever e aceitar os novos termos o mais rapidamente possível para manter contratos atualizados com a Microsoft. A operação de busca da ferramenta em massa retorna os clientes no escopo. Os clientes no escopo também são marcados em suas páginas de conta individuais.

Como alternativa, você também pode determinar quais clientes precisam de ação por meio da página da conta do cliente no Partner Center. Uma notificação exibida na página da conta do cliente mostra um prompt quando uma ação de contrato é necessária.

Encaminhei o(s) meu(s) cliente(s) afetado(s) para o Centro de Administração da Microsoft para aceitar o Contrato de Cliente Microsoft, mas eles não veem uma opção para aceitar ou receber um erro. Como podem aceitar o acordo?

Existem certas condições que podem causar uma incapacidade para o cliente de aceitar diretamente o MCA. Nesses casos, o parceiro deve fornecer um atestado para o cliente. Para obter mais informações, consulte Como confirmar que o cliente aceitou o Contrato de Cliente da Microsoft.

Orientações para resolução de problemas e mensagens de erro

Como posso obter mais detalhes sobre erros antes de entrar em contato com o suporte do Partner Center?

Você pode visualizar o(s) arquivo(s) de log na pasta Logs, no diretório raiz da ferramenta. O nome do arquivo de log é formatado como: log_{MM-dd-yyyy_HH-mm-ss}.txt.

O nível de log padrão é Informações. Você pode alterar o nível de log para Debug passando o argumento de tempo de execução debug ao executar a ferramenta. Por exemplo, dotnet run -- debug.

Uma seleção de erros comuns e suas resoluções estão listadas abaixo.

Mensagem de exceção: "A conta de parceiro não é imposta a MFA".

Este erro ocorre quando a conta usada para executar a ferramenta não foi registrada no MFA. A MFA é necessária para acessar as APIs do Espaço de Trabalho do Cliente do Partner Center. Inscreva a conta no MFA e tente novamente.

Se a sua organização parceira recebeu anteriormente uma exceção de MFA da Microsoft, execute a ferramenta usando dotnet run -- noMfa para ignorar a verificação de MFA.

Erro de autenticação: "AADSTS50011: O URI de redirecionamento 'http://localhost:(PORT)' especificado na solicitação não corresponde aos URIs de redirecionamento configurados para a ID do aplicativo"

Captura de ecrã da página Iniciar sessão, com uma mensagem sobre o URI de redirecionamento.

Este erro ocorre quando as configurações da plataforma e/ou seus URIs de redirecionamento para seu aplicativo não estão configurados corretamente. Certifique-se de que os URIs de redirecionamento para seu aplicativo estejam configurados para inclusão http://localhost na plataforma de aplicativos móveis e de desktop.

Para saber mais, consulte Ferramenta de atestado em massa do contrato de cliente da Microsoft: pré-requisitos.

Erro de chamada de API: 'Falha ao enviar solicitações de registros com código de status: (CÓDIGO DE STATUS)''

A mensagem de erro pode variar dependendo do código de status da chamada de API. Aqui estão alguns códigos de status comuns:

  • 400 - mau pedido. Esse erro geralmente ocorre quando há um problema com os dados inseridos no arquivo CSV. Informações mais detalhadas podem ser encontradas no arquivo de log. Por exemplo, a seguinte mensagem de erro do arquivo de log indica que pelo menos um dos endereços de e-mail nos registros de contrato de cliente a serem atualizados pela ferramenta em massa era inválido.

Erro conforme mostrado na saída da ferramenta:

Captura de tela da ferramenta de atestado em massa, com o erro: 400 solicitação incorreta.

Detalhes do erro, conforme visto no arquivo de log:

Captura de ecrã do ficheiro de registo, com a mensagem: O e-mail do cliente é inválido.

  • 403 - Proibido. Este erro geralmente ocorre quando a conta usada para executar a ferramenta não tem as permissões apropriadas para executar a operação. Verifique se a conta usada tem as funções de Administrador Global ou Agente de Administração

  • 500 - Erro interno do servidor. Esse erro geralmente ocorre quando há um problema com as APIs do Partner Center. Tente novamente mais tarde ou entre em contato com o suporte do Partner Center para obter assistência.

  • Para obter ajuda adicional, contacte o suporte