# 促销查询接口

# 万能促销活动(TP)方案查询

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

请求方式: 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",
      	"item_names":"陈列,端架",
      	"predict_sale_amount":"",
      	"predict_effective_ratio":"",
        "extColumns": [
                    {
                      "ext_key": "DT",
                      "ext_col": "ext_2202230054",
                      "ext_value": "2022-02-23"
                    },
                    {
                      "ext_key": "文本框12",
                      "ext_col": "ext_2201060009",
                      "ext_value": "Text"
                    }
                ],
        "plan_status":"1",
      	"budget_dim_info":[{
          	"subject_name":"科目一",
          	"subject_code":"km1",
          	"period":"2022-01",
          	"dimList":[{
              "dim_name":"部门",
              "dim_val_name":"A部门",
              "dim_val_code":"deptA"
            }]
        }]
    }
]

参数说明:

参数 类型 必填 说明
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) 支付方式
budget_name VARCHAR(100) 预算表名称
extColumns List 自定义字段集合
extColumns.ext_key VARCHAR(100) 自定义字段名称
extColumns.ext_col VARCHAR(100) 自定义字段key
extColumns.ext_value VARCHAR(4000) 自定义字段值(当字段类型为客户单选、商品单选、人员选择时,值为id)
extColumns.ext_value_code VARCHAR(100) 自定义字段值编码(当字段类型为客户单选、商品单选、人员选择时有值)
extColumns.ext_value_name VARCHAR(4000) 自定义字段值名称(当字段类型为客户单选、商品单选、人员选择时有值)
extColumns.ext_value_source_code 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) 项目编码
item_names VARCHAR(100) 付费项目名称
predict_sale_amount VARCHAR(32) 预计销售额
predict_effective_ratio VARCHAR(32) 预计费效比
project_name VARCHAR(100) 项目名称
plan_status VARCHAR(1) 方案状态。1:执行中,2:已终止,3:未开始,4:已结束
budget_dim_info List 关联预算信息列表
budget_dim_info.subject_name VARCHAR(100) 科目名称
budget_dim_info.subject_code VARCHAR(100) 科目编码
budget_dim_info.period VARCHAR(100) 期间
budget_dim_info.dimList List 预算动态维度
budget_dim_info.dimList.dim_name VARCHAR(100) 动态维度字段名称
budget_dim_info.dimList.dim_val_name VARCHAR(100) 预算动态维度值名称
budget_dim_info.dimList.dim_val_code VARCHAR(100) 预算动态维度值编码

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

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

请求方式: 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",
  "status":"",
    "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已作废
status CHAR(1) 删除状态:0-是 1-否
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":"万能促销活动-智能审批",
		"projectApplyCode":"",
		"applyId": "6415729603226401369",
		"applyCode":"SQ202202110010",
		"applicant":"韩煜",
		"applicantCode":"hanyu",
		"applicantSourceCode":"hanyu",
		"applicantId":"6415729603226401369",
		"applyTime":"2022-02-11 15:36:06",
		"projectCode":"",
		"projectName":"",
    "applyName":"",
    "parentApplyCode":"",
		"formDefinedId":null,
		"formDataId":null,
        "extColumns": [
                    {
                      "ext_key": "DT",
                    	"ext_col": "ext_2202230054",
                    	"ext_value": "2022-02-23"
                    },
                    {
                      "ext_key": "文本框12",
                    	"ext_col": "ext_2201060009",
                    	"ext_value": "Text"
                    }
                ],
		"subList":[
            {
                "subId": 7135551781356453533,
                "cusId": 6503181307801475589,
                "cusCode": null,
                "cusSourceCode": null,
                "cusName": null,
                "dealerId": null,
                "dealerCode": null,
                "dealerSourceCode": null,
                "dealerName": null,
              	"cmManagerName":"",
              	"cmManagerCode":"",
              	"cmManagerDept":"",
              	"settlementOrgName": "",
              	"settlementOrgCode":"",
                "startDate": "2022-02-08",
                "endDate": "2022-03-09",
              	"pdRangeType": "",
              	"pdTypesName": "",
              	"pdBrandsName": "",
                "pdIds": "",
              	"pdCodes" : "",
                "pdUnitName": null,
                "pdSale": null,
                "pdSalesVolume": null,
                "pdSalesAmount": null,
                "giftId": null,
                "giftUnitName": null,
                "giftPrice": null,
                "giftNum": null,
                "applyAmount": "2.00",
                "subject": null,
              	"subjectCode": null,
              	"itemName":"付费项目1",
              	"inputStandard":"3",
              	"inputNum":"1",
              	"joinCmNum":"5",
                "period": "2022-01",
                "dimJson": "[{\"dim_post_code\":\"021\",\"dim_post\":\"6113071556135396461\",\"dim_post_name\":\"QQ岗位\"}]",
				"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"
                    }
                ],
                "dimInfoList":[
                    {
                        "dimName":"岗位",
                        "dimCode":"WD0005",
                        "dimValCode":"021",
                        "dimValName":"QQ岗位"
                    }
                ]
            }
        ]
    }
]

参数说明:

参数 类型 必填 说明
applyId VARCHAR(32) 申请单ID
applyCode VARCHAR(32) 申请单编号
applicant VARCHAR(32) 申请人姓名
applicantId VARCHAR(32) 申请人id
applicantCode VARCHAR(32) 申请人账号
applicantSourceCode VARCHAR(32) 申请人三方id
applyTime VARCHAR(32) 申请创建时间。格式:yyyy-MM-dd HH:mm:ss
planId VARCHAR(32) 方案id
planCode VARCHAR(100) 方案编码
planName VARCHAR(100) 方案名称
projectApplyCode VARCHAR(32) 申请批号,按项目申请时有值
projectCode VARCHAR(32) 项目编码,按项目申请时有值
projectName VARCHAR(100) 项目名称,按项目申请时有值
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已作废
status CHAR(1) 删除状态:0-是 1-否
extColumns List 申请单自定义字段集合
extColumns.ext_key VARCHAR(100) 申请单自定义字段名称
extColumns.ext_col VARCHAR(100) 申请单自定义字段key
extColumns.ext_value VARCHAR(4000) 申请单自定义字段值(当字段类型为客户单选、商品单选、人员选择时,值为id)
extColumns.ext_value_code VARCHAR(100) 自定义字段值编码(当字段类型为客户单选、商品单选、人员选择时有值)
extColumns.ext_value_name VARCHAR(4000) 自定义字段值名称(当字段类型为客户单选、商品单选、人员选择时有值)
extColumns.ext_value_source_code VARCHAR(4000) 自定义字段值三方编码(当字段类型为客户单选、商品单选、人员选择时有值)
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.cmManagerId VARCHAR(100) 费用负责人id
subList.cmManagerCode VARCHAR(100) 费用负责人账号
subList.cmManagerName VARCHAR(100) 费用负责人姓名
subList.cmManagerSourceCode VARCHAR(100) 费用负责人三方id
subList.cmManagerDept VARCHAR(100) 费用负责人部门名称
subList.settlementOrgId VARCHAR(100) 结算单位id
subList.settlementOrgName VARCHAR(100) 结算单位名称
subList.settlementOrgSourceCode VARCHAR(100) 结算单位三方id
subList.settlementOrgCode VARCHAR(32) 结算单位编码
subList.startDate VARHCAR(32) 客户行活动开始时间。格式:yyyy-MM-dd
subList.endDate VARCHAR(32) 客户行活动结束时间。格式:yyyy-MM-dd
pdRangeType VARCHAR(32) 活动商品范围:0-和方案的活动商品一致 1-指定商品类型或品牌 2-指定具体商品
pdTypesName VARCHAR(4000) 活动商品类型(多个用英文下逗号分隔)
pdBrandsName VARCHAR(4000) 活动品牌(多个用英文下逗号分隔)
subList.pdIds VARCHAR(4000) 活动商品ID(支持多个,用英文下逗号分隔)
subList.pdNames VARCHAR(4000) 活动商品名称(支持多个,用英文下逗号分隔)
subList.pdSourceCodes VARCHAR(4000) 活动商品三方id(支持多个,用英文下逗号分隔)
subList.pdCodes VARCHAR(4000) 活动商品编码(支持多个,用英文下逗号分隔)
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.giftSourceCode VARCHAR(32) 赠品三方id
subList.giftUnitId VARCHAR(32) 赠品单位ID
subList.giftUnitName VARCHAR(100) 赠品单位
subList.giftPrice VARCHAR(32) 赠品价格
subList.giftNum VARCHAR(32) 赠品数量
subList.exeRequire VARCHAR(100) 执行要求
subList.settlementOrgCode VARCHAR(32) 结算单位编码
subList.applyAmount VARCHAR(32) 申请金额
subList.subject VARCHAR(100) 科目名称
subList.subjectCode VARCHAR(100) 科目编码
subList.period VARCHAR(32) 期间
subList.payType VARCHAR(100) 支付方式
subList.remark VARCHAR(4000) 备注
subList.cmReceiveId VARCHAR(32) 收货方id
subList.cmReceiveCode VARCHAR(32) 收货方编码
subList.cmReceiveName VARCHAR(32) 收货方名称
subList.cmReceiveSourceCode VARCHAR(32) 收货方三方id
subList.itemName VARCHAR(100) 付费项目名称
subList.inputStandard VARCHAR(32) 单位投放标准
subList.inputNum VARCHAR(32) 投放数量
subList.joinCmNum VARCHAR(32) 参与客户数
subList.extColumns List 列表
subList.extColumns.ext_key VARCHAR(100) 申请行自定义字段名称
subList.extColumns.ext_col VARCHAR(100) 申请行自定义字段key
subList.extColumns.ext_value VARCHAR(4000) 申请行自定义字段值(当字段类型为客户单选、商品单选、人员选择时 值为id)
subList.extColumns.ext_value_code VARCHAR(100) 申请行自定义字段值编码(当字段类型为客户单选、商品单选、人员选择时有值)
subList.extColumns.ext_value_name VARCHAR(4000) 申请行自定义字段值名称(当字段类型为客户单选、商品单选、人员选择时有值)
subList.extColumns.ext_value_source_code VARCHAR(4000) 申请行自定义字段值三方id(当字段类型为客户单选、商品单选、人员选择时有值)
subList.dimInfoList List 维度维值信息集合
subList.dimInfoList.dimCode VARCHAR(100) 维度编码
subList.dimInfoList.dimName VARCHAR(100) 维度名称
subList.dimInfoList.dimValCode VARCHAR(100) 维值编码
subList.dimInfoList.dimValName VARCHAR(100) 维值名称
subList.status VARCHAR(32) 删除状态 0-删除 1-未删除

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

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

