# 查询订单数据

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

{
    "page_number": 1,
    "id":"7992869671049732483",
	"status":"1",
	"cm_id":"6563654583404943994",
	"cm_code":" DD000201700290",
	"create_date":"2017-08-16",
	"modify_date":"2017-08-16"
}

参数说明:

参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
status CHAR(1) 记录状态。0:已删除,1:正常
cm_id VARCHAR(32) 勤策客户唯一ID
cm_code VARCHAR(32) 客户编码,有效字符详见附录:有效字符说明 (opens new window)
dept_id VARCHAR(32) 勤策业务员部门唯一ID
dept_code VARCHAR(32) 业务员部门编码
create_date VARCHAR(32) 创建日期。格式:yyyy-MM-dd
modify_date VARCHAR(32) 修改日期。格式:yyyy-MM-dd
after_create_date VARCHAR(32) 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date VARCHAR(32) 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
start_create_date VARCHAR(32) 创建时间开始。格式:yyyy-MM-dd
end_create_date VARCHAR(32) 创建时间结束。格式:yyyy-MM-dd HH:mm:ss
start_modify_date VARCHAR(32) 修改时间开始。格式:yyyy-MM-dd HH:mm:ss
end_modify_date VARCHAR(32) 修改时间结束。格式:yyyy-MM-dd
start_consignment_date VARCHAR(32) 交货日期开始时间。格式:yyyy-MM-dd
end_consignment_date VARCHAR(32) 交货日期结束时间。格式:yyyy-MM-dd
id VARCHAR 勤策中id
order_status VARCHAR 订单状态:0:待确认,1:已确认,2:打回,3:已关闭,4:部分发货
start_confirm_time VARCHAR(32) 审批通过开始时间。格式:yyyy-MM-dd HH:mm:ss
end_confirm_time VARCHAR(32) 审批通过结束时间。格式:yyyy-MM-dd HH:mm:ss
dealer VARCHAR 供货商ID
dealer_code VARCHAR(32) 供货商编码

响应示例:

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

数据DATA示例:

[
    {
          "confirm_emp_code": "cclb",
          "submit_emp_code": "smj_lb",
          "confirm_emp_name": "老板",
            "prods": [
                {
                    "gift_amount": "0.00",
                    "cost_price": "800.00",
                    "base_unit_confirm_count": "12.0000",
                    "confirm_amount": "10665.60",
                    "gift_price": "0.00",
                    "discount_amount": "10665.60",
                    "order_amount": "10665.60",
                    "cost_amount": "9600.00",
                    "price": "888.80",
                    "tax": "0.00",
                    "confirm_count": "12.0000",
                    "tax_amount": "0.00",
                    "base_unit_order_count": "12.0000",
                    "stay_sent_num": "0.0000",
                    "order_count": "12.0000",
                    "incentives_amount": "0.00",
                    "voucher_discount": "0.00",
                    "bill_discount": "0.00",
                    "exts_detail":[
                        {
                          "ext_key":"文本框",
                          "ext_value":""
                        },
                        {
                          "ext_key":"数值输入框",
                          "ext_value":""
                        },
                        {
                          "ext_key":"下拉选项",
                          "ext_value":""
                        }
                    ]
                },
                {
                    "gift_amount": "0.00",
                    "cost_price": "0.00",
                    "base_unit_confirm_count": "12.0000",
                    "confirm_amount": "14400.00",
                    "gift_price": "0.00",
                    "discount_amount": "14400.00",
                    "order_amount": "14400.00",
                    "cost_amount": "0.00",
                    "price": "1200.00",
                    "tax": "0.00",
                    "confirm_count": "12.0000",
                    "tax_amount": "0.00",
                    "base_unit_order_count": "12.0000",
                    "stay_sent_num": "0.0000",
                    "order_count": "12.0000",
                    "incentives_amount": "0.00",
                    "voucher_discount": "0.00",
                    "bill_discount": "0.00",
                    "exts_detail":[
                        {
                          "ext_key":"文本框",
                          "ext_value":""
                        },
                        {
                          "ext_key":"数值输入框",
                          "ext_value":""
                        },
                        {
                          "ext_key":"下拉选项",
                          "ext_value":""
                        }
                    ]
                }
            ],
            "receive_phone": "",
            "order_no": "SD201608090001",
            "cm_source_code": "",
            "dealer": "",
            "write_off_status": "0",
            "storehouse_name": "WQ110",
            "del_remark": "",
            "storehouse_code": "CK0127",
            "dealer_name": "",
            "cm_name": "Wxxjinxiaoshang",
            "status": "1",
            "discount_amount": "25185.60",
            "order_status": "3",
        	"close_detail_status": "全部发货关闭",
            "cost_amount": "9660.00",
            "confirm_emp_id": 5631794108288395000,
            "dealer_source_code": "",
            "cm_linkman_name": "",
            "confirm_time": "2016-08-17 09:51:04",
            "visit_implement_id": "",
            "submit_emp_name": "宋敏健_lb",
            "reconfirm_reason": "",
            "consignment_date": "2016-11-23 00:00:00",
            "cm_id": 8959813786535511000,
            "receive_name": "wangwei",
            "order_remark": "",
            "pictures": "http://image.waiqin365.com/8958085892090750662/common/delete.png",
            "reconfirm_source_code": "",
            "receive_amount": "0.00",
            "storehouse": 4835274098572455000,
            "actual_amount": "25185.60",
            "cm_linkman_id": "",
            "cm_code": "CUS000190",
            "id": 8209030629704786000,
            "order_amount": "25185.60",
            "tax_amount": "0.00",
            "write_off_amount": "0.00",
            "submit_dept_id": 8444424302574007000,
            "submit_emp_id": 8925976031150112000,
            "dealer_code": "",
            "order_date": "2016-08-19 00:00:00",
            "incentives_amount": "0.00",
            "voucher_discount": "0.00",
            "bill_discount": "0.00",
            "cancel_reason": "",
            "receive_addr": "",
            "receive_tel": "9865433w",
            "reconfirm_time": "",
            "submit_dept_name": "部门一",
            "confirm_source_code": "",
            "print_count": 0,
            "reconfirm_emp_name": "",
            "ext_1704190003": "",
            "emp_source_code": "",
            "exts": [
                {
                    "ext_key": "单行文本框1",
                    "ext_value": "12"
                },
                {
                    "ext_key": "日期自定义",
                    "ext_value": "2016-11-28 20:58"
                },
                {
                    "ext_key": "紧急程度",
                    "ext_value": ""
                },
                {
                    "ext_key": "可靠程度",
                    "ext_value": ""
                },
                {
                    "ext_key": "多选1",
                    "ext_value": ""
                },
                {
                    "ext_key": "图片1",
                    "ext_value": ""
                },
                {
                    "ext_key": "数值2",
                    "ext_value": ""
                },
                {
                    "ext_key": "文本框2",
                    "ext_value": ""
                },
                {
                    "ext_key": "自定义时间",
                    "ext_value": ""
                },
                {
                    "ext_key": "自定义时间2",
                    "ext_value": ""
                }
            ],
            "dept_source_code": "",
            "reconfirm_emp_code": "",
            "reconfirm_emp_id": "",
            "submit_dept_code": "001",
            "submit_time": "2016-08-09 20:02:53",
            "order_type": "1",
            "logistics_type": "1",
            "plan_distribution_emp_id": "7126915044968425080",
            "plan_distribution_emp_name": "cui",
            "plan_distribution_emp_code": "waiqin00789",
            "plan_distribution_car_id": "3547615044968421567",
            "plan_distribution_car_name": "AE86",
            "plan_distribution_car_code": "car00859",
            "plan_distribution_time": "2016-08-19",
            "express_company_id": "",
            "express_company_name": "",
            "express_no": "",
            "pay_status": "3",
            "mendian_use_prepare": "0.00"
    }
]

