API开放平台

TIP

新增直营发货单(仅保存发货单)
直营发货单签收接口
新增直营订单及发货单(先保存订单再保存发货单)
新增直营订单发货单运输信息
直营订单发货单自动签收
分销订单发货单自动签收
查询分销或者直营发货单
订单发货单红冲
新增分销发货单
新增批次发货单
互联采购单签收确认
直营发货单自定义字段更新

# 新增直营发货单(仅保存发货单)

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmssent/v1/addZySent/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "sent_no": "FH201612100000001",
    "sent_date": "2020-12-10",
    "order_id": "",
    "order_no": "DD201612090000001",
    "logistics_dept_code": "",
    "sign_status": "FH_CLZ",
    "business_status": "",
    "sent_storehouse_code": "",
    "sent_receive_code": "",
    "receive_name": "张三",
    "receive_phone": "18569854561",
    "receive_tel": "02578946932",
    "receive_addr": "江苏省南京市康缘智汇港",
    "exts": [
        {
            "ext_key": "级别",
            "ext_value": "四星"
        },
        {
            "ext_key": "主营商品",
            "ext_value": "食品,电器,日化用品"
        }
    ],
    "prods": [
        {
            "id": "",
            "posnr": "1",
            "sent_num": "5.00000000",
            "sent_input_unit": "6782340125265424027",
            "sent_input_unit_name": "箱",
            "sent_remark": "易损件",
            "exts": [
                {
                    "ext_key": "级别",
                    "ext_value": "四星"
                },
                {
                    "ext_key": "主营商品",
                    "ext_value": "食品,电器,日化用品"
                }
            ]
        }
    ]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
sent_no	VARCHAR(100)	否	发货单号不传时自动生成。如果不存在该发货单号则新增，如果已存在则修改发货单，仅允许系统状态为“处理中”的发货单支持修改。
sent_date	VARCHAR(32)	否	发货日期。格式：yyyy-mm-dd
order_no	VARCHAR(100)	是	订单号，订单id和订单号必须传一个
order_id	VARCHAR(32)	是	订单id，订单id和订单号必须传一个
logistics_dept_code	VARCHAR(32)	否	物流部门编码
sent_storehouse_code	VARCHAR(32)	否	厂家发货仓库编码
sign_status	VARCHAR(32)	是	发货单系统状态。“FH_CLZ：处理中”；“FH_DQS：待入库”，不传则默认为“FH_DQS：待入库”
business_status	VARCHAR(32)	否	发货单业务状态。“FH_CLZ：处理中”时允许传入对应的业务状态；“FH_DQS：待入库”时不需要传入
receive_name	VARCHAR(100)	否	收货人名称
receive_phone	VARCHAR(32)	否	收货人手机
receive_tel	VARCHAR(32)	否	收货人电话
receive_addr	VARCHAR(1000)	否	收货地址
receive_addr_id	VARCHAR(32)	否	收货地址id
sent_receive_code	VARCHAR(100)	否	收货方编码。不传则取直营订单的收货方。
prods	List		列表
prods.id	VARCHAR(32)	是	直营订单明细行id。直营订单明细行id和直营订单明细行行号必须传一个
prods.sent_num	NUMERIC(18,8)	是	发货数量
prods.sent_input_unit	VARCHAR(32)	否	发货单位和发货单位名称传一个即可，不传使用基本单位
prods.sent_input_unit_name	VARCHAR(100)	否	发货单位和发货单位名称传一个即可，不传使用基本单位
prods.posnr	NUMERIC(10)	是	直营订单明细行行号。直营订单明细行id和直营订单明细行行号必须传一个
prods.sent_remark	text	否	发货单行备注
prods.exts	List	否	发货单详情信息扩展字段列表
prods.exts.ext_key	varchar(4000)	否	发货单详情信息扩展字段key值扩展字段需先在我方系统中创建
prods.exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接
exts	List	否	发货单主信息扩展字段列表
exts.ext_key	varchar(4000)	否	发货单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明