请求方式: 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",
      "sye_code": "xwj",
      "project_code":"",
      "project_name":"",
      "arrive_lla": "江苏省南京市建邺区荷塘路",
      "arrive_pos_offset": "",
      "pos_is_normal":"",
      "comment_status": "未评价",
      "record_sys_id": "",
      "record_source_code": "",
      "record_sys_name": "",
      "record_sys_code": "",
      "comment_time": "",
      "comment_text": "",
      "re_comment_status": "未评价",
      "re_comment_text": "",
      "re_record_sys_id": "",
      "re_record_source_code": "",
      "re_record_sys_name": "",
      "re_record_sys_code": "",
      "re_comment_time": "",
      "visit_implement_id": "",
      "form_define_id": "5351617790943416943",
      "data_id": "5510726260281485832",
      "record_time": "2021-11-17 16:24:02",
      "status": "1",
      "ai_status": "0"
    }
]

参数说明:

参数 类型 必填 说明
record_id VARCHAR(32) 上报记录ID
sye_id VARCHAR(32) 上报人ID(勤策(原外勤365)的ID)
source_code VARCHAR(32) 上报人唯一标识(source_code)
sye_name VARCHAR(100) 上报人姓名
sye_code VARCHAR(100) 上报人编码
project_code VARCHAR(32) 项目编码
project_name VARCHAR(100) 项目名称
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
report_cm_id VARCHAR(32) 上报客户ID
report_cm_name VARCHAR(200) 上报客户名称
report_cm_code VARCHAR(32) 上报客户编码
report_cm_source_code VARCHAR(32) 上报客户source_code
arrive_lla VARCHAR(200) 上报地标信息。纠偏后的定位数据转换得到的地标信息
arrive_pos_offset NUMERIC(20,2) 和客户的偏差距离(米)。纠偏后的位置和客户纠偏后的位置的差值,当客户位置为空时,偏差距离为空
pos_is_normal VARCHAR(10) 位置异常状态:1-正常 0-异常
record_audit_form_id VARCHAR(32) 评价表单模板ID
comment_status VARCHAR(32) 初评状态(未评价/合格/不合格)
record_sys_id VARCHAR(32) 初评人ID(勤策的ID)
record_source_code VARCHAR(32) 初评人唯一标识(source_code)
record_sys_name VARCHAR(100) 初评人姓名
record_sys_code VARCHAR(100) 评价人编码
comment_time VARCHAR(32) 初评时间。格式:yyyy-MM-dd HH:mm:ss
comment_text VARCHAR(100) 初评意见
first_comment_data_id VARCHAR(32) 初评表单数据ID
re_comment_status VARCHAR(32) 复评状态(未评价/合格/不合格)
re_comment_text VARCHAR(100) 复评意见
re_record_sys_id VARCHAR(32) 复评人ID(勤策的ID)
re_record_source_code VARCHAR(32) 复评人唯一标识(source_code)
re_record_sys_name VARCHAR(100) 复评人姓名
re_record_sys_code VARCHAR(100) 复评人编码
re_comment_time VARCHAR(32) 复评时间。格式:yyyy-MM-dd HH:mm:ss
re_comment_data_id VARCHAR(32) 复评表单数据ID
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:正常
ai_status VARCHAR(32) AI评价结果。0:不合格,1:不合格

# 万能促销活动(TP)检核记录查询

接口说明:查询万能促销活动(TP)的检核记录

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

{
    "start_date": "2023-09-17",
    "end_date": "2023-12-31",
    "plan_code": "CX202307318196",
    "apply_code": "SQ202301060003",
    "cm_code": "CUS000031",
    "page_number": "1",
    "page_size": "10"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
start_date VARCHAR(32) 检核开始日期。格式:yyyy-MM-dd
end_date 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) 页长,不填默认1000

响应示例:

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

数据DATA示例:

[
  {
    "plan_id": "6445147899449803186",
    "plan_code": "CX202312048362",
    "plan_name": "",
    "activity_id": "9000198688039876999",
    "activity_code": "SQ202301060003",
    "activity_name": "",
    "detail_id": "4633868379900151647",
    "record_id": "5241891625803771680",
    "check_status": "1",
    "check_reason": "",
    "create_time": "2023-06-28 11:18:36",
    "emp_id": "6612621181315705500",
    "emp_source_code": "",
    "emp_name": "张三",
    "emp_code": "zhangsan",
    "cm_id": "5648775155194538306",
    "cm_source_code": "",
    "cm_name": "",
    "cm_code": "",
    "visit_implement_id": "7127420880237049147",
    "check_data_id": "5527536066870713568",
    "check_form_id": "5169892863426871104"
  }
]

参数说明:

参数 类型 必填 说明
plan_id VARCHAR(32) 活动方案ID
plan_code VARCHAR(32) 活动方案编码
plan_name VARCHAR(32) 活动方案名称
activity_id VARCHAR(32) 申请单ID
activity_code VARCHAR(100) 申请单号
activity_name VARCHAR(32) 申请名称
detail_id VARCHAR(32) 申请明细ID
record_id VARCHAR(32) 检核记录ID
check_status CHAR(1) 检核状态。0:不合格,1:合格
check_reason VARCHAR(1000) 不合格理由
create_time VARCHAR(32) 创建时间。格式:yyyy-MM-dd HH:mm:ss
emp_id VARCHAR(32) 创建人ID(勤策的ID)
emp_source_code VARCHAR(100) 创建人唯一标识(source_code)
emp_name VARCHAR(32) 创建人姓名
emp_code VARCHAR(32) 创建人编码
cm_id VARCHAR(32) 客户(门店)ID(勤策的ID)
cm_source_code VARCHAR(200) 客户(门店)唯一标识(source_code)
cm_name VARCHAR(200) 客户(门店)名称
cm_code VARCHAR(200) 客户(门店)编码
visit_implement_id VARCHAR(32) 拜访记录ID
check_data_id VARCHAR(32) 检核表单数据ID
check_form_id VARCHAR(32) 检核表单ID

# 万能促销活动(TP)结案单查询

接口说明:查询万能促销活动结案头信息数据。

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

{
  "create_start": "2023-01-01 00:00:00",
  "create_end": "2023-04-17 23:59:59",
  "modify_start": "",
  "modify_end": "",
  "close_code": "",
  "apply_code": "",
  "plan_code": "",
  "audit_status": "",
  "audit_start": "",
  "audit_end": "",
  "page_number":"1",
  "page_size":"100"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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
close_code VARCHAR(100) 结案单号。
apply_code VARCHAR(100) 申请单号。
plan_code VARCHAR(100) 方案编码。
audit_status VARCHAR(1) 审批状态。(0:处理中;1:已审批;2:已打回;3:审批中;)
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) 页长,不填默认1000

响应示例:

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

数据DATA示例:

