企业官网建设流程全解析

一、先说结论

用聚水潭开放平台做财务对接（比如对接金蝶、用友），淘宝天猫的订单拿不到金额。这不是接口 bug，是平台规定：

• 淘系订单数据不允许通过聚水潭直接透出，要拿，必须走阿里的网关——奇门

• 聚水潭的「销售出库单查询」对淘系订单不返回线上单号、收件人、金额

• 「订单查询」「售后单查询」只能查到商家自有商城站点的单，淘系的查不到

  所以「聚水潭奇门」说白了就是：想把淘宝天猫订单的金额拿进财务系统，得多开一条奇门通道。

  下面引用的都是聚水潭开放平台官方文档原文，出处写在每一段后面。

二、现象：出库单拉下来了，金额是空的

我在做聚水潭对接金蝶云星空时，用的是聚水潭开放平台的「销售出库查询」接口（/open/orders/out/simple/query），按start_ts增量拉已出库的单。

出库单的每条明细里，金额靠sale_price（单价）和sale_amount（金额）这两个字段。写映射的时候我去翻官方文档，才发现淘系订单是例外。

聚水潭官方文档「财务系统对接聚水潭」里写得很清楚，拿淘系订单涉及出入库单据和商品金额的接口，各自的限制是：

出处：聚水潭开放平台文档 docId=180「财务系统对接聚水潭」。

财务对接最要紧的就是金额，这一条等于把淘宝天猫店铺的收入挡在了外面。一家公司如果主要在天猫卖货，光走聚水潭开放平台，财务对接基本做不下去。

三、为什么：平台规定，不是聚水潭不给

聚水潭官方在「奇门对接场景」文档里的原话：

为了达到用户隐私及数据安全保护的规范要求，淘系订单数据将无法直接提供。聚水潭作为淘宝的服务商，与淘宝平台之间有协定，平台数据不允许通过聚水潭直接透出。如需透出需要经过奇门网关透出（注：奇门是阿里的网关）。

出处：聚水潭开放平台文档 docId=27「奇门对接场景」。

也就是说：

1. 数据是淘宝的，聚水潭只是淘宝的服务商

2. 淘宝不允许服务商把订单数据直接转给第三方

3. 要拿，必须走淘宝自己的通道——奇门

   所以找聚水潭客服也没用，这条规则不在聚水潭手里。

四、奇门是什么

奇门是阿里开放平台的一个网关。聚水潭里的淘系数据要给第三方系统，就经过奇门转一道，由淘宝那边管住谁能拿、拿什么。

聚水潭文档里列了奇门的几种场景：

出处：聚水潭开放平台文档 docId=27。

通过奇门自定义接口，聚水潭提供了三个查询：销售出库查询、售后单查询、订单查询，文档都注明「没有收件人信息」。

财务对接要的是金额，不要收件人，所以走「奇门自定义接口」这条路就够了，不需要 POS 场景（也申请不到了）。

聚水潭文档在「奇门适用场景」里也直接列了这一条：

聚水潭中有淘系订单需要获取该部分订单的销售出库单到财务系统做财务账统计的

五、申请奇门要什么

5.1 聚水潭文档列的：软件著作权

聚水潭文档「奇门申请条件」里写的是软件著作权，需要的材料：

1. 系统界面说明书
2. 软件著作权登记表
3. 软件源码（不少于 6000 行）

5.2 淘宝开放平台那边的要求

奇门资质是在淘宝开放平台申请的。按淘宝官方文档，申请路径分两种：

做对接服务的第三方，走的是「三方系统」。要准备：

审核周期官方说5–7 天。

还有一条容易踩的：WMS 类应用的软著名称必须包含「WMS」或「仓储管理」。只做财务对接的不受这条约束，但如果打算申请奇门 WMS 场景，软著起名时就要注意。

5.3 我走到哪了

我自己正在走这个流程，当前进度：

软著没下来之前千万别提交。PRD 里要求放软著截图，缺了必被驳回，驳回后还要等一段时间才能重新提交。

走完之后我会把审核过程、驳回原因（如果有）、奇门接口的实际调用再写一篇。

六、奇门批下来之前，财务对接怎么办

大多数商家不止淘宝天猫一个平台。奇门没通之前，可以先把非淘系的单子对接起来，淘系的单子单独处理。

6.1 淘系订单先挂起，别按 0 推

最危险的做法是：拿不到金额就按 0 推进金蝶。财务月底一看一堆 0 元出库单，比没推还麻烦。

我的做法是没有价格字段的单一律挂起，记下原因，等补上金额再推：

// 判断一张聚水潭出库单能不能推进财务系统// 返回 null 表示可以推；否则返回挂起原因functionholdReason(row){constitems=Array.isArray(row.items)?row.items:[];if(!items.length)return'出库单没有明细';constmissingPrice=items.some(it=>it.sale_price===undefined||it.sale_price===null);if(missingPrice){return'没有价格字段（淘系订单聚水潭不返回金额，需走奇门），先挂起';}returnnull;}constready=[];constheld=[];for(constrowofrows){constreason=holdReason(row);if(reason)held.push({io_id:row.io_id,shop:row.shop_name,reason});elseready.push(row);}

注意这里判断的是「字段不存在」（undefined或null），不是「等于 0」。赠品、0 元单的价格本来就是 0，那是正常数据，要照常推。

官方只说「不会返回金额」，没说是字段缺失还是给空值。更稳的做法是再加一道按店铺判断：让客户把淘宝、天猫店铺的shop_id列出来，这些店铺的出库单一律走挂起逻辑，不依赖字段长什么样。

挂起的单要有地方能看到：哪些店铺、多少张、从哪天开始。不然时间一长，没人记得还有一批单没进账。

6.2 跟财务商量三种处理方式

选哪种是财务的决定，对接这边要做的是：把这三种都做成配置项，不要写死。

6.3 上线前一定要讲清楚

我在方案里会把这句话写在最前面：

淘宝天猫的订单，通过聚水潭开放平台拿不到金额。要金额，需要另外申请奇门，周期取决于软著和淘宝审核。

客户上线后才发现天猫的单全是 0，信任就没了。

七、顺便说一句：聚水潭自带的「财务小工具」已经停用

聚水潭官方文档 docId=180 开头有一行提示：

财务小工具不再支持使用，权限将不再颁发，财务系统对接请走开放平台应用对接或者联系 KA 定制

以前有商家用聚水潭自带的财务小工具把单据导进金蝶、用友，现在官方已经停了，要么走开放平台应用对接，要么找聚水潭的 KA 定制。

还在用老办法的，最好尽快确认一下自己那条对接还能不能跑。

八、拼多多呢？

聚水潭文档里另外有一个「方舟对接场景」。拼多多订单的金额走不走方舟、限制是什么，我还没核实到官方原文，这篇先不写，核实后单独补一篇。

九、最后

• 聚水潭奇门是什么：淘系订单数据的官方通道。淘宝不允许聚水潭把订单数据直接给第三方，要拿就得过奇门

• 为什么要它：聚水潭开放平台的销售出库单，对淘系订单不返回金额

• 财务对接走哪个场景：奇门自定义接口（只能查淘系），不需要 POS（也不再颁发）

• 申请要什么：企业主体、软著、MRD、PRD、可登录的系统，审核 5–7 天

• 没批下来之前：淘系单挂起，别按 0 推；跟财务定好处理方式

  上一篇写了聚水潭销售出库单对接金蝶云星空的整条线，这一篇是其中「淘系订单没金额」这个坑的来龙去脉。

  在走奇门申请、或者被淘系订单卡住的，评论区聊，看到都会回。