快速捕捉与 AI 辅助

捕捉收件箱用于"先记录，再分类"：在市场行走期间，代理对供应商或产品拍照并加语音备注，然后继续走。稍后 — 在酒店或办公室 — 再处理每个条目，将其转换为字段完整的供应商或产品。

常见问题

捕捉收件箱有什么用？

为了不打断市场行走的节奏。代理不必在每个店铺停下填写完整的表单，而是打开集装箱的收件箱，拍照，可选地加语音备注，标记是供应商还是产品，然后继续。分类和完善留到稍后处理。

如何处理收件箱条目？

每个条目都有 处理 操作：

• 如果是供应商：系统打开供应商表单，并用现有数据预填（名片照片、OCR 如已启用）。
• 如果是产品：打开产品表单，如启用 AI 则可选地用 AI 建议预填。

保存后，条目被标记为 已解决，并关联到创建的供应商或产品。

我可以从收件箱捕捉询价请求吗？

可以 — 那是一种独立类型的条目。仅管理员可在询价集装箱中创建 — 完整流程见询价 FAQ。

AI 在生产环境中已启用吗？

目前没有。有两个 AI 功能，且都在生产环境中关闭，直到我们决定承担其成本：

• 图像识别：分析产品照片以建议描述、尺寸、价格等。
• 文字识别：对供应商名片进行 OCR 提取姓名、地址、联系方式。

捕捉收件箱本身在没有 AI 时也能工作 — 只是不会出现自动建议。

如何启用？

在应用的功能配置页面（仅超级管理员）。启用后，新捕捉的条目处理界面中会出现建议。

如果启用 AI，是否对已有收件箱条目生效？

不会自动生效。AI 在条目首次上传时执行。要对已捕捉的条目运行分析，处理界面中有 重新分析 按钮 — 但只有在图像识别开启时才显示。

语音备注会被转录吗？

暂时不会。它们以音频附件形式保存，代理在处理条目时收听。自动音频转文本是未来的增强。

谁可以看到集装箱的收件箱？

组织的管理员和分配到该集装箱的代理。终端客户看不到收件箱，即使在他们有运输标记的集装箱中也不行。

上线日期: 2026-03-21

客户查看用的共享链接

终端客户无需创建账户即可查看集装箱中属于自己的部分：代理通过 WhatsApp、邮件等方式发送一个唯一链接，客户即可查看自己的产品、提出变更请求，并跟进与代理的来回沟通。数据隔离有保证：客户只能看到根据运输标记分配给自己的内容。

🎥 视频演示（西班牙语音频）: https://jaomai.store/videos/customer_changes_es.mp4

常见问题

如何为客户生成共享链接？

在集装箱视图的共享链接部分，点击"创建链接"并选择客户。系统会生成一个唯一（不可猜测）的 URL，并带有可配置的过期时间。你可以通过任何方式发送给客户。

客户打开链接后看到什么？

只看到集装箱中分配给自己公司运输标记的产品。看不到其他客户的产品，也看不到与自己无关的集装箱总量。该页面是公开的（无需登录），但内容仅限于该链接对应的客户。

客户可以从链接里请求变更吗？

可以。在每个产品上，可以将状态改为 已确认 或 已取消，修改数量，并留下评论。请求不会立即修改产品 — 而是作为请求保留，由代理在自己端接受或拒绝。

代理如何响应客户的请求？

代理在产品视图上会看到黄色提示，显示客户请求的数量和评论。可选：

• 接受：系统更新产品的数量或状态，并将对话记录到历史中。
• 拒绝：必须写明拒绝原因（例如："供应商已生产纸箱，无法取消"）。客户在下次访问链接时会看到拒绝及其原因。

整个对话保存在每个产品的变更历史中，双方都可以查看。

链接的有效期多长？

默认为创建后 2 小时。每个组织都可以在自己的配置中调整有效期。已过期的链接会显示明确的页面，并提供重新生成的选项。

我可以在过期前手动停用链接吗？

可以。在集装箱的共享链接部分，任何有效链接都可以手动停用 — 客户下次打开 URL 时会看到"链接已过期"的页面。

客户能看到供应商名称吗？

取决于配置。组织可以默认隐藏供应商名称，且每个集装箱可以覆盖该决定（始终显示 / 始终隐藏 / 使用默认）。当你不希望终端客户自行联系供应商时很有用。

是否有展示完整流程的视频？

有：上面链接的视频演示。涵盖链接创建、客户的请求、代理的接受和拒绝，以及所有过程如何为双方留下记录。

上线日期: 2026-04-03

按供应商分组的采购订单（OC）

每个集装箱为每个供应商生成一份有效的 OC：该集装箱内同一供应商的所有产品会自动汇总到一份 PDF 中，可直接发给工厂。当产品发生变化时，OC 会被标记为已过期，一键即可使用最新版本重新生成。

