接口文档

壹川接口文档V3

修改指定运单信息

更新时间：2018-06-13 16:53:11 更新人员：叶洋

文档状态：完成 #317 测试接口

章节导航器

接口基本信息
路由参数
请求参数

摘要

接口基本信息

接口名称：修改已有的一个运单信息
请求方法：PUT
接口地址：waybill/:waybill_id
登录验证：是

路由参数

参数名	参数	数据类型	是否必须	示例值	说明
waybill_id	运单id	string	是

请求参数

参数名	参数	数据类型	是否必须	示例值	说明
is_preset_waybill	是否为预制运单	int	否		是否预制单，1:是(必须传预制单单号)，0:否
waybill_no	运单号	string	否
third_waybill_no	客户单号	string	否		客户方单号
send_time	发货时间	string	是		发货时间，提交时间日期YYYY-mm-dd格式字符串
arrive_date	预设到达日期	string	否		预设到达（收货）日期，传递日期yyyy-mm-dd格式
shipper{}	发货方	object	是
├ name	├ 发货方姓名	string	是
├ phone	├ 发货方电话	string	是
├ reserve_phone	├ 发货方座机	string	否
├ address	├ 客户地址（发货方）	string	是
├ province_id	├ 省（发货方）	int	是
├ city_id	├ 市（发货方）	int	是
├ district_id	├ 区（发货方）	int	是
├ lng	├ 经度（发货方）	float	是
└ lat	└ 纬度（发货方）	float	是
consignee{}	收货方	object	是
├ name	├ 收货方姓名	string	是
├ phone	├ 收货方电话	string	是
├ reserve_phone	├ 收货方座机	string	否
├ address	├ 客户地址（收货方）	string	是
├ province_id	├ 省（收货方）	int	是
├ city_id	├ 市（收货方）	int	是
├ district_id	├ 区（收货方）	int	是
├ lng	├ 经度（收货方）	float	是
└ lat	└ 纬度（收货方）	float	是
lineids	经历线路集合	string	否		该运单选择所经历的线路，多个以逗号分隔
start_net_id	起始网点id	string	否		网点id,16位字符串
end_net_id	终止网点id	string	否		网点id,如果运单为外包单，此值应为外包网点
has_outsourcing_bill	是否存在走外包单	int	否		外包单标识, 1:存在，0:不存在，不传时默认为0
cargos[]	货物列表数组	array	是		货物列表数组数据
├ name	├ 货物名称	string	是		货物名称
├ num	├ 货物数量	int	否
├ packing	├ 包装方式	int	否		1:无 2:纸箱 3:铁桶 4:编袋 5:木箱 6:泡沫 7:草绳 8:竹筐 9:麻袋 10:皮箱 11:油纸 12:塑胶 13:箩筐 14:铁皮 15:信封
├ weight	├ 重量	float	是
├ volume	├ 体积	float	是
├ cost	├ 货值	float	否
├ rates	├ 保率	float	否
├ premium	├ 保险费	float	否
└ type	└ 货物类型	string	否		快货运货物类型
total_weight	总重量	float	是		总重量
total_volume	总体积	float	是		总体积
fee{}	运单费用	object	否
├ carriage_fee_inp	├ 运输费-填	float	否
├ pickup_fee	├ 提货费	float	否
├ cfs_fee	├ 装卸费	float	否
├ forklift_fee	├ 叉车费	float	否
├ intro_fee	├ 信息费	float	否
├ deliver_fee	├ 送货费	float	否
├ insure_fee_inp	├ 保险费	float	否
├ insure_fee	├ 系统保费	float	否		该项保险费由系统向网点收取，不会显示到打印运单上
├ agencyfund_fee	├ 代收款金额	float	否
├ tax_rate	├ 税率	float	否
├ tax_fee	├ 税费	float	否
└ repay_oli_fee	└ 预付油费	float	否
payment_method	付款方式	int	是		101:现付；102：回单付：201：到付；202：货款扣；203：货款不代扣
delivery_method	送货方式	int	是		1:自提, 2:送货, 3: 驾驶员直送
need_receipt	是否需要回单	int	否		是否需要回单，1需要，0不需要，不传默认为不需要
need_receipt_copies	需要回单份数	int	否		如果需要回单，此项必填
agencyfund{}	代收款列表	object	否
├ back_start_net	├ 代收款直接返至发货点吗	int	否		1是的，0不是
├ udbc_cardholder	├ 收款人姓名	string	否		要与银行卡持卡人姓名一致
├ udbc_mobile	├ 收款人手机号	string	否		收款人手机号（与银行卡绑定手机号码一致）
├ udbc_cardno	├ 银行卡卡号	string	否		银行卡卡号
├ udbc_bankname	├ 银行卡发卡银行名称	string	否		银行卡发卡银行名称
└ back_start	└ 返款起	int	否
need_insure	是否需要投保	string	否	1	是否投保，1是 0否
badge	运单标签	string	否	1,2	加急易损等从配置项WBILL_BADGE里面取，保存时保存key值，多个用逗号分隔
remark	运单备注信息	string	否		运单备注信息
waybill_type	运单类型	int	否
prebill_id	预单id	string	否		如果是城配单需要传入预单id关联
tax_type	是否报税种	string	否		0为不报

本书创建于 2018-03-30 12:03:13 ？如有疑问，请联系技术人员