星河CRM企业版｜客户数据导入操作手册
适用范围：本手册适用于在星河CRM企业版中进行客户（Account/Customer）数据的标准化导入操作。内容覆盖数据准备、格式与字段映射、导入流程、质量控制与常见问题处理，确保导入安全、合规、高质量落库。若涉及从旧系统迁移，请先按“导出（准备）要点”提取源数据，再执行本文导入流程。
1. 数据准备要求（清洗与格式标准）
- 基础规范
- 文件格式：CSV（UTF-8 无BOM优先；如系统要求BOM则以系统模板为准）
- 分隔符与转义：半角逗号分隔，字段含逗号/换行需使用双引号包裹；双引号内的双引号使用双倍转义（""）
- 行结尾：LF 或 CRLF 均可，保持一致
- 首行：表头（字段名），不得有重复列名、空列
- 文件大小：建议单文件≤50万行或≤100MB；超限请分批（以系统限制为准）
- 去除不可见字符：剔除制表符、零宽空格、Emoji等特殊字符，避免编码与截断错误
- 数据类型与格式
- 文本：不超目标字段长度；建议统一全角半角；首尾空格裁剪
- 数字：小数点使用“.”；不包含千分位分隔符；空值留空
- 布尔：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），省市建议使用内部字典或标准名录统一
- 主键、唯一性与去重
- 首选主键：external_id（外部客户唯一标识），全局唯一，便于重入幂等
- 辅助去重键（至少选1组，建议多重保障）：
- 统一社会信用代码/税号
- 规范化客户名称（去掉公司后缀）+ 主电话
- 网站域名（公司客户适用）
- 统一命名规范：客户名称去除“有限公司/股份有限公司/集团”等常见后缀、空格与标点归一化
- 参照字典与取值标准
- 行业、客户来源、客户级别、状态等枚举值需与星河CRM字典一致；不一致需建立映射表（见下文字段映射表中“允许值/映射规则”）
- 多选字段：使用分号“;”分隔，且每个值必须来自字典
- 关联与层级
- 父子客户：先确保父客户已存在或在同批导入中可被正确引用（通过 parent_external_id）
- 所有者（owner）：建议用系统用户邮箱匹配；无法匹配时统一指定默认所有者，导入后再分配
- 合规与最小化
- 仅导入业务必需字段；营销/隐私字段（如营销同意、拒接电话）必须有合法来源与证据
- 不导入敏感信息（如身份证完整号、银行卡号等非必要数据）
- 导入前完成数据脱敏/授权校验（如需）
- 示例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客户数据导入流程
- 权限与环境
- 使用具备“客户导入”权限的账号登录生产或预发布环境；首次建议在预发布/沙盒验证
- 模板与字典准备
- 在星河CRM企业版的“数据管理 > 数据导入 > 客户”下载官方模板（如提供）
- 在“系统字典/字段管理”导出或记录客户枚举值字典（行业、来源、级别、状态等）
- 构造导入文件
- 按“字段映射表”准备CSV；确保必填与唯一字段完整、去重键稳定
- 执行数据清洗、标准化与格式校验（见第1部分）
- 小批量试导入（强制）
- 取样本100–500条进行导入验证：映射、字典匹配、去重规则、关联关系
- 复核试导入报告（成功率、错误类型），修正后再进行全量
- 发起导入
- 进入“数据管理 > 数据导入 > 客户”
- 上传CSV，设置参数（编码UTF-8、分隔符逗号、日期格式ISO）
- 去重策略：优先按 external_id；备选：统一社会信用代码；再备：名称+主电话
- 字段映射：系统自动匹配后逐项人工确认；保存映射方案以便复用
- 预检：执行系统预验证；下载/查看预检错误并修正源文件
- 执行与监控
- 启动正式导入；大批量建议分段（如每次≤10万行），并在批次间抽检
- 在“导入任务/日志”查看进度、错误报告；失败记录修正后仅重传失败行
- 导入后验证
- 随机抽检≥1%记录；重点核对：数量、所有者、关键枚举、父子关系、唯一性
- 业务口径对齐：与业务方确认可用性；启用生产使用前完成灰度验证
- 审计与归档
- 归档：源文件、清洗脚本/说明、导入报告、错误更正清单、映射方案版本
- 记录导入批次号、执行人、时间窗、变更范围，用于追溯
- 回滚与补救（预案）
- 如因大规模错误需回滚：使用导入任务的回滚功能或批量删除此次导入标记的记录，再次导入更正后的数据
- 禁止直接覆盖关键主键列导致不可逆错配；回滚前先做全库快照/备份
3. 字段映射表（示例标准模型，按贵司实际字典调整）
| 源字段（旧系统） |
目标字段（星河CRM） |
数据类型 |
必填 |
唯一 |
示例值 |
允许值/映射规则与校验 |
| external_id |
customer_external_id |
文本(64) |
是 |
是 |
CUST-000123 |
全局唯一；幂等导入主键；若为空，禁导或由系统生成（建议禁导） |
| name |
customer_name |
文本(200) |
是 |
否 |
上海星河科技有限公司 |
归一化名称（去公司后缀/空格标准化）用于去重辅助 |
| type |
customer_type |
枚举 |
是 |
否 |
企业 |
允许：企业/个人（示例）；按系统字典映射 |
| industry |
industry |
枚举 |
否 |
否 |
互联网 |
必须在“行业”字典内；不在字典内的建立映射或置为“其他” |
| source |
source |
枚举 |
否 |
否 |
广告投放 |
统一到系统来源字典：线索/活动/广告/推荐/网站/电话/其他 等 |
| owner_email |
owner_email |
邮箱 |
否 |
否 |
am@qq.com |
匹配系统用户；不匹配时设默认所有者或抛错（按导入策略） |
| phone |
phone |
电话 |
否 |
去重参与 |
+862155588888 |
E.164；用于辅助去重（与名称组合） |
| mobile |
mobile |
电话 |
否 |
否 |
+8613800138000 |
E.164；如与phone相同可留空 |
| email |
email |
邮箱 |
否 |
否 |
contact@acme.com |
RFC格式校验；重复可允许（客户层面） |
| website |
website |
URL |
否 |
去重参与 |
https://acme.com |
仅域名/URL其一，域名去www归一；辅助去重 |
| country |
country |
枚举 |
否 |
否 |
CN |
ISO 3166-1 alpha-2 |
| province |
province |
文本(64) |
否 |
否 |
上海市 |
与内部行政区字典一致 |
| city |
city |
文本(64) |
否 |
否 |
上海市 |
同上 |
| address |
address |
文本(255) |
否 |
否 |
浦东新区世纪大道100号 |
去除换行与多余空格 |
| postal_code |
postal_code |
文本(20) |
否 |
否 |
200120 |
只保留数字/字母 |
| annual_revenue |
annual_revenue |
数值 |
否 |
否 |
12000000 |
仅数值；币种另字段若启用 |
| employee_count |
employee_count |
整数 |
否 |
否 |
350 |
≥0 |
| rating |
rating |
枚举 |
否 |
否 |
A |
允许：A/B/C/D（示例） |
| status |
status |
枚举 |
否 |
否 |
有效 |
允许：潜在/有效/无效（示例） |
| parent_external_id |
parent_external_id |
文本(64) |
否 |
参照 |
CUST-000001 |
必须引用已存在或同批可解析的external_id |
| tags |
tags |
多选文本 |
否 |
否 |
重点;VIP |
分号分隔；每个值须在标签字典或支持动态创建 |
| notes |
notes |
文本(2000) |
否 |
否 |
核心客户，重点维护 |
去除敏感词与PII |
| created_at |
created_at |
日期/时间 |
否 |
否 |
2024-03-15T09:30:00Z |
ISO 8601；为空则以系统时间 |
| consent_marketing |
consent_marketing |
布尔 |
否 |
否 |
true |
必须有合法来源依据；默认false更安全 |
| do_not_call |
do_not_call |
布尔 |
否 |
否 |
false |
与电话使用策略一致；true时禁止外呼 |
提示：
- 若贵司已启用统一社会信用代码/税号字段，请将其作为唯一且强去重字段加入表（unique_tax_id）。
- 枚举值以星河CRM企业版实际字典为准，本文为示例。导入前务必完成字典映射清单。
4. 常见问题与解决方法（FAQ）
- 预检/导入时报“枚举值无效”
- 现象：行业/来源/状态等值不在系统字典
- 处理：建立源值到目标字典的映射表并批量替换；无法映射的置为“其他”或空
- 重复记录过多，导入被阻断
- 现象：命中唯一键或去重策略
- 处理：优先补齐 external_id；建立二级去重键（统一社会信用代码、域名、名称+主电话）；在导入参数中选择“跳过重复并记录”
- 电话/邮箱格式错误
- 现象：格式校验失败
- 处理：清洗为E.164；邮箱转小写并正则校验；不合规留空或单独列表人工核对
- 关联父客户无法解析
- 现象：parent_external_id 引用不存在
- 处理：先导入父客户，记录其 external_id；或同批次内确保父记录行先于子记录，且系统支持跨行解析
- 用户所有者匹配失败
- 现象：owner_email 无对应用户
- 处理：更新为默认所有者后导入；导入后根据组织架构再分配；同时将缺失账号清单提交给系统管理员
- 特殊字符/编码异常
- 现象：导入后乱码、截断
- 处理：统一UTF-8；移除Emoji/控制字符；确保引号与逗号转义正确
- 大文件导入超时/失败
- 现象：任务中断、超时
- 处理：分批导入（按地区/字母区间/创建时间分段）；每批后校验；非工作高峰时段执行
- 历史数据口径不一致
- 现象：字段含义与新系统不一致
- 处理：在清洗阶段进行口径映射与字段拼拆（如地址拆分、名称标准化），并记录变更规则以便审计
- 合规问题（营销同意/拒呼）
- 现象：未提供合法来源
- 处理：默认设为不同意/拒呼；待后续获取合规同意后再更新
- 导入成功但查询不到部分记录
- 现象：权限/视图过滤
- 处理：检查数据可见范围与列表过滤条件；由管理员调整角色或建立共享视图
5. 注意事项（关键要点与风险提示）
- 试导入必做：任何全量导入前，务必完成小批量试导入并通过业务验收
- 去重优先级：external_id > 统一社会信用代码/税号 > 规范化名称+主电话 > 域名
- 映射方案版本化：保存并标注版本号，在每次导入前复核字典变化
- 分批与断点续导：大规模导入采用分批与失败重试策略，避免一次性大爆发风险
- 审计与追溯：保留源文件、清洗说明、错误更正与导入报告至少12个月或依从企业与法规要求
- 合规最小化：仅导入业务必需数据；涉个人信息时，遵循适用的数据保护法规（如最小必要、告知同意、可撤回、删除权），并确保持证据链可追溯
- 回滚预案：导入前确保有可恢复点（备份/快照）；批量操作前记录批次标识与影响范围
- 权限与安全：仅授权的数据管理员可执行导入；避免通过不安全渠道（如个人邮箱/网盘）传递含PII的源文件
- 变更冻结窗口：在关键销售周期避免大规模结构性导入，建议选在业务低峰并提前公示
- 监控与质量：设定导入后7–14天的质量观察期，开启异常报表（重复率、空值率、无主记录、字典冲突）并滚动修正
以上方案遵循标准化数据管理与合规要求，未涉及系统安全配置细节与未经授权的第三方工具。若贵司拥有星河CRM企业版的官方导入模板或字典清单，请以其为最高优先级完成字段与取值对齐，再依据本手册执行。