常见问题

如何生成 OC？

在按供应商分组的集装箱视图中，每个供应商区块都有 生成 OC 按钮。点击后，系统会用该供应商在此集装箱内所有已确认的产品生成 PDF：编号、描述、数量、单价、CBM、重量、照片和纸箱标签。

同一个集装箱内同一个供应商可以有多份未结的 OC 吗？

不可以。每个集装箱内每个供应商只有一份有效的 OC。如果已经存在有效的 OC，"生成 OC" 会打开重新生成而不是复制一份。重新生成之前的旧版本会保留为历史记录。

为什么 OC 显示为"已过期"？

因为某个产品在上次生成后发生了变化。任何对产品数据的修改都会将其标记为已过期 — 不仅是数量，还包括描述、价格、CBM、重量、尺寸、颜色、规格、品牌、材质或纸箱标签文字。你会看到 OC 上有 已过期 标记和一个重新生成按钮。

如何重新生成已过期的 OC？

从供应商区块或供应商页面（也列出其近期 OC）点击重新生成按钮。新 PDF 取代旧的成为有效 OC；旧版本保留为历史记录。

除了产品数据，OC 上还显示什么？

• 页眉包含你所在组织的 徽标、名称和地址（可在"我的账户 → 公司"中配置）。
• 客户的运输标记及其菱形图。
• 纸箱标签：文字可编辑，含搬运 图标：此面朝上、保持干燥、禁踏、可回收。编辑标签也会将 OC 标记为已过期。
• 纸箱尺寸（宽 × 高 × 深），便于工厂在装箱时无需二次查询即可决定。

在哪里找到某个供应商的 OC？

在供应商页面，产品部分下方有该供应商近期 OC 的列表，带 有效 / 全部 筛选。集装箱按供应商分组的产品视图也有直达供应商页面的链接。

是否有发给终端客户（而非供应商）的等效文档？

有：按供应商的 形式发票（PDF 和 Excel）以及按供应商分组的整箱导出。后者可以将供应商分组匿名化，便于在不暴露具体供应商身份的情况下分享给客户。

谁可以生成和重新生成 OC？

任何对该集装箱有访问权限的用户（管理员或被分配的代理）。终端客户无法访问 OC 流程。

上线日期: 2026-04-26

集装箱生命周期

每个集装箱从买家开始规划到货物抵达目的地，会经历一系列状态。系统使用这些状态在正确的面板中展示集装箱，并启用特定操作（例如上传封箱照片或记录发运日期）。

🎥 视频演示（西班牙语音频）: https://jaomai.store/videos/container_lifecycle_es.mp4

常见问题

集装箱有哪些状态？

按顺序：

1. 计划中 — 代理录入产品、上传照片、设定价格。初始状态。
2. 下单 — 产品已确认；按供应商生成 OC。
3. 装载 — 货物在仓库接收，准备装箱。
4. 已封箱 — 集装箱已关闭，附封条照片。
5. 运输中 — 集装箱已发运；记录发运日期。
6. 已交付 — 抵达目的地。

外加一个特殊状态：已取消，不在正常流程中但保留数据。

如何切换状态？

在集装箱页面有一个状态切换按钮，根据当前状态提供有效选项。系统会校验集装箱在前进前是否满足要求（例如，未加载产品不能进入"已封箱"）。

控制面板上每个状态有单独的面板吗？

是的。控制面板按状态分组集装箱：询价、计划中、下单、装载、已封箱、运输中、已交付（可选地通过开关显示已取消）。这样可以一目了然地看到每个阶段需要处理什么。

我可以在任何状态下取消集装箱吗？

可以。在集装箱的编辑页面，取消集装箱按钮在任何状态下都可用。取消不删除数据，仅将状态改为"已取消"并将其从总量中排除。重新激活也在同一视图中可用 — 集装箱会回到"计划中"状态。

删除集装箱会发生什么？

删除是软删除：集装箱从视图中消失，但数据仍保留在数据库中。超级管理员可以从管理界面恢复。产品、供应商和运输标记也是逻辑删除，而非物理删除。

什么是集装箱类型，有什么用？

每个集装箱有一个类型（例如"40ft 高柜"），带有最大体积和最大重量。当加载的产品超过这些限制时，应用会在集装箱页眉显示视觉警告："体积 / 重量超载"。不会阻止操作，仅提示你调整装载。

共享集装箱有什么不同？

共享集装箱中存在多个运输标记（一个集装箱内多个客户）。通过创建时的开关标记。在这种情况下，体积/重量限制是可选的（每个客户可以有个人上限或没有），且产品在导出时按运输标记分组。

谁可以切换状态？

