管易openapi奇门自定义接口接入指南v1.4

目前支持的接口：

订单查询（gy.erp.trade.get）

历史订单查询（gy.erp.trade.history.get）

发货单查询（gy.erp.trade.deliverys.get）

历史发货单查询（gy.erp.trade.deliverys.history.get）

退货单查询（gy.erp.trade.return.get）

接入指南：

1. 将淘宝appkey提供给管易相关人员进行配置(服务人员、交付顾问、销售)。并告知原先调用接口版本（v1/v2）

2. 在淘宝开放平台的应用管理中，下载对应管易的sdk。

查看appkey、下载sdk，见下图：

3. 将sdk引入项目

4. 以下代码示例：

以gy.erp.trade.deliverys.get接口为例

Sdk中会带有类名为GyErpTradeDeliverysGetRequest的请求类，使用对应接口的请求类来请求接口。

String appkey = "商家的奇门appkey";
String appSecret = "商家的奇门appSecret";
String format = "JSON";
/*
 * 这里的URL可以参考测试工具上的链接，域+后缀
 * 后缀如果测试环境地址则为/router/qmtest，如果是正式地址则为/router/qm
 */
String url = "https://tp8z6548i2.api.taobao.com/router/qmtest";
DefaultQimenCloudClient client = new DefaultQimenCloudClient(url, appkey, appSecret, format);
GyErpTradeDeliverysGetRequest gyErpTradeDeliverysGetRequest = new GyErpTradeDeliverysGetRequest();
//注意！ 千万不能少了这一步
gyErpTradeDeliverysGetRequest.setTargetAppKey("管易的奇门appkey");
//添加参数
gyErpTradeDeliverysGetRequest.setAppkey("管易的appkey");
gyErpTradeDeliverysGetRequest.setSessionkey("管易的sessionkey");
gyErpTradeDeliverysGetRequest.setPageNo(0l);
gyErpTradeDeliverysGetRequest.setPageSize(10l);
gyErpTradeDeliverysGetRequest.setDelivery("1");
gyErpTradeDeliverysGetRequest.setCode("SDO12638426576");
GyErpTradeDeliverysGetResponse response = null;
try {
    response = client.execute(gyErpTradeDeliverysGetRequest);
    System.out.println(JSONUtil.toJsonStr(response));
} catch (ApiException e) {
    e.printStackTrace();
}

请求参数说明：

奇门公共参数：

url：奇门自定义接口请求地址。

生产地址http://tp8z6548i2.api.taobao.com/router/qm

测试地址http://tp8z6548i2.api.taobao.com/router/qmtest

appkey：接入商家的奇门appkey

appSecret：接入商家的奇门appsecret

format：固定为JSON

管易入参：

重要：需要新增一个targetAppKey字段，由管易提供。

其他入参保持不变。

响应参数说明：

出参保持不变。

注：

V1V2对应的管易淘宝appkey：

V1 targetAppKey：21151296

V2 targetAppKey：21226717

奇门参考文档

https://open.taobao.com/doc.htm?docId=106556&docType=1