Conector NetSuite avançado no Jitterbit Design Studio

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 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ífica da conta NetSuite

Durante a configuração de um endpoint NetSuite, você deve fornecer uma URL WSDL específica da conta no campo URL de download do WSDL. Esta seção mostra como obter essa URL encontrando o domínio específico da conta do NetSuite e, em seguida, usando o domínio específico da conta na URL WSDL.

Encontrando o domínio específico da conta NetSuite

Estas etapas devem ser executadas por um administrador do NetSuite ou outro usuário com a permissão Configurar empresa:

1. Efetue login na instância do NetSuite.

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

3. Na página Company Information, vá para a subguia Company URLs. O domínio específico da conta está sob o título SuiteTalk (SOAP and 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 o URL WSDL:

• https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2024_2_0/netsuite.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

Durante a configuração de um endpoint NetSuite, insira esta URL WSDL específica da conta no campo URL de download do WSDL.

Informações sobre quais versões do agente Jitterbit são necessárias para uso com as versões WSDL acima são fornecidas em Pré-requisitos no endpoint do conector NetSuite 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 no data center do NetSuite

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

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

Erro do conector: erro ao obter a URL do data center.

Causado por: org.jitterbit.integration.server.engine.connector.exception.NetSuiteWebServiceRuntimeException: FaultString:

Nesta conta, você deve usar domínios específicos da conta com este endpoint de serviços web SOAP. Você pode usar a operação SOAP getDataCenterUrls para obter o domínio correto. Ou vá para Configuração > Empresa > Informações da empresa na IU do NetSuite. Seus domínios são listados na aba URLs da empresa.

Em algumas circunstâncias, este erro pode aparecer:

Você não está solicitando o data center correto para sua empresa.

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

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

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

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

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

Autenticação de dois fatores NetSuite (TFA ou 2FA)

Aqueles que usam a autenticação de dois fatores do NetSuite (TFA ou 2FA) não devem usar o tipo de autenticação de logon único (SSO) ao configurar seu endpoint do NetSuite no Jitterbit. Isso pode fazer com que seu endpoint NetSuite falhe. 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 adequadamente.

URL WSDL da sandbox do NetSuite

A partir de janeiro de 2018, o NetSuite usa a mesma URL para seus domínios de produção e sandbox. Para Design Studio e Agente versões 9.2 e superior, nenhuma ação é 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 sandbox. Por exemplo, o ID da conta pode ser anexado com _SB1, _SB2, etc. Como o NetSuite não usa mais uma URL de sandbox separada, 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ão 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 no momento. Nesse caso, o teste do endpoint parece bem-sucedido, mas, no tempo de execução da operação, a exceção ocorre.

Para resolver, ao gerar tokens de acesso, certifique-se de gerá-los em uma papel de Acesso Total ou Administrador ou certifique-se de que as permissões apropriadas sejam concedidas 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), é recomendado verificar para certificar-se de que você está usando o URL WSDL correto. O erro conterá o seguinte texto:

FaultString: Ocorreu um erro inesperado. O Suporte Técnico foi alertado sobre esse problema.

Este erro pode ocorrer por vários motivos; no entanto, sabe-se que esse erro é resultado de uma URL WSDL incorreta ao usar agentes que são versão 9.2 para 9.5. Na versão Agents 9.6 e superior, o texto da mensagem de erro descreve o problema com mais precisão.

Governança de simultaneidade do NetSuite

Em 18 de agosto de 2017, a Netsuite introduziu "Concurrency Governance" 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 governança.

Limitações de pesquisa salvas do NetSuite

Ao usar a pesquisa salva do NetSuite, se você estiver tentando pesquisar em objetos que têm 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 pesquisa salva no Jitterbit Studio não será preenchido com nenhuma pesquisa salva. Isso ocorre devido a um limite de 1.000 registros imposto NetSuite em solicitações de API.

Confirmação de limitação

Para confirmar que o problema é com a limitação do NetSuite, você pode verificar o Web Services Usage Log dentro da sua instância do NetSuite. Para um erro desse tipo, o log terá uma entrada semelhante à seguinte:

<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. Após o número de pesquisas ser reduzido, você poderá selecionar uma pesquisa salva no menu suspenso no Jitterbit Studio.

Uma alternativa para reduzir o número de pesquisas salvas é executar a pesquisa salva via SOAP, referenciando a pesquisa 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 mais sua integração com o NetSuite.

Usando funções do NetSuite

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 o horário 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 o NetSuite são executadas de forma síncrona; ou seja, após uma solicitação ser feita, a conexão é mantida aberta. Se algumas solicitações expirarem durante uma pesquisa síncrona, você pode querer ativar a configuração assíncrona. Com essa configuração, após a solicitação ser enviada, o Jitterbit pesquisará periodicamente para ver se a solicitação foi concluída. Isso é mais útil com grandes quantidades de dados.

Para ativar a opção assíncrona, defina $jitterbit.netsuite.async=true em um script que esteja, 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 em Processamento de solicitação síncrona versus assíncrona.

Passando valores nulos para campos personalizados

Uma limitação da API do 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 sobre 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 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 para o NetSuite Connector Criar, Atualizar, ObterLista, Inserir, e Pesquisar atividades usando um endpoint NetSuite com um NetSuite WSDL que seja versão 2016.2 ou superior. Você deve estar usando versão 9.4 ou superior do Design Studio e do Agents para usar este recurso.

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

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 dentro do seu respectivo nó de objeto.

Limitação

Em uma pesquisa avançada do NetSuite, segmentos personalizados do tipo Lista/Registro 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 qual tipo está sendo usado, verifique o Tipo definido no NetSuite em seu Segmento Personalizado:

Essa limitação não se aplica a outros tipos de atividades do NetSuite; ou seja, os tipos Lista/Registro e Seleção Múltipla são suportados em Criar, 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 do 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 Item Fulfillment somente àqueles em que Ship Status = Shipped, em vez de usar o enum para Shipped (_shipped), você precisaria usar o valor a de ItemShip:C conforme 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 do NetSuite:

• Capturando alterações de dados com uma API do API Manager 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 timestamp

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

• Criando iterador de transformação dinamicamente

• Melhores práticas de Harmony

• Vinculando registros de origem ou destino usando IDs compartilhados

• Consultando dados durante o tempo de execução

• Procurando dados usando um dicionário

• Dados persistentes para processamento posterior usando Armazenamento Temporário

• Persistindo dados de entrada para processamento posterior

• Processando registros de destino condicionalmente

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

• Criar um projeto de colaboração em equipe

• Configurar alertas, registro e tratamento de erros

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

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