[
  {
    "close_id": "8536160209542451312",
    "close_code": "JA202302200001",
    "plan_id": "5367628132117647812",
    "plan_code": "CX202302204384",
    "plan_name": "0220指定商品",
    "close_create_time": "2023-02-20 10:42",
    "close_creator_id": "8230823847295124348",
    "close_creator_name": "gaomeng",
    "close_apply_status": "1",
    "close_audit_id": "8230823847295124348",
    "close_audit_name": "gaomeng",
    "close_audit_time": "2023-02-20 10:43",
    "ext_data" : [
      {
        "ext_col": "ext_2206080088",
        "ext_key": "头-Num",
        "ext_value": "152"
      },
      {
        "ext_col": "ext_2206080090",
        "ext_key": "头-DT",
        "ext_value": "2023-04-10"
      },
      {
        "ext_col": "ext_2206080091",
        "ext_key": "头-多选",
        "ext_value": "[{\"name\":\"选项2杭州\",\"id\":\"选项2杭州\"},{\"name\":\"选项4上海\",\"id\":\"选项4上海\"}]"
      },
      {
        "ext_col": "ext_2206080092",
        "ext_key": "头-下拉",
        "ext_value": "[{\"name\":\"选项2pear\",\"id\":\"选项2pear\"}]"
      },
      {
        "ext_col": "ext_2206080093",
        "ext_key": "头-公式优先级",
        "ext_value": "183"
      },
      {
        "ext_value_code": "QQ-mendian-AAA15",
        "ext_value_name": "QQ-mendian-AAA15=name",
        "ext_col": "ext_2211010119",
        "ext_key": "头_客户单选",
        "ext_value": "QQ-mendian-AAA15=name"
      },
      {
        "ext_col": "ext_2301060144",
        "ext_key": "头-本身的公式计算",
        "ext_value": "165"
      },
      {
        "ext_col": "ext_2301110148",
        "ext_key": "头-「申请单模板」公式",
        "ext_value": "155.71"
      },
      {
        "ext_col": "ext_2206070082",
        "ext_key": "头-Text",
        "ext_value": "头-Text"
      },
      {
        "ext_col": "ext_2206070083",
        "ext_key": "头-附件",
        "ext_value": "[{\"srcName\":\"已结案客户20230408150122.xlsx\",\"src\":\"https://image-test.waiqin365.com/8215898327760841985/customerform/default/202304/202304101105588_1079ccd8a23e479d9929f9742aa8e271.xlsx\",\"filePath\":\"customerform/default/202304/202304101105588_1079ccd8a23e479d9929f9742aa8e271.xlsx\",\"dbPath\":\"8215898327760841985/customerform/default/202304/202304101105588_1079ccd8a23e479d9929f9742aa8e271.xlsx\",\"type\":\"xlsx\",\"url\":\"https://image-test.waiqin365.com/8215898327760841985/customerform/default/202304/202304101105588_1079ccd8a23e479d9929f9742aa8e271.xlsx\",\"uid\":\"customerform/default/202304/202304101105588_1079ccd8a23e479d9929f9742aa8e271.xlsx\",\"path\":\"customerform/default/202304/202304101105588_1079ccd8a23e479d9929f9742aa8e271.xlsx\",\"size\":7122,\"fileSize\":7122,\"name\":\"已结案客户20230408150122.xlsx\",\"tenantId\":\"8215898327760841985\",\"id\":\"customerform/default/202304/202304101105588_1079ccd8a23e479d9929f9742aa8e271.xlsx\"}]"
      },
      {
        "ext_col": "ext_2206080089",
        "ext_key": "头-多行",
        "ext_value": "头-多行"
      }
    ]
  }
]

参数说明:

参数 类型 必填 说明
close_id VARCHAR(32) 结案单ID
close_code VARCHAR(32) 结案单号
plan_id VARCHAR(32) 方案ID
plan_code VARCHAR(32) 方案编码
plan_name VARCHAR(100) 方案名称
close_create_time VARCHAR(100) 结案单创建时间,格式:yyyy-MM-dd HH:mm:ss
close_creator_id VARCHAR(32) 结案单创建人的员工id
close_creator_name VARCHAR(32) 结案单创建人姓名
close_apply_status VARCHAR(32) 审批状态(0:处理中;1:已审批;2:已打回;3:审批中;)
close_audit_id VARCHAR(32) 最近审批人id
close_audit_name VARCHAR(32) 最近审批人姓名
close_audit_time VARCHAR(32) 最近审批时间,格式:yyyy-MM-dd HH:mm:ss
ext_data List 结案单行自定义扩展字段列表
ext_data.ext_col VARCHAR(100) 结案单头自定义扩展字段key
ext_data.ext_key VARCHAR(100) 结案单头自定义扩展字段名称
ext_data.ext_value VARCHAR(100) 结案单头自定义扩展字段值
ext_data.ext_value_code VARCHAR(100) 结案单头自定义扩展字段值编码(当字段类型为客户单选、商品单选、人员选择时有值)
ext_data.ext_value_name VARCHAR(100) 结案单头自定义扩展字段值名称(当字段类型为客户单选、商品单选、人员选择时有值)

# 万能促销活动(TP)结案明细查询

接口说明:查询万能促销活动结案行信息数据。

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

