# 查询订单数据
请求方式: POST(HTTPS)
 请求地址: https://openapi.qince.com/api/stdorder/v1/queryStdomOrder/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
 请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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": "老板",
          "supplier_id": "-1",
          "supplier_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",
            "rebate_accounts":[{
                "rebate_account_code":"ZH0001",
                "rebate_account_name":"中国银行账户",
                "rebate_amount":100.00,
                "rebate_type":"amount"
            }, {
                "rebate_account_code":"ZH0002",
                "rebate_account_name":"南京银行账户",
                "rebate_amount":0.00,
                "rebate_type":"gift"
            }]
    }
]
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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.sys_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.sale_type_name | INT8 | 是 | 销售类型 | 
| prods.rebate_discount_amount | numeric(10,2) | 是 | 返利优惠金额 | 
| prods.expect_pd_date | VARCHAR(32) | 是 | 期望生产日期 yyyy-MM-dd | 
| prods.valid_period | VARCHAR(32) | 是 | 保质期天数 | 
| prods.valid_period_unit | VARCHAR(32) | 是 | 保质期单位 1:天,2:月 | 
| rebate_accounts.rebate_account_code | VARCHAR(100) | 是 | 使用返利账户code | 
| rebate_accounts.rebate_account_name | VARCHAR(100) | 是 | 使用返利账户名称 | 
| rebate_accounts.rebate_amount | numeric(20,2) | 是 | 使用返利账户金额 | 
| rebate_accounts.rebate_type | VARCHAR(30) | 是 | 返利方式(gift:赠品返利,amount:金额返利) | 
# 新增订单数据
请求方式: POST(HTTPS)
 请求地址: https://openapi.qince.com/api/stdorder/v1/addStdomOrder/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
 请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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和业务员编码、名称必须传一个 | 
| supplier_id | VARCHAR(32) | 否 | 非必填,供应商Id,供应商id和名称传一个 | 
| supplier_name | VARCHAR(32) | 否 | 非必填,供应商名称,供应商id和名称传一个 | 
| emp_name | 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) | 否 | 发货仓库名称,开启多仓有效 | 
| rebate_discount_list.rebate_account_code | VARCHAR(100) | 否 | 金额返利使用账户code (编码code和id任填其一) | 
| rebate_discount_list.rebate_account_id | VARCHAR(100) | 否 | 金额返利使用账户id (编码code和id任填其一) | 
| rebate_discount_list.rebate_amount | numeric(20,2) | 否 | 金额返利使用金额 | 
接口说明:是否是赠品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.qince.com/api/stdorder/v1/closeStdomOrder/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
 请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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.qince.com/api/stdsent/v1/queryStdomSent/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
 请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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 | 
| sent_no | VARCHAR | 否 | 勤策中发货单编码 | 
| order_id | VARCHAR | 否 | 勤策中订单id | 
| order_no | VARCHAR | 否 | 勤策中订单编码 | 
| start_sign_date | VARCHAR(32) | 否 | 签收时间开始。格式:yyyy-MM-dd | 
| end_sign_date | VARCHAR(32) | 否 | 签收时间结束。格式:yyyy-MM-dd | 
| cm_trade_type | VARCHAR(32) | 否 | 下游终端类型。多选使用英文逗号分割。1:标准客户,2:经销商,3:终端门店,6:KOL | 
响应示例:
{
    "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 | 
| cm_trade_type | VARCHAR(32) | 否 | 下游终端类型。1:标准客户,2:经销商,3:终端门店,6:KOL | 
| 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.expect_pd_date | VARCHAR(32) | 是 | 期望生产日期 yyyy-MM-dd | 
| prods.valid_period | VARCHAR(32) | 是 | 保质期天数 | 
| prods.valid_period_unit | VARCHAR(32) | 是 | 保质期单位,1:天,2:月 | 
| prods.batch_date_details.batch_no | List | 否 | 商品批次 | 
| prods.batch_date_details.pd_date | varchar(32) | 否 | 生产日期 yyyy-MM-dd | 
| prods.batch_date_details.dead_date | varchar(32) | 否 | 有效期至 yyyy-MM-dd | 
| prods.prod_ext | List | 否 | 商品信息扩展字段列表 | 
| prods.prod_ext.ext_key | varchar(4000) | 否 | 商品信息扩展字段key值扩展字段需先在我方系统中创建 | 
| prods.prod_ext.ext_value | varchar(4000) | 否 | 商品信息扩展字段value值对多个选项值,以“,”分隔拼接 | 
# 新增发货单数据
请求方式: POST(HTTPS)
 请求地址: https://openapi.qince.com/api/stdsent/v1/addStdomOrderSent/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
 请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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,必传 | 
| products.batch_pdDate_serial_list.pd_date | varchar(32) | 否 | 保质期商品必传保质期 | 
| products.batch_pdDate_serial_list.batch_no | varchar(32) | 否 | 批次商品必传批次号 | 
| products.batch_pdDate_serial_list.num | 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) | 是 | 响应说明 | 
# 红冲发货单数据
请求方式: POST(HTTPS)
 请求地址: https://openapi.qince.com/api/stdsent/v1/cancelSendOrder/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
 请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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.qince.com/api/std_order/v1/addStdReturn/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
 请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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) | 否 | 收货仓库名称,开启多仓有效 | 
| prods.batch_no | varchar(32) | 否 | 批次商品必传批次号 | 
| prods.pd_date | 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.qince.com/api/std_order/v1/confirmStdReturn/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
 请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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.qince.com/api/std_order/v1/queryStdReturn/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
 请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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.pd_date | varchar(32) | 否 | 生产日期 yyyy-MM-dd | 
| prods.valid_period | varchar(32) | 否 | 保质期天数 | 
| prods.valid_period_unit | varchar(32) | 否 | 保质期单位,1天,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.qince.com/api/stdcarsle/v2/queryCarSaleOrder/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
 请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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) | 否 | 订货会单号 | 
| prods.pd_date | varchar(32) | 否 | 生产日期 yyyy-MM-dd | 
| prods.valid_period | varchar(32) | 否 | 保质期天数 | 
| prods.valid_period_unit | varchar(32) | 否 | 保质期单位,1:天,2:月 | 
# 销货单红冲
请求方式: POST(HTTPS)
 请求地址: https://openapi.qince.com/api/stdorder/v1/salesBillRevoke/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
 请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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.qince.com/api/stdorder/v1/salesBillAdd/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
 请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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.qince.com/api/stdorder/v1/modifyCustomFields/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
 请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| 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) | 是 | 响应说明 |