组织的管理员和分配的代理。终端客户和询价集装箱有单独的流程，不使用这些状态。

是否有展示完整循环的视频？

有：container_lifecycle_es.mp4。涵盖集装箱从"计划中"到"已交付"的创建过程，展示每个状态下的变化和启用的操作。

上线日期: 2025-09-21

代理 ↔ 买家询价流程

买家在标记为询价的集装箱中创建询价请求（含照片和描述），代理通过走访市场并录入带供应商和价格的产品来响应。响应会按价格排序聚合在每个请求下，便于买家比较和选择。

🎥 视频演示（2:13，西班牙语音频）: https://jaomai.store/videos/agent_quote_es.mp4

常见问题

什么是询价集装箱？

仅用于询价的集装箱 — 不是确认订单。它显示在控制面板的询价区域，与计划中的集装箱分开。在该面板上点击"+"按钮创建。

如何发起询价？

打开询价集装箱并在询价请求部分点击 + 新请求。如有照片可上传，写下你需要询价的内容描述（例如："黑色防水学生背包，约 25 升"）后保存。每个请求都是一张独立的卡片。

谁创建请求，谁负责响应？

• 请求：由买家创建，代表终端客户希望询价的内容。
• 响应：由分配到该集装箱的代理录入。每个响应都是一个带有供应商、产品编号、价格和照片的产品。

代理如何响应请求？

从请求卡片点击 询价 按钮，打开已与该请求关联的新产品表单。代理录入供应商、产品编号、单价、尺寸等信息后保存。响应会自动与原始请求关联。

一个请求可以有多个响应吗？

可以 — 这正是设计意图。代理可以为同一个请求带来不同供应商的多个报价。卡片会显示"3 个报价"并列出价格。买家一目了然地比较。

如何在收到的报价之间选择？

响应会按价格从低到高排序显示在每个请求下方，附带供应商的店铺编号和产品编号。点击任意一个即可打开产品详情。

何时从询价转为真实订单？

目前还不能自动转换 — 将询价集装箱推广为正式订单是计划中的下一阶段。现阶段，一旦确定了胜出的报价，买家创建一个新的订单集装箱并将选中的产品录入到那里。

未被分配到该集装箱的代理能看到什么？

什么都看不到。每个代理只能看到分配给自己的集装箱。其他代理的请求和报价彼此不可见。

是否有展示完整流程的视频？

有：上面链接的视频演示（2:13 分钟，西班牙语音频）。涵盖 10 个场景：买家创建请求 → 代理用两个不同供应商提交两次报价 → 买家看到按价格排序的两个响应。

上线日期: 2026-05-02

从 Excel 批量导入产品

在集装箱页面，你可以一次性上传所有产品的 Excel 表格 — 照片直接嵌入到单元格中。当代理希望先在表格中准备完整产品清单再上传时非常实用。

常见问题

在哪里导入？

在集装箱视图的产品部分，有 导入产品 入口。从该页面下载模板，填写后上传。

必须使用可下载的模板，还是任何 Excel 都可以？

必须使用模板。系统会校验列名，如果缺少必填列会拒绝导入。模板已预设好正确的列宽和示例行，方便你了解每个字段应填什么。

哪些列是必填的？

四列： supplier_name、product_reference、units_per_carton 和 unit_price。

其余可选：shipping_mark、description、sample_photo（嵌入图片）、box_reference、unit_type、carton_count、currency、estimated_cbm、width_cm、height_cm、depth_cm、weight_kg、color、size、material、brand、label、order_number、order_date、delivery_date。

如何加载照片？URL？文件？

将图片直接粘贴到 sample_photo 列的单元格中。导入器会提取嵌入的图片并关联到该行对应的产品。导入时每个产品一张图片；之后可以从编辑界面添加更多。

如果供应商还不存在怎么办？

导入会按名称在你所在组织的供应商中查找。如未找到，该行会因"供应商未找到"错误而失败，但表格的其余部分继续处理。你需要在导入前先创建新供应商（手动创建，或从产品表单逐个创建）。

运输标记按名称还是按编号识别？

按精确名称，且只接受已分配给该集装箱的运输标记。如果列为空且集装箱只分配了一个标记，系统默认使用它。如果有多个且列为空，该行会以明确的错误信息失败。

如果某行的产品在集装箱中已存在怎么办？

会被标记为重复（不会创建任何内容），并附带现有产品的链接，由代理决定是编辑原产品还是更改产品编号。规则与单条录入一致：在集装箱内"供应商 + 产品编号"必须唯一。

如果某行失败，整个导入都会被取消吗？

不会。导入器逐行处理，并在最后报告创建了多少行、失败多少行、重复多少行。你可以在 Excel 中修正失败的行后重新导入 — 已成功的保留，重复的继续被标记为重复。

