一、背景与目标  目标很明确：用 API 创建一张采购订单，并让它到达**已审核（C）**状态。  听起来简单，实际踩了整整一天。核心难点不在于"调接口"，而在于：  1. 大量字段是**隐藏必填**，报错一个、补一个、再冒出下一个； 2. 部分字段**key 名与直觉完全不符**，写错了接口还返回成功，只是值不落库（静默失败）； 3. 同一个语义的字段（如"货主"）在不同实体类型下有**不同的枚举值**，用错类型同样静默失败。   二、环境准备 2.1 认证：OAuth2 取 token  苍穹网关的认证头字段名是 **`accessToken`**（驼峰、无下划线）。写成 `access_token` 或 `Authorization: Bearer` 一律返回 401。  ```python import httpx, uuid, datetime  BASE_URL = "https://<你的域名>/kapi"  payload = {     "client_id": "<client_id>",     "client_secret": "<client_secret>",     "username": "<用户名>",     "accountId": "<账套ID>",     "language": "zh_CN",     "nonce": str(uuid.uuid4()),     "timestamp": datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S"), } headers = {"Content-Type": "application/json",            "x-acgw-identity": "<网关身份串>"}   # 私有云需要  r = httpx.post(f"{BASE_URL}/oauth2/getToken", json=payload, headers=headers, timeout=30) token = r.json()["data"]["access_token"] ```  后续所有请求都带这个头：  ```python H = {"Content-Type": "application/json", "accessToken": token,      "x-acgw-identity": "<网关身份串>"} ```  2.2 返回码陷阱  **成功与否要看 `errorCode`（字符串 `"0"` 表示成功），不是 HTTP 状态码。** 而且完整错误信息藏在 `data.result[].errors[].rowMsg[]` 里，顶层的 `message` 会被截断成「……等 N 处错误」。排查时一定要打印完整响应体。 2.3 接口路径约定  ``` /v2/{appId}/{formId}/{操作} ```  采购订单：`/v2/pm/pm_purorderbill/{add|query|getList|batchSubmit|batchAudit}`  - 写操作是 **`add`**，不是 `save` / `create` / `submit`（这些全是 404） - 请求体格式：`{"data": [ {...} ]}`，`data` 必须是**数组** - 查询类接口必须带 `pageNo` / `pageSize`，否则返回 0 条  三、五个致命坑（本文最有价值的部分） 坑 1：含税单价的 key 是 `priceandtax`，不是 `taxprice`  最初按直觉写了 `"taxprice": 10`，接口返回 `ec=0`（成功！），但打开单据一看：**含税单价和税率都是空的**。 读回对比手工单才发现问题——所有金额字段全是 0： json { "price": 0.0, "priceandtax": 0.0, "taxrate": 0.0, "taxrateid_number": "" }  **正确写法：**  ```python "priceandtax": 10,           # 含税单价（不是 taxprice！） "taxrate": 6,                # 税率数值 "taxrateid_number": "V6",    # 税率档编码，必须显式传 ```  > **教训**：API 接受了无效 key 却不报错、也不赋值。这类"静默失败"必须靠**读回校验**才能发现，不能只看返回码。 坑 2：货主的 `ownertype` 是 `bos_org`，不是 `bd_supplier`  这是卡得最久的一个。提交时一直报：  ``` 请填写"物料明细"第1行："货主"。 ```  直觉认为"采购订单的货主"应该是供应

用 WorkBuddy 打通金蝶云·星空旗舰版 OpenAPI：采购订单从建单到审核全流程实录

本文记录一次真实的接口打通过程：从零开始，通过 WorkBuddy 驱动本地脚本与 MCP 服务，把金蝶云·星空旗舰版（苍穹）的采购订单从「建单 → 提交 → 审核」整条链路跑通。文中所有代码均可直接复用，重点在于那些文档里不会写、只有实跑才会暴露的字段名陷阱

后端

开发工具

架构设计

本教程详解通过金蝶云星空API创建采购订单并提交审核的全流程，重点披露5个致命坑：含税单价key为priceandtax而非taxprice、货主ownertype必须是bos_org、第三方业务编码trdbillno需唯一、物料必须GUI手工创建、提交用复数ids。提供完整可用代码及MCP工具封装方案，助你避开静默失败陷阱，一次通过审核。

私有云

2026上云采购 | AI焕新·智启新局

workbuddy-managed-agents

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

本教程详解通过金蝶云星空API创建采购订单并提交审核的全流程，重点披露5个致命坑：含税单价key为priceandtax而非taxprice、货主ownertype必须是bos_org、第三方业务编码trdbillno需唯一、物料必须GUI手工创建、提交用复数ids。提供完整可用代码及MCP工具封装方案，助你避开静默失...

用 WorkBuddy 打通金蝶云·星空旗舰版 OpenAPI：采购订单从建单到审核全流程实录-腾讯云开发者社区-腾讯云

用 WorkBuddy 打通金蝶云·星空旗舰版 OpenAPI：采购订单从建单到审核全流程实录

用 WorkBuddy 打通金蝶云·星空旗舰版 OpenAPI：采购订单从建单到审核全流程实录

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