# 高级 API 操作

> 本文件包含金蝶 K3Cloud WebAPI 的高级操作（基础资料分配、工作流审批、组织切换、业务信息查询、报表查询、合并报表）。主 SKILL.md 只包含常用操作（查询/查看/保存/删除/提交/审核/反审核/下推/自定义操作），需要时按本文件执行。

## 基础资料分配（Allocate）/ 取消分配（CancelAllocate）

将基础资料分配给目标组织。

```
POST {server_url}Kingdee.BOS.WebApi.ServicesStub.BusinessDataService.Allocate.common.kdsvc
POST {server_url}Kingdee.BOS.WebApi.ServicesStub.BusinessDataService.CancelAllocate.common.kdsvc

[
  "{formId}",
  {
    "PkIds": "100001,100002",
    "TOrgIds": "1,2,3"
  }
]
```

`PkIds`：基础资料内码，逗号分隔。`TOrgIds`：目标组织内码，逗号分隔。

## 基础资料分组操作

### 分组保存（GroupSave）

```
POST {server_url}Kingdee.BOS.WebApi.ServicesStub.BusinessDataService.GroupSave.common.kdsvc

[
  "{formId}",
  {group_data}
]
```

### 分组删除（GroupDelete）

```
POST {server_url}Kingdee.BOS.WebApi.ServicesStub.BusinessDataService.GroupDelete.common.kdsvc

[
  {
    "FormId": "{formId}",
    "GroupFieldKey": "{group_field_key}",
    "GroupPkIds": "{group_pk_ids}"
  }
]
```

### 分组信息查询（QueryGroupInfo）

```
POST {server_url}Kingdee.BOS.WebApi.ServicesStub.BusinessDataService.QueryGroupInfo.common.kdsvc

[
  {
    "FormId": "{formId}",
    "GroupFieldKey": "{group_field_key}",
    "GroupPkIds": "{group_pk_ids}",
    "Ids": ""
  }
]
```

## 工作流审批（WorkflowAudit）

```
POST {server_url}Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.WorkflowAudit.common.kdsvc

[
  {
    "FormId": "SAL_SaleOrder",
    "Numbers": ["SO-2026-001"],
    "UserId": 12345,
    "ApprovalType": 1
  }
]
```

| 参数 | 说明 |
|------|------|
| `FormId` | 表单标识 |
| `Numbers` | 单据编号列表 |
| `UserId` | 审批人内码（`T_SEC_USER.FUSERID`） |
| `ApprovalType` | `1`=通过，`2`=驳回，`3`=终止 |

## 切换组织（SwitchOrg）

```
POST {server_url}Kingdee.BOS.WebApi.ServicesStub.UserService.SwitchOrg.common.kdsvc

[
  {"Model": {"FSALEORGID": {"FNumber": "{sales_org_number}"}}}
]
```

## 查询业务信息（QueryBusinessInfo）

查询表单元数据结构（字段列表、实体结构）。空 `FormId` 查全部可用表单。

```
POST {server_url}Kingdee.BOS.WebApi.ServicesStub.BusinessDataService.QueryBusinessInfo.common.kdsvc

[
  {"FormId": "SAL_SaleOrder"}
]
```

## 报表查询（GetSysReportData）

标准报表/分页账表查询。

```
POST {server_url}Kingdee.BOS.WebApi.ServicesStub.SysReportService.GetSysReportData.common.kdsvc

[
  "{formId}",
  {
    "FORMID": "STK_InventorySummary",
    "FSCHEMEID": "{report_scheme_id}",
    "QuicklyCondition": [{"FilterString": "FYear=2026"}]
  }
]
```

## 自定义报表查询（Execute + 已注册服务）

合并报表、汇总报表、工作底稿、抵消表等可通过通用 `Execute` 服务调用；服务名须从当前环境配置或官方文档确认。

```
POST {server_url}Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Execute.common.kdsvc

[
  "{custom_report_service_name},{custom_service_assembly}",
  {
    "parameter": {
      "ReportType": 15,
      "ReportNumber": "{report_number}",
      "AcctSystemNumber": "{accounting_system_number}",
      "AcctPolicyNumber": "{accounting_policy_number}",
      "CurrencyNumber": "{currency_number}",
      "CycleType": 4,
      "Year": 2026,
      "Period": 6,
      "DataType": "Json"
    }
  }
]
```

### ReportType 枚举

| 值 | 含义 |
|----|------|
| 1 | 个别报表 |
| 2 | 穿透报表 |
| 14 | 汇总报表 |
| 15 | 合并报表 |
| 16 | 工作底稿 |

### CycleType 枚举

| 值 | 含义 |
|----|------|
| 1 | 会计期间 |
| 4 | 月报 |
| 5 | 季报 |
| 7 | 年报 |