Esta página foi traduzida pela API Cloud Translation.

NetSuite

O conetor do NetSuite permite-lhe realizar operações de inserção, eliminação, atualização e leitura em dados do NetSuite.

Antes de começar

Antes de usar o conector do NetSuite, conclua as seguintes tarefas:

No seu projeto do Google Cloud:
- Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede.
- Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
- Conceda as seguintes funções de IAM à conta de serviço que quer usar para o conector:
  - roles/secretmanager.viewer
  - roles/secretmanager.secretAccessor
  Uma conta de serviço é um tipo especial de Conta Google destinada a representar um utilizador não humano que precisa de autenticação e autorização para aceder a dados nas APIs Google. Se não tiver uma conta de serviço, tem de criar uma. O conector e a conta de serviço têm de pertencer ao mesmo projeto. Para mais informações, consulte Criar uma conta de serviço.
- Ative os seguintes serviços:
  - secretmanager.googleapis.com (Secret Manager API)
  - connectors.googleapis.com (API Connectors)
  Para saber como ativar serviços, consulte o artigo Ativar serviços.
Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

Configure o conetor

Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.
Aceda à página Ligações
Clique em + Criar novo para abrir a página Criar associação.
Na secção Localização, escolha a localização para a ligação.
1. Região: selecione uma localização na lista pendente.
  As regiões suportadas para conetores incluem:
  Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.
2. Clicar em Seguinte.
Na secção Detalhes da associação, conclua o seguinte:
1. Conetor: selecione Netsuite na lista pendente de conetores disponíveis.
2. Versão do conetor: selecione a versão do conetor na lista pendente de versões disponíveis.
3. No campo Nome da ligação, introduza um nome para a instância de ligação.
  Os nomes das associações têm de cumprir os seguintes critérios:
  - Os nomes das associações podem usar letras, números ou hífenes.
  - As letras têm de ser minúsculas.
  - Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
  - Os nomes das associações não podem exceder 49 carateres.
4. Opcionalmente, introduza uma Descrição para a instância de associação.
5. Opcionalmente, ative o Registo na nuvem e, em seguida, selecione um nível de registo. Por predefinição, o nível do registo está definido como Error.
6. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
7. Opcionalmente, configure as definições do nó de associação:
  - Número mínimo de nós: introduza o número mínimo de nós de ligação.
  - Número máximo de nós: introduza o número máximo de nós de ligação.
  Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.
8. ID da conta: a conta da empresa à qual o seu nome de utilizador está associado no NetSuite.
9. Modo de coluna de agregação: indica como as colunas de agregação devem ser tratadas.
10. ID da aplicação: a partir da versão 2020.1, os pedidos ao NetSuite requerem um ID da aplicação.
11. Autorizações de campos personalizados: uma lista separada por vírgulas de autorizações de campos personalizados. Dá mais controlo do que IncludeCustomFieldColumns .
12. Incluir tabelas secundárias: um valor booleano que indica se as tabelas secundárias devem ser apresentadas.
13. Include Custom Field Columns: um valor booleano que indica se quer incluir colunas de campos personalizados.
14. Include Custom List Tables: um valor booleano que indica se quer usar tabelas baseadas em listas personalizadas.
15. Include Custom Record Tables: um valor booleano que indica se quer usar tabelas baseadas em tipos de registos personalizados.
16. Include Reference Columns: uma lista separada por vírgulas que representa as colunas a incluir quando são obtidos dados de um campo que representa uma referência de registo.
17. Sessões simultâneas máximas: o número máximo de sessões simultâneas disponíveis para utilização na ligação.
18. Formato de data do NetSuite: o formato de data preferencial definido na IU do NetSuite.
19. Formato de data longo do NetSuite: o formato de data longo preferido definido na IU do NetSuite.
20. Pasta de metadados do Netsuite: um caminho para um diretório a partir do qual transferir ficheiros de metadados do NetSuite. Defina esta opção para ter o melhor desempenho.
21. Report Doubles As Decimal: indica se os valores duplos devem ser comunicados como decimais.
22. Request Memorized Transactions: um valor booleano que indica se quer pedir transações memorizadas quando obtém transações do NetSuite.
23. ID da função: o RoleId é o InternalId da função que vai ser usado para iniciar sessão no NetSuite. Deixe este campo vazio para usar a função predefinida do utilizador.
24. Esquema: o tipo de esquema a usar. Pode selecionar qualquer um dos seguintes valores:
  - SuiteTalk: para conectividade baseada em SOAP.
  - SuiteSQL: para conetividade baseada em REST.
