当前位置: 文档中心
发票系统对接方案
一、接入场景&价值
1.1 接入场景
场景名称 : 线上ERP-线下ERP奇门官方场景
1.2 接入价值及背景
实现发票系统对接场景,获取旺店通ERP客户端待开票数据并回写。
根据阿里巴巴—电商服务市场于2015年8月18日发布的《服务市场应用间敏感数据互通安全规则公告》,所有调用订单信息相关类目的应用,必须通过“奇门”和”云栈菜鸟电子面单”安全通道实现订单敏感信息在OMS、ERP、WMS、TMS等第三系统间的流转,并于2016年1月31日前完成新老用户的整改迁移。奇门ERP—CRM场景应运而生,主要应用于接入方商家的CRM(会员管理系统),获取旺店通ERP内各个平台(含淘系)销售订单数据(不含隐私数据)。
附:服务市场应用间敏感数据互通安全规则公告:https://open.taobao.com/doc.htm?docId=103499&docType=1
二、接入条件
已经完成文档三方系统奇门appkey申请或自研系统奇门appkey申请步骤。
奇门应用已经发布且该应用符合如下标签:ERP软件,服务商后台系统,商家后台系统,国际商家后台系统,进销存软件,全渠道ERP,奇门-线下ERP(财务系统),奇门-商家自研线下系统,零售通
三、接入流程
3.1 点击以下链接登录:奇门控制台。
3.2选择奇门中心—>三方互通—>场景列表,选择接入“线上ERP-线下ERP奇门官方场景”
3.3 选择接入场景的应用,如选择不到相关应用,说明应用未发布或应用不符合该场景标签,请参考文档第二条“接入条件”,填写关联原因,申请接入。
四、申请与旺店通ERP联调
联调协助方式:点击“联系我们”查看入群方式,入群沟通联调相关事项。
五、测试开发
为开发者更高效的完成奇门线上ERP-线下ERP场景联调,可按照如下流程进行测试开发:
5.1 进行session授权:session为接口调用的必要信息,如进行奇门ERP-CRM场景联调,需先进行session授权,授权方式如下:
点击链接,进入用户授权工具,输入appkey,点击“去登录授权”,授权成功后界面会出现session相关信息。(session有效期,一般为30天,失效后需重新登录授权)
5.2 SDK下载:可在奇门控制台中下载,路径:"应用管理"→"管理"→"SDK下载"。
5.3 接口文档说明:
接口名称(method):qimen.taobao.erp.order.sync
接口文档可在奇门控制台——我的场景——API列表中查看:
六、申请上线:
点击“上线”进入上线配置页面
点击上线申请进行线上授权申请,目前只支持部分角色发起,如果您没有该按钮,请联系旺店通方发起申请
七、参数说明:
测试环境url:http://qimen.api.taobao.com/router/qmtest
正式环境url:http://qimen.api.taobao.com/router/qm
奇门接口名称(method) | 旺店通接口标识(wdt_interface) | 接口服务名 | 接口名 | 接口描述 |
---|---|---|---|---|
qimen.taobao.erp.order.sync | invoice | vip_invoice_info_query.php | 查询开票信息[增值] | 获取百旺、航天等开发票系统需要的开票数据 |
qimen.taobao.erp.order.sync | invoice_update | vip_invoice_info_update.php | 回传开票结果[增值] | 回传开发票结果信息发票号码、代码、电子发票的下载地址等 |
注意:“查询开票信息”与“回传开票结果”接口所对应的奇门接口相同,通过不同旺店通接口标识(wdt_interface)来解析具体接口,原旺店通接口业务参数及旺店通接口标识字段均传在奇门接口扩展字段extendProps中,请求参数demo如下:
Array ( [customerid] => XXXXXX [extendProps] => {"end_time":"2020-04-22 00:09:40","page_no":"0","page_size":"50","sid":"卖家账号","start_time":"2020-04-22 00:04:40","wdt_interface":"invoice"} //wdt_interface为旺店通接口标识, //wdt_interface:invoice =》invoice_info_query.php //wdt_interface:invoice_update》vip_invoice_info_update.php [startDate] => 2020-04-22 00:09:40 [endDate] => 2020-04-22 00:09:40 [target_appkey] => xxxxx [method] => qimen.taobao.erp.order.sync [format] => json [sign] => xxxxxxxx [app_key] => xxxxxxx [sign_method] => md5 [timestamp] => 2020-04-22 00:10:00 )