# 分销或者直营发货单相关数据同步

请求方式: POST(HTTPS
请求地址: 第三方服务接口URL
请求示例:

{
			"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",
			"trade_type": "2",
			"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(18,2) 单据金额
order_discount_amount NUMERIC(18,2) 单据优惠金额
emp_dept_id VARCHAR(32) 业务员下单时候所在的部门id
emp_dept_name VARCHAR(100) 业务员下单时候所在的部门名称
emp_dept_code VARCHAR(100) 业务员下单时候所在的部门编码
emp_dept_source_code VARCHAR(100) 业务员下单时候所在的部门对应外部数据id
emp_id VARCHAR(32) 单据业务员id
emp_code VARCHAR(100) 员工编码
emp_name VARCHAR(100) 单据业务员名称
emp_source_code VARCHAR(100) 单据业务员对应外部数据id
send_time_str VARCHAR(32) 发货单发货时间,yyyy-mm-dd hh24:mi:ss格式
send_id VARCHAR(32) 发货人id
send_name VRACHAR(100) 发货人名称
send_code VRACHAR(100) 发货人编码
send_source_code VRACHAR(100) 发货人对应外部数据id
cm_id VARCHAR(32) 客户id
cm_code VARCHAR(100) 客户编码
cm_name VARCHAR(100) 客户名称
cm_source_code VARCHAR(100) 客户对应外部数据id
cm_dept_id VARCHAR(32) 下单时候客户所在的部门id
cm_dept_name VARCHAR(100) 下单时候客户所在部门的名称
cm_dept_code VARCHAR(100) 下单时候客户所在部门的编码
cm_dept_source_code VARCHAR(100) 下单时候客户所在的部门对应外部数据id
sign_status varchar(32) 发货单状态。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 VARCHAR(32) 要求送货日期。格式:yyyy-mm-dd
supply_id VARCHAR(32) 供货商id。-1或者空就是没有供货商
supply_name VARCHAR(100) 供货商名称
supply_code VARCHAR(100) 供货商编码
supply_source_code VARCHAR(100) 供货商第三方id
receive_name varchar(1000) 收货人名称。
注:此处收货人信息是由业务员在下单时选择或手工输入
receive_phone varchar(100) 收货人手机号码
receive_tel varchar(100) 收货人电话
receive_addr varchar(4000) 收货地址
remark varchar(4000) 备注
from_storehouse VARCHAR(32) 发货仓库id
from_storehouse_name VARCHAR(100) 发货仓库名称
from_storehouse_code VARCHAR(100) 发货仓库编码
order_type varchar(20) 单据类型,ZY:直营,FX:分销
trade_type VARCHAR(32) 客户类型2:经销商,3:终端门店
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(4000) 商品名称
prods.product_code varchar(4000) 商品编码
prods.product_source_code varchar(4000) 商品对应外部数据id
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(10,2) 金额
prods.order_discount_amount numeric(10,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) 发货数量转化成基本单位的数量
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 预计送达时间。格式yyyy-mm-dd hh24:mi:ss
waybilllogs.remark TEXT 备注

响应示例:

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

参数说明:

参数 说明
return_code 响应编码
return_msg 响应消息内容
msg_id 消息ID

# 直营发货单运输信息相关数据推送

请求方式: POST(HTTPS
请求地址: 第三方服务接口URL
请求示例:

{
			"id": "7226306356013346628",
			"status": "1",
			"creator_id": "5479044577173277483",
			"create_time": "2016-12-01 00:00:00",
			"modifyier_id": "5479044577173277483",
			"modify_time": "2016-12-01 00:00:00",
			"bill_code": "5479044577173277483",
			"driver_name": "李四",
			"driver_phone": "18395573679",
			"car_no": "5479044577173277483",
			"delivery_date": "2016-12-01 00:00:00",
			"remark": "测试!",
			"orderSents": 
			[
			      {
			            "id": "4843786111936788462",
			            "status": "1",
			            "creator_id": "4843786111936788462",
			            "create_time": "2016-12-01 00:00:00",
			            "modifyier_id": "4843786111936788462",
                        "modify_time": "2016-12-01 00:00:00",
			            "sent_id": "8215768532653672550",
			            "sent_no": "TC1234556789",
			            "waybill_id": "7226306356013346628",
			            "sent_date": "2016-12-01 00:00:00"
                }
			],
            "exts":[
                {
                    "ext_key": "自定义字段1",
                    "ext_value": "自定义值1"
                },
                {
                    "ext_key": "自定义字段2",
                    "ext_value": "自定义值2"
                }
            ]
}

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 运输信息ID
status VARCHAR(1) 0:已删除,1:正常
creator_id VARCHAR(32) 运输信息创建人id
create_time VARCHAR(100) 运输信息创建时间,"2016-12-01 00:00:00"
modifyier_id VARCHAR(32) 运输信息修改人id
modify_time VARCHAR(100) 运输信息修改时间,"2016-12-01 00:00:00"
bill_code VARCHAR(100) 运单号
driver_name VARCHAR(100) 司机名称
driver_phone VARCHAR(100) 司机手机号
car_no VARCHAR(100) 车牌号
delivery_date VARCHAR(100) 送达日期,"2016-12-01 00:00:00"
remark VARCHAR(100) 备注
orderSents List
orderSents.id VARCHAR(32) 关联表id
orderSents.status varchar(1) 0:已删除,1:正常
orderSents.creator_id varchar(32) 关联表创建人id
orderSents.create_time varchar(100) 创建时间,"2016-12-01 00:00:00"
orderSents.modifyier_id varchar(32) 关联表修改人id
orderSents.modify_time varchar(100) 关联表修改时间,"2016-12-01 00:00:00"
orderSents.sent_id varchar(32) 发货单id
orderSents.sent_no VARCHAR(100) 发货单号
orderSents.waybill_id VARCHAR(32) 运输信息id
orderSents.sent_date VARCHAR(100) 发送时间
exts List 运单主信息扩展字段列表
exts.ext_key varchar(4000) 运单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接

响应示例:

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

参数说明:

参数 说明
return_code 响应编码
return_msg 响应消息内容
msg_id 消息ID

# 直营发货单签收设置数据同步

请求方式: POST(HTTPS
请求地址: 第三方服务接口URL
请求示例:

{
			"id": "7226306356013346628",
			"status": "1",
			"customer_range": "2",
			"sign_method": "MESSAGES_SIGNATURE",
			"create_time": "2022-08-15 16:05",
			"modify_time": "",
			"cm_id": "2016-12-01",
			"cm_code": "10.00",
			"cm_name": "2.00",
			"districtList":
			[
			    {
                    "code":"",
                    "name":"",
                    "id":""
                }	
			],
			"deptList":
            [
            	{
                    "code":"lhmfxb",
                    "name":"南京市加菲猫系列有限责任公司",
                    "id":"10"
                }		
            ],
            "typeList":
            [
                {
                    "code":"",
                    "name":"",
                    "id":""
                }	        			
            ],
            "levelList":
            [
                {
                    "name":"",
                    "id":""
                }	                    			
            ]
}

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 主键id
status VARCHAR(1) 0:已删除,1:正常, 如果已删除此字段下的所有字段信息不推送
create_time VARCHAR(2) 创建时间。格式:yyyy-MM-dd HH:mm:ss
modify_time VARCHAR(2) 修改时间。格式:yyyy-MM-dd HH:mm:ss
sign_method VARCHAR(2) 签收方式。ELECTRONIC_SEAL:客户使用电子签章方式签收;MESSAGES_SIGNATURE:客户使用短信+手写签字方式签收;APPOWNER_SIGN:客户点“签收”按钮即视同已签收
customer_range VARCHAR(2) 客户范围。1:指定具体客户;2:按客户属性设置范围
cm_id VARCHAR(32) 客户id。customer_range = 1
cm_code VARCHAR(100) 客户编码。customer_range = 1
cm_name VARCHAR(100) 客户名称。customer_range = 1
districtList List 销售区域列表
districtList.id VARCHAR(32) 销售区域id
districtList.code VARCHAR(100) 销售区域编码
districtList.name varchar(100) 销售区域名称
deptList List 客户部门列表
deptList.id VARCHAR(32) 客户部门id
deptList.code VARCHAR(100) 客户部门编码
deptList.name varchar(100) 客户部门名称
typeList List 客户类型列表
typeList.id VARCHAR(32) 客户类型id
typeList.code VARCHAR(100) 客户类型编码
typeList.name varchar(100) 客户类型名称
levelList List 客户级别列表
levelList.id VARCHAR(32) 客户级别id
levelList.name VARCHAR(100) 客户级别名称

响应示例:

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

参数说明:

参数 说明
return_code 响应编码
return_msg 响应消息内容
msg_id 消息ID