25. Use Async Services: um valor booleano que indica se quer usar serviços assíncronos ao inserir, atualizar e eliminar.
26. Use Internal Names For Customizations: um valor booleano que indica se quer usar nomes internos para personalizações.
27. Use Upserts: um valor booleano que indica se quer realizar uma inserção/atualização quando é usada uma operação de inserção.
28. Desvio do fuso horário do utilizador: o desvio do fuso horário do utilizador, conforme definido nas suas preferências do NetSuite em Página inicial --> Preferências --> Fuso horário. Por exemplo: EST.
29. Profundidade da análise de linhas: o número de linhas a analisar quando se determinam dinamicamente as colunas da tabela.
30. (Opcional) Na secção Definições avançadas, selecione a caixa de verificação Usar proxy para configurar um servidor proxy para a ligação e configurar os seguintes valores:
31. Opcionalmente, clique em + Adicionar etiqueta para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
32. Clicar em Seguinte.
Na secção Destinos, introduza os detalhes do anfitrião remoto (sistema de back-end) ao qual quer estabelecer ligação.
1. Tipo de destino: pode especificar os detalhes do destino como um endereço de anfitrião ou um anexo de serviço. Selecione um dos seguintes tipos de destinos:
  - Endereço do anfitrião: se quiser especificar o nome de anfitrião ou o endereço IP do destino.
  - Associação de serviços: se quiser especificar o ponto final privado para os seus endereços IP internos. A associação de serviços permite-lhe ocultar os seus endereços IP internos da rede externa. Pode criar uma associação do serviço no Google Cloud através da funcionalidade Private Service Connect. Para obter informações sobre a configuração de um Private Service Connect, consulte o artigo Publique serviços geridos.
  Com base na sua seleção do tipo de destino, introduza o endereço do anfitrião ou o nome da associação de serviço.
  
  Para introduzir destinos adicionais, clique em +Adicionar destino.
2. Clicar em Seguinte.
Na secção Autenticação, introduza os detalhes de autenticação.
1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.
  Os seguintes tipos de autenticação são suportados pela ligação do Netsuite:
  - Nome de utilizador e palavra-passe
  - Autenticação baseada em tokens
  - Concessão de código de autorização do OAuth 2.0
2. Clicar em Seguinte.
Rever: reveja os detalhes da ligação e da autenticação.
Clique em Criar.

Configure a autenticação

Introduza os detalhes com base na autenticação que quer usar.

Nome de utilizador e palavra-passe
Autenticação de nome de utilizador e palavra-passe. Isto só é válido para a versão 2020.2 ou anterior do Netsuite.
- Nome de utilizador: nome de utilizador do conetor
- Palavra-passe: Secret do Secret Manager que contém a palavra-passe associada ao conector.

Autenticação baseada em tokens
Autenticação baseada em tokens para o Netsuite. Pode ser usado para esquemas SuiteTalk e SuiteQL.
- ID de cliente OAuth: a chave de consumidor apresentada quando a aplicação foi criada.
- Segredo do cliente OAuth: segredo do Secret Manager que contém o segredo do consumidor apresentado quando a aplicação foi criada.
- Chave de acesso OAuth: o ID do token quando a chave de acesso foi criada.
- Segredo da chave de acesso OAuth: segredo do Secret Manager que contém o segredo da chave quando a chave de acesso foi criada.

OAuth 2.0 – Código de autorização

A autorização da associação é feita com um fluxo de início de sessão do utilizador baseado na Web. Isto só é válido para o esquema SuiteQL.

ID de cliente: o ID de cliente usado para pedir tokens de acesso.
Âmbitos: uma lista separada por vírgulas dos âmbitos necessários.
Segredo do cliente: o segredo do cliente usado para pedir tokens de acesso.

Para o tipo de autenticação Authorization code, depois de criar a associação, deve efetuar alguns passos adicionais para configurar a autenticação. Para mais informações, consulte Passos adicionais após a criação da associação.

Nota: se estiver a usar o tipo de autenticação Authorization code e tiver feito alterações de configuração na sua aplicação externa, tem de voltar a autorizar a ligação HTTP. Para saber como autorizar novamente, consulte o artigo Autorização novamente para o código de autorização.

Passos adicionais após a criação da associação

Se selecionou OAuth 2.0 - Authorization code para a autenticação, tem de realizar os seguintes passos adicionais após criar a associação:

Na página Ligações, encontre a ligação criada recentemente.
Tenha em atenção que o Estado do novo conetor é Autorização necessária.
Clique em Autorização obrigatória.
É apresentado o painel Editar autorização.
Copie o valor do URI de redirecionamento para a sua aplicação externa.
Valide os detalhes da autorização.
Clique em Autorizar.
Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligações.

Nova autorização para o código de autorização

Se estiver a usar o tipo de autenticação Authorization code e tiver feito alterações de configuração na aplicação NetSuite de back-end, tem de autorizar novamente a ligação ao NetSuite. Para autorizar novamente uma associação, siga estes passos:

Clique na associação necessária na página Associações.
É apresentada a página de detalhes da associação.
Clique em Editar para editar os detalhes da associação.
Valide os detalhes de OAuth 2.0 – Código de autorização na secção Autenticação.
Se necessário, faça as alterações necessárias.
Clique em Guardar. Esta ação direciona para a página de detalhes da associação.
Clique em Editar autorização na secção Autenticação. É apresentado o painel Autorizar.
Clique em Autorizar.
Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligações.

Configure o NetSuite

Para gerar o ID de cliente, o segredo do cliente, o ID do token e o segredo do token, faça o seguinte:

Crie uma nova integração no Netsuite.
Forneça detalhes de integração, como o nome, e ative a autenticação baseada em tokens.
Especifique um URL de retorno, como https:cloud.google.com/connectors/oauth?e=ApplicationIntegrationConnectorPaginatedFieldsLaunch%3A%3AApplicationIntegrationConnectorPaginatedFieldsEnabled&project=PROJECT_NAME.
Depois de enviar a integração, recebe um ID de cliente e um segredo do cliente. Guarde estes detalhes.
Configure um registo de utilizador de integração.
Para criar um token e um segredo, navegue para a página inicial, selecione Gerir tokens de acesso e, de seguida, clique em Novo token de acesso. Vai usar estes detalhes para criar uma autenticação baseada em tokens no Google Cloud.

