yscli — YonSuite CLI

YonSuite 业务数据查询与分析命令行工具。查询走 YonSuite API，输出支持表格/JSON/CSV/pretty。

安装

pip install git+https://atomgit.com/gcw_cJbJuamU/yonsuiteCLI.git

配置

| 环境变量 | 必需 | 说明 | |---------|------|------| | YONSUITE_APP_KEY | 是 | App Key | | YONSUITE_APP_SECRET | 是 | App Secret | | YONSUITE_TENANT_ID | 是 | 租户 ID |

三层指令体系

快捷命令

高频场景一键直达：

yscli weekly-sales           # 本周销售汇总
yscli monthly-sales          # 本月销售订单
yscli monthly-purchase       # 本月采购订单
yscli monthly-production     # 本月生产订单
yscli current-stock          # 现存量查询
yscli opportunities          # 商机列表
yscli search-customer        # 搜索客户档案
yscli search-product         # 搜索物料档案
yscli search-vendor          # 搜索供应商档案

API 命令

元数据驱动的 API 调用，覆盖所有标准接口：

yscli sales order list --params '{"pageSize": 20}'
yscli purchase order list --params '{"pageSize": 20}'
yscli stock query --params '{"warehouse": "主仓库"}'

Raw API

万能兜底，直接调用 YonSuite OpenAPI：

yscli api POST /yonbip/scm/saleorder/list --data '{"pageSize": 10}'

输出格式

yscli <command> --format json        # JSON 输出
yscli <command> --format table       # 表格输出
yscli <command> --format csv         # CSV 输出
yscli <command> --format pretty      # 格式化输出
yscli <command> --format normalized  # 精简表格输出

适用场景

查 YonSuite 业务数据——销售订单、采购订单、生产工单、库存现存量、商机列表；查基础档案——客户、供应商、物料、组织；做数据分析并出 HTML 报告。

不适用：非 YonSuite 平台的查询、纯财务凭证/账簿/总账、YonSuite 系统配置与权限管理。