Conectando o Oracle NetSuite

A conexão com o Oracle NetSuite acontece em dois passos: primeiro você salva as credenciais do Integration Record criado na conta da empresa, depois autoriza o acesso no próprio NetSuite. A ordem é imposta pelo NetSuite — o Client ID nasce do record criado na conta, então o botão de autorizar só aparece depois do formulário salvo.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.

Antes de começar

Quem cria o Integration Record costuma ser o administrador do NetSuite. Peça a ele:

• um Integration Record criado em Setup → Integration → Manage Integrations, com Authorization Code Grant e escopo REST Web Services;
• a URL de retorno cadastrada no record exatamente igual à que a Toca mostra no card de conexão — o NetSuite exige que ela seja idêntica a uma URI cadastrada;
• o Client ID e o Client Secret gerados ao salvar o record — eles aparecem uma única vez;
• o Account ID da conta, que está em Setup → Company → Company Information.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Oracle NetSuite e clique no botão de conexão. O card mostra a URL de retorno que precisa estar cadastrada no Integration Record — copie-a e envie ao administrador antes de ele criar o record.
3. Preencha os três campos e salve:
   • Account ID — ex.: 1234567.
   • Client ID — gerado ao salvar o Integration Record.
   • Client Secret — o segredo correspondente ao Client ID.
4. Clique em Autorizar no NetSuite e aprove o acesso na tela do NetSuite. Ao voltar, o card fica marcado como conectado.

O que a Toca acessa

Com a conexão ativa, a Toca lê faturas, pedidos de venda e de compra, clientes, fornecedores, itens e estoque, e o financeiro da empresa. A integração é somente leitura: a Toca não cria, não altera e não exclui nada no NetSuite. Como o NetSuite limita o acesso simultâneo por conta, a Toca faz uma chamada por vez para não disputar espaço com as outras integrações da empresa.

Manutenção da conexão

O NetSuite derruba a autorização depois de 7 dias sem uso. Se isso acontecer, abra o card em Configurações → Integrações e clique em Autorizar de novo — as credenciais salvas continuam valendo, não é preciso preencher o formulário outra vez. Se o administrador recriar o Integration Record, salve o novo Client ID e o novo Client Secret e autorize de novo.

Problemas comuns

• A autorização falha ao abrir o NetSuite — a URL de retorno cadastrada no Integration Record precisa ser idêntica à mostrada no card da Toca. Qualquer diferença faz o NetSuite recusar o fluxo.
• Pedem autorização de novo depois de um período parado — é o limite de 7 dias sem uso do NetSuite. Basta clicar em Autorizar de novo no card.
• Client Secret perdido — ele aparece uma única vez, ao salvar o record. Se foi perdido, o administrador precisa gerar novas credenciais no Integration Record.
• Dúvida sobre qual produto conectar — o Oracle Fusion Cloud ERP é outro produto da Oracle, de grande porte, com card e guia próprios. Este guia é do NetSuite, o ERP em nuvem de médio porte.