Automação NetSuite

Automatize operações do ERP Oracle NetSuite, incluindo a criação de clientes e pedidos de venda, execução de consultas SuiteQL, atualização de registros por ID externo e inspeção de metadados de registros para gerenciamento empresarial abrangente.

Documentação do Toolkit: composio.dev/toolkits/netsuite

Configuração

Esta habilidade requer o servidor Rube MCP conectado em https://rube.app/mcp.

Antes de executar qualquer ferramenta, certifique-se de que uma conexão ativa exista para o toolkit netsuite. Se nenhuma conexão estiver ativa, inicie uma através de RUBE_MANAGE_CONNECTIONS.

Fluxos de Trabalho Principais

1. Criar Pedidos de Venda

Crie pedidos de clientes com itens de linha, incluindo referências de item, quantidades e preços.

Ferramenta: NETSUITE_CREATE_SALES_ORDER

Parâmetros Principais:

• entity (obrigatório) -- Referência do cliente: {"id": "<internal_id>"}
• item (obrigatório) -- Contêiner com array items, cada um contendo:
  • item (obrigatório) -- Referência do item: {"id": "<internal_id>"}
  • quantity (obrigatório) -- Unidades a serem pedidas (não negativo)
  • rate -- Preço unitário (opcional se o item tiver preços padrão)
  • amount -- Valor total da linha (alternativa à taxa)
  • taxcode -- Referência do código de imposto: {"id": "<internal_id>"} (obrigatório se SuiteTax estiver ativado)
  • description -- Notas do item de linha
• tranDate -- Data da transação no formato YYYY-MM-DD
• memo -- Memo do cabeçalho
• orderStatus -- "A" (Aguardando Aprovação) ou "B" (Aguardando Atendimento)
• otherrefnum -- Referência externa ou número do PO

Exemplo:

Tool: NETSUITE_CREATE_SALES_ORDER
Arguments:
  entity: {"id": "1234"}
  item: {
    "items": [
      {"item": {"id": "56"}, "quantity": 10, "rate": 25.00},
      {"item": {"id": "78"}, "quantity": 5, "rate": 50.00}
    ]
  }
  tranDate: "2026-02-11"
  memo: "Q1 bulk order"
  orderStatus: "B"

2. Executar Consultas SuiteQL

Execute consultas SQL ad-hoc contra dados do NetSuite com paginação no lado do servidor.

Ferramenta: NETSUITE_RUN_SUITEQL_QUERY

Parâmetros Principais:

• q (obrigatório) -- Declaração SELECT SuiteQL
• limit -- Linhas por página (o padrão varia)
• offset -- Índice baseado em zero da primeira linha (deve ser um múltiplo de limit)

Exemplos:

Tool: NETSUITE_RUN_SUITEQL_QUERY
Arguments:
  q: "SELECT id, companyname, email FROM customer WHERE isinactive = 'F' ORDER BY companyname"
  limit: 100
  offset: 0

Tool: NETSUITE_RUN_SUITEQL_QUERY
Arguments:
  q: "SELECT id, entitystatus, total FROM transaction WHERE type = 'SalesOrd' AND trandate >= '2026-01-01'"
  limit: 50

3. Criar e Gerenciar Clientes

Crie novos registros de clientes com atribuição de subsidiária e detalhes de contato.

Ferramentas:

• NETSUITE_CREATE_CUSTOMER -- Criar um novo cliente
• NETSUITE_GET_CUSTOMER -- Recuperar cliente por ID interno
• NETSUITE_UPDATE_CUSTOMER -- Atualizar cliente existente (semântica PATCH)

Parâmetros Principais para NETSUITE_CREATE_CUSTOMER:

• body (obrigatório) -- Objeto JSON com dados do cliente. Campos obrigatórios:
  • subsidiary -- Objeto com id (ID interno da subsidiária)
  • Ou companyName (para empresas) ou firstName + lastName (para indivíduos)
  • Opcional: email, phone, isPerson (definir como "T" para indivíduos), comments
• replace -- Nomes de sublistas separados por vírgula para substituir completamente (por exemplo, "contacts,addressbook")

Exemplo:

Tool: NETSUITE_CREATE_CUSTOMER
Arguments:
  body: {
    "companyName": "Acme Corp",
    "subsidiary": {"id": "1"},
    "email": "info@acme.com",
    "phone": "555-0100"
  }

4. Atualizar Registros por ID Externo

Crie ou atualize registros de forma idempotente usando um identificador externo. Essencial para fluxos de trabalho de sincronização.

Ferramenta: NETSUITE_UPSERT_RECORD_BY_EXTERNAL_ID

Parâmetros Principais:

• record_type (obrigatório) -- Nome do tipo de registro, por exemplo, "customer", "salesorder", "customrecord_myrec"
• external_id (obrigatório) -- Valor do ID externo (apenas letras, números, sublinhado, hífen)
• body (obrigatório) -- Objeto JSON correspondente ao esquema do registro; inclua campos obrigatórios ao criar

Exemplo:

Tool: NETSUITE_UPSERT_RECORD_BY_EXTERNAL_ID
Arguments:
  record_type: "customer"
  external_id: "CRM-CUST-42"
  body: {
    "companyName": "Acme Corp",
    "subsidiary": {"id": "1"},
    "email": "updated@acme.com"
  }

Aviso: A idempotência depende do uso consistente do ID externo. Inconsistências criam silenciosamente registros adicionais em vez de atualizar.

5. Inspecionar Metadados de Registros

…