星河CRM企业版｜客户数据导入操作手册

适用范围：本手册适用于在星河CRM企业版中进行客户（Account/Customer）数据的标准化导入操作。内容覆盖数据准备、格式与字段映射、导入流程、质量控制与常见问题处理，确保导入安全、合规、高质量落库。若涉及从旧系统迁移，请先按“导出（准备）要点”提取源数据，再执行本文导入流程。

1. 数据准备要求（清洗与格式标准）

1. 基础规范

• 文件格式：CSV（UTF-8 无BOM优先；如系统要求BOM则以系统模板为准）
• 分隔符与转义：半角逗号分隔，字段含逗号/换行需使用双引号包裹；双引号内的双引号使用双倍转义（""）
• 行结尾：LF 或 CRLF 均可，保持一致
• 首行：表头（字段名），不得有重复列名、空列
• 文件大小：建议单文件≤50万行或≤100MB；超限请分批（以系统限制为准）
• 去除不可见字符：剔除制表符、零宽空格、Emoji等特殊字符，避免编码与截断错误

2. 数据类型与格式

• 文本：不超目标字段长度；建议统一全角半角；首尾空格裁剪
• 数字：小数点使用“.”；不包含千分位分隔符；空值留空
• 布尔：true/false 或 是/否（二选一，需与映射中的允许值一致）
• 日期时间：ISO 8601（如 2024-03-15 或 2024-03-15T09:30:00Z）；无时区则视为系统默认时区
• 货币：仅数值，不含货币符号；币种如需区分，单独字段处理
• 电话：E.164 标准（如 +8613800138000）；保留国家码；去除空格/短横线
• 邮箱：小写化，格式校验 name@domain.tld
• 国家/地区与省市：国家用ISO 3166-1 alpha-2（如 CN、US），省市建议使用内部字典或标准名录统一

3. 主键、唯一性与去重

• 首选主键：external_id（外部客户唯一标识），全局唯一，便于重入幂等
• 辅助去重键（至少选1组，建议多重保障）：
  • 统一社会信用代码/税号
  • 规范化客户名称（去掉公司后缀）+ 主电话
  • 网站域名（公司客户适用）
• 统一命名规范：客户名称去除“有限公司/股份有限公司/集团”等常见后缀、空格与标点归一化

4. 参照字典与取值标准

• 行业、客户来源、客户级别、状态等枚举值需与星河CRM字典一致；不一致需建立映射表（见下文字段映射表中“允许值/映射规则”）
• 多选字段：使用分号“;”分隔，且每个值必须来自字典

5. 关联与层级

• 父子客户：先确保父客户已存在或在同批导入中可被正确引用（通过 parent_external_id）
• 所有者（owner）：建议用系统用户邮箱匹配；无法匹配时统一指定默认所有者，导入后再分配

6. 合规与最小化

• 仅导入业务必需字段；营销/隐私字段（如营销同意、拒接电话）必须有合法来源与证据
• 不导入敏感信息（如身份证完整号、银行卡号等非必要数据）
• 导入前完成数据脱敏/授权校验（如需）

7. 示例CSV表头（建议模板）

customer_external_id,customer_name,customer_type,industry,source,owner_email,phone,mobile,email,website,country,province,city,address,postal_code,annual_revenue,employee_count,rating,status,parent_external_id,tags,notes,created_at,consent_marketing,do_not_call

2. 操作步骤（导入流程为主，含导出准备要点）

A. 源数据导出（准备要点，用于从旧系统提取）

• 确定范围：仅客户主数据；剔除已作废/合并记录
• 字段选择：与下述“字段映射表”对齐，导出最小必要集
• 去重：以外部ID或统一社会信用代码优先；如无，则名称+电话
• 编码与格式：导出为CSV UTF-8；日期统一为ISO格式
• 脱敏/合规：剔除无导入必要的PII；保留合规证明记录（内部留存）

B. 星河CRM客户数据导入流程

1. 权限与环境

• 使用具备“客户导入”权限的账号登录生产或预发布环境；首次建议在预发布/沙盒验证

2. 模板与字典准备

• 在星河CRM企业版的“数据管理 > 数据导入 > 客户”下载官方模板（如提供）
• 在“系统字典/字段管理”导出或记录客户枚举值字典（行业、来源、级别、状态等）

3. 构造导入文件

• 按“字段映射表”准备CSV；确保必填与唯一字段完整、去重键稳定
• 执行数据清洗、标准化与格式校验（见第1部分）

4. 小批量试导入（强制）

• 取样本100–500条进行导入验证：映射、字典匹配、去重规则、关联关系
• 复核试导入报告（成功率、错误类型），修正后再进行全量

5. 发起导入