Para obter informações sobre como configurar o Postman, consulte o artigo Importar a coleção do Postman.

Limitações do sistema

O conector do Netsuite pode processar 1 transação por segundo, por nó, e limita todas as transações que excedam este limite. Por predefinição, os Integration Connectors atribuem 2 nós (para uma melhor disponibilidade) a uma ligação.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Nota: o número de nós de conectores de integração é dimensionado automaticamente de forma dinâmica com base na sua utilização. No entanto, se quiser reservar capacidade para grandes volumes sem esperar pela escalabilidade automática, pode ajustar o valor mínimo de nós para uma ligação. São necessários mais nós para processar mais transações para uma associação. Por outro lado, são necessários menos nós se uma associação processar menos transações. Para configurar os valores dos nós, faça o seguinte:

Se for cliente de pagamento conforme o uso, configure o valor mínimo e máximo do nó na página de edição da associação.
Se for cliente com base numa subscrição, contacte o apoio técnico.

O número máximo de transações que um nó pode processar depende de vários fatores. Assim, antes de ajustar os nós mínimos para um melhor débito, é recomendável verificar se os seus sistemas de back-end estão configurados de forma ideal para processar o tráfego necessário.

Use a ligação do NetSuite numa integração

Depois de criar a ligação, esta fica disponível no Apigee Integration e no Application Integration. Pode usar a ligação numa integração através da tarefa Conectores.

Para compreender como criar e usar a tarefa Connectors no Apigee Integration, consulte o artigo Tarefa Connectors.
Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

Exemplos de operações de entidades

Esta secção apresenta as operações de entidades suportadas pelo conector do Netsuite e mostra como realizar algumas das operações de entidades neste conector.

Entidade	Operações suportadas
CreditMemo	LIST, GET, CREATE, UPDATE
Cliente	LIST, GET, CREATE, UPDATE
CustomerPayment	LIST, GET, CREATE, UPDATE
ItemFulfillment	LIST, GET, CREATE
JournalEntry	LIST, GET, CREATE
PurchaseOrder	LIST, GET, CREATE, UPDATE
ReturnAuthorization	LIST, GET, CREATE
SalesOrder	LIST, GET, CREATE, UPDATE
Fornecedor	LIST, GET, CREATE, UPDATE
VendorBill	LIST, GET, CREATE, UPDATE
VendorCredit	LIST, GET, CREATE, UPDATE
VendorPayment	LIST, GET, CREATE, UPDATE
CashRefund	LIST, GET, CREATE
CashSale	LIST, GET, CREATE
CustomerDeposit	LIST, GET
CustomerRefund	LIST, GET
Funcionário(a)	LIST, GET
Estimativa	LIST, GET
Ficheiro	LIST, GET
InventoryAdjustment	LIST, GET, CREATE
InventoryItem	LIST, GET
ItemReceipt	LIST, GET
Oportunidade	LIST, GET
PaycheckJournal	LIST, GET, CREATE
SupportCase	LIST, GET
SupportCaseIssue	LIST, GET
TransferOrder	LIST, GET, CREATE
VendorReturnAuthorization	LIST, GET
WorkOrder	LIST, GET
AssemblyItem	LIST, GET
Contentor	LIST, GET
CustomerCategory	LIST, GET
ItemGroup	LIST, GET
KitItem	LIST, GET
LotNumberedAssemblyItem	LIST, GET
LotNumberedInventoryItem	LIST, GET
NonInventoryPurchaseItem	LIST, GET
NonInventoryResaleItem	LIST, GET
NonInventorySaleItem	LIST, GET
OtherChargePurchaseItem	LIST, GET
OtherChargeResaleItem	LIST, GET
OtherChargeSaleItem	LIST, GET
SerializedAssemblyItem	LIST, GET
SerializedInventoryItem	LIST, GET
ServicePurchaseItem	LIST, GET
ServiceResaleItem	LIST, GET
ServiceSaleItem	LIST, GET
CreditMemo_itemList	CRIAR
Invoice_itemList	CRIAR
PurchaseOrder_itemList	CRIAR
SalesOrder_itemList	CRIAR
VendorBill_itemList	CRIAR
VendorCredit_itemList	CRIAR
VendorPayment_applyList	CRIAR

