7.4 KiB
名单与订单状态输入契约
每项业务固定使用“模板 + 示例”两段。
取消和恢复订单的定位出发日期兼容 MM-DD 简写，并按任务日期归一为下一次发生日；明确填写的年份保持不变。名单导入仍按模板填写完整年份，并随同文字发送一份 Excel 名单附件。
导入独立团名单
模板
导入独立团名单
单号（选填）：<记得时填写业务系统中的独立团团号>
预订客户（必填）：<客户名称或唯一搜索关键词>
出发日期（必填）：<YYYY-MM-DD>
产品名称（选填）：<产品名称或唯一搜索关键词>
领队（选填）：<领队姓名或唯一搜索关键词>
覆盖确认（选填）：<确认替换已有名单时填写“是”>
名单附件（必填）：随同文字发送一份符合下述 ERP 字段规则的 .xls 或 .xlsx 名单工作簿；每行序号对应订单游客位。
示例
导入独立团名单
预订客户：辽宁康辉
出发日期：2026-09-03
产品名称：遇见老挝
领队：张三
示例同时附一份符合 ERP 字段规则的名单工作簿。
导入散拼子单名单
模板
导入散拼子单名单
单号（选填）：<记得时填写业务系统中的具体子单号>
预订客户（必填）：<具体子单客户名称或唯一搜索关键词>
出发日期（必填）：<YYYY-MM-DD>
产品名称（选填）：<产品名称或唯一搜索关键词>
领队（选填）：<领队姓名或唯一搜索关键词>
覆盖确认（选填）：<确认替换已有名单时填写“是”>
名单附件（必填）：随同文字发送一份符合下述 ERP 字段规则的 .xls 或 .xlsx 名单工作簿；每行序号对应具体子单游客位。
示例
导入散拼子单名单
预订客户：辽宁康辉
出发日期：2026-09-15
产品名称：老挝广东8D
领队：张三
示例同时附一份符合 ERP 字段规则的名单工作簿。
附件必须且只能有一个可见工作表。程序在前 100 行中自动定位唯一表头；表头可直接位于第一行，也可位于团信息或说明行之后，列顺序任意，表头下一行起的名单数据必须连续。表头必须各包含一次这些 ERP 语义字段：序号/姓名/英文姓名（或 NAME）/性别/出生日期/出生地/护照号码（或证件号码）/签发地/签发日期（或签发日）/有效期/电话/备注。程序选择和校验这些必需字段；年龄、源证件类型以及其他普通额外列均被忽略。身份证号码（或身份证）仅在性别或出生日期使用下述固定公式时作为校验来源，其余情况下忽略；身份证原值不会进入 ERP 或内部 canonical TSV。程序把英文姓名映射为 NAME、护照号码映射为“证件号码”、固定输出“证件类型=护照”，并把签发日期映射为“签发日”。
顶部团信息或说明区的 Excel 错误值（如 #VALUE!）不作为表头标签；名单字段中的错误值仍阻断。性别、出生日期兼容以下固定身份证推算公式（示例 E3 必须对应唯一身份证列的同一行；列重排后按实际位置匹配）：
性别：IF(OR(LEN(E3)=15,LEN(E3)=18),IF(MOD(MID(E3,15,3)*1,2),"男","女"),NA())
出生日期：DATE(MID(E3,7,VLOOKUP(LEN(E3),{15,2;18,4},2,0)),MID(E3,VLOOKUP(LEN(E3),{15,9;18,11},2,0),2),MID(E3,VLOOKUP(LEN(E3),{15,11;18,13},2,0),2))
程序不执行任意公式，只接收上述模板的已有计算结果，并核对同一行 15 位或 18 位身份证的结构、有效出生日期以及推算性别/生日是否一致。18 位身份证应保存为文本，避免数字精度丢失；不进行身份证真实性或校验码认证。来源缺失、跨行引用、身份证列歧义、缓存缺失/错误/不一致均阻断。原有签发日与有效期之间的同一行十年期 EDATE 模板继续支持；宏、外链和超链接检查仍覆盖整个工作簿。
若某位游客是领队，该行备注去除首尾空格后必须严格等于领队，并同时填写该行姓名和电话。一份名单最多标记一位领队；标记成功后程序会把这两个值写入 ERP 联系人/领队人和电话，该行仍作为普通游客导入。领队备注等其他文字不触发写入；没有严格标记时保留 ERP 原联系人信息。正文里的领队字段仍只是订单定位的选填补充关键词，不是联系人写入来源。
只接收一个 .xls/.xlsx 文件；旧版 .xls 必须经隔离转换得到真实 XLSX，不能回退原始字节。多工作表、隐藏的必需名单字段数据、宏、外部链接、必需字段中的非模板公式、必需字段断行、空名单、非正整数/重复序号均失败关闭。普通额外列可以有值、公式或被隐藏，但外部公式、超链接及其他主动内容仍按全工作簿安全边界阻断。最多 5000 行且最高序号 5000。附件错误不得把单元格值、文件正文或明文文件名写入日志或 API 错误。
用户可提供一个或多个游客序号。规范化后的每个内部数据行必须完整包含 13 列；未提供的序号不代表删除或清空。ERP 独立团默认 16 行、散拼子单默认 31 行只是初始行基线，不是导入上限；执行端按现有行数与最高序号动态扩行。
运行时先识别名单 route 并进入 awaiting_attachment，附件到齐并通过程序校验后，才把 canonical TSV 作为内部 名单内容 交给 Program Parser。名单业务不进入 AI、Shadow 或 Auto。原始 Excel 不进入 Prompt、任务 JSONB 或输出附件；加密 canonical TSV 在解析通过或终止后清除。
名单定位时，预订客户和出发日期是无单号场景的必填主条件；产品名称、领队均为选填补充校验，不填写不追问。后续适配逻辑先用客户和日期查询 ERP，再对候选可见信息做补充校验；不要把产品或领队当作必须的原生列表硬筛选条件。
取消订单
模板
取消订单
单号（选填）：<记得时填写业务系统中的团号或具体子单号>
预订客户（必填）：<客户名称或唯一搜索关键词>
出发日期（必填）：<YYYY-MM-DD>
产品名称（选填）：<产品名称或唯一搜索关键词>
领队（选填）：<领队姓名或唯一搜索关键词>
示例
取消订单
预订客户：辽宁康辉
出发日期：2026-09-03
产品名称：遇见老挝
领队：张三
恢复订单
模板
恢复订单
单号（选填）：<记得时填写业务系统中的团号或具体子单号>
预订客户（必填）：<客户名称或唯一搜索关键词>
出发日期（必填）：<YYYY-MM-DD>
产品名称（选填）：<产品名称或唯一搜索关键词>
领队（选填）：<领队姓名或唯一搜索关键词>
恢复状态（选填）：<预订/已确认/收客中>
示例
恢复订单
预订客户：辽宁康辉
出发日期：2026-09-03
产品名称：遇见老挝
领队：张三
恢复状态：预订
四类业务均兼容填写完整单号；填写时写入 data.existing_refs.identifier。未填写时，名单指令只保留由首行确定的 existing_refs.kind。取消/恢复若原文明确说“独立团”“散拼母团”或“散拼子单”，只保留对应 existing_refs.kind；原文未明确对象类型时省略 existing_refs，不要猜测。