参数说明:

参数 类型 必填 说明
id INT8 勤策订单ID
create_time VARCHAR(32) 创建时间。格式:yyyy-mm-dd hh24:mi:ss
status VARCHAR(1) 订单状态。0:已删除,1:正常
order_no VARCHAR(100) 订单编号
order_date varchar(10) 业务日期。格式:yyyy-mm-dd hh24:mi:ss
submit_dept_id int8 业务员下单时候所在的部门id
submit_dept_code VARCHAR(100) 业务员下单时候所在的部门编码
submit_dept_name VARCHAR(100) 业务员下单时候所在的部门名称
dept_source_code VARCHAR(100) 部门sourcecode
submit_emp_id INT8 单据上报人(业务员)id
submit_emp_code VARCHAR(100) 单据上报人(业务员)编码
submit_emp_name VARCHAR(100) 单据上报人(业务员)名称
emp_source_code VARCHAR(100) 上报人(业务员)sourcecode
submit_time VARCHAR(32) 提交时间。格式:yyyy-mm-dd hh24:mi:ss
cm_id INT8 客户id
cm_code VARCHAR(100) 客户编码
cm_name VARCHAR(100) 客户名称
cm_source_code VARCHAR(100) 客户sourcecode
cm_linkman_id INT8 门店联系人id
cm_linkman_name VARCHAR(100) 门店联系人名称
order_amount numeric(10,2) 订单金额
actual_amount numeric(10,2) 订单实际金额
discount_amount numeric(10,2) 优惠后金额
incentives_amount numeric(10,2) 优惠掉的金额
bill_discount numeric(10,2) 整单优惠,手动录入的优惠金额
voucher_discount numeric(10,2) 优惠券优惠金额
tax_amount numeric(10,2) 税额
cost_amount numeric(10,2) 成本金额
order_status varchar(32) 0:待确认,1:已确认,2:打回,3:已发货,4:部分发货
close_detail_status varchar(32) 3:全部发货关闭、2:部分发货关闭、1:未发货关闭、非关闭状态,返回空值;
confirm_emp_id INT8 单据确认人id
confirm_emp_code VARCHAR(100) 单据确认人编码
confirm_emp_name VARCHAR(100) 单据确认人名称
confirm_source_code VARCHAR(100) 单据确认人sourcecode
confirm_time VARCHAR(100) 确认时间。格式:yyyy-mm-dd hh24:mi:ss
cancel_reason varchar(4000) 打回原因
order_remark varchar(4000) 备注
consignment_date VARCHAR(100) 要求送货日期(交货日期)。格式:yyyy-mm-dd
visit_implement_id INT8 高级拜访id
pictures varchar4000 订单图片(多个用逗号分割)
dealer INT8 经销商id
dealer_name VARCHAR(100) 经销商名称
dealer_code VARCHAR(100) 经销商编码
dealer_source_code VARCHAR(100) 经销商sourcecode
storehouse INT8 发货仓库
storehouse_code VARCHAR(100) 发货仓库编号
storehouse_name VARCHAR(100) 发货仓库名称
order_type VARCHAR(32) 订单类型。1:订单上报订单,2:门店订单,3:转单订单,4:销货单,5:还货订单
write_off_status VARCHAR(2) 收款款核销状。0:未收款,1:已收款,2:部分收款
write_off_amount numeric(10,2) 核销收款金额
receive_amount numeric(10,2) 收款金额
receive_name varchar(100) 收货人
receive_phone varchar(100) 收货人手机
receive_tel varchar(100) 收货人电话
receive_addr varchar(1000) 收货地址
reconfirm_time VARCHAR(32) 反审核时间。格式:yyyy-mm-dd hh24:mi:ss
del_remark varchar(4000) 删除原因
reconfirm_emp_id INT8 反审核人员id
reconfirm_emp_code VARCHAR(100) 反审核人员编码
reconfirm_emp_name VARCHAR(100) 反审核人员名称
reconfirm_source_code VARCHAR(100) 反审核人员sourcecode
reconfirm_reason varchar(4000) 反审核原因
print_count varchar(2) 打印次数
logistics_type varchar(2) 物流方式。1:配送,2:快递,3:其他
plan_distribution_emp_id INT8 预配送人id
plan_distribution_emp_name VARCHAR(100) 预配送人姓名
plan_distribution_emp_code VARCHAR(100) 预配送人编码
plan_distribution_car_id INT8 预配送车辆id
plan_distribution_car_name VARCHAR(100) 预配送车辆名
plan_distribution_car_code VARCHAR(100) 预配送车辆编码
plan_distribution_time TIMESTAMP 预配送时间,yyyy-mm-dd格式
express_company_id INT8 快递公司id
express_company_name VARCHAR(100) 快递公司名
express_no VARCHAR(100) 快递单号
pay_status VARCHAR(1) 支付状态。0:未支付,1:已支付,3:线下支付
mendian_use_prepare numeric(10,2) 商城使用预收
exts List 订单主信息扩展字段列表
exts.ext_key varchar(4000) 订单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接
prods List 列表
prods.detail_id int8 订单子表id
prods.product_id int8 商品id
prods.product_name varchar(4000) 商品名称
prods.product_code varchar(4000) 商品编码
prods.product_source_code varchar(4000) 商品对应sourcecode
prods.product_pictures varchar(4000) 商品图片(多个用逗号分割)
prods.product_spec varchar(1000) 商品规格属性
prods.price numeric(10,8) 商品订货价格
prods.order_count numeric(10,8) 数量
prods.confirm_count numeric(10,8) 确认订购的数量
prods.input_unit INT8 录入单位id
prods.input_unit_name VARCHAR(100) 录入单位名称
prods.base_unit INT8 商品基本单位id
prods.base_unit_name VARCHAR(100) 商品基本单位名称
prods.base_unit_order_count numeric(10,8) 数量转化成基本单位以后的数量
prods.base_unit_confirm_count numeric(10,8) 确认的数量转化成基本单位以后的数量
prods.order_amount numeric(10,2) 订购金额
prods.confirm_amount numeric(10,2) 确认金额
prods.stay_sent_num numeric(10,2) 待发货数量
prods.discount_amount numeric(10,2) 优惠后金额
prods.incentives_amount numeric(10,2) 优惠掉的金额
prods.bill_discount numeric(10,2) 整单优惠分摊
prods.voucher_discount numeric(10,2) 优惠券优惠金额分摊
prods.tax numeric(10,2) 税率
prods.tax_amount numeric(10,2) 税额
prods.cost_amount numeric(10,2) 成本金额
prods.sequ varchar(2) 下单时的排序
prods.remarks varchar(4000) 备注
prods.is_gift varchar(2) 是否是赠品。1:是,0:否
prods.promotion_code varchar(200) 促销编码
prods.promotion_name varchar(200) 促销名称
prods.promotion_id INT8 促销组id(组合促销)
prods.cost_price numeric(10,2) 商品成本价
prods.gift_price numeric(10,2) 赠品的批发价
prods.gift_amount numeric(10,2) 赠品金额
prods.rebate_account_name VARCHAR(200) 返利账户
prods.voucher_id VARCHAR(32) 优惠券id
prods.voucher_bas_id VARCHAR(32) 优惠券活动id
prods.exts_detail List 订单明细表信息扩展字段列表
prods.exts_detail.ext_key varchar(4000) 订单明细表信息扩展字段key值,扩展字段需先在我方系统中创建
prods.exts_detail.ext_value varchar(4000) 扩展字段value值
prods.full_discount_id VARCHAR(32) 满折满减id
prods.pay_promotion_id VARCHAR(32) 满赠促销id
prods.superposition_promotion_id VARCHAR(32) 叠加促销id
prods.amount_promotion_id VARCHAR(32) 金额促销id
prods.min_price_id VARCHAR(32) 特价促销id
prods.product_type_name VARCHAR(32) 商品行类型
prods.rebate_account_id INT8 返利账户ID
prods.rebate_discount_amount numeric(10,2) 返利优惠金额

