批量导入营期营员

按营期批量导入营员并生成订单。字段以 获取营期导入模板 返回的 input_key 为准；PLU 可从 获取营期 PLU 编号 获取。

POST/api/excelData

请求参数

名称	类型	描述	是否必填	默认值	备注
token	String	身份校验令牌	必填	-	由 获取访问令牌 获得
period_id	Number	营期 ID	必填	-	-
excel_data	String	营员数据 JSON 字符串	必填	-	解析后为对象数组，字段见下

excel_data 说明

先将数组序列化为 JSON 字符串 再放入请求体。不同营期必填项可能不同，请以导入模板为准。

可选固定字段（有值且大于 0 时自动分团/分组）：

字段	说明
group_id	组编号
cut_id	团编号

CURL

curl --location --request POST 'https://open.xinduobang.cn/api/excelData' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "YOUR_TOKEN",
    "period_id": 5300,
    "excel_data": "[{\"input_data_0\":\"测试1\",\"input_data_2\":\"4115265554541131\",\"input_data_4\":\"女\",\"input_data_5\":\"1991/12/12\",\"input_data_7\":\"18810416068\",\"input_data_8\":\"337515378463\",\"input_data_9\":\"10\",\"group_id\":1,\"cut_id\":2}]"
}'

excel_data 解码后示例：

[
  {
    "input_data_0": "测试1",
    "input_data_2": "4115265554541131",
    "input_data_4": "女",
    "input_data_5": "1991/12/12",
    "input_data_7": "18810416068",
    "input_data_8": "337515378463",
    "input_data_9": "10",
    "group_id": 1,
    "cut_id": 2
  }
]

成功响应

{
  "code": 0,
  "data": {
    "msg": "操作成功",
    "code": 0,
    "fall_num": 1,
    "success_num": 1,
    "err_data": [
      {
        "s_name": "测试2",
        "s_phone": "",
        "s_idcard": "411526555454114",
        "msg": "请输入正确的会员手机号"
      }
    ],
    "success_data": [
      {
        "sid": "123",
        "s_name": "测试1",
        "ordernum": "NO112113131131313"
      }
    ]
  }
}

字段	类型	说明
fall_num	Number	失败条数
success_num	Number	成功条数
err_data	Array	失败明细（含姓名、手机、证件号与原因 msg）
success_data	Array	成功明细（含 sid、s_name、ordernum）

失败响应

HTTP状态码	错误码	描述	排查建议
200	非 0	业务错误	确认 excel_data 为有效 JSON 字符串且非空；对照导入模板补齐必填项

相关接口

• 获取营期导入模板：获取营期导入模板
• 获取营期 PLU：获取营期 PLU 编号