# 促销查询接口

# 查询付费陈列和市场活动方案

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

{
    "create_start": "2019-09-17 00:00:00",
    "create_end": "2019-09-17 23:59:59",
    "modify_start": "2019-09-17 00:00:00",
    "modify_end": "2019-09-17 23:59:59",
    "plan_code":"CX00001",
    "status": "1",
    "page_number": "1",
    "page_size": "10"
} 
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_start VARCHAR(32) 创建开始时间。格式:yyyy-MM-dd HH:mm:ss
create_end VARCHAR(32) 创建结束时间。格式:yyyy-MM-dd HH:mm:ss
modify_start VARCHAR(32) 修改开始时间。格式:yyyy-MM-dd HH:mm:ss
modify_end VARCHAR(32) 修改结束时间。格式:yyyy-MM-dd HH:mm:ss
status VARCHAR(1) 记录状态。0:已删除,1:正常。默认值为1
plan_code VARCHAR(100) 方案编码
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认1000

响应示例:

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

数据DATA示例:

[{
    "end_date": "2020-11-13 00:00:00",
    "type_name": "无需兑付方案",
    "code": "CX202011136210",
    "create_time": "2020-11-13 09:45:10",
    "check_form_name": "888",
    "close_case_type": "1",
    "expense_enter_type":"3",
    "off_season_month":"4,5",
    "busy_season_month":"6",
    "modify_time": "2020-11-13 10:03:31",
    "description": "sss",
    "field_name": "1113",
    "has_activity": "1",
    "name": "方案名称001复制方案",
    "id": "5825431067305663225",
    "form_name": "123",
    "exts": [{
        "ext_key": "自定义字段1",
        "ext_value": "复制的方案"
    }, {
        "ext_key": "自定义字段2",
        "ext_value": "多行"
    }],
    "start_date": "2020-11-13 00:00:00",
    "flow_status": "1",
    "evaluate_by_input": "0",
    "plan_status": "1"
}]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 方案id
code VARCHAR(100) 方案编码
name VARCHAR(100) 方案名称
type_name VARCHAR(100) 方案类型
form_name VARCHAR(100) 上报模板名称
field_name VARCHAR(100) 上报审核模板名称
start_date VARCHAR(32) 方案执行开始日期。格式:yyyy-MM-dd HH:mm:ss
end_date VARCHAR(32) 方案执行结束日期。格式:yyyy-MM-dd HH:mm:ss
create_time VARCHAR(32) 方案创建时间。格式:yyyy-MM-dd HH:mm:ss
modify_time VARCHAR(32) 方案修改时间。格式:yyyy-MM-dd HH:mm:ss
has_activity VARCHAR(1) 1:需要申请,2:无需申请
description VARCHAR(4000) 方案说明
check_form_name VARCHAR(100) 检核模板名称
close_case_type VARCHAR(1) 结案方式。1:单次结案,2:月度结案,3:季度结案,4:半年度结案
expense_enter_type VARCHAR(1) 费用录入方式。1:录入执行周期内总费用,2:录入月费用(所有月份相同),3:录入月费用(分淡旺季)
off_season_month VARCHAR(100) 淡季月份。有多个月份时,逗号分隔
busy_season_month VARCHAR(100) 旺季月份。有多个月份时,逗号分隔
exts List 方案扩展字段列表
exts.ext_key VARCHAR(32) 方案扩展字段key值
exts.ext_value TEXT 方案扩展字段value值
flow_status VARCHAR(1) 审批状态。9:待提交,0:处理中,1:已批准,2:已打回,3:审批中
evaluate_by_input VARCHAR(1) 是否按付费项目评价。1:是,0:否
plan_status VARCHAR(1) 方案状态。1:执行中,2:已终止,3:未开始,4:已结束

# 查询品鉴会的活动方案

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

{
    "create_start": "2019-09-17 00:00:00",
    "create_end": "2019-09-17 23:59:59",
    "modify_start": "2019-09-17 00:00:00",
    "modify_end": "2019-09-17 23:59:59",
    "page_number": "1",
    "page_size": "10"
}

说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_start VARCHAR(32) 创建开始时间。格式:yyyy-MM-dd HH:mm:ss
create_end VARCHAR(32) 创建结束时间。格式:yyyy-MM-dd HH:mm:ss
modify_start VARCHAR(32) 修改开始时间。格式:yyyy-MM-dd HH:mm:ss
modify_end VARCHAR(32) 修改结束时间。格式:yyyy-MM-dd HH:mm:ss
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认1000

响应示例:

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

数据DATA示例:

