目录一、先说结论二、现象出库单拉下来了金额是空的三、为什么平台规定不是聚水潭不给四、奇门是什么五、申请奇门要什么5.1 聚水潭文档列的软件著作权5.2 淘宝开放平台那边的要求5.3 我走到哪了六、奇门批下来之前财务对接怎么办6.1 淘系订单先挂起别按 0 推6.2 跟财务商量三种处理方式6.3 上线前一定要讲清楚七、顺便说一句聚水潭自带的「财务小工具」已经停用八、拼多多呢九、最后一、先说结论用聚水潭开放平台做财务对接比如对接金蝶、用友淘宝天猫的订单拿不到金额。这不是接口 bug是平台规定淘系订单数据不允许通过聚水潭直接透出要拿必须走阿里的网关——奇门聚水潭的「销售出库单查询」对淘系订单不返回线上单号、收件人、金额「订单查询」「售后单查询」只能查到商家自有商城站点的单淘系的查不到所以「聚水潭奇门」说白了就是想把淘宝天猫订单的金额拿进财务系统得多开一条奇门通道。下面引用的都是聚水潭开放平台官方文档原文出处写在每一段后面。二、现象出库单拉下来了金额是空的我在做聚水潭对接金蝶云星空时用的是聚水潭开放平台的「销售出库查询」接口/open/orders/out/simple/query按start_ts增量拉已出库的单。出库单的每条明细里金额靠sale_price单价和sale_amount金额这两个字段。写映射的时候我去翻官方文档才发现淘系订单是例外。聚水潭官方文档「财务系统对接聚水潭」里写得很清楚拿淘系订单涉及出入库单据和商品金额的接口各自的限制是接口官方注意事项订单查询只能查询到商家自有商城站点的订单销售出库单查询淘系订单的出库单不会返回淘系线上单号、收件人信息、金额等信息售后单查询只能查询到商家自有商城站点的售后单售后退仓单查询—采购入库查询—采购退货查询—其它出入库查询—出处聚水潭开放平台文档 docId180「财务系统对接聚水潭」。财务对接最要紧的就是金额这一条等于把淘宝天猫店铺的收入挡在了外面。一家公司如果主要在天猫卖货光走聚水潭开放平台财务对接基本做不下去。三、为什么平台规定不是聚水潭不给聚水潭官方在「奇门对接场景」文档里的原话为了达到用户隐私及数据安全保护的规范要求淘系订单数据将无法直接提供。聚水潭作为淘宝的服务商与淘宝平台之间有协定平台数据不允许通过聚水潭直接透出。如需透出需要经过奇门网关透出注奇门是阿里的网关。出处聚水潭开放平台文档 docId27「奇门对接场景」。也就是说数据是淘宝的聚水潭只是淘宝的服务商淘宝不允许服务商把订单数据直接转给第三方要拿必须走淘宝自己的通道——奇门所以找聚水潭客服也没用这条规则不在聚水潭手里。四、奇门是什么奇门是阿里开放平台的一个网关。聚水潭里的淘系数据要给第三方系统就经过奇门转一道由淘宝那边管住谁能拿、拿什么。聚水潭文档里列了奇门的几种场景场景干什么现状奇门 WMS聚水潭和仓储系统之间推出库单、回传发货。聚水潭做 ERP 或做 WMS二选一不能双向可申请奇门 POS获取含淘系平台的销售出库单带加密的收件人信息奇门已经不再颁发该场景资质历史申请到的可以继续用奇门 CRM、线下 ERP文档里作为可调自定义接口的场景列出—奇门自定义接口用上面任一场景的奇门 AppKey 调用只能查询到淘系平台的数据需要单独授权出处聚水潭开放平台文档 docId27。通过奇门自定义接口聚水潭提供了三个查询销售出库查询、售后单查询、订单查询文档都注明「没有收件人信息」。财务对接要的是金额不要收件人所以走「奇门自定义接口」这条路就够了不需要 POS 场景也申请不到了。聚水潭文档在「奇门适用场景」里也直接列了这一条聚水潭中有淘系订单需要获取该部分订单的销售出库单到财务系统做财务账统计的五、申请奇门要什么5.1 聚水潭文档列的软件著作权聚水潭文档「奇门申请条件」里写的是软件著作权需要的材料系统界面说明书软件著作权登记表软件源码不少于 6000 行5.2 淘宝开放平台那边的要求奇门资质是在淘宝开放平台申请的。按淘宝官方文档申请路径分两种路径谁能走自研系统仅限有开发能力的天猫商家自己用三方系统软件厂商或其代理商做对接服务的第三方走的是「三方系统」。要准备要求说明企业支付宝注册淘宝开放平台个人不行要企业主体软件著作权就是 5.1 那个证书要下来MRD市场需求分析、产品功能、卖点、营销策略PRD功能描述、业务流程、界面 demo、功能截图、软著截图系统客户端登录凭证给奇门方核实系统真实存在审核周期官方说5–7 天。还有一条容易踩的WMS 类应用的软著名称必须包含「WMS」或「仓储管理」。只做财务对接的不受这条约束但如果打算申请奇门 WMS 场景软著起名时就要注意。5.3 我走到哪了我自己正在走这个流程当前进度步骤状态企业支付宝认证已完成淘宝开放平台入驻应用软件开发商已完成实人认证已过MRD、PRD已写好软件著作权办理中等下证提交奇门申请等软著证书PRD 里要放软著截图软著没下来之前千万别提交。PRD 里要求放软著截图缺了必被驳回驳回后还要等一段时间才能重新提交。走完之后我会把审核过程、驳回原因如果有、奇门接口的实际调用再写一篇。六、奇门批下来之前财务对接怎么办大多数商家不止淘宝天猫一个平台。奇门没通之前可以先把非淘系的单子对接起来淘系的单子单独处理。6.1 淘系订单先挂起别按 0 推最危险的做法是拿不到金额就按 0 推进金蝶。财务月底一看一堆 0 元出库单比没推还麻烦。我的做法是没有价格字段的单一律挂起记下原因等补上金额再推// 判断一张聚水潭出库单能不能推进财务系统// 返回 null 表示可以推否则返回挂起原因functionholdReason(row){constitemsArray.isArray(row.items)?row.items:[];if(!items.length)return出库单没有明细;constmissingPriceitems.some(itit.sale_priceundefined||it.sale_pricenull);if(missingPrice){return没有价格字段淘系订单聚水潭不返回金额需走奇门先挂起;}returnnull;}constready[];constheld[];for(constrowofrows){constreasonholdReason(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信任就没了。七、顺便说一句聚水潭自带的「财务小工具」已经停用聚水潭官方文档 docId180 开头有一行提示财务小工具不再支持使用权限将不再颁发财务系统对接请走开放平台应用对接或者联系 KA 定制以前有商家用聚水潭自带的财务小工具把单据导进金蝶、用友现在官方已经停了要么走开放平台应用对接要么找聚水潭的 KA 定制。还在用老办法的最好尽快确认一下自己那条对接还能不能跑。八、拼多多呢聚水潭文档里另外有一个「方舟对接场景」。拼多多订单的金额走不走方舟、限制是什么我还没核实到官方原文这篇先不写核实后单独补一篇。九、最后聚水潭奇门是什么淘系订单数据的官方通道。淘宝不允许聚水潭把订单数据直接给第三方要拿就得过奇门为什么要它聚水潭开放平台的销售出库单对淘系订单不返回金额财务对接走哪个场景奇门自定义接口只能查淘系不需要 POS也不再颁发申请要什么企业主体、软著、MRD、PRD、可登录的系统审核 5–7 天没批下来之前淘系单挂起别按 0 推跟财务定好处理方式上一篇写了聚水潭销售出库单对接金蝶云星空的整条线这一篇是其中「淘系订单没金额」这个坑的来龙去脉。在走奇门申请、或者被淘系订单卡住的评论区聊看到都会回。