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 系统配置与权限管理。
