Compartilhar via

Ferramenta de Atestado em Massa do Contrato de Cliente da Microsoft

  • Artigo

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

Nuvens aplicáveis: Global

A Ferramenta de Atestado em Massa do Contrato de Cliente da Microsoft possibilita aos parceiros confirmar a aceitação do Contrato de Cliente da Microsoft em nome dos clientes. Essa ferramenta foi projetada para ajudar os parceiros que têm muitos clientes e se enquadram no escopo do esforço de renovação do Contrato de Cliente da Microsoft.

A ferramenta de atestado em massa tem vários recursos:

  • Ferramenta de console do .NET de software livre usando um SDK do .NET de software livre (7.0)
  • Dá suporte ao formato de arquivo separado por vírgulas (.csv) para configurar atestados em massa
  • Nenhuma alteração de código é necessária e pode ser utilizada com um comando .NET
  • O código é extensível e pode ser aprimorado conforme os parceiros acharem adequado
  • O registro extensivo pode ajudar a solucionar problemas

Essa ferramenta é para parceiros de cobrança direta e provedores indiretos que fazem transações por meio do Programa CSP.

Pré-requisitos

  • As contas de parceiro devem ser habilitadas para MFA (autenticação multifator), pois as APIs do espaço de trabalho do cliente impõem a MFA. Você pode adicionar MFA seguindo as instruções em Obrigatoriedade de MFA para seu locatário parceiro.

  • Verifique se você tem o SDK do .NET 7.0 instalado no computador host.

  • Configure um aplicativo nativo no Partner Center:

    1. No Partner Center, selecione Configurações (ícone de engrenagem) >Configurações da conta.

      Captura de tela do menu de configurações do Partner Center, com Configurações da conta realçadas.

    2. Selecione a página Gerenciamento de aplicativos.

    3. Selecione + Adicionar novo aplicativo nativo. Um novo aplicativo é criado para você. Copie o ID do aplicativo e mantenha-o à mão.

      Captura de tela da página Gerenciamento de aplicativos, com Adicionar novo aplicativo nativo realçado.

      Agora você deve ser capaz de ver o aplicativo recém-criado no portal do Azure em Registros de aplicativo de ID > do Azure Entra.

      Captura de tela da página Registros de aplicativo, com o aplicativo nativo do Partner Center realçado.

    4. Use a guia Autenticação para adicionar uma plataforma para aplicativos móveis e de desktop.

      Captura de tela da página Autenticação, com o submenu

    5. Configure o http://localhost e outros URIs de redirecionamento para o aplicativo.

      Captura de tela da página 'Configurar área de trabalho + dispositivos', com URIs de redirecionamento mostrados.

    6. Depois de salvos, verifique se os URIs de redirecionamento estão listados na plataforma de aplicativos móveis e da área de trabalho e se os tokens de ID estão selecionados em Concessão implícita e fluxos híbridos.

    Para saber mais, confira Autenticação do Partner Center.

Executar a Ferramenta de Atestado em Massa do Contrato de Cliente da Microsoft

  1. Acesse os Exemplos de DotNet do Partner Center no GitHub e selecione ZIP de Download de Código>para extrair os arquivos em uma pasta local. Na pasta extraída haverá uma subpasta chamada Microsoft Customer AgreementRefreshBulkAttestationCLITool. Agora você está pronto para executar a ferramenta.

  2. Abra o prompt de comando e navegue até a pasta onde você extraiu os arquivos.

  3. Execute o seguinte comando: dotnet run. Se necessário, aguarde a conclusão da compilação.

  4. Forneça a ID do aplicativo e o nome UPN. Use a ID do aplicativo nativo configurada que você criou e seu UPN.

  5. Faça login na sua conta com MFA.

  6. A ferramenta mostra as seguintes opções, que são descritas nas seguintes seções:

    Captura de tela das opções da Ferramenta de Atestado em Massa para buscar ou atualizar registros de contrato do cliente.

Autenticação

Depois de iniciar a ferramenta, ela tenta buscar um token de autenticação silenciosamente. Se falhar, um modo interativo será acionado e uma janela do navegador será aberta para solicitar que você faça login. Use as mesmas credenciais que você usa ao entrar no Partner Center.

Após a autenticação bem-sucedida, a seguinte mensagem é exibida. Feche a janela do navegador e retorne ao aplicativo de console.

Captura de tela da janela localhost do navegador, com uma mensagem informando que não há problema em fechar a guia do navegador.

Cenários

Antes de usar a ferramenta, observe:

  • A ferramenta não foi projetada para fornecer detalhes de aceitação direta do cliente
  • A ferramenta tem validação de dados de entrada em paridade com a API de criação de contrato do Partner Center

Há dois cenários compatíveis com a ferramenta: buscar registros de contrato de cliente e atualizar registros de contrato de cliente.

Buscar registros de contrato do cliente

