文 档 中 心 / Document Center
搜索 管理中心
壹川接口文档V3
添加新运单
更新时间:2018-06-13 16:49:32   更新人员:叶洋   文档状态:完成 #315    测试接口
摘要
  1. 接口基本信息
    接口名称:创建一个新的运单信息
    请求方法:POST
    接口地址:waybill
    登录验证:是
  2. 请求参数
    参数名 参数 数据类型 是否必须 示例值 说明
    is_preset_waybill 是否为预制运单 int 是否预制单,1:是(必须传预制单单号),0:否
    waybill_type 运单类型 int 1(默认值)为网点线路运单,2为司机城配
    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
    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 ├ 返款起 int 城配生效,返款到起点/发货人,1是0否
    ├ back_start_net ├ 代收款直接返至发货点吗 int 网点干线生效,1是的,0不是
    ├ udbc_cardholder ├ 收款人姓名 string 要与银行卡持卡人姓名一致
    ├ udbc_mobile ├ 收款人手机号 string 收款人手机号(与银行卡绑定手机号码一致)
    ├ udbc_cardno ├ 银行卡卡号 string 银行卡卡号
    └ udbc_bankname └ 银行卡发卡银行名称 string 银行卡发卡银行名称
    need_insure 是否需要投保 string 1 是否投保,1是 0否
    badge 运单标签 string 1,2 加急 易损 等从配置项WBILL_BADGE里面取,保存时保存key值,多个用逗号分隔
    remark 运单备注信息 string 运单备注信息
    prebill_id 来自预单ID string 如果是从预单开的单子,就传预单id进来,如果不是就不传
    dispatch_id 调度单id string 如果是从调度单转入的,需要填调度单id,如果不是就不要传
    is_delayed_settlement 是否延迟结算 int 0否1是,默认为0。延迟结算运单只能手动发起结算,费用在结算时才开始计算、收取、发放分成。
    tax_type 是否报税税种 int 是否报税,0为否,其它为税种id
    customer_id 客户项目id string
    is_monthly_balance 是否月结单 int
    donot_divide 系统不参与分成标识 int 默认0:系统要参与;1:系统不参与
  3. 响应数据参数
    参数名 参数 数据类型 示例值 说明
    waybill_id 运单id string
    waybill_no 运单号 string
  4. 请求示例
    请求例子:
     
    apirq('waybill', {
        method: "post",
        data: {
            "is_preset_waybill": 0,
            "waybill_no": "",
            "third_waybill_no": "",
            "send_time": "2018-06-05",
            "arrive_date": "2018-06-22",
            "shipper": {
                "name": "王小烟",
                "phone": "13722567786",
                "reserve_phone": "",
                "address": "四川省成都市都江堰市玉堂镇苏家山",
                "province_id": 37491,
                "city_id": 37917,
                "district_id": 37983,
                "lng": 103.575248,
                "lat": 30.974482
            },
            "consignee": {
                "name": "洛天依",
                "phone": "13955321145",
                "reserve_phone": "",
                "address": "四川省成都市新都区新都镇邮电小区邮电小区(电子路)",
                "province_id": 37491,
                "city_id": 37917,
                "district_id": 38320,
                "lng": 104.149363,
                "lat": 30.817605
            },
            "lineids": "e756e30f22ed34ee",
            "start_net_id": "2c4da2ba57bcfcf6",
            "end_net_id": "c97bea48dc2af334",
            "has_outsourcing_bill": 0,
            "cargos": [
                {
                    "name": "衣柜",
                    "num": 1,
                    "packing": "2",
                    "weight": 36,
                    "volume": 4,
                    "cost": 0,
                    "rates": 0.001,
                    "premium": 1
                },
                {
                    "name": "桌子",
                    "num": 1,
                    "packing": "2",
                    "weight": 22,
                    "volume": 5,
                    "cost": 0,
                    "rates": 0.001,
                    "premium": 1
                }
            ],
            "total_weight": 58,
            "total_volume": 9,
            "fee": {
                "carriage_fee_inp": 300,
                "pickup_fee": 20,
                "cfs_fee": 15,
                "forklift_fee": 18,
                "intro_fee": 5,
                "deliver_fee": 8,
                "insure_fee_inp": 4,
                "insure_fee": 0,
                "agencyfund_fee": 0
            },
            "payment_method": "101",
            "delivery_method": "1",
            "need_receipt": 0,
            "need_receipt_copies": 0,
            "remark": "",
            "signature": "8246b60cb9b15036c70fd92f2b22e69c"
        }
    }) 
    
    返回数据结果:
     
    {
        "code": 0,
        "msg": "数据添加成功!",
        "time": "1528194529",
        "data": {
            "waybill_id": "5b1665e101691253",
            "waybill_no": "A10037"
        }
    } 
    
本书创建于 2018-03-30 12:03:13 ?如有疑问,请联系技术人员