Centro de suporte da Workiva

Com o conector NetSuite® Token Authentication, você pode usar comandos em cadeia para interagir com o NetSuite. Por exemplo, com esse conector, você pode:

• Baixar arquivos do NetSuite
• Listar pesquisas salvas no NetSuite
• Recupere dados sobre um registro padrão do NetSuite ou uma pesquisa salva

Observação: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.

Pré-requisitos

Para ativar a conexão, o conector usa a API REST do NetSuite. Para configurar o conector, você precisará de:

• NetSuite, com autenticação baseada em token (TBA) ativada
• O ID da conta do NetSuite à qual se conectar

  Observação: Para visualizar o ID da sua conta no NetSuite, selecione Setup, Integrations, Web Services Preferences. A ID também aparece normalmente na primeira cadeia de caracteres do URL, logo antes de app.netsuite.com.

• Um registro de integração e um token de acesso criados no NetSuite para o conector
• A chave e o segredo do consumidor do registro de integração

  Observação: Se você não tiver o segredo ou a chave do consumidor, edite o registro de integração e redefina suas credenciais.

• O ID e o segredo do token de acesso. Se você não tiver o ID ou a senha do token de acesso, precisará criar um novo token.

Observação: Para interagir com um RESTlet do NetSuite usando a autenticação OAuth 2.0, use um conector de solicitação HTTP em vez disso.

Habilitar a integração no NetSuite

Para permitir que o conector interaja com o NetSuite, ele precisa do token-based authentication (TBA) e de seu próprio registro de integração.

Etapa 1. Habilite os serviços da Web SOAP e a autenticação baseada em token

Para habilitar serviços da Web SOAP e TBA para o NetSuite:

1. No NetSuite, selecione Setup, Company, Enable features.
2. Na guia SuiteCloud , em SuiteScript, selecione Client SuiteScript e Server SuiteScript.
   
3. Em SuiteTalk (Web Services), selecione SOAP web services.
   
4. Em Manage authentication (Gerenciar autenticação), selecione Token-based authentication (Autenticação baseada em token).
5. Clique em Salvar.

Etapa 2. Criar um registro de integração

Depois de ativar o TBA, crie um registro de integração para o conector:

1. No NetSuite, selecione Setup, Integrations, Manage integrations, New.
2. Para ajudar a identificar a integração, insira um nome e uma descrição exclusivos, como Integração da Workiva.
   
3. Em Authentication, selecione Token-based authentication e limpe TBA: Fluxo de autorização.
4. Clique em Save e registre a chave e o segredo do consumidor na página de confirmação.

Observação: A chave e o segredo do consumidor aparecem somente na página de confirmação do registro de integração. Certifique-se de registrar esses valores nas propriedades do conector e trate-os como uma senha.

Etapa 3. Criar uma função de integração

Para fins de segurança, crie uma função dedicada no NetSuite para gerenciar suas integrações:

1. Selecione Setup, Users/Roles, Manage roles, New.
   
2. Em General, digite um nome exclusivo para ajudar a identificar a função, como Workiva/NetSuite Integration.
3. Em Authentication, selecione Web services only role para permitir que a função se conecte apenas à API do NetSuite e não faça login diretamente no NetSuite.
4. Em Permissions, adicione as permissões para ativar a integração, como Full-level permissions to all relevant Transactions, Reports, and Lists in NetSuite.
5. Na guia Setup, em Permissions, adicione permissões de nível completo para:
   
   • Serviços da Web SOAP
   • Criação da empresa
   • Autenticação baseada em token:
     • Para ativar a função para autenticar somente por meio de tokens de acesso, Login usando tokens de acesso
     • Para permitir que a função crie e revogue seus próprios tokens de acesso, User access tokens
       
     
6. Clique em Salvar.

Etapa 4. Atribua a função ao usuário de integração

Depois de criar a função de integração, atribua-a ao usuário de integração do conector:

1. No NetSuite, selecione Setup, Users/Roles, Manage users.
2. Selecione ou crie o usuário de integração para o conector.
   

   Observação: Recomendamos um usuário separado para cada conector ou integração.

3. Em Roles, atribua a função de integração ao usuário.

Etapa 5. Crie o token de acesso do usuário de integração

Para criar um token de acesso para o usuário de integração:

1. No NetSuite, selecione Setup, Users/Roles, Access tokens, New.
2. Clique em New access token.
   
3. Em Nome do aplicativo, selecione o registro de integração.
4. Em User, selecione o usuário de integração.
5. Em Role, selecione a função de integração.
6. Clique em Salvar.
7. Observe a ID e o segredo criados para o token; você precisará deles para as propriedades do conector.

   Observação: Para fins de segurança, a ID e o segredo aparecem somente quando o token de acesso é criado. Trate-os como se fosse uma senha. Se você não tiver o ID ou o segredo do token para as propriedades do conector, crie um novo token para o usuário de integração.

Configurar o conector de autenticação de token do NetSuite

Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.

1. Em Construtor de cadeia, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
2. Em Conector Conexão, selecione NetSuite Token Authentication e o CloudRunner padrão.
   
3. Digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.
4. Em Propriedades, digite os detalhes da conexão:
   
   

   Propriedade	Detalhes
   ID da conta	Digite o ID da conta do NetSuite à qual se conectar.
   Chave do consumidor	Digite a chave do consumidor para o registro de integração do conector.
   Segredo do cliente	Digite o segredo da propriedade Chave de cliente.
   ID do token	Digite a ID do token de acesso do conector.
   Token secreto	Digite o segredo da propriedade Token ID.
   Sandbox	Para se conectar a uma conta NetSuite sandbox, marque essa caixa.

   Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256.

5. Selecione os ambientes para usar a conexão e clique em Save.
6. Para testar a conexão, crie e execute uma cadeia com o comando List Saved Searches do conector 2 e verifique se ele retorna uma saída válida.

Solução de problemas

Campos personalizados

Observe que a API do NetSuite não pode retornar campos personalizados. Como alternativa, o Data Prep pode criar transformações que imitam a lógica de um campo personalizado do Netsuite.

Conexões

Se a conexão com o NetSuite falhar:

• Verifique a ID da conta inserida para o conector. Para visualizar o ID da conta no NetSuite, selecione Setup, Integrations, Web Services Preferences. A ID também aparece normalmente logo antes de app.netsuite.com no URL.
• Verifique a chave e o segredo do consumidor do registro de integração do conector. Se necessário, edite o registro de integração e redefina suas credenciais para criar uma nova chave e segredo do consumidor.
• Verifique a ID e o segredo do token de acesso do conector. Se necessário, crie um novo token para o conector.