[
    {
        "end_date":"2021-11-12",
        "record_form_name":"上报模板-单行文本",
        "plan_type":"品鉴会类型",
        "code":"CX202110091116",
        "flow_status":"0",
        "name":"tasting-t-1",
        "description":"A",
        "id":"9157715392064344233",
        "exts":[
            {
                "ext_key":"多选必填启用默认BC",
                "ext_value":"B#C"
            },
            {
                "ext_key":"日期必填启用",
                "ext_value":"2021-10-09"
            }
        ],
        "start_date":"2021-10-09",
        "plan_status":"1"
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 方案id
code VARCHAR(100) 方案编码
name VARCHAR(100) 方案名称
description VARCHAR(4000) 方案说明
plan_type VARCHAR(100) 方案类型
record_form_name VARCHAR(100) 上报模板名称
start_date VARCHAR(32) 方案执行开始日期。格式:yyyy-MM-dd HH:mm:ss
end_date VARCHAR(32) 方案执行结束日期。格式:yyyy-MM-dd HH:mm:ss
exts List 方案扩展字段列表
exts.ext_key VARCHAR(32) 方案扩展字段key值
exts.ext_value TEXT 方案扩展字段value值
flow_status VARCHAR(1) 审批状态。9:待提交,0:处理中,1:已批准,2:已打回,3:审批中
plan_status VARCHAR(1) 方案状态。1:执行中,2:已终止,3:未开始,4:已结束

# 查询进场费的活动方案

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

{
    "create_start": "2019-09-17 00:00:00",
    "create_end": "2019-09-17 23:59:59",
    "modify_start": "2019-09-17 00:00:00",
    "modify_end": "2019-09-17 23:59:59",
    "page_number": "1",
    "page_size": "10"
}

说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_start VARCHAR(32) 创建开始时间。格式:yyyy-MM-dd HH:mm:ss
create_end VARCHAR(32) 创建结束时间。格式:yyyy-MM-dd HH:mm:ss
modify_start VARCHAR(32) 修改开始时间。格式:yyyy-MM-dd HH:mm:ss
modify_end VARCHAR(32) 修改结束时间。格式:yyyy-MM-dd HH:mm:ss
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认1000

响应示例:

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

数据DATA示例:

[
    {
        "end_date":"2021-10-31",
        "record_form_name":"上报模板-单行文本",
        "plan_type":"进场费类型",
        "code":"CX202110116895",
        "flow_status":"",
        "name":"进场费",
        "description":"方案说明",
        "id":"5530312191867006443",
        "exts":[
            {
                "ext_key":"数值必填启用",
                "ext_value":"1"
            }
        ],
        "start_date":"2021-10-01",
        "plan_status":"1"
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 方案id
code VARCHAR(100) 方案编码
name VARCHAR(100) 方案名称
description VARCHAR(4000) 方案说明
plan_type VARCHAR(100) 方案类型
record_form_name VARCHAR(100) 上报模板名称
start_date VARCHAR(32) 方案执行开始日期。格式:yyyy-MM-dd HH:mm:ss
end_date VARCHAR(32) 方案执行结束日期。格式:yyyy-MM-dd HH:mm:ss
exts List 方案扩展字段列表
exts.ext_key VARCHAR(32) 方案扩展字段key值
exts.ext_value TEXT 方案扩展字段value值
flow_status VARCHAR(1) 审批状态。9:待提交,0:处理中,1:已批准,2:已打回,3:审批中
plan_status VARCHAR(1) 方案状态。1:执行中,2:已终止,3:未开始,4:已结束

# 查询付费陈列和市场活动的申请单

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

{
    "create_start": "2019-09-17 00:00:00",
    "create_end": "2019-09-17 23:59:59",
    "modify_start": "2019-09-17 00:00:00",
    "modify_end": "2019-09-17 23:59:59",
    "cus_modify_start": "2019-09-17 00:00:00",
    "cus_modify_end": "2019-09-17 23:59:59",
    "activity_status": "1",
    "page_number": "1",
    "page_size": "10"
}

说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_start VARCHAR(32) 活动创建开始时间。格式:yyyy-MM-dd HH:mm:ss
create_end VARCHAR(32) 活动创建结束时间。格式:yyyy-MM-dd HH:mm:ss
modify_start VARCHAR(32) 活动修改开始时间。格式:yyyy-MM-dd HH:mm:ss
modify_end VARCHAR(32) 活动修改结束时间。格式:yyyy-MM-dd HH:mm:ss
activity_status VARCHAR(4000) 活动状态。0:处理中,1:审批通过,2:打回,3:审批中,9:待提交
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认100
cus_modify_start VARCHAR(100) 客户修改开始时间
cus_modify_end VARCHAR(100) 客户修改结束时间
protocol_sign_status VARCHAR 协议签署状态。0:未签署,1:甲乙双方都已签署,2:乙方已拒绝,3:乙方已签署
activity_code VARCHAR 申请单号

响应示例:

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

数据DATA示例:

[
    {
        "activity_code":"SQ202004200011",
        "activity_id":"5953831674579557459",
        "activity_name":"20200417001",
        "activity_status":"0",
        "status":"1",
        "assign_form":"",
        "audit_time":"",
        "cm":[
            {
                "cm_addr":"江苏省南京市秦淮区武定门码头附近",
                "cm_code":"CUS010258",
                "cm_id":"4930703636894469017",
                "cm_name":"650-misu-001",
                "cus_end_date":"2020-04-30 00:00",
                "cus_modify_time":"",
                "cus_start_date":"2020-04-20 00:00",
                "deal_id":"4951177538876691869",
                "file_url":"",
                "linkman":"汤超",
                "linkman_mobile":"13004393985",
                "pro":[
                    {
                        "cash_count_id":"7365888679045586455",
                        "exts": [{
                            "ext_key": "自定义字段1",
                            "ext_value": "1"
                        }, {
                            "ext_key": "自定义字段2",
                            "ext_value": "2"
                        }],
                        "item_desc_array":[
                            {
                                "label_name":"SKU数",
                                "label_val_show":"11"
                            },
                            {
                                "label_name":"排面数",
                                "label_val_show":"22"
                            }
                        ],
                        "item_describe":"SKU数:11;排面数:22",
                        "item_name":"海报",
                        "item_id":"7365888679045586452",
                        "item_type":"1",
                        "item_value":"22.00",
                        "item_value_month":"",
                        "item_value_off":"",
                        "item_value_busy":"",
                        "pd_code":"",
                        "pd_id":"0",
                        "pd_name":"现金",
                        "pd_sales_price":"",
                        "pro_unit_name":"",
                        "protocol_pay_money":"",
                        "spec":"",
                        "sub_data":[

                        ]
                    }
                ],
                "protocol_code":"XY20200420000013",
                "protocol_status":"0",
                "show_content":"",
                "status":"1",
                "target_sale_quota":"",
                "target_sale_quota_month":"",
                "target_sale_quota_off":"",
                "target_sale_quota_busy":"",
                "off_season_shot":"",
                "busy_season_shot":"",
                "close_case_time":"2020-04-30 00:00",
                "close_case_flag":"1",
                "upper_dealer_code":"",
                "upper_dealer_name":""
            }
        ],
        "create_time":"2020-04-20 09:36",
        "creator_id":"6757956879757257691",
        "form_data_id":"",
        "modify_time":"",
        "plan_code":"CX202004175917",
        "plan_end_date":"2020-04-30 00:00",
        "plan_id":"7900082048681138447",
        "plan_name":"20200417001",
        "plan_start_date":"2020-04-17 00:00",
        "plan_type_name":"付费陈列"
    }
]

参数说明:

参数 类型 必填 说明
plan_id VARCHAR(32) 方案id
plan_code VARCHAR(100) 方案编码
plan_name VARCHAR(100) 方案名称
plan_type_name VARCHAR(100) 方案类型名称
plan_start_date VARCHAR(32) 方案执行开始日期。格式:yyyy-MM-dd HH:mm
plan_end_date VARCHAR(32) 方案执行结束日期。格式:yyyy-MM-dd HH:mm
activity_id VARCHAR(32) 申请单ID
activity_code VARCHAR(32) 活动编码,即申请单单号
activity_name VARCHAR(100) 活动名称
assign_form VARCHAR(32) 申请单叠加表单模板ID
form_data_id VARCHAR(32) 申请叠加表单数据ID
create_time VARCHAR(32) 活动创建时间。格式:yyyy-MM-dd HH:mm
creator_id VARCHAR(32) 活动申请人ID
modify_time VARCHAR(32) 活动修改时间。格式:yyyy-MM-dd HH:mm
activity_status VARCHAR(100) 活动状态
status VARCHAR(1) 删除状态。1:正常,0:删除
audit_time VARCHAR(32) 活动审核时间。格式:yyyy-MM-dd HH:mm
cm List 列表
cm.deal_id VARCHAR(32) 活动申请明细ID
cm.cm_id VARCHAR(32) 客户id
cm.status VARCHAR(1) 客户是否移除。1:未删除,0:已删除
cm.cus_start_date VARCHAR(32) 协议开始时间。格式:yyyy-MM-dd HH:mm
cm.cus_end_date VARCHAR(32) 协议结束时间。格式:yyyy-MM-dd HH:mm
cm.protocol_code VARCHAR(100) 协议编号
cm.cus_modify_time VARCHAR(32) 活动明细修改时间。格式:yyyy-MM-dd HH:mm
cm.file_url text 协议签署URL
cm.protocol_status VARCHAR(1) 协议签署状态。0:未签署,1:甲乙双方都已签署,2:乙方已拒绝,3:乙方已签署
cm.target_sale_quota VARCHAR(1000) 销售目标金额
cm.target_sale_quota_month VARCHAR(1000) 月度销售目标金额。方案上选择的申请费用录入方式为“录入月费用(所有月份都相同)”时有值
cm.target_sale_quota_off VARCHAR(1000) 淡季月度销售目标金额。方案上选择的申请费用录入方式为“录入月费用(分淡旺季)”时有值
cm.target_sale_quota_busy VARCHAR(100) 旺季月度销售目标金额。方案上选择的申请费用录入方式为“录入月费用(分淡旺季)”时有值
cm.off_season_shot VARCHAR(1000) 淡季月份。方案上选择的申请费用录入方式为“录入月费用(分淡旺季)”时有值
cm.busy_season_shot VARCHAR(1000) 旺季月份。方案上选择的申请费用录入方式为“录入月费用(分淡旺季)”时有值
cm.cm_addr VARCHAR(4000) 客户地址
cm.upper_dealer_code VARCHAR(32) 经销商编码
cm.upper_dealer_name VARCHAR(200) 经销商名称
cm.linkman_mobile VARCHAR(32) 客户主联系人手机号
cm.linkman VARCHAR(100) 客户主联系人姓名
cm.cm_name VARCHAR(200) 客户名称
cm.code VARCHAR(32) 客户编码
cm.close_case_time VARCHAR(32) 活动明细结案时间。格式:yyyy-MM-dd HH:mm。仅单次结案使用,分期结案时为空
cm.close_case_flag VARCHAR(1) 是否已结案。0:未结案,1:已结案,2:结案中。活动明细结案状态,仅单次结案使用,分期结案时为空
cm.show_content VARCHAR(100) 甲方配置中的公司名称
cm.pro List 列表
cm.pro.item_name VARCHAR(100) 付费项目名称
cm.pro.item_describe VARCHAR(1000) 付费项目要求
cm.pro.item_id VARCHAR(32) 付费项ID
cm.pro.exts.ext_key VARCHAR(32) 付费项扩展字段key值
cm.pro.exts.ext_value TEXT 付费项扩展字段value值
cm.pro.item_type VARCHAR(1) 兑付方式。1:现金,2:商品
cm.pro.pd_id VARCHAR(32) 兑付商品ID
cm.pro.pd_code VARCHAR(100) 商品编码
cm.pro.pd_name VARCHAR(100) 商品名称
cm.pro.spec VARCHAR(4000) 规格属性
cm.pro.pro_unit_name VARCHAR(32) 协议兑付商品单位
cm.pro.item_value VARCHAR(1000) 协议兑付金额/数量
cm.pro.item_value_month VARCHAR(1000) 月协议兑付金额/数量。方案上选择的申请费用录入方式为“录入月费用(所有月份都相同)”时有值
cm.pro.item_value_off VARCHAR(1000) 淡季月协议兑付金额/数量。方案上选择的申请费用录入方式为“录入月费用(分淡旺季)”时有值
cm.pro.item_value_busy VARCHAR(1000) 旺季月协议兑付金额/数量。方案上选择的申请费用录入方式为“录入月费用(分淡旺季)”时有值
cm.pro.pd_sales_price VARCHAR(32) 商品牌价
cm.pro.protocol_pay_money NUMERIC 协议兑付金额
cm.pro.sub_data List 列表
cm.pro.sub_data.close_case_time VARCHAR(32) 实际结案时间。格式:yyyy-MM-dd HH:mm
cm.pro.sub_data.actual_unit_name VARCHAR(100) 实际结案商品单位
cm.pro.sub_data.actual_pd_price VARCHAR(32) 实际结案商品成本价
cm.pro.sub_data.actual_item_value VARCHAR(1000) 实际结案数量。在兑付商品时有值
cm.pro.sub_data.actual_close_money VARCHAR(1000) 实际结案金额
cm.pro.item_desc_array List 列表
cm.pro.item_desc_array.label_name TEXT 执行要求字段名称
cm.pro.item_desc_array.label_val_show TEXT 执行要求字段值

# 查询固定类费用申请明细

接口说明:查询有效的申请单记录。审批状态不填,默认仅查“已通过”的申请记录

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

{
    "page_number": "1",
    "page_size": "10",
    "audit_date_begin":"2020-10-10 00:00:00",
    "audit_date_end":"2021-01-31 00:00:00"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_date_begin VARCHAR(32) 开始时间。格式:yyyy-MM-dd HH:mm:ss。限制创建时间
create_date_end VARCHAR(32) 结束时间。格式:yyyy-MM-dd HH:mm:ss。限制创建时间
modify_date_begin VARCHAR(32) 开始时间。格式:yyyy-MM-dd HH:mm:ss。限制最近修改时间
modify_date_end VARCHAR(32) 结束时间。格式:yyyy-MM-dd HH:mm:ss。限制最近修改时间
audit_date_begin VARCHAR(32) 限制审批时间的开始时间。格式:yyyy-MM-dd HH:mm:ss
audit_date_end VARCHAR(32) 限制审批时间的结束时间。格式:yyyy-MM-dd HH:mm:ss
flow_status VARCHAR(1) 0:待审批,1:已审批,2:已打回,3:审批中
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认100
activity_code VARCHAR(32) 申请单号
sub_id VARCHAR(32) 申请明细ID

响应示例:

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

数据DATA示例:

[
    {
        "applierName":"张三",
        "applyCode":"SQ202010190009",
        "applyDesc":"详细说明",
        "applyEndDate":"2020-10-19",
        "applyName":"申请单001",
        "applyStartDate":"2020-10-19",
        "applyTime":"2020-10-19 15:20:39",
        "deptCode":"110",
        "deptName":"自定义组",
        "formDefinedId":"54606289555563161323",
        "formDataId":"54606289555563161322",
        "applyFormName":"申请单模板名称",
        "subList":[
            {
                "applyAmount":"20000000.00",
                "cusCode":"",
                "cusName":"沃尔玛",
                "dealerCode":"",
                "dealerName":"",
                "dimJson":"[{'dim_1912200004_name':'权限全公司','dim_1912200004':'6702228490352177010'}]",
                "extColumns":[
                    {
                        "extKey":"自定义字段1",
                        "extValue":""
                    },
                    {
                        "extKey":"自定义字段2",
                        "extValue":""
                    },
                    {
                        "extKey":"自定义字段3",
                        "extValue":""
                    }
                ],
                "payType":"随货搭赠",
                "pdCode":"1001000258",
                "pdName":"52°水晶剑南春(专卖店)20版[500×1×6]",
                "period":"2020-04",
                "remark":"23",
                "subEndDate":"2020-10-19",
                "subId":"5225578183716220103",
                "subStartDate":"2020-10-19",
                "subType":"2",
                "subject":"【是】共用1"
            },
            {
                "applyAmount":"10000000.00",
                "cusCode":"CUS000032",
                "cusName":"客户删除",
                "dealerCode":"CUS010251",
                "dealerName":"111111",
                "dimJson":"[{'dim_1912200004_name':'权限全公司','dim_1912200004':'6702228490352177010'}]",
                "extColumns":[
                    {
                        "extKey":"自定义字段1",
                        "extValue":""
                    },
                    {
                        "extKey":"自定义字段2",
                        "extValue":""
                    },
                    {
                        "extKey":"自定义字段3",
                        "extValue":""
                    }
                ],
                "payType":"成本领用",
                "pdCode":"1009000101",
                "pdName":"商品",
                "period":"2020-03",
                "remark":"23",
                "subEndDate":"2020-10-19",
                "subId":"5460628955556316132",
                "subStartDate":"2020-10-19",
                "subType":"1",
                "subject":"共用1"
            }
        ]
    }
]

参数说明:

参数 类型 必填 说明
applyCode VARCHAR(32) 申请单编号
applyName VARCHAR(100) 方案编码
applyDesc text 详细说明
applyStartDate VARCHAR(32) 申请单执行开始日期。格式:yyyy-MM-dd
applyEndDate VARCHAR(32) 申请单执行结束日期。格式:yyyy-MM-dd
deptCode VARCHAR(32) 部门编码
deptName VARCHAR(100) 部门名称
applierName VARCHAR(100) 申请人名称
applyTime VARCHAR(100) 活动申请时间。格式:yyyy-MM-dd HH:mm:ss
formDefinedId VARCHAR(32) 申请单叠加表单模板ID
formDataId VARCHAR(32) 申请叠加表单数据ID
applyFormName VARCHAR(100) 申请单模板名称
subList List 列表
subList.subId VARCHAR(32) 申请明细ID
subList.cusCode VARCHAR(32) 客户编码
subList.cusName VARCHAR(100) 客户或者连锁品牌名称
subList.subType VARCHAR(1) 申请明细类型。1:客户,2:连锁品牌
subList.dealerCode VARCHAR(32) 费用代垫经销商编码
subList.dealerName VARCHAR(100) 费用代垫经销商名称
subList.applyAmount VARCHAR(32) 申请金额
subList.pdCode VARCHAR(32) 商品编码
subList.pdName VARCHAR(100) 商品名称
subList.subStartDate VARCHAR(32) 活动明细开始时间。格式:yyyy-MM-dd
subList.subEndDate VARCHAR(32) 活动明细结束时间。格式:yyyy-MM-dd
subList.subject VARCHAR(100) 科目
subList.period VARCHAR(32) 期间
subList.dimJson text 维度json
subList.payType VARCHAR(100) 支付方式
subList.remark text 备注
subList.extColumns List 申请明细扩展字段列表
subList.extColumns.extKey VARCHAR(32) 申请明细扩展字段key值
subList.extColumns.extValue TEXT 申请明细扩展字段value值

# 查询进货折让申请明细

接口说明:查询有效的申请单记录。审批状态不填,默认仅查“已通过”的申请记录

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

{
    "page_number": "1",
    "page_size": "10",
    "audit_date_begin":"2020-10-10 00:00:00",
    "audit_date_end":"2021-01-31 00:00:00"
}

说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_date_begin VARCHAR(32) 开始时间。格式:yyyy-MM-dd HH:mm:ss。限制创建时间
create_date_end VARCHAR(32) 结束时间。格式:yyyy-MM-dd HH:mm:ss。限制创建时间
modify_date_begin VARCHAR(32) 开始时间。格式:yyyy-MM-dd HH:mm:ss。限制最近修改时间
modify_date_end VARCHAR(32) 结束时间。格式:yyyy-MM-dd HH:mm:ss。限制最近修改时间
audit_date_begin VARCHAR(32) 限制申请审批时间的开始时间。格式:yyyy-MM-dd HH:mm:ss
audit_date_end VARCHAR(32) 限制申请审批时间的结束时间。格式:yyyy-MM-dd HH:mm:ss
flow_status VARCHAR(1) 0:待审批,1:已审批,2:已打回,3:审批中
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认100
activity_code VARCHAR(32) 申请单号

响应示例:

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

数据DATA示例:

[
    {
        "applierName":"李四",
        "applyCode":"SQ202010160012",
        "applyDesc":"详细说明",
        "applyEndDate":"2020-10-13",
        "applyName":"活动申请单",
        "applyStartDate":"2020-10-12",
        "applyTime":"2020-10-16 13:46:42",
        "modifyTime":"2020-10-16 13:46:42",
        "flowStatus":"1",
        "auditTime":"2020-10-16 13:46:42",
        "deptCode":"QQ1 QQ1",
        "deptName":"QQ1(A组)",
        "id":4815896514453860157,
        "subList":[
            {
                "applyAmount":"2.00",
                "cusCode":"CUS000037",
                "cusName":"倪威测试20190920",
                "dealerCode":"CUS010306",
                "dealerName":"新增看国家码",
                "dimJson":"[{'dim_dept_name':'自由打卡部','dim_dept':'8376087797504218803'},{'dim_2010100006_name':'202010101109wd_啊','dim_2010100006':'8194598985488267252'}]",
                "discountPrice":"18.91",
                "expectedSalesNum":"2",
                "extColumns":[
                    {
                        "extKey":"自定义字段1",
                        "extValue":""
                    },
                    {
                        "extKey":"自定义字段2",
                        "extValue":""
                    },
                    {
                        "extKey":"自定义字段3",
                        "extValue":""
                    }
                ],
                "floorPrice":"",
                "payType":"现金",
                "pdCode":"1010000117",
                "pdName":"银剑南==10016296(济宁广安商贸有限公司)",
                "pdSalesPrice":"19.91",
                "period":"2020-10",
                "remark":"",
                "subEndDate":"2020-10-13",
                "subId":"5664500886558056079",
                "subStartDate":"2020-10-12",
                "subject":"202010101105科目",
                "unitDiscount":"1.00"
            }
        ]
    }
]

参数说明:

参数 类型 必填 说明
applyCode VARCHAR(32) 申请单编号
applyName VARCHAR(100) 申请名称
applyDesc text 详细说明
applyStartDate VARCHAR(32) 申请单执行开始日期。格式:yyyy-MM-dd
applyEndDate VARCHAR(32) 申请单执行结束日期。格式:yyyy-MM-dd
deptCode VARCHAR(32) 部门编码
deptName VARCHAR(100) 部门名称
applierName VARCHAR(100) 申请人名称
applyTime VARCHAR(100) 创建时间。格式:yyyy-MM-dd HH:mm:ss
modifyTime VARCHAR(100) 最近修改时间。格式:yyyy-MM-dd HH:mm:ss
flowStatus VARCHAR(1) 0-待审批 1-已审批 2-已打回 3-审批中
auditTime VARCHAR(100) 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
formDefinedId VARCHAR(32) 申请单叠加表单模板ID
formDataId VARCHAR(32) 申请叠加表单数据ID
subList List 列表
subList.subId VARCHAR(32) 申请明细ID
subList.cusCode VARCHAR(32) 客户编码
subList.cusName VARCHAR(100) 客户或者连锁品牌名称
subList.dealerCode VARCHAR(32) 费用代垫经销商编码
subList.dealerName VARCHAR(100) 费用代垫经销商名称
subList.applyAmount VARCHAR(32) 申请金额
subList.pdCode VARCHAR(32) 商品编码
subList.pdName VARCHAR(100) 商品名称
subList.subStartDate VARCHAR(32) 活动明细开始时间。格式:yyyy-MM-dd
subList.subEndDate VARCHAR(32) 活动明细结束时间。格式:yyyy-MM-dd
subList.pdSalesPrice VARCHAR(32) 商品售价
subList.floorPrice VARCHAR(32) 商品最低限价
subList.unitDiscount VARCHAR(32) 单位折让
subList.discountPrice VARCHAR(32) 折后价
subList.expectedSalesNum VARCHAR(32) 预计销售数量
subList.subject VARCHAR(100) 科目
subList.period VARCHAR(32) 期间
subList.dimJson text 维度json
subList.payType VARCHAR(100) 支付方式
subList.remark text 备注
subList.extColumns List 申请明细扩展字段列表
subList.extColumns.extKey VARCHAR(32) 申请明细扩展字段key值
subList.extColumns.extValue TEXT 申请明细扩展字段value值

# 查询进场费申请明细

接口说明:查询已提交未删除的进场费申请记录

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

{
	"create_date_begin":"2020-10-10 00:00:00",
    "create_date_end":"2022-01-31 00:00:00",
	"modify_date_begin":"2020-10-10 00:00:00",
    "modify_date_end":"2022-01-31 00:00:00",
	"audit_date_begin":"",
    "audit_date_end":"",
	"audit_status": "",
	"apply_code": "SQ202111040012",
    "page_number": "1",
    "page_size": "10"
}

说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_date_begin VARCHAR(32) 限制申请单创建的开始时间。格式:yyyy-MM-dd HH:mm:ss
create_date_end VARCHAR(32) 限制申请单创建的结束时间。格式:yyyy-MM-dd HH:mm:ss
modify_date_begin VARCHAR(32) 限制申请单修改时间的开始时间。格式:yyyy-MM-dd HH:mm:ss
modify_date_end VARCHAR(32) 限制申请单修改时间的结束时间。格式:yyyy-MM-dd HH:mm:ss
audit_date_begin VARCHAR(32) 限制申请审批时间的开始时间。格式:yyyy-MM-dd HH:mm:ss
audit_date_end VARCHAR(32) 限制申请审批时间的结束时间。格式:yyyy-MM-dd HH:mm:ss
audit_status VARCHAR(32) 审批状态 0处理中、1已批准、2已打回、3审批中 、4作废、9待提交
apply_code VARCHAR(32) 申请单号
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认100

响应示例:

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

数据DATA示例:

[
	{
		"applyCode":"SQ202111040012",
		"applyId":6004353746709837221,
		"assignForm":7806275268583491837,
		"auditStatus":"1",
		"auditTime":"2021-11-04 19:38:50",
		"createTime":"2021-11-04 19:37:08",
		"creatorId":"7011544141518850838",
		"efCmDetailDto":[
			{
				"applyExt":[
					{
						"ext_col":"ext_2110270041",
						"ext_key":"text",
						"ext_value":"text"
					},
					{
						"ext_col":"ext_2110270042",
						"ext_key":"num",
						"ext_value":"120"
					},
					{
						"ext_col":"ext_2110270043",
						"ext_key":"textarea",
						"ext_value":"textarea"
					},
					{
						"ext_col":"ext_2110270044",
						"ext_key":"dt",
						"ext_value":"2021-11-04"
					},
					{
						"ext_col":"ext_2110270045",
						"ext_key":"checkbox",
						"ext_value":"选项2checkbox#选项3checkbox"
					},
					{
						"ext_col":"ext_2110270046",
						"ext_key":"select",
						"ext_value":"选项1select"
					},
					{
						"ext_col":"ext_2110270047",
						"ext_key":"必填校验",
						"ext_value":"ngjwkeg"
					}
				],
				"budgetDimInfo":"[]",
				"cmAcId":"6302352245437721460",
				"cmCode":"CUS000014",
				"cmId":"5215745781710813559",
				"cmName":"王阳客户",
				"cmSourceCode":"",
				"dealerCode":"10019200",
				"dealerName":"qqnew经销商--河南省副食品有限公司焦作分公司",
				"dealerSourceCode":"",
				"efWaresDto":[
					{
						"pdCode":"test1",
						"pdEntranceFee":34,
						"pdId":7320333869023283637,
						"pdName":"测试商品1",
						"pdPurchase":43,
						"pdRemark":"",
						"pdSale":43,
						"pdSourceCode":""
					},
					{
						"pdCode":"1009000362",
						"pdEntranceFee":43,
						"pdId":5239771055067925102,
						"pdName":"52°银剑南(A9)18版[480×1×6]-银剑南测试商品",
						"pdPurchase":34,
						"pdRemark":"",
						"pdSale":43,
						"pdSourceCode":""
					}
				],
				"entranceStoreNum":"4",
				"executeEndDate":"2021-11-04 00:00:00",
				"executeStartDate":"2021-11-04 00:00:00",
				"payMode":"10004",
				"payModeName":"开票请款",
				"period":"",
				"remark":"4he",
				"singleStoreEntranceFee":"77.26",
				"status":"1",
				"storeTotalEntranceFee":"309.04",
				"subjectId":"",
				"subjectName":"",
				"upperDealerId":"5981981052594876297"
			}
		],	
		"formDataId":5697466446687567936,
		"modifyTime":"2021-11-04 19:38:50",
		"planCode":"JCF202111019606",
		"planId":8093604252026303903,
		"planName":"20211101"
	}
]

参数说明:

参数 类型 必填 说明
planId VARCHAR(32) 方案id
planCode VARCHAR(100) 方案编码
planName VARCHAR(100) 方案名称
applyId VARCHAR(32) 申请单ID
applyCode VARCHAR(32) 申请单编号
creatorId VARCHAR(32) 申请人ID
createTime VARCHAR(32) 申请创建时间。格式:yyyy-MM-dd HH:mm:ss
modifyTime VARCHAR(32) 修改时间。格式:yyyy-MM-dd HH:mm:ss
auditStatus VARCHAR(100) 审批状态 0处理中、1已批准、2已打回、3审批中 、4作废、9待提交
auditTime VARCHAR(32) 最近审核时间。格式:yyyy-MM-dd HH:mm:ss
assignForm VARCHAR(32) 申请单叠加表单模板ID
formDataId VARCHAR(32) 申请叠加表单数据ID
creator_id VARCHAR(32) 活动申请人ID
efCmDetailDto List 列表
efCmDetailDto.cmAcId VARCHAR(32) 客户申请明细ID
efCmDetailDto.cmId VARCHAR(32) 客户id
efCmDetailDto.cmSourceCode VARCHAR(100) 客户SOURCE_CODE
efCmDetailDto.cmCode VARCHAR(100) 客户编码
efCmDetailDto.cmName VARCHAR(100) 客户名称
efCmDetailDto.upperDealerId VARCHAR(32) 费用代垫经销商ID
efCmDetailDto.dealerSourceCode VARCHAR(100) 费用代垫经销商SOURCE_CODE
efCmDetailDto.dealerCode VARCHAR(100) 费用代垫经销商编码
efCmDetailDto.dealerName VARCHAR(100) 费用代垫经销商名称
efCmDetailDto.executeStartDate VARCHAR(100) 客户行活动开始时间 格式:yyyy-MM-dd HH:mm:ss
efCmDetailDto.executeEndDate VARCHAR(100) 客户行活动结束时间 格式:yyyy-MM-dd HH:mm:ss
efCmDetailDto.entranceStoreNum VARCHAR(100) 进场门店数
efCmDetailDto.singleStoreEntranceFee VARCHAR(100) 单店进场费
efCmDetailDto.storeTotalEntranceFee VARCHAR(100) 申请总金额
efCmDetailDto.subjectId VARCHAR(100) 科目
efCmDetailDto.period VARCHAR(100) 期间
efCmDetailDto.budgetDimInfo VARCHAR(4000) 维度json
efCmDetailDto.payMode VARCHAR(100) 支付方式
efCmDetailDto.remark VARCHAR(4000) 备注
efCmDetailDto.applyExt List 列表
efCmDetailDto.applyExt.ext_key VARCHAR(100) 自定义字段名称
efCmDetailDto.applyExt.ext_col VARCHAR(100) 自定义字段key
efCmDetailDto.applyExt.ext_value VARCHAR(4000) 自定义字段值
efCmDetailDto.status VARCHAR(32) 删除状态 0-删除,1-未删除
efCmDetailDto.efWaresDto List 列表
efCmDetailDto.efWaresDto.pdId VARCHAR(100) 商品ID
efCmDetailDto.efWaresDto.pdSourceCode VARCHAR(100) 商品SOURCE_CODE
efCmDetailDto.efWaresDto.pdCode VARCHAR(100) 商品编码
efCmDetailDto.efWaresDto.pdName VARCHAR(100) 商品名称
efCmDetailDto.efWaresDto.pdEntranceFee VARCHAR(100) 进场费
efCmDetailDto.efWaresDto.pdPurchase VARCHAR(100) 客户进货价
efCmDetailDto.efWaresDto.pdSale VARCHAR(100) 零售价
efCmDetailDto.efWaresDto.pdRemark VARCHAR(4000) 商品行备注

# 查询万能促销活动申请明细

接口说明:查询已提交未删除的万能促销活动申请记录

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

{
	"create_date_begin":"2020-10-10 00:00:00",
    "create_date_end":"2022-01-31 00:00:00",
	"modify_date_begin":"2020-10-10 00:00:00",
    "modify_date_end":"2022-01-31 00:00:00",
	"audit_date_begin":"",
    "audit_date_end":"",
	"activity_status": "",
	"activity_code": "SQ202111040012",
    "page_number": "1",
    "page_size": "10"
}

说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_date_begin VARCHAR(32) 限制申请单创建的开始时间。格式:yyyy-MM-dd HH:mm:ss
create_date_end VARCHAR(32) 限制申请单创建的结束时间。格式:yyyy-MM-dd HH:mm:ss
modify_date_begin VARCHAR(32) 限制申请单修改时间的开始时间。格式:yyyy-MM-dd HH:mm:ss
modify_date_end VARCHAR(32) 限制申请单修改时间的结束时间。格式:yyyy-MM-dd HH:mm:ss
audit_date_begin VARCHAR(32) 限制申请审批时间的开始时间。格式:yyyy-MM-dd HH:mm:ss
audit_date_end VARCHAR(32) 限制申请审批时间的结束时间。格式:yyyy-MM-dd HH:mm:ss
activity_status VARCHAR(32) 审批状态 0处理中、1已批准、2已打回、3审批中 、4作废、9待提交
activity_code VARCHAR(32) 申请单号
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认100

响应示例:

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

数据DATA示例:

[
    {
		"planId":5460676379219624403,
		"planCode":"CX202202087036",
		"planName":"万能促销活动-智能审批",
		"applyCode":"SQ202202110010",
		"applicant":"韩煜",
		"applyTime":"2022-02-11 15:36:06",
    "applyName":"",
    "parentApplyCode":"",
		"formDefinedId":null,
		"formDataId":null,
		"subList":[
            {
                "subId": 7135551781356453533,
                "cusId": 6503181307801475589,
                "cusCode": null,
                "cusSourceCode": null,
                "cusName": null,
                "dealerId": null,
                "dealerCode": null,
                "dealerSourceCode": null,
                "dealerName": null,
              	"settlementOrgName": "",
                "startDate": "2022-02-08",
                "endDate": "2022-03-09",
              	"pdRangeType": "",
              	"pdTypesName": "",
              	"pdBrandsName": "",
                "pdIds": "",
                "pdUnitName": null,
                "pdSale": null,
                "pdSalesVolume": null,
                "pdSalesAmount": null,
                "giftId": null,
                "giftUnitName": null,
                "giftPrice": null,
                "giftNum": null,
                "applyAmount": "2.00",
                "subject": null,
                "period": "2022-01",
                "dimJson": "[ { \"dim_terminal\": \"7119853134660696947\", \"dim_terminal_name\": \"寒冰射手-艾希\" }, { \"dim_dept\": \"6716553271806748909\", \"dim_dept_name\": \"德玛西亚\" } ]",
				"payType":"现金",
                "remark": "",
                "extColumns": [
                    {
                        "ext_key": "DT",
                    	"ext_col": "ext_2202230054",
                    	"ext_value": "2022-02-23"
                    },
                    {
                        "ext_key": "文本框12",
                    	"ext_col": "ext_2201060009",
                    	"ext_value": "Text"
                    }
                ]
            }
        ]
    }
]

参数说明:

参数 类型 必填 说明
planId VARCHAR(32) 方案id
planCode VARCHAR(100) 方案编码
planName VARCHAR(100) 方案名称
applyCode VARCHAR(32) 申请单编号
applicant VARCHAR(32) 申请人
applicantCode VARCHAR(32) 申请人账号
applyTime VARCHAR(32) 申请创建时间。格式:yyyy-MM-dd HH:mm:ss
applyName VARCHAR(100) 申请名称
parentApplyCode VARCHAR(32) 父申请单号
modifyTime VARCHAR(32) 最近修改时间。格式:yyyy-MM-dd HH:mm:ss
auditTime VARCHAR(32) 最新审批时间。格式:yyyy-MM-dd HH:mm:ss
formDefinedId VARCHAR(32) 申请叠加表单模板ID
formDataId VARCHAR(32) 申请叠加表单数据ID
activityStatus VARCHAR(32) 审批状态 0处理中、1已批准、2已打回、3审批中 、4作废、9待提交
subList List 列表
subList.subId VARCHAR(32) 客户申请明细ID
subList.cusId VARCHAR(32) 客户id
subList.cusSourceCode VARCHAR(100) 客户SOURCE_CODE
subList.cusCode VARCHAR(100) 客户编码
subList.cusName VARCHAR(100) 客户名称
subList.dealerId VARCHAR(32) 费用代垫经销商ID
subList.dealerSourceCode VARCHAR(100) 费用代垫经销商SOURCE_CODE
subList.dealerCode VARHCAR(100) 费用代垫经销商编码
subList.dealerName VARCHAR(100) 费用代垫经销商
subList.settlementOrgName VARCHAR(100) 结算单位
subList.startDate VARHCAR(32) 客户行活动开始时间。格式:yyyy-MM-dd
subList.endDate VARCHAR(32) 客户行活动结束时间。格式:yyyy-MM-dd
pdRangeType VARCHAR(32) 活动商品范围
pdTypesName VARCHAR(4000) 活动商品类型(多个用英文下逗号分隔)
pdBrandsName VARCHAR(4000) 活动品牌(多个用英文下逗号分隔)
subList.pdIds VARCHAR(1000) 活动商品ID(支持多个,用英文下逗号分隔)
subList.pdUnitId VARCHAR(32) 商品单位ID
subList.pdUnitName VARCHAR(100) 商品单位
subList.pdSale VARCHAR(32) 商品售价
subList.pdSalesVolume VARCHAR(32) 预计销量
subList.pdSalesAmount VARCHAR(32) 预计销售额
subList.giftId VARCHAR(32) 赠品ID
subList.giftName VARCHAR(32) 赠品名称
subList.giftCode VARCHAR(32) 赠品编码
subList.giftUnitId VARCHAR(32) 赠品单位ID
subList.giftUnitName VARCHAR(100) 赠品单位
subList.giftPrice VARCHAR(32) 赠品价格
subList.giftNum VARCHAR(32) 赠品数量
subList.applyAmount VARCHAR(32) 申请金额
subList.subject VARCHAR(100) 科目
subList.period VARCHAR(32) 期间
subList.dimJson VARCHAR(1000) 维度json
subList.payType VARCHAR(100) 支付方式
subList.remark VARCHAR(4000) 备注
subList.extColumns List 列表
subList.extColumns.ext_key VARCHAR(100) 自定义字段名称
subList.extColumns.ext_col VARCHAR(100) 自定义字段key
subList.extColumns.ext_value VARCHAR(4000) 自定义字段值
subList.status VARCHAR(32) 删除状态 0-删除 1-未删除

# 查询万能促销活动方案

接口说明:查询万能促销活动方案

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

{
    "create_start": "2019-01-10 00:00:00",
    "create_end": "2022-02-28 00:00:00",
    "modify_start": "2017-01-10 00:00:00",
    "modify_end": "2022-02-28 00:00:00",
    "flow_status": "0",
    "plan_code": "",
    "page_number": "1",
    "page_size": "1"
}

说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_start VARCHAR(32) 创建开始时间。格式:yyyy-MM-dd HH:mm:ss
create_end VARCHAR(32) 创建结束时间。格式:yyyy-MM-dd HH:mm:ss
modify_start VARCHAR(32) 修改开始时间。格式:yyyy-MM-dd HH:mm:ss
modify_end VARCHAR(32) 修改结束时间。格式:yyyy-MM-dd HH:mm:ss
flow_status VARCHAR(32) 方案审批状态 0-待审批,1-已审批,2-已打回,3-审批中,不可与project_status参数同时使用
project_status VARCHAR(32) 项目审批状态 0-待审批,1-已审批,2-已打回,3-审批中,不可与flow_status参数同时使用
plan_code VARCHAR(32) 方案编码
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认100

响应示例:

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

数据DATA示例:

[
    {
        "plan_type":5890360826000093762,
        "code":"CX202202252489",
        "form_id":8960641880654960061,
        "description":"qww",
        "plan_amount":2,
        "plan_name":"qw",
        "flow_status":"0",
        "execute_cycle":"2022-02-25 00:00:00~2022-03-31 00:00:00",
        "pay_type":1,
        "project_name":"常规项目0509",
        "project_code":"XM2022058823",
        "exts":[
            {
                "ext_col":"ext_2202080057",
                "ext_key":"custom_DT",
                "ext_value":"2022-02-25"
            },
            {
                "ext_col":"ext_2202080056",
                "ext_key":"custom_textarea",
                "ext_value":"custom_textarea"
            },
            {
                "ext_col":"ext_2202080055",
                "ext_key":"custom_num",
                "ext_value":"159"
            },
            {
                "ext_col":"ext_2202080054",
                "ext_key":"custom_text",
                "ext_value":"custom_text"
            },
            {
                "ext_col":"ext_2202080058",
                "ext_key":"custom_Checkbox",
                "ext_value":"选项1QAZ#选项3EDC"
            },
            {
                "ext_col":"ext_2202080059",
                "ext_key":"custom_Select",
                "ext_value":"选项C"
            }
        ],
        "plan_status":"1"
    }
]

参数说明:

参数 类型 必填 说明
code VARCHAR(100) 方案编码
plan_name VARCHAR(100) 方案名称
plan_type VARCHAR(100) 方案类型
description VARCHAR(4000) 方案说明
execute_cycle VARCHAR(100) 执行周期
form_id VARCHAR(100) 上报模板id
pay_type VARCHAR(100) 支付方式
exts List 列表
exts.ext_key VARCHAR(4000) 自定义字段名称
exts.ext_col VARCHAR(4000) 自定义字段key
exts.ext_value VARCHAR(4000) 自定义字段值
flow_status VARCHAR(32) 方案审批状态。0:待审批,"":已审批,1:已审批,2:已打回,3:审批中
project_status VARCHAR(32) 项目审批状态。0:待审批,"":已审批,1:已审批,2:已打回,3:审批中
plan_amount VARCHAR(32) 方案总金额
project_code VARCHAR(100) 项目编码
project_name VARCHAR(100) 项目名称
plan_status VARCHAR(1) 方案状态。1:执行中,2:已终止,3:未开始,4:已结束

# 查询活动上报记录

接口说明:查询付费陈列和市场活动的活动上报记录

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

{
    "create_start": "2019-09-17 00:00:00",
    "create_end": "2019-09-17 23:59:59",
    "comment_time_start": "2019-09-17 00:00:00",
    "comment_time_end": "2019-09-17 23:59:59",
    "page_number": "1",
    "page_size": "10"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_start VARCHAR(32) 上报时间开始。格式:yyyy-MM-dd HH:mm:ss
create_end VARCHAR(32) 上报时间结束。格式:yyyy-MM-dd HH:mm:ss
comment_time_start VARCHAR(32) 初评时间开始。格式:yyyy-MM-dd HH:mm:ss
comment_time_end VARCHAR(32) 初评时间结束。格式:yyyy-MM-dd HH:mm:ss
re_comment_time_start VARCHAR(32) 复评时间开始。格式:yyyy-MM-dd HH:mm:ss
re_comment_time_end VARCHAR(32) 复评时间结束。格式:yyyy-MM-dd HH:mm:ss
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认1000
activity_code VARCHAR(32) 申请单号
cm_code VARCHAR(32) 客户编码

响应示例:

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

数据DATA示例:

[
    {
        "end_date":"2020-07-31 00:00:00",
        "activity_name":"6.5.6-不限-兑付标准-分期",
        "comment_time":"2020-06-17 13:19:30",
        "type_name":"QQNEW-兑付",
        "code":"CX20200615992",
        "re_comment_status":"",
        "data":"",
        "form_define_id":"5924180213346641304",
        "modify_time":"2020-06-16 16:47:38",
        "record_sys_id":"",
        "re_record_name":"",
        "sye_name":"QQ查看所有",
        "sye_id":"5397154835002159969",
        "cm_code":"11020200",
        "record_sys_name":"",
        "data_id":"8621802954837092385",
        "activity_id":"4795171571139197701",
        "re_comment_text":"",
        "id":"8611380517337046173",
        "start_date":"2020-05-01 00:00:00",
        "comment_text":"",
        "audit_form_data1":"8371127298902346306",
        "audit_form_data2":"5294916129732764766",
        "activity_code":"SQ202006160005",
        "visit_implement_id":"6116470603291862719",
        "re_record_source_code":"",
        "comment_status":"",
        "record_id":"7729258835380395996",
        "record_source_code":"",
        "re_record_id":"",
        "pay_evaluate_data": [{
            "comment_text": "陈列不整齐",
            "item_name": "端架陈列",
            "comment_status": "1"
        }],
        "re_pay_evaluate_data": [{
            "comment_text": "陈列仍然不整齐",
            "item_name": "端架陈列",
            "comment_status": "1"
        }],
        "record_audit_form_id":"7781581630982170154",
        "cm_id":"5429065203332481852",
        "cm_name":"策略--指定-110201",
        "name":"6.5.6-不限-兑付标准-分期",
        "re_comment_time":"2020-06-18 13:19:33",
        "source_code":"qazsc0506",
        "record_time":"2020-06-16 16:42:03",
		"report_source_code": "2"
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 方案id
code VARCHAR(100) 方案编码
name VARCHAR(100) 方案名称
type_name VARCHAR(100) 方案类型
start_date VARCHAR(32) 方案执行开始日期。格式:yyyy-MM-dd HH:mm:ss
end_date VARCHAR(32) 方案执行结束日期。格式:yyyy-MM-dd HH:mm:ss
activity_id VARCHAR(32) 活动ID
activity_code VARCHAR(32) 活动申请编码
activity_name VARCHAR(100) 活动申请名称
cm_id VARCHAR(32) 客户ID
cm_name VARCHAR(200) 客户名称
cm_code VARCHAR(32) 客户编码
record_id VARCHAR(32) 上报记录ID
report_source_code CHAR(1) 上报来源。1:客户自主上报,2:业代上报
sye_id VARCHAR(32) 上报人ID(勤策(原外勤365)的ID)
source_code VARCHAR(32) 上报人唯一标识(source_code)
sye_name VARCHAR(100) 上报人姓名
arrive_lla VARCHAR(200) 上报地标信息。纠偏后的定位数据转换得到的地标信息
arrive_pos_offset NUMERIC(20,2) 和客户的偏差距离(米)。纠偏后的位置和客户纠偏后的位置的差值,当客户位置为空时,偏差距离为空
pay_evaluate_data List 付费评价初评数据列表
pay_evaluate_data.comment_text VARCHAR(1000) 不合格理由
pay_evaluate_data.item_name VARCHAR(100) 付费项目
pay_evaluate_data.comment_status VARCHAR(1) 合格状态。1:不合格,0:合格
re_pay_evaluate_data List 付费评价复评数据
re_pay_evaluate_data.comment_text VARCHAR(1000) 不合格理由
re_pay_evaluate_data.item_name VARCHAR(100) 付费项目
re_pay_evaluate_data.comment_status VARCHAR(1) 合格状态。1:不合格,0:合格
record_audit_form_id VARCHAR(32) 上报评价表单模板ID
comment_status VARCHAR(32) 评价状态:未评价/合格/不合格
audit_form_data1 VARCHAR(32) 评价表单数据ID
record_sys_id VARCHAR(32) 评价人ID(勤策(原外勤365)的ID)
record_source_code VARCHAR(32) 评价人唯一标识(source_code)
record_sys_name VARCHAR(100) 评价人姓名
comment_text VARCHAR(1000) 初评不合格理由
re_comment_status VARCHAR(32) 复评状态:未评价/合格/不合格
re_comment_text VARCHAR(1000) 复评不合格理由
audit_form_data2 VARCHAR(32) 复评表单数据ID
re_record_id VARCHAR(32) 复评人ID(勤策(原外勤365)的ID)
re_record_source_code VARCHAR(32) 复评人唯一标识(source_code)
re_record_name VARCHAR(100) 复评人姓名
re_comment_time VARCHAR(32) 复评时间。格式:yyyy-MM-dd HH:mm:ss
visit_implement_id VARCHAR(32) 拜访记录ID
form_define_id VARCHAR(32) 上报表单模板ID
data_id VARCHAR(32) 上报表单数据ID
record_time VARCHAR(32) 上报时间。格式:yyyy-MM-dd HH:mm:ss
comment_time VARCHAR(32) 初评时间。格式:yyyy-MM-dd HH:mm:ss
status VARCHAR(1) 删除状态。0:删除,1:正常

# 查询品鉴会上报记录

接口说明:查询品鉴会上报记录

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

{
    "create_start": "2019-09-17 00:00:00",
    "create_end": "2019-09-17 23:59:59",
    "modify_time_start": "2019-09-17 00:00:00",
    "modify_time_end": "2019-09-17 23:59:59",
    "comment_time_start": "2019-09-17 00:00:00",
    "comment_time_end": "2019-09-17 23:59:59",
    "re_comment_time_start": "2019-09-17 00:00:00",
    "re_comment_time_end": "2019-09-17 23:59:59",
    "page_number": "1",
    "page_size": "10"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_start VARCHAR(32) 上报时间开始。格式:yyyy-MM-dd HH:mm:ss
create_end VARCHAR(32) 上报时间结束。格式:yyyy-MM-dd HH:mm:ss
modify_time_start VARCHAR(32) 最新修改时间开始。格式:yyyy-MM-dd HH:mm:ss。品鉴会上报记录支持修改和删除,当修改和删除时更新最新修改时间和修改人
modify_time_end VARCHAR(32) 最新修改时间开始结束。格式:yyyy-MM-dd HH:mm:ss
comment_time_start VARCHAR(32) 初评时间开始。格式:yyyy-MM-dd HH:mm:ss
comment_time_end VARCHAR(32) 初评时间结束。格式:yyyy-MM-dd HH:mm:ss
re_comment_time_start VARCHAR(32) 复评时间开始。格式:yyyy-MM-dd HH:mm:ss
re_comment_time_end VARCHAR(32) 复评时间结束。格式:yyyy-MM-dd HH:mm:ss
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认1000

响应示例:

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

数据DATA示例:

[
    {
        "end_date":"2020-07-31 00:00:00",
        "activity_name":"6.5.6-不限-兑付标准-分期",
        "comment_time":"2020-06-17 13:19:30",
        "type_name":"QQNEW-兑付",
        "code":"CX20200615992",
        "re_comment_status":"",
        "data":"",
        "form_define_id":"5924180213346641304",
        "modify_time":"2020-06-16 16:47:38",
        "record_sys_id":"",
        "re_record_name":"",
        "sye_name":"QQ查看所有",
        "sye_id":"5397154835002159969",
        "cm_code":"11020200",
        "record_sys_name":"",
        "data_id":"8621802954837092385",
        "activity_id":"4795171571139197701",
        "re_comment_text":"",
        "id":"8611380517337046173",
        "start_date":"2020-05-01 00:00:00",
        "comment_text":"",
        "audit_form_data1":"8371127298902346306",
        "audit_form_data2":"5294916129732764766",
        "activity_code":"SQ202006160005",
        "visit_implement_id":"6116470603291862719",
        "re_record_source_code":"",
        "comment_status":"",
        "record_id":"7729258835380395996",
        "record_source_code":"",
        "re_record_id":"",
        "pay_evaluate_data": [{
            "comment_text": "陈列不整齐",
            "item_name": "端架陈列",
            "comment_status": "1"
        }],
        "re_pay_evaluate_data": [{
            "comment_text": "陈列仍然不整齐",
            "item_name": "端架陈列",
            "comment_status": "1"
        }],
        "record_audit_form_id":"7781581630982170154",
        "cm_id":"5429065203332481852",
        "cm_name":"策略--指定-110201",
        "name":"6.5.6-不限-兑付标准-分期",
        "re_comment_time":"2020-06-18 13:19:33",
        "source_code":"qazsc0506",
        "record_time":"2020-06-16 16:42:03",
		"report_source_code": "2"
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 方案id
code VARCHAR(100) 方案编码
name VARCHAR(100) 方案名称
type_name VARCHAR(100) 方案类型
start_date VARCHAR(32) 方案执行开始日期。格式:yyyy-MM-dd HH:mm:ss
end_date VARCHAR(32) 方案执行结束日期。格式:yyyy-MM-dd HH:mm:ss
activity_id VARCHAR(32) 活动ID
activity_code VARCHAR(32) 活动申请编码
activity_name VARCHAR(100) 活动申请名称
cm_id VARCHAR(32) 客户ID
cm_name VARCHAR(200) 客户名称
cm_code VARCHAR(32) 客户编码
record_id VARCHAR(32) 上报记录ID
report_source_code CHAR(1) 上报来源。1:客户自主上报,2:业代上报
sye_id VARCHAR(32) 上报人ID(勤策(原外勤365)的ID)
source_code VARCHAR(32) 上报人唯一标识(source_code)
sye_name VARCHAR(100) 上报人姓名
arrive_lla VARCHAR(200) 上报地标信息。纠偏后的定位数据转换得到的地标信息
arrive_pos_offset NUMERIC(20,2) 和客户的偏差距离(米)。纠偏后的位置和客户纠偏后的位置的差值,当客户位置为空时,偏差距离为空
pay_evaluate_data List 付费评价初评数据列表
pay_evaluate_data.comment_text VARCHAR(1000) 不合格理由
pay_evaluate_data.item_name VARCHAR(100) 付费项目
pay_evaluate_data.comment_status VARCHAR(1) 合格状态。1:不合格,0:合格
re_pay_evaluate_data List 付费评价复评数据
re_pay_evaluate_data.comment_text VARCHAR(1000) 不合格理由
re_pay_evaluate_data.item_name VARCHAR(100) 付费项目
re_pay_evaluate_data.comment_status VARCHAR(1) 合格状态。1:不合格,0:合格
record_audit_form_id VARCHAR(32) 上报评价表单模板ID
comment_status VARCHAR(32) 评价状态:未评价/合格/不合格
audit_form_data1 VARCHAR(32) 评价表单数据ID
record_sys_id VARCHAR(32) 评价人ID(勤策(原外勤365)的ID)
record_source_code VARCHAR(32) 评价人唯一标识(source_code)
record_sys_name VARCHAR(100) 评价人姓名
comment_text VARCHAR(100) 初评不合格理由
re_comment_status VARCHAR(32) 复评状态:未评价/合格/不合格
re_comment_text VARCHAR(100) 复评不合格理由
audit_form_data2 VARCHAR(32) 复评表单数据ID
re_record_id VARCHAR(32) 复评人ID(勤策(原外勤365)的ID)
re_record_source_code VARCHAR(32) 复评人唯一标识(source_code)
re_record_name VARCHAR(100) 复评人姓名
re_comment_time VARCHAR(32) 复评时间。格式:yyyy-MM-dd HH:mm:ss
visit_implement_id VARCHAR(32) 拜访记录ID
form_define_id VARCHAR(32) 上报表单模板ID
data_id VARCHAR(32) 上报表单数据ID
record_time VARCHAR(32) 上报时间。格式:yyyy-MM-dd HH:mm:ss
comment_time VARCHAR(32) 初评时间。格式:yyyy-MM-dd HH:mm:ss

# 查询进场费上报记录

接口说明:查询进场费场景的活动上报记录,入口参数都不传时,返回所有的上报记录

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

{
    "create_start": "2019-09-17 00:00:00",
    "create_end": "2019-09-17 23:59:59",
    "comment_time_start": "2019-09-17 00:00:00",
    "comment_time_end": "2019-09-17 23:59:59",
    "re_comment_time_start": "2019-09-17 00:00:00",
    "re_comment_time_end": "2019-09-17 23:59:59",
    "page_number": "1",
    "page_size": "10",
    "activity_cus_id": "4789759081208984580"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_start VARCHAR(32) 上报时间开始。格式:yyyy-MM-dd HH:mm:ss
create_end VARCHAR(32) 上报时间结束。格式:yyyy-MM-dd HH:mm:ss
comment_time_start VARCHAR(32) 初评时间开始。格式:yyyy-MM-dd HH:mm:ss
comment_time_end VARCHAR(32) 初评时间结束。格式:yyyy-MM-dd HH:mm:ss
re_comment_time_start VARCHAR(32) 复评时间开始。格式:yyyy-MM-dd HH:mm:ss
re_comment_time_end VARCHAR(32) 复评时间结束。格式:yyyy-MM-dd HH:mm:ss
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认1000
activity_cus_id VARCHAR(32) 活动申请明细ID

响应示例:

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

数据DATA示例:

[
    {
      "id": 6309024315330045514,
      "code": "JCF202111113454",
      "activity_cus_id": 4789759081208984580,
      "cm_id": 7345266233482427241,
      "cm_name": "小店87",
      "cm_code": "CUS000087",
      "cm_source_code": "",
      "pd_list": [{
        "pd_code": "1000001",
        "pd_name": "雪花啤酒勇闯天涯8度",
        "pd_entrance_fee": 11.00,
        "retail_price": 11.00
      }],
      "record_id": 6858701150506850097,
      "sye_id": 7573427476093814157,
      "source_code": "",
      "sye_name": "xwj14",
      "arrive_lla": "江苏省南京市建邺区荷塘路",
      "arrive_pos_offset": "",
      "comment_status": "未评价",
      "record_sys_id": "",
      "record_source_code": "",
      "record_sys_name": "",
      "comment_time": "",
      "comment_text": "",
      "re_comment_status": "未评价",
      "re_comment_text": "",
      "re_record_id": "",
      "re_record_source_code": "",
      "re_record_name": "",
      "re_comment_time": "",
      "visit_implement_id": "",
      "form_define_id": 5351617790943416943,
      "data_id": 5510726260281485832,
      "record_time": "2021-11-17 16:24:02",
      "status": "正常"
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 方案id
code VARCHAR(100) 方案编码
activity_cus_id VARCHAR(32) 活动申请明细ID
cm_id VARCHAR(32) 客户ID
cm_name VARCHAR(200) 客户名称
cm_code VARCHAR(32) 客户编码
cm_source_code VARCHAR(32) 客户source_code
pd_list List 实际进场商品
pd_list.pd_code VARCHAR(1000) 进场商品编码
pd_list.pd_name VARCHAR(100) 进场商品名称
pd_list.pd_entrance_fee VARCHAR(100) 协议进场价格(申请时的价格)
pd_list.retail_price VARCHAR(100) 实际进场价格(上报时采集的价格)
record_id VARCHAR(32) 上报记录ID
sye_id VARCHAR(32) 上报人ID(勤策(原外勤365)的ID)
source_code VARCHAR(32) 上报人唯一标识(source_code)
sye_name VARCHAR(100) 上报人姓名
arrive_lla VARCHAR(200) 上报地标信息。纠偏后的定位数据转换得到的地标信息
arrive_pos_offset NUMERIC(20,2) 和客户的偏差距离(米)。纠偏后的位置和客户纠偏后的位置的差值,当客户位置为空时,偏差距离为空
comment_status VARCHAR(32) 评价状态("":未评价,1:合格,0:不合格)
record_sys_id VARCHAR(32) 评价人ID(勤策(原外勤365)的ID)
record_source_code VARCHAR(32) 评价人唯一标识(source_code)
record_sys_name VARCHAR(100) 评价人姓名
comment_time VARCHAR(32) 评价时间。格式:yyyy-MM-dd HH:mm:ss
comment_text VARCHAR(100) 评价意见
re_comment_status VARCHAR(32) 复评状态("":未评价,1:合格,0:不合格)
re_comment_text VARCHAR(100) 复评意见
re_record_id VARCHAR(32) 复评人ID(勤策(原外勤365)的ID)
re_record_source_code VARCHAR(32) 复评人唯一标识(source_code)
re_record_name VARCHAR(100) 复评人姓名
re_comment_time VARCHAR(32) 复评时间。格式:yyyy-MM-dd HH:mm:ss
visit_implement_id VARCHAR(32) 拜访记录ID
form_define_id VARCHAR(32) 上报表单模板ID
data_id VARCHAR(32) 上报表单数据ID
record_time VARCHAR(32) 上报时间。格式:yyyy-MM-dd HH:mm:ss
status VARCHAR(32) 删除状态。0:删除,1:正常

# 查询万能促销活动上报记录

接口说明:查询万能促销活动场景的活动上报记录,入口参数都不传时,返回所有的上报记录

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

{
    "create_start": "2019-09-17 00:00:00",
    "create_end": "2019-09-17 23:59:59",
    "comment_time_start": "2019-09-17 00:00:00",
    "comment_time_end": "2019-09-17 23:59:59",
    "re_comment_time_start": "2019-09-17 00:00:00",
    "re_comment_time_end": "2019-09-17 23:59:59",
    "page_number": "1",
    "page_size": "10",
    "activity_cus_id": "4789759081208984580"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_start VARCHAR(32) 上报时间开始。格式:yyyy-MM-dd HH:mm:ss
create_end VARCHAR(32) 上报时间结束。格式:yyyy-MM-dd HH:mm:ss
comment_time_start VARCHAR(32) 初评时间开始。格式:yyyy-MM-dd HH:mm:ss
comment_time_end VARCHAR(32) 初评时间结束。格式:yyyy-MM-dd HH:mm:ss
re_comment_time_start VARCHAR(32) 复评时间开始。格式:yyyy-MM-dd HH:mm:ss
re_comment_time_end VARCHAR(32) 复评时间结束。格式:yyyy-MM-dd HH:mm:ss
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认1000
activity_cus_id VARCHAR(32) 活动申请明细ID

响应示例:

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

数据DATA示例:

[
    {
      "id": "6309024315330045514",
      "code": "JCF202111113454",
      "plan_name":"方案名称",
      "activity_code":"SQ202205101221",
      "activity_cus_id": "4789759081208984580",
      "cm_id": "7345266233482427241",
      "cm_name": "小店87",
      "cm_code": "CUS000087",
      "cm_source_code": "",
      "record_id": "6858701150506850097",
      "sye_id": "7573427476093814157",
      "source_code": "",
      "sye_name": "xwj14",
      "arrive_lla": "江苏省南京市建邺区荷塘路",
      "arrive_pos_offset": "",
      "comment_status": "未评价",
      "record_sys_id": "",
      "record_source_code": "",
      "record_sys_name": "",
      "comment_time": "",
      "comment_text": "",
      "re_comment_status": "未评价",
      "re_comment_text": "",
      "re_record_sys_id": "",
      "re_record_source_code": "",
      "re_record_sys_name": "",
      "re_comment_time": "",
      "visit_implement_id": "",
      "form_define_id": "5351617790943416943",
      "data_id": "5510726260281485832",
      "record_time": "2021-11-17 16:24:02",
      "status": "1"
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 方案id
code VARCHAR(100) 方案编码
plan_name VARCHAR(100) 方案名称
activity_code VARCHAR(32) 申请单号
activity_cus_id VARCHAR(32) 活动申请明细ID
cm_id VARCHAR(32) 客户ID
cm_name VARCHAR(200) 客户名称
cm_code VARCHAR(32) 客户编码
cm_source_code VARCHAR(32) 客户source_code
record_id VARCHAR(32) 上报记录ID
sye_id VARCHAR(32) 上报人ID(勤策(原外勤365)的ID)
source_code VARCHAR(32) 上报人唯一标识(source_code)
sye_name VARCHAR(100) 上报人姓名
arrive_lla VARCHAR(200) 上报地标信息。纠偏后的定位数据转换得到的地标信息
arrive_pos_offset NUMERIC(20,2) 和客户的偏差距离(米)。纠偏后的位置和客户纠偏后的位置的差值,当客户位置为空时,偏差距离为空
comment_status VARCHAR(32) 评价状态(未评价/合格/不合格)
record_sys_id VARCHAR(32) 评价人ID(勤策(原外勤365)的ID)
record_source_code VARCHAR(32) 评价人唯一标识(source_code)
record_sys_name VARCHAR(100) 评价人姓名
comment_time VARCHAR(32) 评价时间。格式:yyyy-MM-dd HH:mm:ss
comment_text VARCHAR(100) 评价意见
re_comment_status VARCHAR(32) 复评状态(未评价/合格/不合格)
re_comment_text VARCHAR(100) 复评意见
re_record_sys_id VARCHAR(32) 复评人ID(勤策(原外勤365)的ID)
re_record_source_code VARCHAR(32) 复评人唯一标识(source_code)
re_record_sys_name VARCHAR(100) 复评人姓名
re_comment_time VARCHAR(32) 复评时间。格式:yyyy-MM-dd HH:mm:ss
visit_implement_id VARCHAR(32) 拜访记录ID
form_define_id VARCHAR(32) 上报表单模板ID
data_id VARCHAR(32) 上报表单数据ID
record_time VARCHAR(32) 上报时间。格式:yyyy-MM-dd HH:mm:ss
status VARCHAR(32) 删除状态。0:删除,1:正常

# 查询结案记录

接口说明:查询审批通过的活动结案数据,按审批通过时间查询

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

{
    "page_number": "1",
    "page_size": "10",
    "audit_start":"2021-06-10 00:00:00",
    "audit_end":"2021-06-31 00:00:00"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
audit_start VARCHAR(32) 审批通过开始。格式:yyyy-MM-dd HH:mm:ss
audit_end VARCHAR(32) 审批通过结束时间。格式:yyyy-MM-dd HH:mm:ss
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认100

响应示例:

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

数据DATA示例:

[
    {
        "audit_time":"2021-06-21 20:24",
        "close_apply_code":"JA202106210001",
        "close_apply_id":"6217718455120623075",
        "create_time":"2021-06-21 20:24",
        "creator_id":"6837814635165396941",
        "detailList":[
            {
                "activity_cm_id":"7759614063985582139",
                "actual_sales_quota":"",
                "close_cycle":"2021-05-18~2021-06-17",
                "cm_code":"CUS010267",
                "cm_id":"5323379110327494049",
                "cm_name":"1232",
                "itemList":[
                    {
                        "cash_value":"8.00",
                        "item_name":"会员店",
                        "pd_code":"",
                        "pd_id":"",
                        "pd_name":"",
                        "pd_unit":"",
                        "pd_value":""
                    },
                    {
                        "cash_value":"21.00",
                        "item_name":"五星",
                        "pd_code":"",
                        "pd_id":"",
                        "pd_name":"",
                        "pd_unit":"",
                        "pd_value":""
                    },
                    {
                        "cash_value":"",
                        "item_name":"三星",
                        "pd_code":"",
                        "pd_id":"",
                        "pd_name":"",
                        "pd_unit":"",
                        "pd_value":""
                    }
                ],
                "pay_record_id":"8243661372315420848",
                "target_sale_quota":"1.92"
            }
        ],
        "plan_code":"CX202012187419",
        "plan_id":"4728479377320271173",
        "plan_name":"2021年全国市场核心终端建设活动"
    }
]

参数说明:

参数 类型 必填 说明
close_apply_id VARCHAR(32) 结案单ID
close_apply_code VARCHAR(32) 结案单号
create_time VARCHAR(100) 创建时间。格式:yyyy-mm-dd hh24:mi
creator_id VARCHAR(32) 结案单创建人ID。自动结案的创建人为“系统”
plan_id VARCHAR(32) 方案ID
plan_code VARCHAR(32) 方案编码
plan_name VARCHAR(100) 方案名称
detailList List 结案明细列表
detailList.pay_record_id VARCHAR(32) 结案明细ID
detailList.close_cycle VARCHAR(100) 结案周期。单次结案时,显示申请时的执行周期;分期时,显示当前分期的执行周期
detailList.activity_cm_id VARCHAR(32) 申请明细ID
detailList.cm_id VARCHAR(32) 客户ID
detailList.cm_code VARCHAR(32) 客户编码
detailList.cm_name VARCHAR(200) 客户名称
detailList.target_sale_quota VARCHAR(1000) 目标销额。分期结案时,是当前分期的目标销额
detailList.actual_sales_quota VARCHAR(1000) 实际销额。分期结案时,是当前分期周期内的实际销额
detailList.itemList List 列表
detailList.itemList.item_name VARCHAR(100) 付费项目
detailList.itemList.pd_id VARCHAR(32) 实际结案商品ID(兑商品时有值)
detailList.itemList.pd_code VARCHAR(100) 实际结案商品编码(兑商品时有值)
detailList.itemList.pd_name VARCHAR(100) 实际结案商品名称(兑商品时有值)
detailList.itemList.pd_value VARCHAR(1000) 实际结案商品数量(兑商品时有值)
detailList.itemList.pd_unit VARCHAR(100) 实际结案商品单位(兑商品时有值)
detailList.itemList.cash_value VARCHAR(1000) 现金(元)

# 查询检核记录

接口说明:查询付费陈列和市场活动场景的活动检核记录

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

{
    "page_number": "1",
    "page_size": "1",
    "check_date_start":"2022-01-01",
    "check_date_end":"2022-03-01"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
check_date_start VARCHAR(32) 检核开始日期。格式:yyyy-MM-dd
check_date_end VARCHAR(32) 检核结束日期。格式:yyyy-MM-dd
plan_code VARCHAR(32) 方案编码
apply_code VARCHAR(32) 申请单号
cm_code VARCHAR(32) 客户编码
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认100

响应示例:

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

数据DATA示例:

[
    {
    "plan_id": "7226626906295451231",
    "plan_code": "11.11",
    "plan _name ": "双十一大促",
    "activity_id ": "5277027684278203306",
    "activity_name ": "江苏区决战双十一",
    "detail_id":"",
    "record_id": "5232948793149090911",
    "record_status ": "1",
    "comment_text": "陈列不整齐",
    "pay_evaluate_data": [{
        "comment_text": "陈列不整齐",
        "item_name": "端架陈列",
        "comment_status": "1"
    }],
    "create_time": "2015-11-15 13:50:18",
    "emp_id": " 5277027684278203306",
    "emp_name": "张三",
    "cm_id": " 5277027684278203306",
    "cm_name": "大润发龙江店",
    "data_id": " 5277027684278203306",
    "check_define_id": " 5277027684278203306"
    }
]

参数说明:

参数 类型 必填 说明
plan_id VARCHAR(32) 促销方案ID
plan_code VARCHAR(100) 促销方案编码
plan_name VARCHAR(100) 促销方案名称
activity_id VARCHAR(32) 活动ID
activity_name VARCHAR(100) 活动名称
detail_id VARCHAR(100) 申请明细ID
record_id VARCHAR(32) 检核记录的ID
record_status CHAR(1) 检核状态。0:合格,1:不合格
comment_text VARCHAR(1000) 不合格理由
pay_evaluate_data List 付费评价数据列表
pay_evaluate_data.comment_text VARCHAR(1000) 不合格理由
pay_evaluate_data.item_name VARCHAR(100) 付费项目
pay_evaluate_data.comment_status VARCHAR(1) 合格状态。1:不合格,0:合格
create_time VARCHAR(32) 创建时间。格式:yyyy-MM-dd HH:mm:ss
emp_id VARCHAR(32) 上报人ID(勤策(原外勤365)的ID)
emp_source_code VARCHAR(100) 上报人唯一标识(source_code)
emp_name VARCHAR(32) 上报人姓名
cm_id VARCHAR(32) 客户(门店)ID(勤策(原外勤365)的ID)
cm_source_code VARCHAR(200) 客户(门店)唯一标识(source_code)
cm_name VARCHAR(200) 客户(门店)名称
visit_implement_id VARCHAR(32) 拜访记录ID
data_id VARCHAR(32) 表单数据id
check_define_id VARCHAR(32) 表单id

# 查询进货折扣类结案额

接口说明:查询活动结案数据,按最近审批时间查询

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

{
    "page_number": "1",
    "page_size": "10",
    "startTime":"2021-06-10 00:00:00",
    "endTime":"2021-06-30 00:00:00",
    "apply_status": "1"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
apply_status VARCHAR(32) 0:处理中,1:已审批,2:被打回
startTime VARCHAR(32) 最近审批开始时间。格式:yyyy-MM-dd HH:mm:ss
endTime VARCHAR(32) 最近审批结束时间。格式:yyyy-MM-dd HH:mm:ss
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认1000

响应示例:

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

数据DATA示例:

[
    {
        "id": "7534647030541451685",
        "apply_code": "JA202010100007",
        "create_times": "2020-10-10 15:05",
        "user_name": "王仪猛1",
        "activity_id": "8681499756400641889",
        "activity_code": "SQ202010100033",
        "activity_name": "20201010-1449",
        "approvalDetail": {
            "modifyier_id": "7455862404045968371",
            "modifyier_name": "王仪猛1",
            "modify_time": "2020-10-10 15:05"
        },
        "caseCloseDetails": [
            {
                "id": "5515296304968485473",
                "cm_id": "7527439616482204539",
                "cus_code": "CUS000036",
                "cus_name": "倪威-策略配置-连续",
                "cus_dept_name": "QQ的新企业测试",
                "dealer_code": "CUS010269",
                "dealer_name": "下发测试",
                "pd_id": "8200618247497811437",
                "pd_code": "1009000359",
                "pd_name": "52°水晶剑南春(专卖店)20版[500×1×6]",
                "pd_unit_name": "箱",
                "pd_sales_amount": "490.00",
                "unit_discount_amount": "40.00",
                "discount_price": "450.00",
                "expected_sales_num": "5.00",
                "apply_amount": "200.00",
                "close_unit_discount": "40.00",
                "actual_sales_num": "5.00",
                "close_amount": "200.00",
                "close_case_remark": null,
                "activity_cycle": "2020-10-08~2020-10-09",
                "subject_name": "202010101105科目",
                "period": "2020-06",
                "budget_dim_info": "[{\"dim_dept_name\":\"自定义组\",\"dim_dept\":\"8854835945898132333\"},{\"dim_2010100006_name\":\"202010101109wd_吧\",\"dim_2010100006\":\"5685456838091294554\"}]",
                "pay_type_name": "电汇",
                "remark": "20201010-1449",
                "fields_info": null
            }
        ]
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 结案单ID
apply_code VARCHAR(32) 结案单号
create_times VARCHAR(100) 创建时间。格式:yyyy-mm-dd hh24:mi
user_name VARCHAR(32) 结案单创建人ID。自动结案的创建人为“系统”
activity_id VARCHAR(32) 方案ID
activity_code VARCHAR(32) 方案编码
activity_name VARCHAR(100) 方案名称
caseCloseDetails List 结案明细列表
caseCloseDetail.id VARCHAR(32) 结案明细ID
caseCloseDetail.cm_id VARCHAR(32) 客户ID
caseCloseDetail.cus_code VARCHAR(100) 客户编码
caseCloseDetail.cus_name VARCHAR(100) 客户名称
caseCloseDetail.cus_dept_name VARCHAR(100) 客户所属部门
caseCloseDetail.dealer_code VARCHAR(100) 费用代垫经销商编码
caseCloseDetail.dealer_name VARCHAR(100) 费用代垫经销商名称
caseCloseDetail.pd_id VARCHAR(32) 商品ID
caseCloseDetail.pd_code VARCHAR(100) 商品编码
caseCloseDetail.pd_name VARCHAR(100) 商品名称
caseCloseDetail.pd_unit_name VARCHAR(100) 商品单位
caseCloseDetail.pd_sales_amount VARCHAR(1000) 商品售价
caseCloseDetail.unit_discount_amount VARCHAR(1000) 单位折让(申请)
caseCloseDetail.discount_price VARCHAR(1000) 折后价
caseCloseDetail.expected_sales_num VARCHAR(1000) 预计销量
caseCloseDetail.apply_amount VARCHAR(1000) 申请金额
caseCloseDetail.close_unit_discount VARCHAR(1000) 单位折让(结案)
caseCloseDetail.actual_sales_num VARCHAR(1000) 实际销量
caseCloseDetail.close_amount VARCHAR(1000) 结案金额
caseCloseDetail.close_case_remark VARCHAR(1000) 结案备注
caseCloseDetail.activity_cycle VARCHAR(100) 活动周期
caseCloseDetail.subject_name VARCHAR(100) 科目
caseCloseDetail.period VARCHAR(100) 期间
caseCloseDetail.budget_dim_info VARCHAR(1000) 预算维度json 格式为:[{"预算维度名称":维值名称}],多个维度用逗号隔开
caseCloseDetail.pay_type_name VARCHAR(100) 支付方式
caseCloseDetail.remark VARCHAR(1000) 申请备注说明
caseCloseDetail.fields_info VARCHAR(1000) 自定义字段 格式为[{字段Code:值}]
approvalDetail Object 结案明细列表
approvalDetail.modifyier_id VARCHAR(32) 最近一次审批人的员工账号
approvalDetail.modifyier_name VARCHAR(100) 最近一次审批人的员工姓名
approvalDetail.modify_time VARCHAR(32) 最近审批时间。格式:yyyy-MM-dd HH:mm:ss

# 查询固定金额类结案额

接口说明:查询活动结案数据,按最近审批时间查询

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

{
    "page_number": "1",
    "page_size": "10",
    "startTime":"2022-02-01 00:00:00",
    "endTime":"2022-03-13 00:00:00",
    "apply_status": "0"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
apply_status VARCHAR(32) 0:处理中,1:已审批,2:被打回
startTime VARCHAR(32) 最近审批开始时间。格式:yyyy-MM-dd HH:mm:ss
endTime VARCHAR(32) 最近审批结束时间。格式:yyyy-MM-dd HH:mm:ss
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认1000

响应示例:

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

数据DATA示例:

[
    {
        "id": "8179065222197351898",
        "apply_code": "JA202203100001",
        "create_times": "2022-03-10 09:09",
        "user_name": "shun",
        "activity_code": "SQ202203090009",
        "activity_name": "固额-hts-test01",
        "activity_id": "7629351255429503936",
        "approvalDetail": {
            "modifyier_id": "7455862404045968371",
            "modifyier_name": "王仪猛1",
            "modify_time": "2022-03-08 10:01"
        },
        "skuDetails": [
            {
                "id": "6136494217914125557",
                "sku_name": "家乐福",
                "dealer_code": "CUS010269",
                "dealer_name": "下发测试",
                "apply_amount": "20.0",
                "close_amount": "20.0",
                "sku_cm_num": "2",
                "pd_id": "8200618247497811437",
                "pd_code": "1009000359",
                "pd_name": "52°水晶剑南春(专卖店)20版[500×1×6]",
                "activity_cycle": "2022-03-05~2022-03-06",
                "subject_name": "【是】共用1",
                "fields_info": ""
            }
        ],
        "cmDetails": [
            {
                "id": "6816132238663717228",
                "cus_name": "测试客户2",
                "dealer_code": "CUS010403",
                "dealer_name": "cctest",
                "apply_amount": "30.00",
                "close_amount": "30.00",
                "close_case_remark": null,
                "pd_code": "1009000359",
                "pd_name": "52°水晶剑南春(专卖店)20版[500×1×6]",
                "activity_cycle": "2022-03-05~2022-03-06",
                "subject_name": "【是】共用1",
                "period": "2022-03",
                "budget_dim_info": "[{\"dim_1912200004_name\":\"权限全公司\",\"dim_1912200004\":\"6702228490352177010\"}]",
                "pay_type_name": "现金",
                "remark": "",
                "fields_info": ""
            }
        ]
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 结案单ID
apply_code VARCHAR(32) 结案单号
create_times VARCHAR(100) 创建时间。格式:yyyy-mm-dd hh24:mi
user_name VARCHAR(32) 结案单创建人ID。自动结案的创建人为“系统”
activity_id VARCHAR(32) 申请明细ID
activity_code VARCHAR(32) 活动申请单号
activity_name VARCHAR(100) 申请名称
skuDetails List 连锁品牌明细列表
skuDetail.id VARCHAR(32) 连锁品牌ID
skuDetail.sku_name VARCHAR(32) 连锁品牌
skuDetail.dealer_code VARCHAR(32) 费用代垫经销商编码
skuDetail.dealer_name VARCHAR(32) 费用代垫经销商名称
skuDetail.apply_amount VARCHAR(1000) 申请金额
skuDetail.close_amount VARCHAR(1000) 结案金额
skuDetail.sku_cm_num VARCHAR(100) 结案客户数
skuDetail.pd_id VARCHAR(32) 商品ID
skuDetail.pd_code VARCHAR(100) 商品编码
skuDetail.pd_name VARCHAR(100) 商品名称
skuDetail.activity_cycle VARCHAR(100) 活动周期
skuDetail.subject_name VARCHAR(100) 科目
skuDetail.fields_info VARCHAR(1000) 自定义字段 格式为[{字段Code:值}]
cmDetails List 客户明细列表
cmDetail.id VARCHAR(32) 客户ID
cmDetail.cus_name VARCHAR(100) 客户
cmDetail.dealer_code VARCHAR(100) 费用代垫经销商编码
cmDetail.dealer_name VARCHAR(100) 费用代垫经销商名称
cmDetail.apply_amount VARCHAR(1000) 申请金额
cmDetail.close_amount VARCHAR(1000) 结案金额
cmDetail.close_case_remark VARCHAR(1000) 结案备注
cmDetail.pd_code VARCHAR(100) 商品编码
cmDetail.pd_name VARCHAR(100) 商品名称
cmDetail.activity_cycle VARCHAR(100) 活动周期
cmDetail.subject_name VARCHAR(100) 预算科目名称
cmDetail.period VARCHAR(100) 预算扣减的期间
cmDetail.budget_dim_info VARCHAR(1000) [{"预算维度名称":维值名称}],多个维度用逗号隔开
cmDetail.pay_type_name VARCHAR(100) 支付方式
cmDetail.remark VARCHAR(1000) 申请备注说明
cmDetail.fields_info VARCHAR(1000) 自定义字段 格式为[{字段Code:值}]
approvalDetail Object 结案明细列表
detailList.modifyier_id VARCHAR(32) 最近一次审批人的员工账号
detailList.modifyier_name VARCHAR(100) 最近一次审批人的员工姓名
detailList.modify_time VARCHAR(32) 最近审批时间。格式:yyyy-MM-dd HH:mm:ss

# 查询品鉴会申请记录

接口说明:查询品鉴会申请记录

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

{
   "create_date_begin":"2022-04-13 00:00:00",
    "create_date_end":"2022-04-15 00:00:00",
    "modify_date_begin":"2022-04-13 00:00:00",
    "modify_date_end":"2022-04-15 00:00:00",
    "audit_date_begin":"2022-04-13 00:00:00",
    "audit_date_end":"2022-04-15 00:00:00",
    "apply_code":"SQ202204140101",
    "page_number":100,
    "page_size":1
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_date_begin VARCHAR(32) 开始时间格式:yyyy-MM-dd HH:mm:ss。限制创建时间
create_date_end VARCHAR(32) 结束时间格式:yyyy-MM-dd HH:mm:ss。限制创建时间
modify_date_begin VARCHAR(32) 开始时间格式:yyyy-MM-dd HH:mm:ss。限制最近修改时间
modify_date_end VARCHAR(32) 结束时间格式:yyyy-MM-dd HH:mm:ss。限制最近修改时间
audit_date_begin VARCHAR(32) 审批通过开始时间格式:yyyy-MM-dd HH:mm:ss。限制申请审批时间
audit_date_end VARCHAR(32) 审批通过结束时间格式:yyyy-MM-dd HH:mm:ss。限制申请审批时间
apply_code VARCHAR(32) 申请单号
apply_status VARCHAR(8) 审批状态。0:处理中,1:已批准,2:已打回,3:审批中
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认100

响应示例:

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

数据DATA示例:

[
	{
		"isOwnJoin": "1",
		"planName": "品鉴会-人员额度配置",
		"customerCode": "CUS000014",
		"remark": "123",
		"applyRecordCode": "SQ202204140101",
		"customerAddr": "江苏省南京市建邺区泰山路",
		"deteleStatus": "1",
		"activityPdList": [
			{
				"productCode": "pd_0001",
				"basicUnit": "把",
				"applyNum": 1.00,
				"productName": "无尽之刃"
			}
		],
		"activityDate": "2022_04-14",
		"customerId": 6503181307801475589,
		"extFieldsInfo": "[{\"column\":\"自定义附件\",\"value\":\"\\\"20220414151084_d76a472f999f44a080d17e0ca8a74160.md\\\"\",\"key\":\"ext_2204140109\"}]",
		"applicantId": "7867366114238721025",
		"approvalStatus": "0",
		"executorId": "8073482308453798824",
		"activityTime": "AM",
		"applicantName": "汤姆布力波",
		"applyRecordId": "9151325028676651599",
		"planCode": "CX202203154552",
		"customerName": "奥巴马要考虑国际化和多选情况多选奥巴马奥巴马奥巴马奥巴马奥巴马奥巴马奥巴马奥巴马奥巴马",
		"executorName": "蔡鹏",
		"createTime": "2022_04-14 15:12:25",
		"auditTime": "2022_04-14 15:12:26",
		"lastModifyTime": "2022_04-14 15:12:26",
		"predictJoinNum": 123
	}
]

参数说明:

参数 类型 必填 说明
applyRecordId VARCHAR(32) 申请记录ID
applyRecordCode VARCHAR(100) 申请单号
applicantId VARCHAR(32) 申请人ID
applicantName VARCHAR(100) 申请人名称
createTime VARCHAR(32) 创建时间。格式:yyyy-mm-dd hh24:mi:ss
auditTime VARCHAR(32) 审批时间。格式:yyyy-mm-dd hh24:mi:ss
lastModifyTime VARCHAR(32) 最近修改时间。格式:yyyy-mm-dd hh24:mi:ss
approvalStatus VARCHAR(32) 审批状态。0:处理中,1:已批准,2:已打回,3:审批中
deleteStatus VARCHAR(32) 删除状态。1:未删除,0:已删除
planCode VARCHAR(100) 方案编码
planName VARCHAR(100) 方案名称
customerId VARCHAR(32) 客户ID
customerCode VARCHAR(100) 客户编码
customerName VARCHAR(100) 客户名称
customerAddr VARCHAR(1000) 客户地址
hotelName VARCHAR(100) 酒店名称
hotelAddress VARCHAR(100) 酒店地址
hotelContact VARCHAR(100) 酒店电话
activityDate VARCHAR(100) 活动日期。格式:yyyy-mm-dd
activityTime VARCHAR(100) 活动时间。AM:上午,NOON:中午,NIGHT:晚上
executorId VARCHAR(32) 执行人ID
executorName VARCHAR(100) 执行人姓名
predictJoinNum NUMERIC 预计参与人数。最大15位数字
isOwnJoin VARCHAR(100) 是否有我方人员参加。1:是,0:否
remark VARCHAR(1000) 备注
extFieldsInfo VARCHAR(1000) 自定义字段,格式为list,一个自定义字段有三个column、key、value
activityPdList List 商品列表明细
activityPdList.productCode VARCHAR(100) 商品编码
activityPdList.productName VARCHAR(100) 商品名称
activityPdList.applyNum NUMERIC 预计数量。最大20位数字
activityPdList.basicUnit VARCHAR(32) 基本单位

# 查询宴席申请记录

接口说明:查询宴席申请记录

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

{
    "create_date_begin":"2022-04-13 00:00:00",
    "create_date_end":"2022-04-15 00:00:00",
    "modify_date_begin":"2022-04-13 00:00:00",
    "modify_date_end":"2022-04-15 00:00:00",
    "audit_date_begin":"2022-04-13 00:00:00",
    "audit_date_end":"2022-04-15 00:00:00",
    "apply_code":"SQ202204130004",
    "apply_status":"1",
    "page_number":100,
    "page_size":1
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_date_begin VARCHAR(32) 开始时间格式:yyyy-MM-dd HH:mm:ss。限制创建时间
create_date_end VARCHAR(32) 结束时间格式:yyyy-MM-dd HH:mm:ss。限制创建时间
modify_date_begin VARCHAR(32) 开始时间格式:yyyy-MM-dd HH:mm:ss。限制最近修改时间
modify_date_end VARCHAR(32) 结束时间格式:yyyy-MM-dd HH:mm:ss。限制最近修改时间
audit_date_begin VARCHAR(32) 审批通过开始时间格式:yyyy-MM-dd HH:mm:ss。限制申请审批时间
audit_date_end VARCHAR(32) 审批通过结束时间格式:yyyy-MM-dd HH:mm:ss。限制申请审批时间
apply_code VARCHAR(32) 申请单号
apply_status VARCHAR(8) 审批状态。0:处理中,1:已批准,2:已打回,3:审批中
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认100

响应示例:

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

数据DATA示例:

[
	{
		"hostTime": "中午",
		"hostName": "啊啊啊是",
		"dealerCode": "CUS000054",
		"feastEndDate": "2022_04_10",
		"planName": "hts-宴席",
		"customerCode": "CUS010305",
		"remark": "阿萨",
		"applyRecordCode": "SQ202204130004",
		"activityPdList": [
			{
				"productCode": "1001000097",
				"useTypeName": "公司赞助",
				"basicUnit": "件",
				"applyNum": 3,
				"productName": "BC端宴会==码中台"
			}
		],
		"deleteStatus": "1",
		"customerId": "6806582156885106531",
		"extFieldsInfo": "[{\"column\":\"自定义字段名\",\"key\":\"ext_2203280067\",\"value\":\"hhh\"}]",
		"applicantId": "7002401310724831087",
		"approvalStatus": "1",
		"feastType": "公司年会",
		"dealerName": "法人刘昭",
		"executorId": "8717688507269859633",
		"dealerId": "5102106230943924527",
		"applicantName": "shun",
		"applyRecordId": "7719558126269131824",
		"planCode": "CX202204133826",
		"feastStartDate": "2022_04_07",
		"hostContact": "13689748942",
		"customerName": "0529测试三要素",
		"executorName": "安安01",
		"createTime": "2022_04-13 14:26:39",
		"auditTime": "2022_04-14 09:52:25",
		"lastModifyTime": "2022_04-14 09:52:25",
		"hostAddress": "aaaa",
		"predictJoinNum": 2
	}
]

参数说明:

参数 类型 必填 说明
applyRecordId VARCHAR(32) 申请记录ID
applyRecordCode VARCHAR(100) 申请单号
applicantId VARCHAR(32) 申请人ID
applicantName VARCHAR(100) 申请人名称
createTime VARCHAR(32) 创建时间。格式:yyyy-mm-dd hh24:mi:ss
auditTime VARCHAR(32) 审批时间。格式:yyyy-mm-dd hh24:mi:ss
lastModifyTime VARCHAR(32) 最近修改时间。格式:yyyy-mm-dd hh24:mi:ss
approvalStatus VARCHAR(32) 审批状态。0:处理中,1:已批准,2:已打回,3:审批中
deleteStatus VARCHAR(32) 删除状态。1:未删除,0:已删除
planCode VARCHAR(100) 方案编码
planName VARCHAR(100) 方案名称
feastType VARCHAR(32) 宴席类型
feastStartDate VARCHAR(32) 宴席开始日期。格式:yyyy-mm-dd
feastEndDate VARCHAR(32) 宴席结束日期。格式:yyyy-mm-dd
hostTime VARCHAR(32) 举办时段
hostName VARCHAR(100) 举办人姓名
hostContact VARCHAR(32) 举办人联系电话
hostAddress VARCHAR(100) 举办地址
predictJoinNum NUMERIC 预计开展桌数
executorId VARCHAR(32) 执行人ID
executorName VARCHAR(100) 执行人姓名
customerId VARCHAR(32) 供货方ID
customerCode VARCHAR(100) 供货方编码
customerName VARCHAR(100) 供货方名称
dealerId VARCHAR(32) 费用代垫经销商ID
dealerCode VARCHAR(100) 费用代垫经销商编码
dealerName VARCHAR(100) 费用代垫经销商名称
remark VARCHAR(1000) 备注
extFieldsInfo VARCHAR(1000) 自定义字段,格式为list,一个自定义字段有三个column、key、value
activityPdList List 商品列表明细
activityPdList.productCode VARCHAR(100) 商品编码
activityPdList.productName VARCHAR(100) 商品名称
activityPdList.applyNum NUMERIC 预计数量。最大20位数字
activityPdList.basicUnit VARCHAR(32) 基本单位
activityPdList.useTypeName VARCHAR(100) 用酒类型

# 查询宴席上报记录

接口说明:查询宴席场景的活动上报记录,入口参数都不传时,返回所有的上报记录

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

{
    "create_start":"2022-03-13 14:00:24",
    "create_end":"2022-03-16 15:00:24",
    "modify_start":"2022-03-13 14:00:24",
    "modify_end":"2022-03-16 15:00:24",
    "apply_code":"SQ202203080009",
    "page_number":100,
    "page_size":1
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_start VARCHAR(32) 开始时间格式:yyyy-MM-dd HH:mm:ss。限制创建时间
create_end VARCHAR(32) 结束时间格式:yyyy-MM-dd HH:mm:ss。限制创建时间
modify_start VARCHAR(32) 开始时间格式:yyyy-MM-dd HH:mm:ss。限制最近修改时间
modify_end VARCHAR(32) 审批通过开始时间格式:yyyy-MM-dd HH:mm:ss。限制申请审批时间
apply_code VARCHAR(32) 活动申请单号
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认1000

响应示例:

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

数据DATA示例:

[
	{
		"arrive_lla": "",
		"code": "CX202203088600",
		"reportPdList": [
			{
				"unit_name": "瓶",
				"use_type_name": "公司赞助",
				"pd_num": 2,
				"pd_name": "红药水",
				"pd_code": "SP202109150005"
			},
			{
				"unit_name": "把",
				"use_type_name": "客户购买",
				"pd_num": 10,
				"pd_name": "蓝药水",
				"pd_code": "pd_002"
			},
			{
				"unit_name": "把",
				"use_type_name": "公司赞助",
				"pd_num": 3,
				"pd_name": "蓝药水",
				"pd_code": "pd_002"
			}
		],
		"create_time": "2022-03-15 10:40:50",
		"form_define_id": 6009237159914380366,
		"modify_time": "2022-03-15 10:48:32",
		"actual_tables": 1,
		"activity_code": "SQ202203080009",
		"sye_name": "韩煜",
		"report_terminal": "MOBILE",
		"sye_id": "7136146755608045854",
		"record_id": "5095203842926411926",
		"data_id": 9066002301057603178,
		"name": "701-宴席-加签",
		"activity_id": "8337818076394260610",
		"id": "5528400412559788988",
		"source_code": "hy",
        "arrive_pos_offset": 10.00,
		"status": "1"
	}
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 方案id
code VARCHAR(100) 方案编码
name VARCHAR(32) 方案名称
activity_id VARCHAR(100) 活动申请ID
activity_code VARCHAR(32) 活动申请单号
record_id VARCHAR(32) 上报记录ID
sye_id VARCHAR(32) 上报人ID(外勤365的ID)
source_code VARCHAR(32) 上报人唯一标识(source_code)
sye_name VARCHAR(32) 上报人姓名
report_terminal VARCHAR(100) 上报终端(手机端、电脑端、微信端)
wx_name VARCHAR(100) 微信昵称
wx_open_id VARCHAR(32) 微信openid
wx_mobile VARCHAR(32) 微信手机号
arrive_lla VARCHAR(32) 上报地标信息。纠偏后的定位数据转换得到的地标信息
arrive_pos_offset VARCHAR(32) 和客户的偏差距离(米)。纠偏后的位置和客户纠偏后的位置的差值,当客户位置为空时,偏差距离为空
form_define_id VARCHAR(100) 上报表单模板ID
data_id VARCHAR(32) 上报表单数据ID
create_time VARCHAR(100) 创建时间。格式:yyyy-mm-dd hh24:mi:ss
modify_time VARCHAR(100) 修改时间。格式:yyyy-mm-dd hh24:mi:ss
actual_tables NUMERIC 实际桌数
status VARCHAR(32) 删除状态。0:删除,1:正常

| reportPdList | List | 是 | 商品列表明细 | | reportPdList.pd_code | VARCHAR(100) | 是 | 实际使用商品编码 |
| reportPdList.pd_name | VARCHAR(100) | 是 | 商品名称 |
| reportPdList.pd_num | NUMERIC | 是 | 数量 |
| reportPdList.unit_name | VARCHAR(32) | 是 | 基本单位 |
| reportPdList.use_type_name | VARCHAR(100) | 是 | 用酒类型 |

# 查询已审批通过的项目

接口说明:查询已审批通过的项目

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

{
    "startTime": "2017-01-10 00:00:00",
    "endTime": "2022-02-28 00:00:00",
    "project_code": "XM2022033605",
    "page_number": "1",
    "page_size": "100"
}

说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
startTime VARCHAR(32) 修改开始时间。格式:yyyy-MM-dd HH:mm:ss
endTime VARCHAR(32) 修改结束时间。格式:yyyy-MM-dd HH:mm:ss
project_code VARCHAR(32) 项目编码
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认100

响应示例:

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

数据DATA示例:

[
    {
        "budget_org_code": "yszzbm001",
        "budget_org_name": "预算组织名称001",
        "modify_time": "2022-03-15 15:26",
        "director_name": "boss",
        "project_code": "XM2022033605",
        "project_name": "项目名称001",
		"parent_project_code":"",
		"parent_project_name":""
    }
]

参数说明:

参数 类型 必填 说明
project_code VARCHAR(100) 项目编码
project_name VARCHAR(100) 项目名称
budget_org_code VARCHAR(100) 预算组织编码
budget_org_name VARCHAR(100) 预算组织名称
director_name VARCHAR(100) 项目负责人
modify_time VARCHAR(100) 最近修改时间。格式:yyyy-MM-dd HH:mm:ss
parent_project_code VARCHAR(100) 父项目编码
parent_project_name VARCHAR(100) 父项目名称

# 查询付费协议同步状态

接口说明:当付费协议是从第三方获取时,根据申请明细行查询同步付费协议的状态

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

{
    "detailId": "5745552265106243620"
}

说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
detailId VARCHAR(32) 申请明细ID

响应示例:

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

数据DATA示例:

{
    "sync_status":"2",
    "source_url":"https://contract-test.waiqin365.com/7320333869003283336/cuxiao_contract/202205/6192137399713160687.pdf"
}

参数说明:

参数 类型 必填 说明
sync_status VARCHAR(1) 付费协议同步状态 0-待同步 1-同步成功 2-同步失败 3-同步中
source_url TEXT 源文件url

# 查询宴席活动方案

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

{
    "create_start": "2022-08-01 00:00:00",
    "create_end": "2022-08-26 00:00:00",
    "modify_start": "2022-08-01 00:00:00",
    "modify_end": "2022-08-26 00:00:00",
    "page_number":"1",
    "page_size":"10"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_start VARCHAR(32) 创建开始时间。格式:yyyy-MM-dd HH:mm:ss
create_end VARCHAR(32) 创建结束时间。格式:yyyy-MM-dd HH:mm:ss
modify_start VARCHAR(32) 修改开始时间。格式:yyyy-MM-dd HH:mm:ss
modify_end VARCHAR(32) 修改结束时间。格式:yyyy-MM-dd HH:mm:ss
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认1000

响应示例:

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

数据DATA示例:

[
    {
        "end_date": "2022-08-17",
        "type_name": "NoDim-宴席-方案",
        "code": "CX202208176888",
        "create_time": "2022-08-17 15:01:29",
        "modify_time": "2022-08-17 15:01:29",
        "feast_type_name": "",
        "evaluate_form_name": "",
        "description": "1",
        "brand_name": "",
        "allow_wine_back": "0",
        "report_form_name": "手动点击",
        "flow_status": "0",
        "name": "2022年08月17日15:01:05",
        "id": "6876392358072815001",
        "pds": [
            {
                "code": "pd_0001",
                "name": "无尽之刃"
            }
        ],
        "start_date": "2022-08-17"
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 方案ID
create_time VARCHAR(32) 创建时间。格式:yyyy-MM-dd HH:mm:ss
modify_time VARCHAR(32) 修改时间。格式:yyyy-MM-dd HH:mm:ss
code VARCHAR(100) 方案编码
name VARCHAR(100) 方案名称
description VARCHAR(4000) 方案说明
type_name VARCHAR(100) 方案类型
report_form_name VARCHAR(100) 上报模板名称
evaluate_form_name VARCHAR(100) 上报评价模板名称
start_date VARCHAR(32) 方案执行开始日期,格式:yyyy-MM-dd
end_date VARCHAR(32) 方案执行结束日期,格式:yyyy-MM-dd
feast_type_name VARCHAR(100) 宴席类型名称,多个逗号分隔
brand_name VARCHAR(100) 活动品牌
pds[].code VARCHAR(100) 活动商品编码
pds[].name VARCHAR(100) 活动商品名称
allow_wine_back VARCHAR(32) 允许用酒退码: 0-否,1-是
flow_status VARCHAR(32) 审批状态:0-处理中、1-已批准、2-已打回、3-审批中

# 查询宴席扫码记录

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

{
    "create_start": "2022-08-25 00:00:00",
    "create_end": "2022-08-26 00:00:00",
    "page_number":"1",
    "page_size":"3"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_start VARCHAR(32) 创建开始时间。格式:yyyy-MM-dd HH:mm:ss
create_end VARCHAR(32) 创建结束时间。格式:yyyy-MM-dd HH:mm:ss
page_number VARCHAR(100) 页码,不填默认第一页
page_size VARCHAR(100) 页长,不填默认1000

响应示例:

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

数据DATA示例:

[
    {
        "cm_code": "CUS000024",
        "creator_code": "ht",
        "create_time": "2022-08-25 19:30:04",
        "cm_name": "001-002下级客户001",
        "scan_type": "2",
        "creator_name": "hutao",
        "id": "5853887678538238175",
        "activity_code": "SQ202208250001",
        "rows": [
            {
                "unit_name": "瓶",
                "scan_code": "12345689",
                "wine_type_name": "公司赞助",
                "pd_name": "红药水",
                "pd_code": "SP202109150005"
            }
        ]
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 扫码批次唯一ID
activity_code VARCHAR(100)
cm_code VARCHAR(100) 供货方编码
cm_name VARCHAR(100) 供货方名称
creator_code VARCHAR(100) 扫码员工账号
creator_name VARCHAR(100) 扫码员工姓名
create_time VARCHAR(32) 创建时间。格式:yyyy-MM-dd HH:mm:ss
scan_type VARCHAR(100) 扫码类型 1-用酒登记 2-用酒退码
rows[].wine_type_name VARCHAR(100) 用酒类型
rows[].pd_code VARCHAR(100) 商品编码
rows[].pd_name VARCHAR(100) 商品名称
rows[].scan_code VARCHAR(100)
rows[].unit_name VARCHAR(100) 码单位