📦 NetSuite
v1.0.4NetSuite 集成。管理会计和 ERP 数据、记录和工作流。用于用户与 NetSuite 数据交互时。
详细分析 ▾
运行时依赖
安装命令
点击复制技能文档
NetSuite
NetSuite 是一个基于云的企业资源规划(ERP)软件套件。它帮助企业管理各种操作,如会计、库存和供应链。它通常被中型至大型公司使用。
官方文档:https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/index.html
NetSuite 概述
客户
供应商
员工
销售订单
采购订单
发票
项目
会计
交易
使用 NetSuite
该技能使用 Membrane CLI 与 NetSuite 交互。Membrane 自动处理身份验证和凭证刷新,因此您可以专注于集成逻辑而不是身份验证。
安装 CLI
安装 Membrane CLI,以便您可以从终端运行 membrane:
npm install -g @membranehq/cli@latest
身份验证
membrane login --tenant --clientName=
这将打开浏览器进行身份验证或在控制台打印授权 URL,具体取决于是否可用交互模式。
无头环境:命令将打印授权 URL。要求用户在浏览器中打开它。
当他们完成登录并看到代码时,完成以下操作:
membrane login complete
将 --json 添加到任何命令以获取机器可读的 JSON 输出。
代理类型:claude、openclaw、codex、warp、windsurf 等。这些将用于调整工具以便与您的工具包配合使用。
连接到 NetSuite
使用 membrane connection ensure 通过应用程序 URL 或域找到或创建连接:
membrane connection ensure "https://www.netsuite.com/" --json
用户在浏览器中完成身份验证。输出包含新的连接 ID。这是获取连接的最快方式。URL 被规范化为域并与已知应用程序匹配。如果找不到应用程序,则创建一个应用程序并自动构建连接器。
如果返回的连接具有状态:“READY”,则跳转到步骤 2。
1b. 等待连接就绪
如果连接处于 BUILDING 状态,请轮询直到它就绪:
npx @membranehq/cli connection get --wait --json
--wait 标志长轮询(最多 --timeout 秒, 默认 30)直到状态更改。继续轮询直到状态不再是 BUILDING。结果状态告诉您下一步该做什么:
READY — 连接已完全设置。跳转到步骤 2。
CLIENT_ACTION_REQUIRED — 用户或代理需要执行某些操作。clientAction 对象描述了所需的操作:
clientAction.type — 所需操作的类型:“connect” — 用户需要身份验证(OAuth、API 密钥等)。这涵盖了初始身份验证和断开连接的重新身份验证。
“provide-input” — 需要更多信息(例如要连接到的应用程序)。
clientAction.description — 人类可读的所需操作的解释。
clientAction.uiUrl(可选)— 预建 UI 的 URL,用户可以在其中完成操作。当存在时,请向用户显示。
clientAction.agentInstructions(可选)— AI 代理如何继续处理的说明。
用户完成操作(例如在浏览器中身份验证)后,再次使用 membrane connection get --json 轮询以检查状态是否已移动到 READY。
CONFIGURATION_ERROR 或 SETUP_FAILED — 出错了。请检查错误字段以获取详细信息。
搜索操作
使用自然语言描述您要执行的操作进行搜索:
membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json
您应该始终在特定连接的上下文中搜索操作。每个结果包括 id、name、description、inputSchema(操作接受的参数)和 outputSchema(它返回的内容)。
热门操作
名称
关键字
描述
列出客户
list-customers
从 NetSuite 检索客户的分页列表
列出供应商
list-vendors
从 NetSuite 检索供应商的分页列表
列出员工
list-employees
从 NetSuite 检索员工的分页列表
列出联系人
list-contacts
从 NetSuite 检索联系人,带有可选的筛选和分页
列出销售订单
list-sales-orders
从 NetSuite 检索销售订单的分页列表
列出采购订单
list-purchase-orders
从 NetSuite 检索采购订单的分页列表
列出发票
list-invoices
从 NetSuite 检索发票的分页列表
列出日记账目条目
list-journal-entries
从 NetSuite 检索日记账目条目的分页列表
列出库存项目
list-inventory-items
从 NetSuite 检索库存项目,带有可选的筛选和分页
获取客户
get-customer
通过 ID 从 NetSuite 检索单个客户
获取供应商
get-vendor
通过 ID 从 NetSuite 检索单个供应商
获取员工
get-employee
通过 ID 从 NetSuite 检索单个员工
获取联系人
get-contact
通过 ID 从 NetSuite 检索特定联系人
获取销售订单
get-sales-order
通过 ID 从 NetSuite 检索单个销售订单
获取采购订单
get-purchase-order
通过 ID 从 NetSuite 检索单个采购订单
获取发票
get-invoice