# 直营发货单签收接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmssent/v1/signZySent/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
sent_no	VARCHAR(100)	是	发货单号
sent_create_date	VARCHAR(100)	否	发货单创建日期(格式为yyyy-MM-dd)
sign_status	VARCHAR(100)	是	签收状态(FH_YQS-已签收，FH_YJQ-已拒收)
sign_time	VARCHAR(100)	否	签收时间(格式为yyyy-MM-dd HH:mm:ss)。不传默认为系统时间
to_storehouse_code	VARCHAR(100)	否	收货仓库编码。不传则取客户默认仓库
sign_emp_name	VARCHAR(100)	否	签收人姓名
whole_order_flag	VARCHAR(100)	否	整单确认标识(Y-是,N-否)(默认为是)
details	List		列表
details.detail_id	VARCHAR(32)	是	发货单明细行id和明细行行号必须传一个
details.posnr	VARCHAR(100)	是	发货单明细行id和明细行行号必须传一个
details.unit_name	VARCHAR(100)	是	行单位名称
details.sign_num	VARCHAR(100)	是	行单位签收数量/span>

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明

# 新增直营订单及发货单(先保存订单再保存发货单)

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmssent/v1/addSent/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "sent_no": "FH201612100000001",
    "sent_date": "2020-12-10",
    "order_no": "DD201612090000001",
    "purchase_no": "CK20161209000001",
    "order_create_date": "2020-12-10",
    "cm_id": "6389893435290873348",
    "cm_code": "CM0001",
    "date": "2016-12-09",
    "emp_id": "9090338090192516225",
    "emp_code": "EMP0001",
    "consignment_date": "2016-12-10",
    "supply_id": "4778886974871755755",
    "supply_code": "SU00001",
    "sent_storehouse_id": "6210170610020953209",
    "sent_storehouse_code": "CK0001",
    "receive_name": "张三",
    "receive_phone": "18569854561",
    "receive_tel": "02578946932",
    "receive_addr": "江苏省南京市康缘智汇港",
    "receive_addr_id": "",
    "remark": "加急订单抓紧送货",
    "distribution_method": "配送方式",
    "exts": [
        {
            "ext_key": "级别",
            "ext_value": "四星"
        },
        {
            "ext_key": "主营商品",
            "ext_value": "食品,电器,日化用品"
        }
    ],
    "prods": [
        {
            "product_id": "7755038711664976249",
            "product_code": "PD001",
            "order_price": "20.000000",
            "order_count": "10.00000000",
            "order_input_unit": "6782340125265424027",
            "order_input_unit_name": "箱",
            "order_amount": "200.00",
            "order_discount_amount": "0.00",
            "sent_num": "5.00000000",
            "sent_input_unit": "6782340125265424027",
            "sent_input_unit_name": "箱",
            "is_gift": "N",
            "posnr": "10",
            "remark": "易损件",
            "exts": [
                {
                    "ext_key": "级别",
                    "ext_value": "四星"
                },
                {
                    "ext_key": "主营商品",
                    "ext_value": "食品,电器,日化用品"
                }
            ]
        }
    ]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