{
  "apply_id": "6561786081227043096",
  "close_code": "",
  "plan_code": "",
  "page_number":"1",
  "page_size":"100"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
apply_id VARCHAR(100) 结案单ID。
close_code VARCHAR(100) 结案单号。
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示例:

[
  {
    "actual_amount": "41.00",
    "actual_sales_teu_num": "0.00",
    "upper_dealer_id": "",
    "apply_name": "",
    "upper_dealer_code": "",
    "actual_sales_amount": "0.00",
    "cm_code": "CUS000024",
    "actual_sales_ratio": "",
    "apply_code": "SQ202303090003",
    "close_remark": "",
    "upper_dealer_name": "",
    "cm_id": "5495909538717319010",
    "ext_data" : [
      {
        "ext_col": "ext_2206080096",
        "ext_key": "行-多行",
        "ext_value": ""
      },
      {
        "ext_col": "ext_2206080097",
        "ext_key": "行-公式优先级",
        "ext_value": "1321.93"
      },
      {
        "ext_col": "ext_2301100145",
        "ext_key": "行-「申请单模板」公式",
        "ext_value": ""
      },
      {
        "ext_col": "ext_2206070084",
        "ext_key": "行-Num",
        "ext_value": ""
      },
      {
        "ext_col": "ext_2206070085",
        "ext_key": "行-日期",
        "ext_value": ""
      },
      {
        "ext_col": "ext_2206070086",
        "ext_key": "行-多选",
        "ext_value": "[{\"name\":\"选项1\",\"id\":\"选项1\"},{\"name\":\"选项4\",\"id\":\"选项4\"}]"
      },
      {
        "ext_col": "ext_2206070087",
        "ext_key": "行-下拉",
        "ext_value": "[]"
      },
      {
        "ext_col": "ext_2206080095",
        "ext_key": "行-文本框",
        "ext_value": "JA202301100015"
      },
      {
        "ext_value_code": "CUS000026",
        "ext_value_name": "此客户有多个经销商",
        "ext_col": "ext_2211010120",
        "ext_key": "行_客户单选",
        "ext_value": "此客户有多个经销商"
      },
      {
        "ext_col": "ext_2211290143",
        "ext_key": "行-本身的公式计算",
        "ext_value": "13"
      }
    ],
    "cm_name": "001-002下级客户001",
    "apply_id": "8949075028169443086",
    "actual_sales_num": "0.00"
  }
]

参数说明:

参数 类型 必填 说明
apply_code VARCHAR(100) 申请单编号
apply_id VARCHAR(100) 申请行ID
apply_name VARCHAR(100) 申请名称
cm_code VARCHAR(100) 客户编码
cm_name VARCHAR(100) 客户名称
upper_dealer_code VARCHAR(32) 费用代垫经销商编码
upper_dealer_name VARCHAR(32) 费用代垫经销商名称
actual_amount VARCHAR(100) 结案金额
close_remark VARCHAR(100) 结案备注
actual_sales_num VARCHAR(32) 实际销量
actual_sales_teu_num VARCHAR(32) 实际销量(标箱)
actual_sales_amount VARCHAR(32) 实际销额
actual_sales_ratio VARCHAR(32) 实际费效比
ext_data List 结案单行自定义扩展字段列表
ext_data.ext_col VARCHAR(100) 结案单行自定义扩展字段key
ext_data.ext_key VARCHAR(100) 结案单行自定义扩展字段名称
ext_data.ext_value VARCHAR(100) 结案单行自定义扩展字段值
ext_data.ext_value_code VARCHAR(100) 结案单行自定义扩展字段值编码(当字段类型为客户单选、商品单选、人员选择时有值)
ext_data.ext_value_name VARCHAR(100) 结案单行自定义扩展字段值名称(当字段类型为客户单选、商品单选、人员选择时有值)

# 万能促销活动(AP/CP)申请单查询

接口说明:查询已提交的万能促销活动(AP/CP)的申请记录

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiao/v1/queryApCpActivities/{ 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",
    "status":"1",
    "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已作废
status CHAR(1) 删除状态:0-是 1-否
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示例:

[
    {
		"applyFormName":"申请单模板AAA",
		"activityId":"5460676379219624403",
		"activityCode":"SQ2931892831",
		"applicantCode": "shun",
		"applicantName":"顺",
		"applyTime":"2022-02-11 15:36:06",
		"modifyTime":"2022-02-11 15:36:06",
		"auditTime":"2022-02-11 15:36:06",
        "activityStatus":"1",
		"status":"1",
		"applyName":"申请名称AAA",
		"managerCode":"hts",
		"cmCode":"cuz001",
		"cmName":"客户001",
		"supplierCode":"sup001",
		"supplierName":"供应商001",
		"areaCode":"area001",
		"areaName":"活动场地001",
		"dealerCode":"cuz100",
		"dealerName":"经销商100",
		"startDate":"2023-05-01",
		"endDate":"2023-05-31",
		"expectArriveNum":"10",
		"pdNames":"商品001,商品002",
		"pdCodes":"pd001,pd002",
		"pdUnitName":"瓶",
		"activityPrice":"21.99",
		"pdSalesVolume":"2100.00",
		"pdSalesAmount":"100",
		"assignFormId":"54123128471131403",
		"holdAddress":"上海",
		"formDataId":"74718361488193105",
        "extColumns": [
                    {
                      "ext_key": "DT",
                    	"ext_col": "ext_2202230054",
                    	"ext_value": "2022-02-23"
                    },
                    {
                      "ext_key": "文本框12",
                    	"ext_col": "ext_2201060009",
                    	"ext_value": "2113aaa"
                    },
                     {
                       "ext_key": "人员单选01",
                        "ext_col": "ext_2201062918",
                        "ext_value": "8982234750855725016",
                        "ext_value_name": "黄体顺",
                        "ext_value_code": "hts",
                        "ext_value_source_code": "hts"
                     }
                ]
    }
]

参数说明:

参数 类型 必填 说明
applyFormName VARCHAR(100) 申请单模板名称
activityId VARCHAR(32) 申请单ID
activityCode VARCHAR(32) 申请单号
applicantId VARCHAR(32) 申请人id
applicantCode VARCHAR(32) 申请人登录账号
applicantName VARCHAR(100) 申请人姓名
applicantSourceCode VARCHAR(100) 申请人三方id
applyTime VARCHAR(32) 申请单创建时间。格式:yyyy-MM-dd HH:mm:ss
modifyTime VARCHAR(32) 最近修改时间。格式:yyyy-MM-dd HH:mm:ss
auditTime VARCHAR(32) 最新审批时间。格式:yyyy-MM-dd HH:mm:ss
activityStatus VARCHAR(32) 审批状态 0待审批、1已通过、2已打回、3审批中、4已作废
status CHAR(1) 删除状态:0-是 1-否
applyName VARCHAR(100) 申请名称
managerId VARCHAR(32) 负责人登录账号
managerCode VARCHAR(32) 负责人登录账号
managerName VARCHAR(32) 负责人姓名
managerSourceCode VARCHAR(32) 负责人三方id
cmId VARCHAR(32) 客户id
cmCode VARCHAR(32) 客户编码
cmSourceCode VARCHAR(32) 客户三方id
cmName VARCHAR(100) 客户姓名
areaCode VARCHAR(32) 活动场地编码
areaName VARCHAR(100) 活动场地名称
dealerId VARCHAR(32) 费用代垫经销商id
dealerCode VARCHAR(32) 费用代垫经销商编码
dealerSourceCode VARCHAR(32) 费用代垫经销商三方id
dealerName VARCHAR(100) 费用代垫经销商名称
supplierId VARCHAR(32) 供应商id
supplierCode VARCHAR(32) 供应商编码
supplierSourceCode VARCHAR(100) 供应商三方id
supplierName VARCHAR(100) 供应商名称
holdAddress VARCHAR(100) 举办地址
startDate VARCHAR(100) 执行开始日期。格式:YYYY-MM-DD
endDate VARCHAR(100) 执行结束日期。格式:YYYY-MM-DD
expectArriveNum VARCHAR(32) 预计到场人数
pdIds VARCHAR(100) 活动商品id多选用,分隔
pdCodes VARCHAR(100) 活动商品编码多选用,分隔
pdSourceCodes VARCHAR(100) 活动商品三方id多选用,分隔
pdNames VARCHAR(100) 活动商品名称多选用,分隔
pdUnitName VARCHAR(100) 商品单位名称
activityPrice VARCHAR(32) 活动价
pdSalesAmount VARCHAR(32) 预计销售额
pdSalesVolume VARCHAR(32) 预计销量
assignFormId VARCHAR(32) 申请叠加表单模板ID
formDataId VARCHAR(32) 申请叠加表单数据ID
extColumns List 申请单自定义字段集合
extColumns.ext_key VARCHAR(100) 申请单自定义字段名称
extColumns.ext_col VARCHAR(100) 申请单自定义字段key
extColumns.ext_value VARCHAR(4000) 申请单自定义字段值
extColumns.ext_value_code VARCHAR(100) 自定义字段值编码(当字段类型为客户单选、商品单选、人员选择时有值)
extColumns.ext_value_name VARCHAR(100) 自定义字段值名称(当字段类型为客户单选、商品单选、人员选择时有值)
extColumns.ext_value_source_code VARCHAR(100) 自定义字段值三方id(当字段类型为客户单选、商品单选、人员选择时有值)

# 万能促销活动(AP/CP)申请明细查询

接口说明:根据申请单号或申请ID查询申请明细记录

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

{
	"activity_id": "5460676379219624403",
	"activity_code": "SQ202111040012",
    "page_number": "1",
    "page_size": "10"
}

说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
activity_id VARCHAR(32) 申请单ID,申请单ID和申请单号不能全部为空
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示例:

[
  {
    "activityCmId": "7135551781356453533",
    "cmCode":"cuz001",
    "cmName":"客户001",
    "supplierCode":"sup001",
    "supplierName":"供应商001",
    "holdAddress":"上海",
    "areaCode":"area001",
    "areaName":"活动场地001",
    "dealerCode":"cuz100",
    "dealerName":"经销商100",
    "startDate":"2023-05-01",
    "endDate":"2023-05-31",
    "applyAmount": "2.00",
    "subjectName": "KM001",
    "subjectCode": "科目001",
    "period": "2023-01",
    "dimJson": "[{\"dim_post_code\":\"021\",\"dim_post\":\"6113071556135396461\",\"dim_post_name\":\"QQ岗位\"}]",
    "payType":"现金",
    "remark": "备注信息",
   "extColumns": [
                    {
                      "ext_key": "DT",
                        "ext_col": "ext_2202230054",
                        "ext_value": "2022-02-23"
                    },
                    {
                      "ext_key": "文本框12",
                        "ext_col": "ext_2201060009",
                        "ext_value": "2113aaa"
                    },
                     {
                       "ext_key": "人员单选01",
                        "ext_col": "ext_2201062918",
                        "ext_value": "8982234750855725016",
                        "ext_value_name": "黄体顺",
                        "ext_value_code": "hts",
                        "ext_value_source_code": "hts"
                     }
                ],
    "dimInfoList":[
        {
            "dimName":"岗位",
            "dimCode":"WD0005",
            "dimValCode":"021",
            "dimValName":"QQ岗位"
        }
    ]
  }
]

参数说明:

参数 类型 必填 说明
activityCmId VARCHAR(32) 客户申请明细ID
cmId VARCHAR(32) 客户id
cmCode VARCHAR(32) 客户编码
cmSourceCode VARCHAR(32) 客户三方id
cmName VARCHAR(100) 客户姓名
areaCode VARCHAR(32) 活动场地编码
areaName VARCHAR(100) 活动场地名称
dealerId VARCHAR(32) 费用代垫经销商id
dealerCode VARCHAR(32) 费用代垫经销商编码
dealerSourceCode VARCHAR(32) 费用代垫经销商三方id
dealerName VARCHAR(100) 费用代垫经销商名称
supplierId VARCHAR(32) 供应商id
supplierCode VARCHAR(32) 供应商编码
supplierSourceCode VARCHAR(32) 供应商三方id
supplierName VARCHAR(100) 供应商名称
holdAddress VARCHAR(100) 举办地址
startDate VARCHAR(100) 执行开始日期。格式:YYYY-MM-DD
endDate VARCHAR(100) 执行结束日期。格式:YYYY-MM-DD
payModeName VARCHAR(100) 支付方式名称
remark VARCHAR(4000) 备注
subjectName VARCHAR(100) 预算科目名称
subjectCode VARCHAR(100) 预算科目编码
period VARCHAR(32) 预算期间
applyAmount VARCHAR(32) 申请金额
extColumns List 申请单自定义字段集合
extColumns.ext_key VARCHAR(100) 申请行自定义字段名称
extColumns.ext_col VARCHAR(100) 申请行自定义字段key
extColumns.ext_value VARCHAR(4000) 申请行自定义字段值
extColumns.ext_value_code VARCHAR(100) 自定义字段值编码(当字段类型为客户单选、商品单选、人员选择时有值)
extColumns.ext_value_name VARCHAR(100) 自定义字段值名称(当字段类型为客户单选、商品单选、人员选择时有值)
extColumns.ext_value_source_code VARCHAR(100) 自定义字段值名称(当字段类型为客户单选、商品单选、人员选择时有值)
dimJson VARCHAR(32) 维度json
dimInfoList List 维度维值信息集合
dimInfoList.dimCode VARCHAR(100) 维度编码
dimInfoList.dimName VARCHAR(100) 维度名称
dimInfoList.dimValCode VARCHAR(100) 维值编码
dimInfoList.dimValName VARCHAR(100) 维值名称
status VARCHAR(32) 删除状态 0-删除 1-未删除

# 查询万能促销活动(AP/CP)上报记录

接口说明:查询万能促销活动(AP/CP)的上报记录

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiao/v1/queryRegularAPCPReport/{ 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",
    "activity_code": "SQ202306280003"
    "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
activity_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示例:

[
  {
    "comment_time": "2023-06-28 11:18:36",
    "re_comment_status": "合格",
    "last_modify_time": null,
    "re_comment_user_id": "9000198688039876999",
    "re_comment_user_name": "zt",
    "reporter_name": "小明",
    "reporter_code": "ssl",
    "reporter_id": "5241891625803771680",
    "activity_id": 5992791736592753121,
    "re_comment_user_source_code": null,
    "re_comment_text": "111122233",
    "report_form_template_id": "6612621181315705500",
    "re_comment_user_code": "zt",
    "comment_text": "1111222",
    "address": "江苏省南京市玄武区北京东路42-2号",
    "reporter_source_code": null,
    "address_dev": 7099289.000000,
    "comment_user_id": "9000198688039876999",
    "comment_user_code": "zt",
    "comment_status": "合格",
    "apply_line_id": 5527536066870713568,
    "report_form_data_id": "5169892863426871104",
    "comment_user_source_code": null,
    "comment_user_name": "zt",
    "report_time": "2023-06-27 14:38:51",
    "report_id": "7590946101051059800",
    "re_comment_time": "2023-06-28 11:19:12",
    "status": "1"
  }
]

参数说明:

参数 类型 必填 说明
report_id VARCHAR(32) 上报记录ID
report_time VARCHAR(32) 上报时间
reporter_id VARCHAR(32) 上报人ID
reporter_code VARCHAR(32) 上报人账号
reporter_name VARCHAR(100) 上报人姓名
reporter_source_code VARCHAR(32) 上报人对应外部数据ID
report_form_template_id VARCHAR(32) 上报表单模板ID
report_form_data_id VARCHAR(100) 上报表单数据ID
last_modify_time VARCHAR(32) 最近修改时间
status VARCHAR(32) 删除状态。0:删除,1:正常
address VARCHAR(200) 上报地标信息。纠偏后的定位数据转换得到的地标信息
address_dev NUMERIC(20,2) 偏差距离(米)。优先和活动场地的位置比对,当活动场地和客户位置都为空时,偏差距离为空
activity_id VARCHAR(32) 申请单ID
apply_line_id VARCHAR(32) 申请明细ID
comment_time VARCHAR(32) 初评时间。格式:yyyy-MM-dd HH:mm:ss
comment_user_id VARCHAR(32) 初评人ID
comment_user_code VARCHAR(32) 初评人账号
comment_user_name VARCHAR(100) 初评人姓名
comment_user_source_code VARCHAR(100) 初评人对应外部数据ID
comment_status VARCHAR(32) 初评结果
comment_text VARCHAR(100) 初评意见
re_comment_time VARCHAR(32) 复评时间。格式:yyyy-MM-dd HH:mm:ss
re_comment_user_id VARCHAR(32) 复评人ID
re_comment_user_code VARCHAR(32) 初评人账号
re_comment_user_name VARCHAR(100) 复评人姓名
re_comment_user_source_code VARCHAR(100) 复评人对应外部数据ID
re_comment_status VARCHAR(32) 复评结果
re_comment_text VARCHAR(100) 复评意见

# 万能促销活动(AP/CP)结案单查询

接口说明:查询万能促销活动(AP/CP)结案头信息数据。

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

{
  "create_start": "2023-01-01 00:00:00",
  "create_end": "2023-04-17 23:59:59",
  "modify_start": "",
  "modify_end": "",
  "close_code": "",
  "apply_code": "",
  "audit_status": "",
  "audit_start": "",
  "audit_end": "",
  "page_number":"1",
  "page_size":"100"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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
close_code VARCHAR(100) 结案单号
apply_code VARCHAR(100) 申请单号
audit_status VARCHAR(1) 审批状态(0:处理中;1:已审批;2:已打回;3:审批中;)
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) 页长,不填默认1000

响应示例:

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

数据DATA示例:

[
  {
    "close_id": "8536160209542451312",
    "close_code": "JA202302200001",
    "close_name": "0220指定商品",
    "close_create_time": "2023-02-20 10:42",
    "close_creator_code": "lisan",
    "close_creator_name": "李三",
    "close_apply_status": "1",
    "close_audit_code": "lisan",
    "close_audit_name": "李三",
    "close_audit_time": "2023-02-20 10:43",
    "ext_data" : [
      {
        "ext_col": "ext_2206070082",
        "ext_key": "头-Text",
        "ext_value": "头-Text"
      },
      {
        "ext_col": "ext_2206080091",
        "ext_key": "头-多选",
        "ext_value": "[{\"name\":\"选项2杭州\",\"id\":\"选项2杭州\"},{\"name\":\"选项4上海\",\"id\":\"选项4上海\"}]"
      },
      {
        "ext_col": "ext_2206080092",
        "ext_key": "头-下拉",
        "ext_value": "[{\"name\":\"选项2pear\",\"id\":\"选项2pear\"}]"
      },
      {
        "ext_col": "ext_2211010119",
        "ext_key": "头_客户单选",
        "ext_value": "QQ-mendian-AAA15=name",
        "ext_value_code": "QQ-mendian-AAA15",
        "ext_value_name": "QQ-mendian-AAA15=name"
      }
    ]
  }
]

参数说明:

参数 类型 必填 说明
close_id VARCHAR(32) 结案单ID
close_code VARCHAR(32) 结案单号
close_name VARCHAR(4000) 结案单名称
close_create_time VARCHAR(100) 结案单创建时间,格式:yyyy-MM-dd HH:mm:ss
close_creator_code VARCHAR(32) 结案单创建人的员工账号
close_creator_name VARCHAR(32) 结案单创建人姓名
close_apply_status VARCHAR(1) 审批状态(0:处理中;1:已审批;2:已打回;3:审批中;)
close_audit_code VARCHAR(32) 最近审批人的员工账号
close_audit_name VARCHAR(32) 最近审批人员工姓名
close_audit_time VARCHAR(32) 最近审批时间,格式:yyyy-MM-dd HH:mm:ss
ext_data List 结案单头自定义扩展字段列表
ext_data.ext_col VARCHAR(100) 结案单头自定义扩展字段key
ext_data.ext_key VARCHAR(100) 结案单头自定义扩展字段名称
ext_data.ext_value VARCHAR(100) 结案单头自定义扩展字段值
ext_data.ext_value_code VARCHAR(100) 结案单头自定义扩展字段值编码(当字段类型为客户单选、商品单选、人员选择时有值)
ext_data.ext_value_name VARCHAR(100) 结案单头自定义扩展字段值名称(当字段类型为客户单选、商品单选、人员选择时有值)

# 万能促销活动(AP/CP)结案明细查询

接口说明:查询万能促销活动(AP/CP)结案行信息数据。

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

{
  "apply_id": "6561786081227043096",
  "close_code": "JA202310070018",
  "page_number":"1",
  "page_size":"100"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
apply_id VARCHAR(100) 结案单ID
close_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示例:

[
  {
    "apply_code": "SQ202303090003",
    "apply_id": "8949075028169443086",
    "close_detail_id":"8862896120816363783",
    "apply_name": "",
    "apply_amount": "41.00",
    "cm_code": "CUS000024",
    "cm_name": "001-002下级客户001",
    "upper_dealer_code": "",
    "upper_dealer_name": "",
    "actual_amount": "",
    "close_remark": "",
    "ext_data" : [
      {
        "ext_col": "ext_2206080095",
        "ext_key": "行-文本框",
        "ext_value": "JA202301100015"
      },
      {
        "ext_col": "ext_2206070086",
        "ext_key": "行-多选",
        "ext_value": "[{\"name\":\"选项1\",\"id\":\"选项1\"},{\"name\":\"选项4\",\"id\":\"选项4\"}]"
      },
      {
        "ext_col": "ext_2206070087",
        "ext_key": "行-下拉",
        "ext_value": "[]"
      },
      {
        "ext_col": "ext_2211010120",
        "ext_key": "行_客户单选",
        "ext_value": "此客户有多个经销商",
        "ext_value_code": "CUS000026",
        "ext_value_name": "此客户有多个经销商"
      }
    ]
  }
]

参数说明:

参数 类型 必填 说明
apply_code VARCHAR(100) 申请单编号
apply_id VARCHAR(100) 申请行ID
close_detail_id VARCHAR(100) 结案行ID
apply_name VARCHAR(100) 申请名称
apply_amount VARCHAR(100) 申请金额
cm_code VARCHAR(100) 客户编码
cm_name VARCHAR(100) 客户名称
upper_dealer_code VARCHAR(32) 费用代垫经销商编码
upper_dealer_name VARCHAR(32) 费用代垫经销商名称
actual_amount VARCHAR(100) 结案金额
close_remark VARCHAR(100) 结案备注
ext_data List 结案单行自定义扩展字段列表
ext_data.ext_col VARCHAR(100) 结案单行自定义扩展字段编码
ext_data.ext_key VARCHAR(100) 结案单行自定义扩展字段名称
ext_data.ext_value VARCHAR(100) 结案单行自定义扩展字段值
ext_data.ext_value_code VARCHAR(100) 结案单行自定义扩展字段值编码(当字段类型为客户单选、商品单选、人员选择时有值)
ext_data.ext_value_name VARCHAR(100) 结案单行自定义扩展字段值名称(当字段类型为客户单选、商品单选、人员选择时有值)

# 品鉴会活动方案查询

请求方式: 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",
  	"plan_code":"",
    "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
plan_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示例:

[
    {
        "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/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:审批中,4:已作废
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": "汤姆布力波",
		"applicantCode": "tom",
		"applicantSourceCode": "tom_3rd",
		"applyRecordId": "9151325028676651599",
		"planCode": "CX202203154552",
		"customerName": "奥巴马要考虑国际化和多选情况多选奥巴马奥巴马奥巴马奥巴马奥巴马奥巴马奥巴马奥巴马奥巴马",
		"customerSourceCode": "aobama_3rd",
		"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) 申请人名称
applicantCode VARCHAR(100) 申请人编码(账号)
applicantSourceCode VARCHAR(100) 申请人三方id
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:审批中,4:已作废
deleteStatus VARCHAR(32) 删除状态。1:未删除,0:已删除
planCode VARCHAR(100) 方案编码
planName VARCHAR(100) 方案名称
customerId VARCHAR(32) 客户ID
customerCode VARCHAR(100) 客户编码
customerName VARCHAR(100) 客户名称
customerSourceCode VARCHAR(100) 客户三方id
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.productId VARCHAR(100) 商品id
activityPdList.productName VARCHAR(100) 商品名称
activityPdList.productSourceCode VARCHAR(100) 商品三方id
activityPdList.applyNum NUMERIC 预计数量。最大20位数字
activityPdList.basicUnit VARCHAR(32) 基本单位

# 品鉴会上报记录查询

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

请求方式: 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":"",
        "re_record_code":"",
        "sye_name":"QQ查看所有",
        "sye_id":"5397154835002159969",
        "cm_code":"11020200",
        "record_sys_name":"",
        "record_sys_code":"",
        "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",
        "cm_source_code":"celue_source_code01",
        "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) 客户编码
cm_source_code VARCHAR(32) 客户三方id
record_id VARCHAR(32) 上报记录ID
report_source_code CHAR(1) 上报来源。1:客户自主上报,2:业代上报
sye_id VARCHAR(32) 上报人ID(勤策的ID)
sye_code VARCHAR(32) 上报人编码
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(勤策的ID)
record_sys_code VARCHAR(32) 评价人编码
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(勤策的ID)
re_record_code VARCHAR(32) 复评人编码
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/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",
  	"plan_code":"",
    "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
plan_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示例:

[
    {
        "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": "无尽之刃",
                "id": "24124366041987",
                "source_code": "无尽之刃"
            }
        ],
        "start_date": "2022-08-17",
        "allow_area": [
          {
           "province_code": "320000",
           "province_name": "江苏省",
           "city_code": "320100",
           "city_name": "南京市",
           "district_code": "",
           "district_name": ""
          }
        ],
        "apply_start_date": "2022-08-10",
        "apply_end_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 List 列表
pds.code VARCHAR(100) 活动商品编码
pds.name VARCHAR(100) 活动商品名称
pds.id VARCHAR(100) 活动商品id
pds.source_code VARCHAR(100) 活动商品三方id
allow_wine_back VARCHAR(32) 允许用酒退码: 0-否,1-是
allow_area[].province_code VARCHAR(100) 宴席开展区域省份编码
allow_area[].province_name VARCHAR(100) 宴席开展区域省份名称
allow_area[].city_code VARCHAR(100) 宴席开展区域城市编码
allow_area[].city_name VARCHAR(100) 宴席开展区域城市名称
allow_area[].district_code VARCHAR(100) 宴席开展区域区县编码
allow_area[].district_name VARCHAR(100) 宴席开展区域区县名称
apply_start_date VARCHAR(32) 申请开始日期
apply_end_date VARCHAR(32) 申请截止日期
flow_status VARCHAR(32) 审批状态:0-处理中、1-已批准、2-已打回、3-审批中

# 宴席申请记录查询

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

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/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:审批中,4:已作废
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": [
			{
				"productId": "1001000097",
				"productCode": "1001000097",
				"productSourceCode": "code_001",
				"useTypeName": "公司赞助",
				"basicUnit": "件",
				"applyNum": 3,
				"productName": "BC端宴会==码中台"
			}
		],
		"deleteStatus": "1",
		"customerId": "6806582156885106531",
		"extFieldsInfo": "[{\"column\":\"自定义字段名\",\"key\":\"ext_2203280067\",\"value\":\"hhh\"}]",
		"applicantId": "7002401310724831087",
		"approvalStatus": "1",
		"feastType": "公司年会",
		"dealerName": "法人刘昭",
		"dealerSourceCode": "del_source_001",
		"executorId": "8717688507269859633",
		"executorCode": "shun",
		"executorSourceCode": "shun_source",
		"dealerId": "5102106230943924527",
		"applicantName": "shun",
		"applicantCode": "shun",
		"applicantSourceCode": "shun_source",
		"applyRecordId": "7719558126269131824",
		"planCode": "CX202204133826",
		"feastStartDate": "2022_04_07",
		"hostContact": "13689748942",
		"customerName": "0529测试三要素",
		"customerSourceCode": "source_code_cm_001",
		"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,
        "provinceCode": "320000",
        "provinceName": "江苏省",
        "cityCode": "320100",
        "cityName": "南京市",
        "districtCode": "320104",
        "districtName": "秦淮区",
        "currentPosition": {
          "address": "江苏省南京市建邺区沙洲街道康文路康缘智汇港附近",
          "longitude": 118.73077,
          "latitude": 31.983762
              }
	}
]

参数说明:

参数 类型 必填 说明
applyRecordId VARCHAR(32) 申请记录ID
applyRecordCode VARCHAR(100) 申请单号
applicantId VARCHAR(32) 申请人ID
applicantName VARCHAR(100) 申请人名称
applicantCode VARCHAR(100) 申请人编码
applicantSourceCode VARCHAR(100) 申请人三方id
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:审批中,4:已作废
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) 举办地址
provinceCode VARCHAR(100) 举办地行政区域-省份编码
provinceName VARCHAR(100) 举办地行政区域-省份名称
cityCode VARCHAR(100) 举办地行政区域-城市编码
cityName VARCHAR(100) 举办地行政区域-城市名称
districtCode VARCHAR(100) 举办地行政区域-区县编码
districtName VARCHAR(100) 举办地行政区域-区县名称
predictJoinNum NUMERIC 预计开展桌数
executorId VARCHAR(32) 执行人ID
executorName VARCHAR(100) 执行人姓名
executorCode VARCHAR(100) 执行人编码
executorSourceCode VARCHAR(100) 执行人三方id
customerId VARCHAR(32) 供货方ID
customerCode VARCHAR(100) 供货方编码
customerName VARCHAR(100) 供货方名称
customerSourceCode VARCHAR(100) 供货方三方id
dealerId VARCHAR(32) 费用代垫经销商ID
dealerCode VARCHAR(100) 费用代垫经销商编码
dealerName VARCHAR(100) 费用代垫经销商名称
dealerSourceCode VARCHAR(100) 费用代垫经销商三方id
remark VARCHAR(1000) 备注
extFieldsInfo VARCHAR(1000) 自定义字段,格式为list,一个自定义字段有三个column、key、value
activityPdList List 商品列表明细
activityPdList.productId VARCHAR(100) 商品id
activityPdList.productCode VARCHAR(100) 商品编码
activityPdList.productSourceCode VARCHAR(100) 商品三方id
activityPdList.productName VARCHAR(100) 商品名称
activityPdList.applyNum NUMERIC 预计数量。最大20位数字
activityPdList.basicUnit VARCHAR(32) 基本单位
activityPdList.useTypeName VARCHAR(100) 用酒类型
currentPosition Object 实时位置信息
currentPosition.address VARCHAR(32) 举办地点地标
currentPosition.longitude NUMERIC 经度
currentPosition.latitude NUMERIC 纬度

# 宴席扫码记录查询

请求方式: 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",
        "creator_id": "5434581345345",
        "creator_source_code": "hutao_source_code1",
        "id": "5853887678538238175",
        "activity_code": "SQ202208250001",
        "rows": [
            {
                "unit_name": "瓶",
                "scan_code": "12345689",
                "wine_type_name": "公司赞助",
                "pd_name": "红药水",
                "pd_source_code": "source_code_pd001",
                "pd_id": "715020522572354234",
                "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 List 列表
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) 码单位

# 宴席上报记录查询

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

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/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": "韩煜",
		"sye_source_code": "hanyu_source_code",
		"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(勤策的ID)
source_code VARCHAR(32) 上报人唯一标识(source_code)
sye_name VARCHAR(32) 上报人姓名
sye_source_code VARCHAR(32) 上报人三方id
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/cuxiaoTpm/v1/queryFeastCommentRecord/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

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

参数说明:

参数 类型 必填 说明
create_start VARCHAR(32) 开始时间格式:yyyy-MM-dd HH:mm:ss。限制创建时间
create_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示例:

[
  {
    "activity_id": "5006720526795851408",
    "activity_code": "SQ202202150006",
    "record_id": "5566516156928682871",
    "comment_step": "1",
    "comment_status": "0",
    "comment_user_id": "9095203782926465726",
    "comment_user_source_code": "zhangsan_source_code",
    "comment_user_name": "张三",
    "comment_user_code": "zhangsan",
    "comment_time": "2022-03-15 10:48:32",
    "comment_text": "",
    "comment_form_id": "5095203842926411926",
    "comment_data_id": "9066002301057603178"
  }
]

参数说明:

参数 类型 必填 说明
activity_id VARCHAR(100) 活动申请ID
activity_code VARCHAR(32) 活动申请单号
record_id VARCHAR(32) 上报记录ID
comment_step VARCHAR(32) 评价类型:1-初评、2-复评
comment_status VARCHAR(32) 评价状态(合格/不合格)
comment_user_id VARCHAR(32) 评价人ID(勤策的ID)
comment_user_source_code VARCHAR(32) 评价人唯一标识(source_code)
comment_user_name VARCHAR(100) 评价人姓名
comment_user_code VARCHAR(100) 评价人编码
comment_time VARCHAR(32) 评价时间。格式:yyyy-MM-dd HH:mm:ss
comment_text VARCHAR(100) 评价意见
comment_form_id VARCHAR(32) 评价表单模板ID
comment_data_id VARCHAR(32) 评价表单数据ID

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

请求方式: 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/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:待提交,4:已作废
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":"",
                        "subject_id": "5801838256916366668",
                        "subject_code": "KM001",
                        "subject_name": "科目一",
                        "period": "2022-11",
                        "budget_dim_info": "[{\"dim_terminal\":\"6654559197856369172\",\"dim_terminal_name\":\"蔚\"},{\"dim_customer_name\":\"薇恩\",\"dim_customer\":\"4847308782274217093\"}]",
                        "sub_data":[

                        ],
                        "dim_info_list":[
                            {
                                "dimName":"商品",
                                "dimValueName":"52°水晶剑南春(558)20版[558×1×6]",
                                "dimCode":"WD0004",
                                "dimValueCode":"1001000268"
                            },
                            {
                                "dimName":"部门",
                                "dimValueName":"全公司",
                                "dimCode":"ZD0007",
                                "dimValueCode":"001"
                            }
                        ]
                    }
                ],
                "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":"",
                "remark":"申请行备注"
            }
        ],
        "create_time":"2020-04-20 09:36",
        "creator_id":"6757956879757257691",
        "creator_code":"zhangsan",
        "creator_name":"张三",
        "creator_source_code":"zhangsan_source_code01",
        "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