导入的行为与手动录入产品一致吗？

是的 — 这是核心原则。校验规则与快速产品表单一致。必填列为空时该行失败。数字格式错误时也失败。不会因为来自 Excel 而更宽松。

此导入会识别已存在于其他集装箱的产品吗？

暂不会。该识别功能计划在下一阶段实现。目前的"此产品已存在于其他集装箱"提示仅在表单逐个录入时生效。

上线日期: 2026-04-26

跨集装箱的重复产品识别

当代理在市场上再次遇到之前已录入到其他集装箱的产品 — 同一店铺、同一编号 — 系统会自动识别，并提供从上次记录复制数据的选项，避免重复录入。这是跨次出差的"机构记忆"。

常见问题

如果我录入一个之前在其他集装箱已录入过的产品，系统会识别吗？

会。在"新产品"表单中，一旦你选择了供应商并输入了产品编号，字段下方会出现蓝色提示：

ℹ️ 此产品已存在于 CONT-2025-014 (3 个月前) 上次记录有 2 张照片 [📋 复制上次的数据]

提示仅供参考。你可以忽略它，从零开始录入产品。

"复制上次的数据"具体会做什么？

• 自动填充空字段：描述、价格、每箱数量、CBM、重量、尺寸、品牌等。
• 如果你已经在某个字段输入了内容，不会被覆盖 — 你手动输入的内容会被保留。
• 同时也会带入上一个产品的照片，除非你已经上传了自己的照片。

如果我在同一个集装箱里两次创建相同的产品会怎样？

系统会以明确的错误信息拒绝：在同一集装箱内"供应商 + 产品编号"的组合必须唯一 — 这就是同一个 SKU 重复了，你应该编辑现有产品而不是再创建一行。

其他代理能通过这个识别功能看到我的数据吗？

不能。每个代理只能看到自己被分配的集装箱里的产品。如果你负责集装箱 A，另一个代理负责集装箱 B，系统永远不会基于集装箱 B 的内容向你显示提示。

跨组织呢？

完全隔离。一个组织永远看不到另一个组织的数据，即使是产品识别也不行。

终端客户能使用此功能吗？

不能。识别功能仅供员工（管理员和代理）使用。终端客户不参与此流程。

Excel 批量导入也支持这种识别吗？

暂不支持。这是下一阶段的工作。目前批量导入遵循与单条录入相同的规则（在集装箱内拒绝重复），但不会自动提供"复制上次的数据"选项。

上线日期: 2026-05-07

代理角色

代理角色面向代表买家在市场工作的外部协作者。他们对特定集装箱有受限访问：可以录入产品、生成 OC 和响应询价请求，但看不到组织的全局目录或其他代理的数据。

常见问题

如何创建代理用户？

作为管理员，进入 设置 → 用户 → 新建，选择"代理"角色。表单允许你在同一步为该代理分配一个或多个现有集装箱。同时生成登录用的邮箱+密码。创建后，代理下次登录时会在自己的控制面板看到该集装箱。

如何为已存在的代理分配集装箱？

在集装箱的编辑页（分配的代理 字段），从下拉菜单选择代理。或在代理用户的编辑页，勾选你要分配的集装箱。

只有管理员可以分配或重新分配代理。

代理在控制面板上能看到什么？

只能看到分配给自己的集装箱。组织中的其他集装箱对他们不可见，包括询价集装箱。

代理在分配给自己的集装箱内可以做什么？

• 创建、编辑和删除产品。
• 现场创建新供应商（产品表单上的"+ 新供应商"）。
• 按供应商生成 OC。
• 响应询价集装箱中的询价请求。
• 查看集装箱的收件箱并处理条目。
• 上传产品照片。

代理不可以做什么？

• 访问组织的全局页面（供应商、客户或运输标记 — 会跳转回控制面板）。
• 查看其他代理的集装箱 — 即使直接输入 URL 也不行。
• 创建新集装箱。
• 创建或管理用户。
• 查看其他组织的数据。

为什么代理在搜索供应商时只能看到部分？

为了避免暴露组织的完整目录，代理的供应商搜索仅限于可见供应商：那些已经在自己分配的集装箱中至少有一个产品的供应商。如果在市场上发现新供应商，使用产品表单上的"+ 新供应商"，系统会创建该供应商（如果已经有相同店铺编号的，则静默复用）。

代理能看到另一个代理在另一个集装箱中录入的产品吗？

不能。跨集装箱的产品识别按代理隔离：每个代理只基于自己分配的集装箱获得提示。代理之间不存在信息泄露。

一个代理同时可以是客户吗？

不能。每个用户有唯一的角色。如果同一个人需要同时以客户和代理身份访问，目前需要两个独立账户。

上线日期: 2026-05-01