# 润界贸析出海系统使用说明 > 适用版本：当前本地开发版 > 适用对象：个人外贸从业者、工厂业务人员、企业团队成员与管理员 --- ## 一、系统是做什么的 润界贸析是一套出口决策与外贸业务工作台，围绕以下主线工作： ```text 客户与产品资料 → HS编码候选 → 目标市场与贸易数据 → 准入及物流判断 → 成本和报价 → PI及出口单证 → 报告与后续任务 ``` 系统可以辅助整理和判断，但不能替代海关、目的国监管机构、进口商、认证机构、货代或报关行的最终确认。 --- ## 二、首次使用 ### 2.1 普通用户登录 1. 打开系统登录页 `/login`。 2. 输入注册邮箱和密码。 3. 登录后进入“企业账户中心”或“客户与产品中心”。 4. 同一账号加入多个企业时，接受邀请后系统会自动切换到本次受邀工作区。 > 系统只认可正式登录会话，不认可浏览器自行添加的身份请求头。 ### 2.2 注册账号 注册页为 `/register`，支持： - **工厂/企业账号**：默认注册类型； - **个人学员账号**：使用 `/register?type=individual`； - **平台管理员账号**：使用 `/register?type=platform`，仅限已授权管理员，且必须有服务器初始化密钥。 普通注册时，按页面要求填写姓名、邮箱、密码和相关资料。密码至少10位，并同时包含字母和数字。 ### 2.3 首次企业开户 系统尚无任何用户时，访问 `/setup-account`： 1. 填写企业所有者资料； 2. 输入服务器管理员提供的初始化密钥； 3. 创建第一个企业所有者账号； 4. 创建成功后，以后访问该页面会自动回到登录页。 > 初始化密钥不得通过聊天、截图或公开文档传播。 ### 2.4 接受企业邀请 1. 企业管理员在“企业账户中心 → 成员与权限”中发起邀请； 2. 被邀请人打开一次性激活链接； 3. 新用户设置账号密码； 4. 已有账号输入原账号密码； 5. 激活成功后，系统自动进入受邀企业工作区。 邀请链接过期、被撤销或已使用后不能重复激活。 --- ## 三、推荐使用顺序 登录后统一访问 `/workflows`。系统会根据账号类型自动进入个人或工厂任务首页，并按当前工作区的真实产品、报告、客户和报价数量推荐“我的下一步”。 新版首页采用五个阶段： ```text 完善方向/工厂资料 → 建立产品或完成选品 → 完成产品与市场评估 → 寻找并核验客户 → 制作报价与PI ``` HS库、贸易数据、全球市场、准入、成本和物流等入口统一收在“专业工具与数据入口”中，新手不需要一开始逐个使用。 进度判定说明： - 工厂资料需填写工厂名称、已有产品和目标国家； - 个人选品需把决定继续验证的候选建立为产品档案； - 只有状态为“完整完成”的出口评估才计入进度，部分失败报告不计； - 只有完成核验并转入客户档案的客户才计入“已核验客户”。 ### 工厂用户 ```text 产品档案 → 工厂产品筛查 → 一键出口情报 → 加工成本 → 客户报价 → 单证制作 ``` ### 个人外贸用户 ```text 个人选品雷达 → 产品出口查询 → 一键出口情报 → 客户智能开发 → 客户档案 → 报价单证 ``` ### 企业团队 ```text 企业资料和成员权限 → 产品库 → 客户开发 → 出口报告 → 报价版本 → PI和出货单证 ``` --- ## 四、主导航说明 ### 4.1 客户与产品中心 包含四个入口： | 模块 | 用途 | |---|---| | 中心概览 | 查看客户、产品、工厂筛查等业务入口 | | 客户智能开发 | 建立开发任务、整理公开线索、评分并转入客户档案 | | 客户档案 | 管理联系人、跟进、社媒、单证和内部备注 | | 产品档案 | 管理规格、材质、HS候选、成本、认证和工厂资料 | 建议先建立产品档案和客户档案，再做分析与报价，避免重复填写。 ### 4.2 工厂产品筛查 从企业已有产品中选择产品，判断： - 产品资料完整度； - HS候选； - 目标市场； - 中国出口贸易数据； - 准入要求； - 包装和物流条件。 如果产品列表为空，请先到“产品档案”新增产品。 ### 4.3 出口情报 | 模块 | 用途 | |---|---| | 一键出口情报 | 完整运行产品、HS、市场、贸易、准入、物流和报告链路 | | 个人选品雷达 | 对候选产品进行选品判断 | | 产品出口查询 | 快速获取HS候选及目标市场核查方向 | | 搜索 | 搜索当前工作区内的产品、客户、报告、报价与模板 | | 分析报告 | 查看和管理已保存的分析结果 | ### 4.4 报价单证 | 模块 | 用途 | |---|---| | 客户报价 | 成本、汇率、利润、贸易术语、阶梯价格与PI报价 | | 单证制作 | 在线填写并导出报价单、发票、装箱单等单证 | ### 4.5 业务工具 | 模块 | 用途 | |---|---| | 业务工具工作台 | 启动可复用流程、管理任务、导入导出任务JSON | | HS编码库 | 查询HS 2022国际六位编码 | | 中国海关数据 | 查询中国进出口贸易数据和海关月报入口 | | 加工成本测算 | 计算材料、废料、加工、工装、管理费用和目标报价 | | 全球市场 | 查看世界银行人口、GDP和贸易开放度等指标 | | 准入资质 | 按国家和HS章目整理法规、认证、标签和资料路径 | | 单证模板库 | 下载和使用报价、PI、发票、装箱单等模板 | --- ## 五、一键出口情报操作方法 ### 第一步：填写产品与工厂资料 至少填写： - 产品名称； - 目标国家两位代码，如美国 `US`、德国 `DE`、沙特 `SA`； - 主要材质； - 用途、结构与安装方式。 建议同时补充： - 英文名称； - 规格型号； - 包装方式、外箱尺寸与重量； - 检测与认证现状； - MOQ； - 月产能和交期； - 英文规格书、图片或目录是否齐全。 资料越完整，准备度和后续判断越可靠。 ### 第二步：第一次运行并查看HS候选 系统会依次执行： 1. 产品资料整理； 2. HS编码判断； 3. B2B公开平台情报； 4. 目标市场数据； 5. 贸易数据； 6. 准入资质； 7. 物流判断； 8. 报告生成。 第一次没有人工确认HS时，系统只生成候选，不会把第一名候选自动用于贸易查询。 ### 第三步：人工确认HS编码 1. 查看候选编码、描述和待确认问题； 2. 结合材质、结构、用途、工作原理和申报要素核实； 3. 在“人工确认HS编码”中填写本次候选中的六位编码； 4. 重新运行工作流。 注意： - 只能填写六位数字； - 编码必须属于本次候选； - 修改产品名称、材质或用途后，旧确认会自动清空； - 国际六位码不等于中国10位商品编码或目的国8/10位税号。 ### 第四步：填写价格竞争力参数 可填写： - 工厂单位成本； - 单位包装成本； - 订单数量； - 整票物流预算； - 目标毛利率； - 关税参考； - 美元兑人民币汇率； - 公开平台价格区间。 这些数据由用户填写，系统只做参考测算。正式报价前必须重新核对汇率、运费、税率和成本。 ### 第五步：生成和保存报告 报告包含： - 产品出口准备度； - HS编码与税率核查事项； - 市场机会和客户画像； - B2B竞争与价格参考； - 准入与物流条件； - 30天行动计划； - 数据来源、推断项和失败项。 重新运行会生成新版本，不应把旧版本直接覆盖。 ### 第六步：推送客户或报价 如需推送： - 勾选“将客户线索推送到客户与产品中心”； - 填写客户公司、联系人和联系方式； - 或勾选“将本次价格测算推送到客户报价”。 未登录时，系统不会写入企业客户、产品或报价资料。 --- ## 六、快速产品出口查询 适合只想先查HS候选和目标市场方向时使用。 1. 打开“出口情报 → 产品出口查询”； 2. 填写产品名称、材质、用途和安装方式； 3. 搜索并选择目标国家，单次最多8个； 4. 点击“实时生成HS候选”； 5. 查看以下页签： - HS编码； - 准入资质； - 市场建议； - 贸易数据； - 资料清单。 不要只填写模糊品名。比如“灯”应补充是否含电池、供电方式、功率、用途、防水等级和安装方式。 --- ## 七、产品档案使用方法 建议每个产品至少维护： - 中文和英文名称； - 规格型号； - 主要材质； - 用途和结构； - 包装尺寸、毛重和净重； - 工厂名称和生产能力； - HS候选及确认状态； - 成本记录； - 检测、认证和资质资料。 产品档案建立后，可以直接用于工厂筛查、出口情报和报价。 --- ## 八、客户管理使用方法 ### 客户智能开发 用于： - 建立客户开发任务； - 记录公开来源； - 对候选客户评分和分级； - 将有效候选转为正式客户。 公开网页上的邮箱、电话或社媒信息仍需人工核验，不应直接视为有效联系人。 ### 客户档案 建议记录： - 公司和联系人； - 国家、渠道和客户类型； - 联系方式和社媒账号； - 需求产品； - 跟进记录； - 报价和单证； - 内部备注。 包含联系方式、报价底价和银行资料的内容属于企业敏感数据，不应放入演示页面或公开链接。 --- ## 九、加工成本测算 依次填写： 1. 产品名称、原材料和生产数量； 2. 成品净材料重量； 3. 材料采购价； 4. 材料利用率和废料回收价； 5. 切割、机加工、焊接、表面处理、组装和包装费用； 6. 模具或工装分摊； 7. 管理制造费用率； 8. 目标毛利率。 系统输出单位成本、批次成本和参考报价。 > 正式页面默认值为空或为零，必须使用真实工厂数据后再采用结果。 --- ## 十、客户报价与PI ### 10.1 报价准备 填写： - 客户类型； - 贸易术语：EXW、FOB、CFR、CIF或DDP； - 币种和汇率； - 数量与单位成本； - 固定项目费； - 国内运输和港杂； - 国际运费和保险； - 税费和末端派送； - 目标毛利、渠道返利和附加费。 ### 10.2 阶梯报价 可添加多条规格和数量档位，分别设置： - 规格； - 数量； - 单位成本； - 优惠比例。 导出前检查总价、单价、币种、贸易术语和毛利率。 ### 10.3 PI必填资料 建议补齐： - 卖方中英文名称和地址； - 买方名称和地址； - PI编号和日期； - 产品中英文名称； - 规格、数量和包装； - 装运港、目的港和原产国； - 交期、付款条件和报价有效期； - 收款人、银行、账号和SWIFT。 银行信息属于高敏感资料，导出和发送前应由负责人复核。 --- ## 十一、单证制作与模板 系统支持的常用单证包括： - 报价单； - 形式发票PI； - 商业发票； - 装箱单； - 报关要素采集表； - HS归类资料表； - 目的国准入核查表； - 出口成本测算表。 操作步骤： 1. 选择单证类型； 2. 填写交易主体、产品、价格、数量、包装和运输信息； 3. 在预览区检查； 4. 导出Excel、Word或PDF； 5. 对照客户订单、合同和实际出货数据复核。 单证不得直接沿用演示数据或过期报价。 --- ## 十二、中国贸易数据使用方法 1. 打开“业务工具 → 中国海关数据”； 2. 输入HS 2位、4位或6位编码； 3. 选择年份； 4. 选择出口或进口； 5. 选择贸易伙伴； 6. 点击查询。 使用时注意： - 2025—2026记录可能是年内数据或尚未同步； - 年度数据与月报必须分开理解； - 无结果不等于没有贸易，可能是年份、伙伴、HS层级或同步口径问题； - 必要时改查上一级HS或最近完整年度。 --- ## 十三、准入与合规查询 1. 填写具体产品名称； 2. 选择目的国家或地区； 3. 选择HS章目； 4. 查看法规、认证、测试、标签和资料清单； 5. 打开官方来源进一步核验； 6. 记录核验日期和责任人。 系统展示的是核查路径，不是最终合规结论。正式出货前应由进口商、当地机构或专业顾问确认。 --- ## 十四、物流工具使用方法 填写： - 单件长、宽、高； - 总毛重； - 包装件数； - 产品数量； - 托盘数； - 液体容量（如适用）。 系统参考计算： - 总体积CBM； - 空运体积重量； - 快递体积重量； - 海运拼箱计费吨； - 20GP、40GP、40HQ体积占用。 最终计费以货代、航司、船公司或快递账单为准，还需考虑不可堆叠、承重、柜门尺寸和超长超宽等条件。 --- ## 十五、演示模式 演示数据只在明确带有 `demo=` 参数时加载，例如： ```text /?module=workflow&demo=malaysia-solar-lights /?module=quoting&demo=malaysia-solar-lights /workflows/factory/screening?demo=factory-solar ``` 演示模式的用途： - 培训； - 产品展示； - 流程演练； - 界面验收。 演示数据不得作为真实客户、真实报价或真实出货依据。正式页面不带 `demo=` 参数。 --- ## 十六、数据口径与责任边界 ### HS编码 - 系统输出的是候选； - 国际六位码需要继续映射到中国或目的国细分税号； - 最终归类应结合产品实物、材料、功能和申报要素。 ### 市场数据 - 世界银行指标可能来自不同最新年份； - 宏观数据不能直接代表单一产品的真实需求。 ### B2B平台数据 - 公开展示价不等于成交价； - 搜索结果不等于销量或有效买家； - 平台信息需要逐页核验和记录来源。 ### 成本与报价 - 汇率、税率、运费和成本会变化； - 正式报价前必须更新； - DDP等复杂术语应由目的国清关方复核税费和责任主体。 --- ## 十七、常见问题 ### 1. 为什么贸易数据没有自动查询？ 因为HS候选尚未人工确认。请从本次候选中确认六位编码后重新运行。 ### 2. 为什么修改产品后HS确认消失？ 这是安全设计，防止上一产品的HS编码被错误用于当前产品。 ### 3. 为什么正式页面是空白参数？ 正式页面不预填演示业务数据。请填写真实产品、成本和客户资料。 ### 4. 为什么保存时要求登录？ 客户、产品、报价、报告和企业资料都属于工作区数据，未登录用户不能写入。 ### 5. 为什么加入新企业后工作区变了？ 系统会把当前工作区切换到本次受邀企业。工作区Cookie只能选择当前账号具有有效成员权限的企业。 ### 6. 为什么中国贸易数据查询无结果？ 尝试： - 使用最近完整年度； - 查询HS 4位或2位汇总； - 更换贸易伙伴为全球； - 检查进出口方向； - 等待当年数据同步。 ### 7. 为什么不能继续使用旧ChatGPT身份迁移？ 旧迁移接口已因安全原因关闭，请使用正式平台注册或联系管理员处理。 ### 8. 数据会自动部署到阿里云吗？ 不会。当前版本只保留在本地，尚未部署或覆盖阿里云服务器。 --- ## 十八、客户公开信息背调 客户背调位于客户档案详情的“背调报告”标签页。它采用“人工查看公开来源 + 系统一致性评分”的方式，不自动爬取网页，也不把评分描述成企业信用保证。 操作步骤： 1. 打开客户档案并选择一位客户； 2. 进入“背调报告”； 3. 填写正式公司名称、官网、业务邮箱和公开地址； 4. 根据官网、企业目录、联系人公开资料逐项勾选一致性； 5. 每行填写一个公开证据链接； 6. 保存并重新评分； 7. 所有者或管理员确认无明显冲突且评分达到要求后，才可审核为“可联系”。 报告明确区分： - 候选客户开发优先级； - 公开信息一致性核验； - 已核验客户档案。 公开信息一致性核验不等于资信调查、制裁筛查或付款能力证明。官网名称、地址或邮箱域名冲突时，系统会提升风险等级并阻止直接审核为可联系。 ## 十九、我的出口项目 “我的出口项目”用于把一条外贸机会串起来： ```text 产品资料 → 市场评估 → 客户核验 → 报价与PI → 出口单证 ``` 入口： ```text /projects ``` 创建项目时可以选择产品和目标市场。项目页面会显示当前步骤、已关联资料和下一步入口。项目数据严格限制在当前工作区；旧产品、客户、报价和评估仍可以独立使用，不会被强制迁移。 ## 二十、新手单证向导 已有报价后，新手首页会把下一步引导到： ```text /?module=documents&wizard=1 ``` 向导可以选择： - 产品档案； - 客户档案； - 已保存报价； - PI、商业发票或装箱单。 系统会优先使用报价快照，并用产品、客户和包装记录补充字段。卖方、买方、产品、数量、贸易术语、币种和金额等阻断项缺失时不能带入编辑器；HS、港口、客户地址和包装信息可能仍需要人工补充。 向导只负责整理字段和风险复核，最终导出仍使用原有单页A4编辑器。正式出具前必须由卖方、出口方、报关主体、收款主体和客户复核。 --- ## 管理员操作建议 - 只给必要人员分配管理员权限； - 邀请成员前核对邮箱； - 定期删除失效邀请； - 离职成员及时移除权限； - 不通过聊天传播初始化密钥和银行资料； - 定期备份数据库、报价、单证和产品资料； - 部署前确认阿里云ECS、持久化数据盘、备份目录和HTTPS方案； - 正式发布前运行构建、测试、类型检查、生产依赖审计和健康检查。 ## 二十一、当前版本说明 当前为本地开发版，最终提交号以项目Git记录为准。 验证状态： - 标准Next.js生产构建通过； - 40项自动回归测试通过； - TypeScript检查通过； - 生产依赖漏洞为0； - Node运行时健康检查返回`{"ok":true,"runtime":"node"}`； - 桌面和移动端已有页面自动无障碍检查通过； - 独立安全与逻辑审查通过。 当前尚未部署到阿里云服务器。