creator_code VARCHAR(32) 活动申请人编码(账号)
creator_name VARCHAR(32) 活动申请人姓名
creator_source_code 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_id VARCHAR(32) 经销商id
cm.upper_dealer_code VARCHAR(32) 经销商编码
cm.upper_dealer_name VARCHAR(200) 经销商名称
cm.upper_dealer_source_code VARCHAR(200) 经销商三方id
cm.linkman_mobile VARCHAR(32) 客户主联系人手机号
cm.linkman VARCHAR(100) 客户主联系人姓名
cm.cm_name VARCHAR(200) 客户名称
cm.cm_code VARCHAR(32) 客户编码
cm.cm_source_code VARCHAR(32) 客户三方id
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.remark VARCHAR(4000) 客户申请行备注
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.subject_id VARCHAR(32) 科目id
cm.pro.subject_code VARCHAR(32) 科目编码
cm.pro.subject_name VARCHAR(100) 科目名称
cm.pro.period VARCHAR(32) 期间
cm.pro.budget_dim_info VARCHAR(1000) 维度信息,jsonArray格式(单个元素中 dim_xxx 动态维度数据id, dim_xxx_name 动态维度名称)
cm.pro.protocol_pay_money NUMERIC 协议兑付金额
cm.pro.dim_info_list List 维值信息集合
cm.pro.dim_info_list.dimCode VARCHAR(32) 维度编码
cm.pro.dim_info_list.dimName VARCHAR(32) 维度名称
cm.pro.dim_info_list.dimValueCode VARCHAR(32) 维值编码
cm.pro.dim_info_list.dimValueName VARCHAR(32) 维值名称
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/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/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示例:

[
    {
        "status": "1",
        "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",
        "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",
        "cm_code":"CUS000121",
        "cm_source_code":"CUS000121_3rd",
        "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",
		"ai_status": "0"
    }
]

参数说明:

参数 类型 必填 说明
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) 客户编码
cm_source_code VARCHAR(32) 客户三方id
record_id VARCHAR(32) 上报记录ID
report_source_code CHAR(1) 上报来源。1:客户自主上报,2:业代上报
sye_id VARCHAR(32) 上报人ID(勤策的ID)
source_code VARCHAR(32) 上报人唯一标识(source_code)
sye_name VARCHAR(100) 上报人姓名
sye_code 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(勤策的ID)
record_sys_code VARCHAR(32) 评价人编码(账号)
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(勤策的ID)
re_record_code VARCHAR(32) 复评人编码(账号)
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:正常
ai_status VARCHAR(32) AI评价结果。0:不合格,1:合格

# 付费陈列和市场活动检核记录查询

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

请求方式: 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": "张三",
    "emp_code": "zhangsan",
    "emp_source_code": "zhangsan_sourcecode",
    "cm_id": " 5277027684278203306",
    "cm_name": "大润发龙江店",
    "cm_code": "CUS000212",
    "cm_source_code": "darunfa01_sourcecode",
    "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(勤策的ID)