sent_no	VARCHAR(100)	否	发货单号不传自动生成
sent_date	VARCHAR(32)	否	发货日期。格式：yyyy-mm-dd
order_no	VARCHAR(100)	是	销售订单号，销售订单号和采购单号必须传一个
purchase_no	VARCHAR(100)	是	采购单号，销售订单号和采购单号必须传一个
order_create_date	VARCHAR(32)	否	订单创建日期。格式：yyyy-mm-dd
cm_id	VARCHAR(32)	是	客户id，客户id和客户编码必须传一个
cm_code	VARCHAR(100)	是	客户编码，客户id和客户编码必须传一个
date	VARCHAR(32)	否	业务日期。格式：yyyy-mm-dd
emp_id	VARCHAR(32)	否	业务员Id，业务员id和业务员编码都不传，默认取其中一个客户经理的
emp_code	VARCHAR(100)	否	业务员编码，业务员id和业务员编码都不传默认取其中一个客户经理的
consignment_date	VARCHAR(32)	否	要求交货日期。格式：yyyy-mm-dd
supply_id	VARCHAR(32)	否	供应商id，-1表示厂家供货。如果供应商id和供应商编码（经销商的编码）都不传将根据客户的上级经销商来查询
supply_code	VARCHAR(100)	否	供应商编码（经销商的编码），-1表示厂家供货。如果供应商id和供应商编码（经销商的编码）都不传将根据客户的上级经销商来查询
sent_storehouse_id	VARCHAR(32)	否	供应商发货仓库id。如果供应商发货仓库id和供应商发货仓库编码都不传，则根据供应商去查询默认仓库
sent_storehouse_code	VARCHAR(100)	否	供应商发货仓库编码。如果供应商发货仓库id和供应商发货仓库编码都不传，则根据供应商去查询默认仓库
receive_name	VARCHAR(100)	否	收货人名称
receive_phone	VARCHAR(32)	否	收货人手机
receive_tel	VARCHAR(32)	否	收货人电话
receive_addr	VARCHAR(1000)	否	收货地址
receive_addr_id	VARCHAR(32)	否	收货地址id
remark	text	否	订单表体备注
distribution_method	text	否	配送方式
sent_receive_id	VARCHAR(32)	否	发货单收货方id
sent_receive_code	VARCHAR(100)	否	发货单收货方编码
sent_receive_name	VARCHAR(100)	否	发货单收货方名称
sent_receive_addr_id	VARCHAR(32)	否	发货单收货地址id
sent_receive_addr	VARCHAR(100)	否	发货单收货地址名称
prods	List		列表
prods.product_id	VARCHAR(32)	是	商品id和商品编码必须传一个
prods.product_code	VARCHAR(100)	是	商品id和商品编码必须传一个
prods.order_price	NUMERIC(18,8)	否	订货价不传就取客户价格，赠品价格为0
prods.order_count	NUMERIC(18,8)	是	订货数量
prods.order_input_unit	VARCHAR(32)	否	订货单位id和订货单位名称传一个即可，不传使用基本单位
prods.order_input_unit_name	VARCHAR(32)	否	订货单位id和订货单位名称传一个即可，不传使用基本单位
prods.order_amount	NUMERIC(18,2)	否	订货金额
prods.order_discount_amount	NUMERIC(18,2)	否	订货优惠金额
prods.sent_num	NUMERIC(18,8)	是	发货数量
prods.sent_input_unit	VARCHAR(32)	否	发货单位和发货单位名称传一个即可，不传使用基本单位
prods.sent_input_unit_name	VARCHAR(32)	否	发货单位和发货单位名称传一个即可，不传使用基本单位
prods.is_gift	VARCHAR(10)	否	是否是赠品。Y：是，N：否。不传默认为非赠品
prods.posnr	NUMERIC(10)	是	对应订单下单商品的序号，标识本行发货是对着订单中的哪行商品进行发货的，且序号必须能对应上订单中序号
prods.remark	text	否	订单子表的备注
prods.sent_remark	text	否	发货单行备注
costpooldetails	List		列表
costpooldetails.account	VARCHAR(32)	否	客户账户名称
costpooldetails.amount	NUMERIC(18,8)	否	核销金额
products.exts	List	否	发货单详情信息扩展字段列表
products.exts.ext_key	varchar(4000)	否	发货单详情信息扩展字段key值扩展字段需先在我方系统中创建
products.exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接
exts	List	否	发货单主信息扩展字段列表
exts.ext_key	varchar(4000)	否	发货单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接

接口说明：订货价order_price不传默认取客户价格，是否是赠品is_gift不传默认为非赠品。如果该商品是赠品，order_price传0，is_gift传Y。未免出错，这二个字段建议必填

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明

# 新增直营订单发货单运输信息

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmssent/v1/addSentWaybilllogs/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "bill_code": "FH20201110000001",
    "driver_name":"小杜呀",
    "driver_phone":"13675189390",
    "car_no":"che1",
    "delivery_date":"2020-12-27",
    "remark":"我这是备注",
    "logistics_url":"",
    "url_type": "",
    "orderSents":[
        {
            "sent_id":"7817081791819132613",
            "sent_no":"FH20210118000003"
        }
    ],
    "exts":[
        {
            "ext_key": "自定义字段1",
            "ext_value": "自定义值1"
        },
        {
            "ext_key": "自定义字段2",
            "ext_value": "自定义值2"
        }
    ]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
bill_code	VARCHAR(100)	是	运单号
driver_name	VARCHAR(32)	否	司机名称
driver_phone	VARCHAR(32)	否	司机手机号
car_no	VARCHAR(32)	否	车牌号
delivery_date	TIMESTAMP	否	预计送达日期。格式：yyyy-MM-dd
remark	TEXT	否	备注
logistics_url	VARCHAR(100)	否	物流链接地址
url_type	VARCHAR(32)	否	链接类型
orderSents	List	否	发货单列表
orderSents.sent_id	INT8	否	发货单id，接口传参至少要传一条发货单数据
orderSents.sent_no	VARCHAR(100)	否	发货单号
exts	List	否	运单主信息扩展字段列表
exts.ext_key	varchar(4000)	否	运单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接