Quando realiza uma operação de inserção no NetSuite, se não forem especificados todos os campos e dados necessários, a API à qual a entidade está alinhada rejeita o pedido. Isto resulta numa exceção. A exceção pode variar consoante a entidade usada na operação de inserção. Tem de fornecer os elementos publicitários do NetSuite na consulta para inserir dados com êxito. Pode especificar o elemento publicitário através do campo ItemListAggregate, que está disponível em todas as tabelas principais. Segue-se o formato do campo ItemListAggregate:

    "`<ItemList>`\n" +
              "  <Row>\n" +
                      "    <ItemList_Item_InternalId>656</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Item_Name>Iphone 15Pro</ItemList_Item_Name>\n" +
                      "    <ItemList_Line>1</ItemList_Line>\n" +
                      "    <ItemList_Description>Canon PowerShot Camera Test</ItemList_Description>\n" +
                      "    <ItemList_Amount>8500.0</ItemList_Amount>\n" +
                      "    <ItemList_Quantity>17.0</ItemList_Quantity>\n" +
                      "    <ItemList_Price_InternalId>1</ItemList_Price_InternalId>\n" +
                      "    <ItemList_Price_Name>List Price</ItemList_Price_Name>\n" +
                      "    <ItemList_Rate>500.00</ItemList_Rate>\n" +
                      "    <ItemList_Location_InternalId>1</ItemList_Location_InternalId>\n" +
                      "    <ItemList_Location_Name>02: NewYork</ItemList_Location_Name>\n" +
                      "    <ItemList_TaxCode_InternalId>-7</ItemList_TaxCode_InternalId>\n" +
                      "    <ItemList_TaxCode_Name>-Not Taxable-</ItemList_TaxCode_Name>\n" +
                      "    <ItemList_ShipGroup>1</ItemList_ShipGroup>\n" +
                      "    <ItemList_ItemIsFulfilled>false</ItemList_ItemIsFulfilled>\n" +
                      "    <CustomFieldListAggregate>\n" +
                      "      <CustomField InternalId=\"4779\" Type=\"platformCore:StringCustomFieldRef\" ScriptId=\"custcol121\">\n" +
                      "        <Value>1</Value>\n" +
                      "      </CustomField>\n" +
                      "    </CustomFieldListAggregate>\n" +
                      "  </Row>\n" +
                      "  <Row>\n" +
                      "    <ItemList_Item_InternalId>656</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Item_Name>Iphone 15Pro</ItemList_Item_Name>\n" +
                      "    <ItemList_Line>4</ItemList_Line>\n" +
                      "    <ItemList_Description>Canon PowerShot Camera Test</ItemList_Description>\n" +
                      "    <ItemList_Amount>8500.0</ItemList_Amount>\n" +
                      "    <ItemList_Quantity>17.0</ItemList_Quantity>\n" +
                      "    <ItemList_Price_InternalId>1</ItemList_Price_InternalId>\n" +
                      "    <ItemList_Price_Name>List Price</ItemList_Price_Name>\n" +
                      "    <ItemList_Rate>500.00</ItemList_Rate>\n" +
                      "    <ItemList_Location_InternalId>2</ItemList_Location_InternalId>\n" +
                      "    <ItemList_Location_Name>01: California</ItemList_Location_Name>\n" +
                      "    <ItemList_TaxCode_InternalId>-7</ItemList_TaxCode_InternalId>\n" +
                      "    <ItemList_TaxCode_Name>-Not Taxable-</ItemList_TaxCode_Name>\n" +
                      "    <ItemList_ShipGroup>1</ItemList_ShipGroup>\n" +
                      "    <ItemList_ItemIsFulfilled>false</ItemList_ItemIsFulfilled>\n" +
                      "    <CustomFieldListAggregate>\n" +
                      "      <CustomField InternalId=\"4776\" Type=\"platformCore:StringCustomFieldRef\" ScriptId=\"custcol121\">\n" +
                      "        <Value>4</Value>\n" +
                      "      </CustomField>\n" +
                      "    </CustomFieldListAggregate>\n" +
                      "  </Row>\n" +
     "`</ItemList>`;"