emp_source_code VARCHAR(100) 上报人唯一标识(source_code)
emp_name VARCHAR(32) 上报人姓名
emp_code VARCHAR(32) 上报人编码
cm_id VARCHAR(32) 客户(门店)ID(勤策的ID)
cm_source_code VARCHAR(200) 客户(门店)唯一标识(source_code)
cm_name VARCHAR(200) 客户(门店)名称
cm_code 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/queryCloseCase/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "page_number": "1",
    "page_size": "10",
    "audit_start":"2021-06-10 00:00:00",
    "audit_end":"2021-06-30 00:00:00",
    "create_start":"2021-06-10 00:00:00",
    "create_end":"2021-06-30 00:00:00",
    "plan_code":"CX202401019988"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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
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
audit_status VARCHAR(32) 审批状态。(0:处理中;1:已审批;2:已打回;3:审批中)。如不传,默认返回审批通过状态的数据
close_code VARCHAR(32) 结案单号
apply_code VARCHAR(32) 申请单号
plan_code VARCHAR(32) 方案编码

响应示例:

{
    "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/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",
  	"plan_code":"",
    "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
plan_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示例:

[
    {
        "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/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",
		"creatorCode":"zhangsan",
		"creatorName":"张三",
		"creatorSourceCode":"zhangsan_source_code01",
		"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":"[]",
                "dimInfoList":[
                            {
                                "dimName":"商品",
                                "dimValueName":"52°水晶剑南春(558)20版[558×1×6]",
                                "dimCode":"WD0004",
                                "dimValueCode":"1001000268"
                            },
                            {
                                "dimName":"部门",
                                "dimValueName":"全公司",
                                "dimCode":"ZD0007",
                                "dimValueCode":"001"
                            }
                        ],
				"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":"",
                "subjectCode":"",
				"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
creatorCode VARCHAR(32) 申请人编码
creatorName VARCHAR(32) 申请人姓名
creatorSourceCode 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.subjectCode VARCHAR(100) 科目编码
efCmDetailDto.subjectName VARCHAR(100) 科目名称
efCmDetailDto.period VARCHAR(100) 期间
efCmDetailDto.budgetDimInfo VARCHAR(4000) 维度json
efCmDetailDto.dimInfoList List 维值信息集合
efCmDetailDto.dimInfoList.dimCode VARCHAR(32) 维度编码
efCmDetailDto.dimInfoList.dimName VARCHAR(32) 维度名称
efCmDetailDto.dimInfoList.dimValueCode VARCHAR(32) 维值编码
efCmDetailDto.dimInfoList.dimValueName VARCHAR(32) 维值名称
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/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,
      "sye_code": "xwj14",
      "source_code": "",
      "sye_name": "xwj14",
      "arrive_lla": "江苏省南京市建邺区荷塘路",
      "arrive_pos_offset": "",
      "comment_status": "未评价",
      "record_sys_id": "",
      "record_sys_code": "",
      "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_record_code": "",
      "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(勤策的ID)
source_code VARCHAR(32) 上报人唯一标识(source_code)
sye_name VARCHAR(100) 上报人姓名
sye_code VARCHAR(100) 上报人编码
arrive_lla VARCHAR(200) 上报地标信息。纠偏后的定位数据转换得到的地标信息
arrive_pos_offset NUMERIC(20,2) 和客户的偏差距离(米)。纠偏后的位置和客户纠偏后的位置的差值,当客户位置为空时,偏差距离为空
comment_status VARCHAR(32) 评价状态("":未评价,1:合格,0:不合格)
record_sys_id VARCHAR(32) 评价人ID(勤策的ID)
record_source_code VARCHAR(32) 评价人唯一标识(source_code)
record_sys_name VARCHAR(100) 评价人姓名
record_sys_code 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(勤策的ID)
re_record_source_code VARCHAR(32) 复评人唯一标识(source_code)
re_record_name VARCHAR(100) 复评人姓名
re_record_code 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/queryCloseCaseHeadOfEntrance/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
  "create_start": "2023-01-01 00:00:00",
  "create_end": "2023-04-17 23:59:59",
  "modify_start": "",
  "modify_end": "",
  "close_code": "",
  "apply_code": "",
  "plan_code": "",
  "audit_status": "",
  "audit_start": "",
  "audit_end": "",
  "page_number":"1",
  "page_size":"100"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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
close_code VARCHAR(100) 结案单号。
apply_code VARCHAR(100) 申请单号。
plan_code VARCHAR(100) 方案编码。
audit_status VARCHAR(1) 审批状态。(0:处理中;1:已审批;2:已打回;3:审批中;)
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) 页长,不填默认1000

响应示例:

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

数据DATA示例:

[
  {
    "close_id": "4955792534503344463",
    "close_code": "JA202211140001",
    "close_apply_status": "1",
    "close_audit_name": "刀妹",
    "plan_code": "JCF202209284923",
    "close_creator_name": "刀妹",
    "plan_name": "708-进场费结案-hts",
    "close_audit_time": "2023-02-20 10:42",
    "close_create_time": "2023-02-20 10:43",
    "close_audit_id": "4883362607570892159",
    "plan_id": "9158455430703301647",
    "close_creator_id": "4883362607570892159"
  }
]

参数说明:

参数 类型 必填 说明
close_id VARCHAR(32) 结案单ID
close_code VARCHAR(32) 结案单号
plan_id VARCHAR(32) 方案ID
plan_code VARCHAR(32) 方案编码
plan_name VARCHAR(100) 方案名称
close_create_time VARCHAR(100) 结案单创建时间,格式:yyyy-MM-dd HH:mm:ss
close_creator_id VARCHAR(32) 结案单创建人的员工id
close_creator_name VARCHAR(32) 结案单创建人姓名
close_apply_status VARCHAR(32) 审批状态(0:处理中;1:已审批;2:已打回;3:审批中;)
close_audit_id VARCHAR(32) 最近审批人id
close_audit_name VARCHAR(32) 最近审批人姓名
close_audit_time VARCHAR(32) 最近审批时间,格式:yyyy-MM-dd HH:mm:ss

# 进场费结案明细查询

接口说明:查询进场费结案行信息数据。

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

{
  "apply_id": "6561786081227043096",
  "close_code": "",
  "plan_code": "",
  "page_number":"1",
  "page_size":"100"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
apply_id VARCHAR(100) 结案单ID。
close_code VARCHAR(100) 结案单号。
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示例:

[
  {
    "entrance_store_num": "1",
    "entrance_time": "",
    "actual_amount": "0.00",
    "upper_dealer_id": "",
    "upper_dealer_code": "",
    "exec_cycle": "2022-09-27至2022-09-27",
    "cm_code": "CUS000013",
    "apply_code": "SQ202209280005",
    "close_remark": "",
    "upper_dealer_name": "",
    "cm_id": "5593391623386071075",
    "cm_name": "男枪",
    "store_total_entrance_fee": "100.00",
    "apply_id": "4857250146151189336",
    "total_store_money": "",
    "single_store_entrance_fee": "100.00"
  }
]

参数说明:

参数 类型 必填 说明
apply_code VARCHAR(100) 申请单编号
apply_id VARCHAR(100) 申请行ID
cm_code VARCHAR(100) 客户编码
cm_name VARCHAR(100) 客户名称
upper_dealer_code VARCHAR(32) 费用代垫经销商编码
upper_dealer_name VARCHAR(32) 费用代垫经销商名称
exec_cycle VARCHAR(32) 执行周期
entrance_time VARCHAR(32) 进场时间
entrance_store_num VARCHAR(32) 申请进场门店数
single_store_entrance_fee VARCHAR(32) 单店申请金额
store_total_entrance_fee VARCHAR(32) 申请总金额
total_store_money VARCHAR(32) 系统结案金额
actual_amount VARCHAR(100) 结案金额
close_remark VARCHAR(100) 结案备注

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

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

请求方式: 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:审批中,4:已作废
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":"张三",
        "applyId":"54606289555563161320",
        "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"
            }
        ]
    }
]

