# 促销接口

# 付费陈列方案新增

接口说明:仅支持付费陈列的活动方案写入。不支持关联预算的付费陈列活动,也不支持方案的自定义字段

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

{
    "code": "CX201912196386",
    "name": "方案",
    "plan_type": "付费陈列",
    "description": "方案描述",
    "start_date": "2019-12-01",
    "end_date": "2019-12-30",
    "cus_apply_type": "3",
    "form_define": "上报模板",
    "applied_range": "市场部,后勤部",
    "applied_range_emp_code": "111,222",
    "emp_code": "wym",
    "visit_execute_flag":"0",
    "input_items":"货架,海报",
    "cash_mode":"2",
    "close_case_type":"1",
    "expense_enter_type": "1",
    "first_close_case_date": "2024-08-06",
    "evaluate_type": "0",
    "activity_start_date": "2019-12-01",
    "activity_end_date": "2019-12-30",
    "cash_pd_list":[
    {"code":"EA0000121","price":"10"},
    {"code":"EA0000122","price":"20"}],
    "ext_data": [
        {
          "ext_key": "ext_2210210195",
          "ext_value": "自定义字段"
        },
        {
          "ext_key": "ext_2210240196",
          "ext_value": "必填字段1"
        }
      ]
}
说明: 本示例仅供参考,具体以参数说明为准。

请求说明

参数 类型 必填 说明
code varchar(100) 方案编码
name varchar(100) 方案名称
plan_type varchar(100) 方案类型
description varchar(4000) 方案说明
start_date varchar(32) 方案执行开始日期。格式:YYYY-MM-DD
end_date varchar(32) 方案执行结束日期。格式:YYYY-MM-DD
cus_apply_type varchar(32) 客户多次申请。1-不允许;2-允许,执行周期不能交叉;3-允许,执行周期可以交叉;4-允许,同付费项目执行周期不能交叉。不填默认为3
form_define varchar(100) 上报模板名称(传系统中已存在的上报模板),为空时使用方案类型上的默认上报模板
applied_range varchar(4000) 申请可见范围(传系统中已存在的部门,多个部门时逗号分隔)
applied_range_emp_code varchar(4000) 申请可见范围人员编码(传系统中已存在的员工账号,多个时逗号分隔), 与申请可见部门不能同时为空
emp_code varchar(100) 员工登录账号
visit_execute_flag varchar(100) 拜访执行要求。0:每次拜访时不强制必须执行,1:每次拜访时都必须执行,2:在执行期间第1次拜访时必须执行,3:在执行期间前2次拜访时必须执行,4:在执行期间前3次拜访时必须执行,5:在执行期间前4次拜访时必须执行,6:在执行期间前5次拜访时必须执行。默认值为为1
input_items varchar(100) 指定付费项目,多个时逗号分隔。付费项目在系统中不存在时,自动添加一个付费项目
close_case_type varchar(100) 结卖方式,1:单次结案,2:月度结案。如果不传,默认值为1。
cash_mode varchar(100) 兑付费用方式。1:仅现金,2:仅商品,3:不限,4:商品或现金
expense_enter_type varchar(100) 活动申请时费用录入方式,结案方式为“月度结案”时必填,1:录入执行周期内总费用 , 2:录入月费用(所有月份都相同)
report_range_dept_code VARCHAR(1000) 上报可见范围部门编码。部门编码(传系统中已存在的部门,多个部门时逗号分隔,部门编码非空取编码,否则取上报可见范围部门名称)
report_range_emp_code VARCHAR(1000) 上报可见范围人员编码(传系统中已存在的员工账号,多个时逗号分隔)
report_range_dept_name VARCHAR(1000) 上报可见范围部门名称(传系统中已存在的部门,多个部门时逗号分隔,匹配到多个返回错误:部门名称重复)
cash_mode varchar(100) 兑付费用方式。支持传两种,“仅现金”和“仅商品”,1:仅现金,2:仅商品
first_close_case_date varchar(100) 首次结算日期, 格式:YYYY-MM-DD ,结案方式为“月度结案”时传值,如果传空,系统默认按照提交时系统时间+1个月自动计算
evaluate_type varchar(32) 上报记录评价方式”,0:按上报记录评价(整体评价),1:按付费项目评价。如果不传,默认值为为0
activity_start_date varchar(32) 活动申请开始日期,格式:YYYY-MM-DD
activity_end_date varchar(32) 活动申请结束日期,格式:YYYY-MM-DD
cash_pd_list List 兑付商品列表
cash_pd_list.code varchar(100) 兑付商品编码(多个),兑付方式为“仅商品”“现金或商品”“不限”时必须有值
cash_pd_list.price varchar(100) 兑付商品成本价(多个),可以为空,兑付方式为“仅商品”“现金或商品”“不限”时可写入
ext_data List 自定义字段数据
ext_data.ext_key varchar(100) 自定义字段key
ext_data.ext_value varchar(100) 自定义字段值,当为多选时,用#分隔

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID

# 市场活动方案新增

接口说明:仅支持需要申请参加的市场活动的活动方案

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

{
    "code": "CX201912196386",
    "name": "方案",
    "plan_type": "市场活动",
    "description": "方案描述",
    "start_date": "2019-12-01",
    "end_date": "2019-12-30",
    "cus_apply_type": "3",
    "form_define": "上报模板",
    "applied_range": "市场部,后勤部",
    "emp_code": "wym",
    "visit_execute_flag":"0"
}
说明: 本示例仅供参考,具体以参数说明为准。

请求说明

参数 类型 必填 说明
code varchar(100) 方案编码
name varchar(100) 方案名称
plan_type varchar(100) 方案类型
description varchar(4000) 方案说明
start_date varchar(32) 方案执行开始日期。格式:YYYY-MM-DD
end_date varchar(32) 方案执行结束日期。格式:YYYY-MM-DD
cus_apply_type varchar(32) 客户多次申请。1-不允许;2-允许,执行周期不能交叉;3-允许,执行周期可以交叉。不填默认为3
form_define varchar(100) 上报模板名称(传系统中已存在的上报模板),为空时使用方案类型上的默认上报模板
applied_range varchar(4000) 方案可见范围(传系统中已存在的部门,多个部门时逗号分隔)
emp_code varchar(100) 员工登录账号
visit_execute_flag varchar(100) 拜访执行要求。0:每次拜访时不强制必须执行 1:每次拜访时都必须执行,2:在执行期间第1次拜访时必须执行,3:在执行期间前2次拜访时必须执行,4:在执行期间前3次拜访时必须执行,5:在执行期间前4次拜访时必须执行,6:在执行期间前5次拜访时必须执行。默认值为1

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID

# 万能促销活动方案新增

接口说明:企业自定义字段中设置的必填,接口中不做强校验。不支持关联预算的方案类型;系统默认结算方式为单次结算,分期结算的方案新增时需新增对应分期明细。 请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiao/v1/addRegularPlan/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "code": "CX202204281282",
    "name": "CX202204281282",
    "planTypeName": "xxx方案类型",
    "description": "这是方案说明",
    "startDate": "2024-01-01",
    "endDate": "2024-02-15",
    "recordFormName": "这是上报模板",
    "specificPds": "1001000268, 1001000269, 1001000270",
    "gifts": "1001000268, 1001000269, 1001000270",
    "applyRangeDeptCode": "120, agent",
    "applyRangeDeptName": "南京办, 上海办",
    "activityDefaultDateRange": "PLAN",
    "visitExeFlag": "0",
    "itemNames":"",
    "payTypeName": "现金",
    "planBudgetAmount":null,
    "predictEffectiveRatio":null,
    "predictSaleAmount":null,
    "applyStartDate": "2024-01-01",
    "applyEndDate": "2024-02-15",
    "verifyEndDate": "2024-02-15",
    "empCode": "njtest",
    "extColums": [{
        "ext_key": "",
        "ext_value": ""
    }],
    "applyRangeEmpCode": "1001,1002",
    "reportRangeDeptCode": "1001,1002",
    "reportRangeEmpCode": "1001,1002",
    "reportRangeDeptName": "开发部,测试部",
    "settlementMode":"2",
    "settlementStageList":[
        {
        "settlementStart":"2024-01-01",
        "settlementEnd":"2024-01-31",
        "ratio":3
        },
        {
        "settlementStart":"2024-02-01",
        "settlementEnd":"2024-03-15",
        "ratio":3
        }
    ],
    "planItemMode":"3",
      "itemCostStdList": [
        {
          "itemName": "付费陈列",
          "costStdName": "付陈费用标准A",
          "executionRequirements": "执行要求111",
          "redemptionAmount": "50.33",
          "redemptionPdCode": "1001000268",
          "redemptionQuantity": "20",
          "unitName": "箱"
        },
        {
          "itemName": "付费陈列",
          "costStdName": "付陈费用标准B",
          "executionRequirements": "执行要求222",
          "redemptionAmount": "30.22",
          "redemptionPdCode": "1001000268",
          "redemptionQuantity": "10",
          "unitName": "瓶"
        },
        {
          "itemName": "端架",
          "costStdName": "端架费用标准X",
          "executionRequirements": "执行要求NNN",
          "redemptionAmount": "66.88",
          "redemptionPdCode": "1001000268",
          "redemptionQuantity": "50",
          "unitName": "个"
        }
  ],
    "applyByCmRange": "1",
    "cmTypeCode": "1,2,3",
    "cmTypeName": "aa,bb,cc",
    "kaSysName": "aa,bb,cc",
    "cmSaleAreaCode": "11,22,33",
    "cmSaleAreaName": "aa,bb,cc",
    "cmDeptCode": "11,22,33",
    "cmDeptName": "aa,bb,cc"
}


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

参数说明:

参数 类型 必填 说明
code VARCHAR(100) 方案编码
name VARCHAR(100) 方案名称
planTypeName VARCHAR(100) 方案类型
description VARCHAR(4000) 方案说明
startDate VARCHAR(32) 执行开始日期(格式:YYYY-MM-DD,开始日期不能大于结束日期)
endDate VARCHAR(32) 执行结束日期(格式:YYYY-MM-DD)
recordFormName VARCHAR(100) 上报模板(如果方案类型必须上报,上报模板为空时,读取方案类型上的默认模板,没有默认模板系统报错)
specificPds VARCHAR(4000) 活动商品(仅支持传具体商品编码,多个商品时英文逗号分隔)
gifts VARCHAR(4000) 活动赠品(仅支持传具体商品编码,多个商品时英文逗号分隔)
applyRangeDeptCode VARCHAR(4000) 申请范围部门编码(传系统中已存在的部门,多个部门时逗号分隔,申请范围部门编码非空,取编码,否则申请范围部门名称)
applyRangeDeptName VARCHAR(4000) 申请范围部门名称(传系统中已存在的部门,多个部门时逗号分隔,匹配到多个返回错误:部门名称重复)
activityDefaultDateRange VARCHAR(32) 申请时执行周期默认值 EMPTY:空;PLAN:方案执行周期
visitExeFlag VARCHAR(32) 拜访执行要求(需要上报的方案类型,必须)0:每次拜访时不强制必须执行1: 每次拜访时都必须执行2:在执行期间第1次拜访时必须执行3:在执行期间前2次拜访时必须执行4:在执行期间前3次拜访时必须执行5:在执行期间前4次拜访时必须执行6:在执行期间前5次拜访时必须执行
itemNames VARCHAR(4000) 付费项目名称,多个时英文逗号分隔。仅支持传付费项目的范围,付费项目在系统中不存在时,自动添加一个付费项目
payTypeName VARCHAR(100) 支付方式
planBudgetAmount NUMERIC(20,2) 方案总金额
predictEffectiveRatio NUMERIC(20,2) 预计费效比
predictSaleAmount NUMERIC(20,2) 预计销售额
applyStartDate VARCHAR(32) 申请开始日期(格式:YYYY-MM-DD)
applyEndDate VARCHAR(32) 申请截止日期(格式:YYYY-MM-DD)
verifyEndDate VARCHAR(32) 核销截止日期(格式:YYYY-MM-DD)
empCode VARCHAR(100) 员工账号(方案创建人)
planItemMode VARCHAR(32) 付费项目模式,1-仅添加付费项目 3-添加付费项目及费用标准 不填默认为仅添加付费项目
cmRangeType VARCHAR(32) 客户范围 0-不限 2-经销商 3-终端,不传默认为不限制。
itemCostStdList List 付费项目及费用标准明细列表
itemCostStdList.itemName VARCHAR(32) 付费项目名称
itemCostStdList.costStdName VARCHAR(32) 费用标准名称
itemCostStdList.executionRequirements VARCHAR(4000) 执行要求
itemCostStdList.redemptionAmount VARCHAR(32) 兑付金额(元)
itemCostStdList.redemptionPdCode VARCHAR(32) 兑付商品编码
itemCostStdList.redemptionQuantity VARCHAR(32) 兑付数量
itemCostStdList.unitName VARCHAR(32) 兑付商品单位
extColums.ext_key VARCHAR(100) 自定义字段名称
extColums.ext_value VARCHAR(100) 自定义字段值
applyRangeEmpCode VARCHAR(32) 申请范围人员编码(传系统中已存在的员工账号,多个时逗号分隔)
reportRangeDeptCode VARCHAR(32) 上报可见范围部门编码。部门编码(传系统中已存在的部门,多个部门时逗号分隔,部门编码非空取编码,否则取上报可见范围部门名称)
reportRangeEmpCode VARCHAR(32) 上报可见范围人员编码(传系统中已存在的员工账号,多个时逗号分隔)
reportRangeDeptName VARCHAR(32) 上报可见范围部门名称(传系统中已存在的部门,多个部门时逗号分隔,匹配到多个返回错误:部门名称重复)
settlementMode CHAR(1) 结算方式 1-单次 2-分期 不传默认单次
settlementStageList.settlementStart VARCHAR(32) 结算期间开始日期 格式:yyyy-MM-dd
settlementStageList.settlementEnd VARCHAR(32) 结算期间结束日期 格式:yyyy-MM-dd
settlementStageList.ratio VARCHAR(32) 结算比例(数值)
applyByCmRange VARCHAR(32) 按客户范围申请 1是、0否”,不传默认是“否”。为否时,客户范围取上面已有的客户范围字段。为是时,客户范围取客户范围-客户类型、客户范围-KA系统、客户范围-销售区域、客户范围-客户部门字段信息,四个字段信息均不传认为是不限制
cmTypeCode VARCHAR(32) 客户范围-客户类型编码(传系统中已存在的,多个时逗号分隔。编码非空时,优先取编码,否则取名称)
cmTypeName VARCHAR(32) 客户范围-客户类型名称(传系统中已存在的,多个时逗号分隔,匹配到多个返回错误:客户类型名称重复)
kaSysName VARCHAR(32) 客户范围-KA系统名称(传系统中已存在的,多个时逗号分隔)
cmSaleAreaCode VARCHAR(32) 客户范围-销售区域编码(传系统中已存在的,多个时逗号分隔。编码非空时,优先取编码,否则取名称)
cmSaleAreaName VARCHAR(32) 客户范围-销售区域名称(传系统中已存在的,多个时逗号分隔,匹配到多个返回错误:销售区域名称重复)
cmDeptCode VARCHAR(32) 客户范围-客户部门编码(传系统中已存在的,多个时逗号分隔。部门编码非空时,优先取编码,否则取名称)
cmDeptName VARCHAR(32) 客户范围-客户部门名称(传系统中已存在的部门,多个时逗号分隔,匹配到多个返回错误:客户部门名称重复)

响应示例: 响应示例:

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

# 品鉴会方案新增

接口说明:品鉴会方案新增接口 请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiao/v1/addTastingPlan/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "empCode": "njtest",
    "code": "CX202204281282",
    "name": "品鉴会001",
    "planTypeName": "品鉴方案类型",
    "description": "这是方案说明",
    "startDate": "2024-01-01",
    "endDate": "2024-02-15",
    "recordFormName": "这是上报模板",
    "applyRangeEmpCode": "1001,1002",
    "applyRangeDeptCode": "120, agent",
    "sort": "5",
    "itemNames":"端架,付费陈列",
    "payExecuteDeadline": "2024-02-15",
    "pdInfoList": [{
            "productCode": "pd001",
            "limitNum": "20"
     }],
    "ext_data": [{
        "ext_key": "自定义字段A",
        "ext_value": "xxxx"
    }]
}


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

参数说明:

参数 类型 必填 说明
empCode VARCHAR(100) 员工账号(方案创建人)
code VARCHAR(100) 方案编码
name VARCHAR(100) 方案名称
planTypeName VARCHAR(100) 方案类型
description VARCHAR(4000) 方案说明
startDate VARCHAR(32) 执行开始日期(格式:YYYY-MM-DD,开始日期不能大于结束日期)
endDate VARCHAR(32) 执行结束日期(格式:YYYY-MM-DD)
payExecuteDeadline VARCHAR(32) 兑付日期截止日(格式:YYYY-MM-DD)
recordFormName VARCHAR(100) 上报模板
sort VARCHAR(32) 排序号
applyRangeEmpCode VARCHAR(32) 申请范围人员编码(传系统中已存在的员工账号,多个时逗号分隔)
applyRangeDeptCode VARCHAR(32) 申请范围部门编码(传系统中已存在的部门,多个时逗号分隔)
itemNames VARCHAR(4000) 付费项目名称,多个时英文逗号分隔,付费项目必须在系统中存在
cmRangeType VARCHAR(32) 客户范围 0-不限 2-经销商 3-终端,不传默认为不限制。
pdInfoList List 活动商品列表
pdInfoList.productCode VARCHAR(32) 活动商品编码
pdInfoList.limitNum VARCHAR(32) 活动商品上限数量
ext_data List 自定义字段数据
ext_data.ext_key varchar(100) 自定义字段key
ext_data.ext_value varchar(100) 自定义字段值,当为多选时,用#分隔

响应示例: 响应示例:

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

# 活动方案修改

接口说明:仅支持付费陈列、市场活动、万能促销活动场景,并需要申请参加的活动方案,非必填项传空时,不更新

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

{
    "scene": "1",
    "code": "CX201912196386",
    "name": "方案",
    "description": "方案描述",
    "start_date": "2019-12-01",
    "end_date": "2019-12-30",
    "applied_range": "市场部,后勤部",
    "input_items":"货架,海报",
    "emp_code": "wym",
    "visit_execute_flag":"0",
    "budget_amount": "100",
    "predict_sale_amount": "100",
    "exts":[{
      "ext_key":"",
      "ext_value":""
    }]
}
说明: 本示例仅供参考,具体以参数说明为准。

请求说明

参数 类型 必填 说明
scene varchar(100) 活动场景,支持传0-市场活动、1-付费陈列、9-万能促销活动
code varchar(100) 方案编码
name varchar(100) 方案名称
description varchar(4000) 方案说明
start_date varchar(32) 方案执行开始日期。格式:YYYY-MM-DD
end_date varchar(32) 方案执行结束日期。格式:YYYY-MM-DD
applied_range varchar(4000) 申请可见范围(传系统中已存在的部门,多个部门时逗号分隔)
input_items varchar(100) 付费项目,多个付费项目逗号分隔。仅支持追加付费项目。付费项目在系统中不存在时,自动添加。仅付费陈列、万能促销活动场景生效
emp_code varchar(100) 员工登录账号
visit_execute_flag varchar(100) 拜访执行要求。0:每次拜访时不强制必须执行,1:每次拜访时都必须执行,2:在执行期间第1次拜访时必须执行,3:在执行期间前2次拜访时必须执行,4:在执行期间前3次拜访时必须执行,5:在执行期间前4次拜访时必须执行,6:在执行期间前5次拜访时必须执行。默认值为1
budget_amount varchar(4000) 方案总金额。仅万能促销活动(TP)场景生效。当方案冻结预算时忽略
predict_sale_amount varchar(4000) 预计销售额。仅万能促销活动(TP)场景生效
exts List 列表
exts.ext_key varchar(100) 扩展字段名称
exts.ext_value varchar(100) 扩展字段数据值

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID

# 付费陈列和市场活动方案启用

接口说明:启用时,传入的活动结束日期必须大于等于系统日期

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

{
    "code": "CX20191218873",
    "end_date": "2019-12-25"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
code VARCHAR(100) 方案编码
end_date VARCHAR(100) 活动结束日期

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 付费陈列和市场活动方案终止

接口说明:付费陈列和市场活动方案终止

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

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

参数说明:

参数 类型 必填 说明
code VARCHAR(100) 方案编码

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 付费陈列活动申请新增

接口说明:仅支持付费陈列的活动申请数据写入。如果方案对应的申请单模板支持流程审批,则根据员工账号走审批流。如果没找到审批流,第三方同步过来的为已审核的记录。不支持申请叠加表单字段,仅支持单次结案、兑付方式为“仅现金”、“仅商品”

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

{
    "plan_code": "CX202106081712",
    "activity_code": "SQ202106082026",
    "activity_name": "活动1712",
    "activity_desc": "陈列要求",
    "cm_list": [{ 
        "cm_code": "CUS017269",  
        "uper_dealer":"",
        "start_date": "2021-06-01",  
        "end_date": "2021-06-30",
        "target_sale_quota":"500",
        "activity_goods_range": "1",
        "activity_goods_brand": "AA,BB",  
        "activity_goods_type": "日用,医疗",
        "activity_pd_codes":"pd_code01,pd_code02",
        "item_list":[
            {
                "name":"端架",
                "desc":"股东大会",
                "pd_list":[{"code":"0","value":"10"}],
                "subjectName":"科目三",
                "subjectCode": "AWS123",
                "period":"2023-05",
                "dimColumns":[{
                   "dimName":"自定义维度1",
                   "dimValue":"zdy001"
                  }],
                "ext_data": [
                    {
                      "ext_key": "ext_2210210195",
                      "ext_value": "自定义字段"
                    },
                    {
                      "ext_key": "ext_2210240196",
                      "ext_value": "必填字段1"
                    }
                ]
            },
            {
                "name":"海报",
                "desc":"恢复健康",
                "pd_list":[{"code":"0","value":"12"}],
                "subjectName":"科目三",
                "subjectCode": "AWS123",
                "period":"2023-05",
                "dimColumns":[{
                   "dimName":"自定义维度1",
                   "dimValue":"zdy001"
                }],
                "ext_data": [
                    {
                      "ext_key": "ext_2210210195",
                      "ext_value": "自定义字段"
                    },
                    {
                      "ext_key": "ext_2210240196",
                      "ext_value": "必填字段1"
                    }
                ]
        }],
        "remark": "客户申请行备注"
    }],
    "emp_code": "zhouchunlin"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
plan_code VARCHAR(100) 促销方案编码
activity_code VARCHAR(100) 活动申请编号
activity_name VARCHAR(100) 申请活动名称
activity_desc VARCHAR(4000) 陈列要求
cm_list List 列表
cm_list.cm_code VARCHAR(32) 客户编码
cm_list.uper_dealer VARCHAR(32) 费用代垫经销商编码。必须是系统中已存在的经销商
cm_list.start_date VARCHAR(100) 执行开始日期。格式:YYYY-MM-DD
cm_list.end_date VARCHAR(100) 执行结束日期。格式:YYYY-MM-DD
cm_list.target_sale_quota VARCHAR(100) 目标销额
cm_list.activity_goods_range VARCHAR(100) 活动商品范围:3-和方案的活动商品一致;2-指定具体商品;1-指定商品范围(品牌、类型)
cm_list.activity_goods_brand VARCHAR(100) 活动商品品牌;指定商品范围时,品牌和类型不能同时为空
cm_list.activity_goods_type VARCHAR(100) 活动商品类型;指定商品范围时,品牌和类型不能同时为空
cm_list.activity_pd_codes VARCHAR(100) 活动商品编码,多个“,”拼接。指定具商品时,活动商品必须有值,品牌和类型必须传空
cm_list.item_list List 列表
cm_list.item_list.name VARCHAR(100) 付费项目,一个客户支持多个付费项目,当付费陈列的申请必须传付费项目
cm_list.item_list.desc VARCHAR(1000) 执行要求。付费项目的执行要求有自定义字段时不支持导入,用中文分号作为换行符
cm_list.item_list.pd_list.code VARCHAR(32) 兑付商品编码,一个付费项目支持多个商品,商品编码必须在系统中存在。当方案的兑付费用方式为“仅现金”时,则code为0
cm_list.item_list.pd_list.unit VARCHAR(100) 兑付商品单位。单位必须在系统中存在,当方案的兑付费用方式为“仅商品”时,必传
cm_list.item_list.pd_list.value VARCHAR(100) 兑付数量/现金。当兑付方式为“仅商品”时,传数量,当兑付方式为“仅现金”时传现金
cm_list.item_list.subjectCode VARCHAR(100) 预算科目编码,申请单模板关联预算时,预算科目编码和预算科目名称至少有一个要填
cm_list.item_list.subjectName VARCHAR(100) 预算科目名称,申请单模板关联预算时,预算科目编码和预算科目名称至少有一个要填
cm_list.item_list.period VARCHAR(32) 预算期间,申请单模板关联预算时必填
cm_list.item_list.dimColumns List 预算期间动态维度列表,申请单模板关联预算且有动态维度时必填
cm_list.item_list.dimColumns.dimName VARCHAR(100) 动态维度名称
cm_list.item_list.dimColumns.dimValue VARCHAR(4000) 维度维度值
cm_list.item_list.ext_data List 自定义字段数据
cm_list.item_list.ext_data.ext_key varchar(100) 自定义字段key
cm_list.item_list.ext_data.ext_value varchar(100) 自定义字段值,当为多选时,用#分隔
cm_list.remark VARCHAR(4000) 客户申请行备注
emp_code varchar100 员工登录账号

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 市场活动申请新增

接口说明:仅支持市场活动的活动申请数据。如果方案对应的申请单模板支持流程审批,则根据员工账号走审批流。如果没找到审批流,第三方同步过来的为已审核的记录。接口过来的数据,不校验方案的申请可见范围

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

{
    "plan_code": "CX20191218873",
    "activity_code": "SQ201912180022",
    "activity_name": "双十一",
    "cm_list": [{ "cm_code": "CUS000001",  
                 "start_date": "2019-12-18",  
                 "end_date": "2019-12-20"   
                },
                { "cm_code": "CUS010122",  
                 "start_date": "2019-12-18",  
                 "end_date": "2019-12-20"   
                }],
    "emp_code": "wym"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
plan_code VARCHAR(100) 促销方案编码
activity_code VARCHAR(100) 活动申请编号
activity_name VARCHAR(100) 申请活动名称
cm_list List 列表
cm_list.cm_code VARCHAR(32) 客户编码
cm_list.start_date VARCHAR(100) 执行开始日期。格式:YYYY-MM-DD
cm_list.end_date VARCHAR(100) 执行结束日期。格式:YYYY-MM-DD
emp_code varchar100 员工登录账号

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 万能促销活动活动申请新增

接口说明:仅支持万能促销活动的活动申请数据写入。如果方案对应的申请单模板支持流程审批,则根据员工账号走审批流。不支持申请叠加表单字段;企业自定义字段中设置的必填项,在接口新增时不做强校验。不支持关联预算的申请单

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

{
    "planCode": "CX202106081712",
    "projectApplyCode":"",
    "activityCode": "SQ202106082026",
    "applicantCode": "hy",
  	"applyName": "",
  	"parentApplyCode": "",
    "subList": [{ "cusCode": "CUS017269",
                 "dealerCode":"",
                 "cmManagerCode":"",
                 "startDate": "2021-06-01",  
                 "endDate": "2021-06-30",
                 "pdRangeType":"1",
                 "pdTypes":"",
                 "pdBrands":"",
                 "payerCode": "",
                 "cmReceiveCode":"",
                 "pdCodes":"500",
                 "pdUnitName":"",
                 "pdSale":"",
                 "unitDiscount":"",
                 "discountPrice":"",
                 "pdSalesVolume":"",
                 "expectedSalesNum":"",
                 "pdSalesAmount":"",
                 "giftCode":"",
                 "giftUnitName":"",
                 "giftPrice":"",
                 "giftNum":"",
                 "joinCmNum":"5",
                 "itemName":"端架陈列",
                 "inputStandard":"5",
                 "budgetAmount":"",
                 "payMode":"",
                 "remark":"",
                 "extColumns":[{
                     "ext_key":"",
                     "ext_value":""
                 }]
        }]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
planCode VARCHAR(100) 方案编码
projectApplyCode VARCHAR(32) 申请批号
activityCode VARCHAR(100) 申请单号
applicantCode VARCHAR(100) 申请人登录账号
applyName VARCHAR(100) 申请名称
parentApplyCode VARCHAR(32) 父申请单号
subList List 列表
subList.cusCode VARCHAR(32) 客户编码, 方案为按客户申请时必填
subList.rangeCmTypeCodes VARCHAR(1000) 客户类型编码,方案为按客户范围申请时填写,优先编码
subList.rangeCmTypeNames VARCHAR(1000) 客户类型名称,方案为按客户范围申请时填写
subList.rangeKaNames VARCHAR(1000) KA系统名称,方案为按客户范围申请时填写
subList.rangeSaleAreaCodes VARCHAR(1000) 销售区域编码,方案为按客户范围申请时填写,优先编码
subList.rangeSaleAreaNames VARCHAR(1000) 销售区域名称,方案为按客户范围申请时填写
subList.rangeDeptCodes VARCHAR(1000) 客户部门编码,方案为按客户范围申请时填写,优先编码
subList.rangeDeptNames VARCHAR(1000) 客户部门名称,方案为按客户范围申请时填写
subList.dealerCode VARCHAR(32) 费用代垫经销商编码
subList.cmManagerCode VARCHAR(32) 费用负责人登录账号。如果这个值为空,当客户只有一个客户经理时自动带入客户经理;有多个客户经理时,不带入。
subList.startDate VARCHAR(100) 执行开始日期。格式:YYYY-MM-DD
subList.endDate VARCHAR(100) 执行结束日期。格式:YYYY-MM-DD
subList.subjectCode VARCHAR(100) 预算科目编码,申请单模板关联预算且冻结节点为申请冻结时,预算科目编码和预算科目名称至少有一个要填
subList.subjectName VARCHAR(100) 预算科目名称,申请单模板关联预算且冻结节点为申请冻结时,预算科目编码和预算科目名称至少有一个要填
subList.period VARCHAR(32) 预算期间,申请单模板关联预算且冻结节点为申请冻结时必填
subList.dimColumns List 预算期间动态维度列表,申请单模板关联预算且冻结节点为申请冻结且有动态维度时必填
subList.dimColumns.dimName VARCHAR(100) 动态维度名称
subList.dimColumns.dimValue VARCHAR(4000) 维度维度值
subList.pdRangeType VARCHAR(4000) 活动商品范围(0-和方案的活动商品一致;1-指定商品类型或品牌;2-指定具体商品)
subList.pdTypes VARCHAR(32) 活动商品类型(多个用英文下逗号分隔)
subList.pdBrands VARCHAR(4000) 活动品牌(多个用英文下逗号分隔)
subList.payerCode VARCHAR(32) 结算单位编码
subList.cmReceiveCode VARCHAR(32) 收货方编码,系统中存在的客户
subList.pdCodes VARCHAR(1000) 活动商品编码(支持多个,用英文逗号分隔)
subList.pdUnitName VARCHAR(32) 商品单位名称
subList.pdSale VARCHAR(32) 商品售价
subList.unitDiscount VARCHAR(32) 单位折让
subList.discountPrice VARCHAR(32) 折后价
subList.pdSalesVolume VARCHAR(32) 预计销量
subList.expectedSalesNum VARCHAR(32) 预计销量(标箱)
subList.pdSalesAmount VARCHAR(32) 预计销额
subList.giftCode VARCHAR(32) 赠品编码
subList.giftUnitName VARCHAR(32) 赠品单位
subList.giftPrice VARCHAR(32) 赠品价格
subList.giftNum VARCHAR(32) 赠品数量
subList.joinCmNum VARCHAR(32) 参与客户数
subList.itemName VARCHAR(32) 付费项目
subList.inputStandard VARCHAR(32) 单位投放标准
subList.exeRequire VARCHAR(100) 执行要求
subList.budgetAmount VARCHAR(32) 申请金额
subList.payMode VARCHAR(100) 支付方式
subList.remark VARCHAR(4000) 备注
subList.extColumns List 列表
subList.extColumns.ext_key VARCHAR(100) 自定义字段名称
subList.extColumns.ext_value VARCHAR(4000) 自定义字段值,当为多选时,用#分隔

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 万能促销活动(TP)场景申请单反审核

接口说明:支持对万能促销活动(TP)场景的申请单进行反审核。

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

请求示例:

{
    "activityCode": "SQ202011160001",
    "applicantCode": "hts"
}
说明: 本示例仅供参考,具体以参数说明为准。
参数 类型 必填 说明
activityCode varchar(100) 申请单编号
applicantCode varchar(100) 员工登录账号

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID

# 万能促销活动(TP)场景申请单删除

接口说明:支持对万能促销活动(TP)场景的申请单进行删除

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

请求示例:

{
    "activityCode": "SQ202011160001",
    "applicantCode": "CUS010119"
}
说明: 本示例仅供参考,具体以参数说明为准。
参数 类型 必填 说明
activityCode varchar(100) 申请单编号
applicantCode varchar(100) 员工登录账号

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID

# 万能促销活动活动申请移除客户

接口说明:支持移除万能促销活动的活动申请明细。不判断客户的执行周期,无论当前客户的执行周期是未开始、执行中还是已结束都可以移除,移除时把客户申请数据、活动上报记录都一起删除,并记录客户移除日志。如果传入的申请单和客户编码找到多条客户明细,多条记录一起删除。有核销数据的申请明细不允许删除

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

请求示例:

{
    "activityCode": "SQ202011160001",
    "cusCode": "CUS010119",
    "empCode": "zcl"
}
说明: 本示例仅供参考,具体以参数说明为准。
参数 类型 必填 说明
activityCode varchar(100) 申请单编号
cusCode varchar(32) 客户编码
empCode varchar(100) 员工登录账号

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID

# 万能促销活动(TP)场景申请单关闭

接口说明:支持对万能促销活动(TP)场景的申请单进行关闭

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

请求示例:

{
    "activityCode": "SQ202011160001",
    "activityCmId": 1828371739131,
    "endReason": "文本测试11"
}
说明: 本示例仅供参考,具体以参数说明为准。
参数 类型 必填 说明
activityCode varchar(100) 活动申请单号
activityCmId int8 活动申请行ID
endReason varchar(100) 关闭原因

参数说明:

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

# 关闭申请记录查询接口

接口说明:暂时只支持进货折扣、进场费、固定金额、市场活动方案、万能促销活动、品鉴会场景、线上费用场景

请求方式: POST(HTTPS
付费陈列 请求地址: https://openapi.waiqin365.com/api/cuxiaoVerify/v1/queryEndRecords/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
参数说明:

参数 类型 必填 说明
start_time varchar(32) 关闭申请开始时间。格式:yyyy-MM-dd HH:mm:ss
end_time VARCHAR(32) 关闭申请结束时间。格式:yyyy-MM-dd HH:mm:ss
scene_name VARCHAR(32) 系统中场景的名称(非别名)
page VARCHAR(10) 页码,不填默认第一页
rows VARCHAR(10) 页长,不填默认1000

请求示例:

zsf

{
    "scene_name": "进场费",
    "start_time": "2017-01-20 00:00:00",
    "end_time": "2017-01-21 00:00:00",
    "page": "1",
    "rows": "1000"
}

响应示例:

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

数据DATA示例:

[
    {
        "end_code": "ZZ2022021701",
        "end_time": "2022-02-17 17:09",
        "end_amount": "1000.00",
        "end_close_amount": "",
        "end_reason": "终止原因",
        "row_id": "1711032546",
        "activity_code": "SQ0000001",
        "customer_name": "客户名称",
        "customer_source_code": "",
        "budget_amount": "2000.00",
        "close_amount": "",
        "verify_amount": "1000.00"
    }
]

参数说明:

参数 类型 说明
end_code VARCHAR(32) 关闭申请单号
end_time VARCHAR(32) 关闭申请时间。格式:yyyy-MM-dd HH:mm
end_amount NUMERIC(15, 2) 关闭申请金额
end_close_amount NUMERIC(15, 2) 关闭结案金额
end_reason VARCHAR(100) 关闭申请原因
row_id VARCHAR(100) 申请行id
activity_code VARCHAR(100) 申请单号
customer_name VARCHAR(100) 客户名称
customer_source_code VARCHAR(100) 客户外部id
budget_amount NUMERIC(15, 2) 申请金额
close_amount NUMERIC(15, 2) 结案金额
verify_amount NUMERIC(15, 2) 核销金额

# 促销活动申请审批结果写入接口

接口说明:当活动申请单在第三方审核通过后,通过此接口写入审核结果 ,没有启用流程审批的单子才能写入,否则报错。

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

{
   "activity_id":"7479273995003715336",
   "audit_status":"1",
   "audit_reason":"审核通过",
   "auditor_code":"zcl",
   "audit_time":"2019-12-01 18:00:00"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
activity_id VARCHAR(100) 活动ID
audit_status VARCHAR(100) 审核结果。1:审核通过,2:打回
audit_reason VARCHAR(100) 审核意见
auditor_code VARCHAR(100) 审核人。审核人在365中的登录账号中必须存在
audit_time VARCHAR(100) 审核时间。格式:YYYY-MM-DD HH:MM:SS

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 更新付费协议pdf接口

接口说明:当需要协议签署需要第三方落章时,通过此接口传入要签署的协议文件和甲方签署后的文件 请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiao/v1/receiveThirdPdf/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "dealid": "4915670982873944872",
    "file_url": "http://image-test.waiqin365.com/third_party/customer_contract_pdf/2019-11/26bb3ebe2b624a4ca788525c35f61724.pdf",
    "file_type": "0",
    "sign_b_postions":[ {
    "page_num":"2",
    "pos_x":"300",
    "pos_y":"600"
    }]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
dealid VARCHAR(32) 活动申请明细ID
file_url VARCHAR(4000) 签署文件URL
file_type VARCHAR(1) 协议类型。0:新生成的PDF,1:甲方落章的PDF
sign_b_key VARCHAR(255) 乙方签署关键字。file_type=0时,sogn_b_key和sign_b_position至少一个非空
sign_b_postions List 乙方签署坐标位置。file_type=0时,sogn_b_key和sign_b_position至少一个非空
sign_b_postions.page_num VARCHAR(32) 乙方签署页码
sign_b_postions.pos_x VARCHAR(32) 乙方签署横坐标
sign_b_postions.pos_y VARCHAR(32) 乙方签署纵坐标

响应示例:

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

# 活动申请移除客户

接口说明:支持移除市场活动和付费陈列的活动申请明细。不判断客户的执行周期,无论当前客户的执行周期是未开始、执行中还是已结束都可以移除,移除时把客户申请数据、活动上报记录和活动检核记录都一起删除,并记录客户移除日志

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

{
    "apply_code": "SQ202011160001",
    "cus_code": "CUS010119",
    "emp_code": "zcl"
}
说明: 本示例仅供参考,具体以参数说明为准。

请求说明

参数 类型 必填 说明
apply_code varchar(32) 申请单号
cus_code varchar(32) 客户编码
emp_code varchar(100) 员工登录账号

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID

# 兑付执行新增

接口说明:接收第三方系统的兑付执行数据 请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiao/v1/savePayExecution/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "activityId": "5641319548657049388",
    "cmId": "7475146111689843554",
    "cmCode": "",
    "cmName": "",
    "firstPayDate":"2020-11-17 20:55:00",
    "reportType": "端架陈列",
   "linkmanMobile":"",
   "signType":"0",
    "executionType": "2",
    "userCode": "sj",
    "execution_re": [
        {
            "itemName":"海报DM",
            "pdCode": "",
            "unitName": "",
           "actualItemValue":"10"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
activityId VARCHAR(32) 申请单ID
cmId VARCHAR(32) 客户ID。客户id和客户编码、名称必须传一个
cmCode VARCHAR(32) 客户编码。客户id和客户编码、名称必须传一个
cmName VARCHAR(200) 客户名称。客户id和客户编码、名称必须传一个
firstPayDate VARCHAR(32) 兑付时间。格式:YYY-MM-DD hh:mm:ss
reportType VARCHAR(1) 录入终端。1:手机端,2:电脑端
signType VARCHAR(1) 签收方式:0:空,1:短信验证码,2:手写签字,3:手写签字+短信验证码
linkmanMobile VARCHAR(32) 接收短信验证码的手机号
executionType VARCHAR(1) 兑付状态。1:全部兑付完成,2:兑付未完成
userCode VARCHAR(100) 创建人(传系统中存在的登录账号)
execution_re List 列表
execution_re.itemName VARCHAR(100) 付费项目名称,必须和申请时的付费项目一致
execution_re.pdCode VARCHAR(32) 兑付商品编码。现金时不传,商品时必传
execution_re.unitName VARCHAR (32) 兑付商品单位。现金时不传,商品时必传
execution_re.actualItemValue VARCHAR (32) 兑付金额/数量

响应示例:

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

# 活动申请明细执行周期修改

接口说明:支持付费陈列、市场活动、万能促销活动、进场费场景的活动申请明细执行周期修改 请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiao/v1/modifyExeCycle/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "scene": "display",
    "id":"6916424039566956578",
    "start_date": "2021-11-02",
    "end_date": "2021-11-04"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 活动申请明细ID
scene VARCHAR(32) 活动场景:display-付费陈列,market-市场活动,regular-万能促销活动,entrance-进场费
start_date VARCHAR(32) 执行周期开始日期
end_date VARCHAR(32) 执行周期结束日期

响应示例:

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

# 宴席活动申请新增

接口说明:仅支持宴席活动的活动申请数据写入。如果方案对应的申请单模板支持流程审批,则根据员工账号走审批流;没有设置审批流时报错,如果不需要审批,企业可以提前设置自动审批流程

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

{
    "planCode": "CX202106081712",
    "activityCode": "SQ202106082026",
    "applicantCode": "lih",
  	"feastType":"婚宴",
  	"startDate":"2022-08-01",
  	"endDate":"2022-08-05",
  	"hostTime":"上午",
  	"host":"张三",
    "contact":"13511111111",
  	"address":"江苏南京",
  	"predictTables":"10",
  	"executor":"lih",
  	"cmCode":"CUS00001",
  	"upperDealerCode":"",
  	"remark":"",
    "lonLat":"31.982737,118.735114",
    "operator_address":"江苏省南京市建邺区创智路南京国际广告大厦",
  	"extColumns":[{
                     "ext_key":"",
                     "ext_value":""
                 }],
    "pds": [{ 	
      	"useType": "公司赞助",  
        "pdCode":"lgdw002",
        "pdNum": "10",  
        "unit": "箱"
     }],
    "province":"江苏省",
    "city":"南京市",
    "district":"建邺区"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
planCode VARCHAR(100) 促销方案编码
activityCode VARCHAR(100) 活动申请编号
applicantCode VARCHAR(100) 申请人登录账号
feastType VARCHAR(100) 宴席类型
startDate VARCHAR(100) 必填与否根据申请单字段配置判断,宴席开始日期。格式:YYYY-MM-DD
endDate VARCHAR(100) 必填与否根据申请单字段配置判断,宴席结束日期。格式:YYYY-MM-DD
hostTime VARCHAR(32) 必填与否根据申请单字段配置判断,举办时段:上午、中午、下午、晚上
host VARCHAR(100) 举办人姓名
contact VARCHAR(100) 举办人联系电话
address VARCHAR(1000) 必填与否根据申请单字段配置判断,举办人地址
predictTables VARCHAR(32) 预计开展桌数
executor VARCHAR(100) 执行人登录账号
cmCode VARCHAR(32) 供货方编码(编码必须在客户编码中存在)
upperDealerCode VARCHAR(32) 必填与否根据申请单字段配置判断,费用代垫经销商编码
remark VARCHAR(4000) 必填与否根据申请单字段配置判断,备注
lonLat VARCHAR(100) 举办地经纬度,坐标格式为"纬度,经度"
operator_address VARCHAR(100) 举办地经纬度对应地址(如果lonLat不为空,则operator_address为必填)
extColumns List 列表
extColumns.ext_key VARCHAR(100) 自定义字段名称
extColumns.ext_value VARCHAR(4000) 自定义字段值,当为多选时,用#分隔
pds List 商品列表
pds.useType VARCHAR(32) 用酒类型
pds.pdCode VARCHAR(32) 商品编码
pds.pdNum VARCHAR(32) 预计数量
pds.unit VARCHAR(32) 商品单位
predictGifts List 预计赠送商品列表
predictGifts.giftUserType VARCHAR(32) 赠送对象 1-消费方 2-供货方 3-其他
predictGifts.pdCode VARCHAR(32) 商品编码
predictGifts.pdNum NUMERIC(15) 数量
predictGifts.unit VARCHAR(32) 商品单位
predictGifts.remarks VARCHAR(4000) 备注
province VARCHAR(32) 举办地行政区域-省份名称
city VARCHAR(32) 举办地行政区域-城市名称
area VARCHAR(32) 举办地行政区域-区县名称

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 宴席申请头自定义字段修改

接口说明:支持宴席场景申请单头自定义字段的更新支持宴席场景申请单头自定义字段的更新。传哪个字段就更新哪个字段传哪个字段就更新哪个字段,必须是一个有效的自定义字段的更必须是一个有效的自定义字段的更新。

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

{
     "activityCode":"SQ202210011234",
        "exts": [{
          	"ext_key":"字段A",
          	"ext_value":"aa"
        }]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
activityCode VARCHAR(100) 申请单号
extColumns List 列表
extColumns.ext_key VARCHAR(100) 申请单头自定义字段名称
extColumns.ext_value VARCHAR(4000) 申请单头自定义字段数据值,当为多选时,用#分隔

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 宴席申请移除

接口说明:删除未上报的宴席申请记录,删除时直接生效

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

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

请求说明

参数 类型 必填 说明
activityCode varchar(32) 申请单号

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "{ msg_id }",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID

# 宴席方案新增

接口说明:接口新增的宴席方案,如果找到审批流,根据方案创建人走审批流

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

{
    "code": "YX0826151302",
    "name":"API-宴席-02",
    "description": "API",
    "type_name": "701-宴席-加签",
    "report_form_name": "手动点击",
    "evaluate_form_name": "",
    "start_date": "2022-08-26",
    "end_date": "2022-08-26",
    "dept_codes": "BM21111601,XK081801",
    "feast_type_name": "生日宴,庆功宴",
    "brand_name": "",
    "pd_codes": "SP202201190002,SP202201270002",
    "allow_wine_back": "",
    "allow_area":[
      {
          "province":"江苏省",
          "city":"南京市",
          "district":"建邺区"
        }
    ],
    "apply_start_date": "2022-08-26",
    "apply_end_date": "2022-09-26",
    "creator_code": "ht01",
    "ext_data": [{
        "ext_key": "自定义字段A",
        "ext_value": "xxxx"
    }]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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”
cm_range_type VARCHAR(32) 客户范围 0-不限 2-经销商 3-终端,不传默认为不限制。
dept_codes VARCHAR(4000) 申请范围部门编码(传系统中已存在的部门,多个部门时英文逗号分隔)
feast_type_name VARCHAR(4000) 宴席类型名称,多个逗号分隔
brand_name VARCHAR(200) 活动品牌
pd_codes VARCHAR(4000) 活动商品编码,多个英文逗号分隔。商品编码必须在商品信息中存在,如果品牌非空,必须是活动品牌下的商品
allow_wine_back VARCHAR(32) 允许用酒退码 0-否 1-是 默认为否
allow_area List 宴席开展区域(支持多组)
allow_area.province VARCHAR(100) 宴席开展区域省份名称
allow_area.city VARCHAR(100) 宴席开展区域城市名称
allow_area.district VARCHAR(100) 宴席开展区域区县名称
apply_start_date VARCHAR(32) 申请开始日期
apply_end_date VARCHAR(32) 申请截止日期
creator_code VARCHAR(100) 员工账号(方案创建人)
ext_data List 自定义字段数据
ext_data.ext_key varchar(100) 自定义字段key
ext_data.ext_value varchar(100) 自定义字段值,当为多选时,用#分隔

响应示例:

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

# 宴席方案修改

接口说明:根据方案编码修改。地区:传空数组,会更新成[],不传就不更新;其他字段:不传或者传了空字符串,都不更新。

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

{
    "code": "YX0826151302",
    "name":"API-宴席-02",
    "description": "API",
    "start_date": "2022-08-26",
    "end_date": "2022-09-26",
    "dept_codes": "BM21111601,XK081801",
    "feast_type_name": "生日宴,庆功宴",
    "brand_name": "",
    "pd_codes": "SP202201190002,SP202201270002",
    "allow_wine_back": "",
    "allow_area":[
        {
            "province":"江苏省",
            "city":"南京市",
            "district":"建邺区"
        }
    ],
    "apply_start_date": "2022-08-26",
    "apply_end_date": "2022-09-26",
    "creator_code": "ht01",
  "ext_data": [{
    "ext_key": "自定义字段A",
    "ext_value": "xxxx"
  }]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
code VARCHAR(100) 方案编码。唯一,不能重复
name VARCHAR(100) 方案名称
description VARCHAR(4000) 方案说明
start_date VARCHAR(32) 方案执行开始日期(开始日期不能大于结束日期)。格式“yyyy-MM-dd”
end_date VARCHAR(32) 方案执行结束日期。格式“yyyy-MM-dd”
dept_codes VARCHAR(4000) 申请范围部门编码(传系统中已存在的部门,多个部门时英文逗号分隔)
feast_type_name VARCHAR(4000) 宴席类型名称,多个逗号分隔
brand_name VARCHAR(200) 活动品牌
pd_codes VARCHAR(4000) 活动商品编码,多个英文逗号分隔。商品编码必须在商品信息中存在,如果品牌非空,必须是活动品牌下的商品
allow_wine_back VARCHAR(32) 允许用酒退码 0-否 1-是 默认为否
allow_area List 宴席开展区域(支持多组)
allow_area.province VARCHAR(100) 宴席开展区域省份名称
allow_area.city VARCHAR(100) 宴席开展区域城市名称
allow_area.district VARCHAR(100) 宴席开展区域区县名称
apply_start_date VARCHAR(32) 申请开始日期
apply_end_date VARCHAR(32) 申请截止日期
creator_code VARCHAR(100) 员工账号(方案创建人)
ext_data List 自定义字段数据
ext_data.ext_key varchar(100) 自定义字段key
ext_data.ext_value varchar(100) 自定义字段值,当为多选时,用#分隔

响应示例:

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

# 宴席扫码新增

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

{
    "activity_code": "SQ202208250001",
    "creator_code":"ht01",
    "biz_id": "X08231704",
    "scan_type": "1",
    "rows": [
        {
            "wine_type_name": "公司赞助",
            "pd_code": "SP202109150005",
            "scan_code": "08260001",
            "unit_name": "瓶"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
activity_code VARCHAR(100) 申请单号,必须是系统中存在的宴席单号
creator_code VARCHAR(100) 员工账号(创建人)
biz_id VARCHAR(100) 外部唯一ID
scan_type VARCHAR(100) 扫码类型 1-用酒登记 2-用酒退码
rows[].wine_type_name VARCHAR(100) 用酒类型
rows[].pd_code VARCHAR(100) 商品编码
rows[].scan_code VARCHAR(100)
rows[].unit_name VARCHAR(100) 码单位,必须在当前商品存在

响应示例:

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

# 审批额度写入

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

{
	"emp_code": "tc",
    "ext_cols":[
        {
            "ext_key":"审批额度1",
            "ext_value":"10"
        },
        {
            "ext_key":"审批额度2",
            "ext_value":"20"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
emp_code VARCHAR(100) 员工登录账号,唯一值
ext_cols[].ext_key VARCHAR(100) 审批额度字段名,中文名
ext_cols[].ext_value VARCHAR(100) 审批额度字段值

响应示例:

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

# 销售明细数据写入

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

{
    "bizDate": "2022-10-11",
    "empCode":"yanp",
    "receiptCode": "SZ12312312",
    "cmCode": "CUS000016",
    "vendorCode":"CUS000015",
    "managerCode": "yanp",
    "pdCode": "lgdw002",
    "unitName": "箱",
    "pdNum": 1.8,
    "saleAmount": 345.44,
    "saleType": "ZY",
    "receiptType": "FX_SENT",
    "remark":"备注信息"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
bizDate VARCHAR(32) 业务日期,格式:yyyy-MM-dd
empCode VARCHAR(32) 员工编码,该条记录的创建人
receiptCode VARCHAR(100) 单据编号
cmCode VARCHAR(32) 客户编码
vendorCode VARCHAR(32) 供货商编码
managerCode VARCHAR(32) 客户经理编码
pdCode VARCHAR(32) 商品编码
unitName VARCHAR(32) 商品单位名称
pdNum VARCHAR(100) 商品数量,不可以为0,可以是小数
price VARCHAR(100) 价格,不可以为负数,可以是小数
saleAmount VARCHAR(100) 订单金额,可以是小数
saleType VARCHAR(32) 直营/分销:ZY-直营、FX-分销
receiptType VARCHAR(32) 单据类型:ZY_SENT-直营发货单、FX_SENT-分销发货单、CAR_DISTRIBUTE-车铺销售单、CAR_SALE-分销车销单、TH-退货单、OTHER-其他
remark VARCHAR(4000) 备注

响应示例:

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

# 万能促销申请审批接口

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

{
    "applyId": null,
    "applyCode":"SQ202210011234",
    "approverId": null,
    "approverCode": "yanp",
    "verifyType":"1",
    "reason": "",
  	"updateSubs":[{
      	"subId":"12321423541242",
      	"applyAmount":"200.12"
    }]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
applyId VARCHAR(32) 申请单id,申请单ID和申请单号必须传一个
applyCode VARCHAR(200) 申请单号,申请单ID和申请单号必须传一个
approverId VARCHAR(32) 审批人账号id,审批人id和编码必须传一个
approverCode VARCHAR(100) 审批人账号编码,审批人id和编码必须传一个
verifyType VARCHAR(32) 审批状态:1-通过 0-打回
reason VARCHAR(4000) 审批意见
updateSubs List
updateSubs.subId VARCHAR(100) 申请明细ID。修改申请金额时需要传这个参数,修改哪一行就传哪一行
updateSubs.applyAmount NUMERIC(20,2) 申请金额。修改申请金额时需要传这个参数

响应示例:

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

# 万能申请单头行自定义字段更新修改

接口说明:支持申请单头行自定义字段的更新。传哪个字段就更新哪个字段,必须有一个有效的自定义字段的更新。申请单号必填。当仅更新申请单的自定义字段时,申请明细列表可以不传。当仅更新申请明细行的自定义字段时,申请单的自定义字段列表可以不传。附件、图片不支持写入。字段类型:客户、商品、人员、下拉框、单选框、多选框需要做合法性校验、必填项为空不允许修改。

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

{
    "activityCode":"SQ202210011234",
    "exts": [{
      	"ext_key":"",
      	"ext_value":""
    }],
  	"subList":[{
      	"id":"44829037827429384",
      	"exts":[{
          	"ext_key":"",
          	"ext_value":""
        }]
    }]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
activityCode VARCHAR(200) 申请单号
exts List 申请单自定义字段集合
exts.ext_key VARCHAR(100) 申请单主数据扩展字段名称
exts.ext_value VARCHAR(100) 申请单主数据扩展字段数据值
subList List 申请行集合
subList.id VARCHAR(32) 申请明细行ID
subList.exts List 申请行明细数据扩展字段列表
subList.exts.ext_key VARCHAR(100) 申请行明细数据扩展字段名称
subList.exts.ext_value VARCHAR(100) 申请行明细数据扩展字段数据值

响应示例:

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

# 供应商新增

接口说明:供应商数据录入

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

    {    "sourceCode": "A1001",
         "code":"code001",
         "name":"供应商001",
         "address": "南京夫子庙",  
         "concatName": "张三",
         "concatPhone":"13298120110",
         "remark":"这是个备注",
         "enable":"1",
         "extColumns":[{
             "ext_key":"自定义文本",
             "ext_value":"哈哈哈"
         },
          {
             "ext_key":"自定义多选",
             "ext_value":"选项2#选项3"
         }]
        }
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
sourceCode VARCHAR(32) 来源第三方系统的唯一ID
code VARCHAR(32) 供应商编码
name VARCHAR(100) 供应商名称
address VARCHAR(100) 详细地址
concatName VARCHAR(100) 联系人姓名
concatPhone VARCHAR(32) 联系人手机号
remark VARCHAR(32) 备注
enable VARCHAR(32) 停用状态 0-停用 1-启用 不传值时为启用状态
extColumns List 自定义字段列表
extColumns.ext_key VARCHAR(100) 自定义字段名称
extColumns.ext_value VARCHAR(4000) 自定义字段的值,当为多选时,用#分隔

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 供应商修改

接口说明:供应商数据修改

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

    {    "id":"999",
        "sourceCode": "A1001",
         "code":"code001",
         "name":"供应商001",
         "address": "南京夫子庙",  
         "concatName": "张三",
         "concatPhone":"13298120110",
         "remark":"这是个备注",
         "enable":"1",
         "extColumns":[{
             "ext_key":"自定义文本",
             "ext_value":"哈哈哈"
         },
          {
             "ext_key":"自定义多选",
             "ext_value":"选项2#选项3"
         }]
        }
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
sourceCode VARCHAR(32) 来源第三方系统的唯一ID,来源第三方系统的唯一ID和勤策系统ID必须有一个有值,两个同时有值时,优先取在的,优先取来源第三方系统的唯一ID
id VARCHAR(32) 勤策系统ID,来源第三方系统的唯一ID和勤策系统ID必须有一个有值,两个同时有值时,优先取在的,优先取来源第三方系统的唯一ID
code VARCHAR(32) 供应商编码
name VARCHAR(100) 供应商名称
address VARCHAR(100) 详细地址
concatName VARCHAR(100) 联系人姓名
concatPhone VARCHAR(32) 联系人手机号
remark VARCHAR(32) 备注
enable VARCHAR(32) 停用状态 0-停用 1-启用 不传值时为启用状态
extColumns List 自定义字段列表
extColumns.ext_key VARCHAR(100) 自定义字段名称
extColumns.ext_value VARCHAR(4000) 自定义字段的值,当为多选时,用#分隔

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 供应商删除

接口说明:供应商数据逻辑删除

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

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

参数说明:

参数 类型 必填 说明
sourceCode VARCHAR(32) 来源第三方系统的唯一ID,来源第三方系统的唯一ID和勤策系统ID必须有一个有值,两个同时有值时,优先取在的,优先取来源第三方系统的唯一ID
id VARCHAR(32) 勤策系统ID,来源第三方系统的唯一ID和勤策系统ID必须有一个有值,两个同时有值时,优先取在的,优先取来源第三方系统的唯一ID

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID

# 万能促销活动(AP/CP)申请新增

接口说明:万能促销活动(AP/CP)申请新增接口

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

{
    "applyFormName": "申请单模板AAA",
    "activityCode": "SQ2023052500023",
    "applicantCode": "zs",
    "applyName": "申请名称AC",
    "managerCode": "ls",
    "cmCode": "cus001",
    "dealerCode": "cus100",
    "supplierCode": "sul001",
    "holdAddress": "上海",
    "areaCode": "area001",
    "startDate": "2023-05-02",
    "endDate": "2023-06-02",
    "expectArriveNum": "12",
    "pdCodes": "pd001,pd002,pd003",
    "pdUnitName": "箱",
    "activityPrice": "20.20",
    "pdSalesAmount": "100",
    "pdSalesVolume": "2000",
     "extColumns":[{
                         "ext_key":"申请单自定义字段1",
                         "ext_value":"哈哈哈"
                     }],
    "subList": [{ "cmCode": "CUS017269",
                 "dealerCode":"cus100",
                 "supplierCode": "sul001",
                 "areaCode": "area001",
                 "startDate": "2023-06-01",  
                 "endDate": "2023-06-30",
                 "payMode":"现金",
                 "remark":"备注的文本",
                 "holdAddress":"上海",
                 "subjectName":"科目三",
                 "period":"2023-05",
                 "dimColumns":[{
                                 "dimName":"自定义维度1",
                                 "dimValue":"zdy001"
                             }],
                 "applyAmount":"100.50",
                 "extColumns":[{
                     "ext_key":"申请明细自定义字段1",
                     "ext_value":"嘿嘿嘿"
                 }]
        }]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
applyFormName VARCHAR(100) 申请单模板名称
activityCode VARCHAR(32) 申请单号
applicantCode VARCHAR(100) 申请人登录账号
applyName VARCHAR(100) 申请名称
managerCode VARCHAR(100) 负责人登录账号
cmCode VARCHAR(32) 客户编码
dealerCode VARCHAR(32) 费用代垫经销商编码
areaCode VARCHAR(32) 活动场地编码
supplierCode VARCHAR(32) 供应商编码
holdAddress VARCHAR(100) 举办地址
startDate VARCHAR(100) 执行开始日期。格式:YYYY-MM-DD
endDate VARCHAR(100) 执行结束日期。格式:YYYY-MM-DD
expectArriveNum VARCHAR(32) 预计到场人数
pdCodes VARCHAR(100) 活动商品编码多选用,分隔
pdUnitName VARCHAR(100) 商品单位名称
activityPrice VARCHAR(32) 活动价
pdSalesAmount VARCHAR(32) 预计销售额
pdSalesVolume VARCHAR(32) 预计销量
extColumns List 申请单自定义字段列表
extColumns.ext_key VARCHAR(100) 自定义字段名称
extColumns.ext_value VARCHAR(4000) 自定义字段值,当为多选时,用#分隔
subList List 申请明细列表
subList.cmCode VARCHAR(32) 客户编码
subList.dealerCode VARCHAR(32) 费用代垫经销商编码
subList.areaCode VARCHAR(32) 活动场地编码
subList.supplierCode VARCHAR(32) 供应商编码
subList.startDate VARCHAR(100) 执行开始日期。格式:YYYY-MM-DD
subList.endDate VARCHAR(100) 执行结束日期。格式:YYYY-MM-DD
subList.payMode VARCHAR(32) 支付方式
subList.remark VARCHAR(4000) 申请备注
subList.holdAddress VARCHAR(100) 举办地址
subList.subjectCode VARCHAR(100) 预算科目编码,申请单模板关联预算时,预算科目编码和预算科目名称至少有一个要填
subList.subjectName VARCHAR(100) 预算科目名称,申请单模板关联预算时,预算科目编码和预算科目名称至少有一个要填
subList.period VARCHAR(32) 预算期间,申请单模板关联预算时必填
subList.dimColumns List 预算期间动态维度列表,申请单模板关联预算且有动态维度时必填
subList.extColumns.dimName VARCHAR(100) 动态维度名称
subList.extColumns.dimValue VARCHAR(4000) 维度维度值
subList.applyAmount VARCHAR(32) 申请金额
subList.extColumns List 申请明细自定义字段列表
subList.extColumns.ext_key VARCHAR(100) 自定义字段名称,图片、附件暂不支持写入
subList.extColumns.ext_value VARCHAR(4000) 自定义字段值,当为多选时,用#分隔

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 万能促销活动(AP/CP)申请第三方修改审批状态

接口说明:根据申请单ID/申请单号进行审批,审批时调用平台的审批流,如果传的审批人和当前这张单子的审批人不一致,审批失败。当前节点手工指定下一审批人时,下一审批人默认是当前审批人。

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

{
    "applyId": null,
    "applyCode":"SQ202210011234",
    "approverId": null,
    "approverCode": "yanp",
    "verifyType":"1",
    "reason": "",
    "modCmList": [{
      "activityCmId": "7429044872374172629",
      "applyAmount": "23.50"
    }]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
applyId VARCHAR(32) 申请单id,申请单ID和申请单号必须传一个
applyCode VARCHAR(200) 申请单号,申请单ID和申请单号必须传一个
approverId VARCHAR(32) 审批人账号id,审批人id和编码必须传一个
approverCode VARCHAR(100) 审批人账号编码,审批人id和编码必须传一个
verifyType VARCHAR(32) 审批状态:1-通过 0-打回
reason VARCHAR(4000) 审批意见
modCmList List 修改申请明细列表
modCmList.activityCmId VARCHAR(32) 申请明细ID
modCmList.applyAmount VARCHAR(16) 申请金额

响应示例:

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

# 万能促销活动(AP/CP)申请自定义字段修改

接口说明:支持申请单头行自定义字段的更新。传哪个字段就更新哪个字段,必须有一个有效的自定义字段的更新。申请单号必填。当仅更新申请单的自定义字段时,申请明细列表可以不传。当仅更新申请明细的自定义字段时,申请单的自定义字段列表可以不传。附件、图片不支持写入。

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

{
  "activityCode":"SQ202210011234",
  "exts": [{
    "ext_key":"",
    "ext_value":""
  }],
  "subList":[{
    "id":"44829037827429384",
    "exts":[{
      "ext_key":"",
      "ext_value":""
    }]
  }]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
activityCode VARCHAR(200) 申请单号
exts List 申请单自定义字段集合
exts.ext_key VARCHAR(100) 申请单主数据扩展字段名称
exts.ext_value VARCHAR(100) 申请单主数据扩展字段数据值
subList List 申请行集合
subList.id VARCHAR(32) 申请明细行ID
subList.exts List 申请行明细数据扩展字段列表
subList.exts.ext_key VARCHAR(100) 申请行明细数据扩展字段名称
subList.exts.ext_value VARCHAR(100) 申请行明细数据扩展字段数据值

响应示例:

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

# 万能促销活动TP上报记录新增

接口说明:万能促销活动TP上报记录新增

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

{
  "reporter_code": "code001",
  "report_time": "2021-03-25 09:00:00",
  "activity_cm_id": "4789759081208984580",
  "report_cm_code": "cszd001",
  "report_form_data": {
    "main_form": [
      {
        "component_name": "数值输入框组件",
        "component_value": "数值输入框组件内容"
      },
      {
        "component_name": "单行文本框组件",
        "component_value": "单行文本框组件内容"
      }
    ],
    "sub_form": [
      {
        "name": "子表单名称",
        "forms": [
          {
            "name": "子表单名称1",
            "components": [
              {
                "component_name": "数值输入框组件",
                "component_value": "数值输入框组件内容"
              },
              {
                "component_name": "单行文本框组件",
                "component_value": "单行文本框组件内容"
              }
            ]
          },
          {
            "name": "子表单名称2",
            "components": [
              {
                "component_name": "数值输入框组件",
                "component_value": "数值输入框组件内容"
              },
              {
                "component_name": "单行文本框组件",
                "component_value": "单行文本框组件内容"
              }
            ]
          }
        ]
      }
    ]
  }
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
reporter_code VARCHAR(32) 上报人登录编码
report_time VARCHAR(32) 上报时间。格式:yyyy-MM-dd HH:mm:ss
activity_cm_id VARCHAR(32) 活动申请明细ID
report_cm_code VARCHAR(32) 上报客户编码
report_form_data Object 上报表单数据
report_form_data.main_form List 上报主表单数据
report_form_data.main_form.component_name VARCHAR(4000) 上报主表单组件名称
report_form_data.main_form.component_value VARCHAR(4000) 上报主表单组件填写内容
report_form_data.sub_form List 上报子表单数据
report_form_data.sub_form.name VARCHAR(4000) 上报子表单名称
report_form_data.sub_form.forms List 上报子表单数据
report_form_data.sub_form.forms.name VARCHAR(4000) 上报子表单名称
report_form_data.sub_form.forms.components List 上报子表单组件
report_form_data.sub_form.forms.components.component_name VARCHAR(4000) 上报子表单组件名称
report_form_data.sub_form.forms.components.component_value VARCHAR(4000) 上报子表单组件填写内容

响应示例:

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

参数说明:

参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 进场费申请新增

接口说明:支持进场费的活动申请数据写入。不支持申请叠加表单字段;企业自定义字段中设置的必填项,在接口新增时不做强校验。

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

{
  "planCode": "CX202210011201",
  "activityCode":"SQ202210011234",
  "applicantCode":"emp001",
  "cmList": [{
    "cmCode": "cm001",
    "dealerCode": "dealer001",
    "entranceStartDate": "2023-12-20",
    "entranceEndDate": "2023-12-25",
    "executeStartDate": "2023-12-25",
    "executeEndDate": "2023-12-25",
    "entranceStoreNum": "12",
    "payMode": "现金",
    "remark": "客户备注说明",
    "subjectName":"科目三",
    "subjectCode": "AWS123",
    "period":"2023-05",
    "dimColumns":[{
      "dimName":"自定义维度1",
      "dimValue":"zdy001"
    }],
      "extColumns": [{
        "ext_key":"自定义文本",
        "ext_value":"abcd"
      }],
      "pdList": [{
        "pdCode":"pd001",
        "pdEntranceFee":"200.00",
        "pdPurchase":"18.00",
        "pdSale":"26.50",
        "pdRemark":"商品的备注说明"
      }]
  }]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
planCode VARCHAR(200) 方案编码
activityCode VARCHAR(200) 申请单号
applicantCode VARCHAR(32) 申请人登录账号
cmList List 客户申请行集合
cmList.cmCode VARCHAR(32) 客户编码
cmList.dealerCode VARCHAR(32) 费用代垫经销商编码
cmList.entranceStartDate VARCHAR(32) 进场周期开始日期。格式:YYYY-MM-DD
cmList.entranceEndDate VARCHAR(32) 进场周期结束日期。格式:YYYY-MM-DD
cmList.executeStartDate VARCHAR(32) 执行开始日期。格式:YYYY-MM-DD
cmList.executeEndDate VARCHAR(32) 执行结束日期。格式:YYYY-MM-DD
cmList.entranceStoreNum VARCHAR(16) 进场门店数
cmList.payMode VARCHAR(32) 支付方式
cmList.subjectCode VARCHAR(100) 预算科目编码,申请单模板关联预算时,预算科目编码和预算科目名称至少有一个要填
cmList.subjectName VARCHAR(100) 预算科目名称,申请单模板关联预算时,预算科目编码和预算科目名称至少有一个要填
cmList.period VARCHAR(32) 预算期间,申请单模板关联预算时必填
cmList.dimColumns List 预算期间动态维度列表,申请单模板关联预算且有动态维度时必填
cmList.extColumns.dimName VARCHAR(100) 动态维度名称
cmList.extColumns.dimValue VARCHAR(4000) 维度维度值
cmList.remark VARCHAR(1000) 备注
cmList.extColumns List 列表
cmList.extColumns.ext_key VARCHAR(100) 自定义字段名称
cmList.extColumns.ext_value VARCHAR(4000) 自定义字段值,当为多选时,用#分隔
cmList.pdList List 商品明细列表集合
cmList.pdList.pdCode VARCHAR(32) 商品编码
cmList.pdList.pdEntranceFee VARCHAR(16) 进场费
cmList.pdList.pdPurchase VARCHAR(16) 客户进货价
cmList.pdList.pdSale VARCHAR(16) 零售价
cmList.pdList.pdRemark VARCHAR(1000) 备注

响应示例:

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

# 万能促销活动(TP)结案新增接口

接口说明:新增万能促销活动(TP)结案数据。

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

{
  "plan_code": "CX202311205669",
  "creator_code": "zhangsan",
  "close_head_ext_info": [
    {
      "ext_key": "",
      "ext_value": ""
    }
  ],
  "close_details": [
    {
      "activity_cm_id": "",
      "actual_amount": "",
      "close_remark": "",
      "actual_sales_num": "",
      "actual_sales_teu_num": "",
      "actual_sales_amount": "",
      "actual_sales_ratio": "",
      "close_ext_info": [
        {
          "ext_key": "",
          "ext_value": ""
        }
      ]
    }
  ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
plan_code VARCHAR(100) <span style="color:gray;font-size:12px"方案编码
creator_code VARCHAR(100) 创建人账号
close_head_ext_info List 结案头扩展字段信息
close_head_ext_info.ext_key VARCHAR(100) 结案头扩展字段名称
close_head_ext_info.ext_value VARCHAR(100) 结案头扩展字段值
close_details List 结案行信息
close_details.activity_cm_id VARCHAR(100) 活动申请明细行ID
close_details.actual_amount VARCHAR(100) 结案金额
close_details.close_remark VARCHAR(100) 结案备注
close_details.actual_sales_num VARCHAR(100) 实际销量
close_details.actual_sales_teu_num VARCHAR(100) 实际销量(标箱)
close_details.actual_sales_amount VARCHAR(100) 实际销额
close_details.actual_sales_ratio VARCHAR(100) 实际费效比
close_details.close_ext_info List 结案行扩展字段信息
close_details.close_ext_info.ext_key VARCHAR(100) 结案行扩展字段名称
close_details.close_ext_info.ext_value VARCHAR(100) 结案行扩展字段值

响应示例:

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

参数说明:

参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 线上费用活动申请新增

接口说明:线上费用活动申请新增接口

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

{
      "applyFormName": "预算1",
      "activityCode": "",
      "applicantCode": "ceo",
      "applyName": "线上费用api测试",
      "platFormCode":"PT20240428140001",
      "salesTarget":"12312",
      "extColumns":[{
        "ext_key":"头文本",
        "ext_value":"1231"
      },
        {
          "ext_key":"人员选择",
          "ext_value":"cao"
        }],
      "subList": [{ "startDate": "2024-09-05",
        "endDate":"2024-09-06",
        "applyAmount":"10",
        "payMode":"现金",
        "remark":"备注的文本",
        "subjectName":"2222",
        "period":"2024-01",
        "dimColumns":[{
          "dimName":"部门",
          "dimValue":"南京"
        },
          {
            "dimName":"经销商",
            "dimValue":"1111111"
          },
          {
            "dimName":"成本中心",
            "dimValue":"222"
          },
          {
            "dimName":"自定义维度",
            "dimValue":"自定义维度"
          }],
        "inputItemCode":"OI20240428140007",
        "onlineShopCode":"DP0001",
        "pdCode":"1000001",
        "pdList":[
          {
            "pdCode":"1000001",
            "pdNum":"10"
          }
        ],
        "salesAmount":"12",
        "salesRatio":"22",
        "extColumns":[{
          "ext_key":"行文本",
          "ext_value":"1231"
        }]
      }]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
applyFormName VARCHAR(100) 申请单模板名称
activityCode VARCHAR(32) 申请单号
applicantCode VARCHAR(100) 申请人登录账号
applyName VARCHAR(100) 申请名称
platFormCode VARCHAR(100) 平台编码
salesTarget VARCHAR(32) 销售目标
extColumns List 申请单自定义字段列表
extColumns.ext_key VARCHAR(100) 自定义字段名称
extColumns.ext_value VARCHAR(4000) 自定义字段值,当为多选时,用#分隔
subList List 申请明细列表
subList.startDate VARCHAR(100) 活动开始日期。格式:YYYY-MM-DD
subList.endDate VARCHAR(100) 活动结束日期。格式:YYYY-MM-DD
subList.applyAmount VARCHAR(32) 申请金额
subList.subjectCode VARCHAR(100) 预算科目编码,申请单模板关联预算时,预算科目编码和预算科目名称至少有一个要填
subList.subjectName VARCHAR(100) 预算科目名称,申请单模板关联预算时,预算科目编码和预算科目名称至少有一个要填
subList.period VARCHAR(32) 预算期间,申请单模板关联预算时必填
subList.dimColumns List 预算期间动态维度列表,申请单模板关联预算且有动态维度时必填
subList.extColumns.dimName VARCHAR(100) 动态维度名称
subList.extColumns.dimValue VARCHAR(4000) 维度维度值
subList.inputItemName VARCHAR(32) 付费项目名称
subList.onlineShopCode VARCHAR(32) 店铺编码
subList.pdCode VARCHAR(32) 活动商品编码
subList.pdList List 商品组合子表
pdList.pdCode List 商品编码
pdList.pdNum List 数量
subList.salesAmount VARCHAR(32) 预计销额
subList.salesRatio VARCHAR(32) 预计费效比
subList.payMode VARCHAR(32) 支付方式
subList.extColumns List 申请明细自定义字段列表
subList.extColumns.ext_key VARCHAR(100) 自定义字段名称,图片、附件暂不支持写入
subList.extColumns.ext_value VARCHAR(4000) 自定义字段值,当为多选时,用#分隔

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID

# 线上费用活动申请自定义字段修改

接口说明:支持申请单头行自定义字段的更新。传哪个字段就更新哪个字段,必须有一个有效的自定义字段的更新。申请单号必填。当仅更新申请单的自定义字段时,申请明细列表可以不传。当仅更新申请明细的自定义字段时,申请单的自定义字段列表可以不传。附件、图片不支持写入。

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

{
  "activityCode":"SQ202210011234",
  "exts": [{
    "ext_key":"",
    "ext_value":""
  }],
  "subList":[{
    "id":"44829037827429384",
    "exts":[{
      "ext_key":"",
      "ext_value":""
    }]
  }]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
activityCode VARCHAR(200) 申请单号
exts List 申请单自定义字段集合
exts.ext_key VARCHAR(100) 申请单头自定义字段名称
exts.ext_value VARCHAR(100) 申请单头自定义字段值
subList List 申请行集合
subList.id VARCHAR(32) 申请明细行ID
subList.exts List 申请行明细数据扩展字段列表
subList.exts.ext_key VARCHAR(100) 申请明细行自定义字段名称
subList.exts.ext_value VARCHAR(100) 申请明细行自定义字段值

响应示例:

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

参数说明:

参数 说明
return_code 响应编码
return_msg 相应信息
msg_id 消息ID