# 查询分销或者直营签收单

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


{
    "page_number": 1,
    "s_status": 1,
    "send_no": "FH20150819",
    "send_date_begin": "2017-05-01 00:00:00",
    "send_date_end": "2017-05-31 00:00:00"
}  
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
page_length INT 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
s_status CHAR(1) 记录状态。0:已删除,1:正常
s_sign_status VARCHAR(32) 签收状态。FH_DQS:待签收,FH_YQS:已签收,FH_CLZ:处理中,FH_QSZ:签收中,FH_YJQ:已拒签。不传默认值为FH_YQS,多个值以","隔开
sign_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",
        "sign_no": "QS201612010001",
        "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",
        "sign_time_str": "2016-12-01 00:00:00",
        "sign_object_id": "4786443529856258791",
        "sign_object_name": "张三",
        "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",
        "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": "请尽快送货",
        "to_storehouse": "4786443529856258791",
        "to_storehouse_name": "仓库1",
        "to_storehouse_code": "ck001",
        "order_type": "ZY",
         "verification_code_sign": "1",
        "prods": 
        [
              {
                    "detail_id": "4843786111936788462",
                    "order_detail_id": "4843786111936788462",
                    "sent_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_num": "发货数量",
                    "sent_input_unit": "8215768532653672550",
                    "sent_input_unit_name": "箱",
                    "sent_base_unit_num": "20.0000",
                    "sign_num": "发货数量",
                    "sign_input_unit": "8215768532653672550",
                    "sign_input_unit_name": "箱",
                    "sign_base_unit_num": "20.0000",
                    "third_sign_num": ""
              }
       ]
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 单据ID
sent_id VARCHAR(32) 发货单据ID
status VARCHAR(1) 0:已删除,1:正常
sent_no VARCHAR(100) 发货单编号
sign_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) 单据金额
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
sign_time_str TIMESTAMP 签收时间。格式:yyyy-mm-dd hh24:mi:ss
sign_object_id VARCHAR(32) 签收人id
sign_object_name VRACHAR(100) 签收人名称
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
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) 收货地址
sent_receive_code varchar(100) 收货方编码
remark varchar(4000) 备注
to_storehouse VARCHAR(32) 签收仓库id
to_storehouse_name VARCHAR(200) 签收仓库名称
to_storehouse_code VARCHAR(200) 签收仓库编码
order_type varchar(20) 单据类型,ZY:直营,FX:分销
verification_code_sign varchar(20) 验证码回单确认。1:是,0:否
cm_location_a VARCHAR(100) 客户位置
sign_location_a VARCHAR(100) 签收位置
sign_deviation VARCHAR(100) 偏差距离(米)
sign_deviation_remark VARCHAR(4000) 偏差备注
sign_pictures VARCHAR(4000) 签收照片,多张使用逗号分隔
sign_mode varchar(32) 签收方式:ELECTRONIC_SEAL、电子签章,MESSAGES_SIGNATURE、短信签字,APPOWNER_SIGN、点击签收按钮签收(默认签收方式),SYSTEM_AUTO_SIGN、系统自动签收,OPENAPI_SIGN、外部接口签收,CMTENANT_SIGN、互联下游签收
sign_attachment TEXT 当发货单状态为FH_YQS,为签收文件地址。当发货当状态为FH_YJQ时,为拒收文件地址。
sign_attachment_full_path TEXT sign_attachment的全路径地址
sign_reason TEXT 当发货单状态为FH_YQS,为签收原因。当发货当状态为FH_YJQ时,为拒收原因。
review_position VARCHAR(100) 评价定位地址
sign_status varchar(32) 发货单状态。FH_DQS:待签收,FH_YQS:已签收,FH_CLZ:处理中,FH_QSZ:签收中,FH_YJQ:已拒签
logistics_dept_code varchar(4000) 物流部门编码
prods List 列表
prods.detail_id VARCHAR(32) 签收子表id
prods.sent_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.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.gift_amount numeric(20,2) 赠品金额
prods.gift_price numeric(20,2) 赠品单价
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.sign_num numeric(28,8) 签收数量
prods.sign_input_unit VARCHAR(32) 发货单位
prods.sign_input_unit_name VARCHAR(100) 签收单位名称
prods.sign_base_unit_num numeric(28,8) 签收数量转化成基本单位的数量
prods.third_sign_num numeric(28,8) 第三方签收数量
reviewInfos timestamp 评价内容列表
reviewInfos.review_time timestamp 评价时间。格式:yyyy-mm-dd hh24:mi:ss
reviewInfos.review_score numeric(15,0) 服务评分
reviewInfos.review_content VARCHAR(1000) 评价内容
reviewInfos.review_image VARCHAR(1000) 评价照片