• 进入“数据管理 > 数据导入 > 客户”
• 上传CSV，设置参数（编码UTF-8、分隔符逗号、日期格式ISO）
• 去重策略：优先按 external_id；备选：统一社会信用代码；再备：名称+主电话
• 字段映射：系统自动匹配后逐项人工确认；保存映射方案以便复用
• 预检：执行系统预验证；下载/查看预检错误并修正源文件

6. 执行与监控

• 启动正式导入；大批量建议分段（如每次≤10万行），并在批次间抽检
• 在“导入任务/日志”查看进度、错误报告；失败记录修正后仅重传失败行

7. 导入后验证

• 随机抽检≥1%记录；重点核对：数量、所有者、关键枚举、父子关系、唯一性
• 业务口径对齐：与业务方确认可用性；启用生产使用前完成灰度验证

8. 审计与归档

• 归档：源文件、清洗脚本/说明、导入报告、错误更正清单、映射方案版本
• 记录导入批次号、执行人、时间窗、变更范围，用于追溯

9. 回滚与补救（预案）

• 如因大规模错误需回滚：使用导入任务的回滚功能或批量删除此次导入标记的记录，再次导入更正后的数据
• 禁止直接覆盖关键主键列导致不可逆错配；回滚前先做全库快照/备份

3. 字段映射表（示例标准模型，按贵司实际字典调整）

提示：

• 若贵司已启用统一社会信用代码/税号字段，请将其作为唯一且强去重字段加入表（unique_tax_id）。
• 枚举值以星河CRM企业版实际字典为准，本文为示例。导入前务必完成字典映射清单。

4. 常见问题与解决方法（FAQ）

1. 预检/导入时报“枚举值无效”

• 现象：行业/来源/状态等值不在系统字典
• 处理：建立源值到目标字典的映射表并批量替换；无法映射的置为“其他”或空

2. 重复记录过多，导入被阻断

• 现象：命中唯一键或去重策略
• 处理：优先补齐 external_id；建立二级去重键（统一社会信用代码、域名、名称+主电话）；在导入参数中选择“跳过重复并记录”

3. 电话/邮箱格式错误

• 现象：格式校验失败
• 处理：清洗为E.164；邮箱转小写并正则校验；不合规留空或单独列表人工核对

4. 关联父客户无法解析

• 现象：parent_external_id 引用不存在
• 处理：先导入父客户，记录其 external_id；或同批次内确保父记录行先于子记录，且系统支持跨行解析

5. 用户所有者匹配失败

• 现象：owner_email 无对应用户
• 处理：更新为默认所有者后导入；导入后根据组织架构再分配；同时将缺失账号清单提交给系统管理员

6. 特殊字符/编码异常

• 现象：导入后乱码、截断
• 处理：统一UTF-8；移除Emoji/控制字符；确保引号与逗号转义正确

7. 大文件导入超时/失败

• 现象：任务中断、超时
• 处理：分批导入（按地区/字母区间/创建时间分段）；每批后校验；非工作高峰时段执行

8. 历史数据口径不一致

• 现象：字段含义与新系统不一致
• 处理：在清洗阶段进行口径映射与字段拼拆（如地址拆分、名称标准化），并记录变更规则以便审计

9. 合规问题（营销同意/拒呼）

• 现象：未提供合法来源
• 处理：默认设为不同意/拒呼；待后续获取合规同意后再更新

10. 导入成功但查询不到部分记录

• 现象：权限/视图过滤
• 处理：检查数据可见范围与列表过滤条件；由管理员调整角色或建立共享视图

5. 注意事项（关键要点与风险提示）

• 试导入必做：任何全量导入前，务必完成小批量试导入并通过业务验收
• 去重优先级：external_id > 统一社会信用代码/税号 > 规范化名称+主电话 > 域名
• 映射方案版本化：保存并标注版本号，在每次导入前复核字典变化
• 分批与断点续导：大规模导入采用分批与失败重试策略，避免一次性大爆发风险
• 审计与追溯：保留源文件、清洗说明、错误更正与导入报告至少12个月或依从企业与法规要求
• 合规最小化：仅导入业务必需数据；涉个人信息时，遵循适用的数据保护法规（如最小必要、告知同意、可撤回、删除权），并确保持证据链可追溯
• 回滚预案：导入前确保有可恢复点（备份/快照）；批量操作前记录批次标识与影响范围
• 权限与安全：仅授权的数据管理员可执行导入；避免通过不安全渠道（如个人邮箱/网盘）传递含PII的源文件
• 变更冻结窗口：在关键销售周期避免大规模结构性导入，建议选在业务低峰并提前公示
• 监控与质量：设定导入后7–14天的质量观察期，开启异常报表（重复率、空值率、无主记录、字典冲突）并滚动修正

以上方案遵循标准化数据管理与合规要求，未涉及系统安全配置细节与未经授权的第三方工具。若贵司拥有星河CRM企业版的官方导入模板或字典清单，请以其为最高优先级完成字段与取值对齐，再依据本手册执行。