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 da 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 de Administração 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 de acordo com o 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 registros de clientes que posso atualizar de uma só 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 agrupa 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 do contrato do cliente sejam enviados para o Partner Center.
Meu cliente ainda receberá uma notificação por e-mail informando que eu atestado para ele se eu usar a ferramenta em massa para atestar?
Sim, o cliente recebe uma notificação por e-mail de que você atestou para ele. A notificação por e-mail é enviada para o endereço de e-mail do contato principal.
Cometi um erro em um 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 de Criação de Contrato 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 fosse processado.
Tentei a ferramenta em massa para recuperar meus clientes e não vejo alguns deles. Por quê?
Nem todos os clientes precisam de ação. Seus clientes que aceitaram um Contrato de Cliente da Microsoft antes de 1º de abril de 2023 devem revisar e aceitar os novos termos o mais rápido possível para manter os 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 exigem 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 e mostra um prompt quando a ação do contrato é necessária.
Direcionei meus clientes afetados para o Centro de Administração da Microsoft para aceitar o Contrato de Cliente da Microsoft, mas eles não veem uma opção para aceitar ou receber um erro. Como eles podem aceitar o acordo?
Existem certas condições que podem causar a incapacidade do 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 se o cliente aceitou o Contrato de Cliente da Microsoft.
Diretrizes de soluçã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 exibir os arquivos 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 Depurar 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 do parceiro não é imposta pela MFA".
Esse erro ocorre quando a conta usada para executar a ferramenta não estava registrada na MFA. A MFA é necessária para acessar as APIs do Customer Workspace do Partner Center. Registre a conta no MFA e tente novamente.
Se sua organização parceira recebeu anteriormente uma exceção de MFA pela 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"
Esse 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 do seu aplicativo estejam configurados para serem incluídos http://localhost na plataforma de aplicativos móveis e da área de trabalho.
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: (STATUS CODE)''
A mensagem de erro pode variar dependendo do código de status da chamada à API. Aqui estão alguns códigos de status comuns:
- 400 - Pedido incorreto. 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 mensagem de erro a seguir do arquivo de log indica que pelo menos um dos endereços de email nos registros do contrato do cliente a serem atualizados pela ferramenta em massa era inválido.
Erro conforme mostrado na saída da ferramenta:
Detalhes do erro, conforme visto no arquivo de log:
403 - Proibido. Esse 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 Administrador
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.
Conteúdo relacionado
- Para obter mais ajuda, entre em contato com o suporte