Essa operação usa a API do Partner Center para buscar todos os registros de contrato de cliente que estão no escopo da Atualização do Contrato de Cliente da Microsoft para seu locatário de parceiro. Em seguida, a ferramenta salva os registros em um arquivo CSV (CustomerAgreementRecords.csv) em um caminho de sua escolha.

Se um contrato de cliente tiver sido atualizado (por meio da ferramenta em massa, do Portal do Partner Center ou da API de criação de contrato), o registro não será retornado na operação de busca. Ele também não será incluído no arquivo CSV. Todos os registros retornados no arquivo CSV são acionáveis e devem ser atualizados.

Exemplo de execução da operação de busca:

Captura de tela da Ferramenta de Atestado em Massa, com uma mensagem informando que ela buscou 14 registros de contrato do cliente do Partner Center.

Parte dos campos retornados inclui os detalhes de contato do cliente para o último contrato confirmado pelo parceiro. Se um atestado anterior (contrato confirmado pelo parceiro em nome do cliente) existiu, os detalhes de contato do cliente para essa confirmação serão mostrados nos campos a seguir. Caso contrário, eles ficarão em branco. Esses detalhes são fornecidos para sua conveniência, caso o agente aceitante seja o mesmo no momento da atualização da aceitação, mas, caso contrário, devem ser atualizados para refletir com precisão os detalhes da aceitação. Uma notificação por email será enviada ao cliente usando o email fornecido assim que o parceiro confirmar a aceitação do Contrato de Cliente da Microsoft.

O arquivo CSV contém os seguintes campos:

  • ID do locatário do cliente: o locatário/ID da Microsoft do cliente
  • Detalhes de contato do cliente:
    • Nome: o nome do agente aceitante na organização do cliente do último contrato confirmado pelo parceiro
    • Sobrenome: o sobrenome do agente aceitante na organização do cliente do último contrato confirmado pelo parceiro
    • E-mail: o endereço de e-mail do agente aceitante na organização do cliente do último contrato confirmado pelo parceiro
    • PhoneNumber: o número de telefone do agente aceitante na organização do cliente do último contrato confirmado pelo parceiro
    • LastAgreementDate: a data e hora do último contrato confirmado pelo parceiro
  • Atestado de parceiro concluído: um valor booliano que indica se o registro do contrato do cliente deve ser atualizado pela ferramenta em massa. Esse campo é definido como False por padrão e deve ser definido como True para todos os registros que você deseja atualizar.
  • Link da Conta do Cliente: um campo não operacional usado para exibir um link direto para a página da conta do cliente no Partner Center. A ferramenta preenche esse campo, mas não é usada para nenhuma operação e não deve ser modificada.

Exemplo de arquivo CSV:

Captura de tela da saída de exemplo do arquivo CSV.

Dica

Antes de acionar a primeira operação de atualização, é recomendável salvar uma cópia dos registros do contrato do cliente retornados em outro local para seus próprios registros. Depois que os registros do contrato do cliente são atualizados com êxito, eles são tratados como resolvidos e não serão retornados no futuro.

Atualizar registros de contrato do cliente

Essa operação usa a API do Partner Center para atualizar os registros do contrato do cliente do arquivo CSV criado pela operação de busca.

Antes de atualizar um registro de contrato do cliente, certifique-se de que os detalhes de contato do cliente para o agente aceitante na organização do cliente estejam precisos e atualizados. Para fazer isso, atualize os seguintes campos no arquivo CSV:

  • Nome
  • Sobrenome
  • Email
  • PhoneNumber (opcional)

A data e hora do contrato será preenchida automaticamente no Partner Center.

Para marcar um registro de contrato de cliente para atualização, defina o campo Atestado de Parceiro Concluído como Verdadeiro para o registro no arquivo CSV. A ferramenta processa apenas registros que têm esse campo definido como True.

Exemplo de atualização do arquivo CSV para os 2 principais clientes retornados da operação de busca:

Captura de tela da saída de exemplo do arquivo CSV, em que Atestado de Parceiro Concluído é Verdadeiro.

Depois de marcar os registros do contrato do cliente que você deseja atualizar, salve e feche o arquivo CSV e acione a operação de atualização no menu de ferramentas. A ferramenta solicita que você forneça o caminho para o arquivo CSV. Depois de analisar os registros com êxito, a ferramenta exibe quantos registros acionáveis encontrou e começa a despachar operações de atualização.

Para grandes quantidades de contratos, as atualizações podem levar algum tempo porque o máximo de contratos a serem atualizados por chamada enviada é 500. As operações de atualização ocorrem de forma assíncrona quando chegam ao Partner Center. Você pode esperar um atraso a partir do momento em que a ferramenta conclui as operações de atualização e quando os registros do contrato do cliente são atualizados no Partner Center.

Exemplo de execução da operação de atualização:

Captura de tela da Ferramenta de Atestado em Massa, com uma mensagem dizendo que processou dois registros acionáveis e concluiu a operação.

Conteúdo relacionado