奇门ISV接入白皮书
2015/11/23 2.3 1、发货单创建接口，出参response下增加createTime。 新增4个接口，主要用来注册奇门的仓库编码，奇门的用户号，包括奇门仓库注册接口，奇门仓库查询接口，奇门仓库更新接口，奇门用户注册接口 1、新增店铺同步接口 1、新增库存查询接口（多条件） 1、新增挂起（恢复）接口 2、取消和挂起接口的订单类型增加THRK=退货入库 1、组合商品增加itemId字段 1、出库单确认接口，orderline节点下增加货主编码这个字段 2、单据取消接口，单据类型增加采购退货出库 1、商品同步接口，商品同步接口（批量）新增字段goodsCode 2015/11/25 2015/12/3 2015/12/8 2015/12/21 2015/12/28 2015/12/30 2.4 2.4 2.4 2.4 2.4 2.4 2015/12/31 2.4
6
奇门ISV接入白皮书
2 目录
1 2 3
版本记录 ................................................................................................ 2 目录 ....................................................................................................... 7 前言 ..................................................................................................... 13
业务背景 .................................................................................................. 13 名词解释 .................................................................................................. 13
3.1 3.2
4 奇门对接方案 ....................................................................................... 14
奇门对接方式 .......................................................................................... 14 奇门标准化对接构架 ............................................................................... 15 系统调用流程 .......................................................................................... 16 联调、测试方式 ....................................................................................... 16
4.1 4.2 4.3 4.4
4.4.1 ERP端 .......................................................................................................... 17 4.4.2 WMS端 ....................................................................................................... 17
5 接口规范 .............................................................................................. 19
ERP与奇门的通信协议 ............................................................................. 19
协议描述 .................................................................................................... 19 访问授权 .................................................................................................... 19 请求参数说明 ............................................................................................ 20 响应参数 .................................................................................................... 20
5.1
5.1.1 5.1.2 5.1.3 5.1.4 5.2
奇门与WMS的通信协议 ......................................................................... 20 协议描述 .................................................................................................... 20 请求参数 .................................................................................................... 21 响应参数 .................................................................................................... 22
5.2.1 5.2.2 5.2.3
6 接口说明 .............................................................................................. 22
商品同步接口 .......................................................................................... 22
7
6.1
奇门ISV接入白皮书
6.1.1 6.1.2 6.1.3 6.2
接口介绍 .................................................................................................... 22 入参规范 .................................................................................................... 22 出参规范 .................................................................................................... 25
组合商品接口 .......................................................................................... 28 接口介绍 .................................................................................................... 28 入参规范 .................................................................................................... 28 出参规范 .................................................................................................... 28
6.2.1 6.2.2 6.2.3 6.3
入库单创建接口 ....................................................................................... 29 接口介绍 .................................................................................................... 29 入参规范 .................................................................................................... 29 出参规范 .................................................................................................... 32
6.3.1 6.3.2 6.3.3 6.4
入库单确认接口 ....................................................................................... 32 接口介绍 .................................................................................................... 32 入参规范 .................................................................................................... 32 出参规范 .................................................................................................... 34
6.4.1 6.4.2 6.4.3 6.5
入库单查询接口 ....................................................................................... 34 接口介绍 .................................................................................................... 34 入参规范 .................................................................................................... 34 出参规范 .................................................................................................... 35
6.5.1 6.5.2 6.5.3 6.6
退货入库单创建接口 ............................................................................... 36 接口介绍 .................................................................................................... 36 入参规范 .................................................................................................... 36 出参规范 .................................................................................................... 38
6.6.1 6.6.2 6.6.3 6.7
退货入库单确认接口 ............................................................................... 38 接口介绍 .................................................................................................... 38 入参规范 .................................................................................................... 38 出参规范 .................................................................................................... 40
6.7.1 6.7.2 6.7.3 6.8
退货入库单查询接口 ............................................................................... 41
8
奇门ISV接入白皮书
6.8.1 6.8.2 6.8.3 6.9
接口介绍 .................................................................................................... 41 入参规范 .................................................................................................... 41 出参规范 .................................................................................................... 41
出库单创建接口 ....................................................................................... 43 接口介绍 .................................................................................................... 43 入参规范 .................................................................................................... 43 出参规范 .................................................................................................... 46 出库单确认接口 ..................................................................................... 46 接口介绍 .................................................................................................. 46 入参规范 .................................................................................................. 46 出参规范 .................................................................................................. 49
6.9.1 6.9.2 6.9.3 6.10
6.10.1 6.10.2 6.10.3 6.11
出库单查询接口 ..................................................................................... 49 接口介绍 .................................................................................................. 49 入参规范 .................................................................................................. 49 出参规范 .................................................................................................. 50
6.11.1 6.11.2 6.11.3 6.12
发货单创建接口 ..................................................................................... 52 接口介绍 .................................................................................................. 52 入参规范 .................................................................................................. 52 出参规范 .................................................................................................. 56
6.12.1 6.12.2 6.12.3 6.13
发货单确认接口 ..................................................................................... 62 接口介绍 .................................................................................................. 62 入参规范 .................................................................................................. 62 出参规范 .................................................................................................. 66
6.13.1 6.13.2 6.13.3 6.14
发货单查询接口 ..................................................................................... 70 接口介绍 .................................................................................................. 70 入参规范 .................................................................................................. 70 出参规范 .................................................................................................. 71
6.14.1 6.14.2 6.14.3 6.15
发货单SN通知接口 ............................................................................... 74
9
奇门ISV接入白皮书
6.15.1 6.15.2 6.15.3 6.16
接口介绍 .................................................................................................. 74 入参规范 .................................................................................................. 74 出参规范 .................................................................................................. 75
订单流水查询接口 ................................................................................. 75 接口介绍 .................................................................................................. 75 入参规范 .................................................................................................. 75 出参规范 .................................................................................................. 75
6.16.1 6.16.2 6.16.3 6.17
订单状态查询接口（批量） .................................................................. 77 接口介绍 .................................................................................................. 77 入参规范 .................................................................................................. 77 出参规范 .................................................................................................. 77
6.17.1 6.17.2 6.17.3 6.18
订单流水通知接口 ................................................................................. 78 接口介绍 .................................................................................................. 78 入参规范 .................................................................................................. 78 出参规范 .................................................................................................. 79
6.18.1 6.18.2 6.18.3 6.19
发货单缺货通知接口 ............................................................................. 80 接口介绍 .................................................................................................. 80 入参规范 .................................................................................................. 80 出参规范 .................................................................................................. 81
6.19.1 6.19.2 6.19.3 6.20
发货单缺货查询接口 ............................................................................. 81 接口介绍 .................................................................................................. 81 入参规范 .................................................................................................. 81 出参规范 .................................................................................................. 81
6.20.1 6.20.2 6.20.3 6.21
单据取消接口 ........................................................................................ 82 接口介绍 .................................................................................................. 82 入参规范 .................................................................................................. 82 出参规范 .................................................................................................. 83
6.21.1 6.21.2 6.21.3 6.22
库存查询接口 ........................................................................................ 84
10