# 新增订单数据

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

{
    "cm_id": "8279858127296441724",
   	"emp_id": "6088467620916271947",
    "creator_id": "6088467620916271947",
    "storehouse_id": "10",
    "submit_date": "2020-09-09 14:59:46",
    "consignment_date":"2020-09-12",
    "remarks":"xxxx",
    "logistics_type":"3",
    "prods": [
        {
            "product_id": "1111475397642389622",
            "remark": "子表备注",
            "input_price": "2",
            "input_count": "10",
            "input_unit": "111147539764231111",
            "is_gift": "0"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
order_no VARCHAR(32) 订单编码,不传时自动生成
cm_id VARCHAR(32) 客户id,客户id和客户编码、名称必须传一个
cm_code VARCHAR(100) 客户编码,客户id和客户编码、名称必须传一个
cm_name VARCHAR(100) 客户名称,客户id和客户编码、名称必须传一个
emp_id VARCHAR(32) 业务员Id,业务员id和业务员编码、名称必须传一个
emp_code VARCHAR(32) 业务员编码,业务员id和业务员编码、名称必须传一个
emp_name VARCHAR(32) 业务员名称,业务员id和业务员编码、名称必须传一个
creator_id VARCHAR(32) 提交人Id
creator_code VARCHAR(32) 提交人编码
creator_name VARCHAR(32) 提交人名称
storehouse_id VARCHAR(32) 发货仓库id,发货仓库id和发货仓库编码、名称必须传一个
storehouse_code VARCHAR(32) 发货仓库编码,发货仓库id和发货仓库编码、名称必须传一个
storehouse_name VARCHAR(32) 发货仓库名称,发货仓库id和发货仓库编码、名称必须传一个
submit_date CHAR(10) 下单日期。格式:yyyy-MM-dd HH:mm:ss
consignment_date CHAR(10) 要求送货日期(交货日期)。格式:yyyy-MM-dd
receive_name VARCHAR(32) 收货人姓名
receive_addr VARCHAR(1000) 收货人地址
receive_phone varchar(32) 收货人手机
receive_tel varchar(32) 收货人电话
bill_discount varchar(32) 整单优惠,默认0,没有优惠金额
remarks varchar(4000) 订单备注
logistics_type varchar(2) 物流方式。1:配送,2:快递,3:其他
plan_distribution_emp_id varchar(32) 预配送人id,物流方式为配送时,可传参
plan_distribution_emp_name VARCHAR(100) 预配送人姓名,物流方式为配送时,可传参
plan_distribution_emp_code VARCHAR(100) 预配送人编码,物流方式为配送时,可传参
plan_distribution_time TIMESTAMP 预配送时间。格式:yyyy-mm-dd。物流方式为配送时,可传参
express_company_id varchar(32) 快递公司id,物流方式为快递时,可传参
express_company_name VARCHAR(100) 快递公司名,物流方式为快递时,可传参
express_no VARCHAR(100) 快递单号,物流方式为快递时,可传参
sale_order_type_id varchar(32) 销售单类型ID
sale_order_type_name VARCHAR(100) 销售单类型名
prods List 列表
prods.product_id VARCHAR(100) 商品id。商品id和商品编码、名称必须传一个
prods.product_code VARCHAR(100) 商品编码。商品id和商品编码、名称必须传一个
prods.product_name VARCHAR(100) 商品名称。商品id和商品编码、名称必须传一个
prods.input_price numeric(20,8) 商品的订货价,赠品价格为0
prods.input_count numeric(20,8) 商品数量
prods.input_unit VARCHAR(32) 录入单位id和录入单位名称传一个即可,不传使用基本单位
prods.input_unit_name varchar(100) 录入单位id和录入单位名称传一个即可,不传使用基本单位
prods.is_gift VARCHAR(10) 是否是赠品。1:是,0:否。不传就是非赠品
prods.remark VARCHAR(4000) 订单子表的备注
prods.detail_storehouse_id VARCHAR(32) 发货仓库id,开启多仓有效
prods.detail_storehouse_code VARCHAR(32) 发货仓库编码,开启多仓有效
prods.detail_storehouse_name VARCHAR(32) 发货仓库名称,开启多仓有效

接口说明:是否是赠品is_gift不传默认为非赠品。如果该商品是赠品,input_price传0,is_gift传1。未免出错,这二个字段建议必填

响应示例:

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

参数说明:

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码。0:成功,1:失败
return_msg VARCHAR(100) 响应说明

# 关闭订单

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

{
    "id": "6515888808602338074",
    "close_emp_id": "9085738668330031017"
}  
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
id VARCHAR(100) 订单id。订单id和订单编码必须传一个
order_no VARCHAR(32) 订单编码。订单id和订单编码必须传一个
close_emp_id VARCHAR(100) 关闭人id
close_emp_name VARCHAR(100) 关闭人姓名
close_emp_code VARCHAR(100) 关闭人编码

响应示例:

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

参数说明:

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码。0:成功,1:失败
return_msg VARCHAR(100) 响应说明

# 查询订单发货数据

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

{
    "page_number": 1,
    "id":"7992869671049732483",
	"status":"1",
	"cm_id":"6563654583404943994",
	"cm_code":" DD000201700290",
	"create_date":"2017-08-16",
	"modify_date":"2017-08-16"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
status CHAR(1) 记录状态。0:已删除,1:正常
cm_id VARCHAR(32) 勤策客户唯一ID
cm_code VARCHAR(32) 客户编码,有效字符详见附录:有效字符说明 (opens new window)
create_date VARCHAR(32) 创建日期。格式:yyyy-MM-dd
modify_date VARCHAR(32) 修改日期。格式:yyyy-MM-dd
after_create_date VARCHAR(32) 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date VARCHAR(32) 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
start_create_date VARCHAR(32) 创建时间开始。格式:yyyy-MM-dd
end_create_date VARCHAR(32) 创建时间结束。格式:yyyy-MM-dd
start_modify_date VARCHAR(32) 修改时间开始。格式:yyyy-MM-dd
end_modify_date VARCHAR(32) 修改时间结束。格式:yyyy-MM-dd
id VARCHAR 勤策中id
start_sign_date VARCHAR(32) 签收时间开始。格式:yyyy-MM-dd
end_sign_date VARCHAR(32) 签收时间结束。格式:yyyy-MM-dd

响应示例:

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

数据DATA示例:

[
     {
         	"gift_amount": "0.00",
             "disable_reason": "",
             "prods": [
                 {
                     "gift_amount": "0.00",
                     "cost_amount": "0.00",
                     "base_unit_sent_num": "1.0000",
                     "price": "0.00",
                     "tax": "0.00",
                     "cost_price": "0.00",
                     "tax_amount": "0.00",
                     "sent_num": "1.0000",
                     "incentives_amount": "0.00",
                     "discount_amount": "0.00",
                     "gift_cm_price": "0.00",
                     "gift_cm_amount": "0.00",
                     "prod_ext": [
                         {
                           "ext_key": "商品自定义1",
                           "ext_value": "自定义1"
                         }
                     ]
                 }
             ],
             "send_amount": "0.00",
             "user_code": "smj_lb",
             "order_id": 8956242923759425000,
             "storehouse": 10,
             "order_no": "",
             "id": 8177521589286483000,
             "write_off_status": "1",
             "hc_status": "",
             "send_time": "2016-05-19 17:00:10",
             "storehouse_name": "总仓库",
             "write_off_amount": "0.00",
             "tax_amount": "0.00",
             "storehouse_code": "CK001",
             "user_id": 8925976031150112000,
             "sent_user_id": "",
             "incentives_amount": "0.00",
             "status": "1",
             "print_count": 0,
             "is_enable": "1",
             "bill_check_status": "0",
             "discount_amount": "0.00",
             "hc_id": "",
             "emp_source_code": "",
             "user_name": "宋敏健_lb",
             "cost_amount": "0.00",
             "sent_name": "",
             "sent_no": "FH201605190003",
             "sent_code": "",
             "sent_source_code": "",
             "hc_no": "",
             "express_company_name": "",
             "express_no": ""  ,
             "signe_status":"1"
     }
]

参数说明:

参数 类型 必填 说明
id INT8 发货单ID
status VARCHAR(1) 发货单状态。0:已删除,1:正常
sent_no VARCHAR(100) 发货单号
send_time VARCHAR(10) 发货时间。格式:yyyy-mm-dd hh24:mi:ss
user_id int8 发货人id
user_code VARCHAR(100) 发货人编码
user_name VARCHAR(100) 发货人名称
user_source_code VARCHAR(100) 发货人sourcecode
sent_user_id INT8 送货人id
sent_code VARCHAR(100) 送货人编码
sent_name VARCHAR(100) 送货人名称
sent_source_code VARCHAR(100) 送货人sourcecode
send_amount numeric(10,2) 发货金额
discount_amount numeric(10,2) 优惠后金额
incentives_amount numeric(10,2) 优惠掉的金额
tax_amount numeric(10,2) 税额
cost_amount numeric(10,2) 成本金额
storehouse INT8 发货仓库
storehouse_code VARCHAR(100) 发货仓库编号
storehouse_name VARCHAR(100) 发货仓库名称
order_id INT8 订单id
order_no VARCHAR(100) 订单编号
write_off_status VARCHAR(2) 收款款核销状。0:未收款,1:已收款,2:部分收款
write_off_amount numeric(10,2) 核销收款金额
bill_check_status VARCHAR(2) 账单对账状态。0:待确认,1:已确认
gift_amount numeric(10,2) 赠品金额
print_count VARCHAR(10) 打印次数
hc_status VARCHAR(2) 红冲状态。1:被红冲,2:红冲
hc_id int8 只有hc_status是1的单据,此字段才会填值关联自己的红冲
hc_no VARCHAR(10) 红冲单号
disable_reason VARCHAR(4000) 作废原因
is_enable VARCHAR(2) 作废状态。0:作废,1:未作废
express_company_name VARCHAR(100) 快递公司名称
express_no VARCHAR(100) 快递单号
sign_status CHAR(1) 签收状态 1:已签收 0:未签收
signer_id int8 签收人id
signer_name VARCHAR(100) 签收人名称
signer_source_code VARCHAR(100) 签收人sourcecode
sign_time VARCHAR(100) 签收时间。格式:yyyy-MM-dd HH:mm:ss
prods List 列表
prods.order_detail_id int8 订单子表id
prods.hc_detail_id int8 红冲子表id
prods.product_id int8 商品id
prods.product_name varchar(4000) 商品名称
prods.product_code varchar(4000) 商品编码
prods.product_source_code varchar(4000) 商品sourcecode
prods.product_pictures varchar(4000) 商品图片,多个值用","分割
prods.product_spec varchar(1000) 商品规格属性
prods.cost_price numeric(10,8) 商品成本价
prods.sent_num numeric(10,8) 发货数量
prods.input_unit INT8 发货时候录入单位id
prods.input_unit_name VARCHAR(100) 发货时候录入单位名称
prods.base_unit INT8 商品基本单位id
prods.base_unit_name VARCHAR(100) 商品基本单位名称
prods.base_unit_sent_num numeric(10,8) 发货数量转化成基本单位以后的数量
prods.send_amount numeric(10,2) 发货金额
prods.discount_amount numeric(10,2) 发货优惠后金额
prods.incentives_amount numeric(10,2) 优惠掉的金额
prods.tax numeric(10,2) 税率
prods.tax_amount numeric(10,2) 税额
prods.cost_amount numeric(10,2) 成本金额
prods.sequ varchar(2) 下单时的排序
prods.is_gift varchar(2) 是否是赠品。1:是,0:否
prods.price numeric(10,2) 商品订货价
prods.gift_amount numeric(10,2) 赠品金额
prods.rebate_account_name VARCHAR(200) 返利账户
prods.gift_cm_price numeric(10,2) 赠品的客户价
prods.gift_cm_amount numeric(10,2) 赠品的客户价算出来的金额
prods.prod_ext List 商品信息扩展字段列表
prods.prod_ext.ext_key varchar(4000) 商品信息扩展字段key值扩展字段需先在我方系统中创建
prods.prod_ext.ext_value varchar(4000) 商品信息扩展字段value值对多个选项值,以“,”分隔拼接

# 新增发货单数据

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

[
  {
    "send_time":"yyyy-mm-dd hh24:mi:ss",
    "order_id":"8007172427642688873",
    "order_no": "SD202211070001",
    "emp_id":"",
    "emp_code": "smj_lb",
    "emp_name":"",
    "send_remark":"ssss",
    "express_company_name":"",
    "express_no":"",
    "sent_use_advance":"",
    "storehouse_id":"",
    "storehouse_code":"SMJ0001",
    "storehouse_name":"",
    "products": [
        {
            "product_id": 1,
            "product_name": "商品1",
            "sent_num": "2",
            "product_code": "SMJ123",
            "input_unit_name":"件",
            "order_detail_id": "",
            "is_gift": "0",
            "input_unit": "7911475397642389622"
        },
        {
            "product_id": 1,
            "product_name": "商品2",
            "sent_num": "2",
            "product_code": "SMJ123",
            "input_unit_name":"件",
            "order_detail_id": "",
            "is_gift": "0",
            "input_unit": "7911475397642389622"
        }
            ]
    }
]
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
send_time VARCHAR(32) 发货单发货时间,格式:yyyy-mm-dd/yyyy-mm-dd hh24:mi/yyyy-mm-dd hh24:mi:ss
order_id INT8 销售订单id,销售订单id和销售订单编码必须传一个
order_no VARCHAR(32) 销售订单编码,销售订单id和销售订单编码必须传一个
emp_id INT8 发货单配送人员Id,发货单配送人员Id、发货单配送人员编码和发货单配送人员名称必须传一个
emp_code VARCHAR(32) 发货单配送人员编码,发货单配送人员Id、发货单配送人员编码和发货单配送人员名称必须传一个
emp_name VARCHAR(32) 发货单配送人员名称,发货单配送人员Id、发货单配送人员编码和发货单配送人员名称必须传一个
send_remark VARCHAR(4000) 发货单备注
express_company_name VARCHAR(100) 快递公司名称
express_no VARCHAR(100) 快递单号
sent_use_advance varchar(10) 发货使用预收。0:否,1:是,默认值为0
storehouse_id INT8 发货单发货仓库Id,发货单发货仓库Id、发货单发货仓库编码和发货单发货仓库名称传一个
storehouse_code VARCHAR(32) 发货单发货仓库编码,发货单发货仓库Id、发货单发货仓库编码和发货单发货仓库名称传一个
storehouse_name VARCHAR(32) 发货单发货仓库名称,发货单发货仓库Id、发货单发货仓库编码和发货单发货仓库名称传一个
products List 列表
products.product_id INT8 商品id,商品id、商品编码和商品名称必须传一个
products.product_code VARCHAR(100) 商品编码,商品id、商品编码和商品名称必须传一个
products.product_name VARCHAR(100) 商品名称,商品id、商品编码和商品名称必须传一个
products.input_unit INT8 发货单位id,发货单位id和发货单位名称传一个即可
products.input_unit_name VARCHAR(100) 发货单位名称,发货单位id和发货单位名称传一个即可
products.sent_num numeric(20,8) 发货数量
products.is_gift VARCHAR(10) 是否是赠品。1:赠品,0:非赠品。默认值为0
products.order_detail_id INT8 订单子表ID。传订单子表ID,必传

接口说明:是否是赠品is_gift不传默认为非赠品。如果该商品是赠品,is_gift传1。未免出错,这个字段建议必填

响应示例:

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

参数说明:

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码。0:成功,1:失败
return_msg VARCHAR(100) 响应说明

# 红冲发货单数据

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

{
    "ids": "",
    "sent_no": "FH201901210018"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
ids VARCHAR(32) 发货单id,发货单id和发货单编码必须传一个
sent_no VARCHAR(32) 发货单编码,发货单id和发货单编码必须传一个

响应示例:

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

参数说明:

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码。0:成功,1:失败
return_msg VARCHAR(100) 响应说明

# 新增退货单数据

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

{
    "cm_code": "8007172427642688873",
    "emp_code": "smj_lb",
    "exts": [
        {
            "return_ext_key": "单选框",
            "return_ext_value": "选项1"
        }
    ],
    "return_date": "2017-08-25",
    "prods": [
        {
            "product_id": 1,
            "remark": "子表备注",
            "return_amount": "2",
            "product_code": "SMJ123",
            "return_price": "1",
            "sequ": "0",
            "return_count": "2",
            "input_unit": "7911475397642389622"
        },
        {
            "product_id": 1,
            "remark": "子表备注2",
            "return_amount": "3",
            "product_code": "SMJ123",
            "return_price": "1",
            "sequ": "0",
            "return_count": "3",
            "input_unit": "7911475397642389622"
        }
    ],
    "emp_id": "1",
    "cm_id": "8279858127296441724",
    "storehouse_code": "SMJ0001",
    "storehouse_id": "DD000201700290"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
cm_id INT8 客户id。客户id和客户编码、名称必须传一个
cm_code VARCHAR(100) 客户编码。客户id和客户编码、名称必须传一个
cm_name VARCHAR(100) 客户id和客户编码、名称必须传一个
emp_id INT8 业务员Id,业务员id和业务员编码、名称必须传一个
emp_code VARCHAR(32) 业务员编码。业务员id和业务员编码、名称必须传一个
emp_name VARCHAR(32) 业务员名称。业务员id和业务员编码、名称必须传一个
creator_id INT8 创建人Id
creator_code VARCHAR(32) 创建人编码
creator_name VARCHAR(32) 创建人名称
storehouse_id INT8 收货仓库id。收货仓库id和收货仓库编码、名称必须传一个
storehouse_code VARCHAR(32) 收货仓库编码。收货仓库id和收货仓库编码、名称必须传一个
storehouse_name VARCHAR(32) 收货仓库名称。收货仓库id和收货仓库编码、名称必须传一个
dealer_id INT8 供应商id
dealer_code VARCHAR(32) 供应商编码
dealer_name VARCHAR(32) 供应商名称
return_date CHAR(10) 退货日期。格式:yyyy-MM-dd
return_name VARCHAR(32) 退货人姓名
return_addr VARCHAR(1000) 退货人地址
return_tel varchar(32) 退货人手机
return_phone varchar(32) 退货人电话
remarks varchar(4000) 备注
source_type varchar(32) 来源。0:商贸版内部(默认),1:勤策订货,2:旺店,3:转单订单
exts List 退货信息扩展字段列表
exts.return_ext_key varchar(100) 退货信息扩展字段key值, 退货信息扩展字段需先在我方系统中创建
exts.return_ext_value VARCHAR(4000) 退货信息扩展字段value值对多个选项值,以“,”分隔拼接
prods List 列表
prods.product_id VARCHAR(100) 商品id。商品id和商品编码、名称必须传一个
prods.product_code VARCHAR(100) 商品编码。商品id和商品编码、名称必须传一个
prods.product_name VARCHAR(100) 商品名称。商品id和商品编码、名称必须传一个
prods.return_price numeric(20,8) 商品的退货价,赠品价格为0
prods.return_count numeric(20,8) 商品退货数量
prods.input_unit int8 录入单位id和录入单位名称传一个即可,不传使用基本单位
prods.input_unit_name varchar(100) 录入单位id和录入单位名称传一个即可,不传使用基本单位
prods.return_amount numeric(20,8) 商品退货金额
prods.is_gift VARCHAR(10) 是否是赠品。1:是,0:否。不传就是非赠品
prods.sequ VARCHAR(10) 排序号
prods.remark VARCHAR(4000) 退货单子表的备注
prods.detail_storehouse_id INT8 收货仓库id,开启多仓有效
prods.detail_storehouse_code VARCHAR(32) 收货仓库编码,开启多仓有效
prods.detail_storehouse_name VARCHAR(32) 收货仓库名称,开启多仓有效

接口说明:是否是赠品is_gift不传默认为非赠品。如果该商品是赠品,is_gift传1。未免出错,这个字段建议必填

响应示例:

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

参数说明:

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码。0:成功,1:失败
return_msg VARCHAR(100) 响应说明</span

# 审批退货单数据

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

{
    "id": "8007172427642688873",
    "modifyTimes": "",
    "approvalType": "1",
    "cancelRe": ""
} 
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
id VARCHAR(100) 退货单id,多个逗号分割
approvalType VARCHAR(100) 审批类型。1:通过,2:打回,3:红冲,4:审批入库,5:反审核
modifyTimes VARCHAR(100) 退货时间戳,多个逗号分割
cancelRe VARCHAR(4000) 审批意见

响应示例:

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

参数说明:

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码。0:成功,1:失败
return_msg VARCHAR(100) 响应说明

# 查询退货单数据

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

{
	"id":"7992869671049732483",
	"status":"1",
	"cm_id":"6563654583404943994",
	"cm_code":" DD000201700290",
	"create_date":"2017-08-16",
	"modify_date":"2017-08-16"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
page_number INT8 页码默认1,每页默认1000条
status CHAR(1) 记录状态:0 已删除 1 正常
id VARCHAR(32) 勤策中id
cm_id VARCHAR(32) 勤策客户唯一ID
cm_code VARCHAR(32) 客户编码。有效字符详见附录:有效字符说明 (opens new window)
create_date VARCHAR(32) 创建日期。格式:yyyy-MM-dd
modify_date VARCHAR(32) 修改日期。格式:yyyy-MM-dd
after_create_date VARCHAR(32) 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date VARCHAR(32) 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
start_create_date VARCHAR(32) 创建时间开始。格式:yyyy-MM-dd
end_create_date VARCHAR(32) 创建时间结束。格式:yyyy-MM-dd
start_modify_date VARCHAR(32) 修改时间开始。格式:yyyy-MM-dd
end_modify_date VARCHAR(32) 修改时间结束。格式:yyyy-MM-dd

响应示例:

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

数据DATA示例:

[
        {
            "gift_amount": "16.00",
                       "confirm_emp_code": "scklb",
                       "return_order_type_name": "默认退货类型3",
                       "confirm_emp_name": "孙传宽老板测试账号",
                       "return_amount": "16.00",
                       "prods": [
                           {
                               "gift_amount": "16.00",
                               "product_id": "9099952839222507624",
                               "hc_detail_id": "",
                               "return_amount": "0.00",
                               "base_unit_confirm_count": "1.00",
                               "product_name": "商品4",
                               "remarks": "",
                               "gift_price": "16.00",
                               "base_unit_return_count": "1.00",
                               "return_id": "7992869671049732483",
                               "tax_amount": "0.00",
                               "is_gift": "Y",
                               "detail_id": "7000982478311031481",
                               "cost_price": "0.00",
                               "confirm_amount": "0.00",
                               "order_detail_id": "",
                               "base_unit": "9099952839222507625",
                               "cost_amount": "0.0000",
                               "price": "0.00",
                               "base_unit_name": "件",
                               "confirm_count": "1.00",
                               "tax": "0.60",
                               "product_code": "",
                               "sequ": "1.00",
                               "return_count": "1.0000",
                               "input_unit_name": "件",
                               "input_unit": "9099952839222507625",
                               "detail_status": "1",
                               "prod_ext": [
                                   {
                                     "ext_key": "商品自定义1",
                                     "ext_value": "自定义1"
                                   }
                               ]
                           },
                           {
                               "gift_amount": "0.00",
                               "product_id": "9099952839222507624",
                               "hc_detail_id": "",
                               "return_amount": "16.00",
                               "base_unit_confirm_count": "1.00",
                               "product_name": "商品4",
                               "remarks": "",
                               "gift_price": "0.00",
                               "base_unit_return_count": "1.00",
                               "return_id": "7992869671049732483",
                               "tax_amount": "6.00",
                               "is_gift": "N",
                               "detail_id": "4918143653733183193",
                               "cost_price": "0.00",
                               "confirm_amount": "16.00",
                               "order_detail_id": "",
                               "base_unit": "9099952839222507625",
                               "cost_amount": "0.0000",
                               "price": "16.00",
                               "base_unit_name": "件",
                               "confirm_count": "1.00",
                               "tax": "0.60",
                               "product_code": "",
                               "sequ": "0.00",
                               "return_count": "1.0000",
                               "input_unit_name": "件",
                               "input_unit": "9099952839222507625",
                               "detail_status": "1",
                               "prod_ext": [
                                   {
                                     "ext_key": "商品自定义1",
                                     "ext_value": "自定义1"
                                   }
                               ]
                           }
                       ],
                       "order_no": "",
                       "return_tel": "",
                       "cm_source_code": "",
                       "dealer": "",
                       "write_off_status": "0",
                       "return_addr": "",
                       "return_emp_source_code": "",
                       "storehouse_name": "测试0",
                       "del_remark": "",
                       "storehouse_code": "CK0007",
                       "gift_cost_amount": "0.00",
                       "modifyier_name": "孙传宽老板测试账号",
                       "modify_time": "2017-08-23",
                       "dealer_name": "",
                       "cm_name": "亲戚去去去",
                       "status": "1",
                       "modifyier_id": "6730634712774216679",
                       "return_phone": "",
                       "bill_check_status": "",
                       "creator_id": "5073510449430503303",
                       "hc_id": "0",
                       "cost_amount": "0.00",
                       "confirm_emp_id": "6730634712774216679",
                       "confirm_count": "2.00000000",
                       "return_name": "",
                       "return_no": "TD201708160002",
                       "dealer_source_code": "",
                       "create_time": "2017-08-16",
                       "creator_name": "王老板",
                       "return_emp_id": "5073510449430503303",
                       "modifyier_source_code": "",
                       "creator_code": "wyxlaoban",
                       "return_emp_name": "王老板",
                       "confirm_time": "2017-08-23",
                       "visit_implement_id": "",
                       "confirm_emp_source_code": "",
                       "cm_id": "6563654583404943994",
                       "pictures": "",
                       "creator_source_code": "",
                       "remarks": "",
                       "order_id": "",
                       "storehouse": "7519287026833534497",
                       "cm_code": "DD000201700290",
                       "id": "7992869671049732483",
                       "hc_status": "",
                       "return_order_type": "5926299953521597437",
                       "modifyier_code": "scklb",
                       "tax_amount": "6.00",
                       "write_off_amount": "0.00",
                       "dealer_code": "",
                       "return_status": "2",
                       "cancel_reason": "",
                       "return_emp_code": "wyxlaoban",
                       "confirm_amount": "16.00",
                       "print_count": "",
                       "exts": [
                           {
                               "ext_key": "测试文本框",
                               "ext_value": ""
                           },
                           {
                               "ext_key": "单选框",
                               "ext_value": "选项1"
                           }
                       ],
                       "return_date": "2017-08-16",
                       "return_time": "2017-08-16",
                       "return_count": "2.00000000",
                       "hc_no": ""
        }
    ]

参数说明:

参数 类型 必填 说明
id varchar(32) 退货单ID
status varchar(1) 退货单状态。0:已删除,1:正常
creator_id varchar(32) 创建人
creator_code varchar(32) 创建人编码
creator_name varchar(32) 创建人名称
creator_source_code varchar(32) 创建人sourcecode
create_time VARCHAR(32) 创建时间。格式:yyyy-mm-dd
modifyier_id varchar(32) 修改人
modifyier_code varchar(32) 修改人编码
modifyier_name varchar(32) 修改人名称
modifyier_source_code varchar(200) 修改人sourcecode
modify_time TIMESTAMP 修改时间。格式:yyyy-mm-dd
return_no VARCHAR(32) 退单号
cm_id VARCHAR(32) 客户id
cm_code varchar(32) 客户编码
cm_name varchar(200) 客户名称
cm_source_code varchar(32) 客户sourcecode
return_emp_id varchar(32) 上报人(业务员)
return_emp_code varchar(32) 上报人(业务员)编码
return_emp_name varchar(200) 上报人(业务员)名称
return_emp_source_code varchar(32) 上报人(业务员)sourcecode
return_date varchar(32) 业务日期。格式:yyyy-mm-dd
return_time varchar(32) 退货创建日期。格式:yyyy-mm-dd
remarks varchar(4000) 备注
return_count numeric(20,8) 退货数量
return_amount numeric(20,2) 退货金额
confirm_count numeric(20,8) 确认数量
confirm_amount numeric(20,2) 确认金额
tax_amount numeric(20,2) 税额合计
cost_amount numeric(20,2) 成本金额合计
return_status varchar(10) 状态。0:待确认,1:已入库,2:打回,3:已确认
confirm_emp_id varchar(32) 确认人id
confirm_emp_code varchar(32) 确认人编码
confirm_emp_name varchar(32) 确认人名称
confirm_emp_source_code varchar(32) 确认人sourcecode
confirm_time varchar(32) 确认时间。格式:yyyy-mm-dd
cancel_reason varchar(4000) 打回原因
visit_implement_id varchar(32) 高级拜访id
pictures varchar(4000) 退货单图片
dealer varchar(32) 经销商id
dealer_code varchar(32) 经销商编码
dealer_name varchar(32) 经销商名称
dealer_source_code varchar(32) 经销商sourcecode
storehouse int8 收货仓库
storehouse_code varchar(200) 收货仓库编码
storehouse_name varchar(200) 收货仓库名称
write_off_status varchar(2) 收款款核销状态。0:未收款,1:已收款,2:部分收款
write_off_amount numeric(20,2) 核销收款金额
del_remark varchar(4000) 删除原因
order_id varchar(32) 订单id
order_no varchar(32) 订单编号
bill_check_status varchar(2) 账单对账状态。0、待确认 1、已确认
return_name varchar(32) 退货人姓名
return_addr varchar(4000) 退货人地址
return_tel varchar(32) 退货人手机
return_phone varchar(32) 退货人电话
print_count numeric(20) 打印次数
return_order_type int8 退货单类型id
return_order_type_name varchar(100) 退货单类型名称
gift_amount numeric(20,2) 赠品金额合计
gift_cost_amount numeric(20,2) 赠品成本金额合计
hc_status varchar(2) 红冲状态。1、被红冲,2、红冲
hc_id varchar(32) 关联的红冲单id
hc_no varchar(32) 关联的红冲单单号
source_type varchar(32) 0:商贸版内部(默认),1:勤策订货,2:旺店,3:转单订单
exts List 退货单主信息扩展字段列表
exts.ext_key varchar(4000) 退货单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接
prods List 列表
prods.detail_id VARCHAR(32) 退货单子表ID
prods.detail_status varchar(1) 状态。0:已删除,1:正常
prods.return_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) 商品sourcecode
prods.price numeric(20,8) 商品的退货价
prods.return_count numeric(20,8) 商品退货数量
prods.input_unit varchar(32) 录入单位
prods.input_unit_name varchar(100) 单位名称
prods.base_unit int8 基本单位
prods.base_unit_name varchar(100) 基本单位名称
prods.base_unit_return_count numeric(20,8) 商品退货数量转化成基本单位以后的数量
prods.return_amount numeric(20,2) 商品退货的金额
prods.confirm_count numeric(20,8) 商品退货确认的数量
prods.base_unit_confirm_count numeric(20,8) 商品退货确认的数量转化成基本单位以后的数量
prods.confirm_amount numeric(20,2) 商品订购确认的金额
prods.tax numeric(20,2) 税率
prods.tax_amount numeric(20,2) 税额
prods.remarks VARCHAR(4000) 备注
prods.cost_amount numeric(20,2) 退货成本金额
prods.cost_price numeric(20,8) 商品成本价
prods.gift_price numeric(20,8) 赠品价格
prods.gift_amount numeric(20,2) 赠品金额
prods.sequ varchar(2) 排序号
prods.is_gift varchar(32) 是否是赠品。1:是,0:不是
prods.hc_detail_id varchar(32) 关联的红冲单id
prods.prod_ext List 商品信息扩展字段列表
prods.prod_ext.ext_key varchar(4000) 商品信息扩展字段key值扩展字段需先在我方系统中创建
prods.prod_ext.ext_value varchar(4000) 商品信息扩展字段value值对多个选项值,以“,”分隔拼接

# 查询车销单数据

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

{
    "page_number": 1,
    "id":"7992869671049732483",
	"status":"1",
	"cm_id":"6563654583404943994",
	"cm_code":" DD000201700290",
	"create_date":"2017-08-16",
	"modify_date":"2017-08-16"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
status CHAR(1) 记录状态。0:已删除,1:正常
cm_id VARCHAR(32) 勤策客户唯一ID
cm_code VARCHAR(32) 客户编码,有效字符详见附录:有效字符说明 (opens new window)
create_date VARCHAR(32) 创建日期。格式:yyyy-MM-dd
modify_date VARCHAR(32) 修改日期。格式:yyyy-MM-dd
after_create_date VARCHAR(32) 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date VARCHAR(32) 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
start_create_date VARCHAR(32) 创建时间开始。格式:yyyy-MM-dd
end_create_date VARCHAR(32) 创建时间结束。格式:yyyy-MM-dd
start_modify_date VARCHAR(32) 修改时间开始。格式:yyyy-MM-dd
end_modify_date VARCHAR(32) 修改时间结束。格式:yyyy-MM-dd
id VARCHAR 勤策中id

响应示例:

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

数据DATA示例:

[
    {
       "gift_amount": "0.00",
               "sale_amount": "0.00",
               "remark": "",
               "return_amount": "0.00",
               "write_off_time": "2017-09-14 17:26:43",
               "prods": [
                   {       
                  "type": "4",
                  "sale_type": 10,
                  "sale_type_name": "正常销售",
                  "product_id": 6937089532047239000,
                  "product_name": "商品1",
                  "product_code": "1",
                  "product_source_code": "",
                  "product_pictures": "",
                  "product_spec": "",
                  "num": "2.00",
                  "input_unit": 6937089532047239000,
                  "input_unit_name": "件",
                  "base_unit": 6937089532047239000,
                  "base_unit_name": "件",
                  "base_unit_num": "2.00",
                  "amount": "0.00",
                  "cost_price": "0.00",
                  "price": "0.00",
                  "discount_amount": "0.00",
                  "tax": 0.17,
                  "tax_amount": "0.00",
                  "cost_amount": "0.00",
                  "gift_amount": "0.00",
                  "gift_price": "0.00",
                  "reason": "",
                  "is_gift": "1",
                  "seq": "2",
                  "promotion_code": "",
                  "promotion_name": "",
                  "promotion_id": "",
                  "book_id": 5969850178664757000,
                  "book_no": "DH201709140001"
              }
          ],
          "submit_date": "2017-09-14 00:00:00",
          "create_emp_name": "王老板",
          "car_code": "",
          "cm_source_code": "",
          "write_off_status": "1",
          "back_amount": "10.00",
          "back_cost_amount": "0.00",
          "gift_cost_amount": "0.00",
          "sale_no": "XSD201709140002",
          "back_tax_amount": "1.45",
          "cm_name": "补补啊",
          "sale_tax_amount": "0.00",
          "total_amount": "0.00",
          "sale_cost_amount": "0.00",
          "return_gift_amount": "0.00",
          "status": "1",
          "return_tax_amount": "0.00",
          "car_name": "苏A452Q8",
          "is_enable": "1",
          "bill_check_status": "1",
          "discount_amount": "0.00",
          "hc_id": "",
          "return_gift_cost_amount": "0.00",
          "create_time": "2017-09-14 17:26:43",
          "change_cost_amount": "0.00",
          "visit_implement_id": "",
          "car_id": 7119310922438671000,
          "cm_id": 7673378102189802000,
          "deal_amount": "0.00",
          "create_dept_id": 10,
          "receive_amount": "0.00",
          "create_emp_id": 5073510449430503000,
          "cm_code": "CUS001842",
          "id": 8007172427642689000,
          "change_amount": "0.00",
          "hc_status": "",
          "create_emp_code": "wyxlaoban",
          "write_off_amount": "0.00",
          "create_dept_name": "流程审批测试(勿删)",
          "create_dept_code": "test_flow",
          "print_count": "",
          "return_cost_amount": "0.00",
          "emp_source_code": "",
          "dept_source_code": "aff",
          "debt_amount": "0.00",
          "hc_no": ""
    }
]

参数说明:

参数 类型 必填 说明
id INT8 车销单ID
status VARCHAR(1) 车销单状态。0:已删除,1:正常
is_enable VARCHAR(1) 是否作废。0:已作废,1:未作废
car_id INT8 车辆id
car_code VARCHAR(100) 车辆编号
car_nam VARCHAR(100) 车辆名称
sale_no VARCHAR(100) 车销单编号
submit_date varchar(10) 提交日期。格式:yyyy-mm-dd hh24:mi:ss
create_time varchar(32) 创建日期。格式:yyyy-mm-dd hh24:mi:ss
create_dept_id int8 业务员下单时候所在的部门id
create_dept_code VARCHAR(100) 业务员下单时候所在的部门编码
ceate_dept_name VARCHAR(100) 业务员下单时候所在的部门名称
dept_source_code VARCHAR(100) 部门sourcecode
create_emp_id INT8 业务员id
create_emp_code VARCHAR(100) 业务员编码
create_emp_name VARCHAR(100) 业务员名称
emp_source_code VARCHAR(100) 业务员sourcecode
cm_id INT8 客户id
cm_code VARCHAR(100) 客户编码
cm_name VARCHAR(100) 客户名称
cm_source_code VARCHAR(100) 客户sourcecode
total_amount numeric(10,2) 合计金额
discount_amount numeric(10,2) 优惠掉的金额
deal_amount numeric(10,2) 成交金额
receive_amount numeric(10,2) 收款金额
sale_amount numeric(10,2) 优惠前销售金额合计
sale_tax_amount numeric(10,2) 销售商品税额合计
sale_cost_amount numeric(10,2) 销售商品成本金额合计
return_amount numeric(10,2) 退货金额合计
return_tax_amount numeric(10,2) 退货税额合计
return_cost_amount numeric(10,2) 退货成本金额合计
gift_cost_amount numeric(10,2) 赠品成本金额合计
gift_amount numeric(10,2) 赠品金额合计
change_cost_amount numeric(10,2) 换货成本金额合计
change_amount numeric(10,2) 换货金额合计
debt_amount numeric(10,2) 欠款金额
write_off_status VARCHAR(2) 收款款核销状。0:未收款,1:已收款,2:部分收款
write_off_amount numeric(10,2) 核销收款金额
write_off_time VARCHAR(32) 最后一次核销时间。格式:yyyy-mm-dd hh24:mi:ss
remark varchar(4000) 备注
visit_implement_id INT8 高级拜访id
bill_check_status VARCHAR(2) 账单对账状态。0:待确认,1:已确认(交款交账用)
print_count varchar(2) 打印次数
back_amount numeric(10,2) 还货金额合计
back_tax_amount numeric(10,2) 还货商品税额合计
back_cost_amount numeric(10,2) 还货商品成本金额合计
return_gift_cost_amount numeric(10,2) 退货赠品成本金额
return_gift_amount numeric(10,2) 退货赠品金额
hc_status VARCHAR(2) 红冲状态。1:被红冲,2:红冲
hc_id int8 只有hc_status是1的单据,此字段才会填值关联自己的红冲
hc_no VARCHAR(10) 红冲单号
prods List 列表
prods.type VARCHAR(2) 车销类型。1:销售,2:退货,3:换货(废弃),4:还货,5:换入,6:换出
prods.sale_type int8 销售类型id
prods.sale_type_name VARCHAR(1000) 销售类型名称
prods.product_id int8 商品id
prods.product_name varchar(4000) 商品名称
prods.product_code varchar(4000) 商品编码
prods.product_source_code varchar(4000) 商品对应sourcecode
prods.product_pictures varchar(4000) 商品图片(多个用逗号分割)
prods.product_spec varchar(1000) 商品规格属性
prods.num numeric(10,8) 录入数量
prods.input_unit INT8 录入单位id
prods.input_unit_name VARCHAR(100) 录入单位名称
prods.base_unit INT8 商品基本单位id
prods.base_unit_name VARCHAR(100) 商品基本单位名称
prods.base_unit_num numeric(10,8) 录入数量转化成基本单位以后的数量
prods.amount numeric(10,2) 金额
prods.cost_price numeric(10,8) 成本价
prods.price numeric(10,8) 实际价格
prods.discount_amount numeric(10,2) 优惠掉的金额
prods.tax numeric(10,2) 商品税率
prods.tax_amount numeric(10,2) 商品税额
prods.cost_amount numeric(10,2) 商品成本金额
prods.sys_amount numeric(10,2) 系统金额
prods.sys_price numeric(10,8) 商品对应录入单位的系统价格
prods.remark varchar(4000) 子表行备注
prods.is_gift varchar(2) 是否是赠品。1:是,0:否
prods.seq varchar(2) 下单时的排序
prods.promotion_code varchar(200) 促销编码
prods.promotion_name varchar(200) 促销名称
prods.promotion_id INT8 促销组id
prods.book_id numeric(10,2) 订货会主表id
prods.book_no numeric(10,2) 订货会单号

# 销货单红冲

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


{
   "id":"",
   "order_no" : ""
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 单据ID。单据编码和单据ID不能同时为空
order_no VARCHAR(32) 单据编码

响应示例:

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

参数说明:

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code CHAR(1) 响应编码。0:成功,1:失败
return_msg VARCHAR(100) 响应说明

# 新增销货单数据

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

{
    "cm_id" : "",
    "emp_id" : "",
    "storehouse_id" : "",
    "submit_date" : "",
    "consignment_date" : "",
	"prods":[
		{
			"input_price":"",
			"input_count":"",
			"product_id":"",
            "input_unit": ""
		}
	]
	
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
order_no VARCHAR(32) 订单编码,不传时自动生成
cm_id VARCHAR(32) 客户id,客户id和客户编码、名称必须传一个
cm_code VARCHAR(100) 客户编码,客户id和客户编码、名称必须传一个
cm_name VARCHAR(100) 客户名称,客户id和客户编码、名称必须传一个
emp_id VARCHAR(32) 业务员Id,业务员id和业务员编码、名称必须传一个
emp_code VARCHAR(32) 业务员编码,业务员id和业务员编码、名称必须传一个
emp_name VARCHAR(32) 业务员名称,业务员id和业务员编码、名称必须传一个
creator_id VARCHAR(32) 提交人Id
creator_code VARCHAR(32) 提交人编码
creator_name VARCHAR(32) 提交人名称
storehouse_id VARCHAR(32) 发货仓库id,发货仓库id和发货仓库编码、名称必须传一个
storehouse_code VARCHAR(32) 发货仓库编码,发货仓库id和发货仓库编码、名称必须传一个
storehouse_name VARCHAR(32) 发货仓库名称,发货仓库id和发货仓库编码、名称必须传一个
submit_date CHAR(10) 下单日期。格式:yyyy-MM-dd HH:mm:ss
receive_name VARCHAR(32) 收货人姓名
receive_addr VARCHAR(1000) 收货人地址
receive_phone varchar(32) 收货人手机
receive_tel varchar(32) 收货人电话
bill_discount varchar(32) 整单优惠,默认0,没有优惠金额
receive_amount varchar(32) 收款金额
account_from varchar(32) 收款方式
account_id varchar(32) 结算账户
remarks varchar(4000) 订单备注
prods List 列表
prods.product_id VARCHAR(100) 商品id,商品id和商品编码、名称必须传一个
prods.product_code VARCHAR(100) 商品编码,商品id和商品编码、名称必须传一个
prods.product_name VARCHAR(100) 商品名称,商品id和商品编码、名称必须传一个
prods.input_price numeric(20,8) 商品的订货价,赠品价格为0
prods.input_count numeric(20,8) 商品数量
prods.input_unit VARCHAR(32) 录入单位id和录入单位名称传一个即可,不传使用基本单位
prods.input_unit_name varchar(100) 录入单位id和录入单位名称传一个即可,不传使用基本单位
prods.is_gift VARCHAR(10) 是否是赠品。1:是,0:否,不传就是非赠品
prods.remark VARCHAR(4000) 订单子表的备注

接口说明:是否是赠品is_gift不传默认为非赠品。如果该商品是赠品,price传0,is_gift传1。未免出错,这二个字段建议必填

响应示例:

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

数据DATA示例:

[
        {
           "orderNo":"1234",
           "id":"5555"
        }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 单据ID
order_no VARCHAR(32) 单据编码

# 销售订单自定义字段修改

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


{
    "order_no": "SD202210080001",
    "exts": [
        {
            "ext_key": "ext_2111250076",
            "ext_value": "选项1"
        },
        {
            "ext_key": "ext_2111250077",
            "ext_value": "33333"
        }
    ],
    "products": [
        {
            "id": "8973227330111272878",
            "exts": [
                {
                    "ext_key": "ext_1912300041",
                    "ext_value": "2222"
                },
                {
                    "ext_key": "ext_1912300042",
                    "ext_value": "选项1"
                }
            ]
        }, 
        {
            "id": "5015416164985193878",
            "exts": [
                {
                    "ext_key": "ext_1912300041",
                    "ext_value": "3333"
                },
                {
                    "ext_key": "ext_1912300042",
                    "ext_value": "选项2"
                }
            ]
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
order_id VARCHAR(32) 订单id
order_no VARCHAR(100) 订单单号,订单id与订单号选填一个
exts List 列表
exts.ext_key VARCHAR(100) 订单主数据扩展字段编码
exts.ext_value VARCHAR(100) 订单主数据扩展字段数据值
products List 列表
products.id VARCHAR(100) 订单明细行id
products.exts List 订单明细数据扩展字段列表
products.exts.ext_key VARCHAR(100) 订单明细数据扩展字段编码
products.exts.ext_value VARCHAR(100) 订单明细数据扩展字段数据值

响应示例:

{
    "return_code": "0",
    "return_msg": null,
    "msg_id": "KAIKAI123456",
    "response_data": null
}

参数说明:

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code CHAR(1) 响应编码。0:成功,1:失败
return_msg VARCHAR(100) 响应说明