Conector NetSuite Avançado

Introdução

Esta página aborda dicas de solução de problemas, tutoriais e funcionalidades avançadas relacionadas às integrações do NetSuite.

Solução de Problemas e Como Tutoriais

Esta seção descreve problemas e soluções alternativas para problemas comuns enfrentados com integrações do NetSuite e fornece informações sobre alterações do NetSuite que podem afetar sua integração.

URL WSDL Específico da Conta NetSuite

Durante a configuração de um endpoint NetSuite, você deverá fornecer um URL WSDL específico da conta no campo WSDL Download URL. Esta seção mostra como obter esse URL localizando o domínio específico da conta NetSuite e, em seguida, usando o domínio específico da conta no URL WSDL.

Encontrando o Domínio Específico da Conta NetSuite

Estas etapas devem ser realizadas por um Administrador do NetSuite ou outro usuário com a permissão Configurar Empresa:

1. Faça login na instância do NetSuite.

2. Vá para Configuração > Empresa > Informações da empresa (ou pesquise Informações da empresa).

3. Na página Informações da empresa, acesse a subguia URLs da empresa. O domínio específico da conta está sob o título SuiteTalk (SOAP e REST Web Services):

   

Para obter mais informações, consulte URLs para domínios específicos da conta.

Construindo a URL WSDL

Depois de obter o domínio específico da conta, use-o para construir a URL WSDL:

• https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2024_1_0/netsuite.wsdl
• https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2023_2_0/netsuite.wsdl
• https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2023_1_0/netsuite.wsdl
• https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2022_2_0/netsuite.wsdl
• https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2022_1_0/netsuite.wsdl
• https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2021_2_0/netsuite.wsdl

Durante a configuração de um endpoint NetSuite, insira esse URL WSDL específico da conta no campo WSDL Download URL.

Informações sobre quais versões do Harmony Agente são necessárias para uso com as versões WSDL acima são fornecidas em Pré-requisitos no NetSuite Connector Endpoint página.

Alterar a Versão do WSDL

Atualizar periodicamente a versão WSDL usada pelo seu endpoint NetSuite para sempre usar uma versão totalmente suportada é uma boa prática recomendada. As etapas abaixo descrevem a melhor maneira de fazer a alteração, garantindo uma atualização perfeita.

1. Crie um novo endpoint.

2. Para cada operação do NetSuite, troque o endpoint antigo pelo novo.

3. Atualize a função.

4. Atualize as transformações.

5. Repita as etapas 2 a 4 para cada operação do NetSuite.

Erro do Data Center do NetSuite

Devido às alterações feitas pelo NetSuite, alguns formatos de URL WSDL que eram permitidos anteriormente não são mais aceitos, incluindo URLs WSDL genéricos e URLs específicos de data center. A Jitterbit recomenda sempre usar uma URL WSDL específica da conta.

Um endpoint NetSuite pode ter sido testado anteriormente com sucesso, mas agora falha com este erro:

Connector Error: Error getting the data center URL.

Caused by: org.jitterbit.integration.server.engine.connector.exception.NetSuiteWebServiceRuntimeException: FaultString:

In this account, you must use account-specific domains with this SOAP web services endpoint. You can use the SOAP getDataCenterUrls operation to obtain the correct domain. Or, go to Setup > Company > Company Information in the NetSuite UI. Your domains are listed on the Company URLs tab.

Em algumas circunstâncias, este erro pode aparecer:

You are not requesting the correct data center for your company.

Esses erros podem resultar do uso de um URL de download WSDL incorreto na configuração de uma conexão NetSuite. Devido às alterações feitas pelo NetSuite, alguns formatos de URL WSDL que eram permitidos anteriormente não são mais aceitos, incluindo URLs WSDL genéricos e URLs específicos de data center. Por exemplo:

• URL WSDL genérico: https://webservices.netsuite.com/wsdl/v2024_1_0/netsuite.wsdl
• URL WSDL específico do data center: https://webservices.na3.netsuite.com/wsdl/v2024_1_0/netsuite.wsdl

Para resolver, altere a URL do WSDL para usar um domínio específico da conta:

• URL WSDL específico da conta: https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2024_1_0/netsuite.wsdl

Para obter instruções sobre como encontrar o domínio específico da conta do NetSuite e, em seguida, usar o domínio específico da conta no URL WSDL, consulte URL WSDL específico da conta do NetSuite.

Autenticação de Dois Fatores NetSuite (tfa Ou 2fa)

Aqueles que usam autenticação de dois fatores NetSuite (TFA ou 2FA) não devem usar o tipo de autenticação de logon único (SSO) ao configurar seu endpoint NetSuite em Jitterbit. Fazer isso pode causar falha no endpoint do NetSuite. Em vez disso, é recomendado que esses usuários habilitem a autenticação baseada em token (TBA) em sua conta NetSuite e configurem seu endpoint NetSuite no Jitterbit de acordo.

