亿奇达虚拟进货开放文档
<h5>请求头</h5>
<ul>
<li><code>content-type:application/json;</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li><code>POST</code></li>
</ul>
<h5>编码格式</h5>
<ul>
<li><code>UTF-8</code></li>
</ul>
<h5>请求参数</h5>
<ul>
<li><code>JSON格式，若不标准导致签名错误请删除全部JSON空格，参数大小写敏感</code></li>
</ul>
<h5>请求限制</h5>
<ul>
<li><code>不限制速度</code></li>
</ul>
<h5>接口地址</h5>
<ul>
<li><code>open.yiqida.cn</code></li>
</ul>
<h5>签名方式</h5>
<ul>
<li><code>md5(timestamp+data+key)，注意data代表请求json格式参数。</code></li>
</ul>
<h5>接口地址</h5>
<ul>
<li><code>open.yiqida.cn</code></li>
</ul>
<h5>参数说明</h5>
<ul>
<li><code>key是值账户秘钥，商户中心登录后账户管理处获取秘钥。userName是登录账号，请在商户中心登录后账户管理处查看登录账号。</code></li>
</ul>
<h5>常用接口</h5>
<ul>
<li>见下表</li>
</ul>
<h3>一：查询商品信息</h3>
<p>1、接口介绍</p>
<ul>
<li>查询进价、下单模板、商品上下架状态、库存等</li>
</ul>
<p>2、接口地址</p>
<ul>
<li><code>http://open.yiqida.cn/api/UserCommdity/GetCommodityInfo?timestamp=当前时间戳13位&amp;userName=登录账号&amp;sign=签名</code></li>
</ul>
<p>3、编码方式</p>
<ul>
<li>UTF-8</li>
</ul>
<p>4、请求参数（JSON格式）</p>
<pre><code> {
&quot;id&quot;:商品编号
}</code></pre>
<p>5、接口响应（成功code=200,失败code=506）</p>
<ul>
<li>正常返回</li>
</ul>
<pre><code> {
&quot;code&quot;:200,
&quot;msg&quot;:&quot;成功&quot;,
&quot;data&quot;:{
&quot;mainId&quot;:30662, //主产品Id
&quot;branchId&quot;:30662,//规格产品Id
&quot;branchName&quot;:&quot;活动开始时间以商品显示时间为准，未到时间说明是预售！&quot;,//规格产品名称
&quot;isPreSale&quot;:2,//1非活动商品 2活动商品
&quot;discount&quot;:3.21,//折扣
&quot;preSaleETime&quot;:&quot;2021-07-20 23:59:55&quot;,//活动开始时间，非活动商品为null
&quot;preSaleSTime&quot;:&quot;2021-07-15 12:01:00&quot;,//活动结束时间，非活动商品为null
&quot;preSaleDesc&quot;:&quot;活动开始时间以商品显示时间为准，未到时间说明是预售！&quot;,
&quot;endTime&quot;:null,
&quot;virtualDelivery&quot;:3,// 3.官方直充 6卡密
&quot;branchImg&quot;:&quot;http://file.yiqida.cn/upload/2021-07-13/9a/43/9a025be64323413f6f4937e360a325fb.jpg&quot;,//规格图片
&quot;status&quot;:1,//1上架 2下架 3删除 4维护
&quot;stockAmount&quot;:0,//库存数量
&quot;salesCount&quot;:0,//销量
&quot;name&quot;:&quot;爱奇艺黄金半年卡【活动】&quot;,
&quot;template&quot;:&quot;[{\&quot;type\&quot;:\&quot;input\&quot;,\&quot;txt\&quot;:\&quot;手机号\&quot;,\&quot;tips\&quot;:\&quot;请输入手机号\&quot;,
\&quot;regData\&quot;:[\&quot;phone\&quot;,\&quot;str\&quot;],\&quot;value\&quot;:\&quot;\&quot;}]&quot;,//充值模板
&quot;MainImg&quot;:&quot;http://file.yiqida.cn/upload/2021-07-13/9a/43/9a025be64323413f6f4937e360a325fb.jpg&quot;,//主产品图
&quot;price&quot;:xxx,//结算价格
&quot;guidePrice&quot;:168,//面值
&quot;imgList&quot;:null,
&quot;branchList&quot;:null,
&quot;limitCountMax&quot;:1,//单个订单最大购买数量
&quot;limitCountMin&quot;:1,//单个订单最小购买限制数量
&quot;delivery&quot;:3,//充值类型 1.厂家直冲 2.卖家直发 3.官方直充 4.扫码直充 5.卖家代充 6.卡密
&quot;taxationPrice&quot;:0,// 带票税费
&quot;catalogId&quot;:0,//目录Id
&quot;catalogName&quot;:null,//目录名称
},
&quot;sum&quot;:1
}</code></pre>
<ul>
<li>商品不存在</li>
</ul>
<pre><code>{&quot;code&quot;:1004,&quot;msg&quot;:&quot;商品编号不存在&quot;,&quot;data&quot;:null,&quot;sum&quot;:0}</code></pre>
<h3>二：提交新订单</h3>
<p>1、接口介绍</p>
<ul>
<li>通过提交新订单接口，将订单成功提交至亿奇达，此接口支持高并发。</li>
</ul>
<p>2、接口地址</p>
<ul>
<li><code>http://open.yiqida.cn/api/UserOrder/CreateOrder?timestamp=当前时间戳13位&amp;userName=登录账号&amp;sign=签名</code></li>
</ul>
<p>3、编码方式</p>
<ul>
<li><code>UTF-8</code></li>
</ul>
<p>4、请求参数data（json格式）</p>
<pre><code> {
&quot;commodityId&quot;:&quot;商品编号&quot;,
&quot;external_orderno&quot;:&quot;第三方外部单号&quot;,
&quot;buyCount&quot;:1,
&quot;remark&quot;:&quot;&quot;,
&quot;callbackUrl&quot;:&quot;&quot;,
&quot;externalSellPrice&quot;:0,
&quot;template&quot;:[&quot;URL编码（充值账号）&quot;]
}
</code></pre>
<h3>参数</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th>必传</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">commodityId</td>
<td>是</td>
<td>商品编号，整数类型，需要下单的商品规格编号</td>
</tr>
<tr>
<td style="text-align: left;">external_orderno</td>
<td>否</td>
<td>商户平台订单号，字符串类型，可传空，建议传值有效防重复</td>
</tr>
<tr>
<td style="text-align: left;">buyCount</td>
<td>是</td>
<td>购买件数，整数类型，下单倍拍件数</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td>否</td>
<td>备注信息</td>
</tr>
<tr>
<td style="text-align: left;">callbackUrl</td>
<td>否</td>
<td>异步通知地址</td>
</tr>
<tr>
<td style="text-align: left;">externalSellPrice</td>
<td>是</td>
<td>商户平台卖价，小数类型，<strong>默认请传0</strong>，建议传入，防止商品价格变更造成溢价亏损</td>
</tr>
<tr>
<td style="text-align: left;">template</td>
<td>是</td>
<td>关于字段传值方式，本质为下单模板填入,按下单填写项依次填入，值进行URL编码，如需要一项充值账号1234567（传<strong>["URL编码（1234567)"]</strong>）,如需要两项充值账号"1234567"，游戏大区"电信一区"（传<strong>["URL编码（1234567）","URL编码（电信一区)”]</strong>），依次类推，[]中需用英文双引号包含每一项下单参数，加粗部分为参数格式，不能有空格！</td>
</tr>
</tbody>
</table>
<p>5、接口响应</p>
<ul>
<li>
<p><code>下单成功code=200,下单失败code=506,重复下单code=1001</code></p>
</li>
<li><code>提示： 下单请求出现web网络异常请不要直接失败订单 请调用查询接口确认</code></li>
</ul>
<p>6、响应结果</p>
<pre><code> {
&quot;code&quot;:&quot;200&quot;,
&quot;msg&quot;:&quot;成功&quot;,
&quot;data:&quot;{
&quot;orderNo&quot;:&quot;B120210923164437556288161&quot;,//亿奇达订单号
&quot;orderId&quot;:124900067,//亿奇达订单Id
&quot;virtualDelivery&quot;:3,// 3.官方直充 6卡密
&quot;branchId&quot;:30366,//品牌Id
&quot;name&quot;:&quot;全国三网通话费50元&quot;,//产品名称
&quot;actualPrice&quot;:46.250,//订单金额
&quot;preSaleDesc&quot;:&quot;&quot;//预售说明
}&quot;,
&quot;sum&quot;:0
}
</code></pre>
<h3>URL编码示范汉字</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">文字</th>
<th>编码结果</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">尊敬的客户你好</td>
<td>%E5%B0%8A%E6%95%AC%E7%9A%84%E5%AE%A2%E6%88%B7%E4%BD%A0%E5%A5%BD</td>
</tr>
</tbody>
</table>
<h3>三：异步通知接口</h3>
<h5>1、解释及说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">说明</th>
<th>名词解释</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">异步通知地址</td>
<td>url</td>
</tr>
<tr>
<td style="text-align: left;">请求方式</td>
<td>post</td>
</tr>
<tr>
<td style="text-align: left;">消息头</td>
<td>Content-Type:application/json</td>
</tr>
<tr>
<td style="text-align: left;">编码格式</td>
<td>utf-8</td>
</tr>
<tr>
<td style="text-align: left;">返回字符串</td>
<td>收到请求后请返回小写“ok”，否则我们会连续通知10次为止</td>
</tr>
<tr>
<td style="text-align: left;">加密方式</td>
<td>md5(body+key)</td>
</tr>
<tr>
<td style="text-align: left;">通知接口</td>
<td>我方通知地址url?sign=md5(body+key)</td>
</tr>
<tr>
<td style="text-align: left;">通知数据格式</td>
<td>{"orderNo": "B120210621224410165800667","Id": 101090054,"status": 4,"msg": "充值成功，请注意查收！","mobile": "","shopId": 0,"name": "QQ豪华绿钻月卡","actualPrice": 0.000,"payPrice":0.000,"format":"","branchId": 0,"externalOrderno": "92276","img": "http: //file.yiqida.cn/upload/2021-06-15/7d/7b/7d68e1fb7b349f1248b83758c41c7f0b.jpg","kami":"[]","uuId": "f727b3a7-5db2-4dcf-936a1c6b839d4bee"}</td>
</tr>
<tr>
<td style="text-align: left;">加密字符串例子</td>
<td>{"orderNo": "B120210621224410165800667","Id": 101090054,"status": 4,"msg": "充值成功，请注意查收！","mobile": "","shopId": 0,"name": "QQ豪华绿钻月卡","actualPrice": 0.000,"payPrice":0.000,"format":"","branchId": 0,"externalOrderno": "92276","img": "http: //file.yiqida.cn/upload/2021-06-15/7d/7b/7d68e1fb7b349f1248b83758c41c7f0b.jpg","kami":"[]","uuId": "f727b3a7-5db2-4dcf-936a1c6b839d4bee"}+您的key</td>
</tr>
</tbody>
</table>
<h5>2、通知数据格式解释及说明</h5>
<pre><code> {
&quot;orderNo&quot;:&quot;B120210621224410165800667&quot;,//亿奇达订单编号
&quot;Id&quot;:101090054,//亿奇达订单Id
&quot;status&quot;:4,//订单状态
&quot;msg&quot;:&quot;充值成功，请注意查收！&quot;,//充值说明
&quot;mobile&quot;:&quot;&quot;,//手机号
&quot;shopId&quot;:0,//预留字段不用管
&quot;name&quot;: &quot;QQ豪华绿钻&quot;,//产品名称
&quot;actualPrice&quot;: 4.500,//价格
&quot;payPrice&quot;:4.500,//支付金额
&quot;format&quot;:&quot;QQ豪华绿钻月卡&quot;,//产品规格名称
&quot;branchId&quot;: 30879,//产品Id
&quot;externalOrderno&quot;: &quot;92276&quot;,//对接方传的订单号
&quot;img&quot;: &quot;http://file.yiqida.cn/upload/2021-06-15/7d/7b/7d68e1fb7b349f1248b83758c41c7f0b.jpg&quot;,//产品图
&quot;kami&quot;:[{
&quot;number&quot;: &quot;卡号&quot;,
&quot;endTime&quot;: &quot;到期时间&quot;,
&quot;pwd&quot;: &quot;卡密&quot;,
&quot;url&quot;: &quot;链接&quot;,
&quot;stockType&quot;: &quot;卡密类型 1.卡密 2.图片 &quot;
}]//如果直冲产品 值为[]
&quot;uuId&quot;: &quot;f727b3a7-5db2-4dcf-936a1c6b839d4bee&quot;,//通知uuid
} </code></pre>
<hr />
<h3>四：查询进货订单状态</h3>
<h4>1、接口介绍</h4>
<ul>
<li>查询进货订单的处理状态，卡密订单需要调用该接口查询卡密内容（卡密查询会有短暂延迟，需要做好延迟处理，可以间隔2-5秒轮询查询），<code>此接口支持高并发，由于服务器集群网络传输有毫秒级别延迟</code>，<strong>下单后请延迟1-3秒后方可查询，切勿下单即查询，若下单即查询状态，出现订单不存在的请重新调用下单接口，带外部单号的订单会报订单重复，再重新查询即可，不存在订单请勿直接做退单处理,(若提交3分钟后查询订单返回订单不存在 订单失败处理 )。</strong></li>
</ul>
<h4>2、接口地址</h4>
<ul>
<li><code>http://open.yiqida.cn/api/UserOrder/QueryOrderModel?timestamp=当前时间戳13位&amp;userName=登录账号&amp;sign=签名</code></li>
</ul>
<h4>3、接口地址</h4>
<ul>
<li><code>UTF-8</code></li>
</ul>
<h4>4、请求参数（json格式）</h4>
<pre><code> {
&quot;external_orderno&quot;:&quot;外部订单号&quot;,
&quot;orderNo&quot;:&quot;亿奇达订单号,不可以同时为空&quot;,
&quot;orderTime&quot;:&quot;10&quot;
}</code></pre>
<h5>参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">说明</th>
<th>名词解释</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">orderTime</td>
<td>代表查询订单状态的时间范围，单位（天），默认在近10天范围内查找该订单，要查全部日期请传0，该参数字段非必传针对高并发客户建议传小一点或者启用异步回调。</td>
</tr>
</tbody>
</table>
<h4>5、接口响应</h4>
<pre><code>{
&quot;code&quot;:200,
&quot;msg&quot;:&quot;成功&quot;,
&quot;data&quot;:{
&quot;orderNo&quot;:&quot;A120210609192725383000008&quot;,//亿奇达订单号
&quot;orderIP&quot;:&quot;113.250.224.75&quot;,//下单Ip
&quot;payTime&quot;:&quot;2021-06-09 19:27:25&quot;,//支付时间
&quot;payType&quot;:2,//支付类型
&quot;sendTime&quot;:null,//完成时间
&quot;virtualDelivery&quot;:3,// 3.官方直充 6卡密
&quot;sendType&quot;:3,//发货类型
&quot;payPrice&quot;:0,//支付金额
&quot;status&quot;:5,//状态
&quot;templateText&quot;:&quot;[{\&quot;type\&quot;:\&quot;input\&quot;,\&quot;txt\&quot;:\&quot;手机号\&quot;,
\&quot;tips\&quot;:\&quot;请输入手机号\&quot;,\&quot;regData\&quot;:[\&quot;str\&quot;,\&quot;phone\&quot;],\&quot;value\&quot;:\&quot;18875028074\&quot;}]&quot;,//模板数据
&quot;templateId&quot;:20006,//充值模板Id
&quot;carmi&quot;:[{
&quot;number&quot;: &quot;卡号&quot;,
&quot;endTime&quot;: &quot;到期时间&quot;,
&quot;pwd&quot;: &quot;卡密&quot;,
&quot;url&quot;: &quot;链接&quot;,
&quot;stockType&quot;: &quot;卡密类型 1.卡密 2.图片 &quot;
}],//卡密数据预留字段
&quot;sellerMessage&quot;:&quot;充值成功，请注意查收！&quot;//充值说明
},
&quot;sum&quot;:0
}
</code></pre>
<h5>帮助说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">说明</th>
<th>名词解释</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">status==1</td>
<td>等待支付，下一时刻会变成2</td>
</tr>
<tr>
<td style="text-align: left;">status==2</td>
<td>等待发货，等待处理</td>
</tr>
<tr>
<td style="text-align: left;">status==3</td>
<td>已发货，物流派送中</td>
</tr>
<tr>
<td style="text-align: left;">status==4</td>
<td>交易成功，订单完成，<strong>虚拟充值商品订单成功为该状态</strong></td>
</tr>
<tr>
<td style="text-align: left;">status==5</td>
<td>交易取消，订单失败，<strong>虚拟充值商品订单失败为该状态</strong></td>
</tr>
<tr>
<td style="text-align: left;">status==6</td>
<td>处理中，正在处理</td>
</tr>
</tbody>
</table>
<hr />
<h3>五：亿奇达用户余额查询</h3>
<h4>1、接口介绍</h4>
<p><code>查询进货用户的账户余额</code></p>
<h4>2、接口地址</h4>
<p><code>http://open.yiqida.cn/api/UserInfo/GetMemberInfo?timestamp=当前时间戳13位&amp;userName=登录账号&amp;sign=签名</code></p>
<h4>3、编码方式</h4>
<p><code>UTF-8</code></p>
<h4>4、请求参数（无参数直接POST请求）</h4>
<p><code>注意：此接口Sign=md5{时间戳+key}，因为不需要参数。</code></p>
<h4>5、接口响应</h4>
<pre><code>{
&quot;code&quot;:200,
&quot;msg&quot;:&quot;成功&quot;,
&quot;data&quot;:{
&quot;avatar&quot;:&quot;http://thirdqq.qlogo.cn/g?b=oidb&amp;k=NKLMIsIUH4HqfNrGEYY30Q&amp;s=100&amp;t=1555323126&quot;,
&quot;nickname&quot;:&quot;重庆亿奇达网络科技有限公司&quot;,
&quot;proxyTree&quot;:&quot;&quot;,
&quot;email&quot;:&quot;&quot;,
&quot;business&quot;:{
&quot;userName&quot;:&quot;商务客服_陈总&quot;,
&quot;Id&quot;:11060,
&quot;logo&quot;:&quot;http://file.yiqida.cn/upload/img/userlogo.png&quot;
},
&quot;Id&quot;:11061,
&quot;balance&quot;:939.6,//当前账户余额
&quot;creditBalance&quot;:&quot;-100000&quot;//1、负数代表授信总额度 2、正数代表当前卖家保证金
},
&quot;sum&quot;:0
}
</code></pre>
<h3>六：亿奇达查询商品分组列表查询</h3>
<h4>1、接口介绍</h4>
<ul>
<li>查询亿奇达商品分组列表</li>
</ul>
<h4>2、接口地址</h4>
<p><code>http://open.yiqida.cn/api/UserCommdity/GetCatalogList?timestamp=当前时间戳13位&amp;userName=登录账号&amp;sign=签名</code></p>
<h4>3、编码方式</h4>
<p><code>UTF-8</code></p>
<h4>4、请求参数（json格式）</h4>
<p><code>无</code></p>
<h4>5、接口响应</h4>
<ul>
<li>正常响应</li>
</ul>
<pre><code> {
&quot;code&quot;:200,
&quot;msg&quot;:&quot;成功&quot;,
&quot;data&quot;:[{&quot;name&quot;:&quot;分组名称&quot;,&quot;Id&quot;:&quot;分组Id&quot;,&quot;memberId&quot;:0 }]
}</code></pre>
<h3>七：亿奇达查询商品列表</h3>
<h4>1、接口介绍</h4>
<ul>
<li>根据商品分组查询分组内的商品列表</li>
</ul>
<h4>2、接口地址</h4>
<p><code>http://open.yiqida.cn/api/UserCommdity/GetCommodityList?timestamp=当前时间戳13位&amp;userName=登录账号&amp;sign=签名</code></p>
<h4>3、编码方式</h4>
<p><code>UTF-8</code></p>
<h4>4、请求参数（json格式）</h4>
<pre><code> {
&quot;page&quot;:1,
&quot;size&quot;:60,
&quot;catalogId&quot;:0,
&quot;name&quot;:&quot;&quot;
}</code></pre>
<table>
<thead>
<tr>
<th style="text-align: left;">说明</th>
<th>名词解释</th>
<th>是否必填</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">page</td>
<td>页码</td>
<td>必填</td>
</tr>
<tr>
<td style="text-align: left;">size</td>
<td>每页展示数量</td>
<td>不必填(默认60条)</td>
</tr>
<tr>
<td style="text-align: left;">catalogId</td>
<td>分组Id</td>
<td>不必填(分组Id来源于分组列表Id，如果此参数传了，只会查询出当前分组下面的商品)</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td>产品名称</td>
<td>不必填</td>
</tr>
</tbody>
</table>
<h4>5、接口响应</h4>
<ul>
<li>正常响应</li>
</ul>
<pre><code> {
&quot;code&quot;:200,
&quot;msg&quot;:&quot;成功&quot;,
&quot;data&quot;:[
{
&quot;mainId&quot;: 30181,//主产品Id
&quot;branchId&quot;: 30181,//主产品Id
&quot;branchName&quot;: &quot;&quot;,//规格产品名称
&quot;isPreSale&quot;: 1,//1非活动商品 2活动商品
&quot;discount&quot;: 8.500,//折扣
&quot;preSaleETime&quot;: null,//活动开始时间，非活动商品为null
&quot;preSaleSTime&quot;: &quot;1970-01-01 00:00:00&quot;,//活动结束时间，非活动商品为null
&quot;preSaleDesc&quot;: &quot;&quot;,
&quot;endTime&quot;: null,
&quot;virtualDelivery&quot;: 3,// 3.官方直充 6卡密
&quot;branchImg&quot;: &quot;http://file.yiqida.cn/upload/2021-06-15/ba/63/ba382ce163fcdf904617f62a9b8a44f1.jpg&quot;,
&quot;status&quot;: 1,
&quot;stockAmount&quot;: 0,
&quot;salesCount&quot;: 0,
&quot;name&quot;: &quot;哔哩哔哩会员月卡&quot;,
&quot;template&quot;: &quot;[{\&quot;type\&quot;:\&quot;input\&quot;,\&quot;txt\&quot;:\&quot;手机号\&quot;,\&quot;tips\&quot;:\&quot;请输入手机号\&quot;,\&quot;regData\&quot;:[\&quot;phone\&quot;],\&quot;value\&quot;:\&quot;\&quot;}]&quot;,
&quot;subsidy&quot;: null,
&quot;MainImg&quot;: &quot;http://file.yiqida.cn/upload/2021-06-15/ba/63/ba382ce163fcdf904617f62a9b8a44f1.jpg&quot;,
&quot;price&quot;: 17.000,
&quot;guidePrice&quot;: 20.0,
&quot;imgList&quot;: null,
&quot;branchList&quot;: null,
&quot;limitCountMax&quot;: 1,
&quot;limitCountMin&quot;: 1,
&quot;delivery&quot;: 3,
&quot;taxationPrice&quot;: 6,
&quot;catalogId&quot;: 0,//分组ID为0，说明没有添加分组
&quot;catalogName&quot;: null,
&quot;blnSwitchCode&quot;: false,
&quot;switchStartTime&quot;: &quot;&quot;,
&quot;switchEndTime&quot;: &quot;&quot;,
&quot;lngSwitchMinNumber&quot;: 0
}, {
&quot;mainId&quot;: 30157,//主产品Id
&quot;branchId&quot;: 30157,
&quot;branchName&quot;: &quot;&quot;,
&quot;isPreSale&quot;: 1,
&quot;discount&quot;: 5.520,
&quot;preSaleETime&quot;: null,
&quot;preSaleSTime&quot;: &quot;1970-01-01 00:00:00&quot;,
&quot;preSaleDesc&quot;: &quot;&quot;,
&quot;endTime&quot;: null,
&quot;virtualDelivery&quot;: 3,// 3.官方直充 6卡密
&quot;branchImg&quot;: &quot;http://file.yiqida.cn/upload/2021-06-15/c9/83/c9587e758339297f3d833a3c7b601f28.jpg&quot;,
&quot;status&quot;: 1,
&quot;stockAmount&quot;: 0,
&quot;salesCount&quot;: 0,
&quot;name&quot;: &quot;爱奇艺黄金会员月卡&quot;,
&quot;template&quot;: &quot;[{\&quot;type\&quot;:\&quot;input\&quot;,\&quot;txt\&quot;:\&quot;手机号\&quot;,\&quot;tips\&quot;:\&quot;请输入手机号\&quot;,\&quot;regData\&quot;:[\&quot;phone\&quot;],\&quot;value\&quot;:\&quot;\&quot;}]&quot;,
&quot;subsidy&quot;: null,
&quot;MainImg&quot;: &quot;http://file.yiqida.cn/upload/2021-06-15/c9/83/c9587e758339297f3d833a3c7b601f28.jpg&quot;,
&quot;price&quot;: 13.800,
&quot;guidePrice&quot;: 25.0,
&quot;imgList&quot;: null,
&quot;branchList&quot;: null,
&quot;limitCountMax&quot;: 1,
&quot;limitCountMin&quot;: 1,
&quot;delivery&quot;: 3,
&quot;taxationPrice&quot;: 6,
&quot;catalogId&quot;: 10196,//分组ID不为0，说明已经添加分组
&quot;catalogName&quot;: &quot;分组2&quot;,
&quot;blnSwitchCode&quot;: false,
&quot;switchStartTime&quot;: &quot;&quot;,
&quot;switchEndTime&quot;: &quot;&quot;,
&quot;lngSwitchMinNumber&quot;: 0
}
],
&quot;sum&quot;:2
}</code></pre>
<ul>
<li>
<p>异常响应</p>
<p><code>{&quot;code&quot;:406,&quot;msg&quot;:&quot;签名错误&quot;,&quot;data&quot;:[],&quot;sum&quot;:0}</code> </p>
</li>
</ul>
<h3>八：亿奇达商品调价推送</h3>
<h4>1、接口介绍</h4>
<ul>
<li>商品调价推送</li>
</ul>
<h4>2、接口地址</h4>
<p><code>亿奇达商户端-账户管理-商品信息异步通知接收地址</code></p>
<h4>3、推送响应</h4>
<pre><code> {
&quot;advanceTime&quot;: 2022-02-08 16:04:31,//预设时间 作废
&quot;advancePrice&quot;: 1.0,//预设价 作废
//若advancetime是过去式那么说明当前advanceprice价格已经生效；若advancetime是将来时说明当advanceprice价格还未生效，当前结算价始终都是price字段，时间只作下一个价格的鉴别作用。
&quot;price&quot;: 17.000,//生效价格
&quot;mainId&quot;: 30181,//主产品Id
&quot;branchId&quot;: 30181,
&quot;branchName&quot;: &quot;&quot;,
&quot;isPreSale&quot;: 1,
&quot;discount&quot;: 8.500,
&quot;preSaleETime&quot;: null,
&quot;preSaleSTime&quot;: &quot;1970-01-01 00:00:00&quot;,
&quot;preSaleDesc&quot;: &quot;&quot;,
&quot;endTime&quot;: null,
&quot;virtualDelivery&quot;: 3,// 3.官方直充 6卡密
&quot;branchImg&quot;: &quot;http://file.yiqida.cn/upload/2021-06-15/ba/63/ba382ce163fcdf904617f62a9b8a44f1.jpg&quot;,
&quot;status&quot;: 1,
&quot;stockAmount&quot;: 0,
&quot;salesCount&quot;: 0,
&quot;name&quot;: &quot;哔哩哔哩会员月卡&quot;,
&quot;template&quot;: &quot;[{\&quot;type\&quot;:\&quot;input\&quot;,\&quot;txt\&quot;:\&quot;手机号\&quot;,\&quot;tips\&quot;:\&quot;请输入手机号\&quot;,\&quot;regData\&quot;:[\&quot;phone\&quot;],\&quot;value\&quot;:\&quot;\&quot;}]&quot;,
&quot;subsidy&quot;: null,
&quot;MainImg&quot;: &quot;http://file.yiqida.cn/upload/2021-06-15/ba/63/ba382ce163fcdf904617f62a9b8a44f1.jpg&quot;,
&quot;guidePrice&quot;: 20.0,
&quot;imgList&quot;: null,
&quot;branchList&quot;: null,
&quot;limitCountMax&quot;: 1,
&quot;limitCountMin&quot;: 1,
&quot;delivery&quot;: 3,
&quot;taxationPrice&quot;: 6,
&quot;catalogId&quot;: 0,//分组ID为0，说明没有添加分组
&quot;catalogName&quot;: null,
&quot;blnSwitchCode&quot;: false,
&quot;switchStartTime&quot;: &quot;&quot;,
&quot;switchEndTime&quot;: &quot;&quot;,
&quot;lngSwitchMinNumber&quot;: 0
}</code></pre>
<h3>九： 查询订单资金流水</h3>
<h4>1、接口介绍</h4>
<ul>
<li>根据亿奇达订单号 或者外部订单号 查询资金</li>
</ul>
<h4>2、接口地址</h4>
<p><code>http://open.yiqida.cn/api/UserOrder/QueryOrderFund?timestamp=当前时间戳13位&amp;userName=登录账号&amp;sign=签名</code></p>
<h4>3、编码方式</h4>
<p><code>UTF-8</code></p>
<h4>4、请求参数（json格式）</h4>
<pre><code> {
&quot;external_orderno&quot;:&quot;外部订单号&quot;,
&quot;orderNo&quot;:&quot;亿奇达订单号&quot;
}</code></pre>
<table>
<thead>
<tr>
<th style="text-align: left;">说明</th>
<th>名词解释</th>
<th>是否必填</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">external_orderno</td>
<td>外部订单号</td>
<td>2选1 不能同时为空</td>
</tr>
<tr>
<td style="text-align: left;">orderNo</td>
<td>亿奇达订单号</td>
<td>2选1 不能同时为空</td>
</tr>
</tbody>
</table>
<h4>5、接口响应</h4>
<pre><code>{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;data&quot;: {
&quot;orderNo&quot;: &quot;B220240621110023756956516&quot;,
&quot;externalOrderno&quot;: &quot;DZ8A240621110022007-8398669&quot;,
&quot;payLog&quot;: {
&quot;addTime&quot;: &quot;2024-06-21T11:00:23&quot;,//交易时间
&quot;price&quot;: 10.090,//操作金额
&quot;balance&quot;: 16239.750,//操作后余额
&quot;beforeBalance&quot;: 16249.840,//操作前余额
&quot;logId&quot;: &quot;B220240621110023756956518&quot;,//流水单号
&quot;desc&quot;: &quot;全国联通话费10元(余额支付)&quot;,说明
&quot;direction&quot;: &quot;减少&quot;,//操作说明
&quot;autoincrement&quot;: 3010791,//变动顺序
&quot;sourceOrderNo&quot;: &quot;&quot;//资金来源
},
&quot;refundLog&quot;: {
&quot;addTime&quot;: &quot;2024-06-21T11:00:26&quot;,//交易时间
&quot;price&quot;: 10.090,//操作金额
&quot;balance&quot;: 16249.840,//操作后余额
&quot;beforeBalance&quot;: 16239.750,//操作前余额
&quot;logId&quot;: &quot;D220240621110026929943438&quot;,//流水单号
&quot;desc&quot;: &quot;订单取消&quot;,//说明
&quot;direction&quot;: &quot;增加&quot;,//操作说明
&quot;autoincrement&quot;: 3010792,//变动顺序
&quot;sourceOrderNo&quot;: &quot;B220240621110023756956518&quot;//资金来源
}
}
}</code></pre>
<p>说明： payLog 支付流水 refundLog 退款流水 </p>
<h3>十：亿奇达code码介绍</h3>
<p>接口code状态码</p>
<table>
<thead>
<tr>
<th style="text-align: left;">状态码</th>
<th style="text-align: left;">状态解释</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">200</td>
<td style="text-align: left;">请求成功</td>
</tr>
<tr>
<td style="text-align: left;">403</td>
<td style="text-align: left;">权限不足</td>
</tr>
<tr>
<td style="text-align: left;">404</td>
<td style="text-align: left;">找不到资源</td>
</tr>
<tr>
<td style="text-align: left;">405</td>
<td style="text-align: left;">参数错误</td>
</tr>
<tr>
<td style="text-align: left;">406</td>
<td style="text-align: left;">签名错误</td>
</tr>
<tr>
<td style="text-align: left;">411</td>
<td style="text-align: left;">未登录</td>
</tr>
<tr>
<td style="text-align: left;">412</td>
<td style="text-align: left;">登录失效</td>
</tr>
<tr>
<td style="text-align: left;">500</td>
<td style="text-align: left;">未经处理的异常</td>
</tr>
<tr>
<td style="text-align: left;">506</td>
<td style="text-align: left;">失败,此错误需要看msg里面的信息</td>
</tr>
<tr>
<td style="text-align: left;">508</td>
<td style="text-align: left;">操作频繁,重新提交订单</td>
</tr>
<tr>
<td style="text-align: left;">509</td>
<td style="text-align: left;">访问设备已失效</td>
</tr>
<tr>
<td style="text-align: left;">510</td>
<td style="text-align: left;">访问设备已经封停</td>
</tr>
<tr>
<td style="text-align: left;">511</td>
<td style="text-align: left;">设备状态异常</td>
</tr>
<tr>
<td style="text-align: left;">513</td>
<td style="text-align: left;">系统更新升级中</td>
</tr>
<tr>
<td style="text-align: left;">55</td>
<td style="text-align: left;">系统报错</td>
</tr>
<tr>
<td style="text-align: left;">-1001</td>
<td style="text-align: left;">API登录失败</td>
</tr>
<tr>
<td style="text-align: left;">1001</td>
<td style="text-align: left;">外部订单号重复</td>
</tr>
<tr>
<td style="text-align: left;">1002</td>
<td style="text-align: left;">买家进货高于卖价，用于防止溢价亏损</td>
</tr>
<tr>
<td style="text-align: left;">1003</td>
<td style="text-align: left;">商品已下架</td>
</tr>
<tr>
<td style="text-align: left;">1004</td>
<td style="text-align: left;">商品编号不存在</td>
</tr>
<tr>
<td style="text-align: left;">1005</td>
<td style="text-align: left;">外部单号限制，如超长</td>
</tr>
<tr>
<td style="text-align: left;">1006</td>
<td style="text-align: left;">备注限制，如超长</td>
</tr>
<tr>
<td style="text-align: left;">1007</td>
<td style="text-align: left;">回调地址限制，如超长</td>
</tr>
<tr>
<td style="text-align: left;">1008</td>
<td style="text-align: left;">用户类型错误</td>
</tr>
<tr>
<td style="text-align: left;">1009</td>
<td style="text-align: left;">参数模板限制，如没按模板传参</td>
</tr>
<tr>
<td style="text-align: left;">1010</td>
<td style="text-align: left;">购买数量限购，如超出购买限制</td>
</tr>
<tr>
<td style="text-align: left;">1014</td>
<td style="text-align: left;">lp白名单限制</td>
</tr>
<tr>
<td style="text-align: left;">1011</td>
<td style="text-align: left;">您没有对接此商品权限</td>
</tr>
</tbody>
</table>
<h3>十一：亿奇达接口确认函</h3>
<p>亿奇达接口文档版本：</p>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">二：提交新订单</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">状态码</td>
<td style="text-align: left;">code</td>
</tr>
<tr>
<td style="text-align: left;">提交成功</td>
<td style="text-align: left;">200</td>
</tr>
<tr>
<td style="text-align: left;">提交失败(订单失败处理)</td>
<td style="text-align: left;">506,1002,1003,1004,1005,1006,1007,1008,1009,1010,1011,1012,1013</td>
</tr>
<tr>
<td style="text-align: left;">订单重复提交（说明订单之前提交过，需调用查询订单状态接口确认状态）</td>
<td style="text-align: left;">1001</td>
</tr>
<tr>
<td style="text-align: left;">系统升级（调用查询接口，可能提交成功了，可是查询状态的时候系统在升级，若升级完成提示订单不存在才能说明没下单成功）</td>
<td style="text-align: left;">513</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">四：查询进货订单状态</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">状态码</td>
<td style="text-align: left;">data. status</td>
</tr>
<tr>
<td style="text-align: left;">订单成功(订单成功处理)</td>
<td style="text-align: left;">4</td>
</tr>
<tr>
<td style="text-align: left;">订单失败(订单失败处理)</td>
<td style="text-align: left;">5</td>
</tr>
<tr>
<td style="text-align: left;">若提交3分钟后订单不存在(订单失败处理)</td>
<td style="text-align: left;">code=404</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">三：异步通知接口</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">状态码</td>
<td style="text-align: left;">status</td>
</tr>
<tr>
<td style="text-align: left;">订单成功(订单成功处理)</td>
<td style="text-align: left;">4</td>
</tr>
<tr>
<td style="text-align: left;">订单失败(订单失败处理)</td>
<td style="text-align: left;">5</td>
</tr>
</tbody>
</table>