参数说明:

参数 类型 必填 说明
applyId VARCHAR(32) 申请单ID
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) 申请人名称
applierId VARCHAR(100) 申请人id
applierCode VARCHAR(100) 申请人编码
applierSourceCode VARCHAR(100) 申请人三方id
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.cusId VARCHAR(32) 客户id
subList.cusCode VARCHAR(32) 客户编码
subList.cusSourceCode VARCHAR(32) 客户三方id
subList.cusName VARCHAR(100) 客户或者连锁品牌名称
subList.subType VARCHAR(1) 申请明细类型。1:客户,2:连锁品牌
subList.dealerId VARCHAR(32) 费用代垫经销商id
subList.dealerCode VARCHAR(32) 费用代垫经销商编码
subList.dealerSourceCode VARCHAR(32) 费用代垫经销商三方id
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/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/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:审批中,4:已作废
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":"李四",
        "applyId":"8376087797504218798",
        "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"
            }
        ]
    }
]

参数说明:

参数 类型 必填 说明
applyId VARCHAR(32) 申请单ID
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) 申请人名称
applierId VARCHAR(100) 申请人编码
applierCode VARCHAR(100) 申请人三方id
applierSourceCode 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-审批中 4-已作废
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.cusId VARCHAR(32) 客户id
subList.cusCode VARCHAR(32) 客户编码
subList.cusSourceCode VARCHAR(32) 客户三方id
subList.cusName VARCHAR(100) 客户或者连锁品牌名称
subList.dealerId VARCHAR(32) 费用代垫经销商id
subList.dealerCode VARCHAR(32) 费用代垫经销商编码
subList.dealerSourceCode VARCHAR(32) 费用代垫经销商三方id
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/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/project/v1/queryProject/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "startTime": "2017-01-10 00:00:00",
    "endTime": "2022-02-28 00:00:00",
    "auditStartTime": "2017-01-10 00:00:00",
    "auditEndTime": "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
auditStartTime VARCHAR(32) 审批通过开始时间。格式:yyyy-MM-dd HH:mm:ss
auditEndTime 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",
        "create_time": "2022-03-15 15:26",
        "audit_time": "2022-03-15 15:26",
        "director_id": "1111123",
        "director_code": "zhangsan",
        "director_source_code": "zhangsan3rd",
        "public_flag": "1",
        "project_status": "1",
        "status": "1",
        "director_name": "boss",
        "project_code": "XM2022033605",
        "project_name": "项目名称001",
        "project_description": "项目描述001",
		"parent_project_code":"",
		"parent_project_name":"",
        "exts":[
          {
            "ext_code":"ext_202202221212",
            "ext_name":"人员选择",
            "ext_value":"30128312380123",
            "ext_value_code":"zhangsan",
            "ext_value_name":"张三",
            "ext_value_source_code":"zhangsan3rd"
          }
        ]
    }
]

参数说明:

参数 类型 必填 说明
project_code VARCHAR(100) 项目编码
project_name VARCHAR(100) 项目名称
project_exe_cycle VARCHAR(32) 项目周期,起止日期以~分隔,日期格式:yyyy-MM-dd
budget_org_code VARCHAR(100) 预算组织编码
budget_org_name VARCHAR(100) 预算组织名称
director_id VARCHAR(100) 项目负责人id
director_code VARCHAR(100) 项目负责人账号/编码
director_name VARCHAR(100) 项目负责人姓名
director_source_code VARCHAR(100) 项目负责人第三方id
public_flag VARCHAR(100) 是否公示1-是 0否
modify_time VARCHAR(100) 最近修改时间。格式:yyyy-MM-dd HH:mm:ss
create_time VARCHAR(100) 创建时间。格式:yyyy-MM-dd HH:mm:ss
audit_time VARCHAR(100) 审批通过时间。格式:yyyy-MM-dd HH:mm:ss
project_status VARCHAR(100) 审批状态。1-已审批
status VARCHAR(100) 删除状态。1-未删除 0-已删除
parent_project_code VARCHAR(100) 父项目编码
parent_project_name VARCHAR(100) 父项目名称
exts LIST 自定义字段
exts.ext_code VARCHAR(100) 自定义字段编码
exts.ext_name VARCHAR(100) 自定义字段名
exts.ext_value VARCHAR(100) 自定义字段值 e.g.当为人员/商品/客户控件时 此值为人员/商品/客户名称的id
exts.ext_value_code VARCHAR(100) 自定义字段值对应的编码 e.g.如果自定义字段是人员/商品/客户,则该字段响应的是人员/商品/客户编码
exts.ext_value_name VARCHAR(100) 自定义字段值对应的名称 e.g.如果自定义字段是人员/商品/客户,则该字段响应的是人员/商品/客户名称
exts.ext_value_source_code VARCHAR(100) 自定义字段值对应的三方系统ID e.g.如果自定义字段是人员/商品/客户,则该字段响应的是人员/商品/客户三方系统ID

# 供应商查询

接口说明:查询供应商数据,包括删除的数据

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

{
    "createStartTime": "2023-01-01",
    "createEndTime": "2023-01-31",
    "modifyStartTime": "2023-01-01",
    "modifyEndTime": "2023-01-31",
    "pageNumber": "1",
    "pageSize": "100",
    "enable": "1",
    "status": "1",
    "id": "4789759081208984580",
    "code": "GYS001",
    "sourceCode": "A1001"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
createStartTime VARCHAR(32) 创建开始时间。格式:yyyy-MM-dd
createEndTime VARCHAR(32) 创建结束时间。格式:yyyy-MM-dd
modifyStartTime VARCHAR(32) 修改开始时间。格式:yyyy-MM-dd
modifyEndTime VARCHAR(32) 修改结束时间。格式:yyyy-MM-dd
pageNumber VARCHAR(32) 页码,不填默认第一页
pageSize VARCHAR(32) 页长,不填默认1000
enable VARCHAR(32) 停用状态。 0-已停用 1-正常
status VARCHAR(32) 删除状态。 0-删除 1-正常
id VARCHAR(32) 勤策供应商ID
sourceCode VARCHAR(100) 来源第三方系统的唯一ID
code VARCHAR(100) 供应商编码,精准匹配

响应示例:

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

数据DATA示例:

[
    {
      "id": "6309024315330045514",
      "source_code": "A1001",
      "code": "GYS001",
      "name":"供应商001",
      "address": "南京夫子庙",  
      "concatName": "张三",
      "concatPhone":"13298120110",
      "remark":"这是个备注",
      "enable":"1",
      "status": "1",
      "createTime": "2022-12-01 12:00",
      "modifyTime": "2022-12-01 13:00",
      "extColumns":[{
           "ext_key":"自定义文本",
            "ext_col": "ext_82731831",
           "ext_value":"哈哈哈"
       },
        {
           "ext_key":"自定义多选",
           "ext_col": "ext_82731833",
           "ext_value":"选项2#选项3"
       }]
    }
]

参数说明:

参数 类型 必填 说明
sourceCode VARCHAR(32) 来源第三方系统的唯一ID
id VARCHAR(32) 勤策系统ID
code VARCHAR(32) 供应商编码
name VARCHAR(100) 供应商名称
address VARCHAR(100) 详细地址
concatName VARCHAR(100) 联系人姓名
concatPhone VARCHAR(32) 联系人手机号
remark VARCHAR(32) 备注
extColumns List 自定义字段列表
extColumns.ext_key VARCHAR(100) 自定义字段名称
extColumns.ext_col VARCHAR(100) 自定义字段key
extColumns.ext_value VARCHAR(4000) 自定义字段的值,当为多选时,用#分隔
createTime VARCHAR(32) 创建时间。格式:yyyy-MM-dd HH:mm
modifyTime VARCHAR(32) 最近修改时间。格式:yyyy-MM-dd HH:mm
enable VARCHAR(32) 停用状态。 0-停用 1-正常
status VARCHAR(32) 删除状态。 0-删除 1-正常