商家自研OMS奇门对接-SDK踩坑录

本文链接：https://blog.youkuaiyun.com/u012847695/article/details/119209212

本文记录了使用.NET Core SDK对接奇门接口时遇到的回传接口和推送接口问题。在回传接口中，发现必须返回XML格式才能通过奇门的校验，而SDK签名验证在特定情况下会失败，需要修改源码解决。在推送接口中，签名验证需要特殊处理，同时ReturnorderCreateRequest的XML序列化问题导致请求失败。这些问题的解决过程揭示了对接过程中需要注意的细节。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

前言：为自家零售行业的公司做OMS系统，需要通过奇门去对接第三方WMS系统。自家有淘宝店，申请商家自研应用还是很好申请的。就当前在做的OMS系统而言，我们要用的奇门的接口其实也就3个模块，发货，退换货，取消。介于官方接口那一堆要传的参数，我们还是选择用他们的SDK（.net core版本）。

对于官方SDK，咱还是100%信任的，出问题，首先咱就觉得是自己的问题，加班加点N次轮番测试，绞尽脑汁从自身找问题，快要崩溃的时候，扛不住了。

这里要感谢官方提供了SDK的源码，让我终于找出了问题所在。找到问题的那一瞬间，爆粗口的有木有，气死人不偿命的有木有。我忍，呼~

故此篇不会叙述申请应用那块的流程，这个自己去百度或官方文档就行，只重点叙述对接过程的坑点

言归正传，进入接口对接主题，首先是先跟奇门测试环境进行自测，测试通过之后就进入跟第三方的联调。

接口统一参数说明：

奇门测试环境接口地址Url：http://qimen.api.taobao.com/top/router/qmtest

淘宝应用Appkey：你在淘宝开放平台申请的应用的Appkey

淘宝应用Secretkey：你在淘宝开放平台申请的应用的Secretkey

CustomerId：测试环境统一用mockCustomerId模拟测试，转正式的第三方对接的公司会提供

OwnerCode：货主编码，这是第三方公司需要的参数，他们会提供

对接SDK版本：.net core，自己系统框架：.net 5.0

一、回传接口坑点（自测测出的问题）

以此接口为例taobao.qimen.deliveryorder.confirm(发货单已发货回传接口)

进入淘宝开放平台 - 奇门 - 三方互通 - 我的场景，点击 taobao.qimen.deliveryorder.confirm 接口进入，填写自测地址（即奇门回传信息给我们的地址，这需要咱将回写接口发布并且可外网访问）。在“系统检测的API列表” 中找到 taobao.qimen.deliveryorder.confirm，点击“进入”，有