URL WSDL do NetSuite Sandbox

A partir de janeiro de 2018, o NetSuite usa o mesmo URL para o domínio de produção e de sandbox. Para Design Studio e Agente versões 9.2 e superiores, nenhuma ação será necessária para usuários do Jitterbit com endpoints NetSuite existentes configurados para o domínio sandbox, desde que o sandbox tenha sido atualizado desde essa alteração.

O número da conta NetSuite agora é usado para determinar se a conta está em produção ou em sandbox. Por exemplo, o ID da conta pode ser anexado com _SB1, _SB2, etc. Como o NetSuite não usa mais um URL de sandbox separado e o sandbox agora é indicado pelo ID da conta, a caixa de seleção Sandbox foi removida nas versões 9.2 e superiores do Design Studio.

Se o seu sandbox do NetSuite não tiver sido atualizado desde que essas alterações do NetSuite foram implementadas, talvez seja necessário usar um URL WSDL específico do sandbox.

Erro de Permissões para TBA

Se você receber um INSUFFICIENT_PERMISSION erro ao executar operações usando um endpoint NetSuite configurado com autenticação baseada em token (TBA), talvez seja necessário usar uma papel diferente para gerar os tokens de acesso ou adicionar permissões à papel que você está usando atualmente. Nesse caso, o teste do endpoint parece bem-sucedido, mas durante o tempo de execução da operação ocorre a exceção.

Para resolver, ao gerar tokens de acesso, certifique-se de gerá-los em uma papel de acesso total ou de administrador ou certifique-se de que as permissões apropriadas sejam permitidas para a papel.

Erro Inesperado para TBA

Se você receber um UNEXPECTED_ERROR erro ao testar a conexão com um endpoint NetSuite configurado com autenticação baseada em token (TBA), é recomendável verificar se você está usando o URL WSDL correto. O erro conterá o seguinte texto:

FaultString: An unexpected error has occurred. Technical Support has been alerted to this problem.

Este erro pode ocorrer por vários motivos; entretanto, sabe-se que esse erro resulta de uma URL WSDL incorreta ao usar Agentes que são versão 9.2 a 9,5. Na versão Agentes 9.6 e superiores, o texto da mensagem de erro descreve o problema com mais precisão.

Atualização de Compatibilidade NetSuite TLS

Informações sobre o uso da criptografia TLS 1.2 são fornecidas em NetSuite TLS Compatibility Upgrade.

Governança de Simultaneidade do NetSuite

Em 18 de agosto de 2017, a Netsuite introduziu "Governança de simultaneidade" em sua versão 2017.2. Se você usa serviços web e/ou RESTlets, saiba mais sobre como isso pode afetar sua integração em NetSuite 2017.2 Concurrency Governance.

Limitações de Pesquisa Salva do NetSuite

Ao usar a pesquisa salva do NetSuite, se você estiver tentando pesquisar em objetos que possuem mais de 1.000 pesquisas salvas, pode aparecer no Jitterbit Studio como se não houvesse pesquisas salvas disponíveis no objeto. Nesse caso, o menu suspenso de pesquisas salvas no Jitterbit Studio não será preenchido com nenhuma pesquisa salva. Isso se deve a um limite de 1.000 registros imposto NetSuite em solicitações de API.

Confirmação de Limitação

Para confirmar se o problema está na limitação do NetSuite, você pode verificar o registro de uso de serviços da Web em sua instância do NetSuite. Para um erro deste tipo, o log terá uma entrada semelhante a esta:

<platformCore:code>MAX_RCRDS_EXCEEDED</platformCore:code>
<platformCore:message>The maximum number ( 1000) of records allowed for a READ operation has been exceeded.</platformCore:message>

Solução Alternativa para Limitação

Como solução alternativa, é recomendável limpar as pesquisas salvas do NetSuite que não estão mais sendo usadas para reduzir o número de pesquisas salvas para menos de 1.000. Depois que o número de pesquisas for reduzido, você poderá selecionar uma pesquisa salva no menu suspenso do Jitterbit Studio.

Uma alternativa para reduzir o número de buscas salvas é executar a busca salva via SOAP, referenciando a busca salva por ID. Observe que esta alternativa não faz uso do Conector NetSuite e pode resultar em problemas ao migrar ambientes.

Funcionalidade Avançada

Esta seção fornece informações sobre os recursos do Jitterbit que permitem que você aproveite ao máximo sua integração com o NetSuite.

Usando Funções do NetSuite

As funções específicas do NetSuite disponíveis no Formula Builder em Funções > Funções do Conector estão listadas abaixo. Para obter mais informações sobre como usar essas funções, consulte Funções do conector.

• NetSuiteGetSelectValue: Recupera os valores da lista de opções para um campo do NetSuite.
• NetSuiteGetServerTime: Obtém a hora do servidor do NetSuite.
• NetSuiteLogin: Obtém a sessão do NetSuite.