响应示例：

{
	"msg_id": "X000001",
	"return_code": 1,
	"return_msg": "",
	"response_data": null
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明
response_data	String	响应数据

# 直营订单发货单自动签收

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/zyOrderSign/v1/autoSignFromSentNo/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
sent_no	VARCHAR(100)	是	发货单号
sign_time	VARCHAR(32)	否	签收时间，yyyy-MM-dd HH:mm:ss

响应示例：

{
	"msg_id": "X000001",
	"return_code": 1,
	"return_msg": "",
	"response_data": null
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明
response_data	String	响应数据

# 分销订单发货单自动签收

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/fxOrderSign/v1/autoSignFromSentNo/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
sent_no	VARCHAR(100)	是	发货单号

响应示例：

{
	"msg_id": "X000001",
	"return_code": 1,
	"return_msg": "",
	"response_data": null
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明
response_data	String	响应数据

# 查询分销或者直营发货单

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsdatasearch/v1/getDmsOrderSentInfos/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
page_number	INT	否	页码默认1，每页默认1000条
page_length	INT	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整
s_status	CHAR(1)	否	记录状态。0：已删除，1：正常
order_no	VARCHAR(32)	否	订单编码
send_no	VARCHAR(32)	否	发货单编码，有效字符详见附录：有效字符说明 (opens new window)
order_type	VARCHAR(32)	否	单据类型。ZY：直营，FX：分销
after_create_date	TIMESTAMP	否	创建时间之后。格式：yyyy-MM-dd HH:mm:ss
after_modify_date	TIMESTAMP	否	修改时间之后。格式：yyyy-MM-dd HH:mm:ss
start_create_date	TIMESTAMP	否	创建时间开始。格式：yyyy-MM-dd
end_create_date	TIMESTAMP	否	创建时间结束。格式：yyyy-MM-dd
start_modify_date	TIMESTAMP	否	修改时间开始。格式：yyyy-MM-dd
end_modify_date	TIMESTAMP	否	修改时间结束。格式：yyyy-MM-dd

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "id": "7226306356013346628",
        "status": "1",
        "sent_no": "FH201612010001",
        "purchase_no": "CK201612010001",
        "order_no": "FX201612010001",
        "order_id": "7226306356013346628",
        "date": "2016-12-01",
        "order_amount": "10.00",
        "order_discount_amount": "2.00",
        "emp_dept_id": "6173157522867102283",
        "emp_dept_name": "市场部",
        "emp_dept_code": "DP00001",
        "emp_dept_source_code": "000001",
        "emp_id": "6360879952207158181",
        "emp_code": "EMP0001",
        "emp_name": "张明",
        "emp_source_code": "000001",
        "send_time_str": "2016-12-01 00:00:00",
        "send_id": "4786443529856258791",
        "send_name": "张三",
        "send_code": "EMP0001",
        "send_source_code": "EMP0001",
        "cm_id": "4786443529856258791",
        "cm_code": "CUS00001",
        "cm_name": "南京苏果超市",
        "cm_source_code": "0001",
        "cm_dept_id": "5479044577173277483",
        "cm_dept_name": "南京市场部",
        "cm_dept_code": "DP0001",
        "cm_dept_source_code": "00001",
        "sign_status": "CG_DFH",
        "order_status": "CG_DFH",
        "purchase_status": "CG_DFH",
        "consignment_date": "2016-12-01",
        "supply_id": "4786443529856258791",
        "supply_name": "CUS00001",
        "supply_code": "南京苏果超市",
        "supply_source_code": "0001",
        "receive_name": "李四",
        "receive_phone": "18254623212",
        "receive_tel": "02589652314",
        "receive_addr": "江苏省南京建邺区云龙山路66号",
        "remark": "请尽快送货",
        "from_storehouse": "4786443529856258791",
        "from_storehouse_name": "仓库1",
        "from_storehouse_code": "ck001",
        "order_type": "ZY",
        "instead_dispatch_cm_code": "CUS010058",
        "sent_receive_code": "CUS000003",
        "prods": 
        [
              {
                    "detail_id": "4843786111936788462",
                    "order_detail_id": "4843786111936788462",
                    "product_id": "4843786111936788462",
                    "product_name": "商品1",
                    "product_code": "P0001",
                    "product_source_code": "P0001",
                    "order_price": "10.00000000",
                    "order_count": "20.00000000",
                    "order_input_unit": "8215768532653672550",
                    "order_input_unit_name": "箱",
                    "base_unit": "6930792320160995628",
                    "base_unit_name": "瓶",
                    "order_base_unit_count": "120.00000000",
                    "order_amount": "200.00",
                    "order_discount_amount": "10.00",
                    "is_gift": "N",
                    "sent_input_unit": "8215768532653672550",
                    "sent_input_unit_name": "箱",
                    "sent_base_unit_num": "20.0000"
              }
       ]
    }
]

参数说明：

参数	类型	必填	说明
id	VARCHAR(32)	是	单据ID
status	VARCHAR(1)	否	0：已删除，1：正常
sent_no	VARCHAR(100)	否	发货单编号
purchase_no	VARCHAR(100)	否	直营订单号
order_no	VARCHAR(100)	否	分销订单号
order_id	VARCHAR(32)	否	对应的分销或者直营单id
date	TIMESTAMP	否	单据业务日期。格式：yyyy-mm-dd
order_amount	NUMERIC(20,2)	否	单据金额
all_sent_actual_amount	NUMERIC(20,2)	否	应支付金额
order_discount_amount	NUMERIC(20,2)	否	单据优惠金额
emp_dept_id	VARCHAR(32)	否	业务员下单时候所在的部门id
emp_dept_name	VARCHAR(100)	否	业务员下单时候所在的部门名称
emp_dept_code	VARCHAR(100)	否	业务员下单时候所在的部门编码
emp_dept_source_code	VARCHAR(32)	否	业务员下单时候所在的部门对应外部数据id
emp_id	VARCHAR(32)	否	单据业务员id
emp_code	VARCHAR(100)	否	员工编码
emp_name	VARCHAR(100)	否	单据业务员名称
emp_source_code	VARCHAR(32)	否	单据业务员对应外部数据id
send_time_str	TIMESTAMP	否	发货单发货时间。格式：yyyy-mm-dd hh24:mi:ss
send_id	VARCHAR(32)	否	发货人id
send_name	VRACHAR(100)	否	发货人名称
send_code	VRACHAR(100)	否	发货人编码
send_source_code	VRACHAR(32)	否	发货人对应外部数据id
cm_id	VARCHAR(32)	否	客户id
cm_code	VARCHAR(32)	否	客户编码
cm_name	VARCHAR(100)	否	客户名称
cm_source_code	VARCHAR(32)	否	客户对应外部数据id
cm_dept_id	VARCHAR(32)	否	下单时候客户所在的部门id
cm_dept_name	VARCHAR(100)	否	下单时候客户所在部门的名称
cm_dept_code	VARCHAR(100)	否	下单时候客户所在部门的编码
cm_dept_source_code	VARCHAR(32)	否	下单时候客户所在的部门对应外部数据id
sign_status	varchar(32)	否	发货单状态。FH_CLZ：发货处理中，FH_DQS：待签收，FH_YQS:已签收
order_status	varchar(32)	否	销售订单状态。XS_DFH：待发货，XS_DQS：待签收，XS_YWC：已完成，XS_DQR：待确认，XS_YQX：已取消，XS_FHZ：发货中
purchase_status	varchar(32)	否	直营订单状态。CG_DFH：待发货，CG_DRK：待入库，CG_YWC：已完成，CG_DQR：待确认，CG_YQX：已取消，CG_FHZ：发货中
consignment_date	TIMESTAMP	否	要求送货日期。格式：yyyy-mm-dd
supply_id	VARCHAR(32)	否	供货商id,-1就是没有供货商
supply_name	VARCHAR(200)	否	供货商名称
supply_code	VARCHAR(200)	否	供货商编码
supply_source_code	VARCHAR(32)	否	供货商第三方id
receive_name	varchar(100)	否	收货人名称
receive_phone	varchar(100)	否	收货人手机号码
receive_tel	varchar(100)	否	收货人电话
receive_addr	varchar(1000)	否	收货地址
remark	varchar(4000)	否	备注
from_storehouse	VARCHAR(32)	否	发货仓库id
from_storehouse_name	VARCHAR(200)	否	发货仓库名称
from_storehouse_code	VARCHAR(200)	否	发货仓库编码
order_type	varchar(20)	否	单据类型。ZY：直营，FX：分销
instead_dispatch_cm_code	varchar(32)	否	配送商编码
sent_receive_code	varchar(32)	否	收货方编码
exts	List	否	发货主数据自定义字段集合
exts.ext_key	VARCHAR(100)	否	发货主数据自定义字段名称
exts.ext_value	TEXT	否	发货主数据自定义字段数据值
exts.ext_column	VARCHAR(100)	否	发货主数据自定义字段code编码
prods	List		列表
prods.detail_id	VARCHAR(32)	是	发货子表id
prods.order_detail_id	VARCHAR(32)	否	分销单或直营单的子表id
prods.product_id	varchar(32)	否	商品id
prods.product_name	varchar(100)	否	商品名称
prods.product_code	varchar(100)	否	商品编码
prods.product_source_code	varchar(32)	否	商品对应外部数据id
prods.standard_price	numeric(28,8)	否	商品标准价
prods.posnr	numeric(10)	否	发货商品的序号
prods.order_price	numeric(28,8)	否	价格
prods.order_count	numeric(28,8)	否	数量
prods.order_input_unit	VARCHAR(32)	否	下单时候录入单位id
prods.order_input_unit_name	VARCHAR(100)	否	下单时候录入单位名称
prods.base_unit	VARCHAR(32)	否	下单时候商品基本单位id
prods.base_unit_name	VARCHAR(100)	否	下单时候商品基本单位名称
prods.order_base_unit_count	numeric(28,8)	否	数量转化成基本单位以后的数量
prods.order_amount	numeric(20,2)	否	金额
prods.order_discount_amount	numeric(20,2)	否	优惠金额
prods.is_gift	varchar(2)	否	是否是赠品。Y：是，N：否
prods.sent_num	numeric(28,8)	否	发货数量
prods.sent_input_unit	VARCHAR(32)	否	发货单位
prods.sent_input_unit_name	VARCHAR(100)	否	发货单位名称
prods.sent_base_unit_num	numeric(28,8)	否	发货数量转化成基本单位的数量
prods.exts	List	否	发货详情自定义字段集合
prods.exts.ext_key	VARCHAR(100)	否	发货详情自定义字段名称
prods.exts.ext_value	TEXT	否	发货详情自定义字段数据值
prods.exts.ext_column	VARCHAR(100)	否	发货详情自定义字段code编码
waybilllogs	List	否	列表
waybilllogs.bill_code	VARCHAR(100)	否	运单号
waybilllogs.driver_name	VARCHAR(32)	否	司机姓名
waybilllogs.driver_phone	VARCHAR(32)	否	司机联系电话
waybilllogs.car_no	VARCHAR(32)	否	车牌号码
waybilllogs.delivery_date	TIMESTAMP	否	预计送达时间
waybilllogs.remark	TEXT	否	备注

# 订单发货单红冲

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmssent/v1/counteractOrderSent/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
sent_no	VARCHAR(100)	否	发货单号，单号或者id传递其中的一个即可
sent_id	VARCHAR(100)	否	发货单id，单号或者id传递其中的一个即可

响应示例：

{
	"msg_id": "X000001",
	"return_code": 1,
	"return_msg": "",
	"response_data": null
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明
response_data	String	响应数据

# 新增分销发货单

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmssent/v1/addFxSent/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "sent_no": "FH201612100000001",
    "sent_date": "2020-12-10",
    "order_id": "",
    "order_no": "DD201612090000001",
    "sign_status": "FH_CLZ",
    "sent_storehouse_code": "",
    "sent_receive_code": "",
    "receive_name": "张三",
    "receive_phone": "18569854561",
    "receive_tel": "02578946932",
    "receive_addr": "江苏省南京市康缘智汇港",
    "exts": [
        {
            "ext_key": "级别",
            "ext_value": "四星"
        },
        {
            "ext_key": "主营商品",
            "ext_value": "食品,电器,日化用品"
        }
    ],
    "prods": [
        {
            "id": "",
            "posnr": "1",
            "sent_num": "5.00000000",
            "sent_input_unit": "6782340125265424027",
            "sent_input_unit_name": "箱",
            "sent_remark": "易损件",
            "exts": [
                {
                    "ext_key": "级别",
                    "ext_value": "四星"
                },
                {
                    "ext_key": "主营商品",
                    "ext_value": "食品,电器,日化用品"
                }
            ]
        }
    ]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
sent_no	VARCHAR(100)	否	发货单号，不传时自动生成
sent_date	VARCHAR(32)	否	发货日期。格式：yyyy-mm-dd
order_no	VARCHAR(100)	是	订单号，订单id和订单号必须传一个
order_id	VARCHAR(32)	是	订单id，订单id和订单号必须传一个
create_time	VARCHAR(100)	是	订单创建时间
sent_storehouse_code	VARCHAR(32)	否	发货仓库编码，没有则取默认仓库
sign_status	VARCHAR(32)	是	发货单系统状态。不传则默认为“FH_DQS：待入库”
receive_name	VARCHAR(100)	否	收货人名称
receive_phone	VARCHAR(32)	否	收货人手机
receive_tel	VARCHAR(32)	否	收货人电话
receive_addr	VARCHAR(1000)	否	收货地址
receive_addr_id	VARCHAR(32)	否	收货地址id
sent_receive_code	VARCHAR(100)	否	收货方编码。
prods	List		列表
prods.id	VARCHAR(32)	是	分销订单明细行id。分销订单明细行id和分销订单明细行行号必须传一个
prods.sent_num	NUMERIC(18,8)	是	发货数量
prods.sent_input_unit	VARCHAR(32)	否	发货单位和发货单位名称传一个即可，不传使用基本单位
prods.sent_input_unit_name	VARCHAR(100)	否	发货单位和发货单位名称传一个即可，不传使用基本单位
prods.posnr	NUMERIC(10)	是	分销订单明细行行号。分销订单明细行id和分销订单明细行行号必须传一个
prods.sent_remark	text	否	发货单行备注
prods.exts	List	否	发货单详情信息扩展字段列表
prods.exts.ext_key	varchar(4000)	否	发货单详情信息扩展字段key值扩展字段需先在我方系统中创建
prods.exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接
exts	List	否	发货单主信息扩展字段列表
exts.ext_key	varchar(4000)	否	发货单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明

# 新增批次发货单

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmssent/v1/addSentWithBatch/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "sent_no": "FH201612100000001",
    "sent_date": "2020-12-10",
    "purchase_id": "",
    "purchase_no": "DD201612090000001",
    "sign_status": "FH_CLZ",
    "sent_storehouse_code": "",
    "sent_receive_code": "",
    "receive_name": "张三",
    "receive_phone": "18569854561",
    "receive_tel": "02578946932",
    "receive_addr": "江苏省南京市康缘智汇港",
    "exts": [
        {
            "ext_key": "级别",
            "ext_value": "四星"
        },
        {
            "ext_key": "主营商品",
            "ext_value": "食品,电器,日化用品"
        }
    ],
    "prods": [
        {
            "order_detail_id": "",
            "order_detail_posnr": "1",
            "sent_num": "5.00000000",
            "sent_input_unit": "6782340125265424027",
            "sent_input_unit_name": "箱",
            "logistics_dept_code": "",
            "exts": [
                {
                    "ext_key": "级别",
                    "ext_value": "四星"
                },
                {
                    "ext_key": "主营商品",
                    "ext_value": "食品,电器,日化用品"
                }
            ]
        }
    ]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
purchase_id	VARCHAR(100)	否	直营订单id，与直营订单单号二者必传其一。
purchase_no	VARCHAR(100)	否	直营订单单号，与直营订单id二者必传其一。
sent_no	VARCHAR(100)	否	发货单号，不传时自动生成。
sign_status	VARCHAR(32)	否	发货单系统状态。不传则默认为“FH_DQS：待入库”
sign_business_status	VARCHAR(32)	否	发货单业务状态。不传则默认为“FH_DQS：待入库”
sent_date	VARCHAR(32)	否	发货日期。格式：yyyy-mm-dd
sent_storehouse_id	VARCHAR(32)	否	发货仓库id，与发货仓库编码必传其一。
sent_storehouse_code	VARCHAR(32)	否	发货仓库编码，与发货仓库id必传其一。
logistics_dept_code	VARCHAR(100)	否	物流部门编码
sent_receive_id	VARCHAR(32)	否	收货方id，与收货方编码、收货方名称必传其一。
sent_receive_code	VARCHAR(100)	否	收货方编码，与收货方id、收货方名称必传其一。
sent_receive_name	VARCHAR(100)	否	收货方名称，与收货方编码、收货方id必传其一。
receive_name	VARCHAR(100)	否	收货人名称
receive_phone	VARCHAR(32)	否	收货人手机
receive_tel	VARCHAR(32)	否	收货人电话
receive_addr	VARCHAR(1000)	否	收货地址
prods	List		商品列表
prods.order_detail_id	VARCHAR(32)	否	直营订单明细行id。直营订单明细行id和直营订单明细行行号必须传一个。
prods.order_detail_posnr	VARCHAR(32)	否	直营订单明细行行号。直营订单明细行id和直营订单明细行行号必须传一个。
prods.product_id	VARCHAR(32)	否	商品id，与商品编码必传其一。
prods.product_code	VARCHAR(32)	否	商品编码，与商品id必传其一。
prods.sent_num	NUMERIC(18,8)	是	发货数量。
prods.sent_input_unit	VARCHAR(32)	否	发货单位id和发货单位名称传一个即可，不传使用基本单位。
prods.sent_input_unit_name	VARCHAR(100)	否	发货单位id和发货单位名称传一个即可，不传使用基本单位。
prods.sent_detail_posnr	VARCHAR(10)	否	发货单批次明细行行号。
prods.batch_no	VARCHAR(100)	否	发货明细批次号。
prods.production_date	VARCHAR(100)	否	发货明细生产日期。
prods.exts	List	否	发货单详情信息扩展字段列表
prods.exts.ext_key	varchar(4000)	否	发货单详情信息扩展字段key值扩展字段需先在我方系统中创建
prods.exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接
exts	List	否	发货单主信息扩展字段列表
exts.ext_key	varchar(4000)	否	发货单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明

# 互联采购单签收确认

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/icesssstock/v1/verify/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "sent_no": "FH201612100000001",
    "sent_create_date": "2020-12-10",
    "all_sign": "N",
    "prods": [
        {
            "sequ": "1",
            "num": "5.00000000",
            "sent_detail_id": "6782340125265424027",
            "unit_name": "箱"
        }
    ]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
sent_no	VARCHAR(100)	是	发货单号，必须传递。
sent_create_date	VARCHAR(32)	否	发货创建日期。格式：yyyy-mm-dd
all_sign	VARCHAR(32)	否	是否全局签收。Y：是；N：否。
prods	List		商品列表
prods.sent_detail_id	VARCHAR(32)	否	发货单明细行id。发货单明细行id和发货单明细行行号必须传一个。
prods.sequ	VARCHAR(32)	否	发货单明细行行号。发货单明细行id和发货单明细行行号必须传一个。
prods.num	NUMERIC(18,8)	是	签收数量。
prods.unit_name	VARCHAR(100)	否	签收单位名称。

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明

# 直营发货单自定义字段更新

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmssent/v1/modifyUseDefinedVal/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "sent_no": "FH20201110000001",
    "exts":[{
        "ext_key":"等级",
        "ext_value":"VIP"
    }],
    "prods":[{
        "id":"20201110000001",
        "posnr":"1",
        "exts":[{
        	"ext_key":"商品等级",
        	"ext_value":"88VIP"
    	}]
    }]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
sent_no	VARCHAR(100)	是	发货单单号
exts	List		列表
exts.ext_key	VARCHAR(100)	是	发货单主数据扩展字段名称
exts.ext_value	VARCHAR(100)	是	发货单主数据扩展字段数据值
prods	List		列表
prods.id	VARCHAR(100)	否	发货单明细行id。ID和行号必传一个
prods.posnr	VARCHAR(100)	否	发货单明细行号。ID和行号必传一个
prods.exts	List		发货单明细数据扩展字段列表
prods.exts.ext_key	VARCHAR(100)	是	发货单明细数据扩展字段名称
prods.exts.ext_value	VARCHAR(100)	是	发货单明细数据扩展字段数据值

响应示例：

{
	"msg_id": "X000001",
	"return_code": 1,
	"return_msg": "",
	"response_data": null
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明
response_data	String	响应数据

← 分销订单推送发货单推送 →