Exemplo: listar todas as notas de crédito

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione CreditMemo na lista Entity.
Selecione a operação List e, de seguida, clique em Concluído.
Opcionalmente, na secção Entrada de tarefas da tarefa Conectores, pode filtrar o conjunto de resultados especificando uma cláusula de filtro. Especifique sempre o valor da cláusula de filtro entre aspas simples (').

Exemplo: obtenha um registo CreditMemo

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione CreditMemo na lista Entity.
Selecione a operação GET e, de seguida, clique em Concluído.
Defina o ID da entidade como 1083723, que é a chave a ser transmitida. Para definir o ID da entidade, na secção Mapeador de dados do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza 1083723 no campo Valor de entrada e escolha EntityId como variável local.
Transmita o ID da entidade diretamente. A transmissão de um ID de entidade pode gerar um erro se existirem chaves compostas. Nestes casos, use a cláusula de filtro para especificar o ID.

Exemplo: criar um registo PurchaseOrder

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione PurchaseOrder na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

{
          "Entity_InternalId": "2041",
          "Location_InternalId": "6",
          " + "<ItemList>\n" +
              "  <Row>\n" +
                  "    <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>2</ItemList_Line>\n" +
                  "    <ItemList_Amount>66500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>3</ItemList_Line>\n" +
                  "    <ItemList_Amount>16500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "</ItemList>" + ",
          "Email": "222larabrown@gmail.com"
      }

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:PurchaseOrderconnectorOutputPayload

 {
    "InternalId": "1093053"
  }

Exemplo: crie um registo ReturnAuthorization

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione ReturnAuthorization na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

{
          "Entity_InternalId": "1709",
          "Status": "Approved",
          " + "<ItemList>\n" +
              "  <Row>\n" +
                  "    <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>2</ItemList_Line>\n" +
                  "    <ItemList_Amount>2500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>3</ItemList_Line>\n" +
                  "    <ItemList_Amount>16500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "</ItemList>" + "
      }

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:ReturnAuthorizationconnectorOutputPayload

 {
    "InternalId": "1093053"
  }

Exemplo: crie um registo SalesOrder

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione SalesOrder na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

{
          " + "<ItemList>\n" +
              "  <Row>\n" +
                  "    <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>1</ItemList_Line>\n" +
                  "    <ItemList_Amount>9990900.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Amount>99900.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "</ItemList>" + ",
          "Entity_InternalId": "1709"
      }

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:SalesOrderconnectorOutputPayload

 {
    "InternalId": "1093053"
  }

Exemplo: crie um registo CreditMemo_itemList

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione CreditMemo_itemList na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
{
    "ItemList_Item_InternalId": "945",
    "Entity_InternalId": "1709",
    "Location_InternalId": "5",
    "ItemList_Amount": 7777777.0,
    "ItemList_Description": "Created"
  }
  
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:CreditMemo_itemListconnectorOutputPayload
```
 {
    "InternalId": "1093053",
    "ListId": "1"
  }
  
```

Exemplo: criar um registo de cliente

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Cliente na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
 {
    "CompanyName": "Bcone8",
    "Email": "222larabrown@gmail.com"
  }
  
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:CustomerconnectorOutputPayload
```
{
    "InternalId": "4767"
  } 
  
```

Exemplo: crie um registo Invoice_itemList

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Invoice_itemList na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
 {
    "ItemList_Item_InternalId": "945",
    "Entity_InternalId": "1709",
    "ItemList_Amount": 945.0,
    "Item": "InvoiceItem"
  }
  
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:Invoice_itemListconnectorOutputPayload
```
 {
    "InternalId": "1093052",
    "ListId": "1"
  } 
  
```

Exemplo: criar um registo CustomerPayment

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione CustomerPayment na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
 {
    "Customer_InternalId": "1714",
    "Payment": 9999.0
  } 
  
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:CustomerPaymentconnectorOutputPayload
```
 {
    "InternalId": "1090749"
  } 
  
```

Exemplo: criar um registo PurchaseOrder_itemList

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione PurchaseOrder_itemList na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
 {
    "Entity_InternalId": "2041",
    "Location_InternalId": "6",
    "ItemList_Description": "Created on Jan 11",
    "ItemList_Item_InternalId": "979"
  } 
  
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:PurchaseOrder_itemListconnectorOutputPayload
```
 {
    "InternalId": "1093151",
    "ListId": "1"
  }  
  
```

Exemplo: crie um registo SalesOrder_itemList

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione SalesOrder_itemList na Entity lista.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
 {
    "Email": "222larabrown@gmail.com",
    "Entity_InternalId": "1709",
    "ItemList_Item_InternalId": "945",
    "ItemList_Amount": 1000.0
  }
  
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:SalesOrder_itemListconnectorOutputPayload
```
  {
    "InternalId": "1093351",
    "ListId": "1"
  }  
  
```

Exemplo: crie um registo de fornecedor

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Fornecedor na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
 {
    "CompanyName": "Deloitte",
    "LegalName": "AU Vendor"
  } 
  
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:VendorconnectorOutputPayload
```
 {
    "InternalId": "5067"
  }  
  
```

Exemplo: crie um registo VendorBill_itemList

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione VendorBill_itemList na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
 {
    "Entity_InternalId": "2041",
    "ItemList_Item_InternalId": "1374",
    "ItemList_Amount": 700.0
  } 
  
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:VendorBill_itemListconnectorOutputPayload
```
 {
    "InternalId": "5067"
  }  
  
```

Exemplo: crie um registo VendorCredit_itemList

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione VendorCredit_itemList na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
 {
    "Entity_InternalId": "2041",
    "Location_InternalId": "6",
    "ItemList_Item_InternalId": "992",
    "ItemList_Description": "Created on Jan 12"
  }
  
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:VendorCredit_itemListconnectorOutputPayload
```
 {
    "InternalId": "1093353",
    "ListId": "1"
  }  
  
```

Exemplo: crie um registo VendorPayment_applyList

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione VendorPayment_applyList na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
 {
    "ApplyList_Doc": 3339.0,
    "ApplyList_Apply": true,
    "Entity_InternalId": "1471"
  }
  
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:VendorPayment_applyListconnectorOutputPayload
```
 {
    "InternalId": "1093756",
    "ListId": "1"
  }   
  
```

Exemplo: criar um registo CreditMemo

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione CreditMemo na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

{
          "ItemListAggregate": " + "<ItemList>\n" +
                 "  <Row>\n" +
                 "    <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" +
                 "    <ItemList_Line>2</ItemList_Line>\n" +
                 "    <ItemList_Amount>8800.0</ItemList_Amount>\n" +
                 "  </Row>\n" +
                 "  <Row>\n" +
                 "    <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" +
                 "    <ItemList_Line>3</ItemList_Line>\n" +
                 "    <ItemList_Amount>9900.0</ItemList_Amount>\n" +
                 "  </Row>\n" +
                 "</ItemList>" + ",
          "Entity_InternalId": "11",
          "Email": "222larabrown@gmail.com"
      }

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:CreditMemoconnectorOutputPayload

{
    "InternalId": "106"
  }

Exemplo: crie um registo de fatura

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Fatura na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

{
          "ItemListAggregate": " + "<ItemList>\n" +
              "  <Row>\n" +
                  "    <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>1</ItemList_Line>\n" +
                  "    <ItemList_Amount>7998500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>2</ItemList_Line>\n" +
                  "    <ItemList_Amount>6500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "</ItemList>" + ",
          "Memo": "May9"
      }

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:InvoiceconnectorOutputPayload

{
    "InternalId": "206"
  }

Exemplo: crie um registo ItemFulfillment

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione ItemFulfillment na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
{
    "CreatedFrom_InternalId": "411",
    "ShipStatus": "_picked"
  } 
  
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:ItemFulfillmentconnectorOutputPayload
```
{
    "InternalId": "412"
  }
  
```

Exemplo: crie um registo JournalEntry

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione JournalEntry na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

{
          "Subsidiary_InternalId": "1",
          "Memo": "Journal Entry created on April 2",
          "LineListAggregate":" + "<LineList>\n" +
              "  <Row>\n" +
                  "    <LineList_Account_InternalId>1</LineList_Account_InternalId>\n" +
                  "    <LineList_Line>1</LineList_Line>\n" +
                  "    <LineList_credit>500.0</LineList_credit>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <LineList_Account_InternalId>1</LineList_Account_InternalId>\n" +
                  "    <LineList_Line>1</LineList_Line>\n" +
                  "    <LineList_debit>500.00</LineList_debit>\n" +
                  "  </Row>\n" +
                  "</LineList>" + "
      }

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:JournalEntryconnectorOutputPayload

{
    "InternalId": "612"
  }

Exemplo: criar um registo PurchaseOrder

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione PurchaseOrder na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

{
          "Entity_InternalId": "2041",
          "Location_InternalId": "6",
          " + "<ItemList>\n" +
              "  <Row>\n" +
                  "    <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>2</ItemList_Line>\n" +
                  "    <ItemList_Amount>66500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>3</ItemList_Line>\n" +
                  "    <ItemList_Amount>16500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "</ItemList>" + ",
          "Email": "222larabrown@gmail.com"
      }

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:PurchaseOrderconnectorOutputPayload

{
    "InternalId": "1116228"
  }

Exemplo: crie um registo VendorBill

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione VendorBill na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

  {"Entity_InternalId": "12",
  " + "<ItemList>\n" +
              "  <Row>\n" +
                      "    <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>1</ItemList_Line>\n" +
                      "    <ItemList_Amount>77700.0</ItemList_Amount>\n" + +
                      "  </Row>\n" +
                      "  <Row>\n" +
                      "    <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>2</ItemList_Line>\n" +
                      "    <ItemList_Amount>888888</ItemList_Amount>\n" + +
                      "  </Row>\n" +
                      "</ItemList>;" + "}

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:VendorBillconnectorOutputPayload

{
    "InternalId": "816"
  }

Exemplo: crie um registo VendorCredit

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione VendorCredit na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

{"Entity_InternalId": "12",
  " + "<ItemList>\n" +
              "  <Row>\n" +
                      "    <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>1</ItemList_Line>\n" +
                      "    <ItemList_Amount>77700.0</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "  <Row>\n" +
                      "    <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>2</ItemList_Line>\n" +
                      "    <ItemList_Amount>888888</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "</ItemList>;" + "}

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:VendorCreditconnectorOutputPayload

{
    "InternalId": "818"
  }

Exemplo: crie um registo VendorPayment

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione VendorPayment na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
{
    "Entity_InternalId": "12",
    "ApplyList_Apply": true,
    "ApplyList_Doc": 714.0
  }       
  
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:VendorPaymentconnectorOutputPayload
```
{
    "InternalId": "1025",
    "ListId": "1"
  } 
  
```

Exemplo: crie um registo TRANSFERORDER

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione TRANSFERORDER na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

{
  "Location_InternalId": "1",
  "TransferLocation_InternalId": "3",
  "ItemListAggregate": 
   " + "<ItemList>\n" +
              "  <Row>\n" +
              "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
              "    <ItemList_Line>1</ItemList_Line>\n" +
              "    <ItemList_Amount>77700.0</ItemList_Amount>\n" +
              "  </Row>\n" +
              "  <Row>\n" +
              "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
              "    <ItemList_Line>2</ItemList_Line>\n" +
              "    <ItemList_Amount>888888</ItemList_Amount>\n" +
              "  </Row>\n" +
              "</ItemList>;"
  }

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:TRANSFERORDERconnectorOutputPayload

{
  "InternalId": "1337"
  }

Exemplo: crie um registo CashSale

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione CashSale na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

{
  "Entity_InternalId": "10",
  "Location_InternalId": "3",
  "ItemListAggregate": 
   "<ItemList>\n" +
              "  <Row>\n" +
              "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
              "    <ItemList_Line>1</ItemList_Line>\n" +
              "    <ItemList_Amount>77700.0</ItemList_Amount>\n" +
              "  </Row>\n" +
              "  <Row>\n" +
              "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
              "    <ItemList_Line>2</ItemList_Line>\n" +
              "    <ItemList_Amount>888888</ItemList_Amount>\n" +
              "  </Row>\n" +
              "</ItemList>;"
  }

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:CashSaleconnectorOutputPayload

{
  "InternalId": "1234"
  }

Exemplo: crie um registo PaycheckJournal

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione PaycheckJournal na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

{
  "Employee_InternalId": "8",
  "Account_InternalId": "314",
  "EarningListAggregate":  
   "<EarningList>\n" +
              "  <Row>\n" +
              "    <EarningList_PayrollItem_InternalId>2</EarningList_PayrollItem_InternalId>\n" +
              "    <EarningList_Amount>1998</EarningList_Amount>\n" +
              "  </Row>\n" +
              "</EarningList>;"
  }

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:PaycheckJournalconnectorOutputPayload

{
  "InternalId": "1746"
  }

Exemplo: crie um registo InventoryAdjustment

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione InventoryAdjustment na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

{
  "Account_InternalId": "1",
  "AdjLocation_InternalId": "1",
  "Location_InternalId": "3",
  "InventoryListAggregate": 
   "<InventoryList>\n" +
              "  <Row>\n" +
              "    <InventoryList_Item_InternalId>8</InventoryList_Item_InternalId>\n" +
              "    <InventoryList_Line>1</InventoryList_Line>\n" +
              "    <InventoryList_Location_InternalId>1</InventoryList_Location_InternalId>\n" +
              "    <InventoryList_AdjustQtyBy>100</InventoryList_AdjustQtyBy>\n" +
              "  </Row>\n" +
              "</InventoryList>;"
  }

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:InventoryAdjustmentconnectorOutputPayload

{
  "InternalId": "1640"
  }

Exemplo: crie um registo CashRefund

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione CashRefund na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.

{
  "Entity_InternalId": "10",
  "Location_InternalId": "3",
  "ItemListAggregate": 
   "<ItemList>\n" +
              "  <Row>\n" +
              "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
              "    <ItemList_Line>1</ItemList_Line>\n" +
              "    <ItemList_Amount>799.0</ItemList_Amount>\n" +
              "  </Row>\n" +
              "  <Row>\n" +
              "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
              "    <ItemList_Line>2</ItemList_Line>\n" +
              "    <ItemList_Amount>666</ItemList_Amount>\n" +
              "  </Row>\n" +
              "</ItemList>;"
  }

Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:CashRefundconnectorOutputPayload

{
  "InternalId": "1232"
  }

Exemplo: atualizar um registo CreditMemo

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione CreditMemo na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
{
    "Email2": "222larabrown@gmail.com"
  } 
  
```
Defina o ID da entidade no mapeador de dados para a entidade da nota de crédito. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em alternativa, em vez de especificar o entityId, também pode definir a filterClause como 1090651.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:
```
 {
    "InternalId": "1090651"
  } 
  
```

Exemplo: atualize um registo de cliente

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Cliente na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
 {
    "Email": "222larabrown@gmail.com"
  } 
  
```
Defina o ID da entidade no Mapeador de dados para a entidade do cliente. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em alternativa, em vez de especificar o entityId, também pode definir a filterClause como 4767.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:
```
 {
    "InternalId": "4767"
  } 
  
```

Exemplo: atualize um registo de fatura

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Fatura na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
  {
    "Email2": "222larabrown@gmail.com"
  } 
  
```
Defina o ID da entidade no mapeador de dados para a entidade da fatura. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em alternativa, em vez de especificar o entityId, também pode definir a filterClause como 1083927.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:
```
 {
    "InternalId": "1083927"
  } 
  
```

Exemplo: atualize um registo CustomerPayment

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione CustomerPayment na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
 {
    "Customer_InternalId": "1714",
    "Payment": 7.77777777E8
  } 
  
```
Defina o ID da entidade no mapeador de dados para a entidade do CustomerPayment. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em alternativa, em vez de especificar o entityId, também pode definir a filterClause como 1090749.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:
```
 {
    "InternalId": "1090749"
  } 
  
```

Exemplo: atualizar um registo PurchaseOrder

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione PurchaseOrder na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
 {
    "Message": "Aspirin Updated"
  } 
  
```
Defina o ID da entidade no mapeador de dados para a entidade de PurchaseOrder. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em alternativa, em vez de especificar o entityId, também pode definir a filterClause como 1000.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:
```
 {
    "InternalId": "1000"
  } 
  
```

Exemplo: atualizar um registo SalesOrder

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione PurchaseOrder na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
 {
    "Email": "222larabrown@gmail.com",
    "Entity_InternalId": "1709",
    "Item_InternalId": "945"
  }
  
```
Defina o ID da entidade no mapeador de dados para a entidade de SalesOrder. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em alternativa, em vez de especificar o entityId, também pode definir a filterClause como 1086949.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:
```
 {
    "InternalId": "1086949"
  } 
  
```

Exemplo: atualizar um registo de fornecedor

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Fornecedor na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
 {
    "CompanyName": "Deloitte_Updated"
  } 
  
```
Defina o ID da entidade no mapeador de dados para a entidade do fornecedor. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em alternativa, em vez de especificar o entityId, também pode definir a filterClause como 4567.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:
```
 {
    "InternalId": "4567"
  } 
  
```

Exemplo: atualize um registo VendorBill

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione VendorBill na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
  {
    "Memo": "Memo_Jan 11"
  } 
  
```
Defina o ID da entidade no mapeador de dados para a entidade da fatura do fornecedor. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em alternativa, em vez de especificar o entityId, também pode definir a filterClause como 3339.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:
```
 {
    "InternalId": "3339"
  } 
  
```

Exemplo: atualize um registo VendorCredit

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione VendorCredit na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
 {
    "Memo": "16253"
  } 
  
```
Defina o ID da entidade no mapeador de dados para a entidade do VendorCredit. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em alternativa, em vez de especificar o entityId, também pode definir a filterClause como 1091549.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:
```
 {
    "InternalId": "1091549"
  } 
  
```

Exemplo: atualizar um registo VendorPayment

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione VendorPayment na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
  {
    "Memo": "Jan8"
  } 
  
```
Defina o ID da entidade no mapeador de dados para a entidade do VendorPayment. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em alternativa, em vez de especificar o entityId, também pode definir a filterClause como 1082627.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:
```
 {
    "InternalId": "1082627"
  } 
  
```

Crie ligações com o Terraform

Pode usar o recurso do Terraform para criar uma nova associação.

Para saber como aplicar ou remover uma configuração do Terraform, consulte os comandos básicos do Terraform.

Para ver um modelo do Terraform de exemplo para a criação de ligações, consulte o modelo de exemplo.

Quando criar esta associação através do Terraform, tem de definir as seguintes variáveis no ficheiro de configuração do Terraform:

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
account_id	STRING	True	A conta empresarial à qual o seu nome de utilizador está associado no NetSuite.
aggregate_column_mode	STRING	Falso	Indicando como as colunas de agregação devem ser tratadas.
application_id	STRING	Falso	A partir da versão 2020.1, os pedidos ao NetSuite requerem um ID da aplicação.
custom_field_permissions	STRING	Falso	Uma lista separada por vírgulas de autorizações de campos personalizados. Dá mais controlo do que IncludeCustomFieldColumns .
include_child_tables	BOOLEAN	Falso	Um valor Booleano que indica se as tabelas secundárias devem ser apresentadas.
include_custom_field_columns	BOOLEAN	Falso	Um valor booleano que indica se quer incluir colunas de campos personalizados.
include_custom_list_tables	BOOLEAN	Falso	Um valor Booleano que indica se quer usar tabelas baseadas em listas personalizadas.
include_custom_record_tables	BOOLEAN	Falso	Um valor booleano que indica se quer usar tabelas baseadas em tipos de registos personalizados.
include_reference_columns	STRING	Falso	Uma lista separada por vírgulas que representa as colunas a incluir quando são obtidos dados de um campo que representa uma referência de registo.
maximum_concurrent_sessions	INTEGER	Falso	O número máximo de sessões simultâneas disponíveis para utilização na ligação.
net_suite_date_format	STRING	Falso	O formato de data preferido definido na IU do NetSuite.
net_suite_long_date_format	STRING	Falso	O formato de data longo preferido definido na IU do NetSuite.
netsuite_metadata_folder	STRING	Falso	Um caminho para um diretório a partir do qual transferir ficheiros de metadados do NetSuite. Defina esta opção para ter o melhor desempenho.
report_doubles_as_decimal	BOOLEAN	Falso	Indica se os números de vírgula flutuante devem ser comunicados como decimais.
request_memorized_transactions	BOOLEAN	Falso	Um valor booleano que indica se quer pedir transações memorizadas quando obtém transações do NetSuite.
role_id	STRING	Falso	O RoleId é o InternalId da função que vai ser usada para iniciar sessão no NetSuite. Deixe este campo vazio para usar a função predefinida do utilizador.
esquema	STRING	True	O tipo de esquema a usar.
use_async_services	BOOLEAN	Falso	Um valor booleano que indica se quer usar serviços assíncronos ao inserir, atualizar e eliminar.
use_internal_names_for_customizations	BOOLEAN	Falso	Um valor booleano que indica se quer usar nomes internos para personalizações.
use_upserts	BOOLEAN	Falso	Um valor booleano que indica se quer fazer uma inserção/atualização quando é usada uma operação de inserção.
user_timezone_offset	STRING	Falso	A diferença do fuso horário do utilizador, conforme definido nas suas preferências do NetSuite em Página inicial --> Preferências --> Fuso horário. Por exemplo: EST.
row_scan_depth	STRING	Falso	O número de linhas a analisar quando determina dinamicamente as colunas da tabela.
verbosidade	STRING	Falso	Nível de verbosidade para a ligação, varia de 1 a 5. Um nível de detalhe mais elevado regista todos os detalhes de comunicação (pedido,resposta e certificados SSL).
proxy_enabled	BOOLEAN	Falso	Selecione esta caixa de verificação para configurar um servidor proxy para a ligação.
proxy_auth_scheme	ENUM	Falso	O tipo de autenticação a usar para autenticar no proxy ProxyServer. Os valores suportados são: BASIC, DIGEST, NONE
proxy_user	STRING	Falso	Um nome de utilizador a ser usado para autenticar no proxy ProxyServer.
proxy_password	SECRET	Falso	Uma palavra-passe a usar para autenticar no proxy ProxyServer.
proxy_ssltype	ENUM	Falso	O tipo de SSL a usar quando se liga ao proxy ProxyServer. Os valores suportados são: AUTO, ALWAYS, NEVER, TUNNEL

Obtenha ajuda da comunidade do Google Cloud

Pode publicar as suas perguntas e discutir este conector na comunidade do Google Cloud nos Fóruns do Cloud.

O que se segue?

Compreenda como suspender e retomar uma associação.
Compreenda como monitorizar a utilização do conector.
Compreenda como ver os registos do conetor.