Usando a Configuração Assíncrona

Por padrão, as chamadas de API para NetSuite são executadas de forma síncrona; ou seja, depois que uma solicitação é feita, a conexão é mantida aberta. Se algumas solicitações atingirem o tempo limite durante uma pesquisa síncrona, talvez você queira ativar a configuração assíncrona. Com esta configuração, após o envio da solicitação, o Jitterbit fará uma pesquisa periódica para ver se a solicitação foi concluída. Isto é mais útil com grandes quantidades de dados.

Para ativar a opção assíncrona, defina $jitterbit.netsuite.async=true em um script que está, por exemplo, no início da operação ou dentro da cadeia de operação (veja Criando um Script). Para obter informações adicionais, consulte a documentação do NetSuite sobre Processamento de solicitação síncrona versus assíncrona.

Passando Valores NULL para Campos Personalizados

Uma limitação da API NetSuite é que você não pode passar valores NULL ou em branco (string vazia) para campos personalizados no NetSuite.

De acordo com a documentação do NetSuite em CustomFieldList, os campos personalizados podem ser definidos como NULL enviando o campo no NetSuite nullFieldList.

No Design Studio, você não verá nullFieldList como um campo ou opção.

Em vez disso, você pode passar valores NULL ou em branco (string vazia) para campos personalizados mapeando o campo de origem para ambos os campos externalId e name campos de um campo de destino.

Usando Segmentos Personalizados do NetSuite

Segmentos personalizados em objetos NetSuite padrão e personalizados são suportados pelo NetSuite Connector Create, Atualizar, ObterLista, Inserir e Pesquisar atividades usando um NetSuite Endpoint com um NetSuite WSDL versão 2016.2 ou superior. Você deve estar usando a versão 9.4 ou superior do Design Studio e dos Agentes para usar esse recurso.

Ao configurar qualquer um dos tipos de atividade listados acima, você verá cada segmento personalizado exibido na resposta do NetSuite ou na estrutura de solicitação:

Depois que a atividade for usada em uma transformação, você poderá mapear de ou para qualquer um desses segmentos personalizados, assim como faz para outros campos. Os segmentos personalizados estão localizados em um nó chamado customFieldList que está presente em seu respectivo nó de objeto.

Limitação

Em uma Pesquisa Avançada do NetSuite, segmentos personalizados do tipo List/Record conforme definido no NetSuite não são suportados. No entanto, observe que o tipo Seleção múltipla é suportado em uma Pesquisa avançada do NetSuite. Para determinar que tipo está sendo usado, verifique o Tipo definido no NetSuite em seu Segmento Personalizado:

Esta limitação não se aplica a outros tipos de atividades do NetSuite; ou seja, os tipos List/Record e Multiple Select são suportados em Create, Atualizar, ObterLista, Inserir, Pesquisa Básica, Pesquisa expandida e Pesquisa salva Atividades.

Usando a Pesquisa de Transações do NetSuite por Status

Ao pesquisar transações NetSuite com base em um status específico, você precisará especificar o valor correto do filtro de pesquisa que corresponde ao status desejado. Você pode determinar o valor do filtro de pesquisa correspondente conforme fornecido na tabela abaixo.

Por exemplo, se você quiser que os critérios de pesquisa limitem os registros de Cumprimento de Item apenas àqueles em que Status do Envio = Enviado, em vez de usar a enumeração para Enviado (_enviado), você realmente precisará usar o valor a de ItemShip:C como fornecido na tabela abaixo. Traduções semelhantes se aplicam a uma variedade de objetos NetSuite.

Fonte: http://blog.prolecto.com/2013/08/30/netsuite-searchfilter-transaction-internal-status-list/

Padrões de Design

Os seguintes padrões de design podem ser úteis para integrações NetSuite:

• Capturando alterações de dados com uma API Harmony ou Endpoint HTTP

• Capturando alterações de dados com fontes de arquivo

• Capturando alterações de dados com valores de campo de origem

• Capturar alterações de dados com alterações de tabela ou arquivo

• Capturando alterações de dados com consultas baseadas em carimbo de data/hora

• Criando saída de registro único ou múltiplo

• Criando Iterador de Transformação Dinamicamente

• Práticas recomendadas de Harmony

• Vinculando registros de origem ou destino usando IDs compartilhados

• Procurando dados durante o tempo de execução

• Pesquisando dados usando um dicionário

• Persistência de dados para processamento posterior usando armazenamento temporário

• Persistência de dados de entrada para processamento posterior

• Processando registros de destino condicionalmente

• Executando as próximas operações condicionalmente usando cadeias de operações

• Configurar um projeto de colaboração em equipe

• Configurar alertas, registros e tratamento de erros

• Atualizando vários alvos de um único registro de origem

• Upserting de dados Clarizen com uma cadeia de operações