巴西发票同步巴西电商平台，预算一百万

业财一体化进销存软件开巴西发票同步巴西电商平台，预算一百万，资金已经验证过是真实的

要求：费用全额托管到平台，中间开发拿不到一分钱，做完结算，没有定金、预付款、分阶段付款的说话，项目相对而言较大，开发周期长，不符合的不要报名



全渠道零售一体化智能管理平台

软件需求规格说明书（SRS）

文档版本： V9.5（最终定稿·外卖平台对接增强版）

撰写人： [您的姓名]

日期： 2026-03-11



修订记录

版本 日期 修订内容 修订人

V5.0 2026-02-16 完整版发布，补充所有业务细节 [您的姓名]

V5.1 2026-02-16 修正收银员/销售员职责区分，补充合并/拆分设置 [您的姓名]

V5.2 2026-02-16 补充开班/交班清点及储备金管理，增加界面自定义配置 [您的姓名]

V5.3 2026-02-18 增强AI智能运营、生态集成、业务精细化、风险控制及开发者生态 (注：AI部分二期) [您的姓名]

V5.4 2026-02-18 增加第三方系统迁移工具，完善数据导入能力 [您的姓名]

V5.5 2026-02-20 整合支票管理、异构数据迁移、逻辑删除、订单快照、批量修改撤销、合并开票及进销存防查模式（混合策略） [您的姓名]

V5.6 2026-02-21 补充触摸屏支持、重构财务模块、增加爆款优先打印与10×15热敏纸同时打印发票/面单功能 [您的姓名]

V6.0 2026-02-21 整合用户语言偏好、个性化快捷菜单（自定义名称+组合快捷方式） [您的姓名]

V6.1 2026-02-22 新增第三方平台流量向独立网站引导模块（跨域引流、包裹物料、专属优惠码、效果追踪） [您的姓名]

V6.2 2026-02-22 增强会计科目与会计账户自定义功能：科目层级继承、预算预警、多版本管理、多维度辅助核算、科目级权限、外币核算增强、科目变更审批、明细账自定义 [您的姓名]

V7.0 2026-02-23 全面增强：移动端专属功能、多公司/多门店/多仓库管理、供应链金融与信用管理、售后与维修管理、项目型业务管理、营销自动化、自定义报表与分析、系统监控与运维、数据归档策略、国际化支付方式、多级审批工作流、税务规则细化 [您的姓名]

V7.1 2026-02-23 新增GNRE自动生成模块，完善跨州税务合规能力 [您的姓名]

V7.2 2026-02-23 新增独立网站结构与样式自定义功能，提升私域商城可定制性 [您的姓名]

V7.3 2026-02-23 增强多库存状态管理、AI智能故障诊断（注：AI功能二期开发）、软件公司-用户互动平台、内部协作交流，完善离线授权控制与多渠道发票支持 [您的姓名]

V7.4 2026-02-24 明确并细化打印机连接方式：增加蓝牙、Wi-Fi网络、PC共享USB、云打印四种具体连接方式的强制要求，完善移动打印场景与验收标准 [您的姓名]

V7.5 2026-02-24 根据率、会计科目性能、AI验收标准(AI功能二期开发)、防查模式隐藏实现、移动端功能一致性、数据实体字段补充、通用模糊点等 [您的姓名]

V7.6 2026-02-28 在3.8.1节中增加自研API渠道，完善多渠道发票发送能力，支持接入甲方自研税务API [您的姓名]

V7.7 2026-02-28 在3.1.1节中增加翻译质量管理机制，系统性解决多语言翻译生硬问题 [您的姓名]

V7.8 2026-03-01 新增3.1.11节“变量管理功能”，统一管理界面文本、多语言、自定义菜单等，提升系统可配置性 [您的姓名]

V7.9 2026-03-09 新增3.6.5.1节“分批开票（按比例开票）”，支持基于发货/服务进度的合规部分开票，完善分期收款与税务联动 [您的姓名]

V8.0 2026-03-09 新增3.3.7节“进口报关单（DI/DUIMP）导入与进口成本核算”，支持巴西官方进口文件自动解析、税费计算、一键生成采购入库单（注：参考老系统完善DI导入自动计算逻辑） [您的姓名]

V9.0 2026-03-09 新增第3.25节“分布式生产管理”，支持多工厂、多工序的成品/半成品/在制品数量跟踪，提供全流程可视化 [您的姓名]

V9.1 2026-03-09 新增3.6.5.3节“选择性开票与发票列表分离”，增强订单列表可见性控制（权限过滤），完善客户自助申请开票与发票同步选项 [您的姓名]

V9.2 2026-03-10 新增3.2.5节“重复数据检测与报警（客户/供应商/运输公司）”，实现主数据录入时的重复识别与预警，支持精确匹配与模糊匹配，提供合并建议 [您的姓名]

V9.3 2026-03-10 新增产品“前台备注”字段，支持多语言，并在私域商城、POS、移动端前台对会员可见，方便中介模式添加联系方式或特殊说明 [您的姓名]

V9.4 2026-03-10 新增3.3.7.8节“商业发票（DIR）导入与预申报处理”，扩展进口自动化能力；新增3.9.7节“佣金计算规则引擎”，实现灵活的多角色佣金计算与分账（注：佣金计算与外卖同为二期） [您的姓名]

V9.5 2026-03-11 新增3.10.4节“外卖平台对接”，详细描述巴西主流外卖平台（iFood、Rappi、Uber Eats）的订单接入、处理流程、状态同步、配送跟踪、财务结算等要求；在3.6.6.4节中补充外卖小票模板要求；在3.9.7节中补充平台佣金规则配置；在套餐组合中增加“外卖平台集成”可选模块；补充相关业务规则与验收标准（注：外卖平台对接二期开发） [您的姓名]



1. 引言

1.1 项目背景

本项目旨在为巴西及国际化市场打造一套集采购、销售、库存、财务、客服、生产、人事于一体的全渠道智能管理平台。系统需支持线上线下多渠道业务融合，满足巴西本地税务合规要求，具备分布式部署、断网操作能力，并提供灵活的模块化套餐以适应不同规模商户的需求。

1.2 项目目标

•构建一个高度集成、可扩展的企业管理平台，覆盖零售、批发、电商等全渠道业务。

•实现巴西税务（NFe/NFCe/GNRE）的自动化处理与合规，支持离线开单、在线开票。

•提供智能化的合约管理、客户关系管理、财务核算与报表分析。

•通过AI能力（智能客服、数字人直播、智能运营决策、智能运维）提升商户服务与管理效率。（注：AI部分二期开发）

•支持模块化订阅（套餐），满足从个体户到中型企业的不同需求。

•建立开放平台生态，支持第三方开发者及深度集成。（注：开放平台二期）

•提供平滑的第三方系统迁移工具，降低客户切换成本。

•实现灵活、安全的“防查模式”，满足突击检查下的数据隐蔽需求。

•打通第三方平台与独立站之间的流量通道，实现公域向私域的有效转化。

•构建高度可配置的会计科目与账户体系，满足多维度财务核算需求。

•提供完整的移动端作业能力，支持多公司/多门店/多仓库协同，完善供应链金融、售后维修、项目管理等业务场景。

•为私域商城提供强大的结构与样式自定义能力，实现品牌差异化。

•实现精细化库存状态管理（可用、在途、锁定、安全库存）；引入AI智能运维（注：AI功能二期），主动发现故障原因并提供解决方案；搭建软件公司与用户之间的互动平台；提供内部协作交流工具；完善离线环境下的合约授权控制；支持多种本地/云端发票发送渠道。

•新增打印目标：确保手机端（移动终端）可通过蓝牙、Wi-Fi网络、PC共享USB、云打印四种方式自由、稳定地完成打印任务，满足仓库、门店、办公室等多种移动场景需求。

•新增翻译质量目标：确保多语言界面翻译地道、术语统一、符合本地文化习惯，避免机器翻译生硬问题，提升用户体验。

•新增变量管理目标：通过统一的变量管理机制，实现界面文本的全面可配置，支持多语言、多级覆盖、用户个性化自定义，降低维护成本，提升系统灵活性。

•新增分批开票目标：支持根据发货进度或服务进度按比例分次开具发票，满足分期结算的合规需求。

•新增进口成本核算目标：自动解析巴西官方进口报关单（DI/DUIMP），准确计算进口税费并生成采购入库单，实现进口业务全流程自动化。

•新增分布式生产管理目标：实现多工厂、多工序生产过程的透明化，实时跟踪成品、半成品和在制品数量，提升生产协同效率。

•新增开票控制目标：实现订单与发票管理分离，提供选择性开票、订单列表权限过滤、客户自助申请开票等能力，满足精细化管控需求。

•新增重复数据检测目标：通过智能检测机制，防止客户、供应商、运输公司等主数据的重复创建，确保数据清洁度，提升业务效率。

•新增前台备注目标：为商品添加面向会员的备注字段，支持多语言和灵活显示，增强中介模式下的信息传递能力。

•新增DIR导入目标：支持商业发票（DIR）的自动导入与预申报处理，进一步扩展进口自动化流程，覆盖从预申报到清关的全链路。（注：参考老系统完善DI导入自动计算逻辑）

•新增佣金规则引擎目标：构建灵活的佣金计算规则引擎，支持多角色、多场景的佣金计算与分账，满足复杂的分销、合作、中介模式需求。（注：佣金计算和外卖同为二期）

•新增外卖平台对接目标：实现与巴西主流外卖平台（iFood、Rappi、Uber Eats等）的无缝对接，支持订单自动接入、状态同步、库存管理、配送跟踪及财务结算，满足餐饮及零售商户的外卖业务需求。（注：外卖对接二期）

1.3 文档范围

本文档定义了系统的全部功能性需求、非功能性需求、数据需求及核心业务规则，是后续设计、开发、测试、验收的唯一依据。

1.4 定义与缩写

术语 说明

POS 销售终端，指快速开单打印场景

NFe 巴西电子发票（企业间）

NFCe 巴西电子发票（零售消费）

CNPJ 巴西法人国家登记号（企业税号）

CPF 巴西自然人登记号（个人税号）

CFOP 税务操作代码，标识交易性质

CST 税收情况代码（正常税制企业）

CSOSN 税收情况代码（Simples Nacional税制企业）

FMS 业务财务系统

DTC 直接面向消费者的私域商城

OMS 订单管理系统

PWA 渐进式Web应用，可免安装使用

LGPD 巴西通用数据保护法

开班清点 收银员上班时领用备用金并在系统中登记

交班清点 收银员下班时结算销售额、交回备用金，系统自动对账

储备金 收银员为找零而预领的现金

Webhook 通过HTTP回调实现实时事件通知的机制

策略A/策略B 防查模式下的两种数据存储策略。A为本地存储隐藏，B为云端存储本地删除

背书人 在支票背面签字以将支票权利转让给他人的人

被背书人 接受背书转让支票的人

出票人 签发支票的人

逻辑删除 数据在数据库中标记为已删除，但物理上仍存在

物理删除 数据从数据库中彻底移除

订单快照 订单修改前保存的完整数据副本

DDC Declaração de Conteúdo，跨境申报单

UTM参数 Urchin Tracking Module，用于追踪广告来源的标准参数

Link-in-bio 社交媒体个人简介中的链接聚合页

归因分析 确定多个营销触点中哪些对转化贡献最大的分析方法

辅助核算 在会计科目基础上附加的核算维度（如客户、供应商、部门、项目）

RFM模型 根据最近一次消费、消费频率、消费金额进行客户价值分析的方法

SLA 服务等级协议

WBS 工作分解结构

GNRE Guia Nacional de Recolhimento de Tributos Estaduais，州税全国征收单

Receita 收款码，标识GNRE对应的具体税种

UF Favorecida 收款州，即税款归属的州

页面构建器 可视化拖拽式页面设计工具

可用库存 当前可销售或可使用的实际库存数量

在途库存 已采购但尚未入库的库存数量

锁定库存 已被订单预占但尚未出库的库存数量

安全库存 为防止缺货而设定的最低库存警戒线

AI运维助手 基于AI的系统运维辅助工具，可分析日志、诊断故障、提供解决方案（注：AI在二期，基础的运维日志诊断一期会有）

用户互动平台 软件公司与所有商户之间的信息交互渠道

内部协作平台 商户内部员工的沟通工具（注：像微信这种即时通讯的聊天工具在二期）

License文件 包含授权信息的加密文件，用于离线控制合约期限

硬件指纹 用于绑定软件到特定机器的唯一标识（如CPU ID、MAC地址）

时间回拨检测 防止用户通过调低系统时间绕过授权过期的机制

蓝牙打印 通过蓝牙直连打印机进行无线打印

Wi-Fi网络打印 通过局域网连接网络打印机进行打印

PC共享USB打印 通过PC共享USB打印机，手机经网络转发任务

云打印 通过互联网将打印任务发送至云端打印机

SMB 服务器消息块协议，用于Windows网络共享

IPP 互联网打印协议，网络打印机标准协议

ESC/POS 热敏打印机标准指令集

术语库 存储标准业务术语及其译法的数据库，用于强制统一翻译

翻译记忆库 存储已人工确认的翻译句段，用于复用和持续优化

变量 界面文本的抽象标识符，每个变量有唯一ID，可配置不同作用域下的值

作用域 变量值的生效范围，包括全局、客户、用户等层级

分批开票 将一个订单拆分为多张发票，每张发票基于已交付商品/服务按比例生成，符合税务要求

DI Declaração de Importação，巴西进口报关单

DUIMP Declaração Única de Importação，单一进口报关单（SISCOMEX新系统） （注：参考老系统完善DI导入自动计算逻辑）

II Imposto de Importação，进口税

IPI Imposto sobre Produtos Industrializados，工业产品税

PIS-Importação 进口社会一体化费

COFINS-Importação 进口社保金融贡献费

ICMS-Importação 进口商品流通税

SISCOMEX 巴西外贸综合系统

工单 生产指令单，明确生产什么产品、数量、计划时间、负责工厂

工序 产品生产过程中的一个作业步骤，可定义顺序、标准工时、投入产出物料

在制品 (WIP) 正在生产线上加工但尚未完成本工序或全部工序的半成品

半成品 已完成部分工序，可作为独立物料入库或供后续工序使用的中间产品

报工 工序完成后，操作员汇报实际完成数量、工时等信息

工序转移 在制品从一个工序流转到下一工序，或在不同工厂间转移

工厂间调拨 将物料（原材料、半成品、成品）从一个工厂调拨到另一个工厂

选择性开票 允许用户从订单列表中勾选一个或多个订单手动触发开票，支持合并/分别开票

订单列表可见性控制 通过权限配置限制特定角色查看未开票订单

重复数据检测 通过精确匹配和模糊匹配算法，识别并预警主数据（客户、供应商、运输公司）中的重复记录

前台备注 商品的一个额外说明字段，内容可在前端对登录会员展示，常用于添加联系方式、特殊提示等

DIR Declaração de Importação de Remessa，商业发票/进口货物申报单，用于预申报或内部记录（注：参考老系统完善DI导入自动计算逻辑）

佣金规则引擎 可配置的佣金计算规则，支持按金额、比例、阶梯、多角色分账等

iFood 巴西最大的外卖平台

Rappi 拉丁美洲外卖平台，在巴西运营

Uber Eats 优食，全球外卖平台，在巴西提供服务

KDS Kitchen Display System，厨房显示系统，用于展示外卖订单

取餐码 顾客自取或骑手取餐时用于核销的二维码或数字码

PIN码 个人识别码，用于配送员送达时验证 （注：外卖对接部分在二期）



2. 总体描述

2.1 产品愿景

为商户提供一套“零思考、极速开单、全渠道合规”的智能管理工具，在3秒内完成开单，自动处理税务与财务，实时同步线上线下数据，并通过AI与生态集成助力商户高效运营与决策。同时，通过平滑的数据迁移工具，帮助商户轻松从其他系统切换至本平台，并提供灵活可靠的防查模式以应对突击检查。通过精细化库存管理、AI智能运维和内置协作平台，进一步提升商户的管理效率与系统可靠性。打印功能需实现全场景无线化、自由移动化，确保手机端在任何位置均可通过多种连接方式完成打印。 多语言翻译需实现地道、术语统一，确保巴西本地用户及其他语种用户获得原生体验。 通过变量管理功能，实现界面文本的全面可配置，支持多语言、多级覆盖、用户个性化自定义，降低维护成本，提升系统灵活性。 通过分批开票功能，支持分期结算的合规需求。 通过进口成本核算功能，实现进口业务全流程自动化。 通过分布式生产管理，实现多工厂生产透明化。 通过开票控制功能，实现订单与发票分离、权限控制、客户自助开票，提升管控能力。 通过重复数据检测功能，确保主数据清洁度，避免重复录入，提升数据质量。 通过前台备注功能，支持中介模式下灵活传递信息，提升平台与会员的沟通效率。 通过DIR导入功能，扩展进口自动化至预申报环节，实现从商业发票到清关的全链路自动化。 通过佣金规则引擎，支持灵活的多角色佣金计算与分账，满足复杂的分销、中介、合作模式需求。 通过外卖平台对接，实现与iFood、Rappi、Uber Eats等主流外卖平台的深度集成，支持订单自动接入、厨房显示、配送跟踪及财务结算，满足餐饮零售商户的外卖业务全流程管理。

2.2 用户角色与权限

角色 职责 核心权限

超市收银员 超市日常收银 只负责扫描商品、输入数量、打印小票、收款（现金找零），无权修改价格/折扣。开班需领用储备金，交班需结算。如需修改价格需主管授权。

销售员（批发/零售） 销售业务、客户谈判 可与客户商谈价格与折扣，可修改订单金额/折扣，查看自己客户的订单和佣金，无找零职责，不涉及储备金管理。

主管 现场管理 可临时授权收银员修改价格，审批退货，查看交班差异，接收防损预警，并在授权范围内切换本终端防查策略、触发全局检查模式。

财务/会计 账务处理、报税 可查看所有财务凭证、发票XML、工资计算、报税报表、收银员交班差异。

财务经理 财务审核、预算控制 审批科目变更、设置预算、查看科目级报表、分配财务人员权限、审批信用额度调整。

财务总监 财务决策 查看所有财务报表、审批大额预算调整、审批一级科目变更、审批授信政策。

仓库管理员 库存管理、拣货 可查看库存、打印拣货单，无权修改价格。支持移动端PDA操作。

采购员 采购管理 可查看供应商、采购订单，无权查看销售数据。

售后专员 售后处理、维修管理 处理退货、换货、维修申请，跟踪维修进度，管理备件。

项目经理 项目管理 创建项目、分配任务、跟踪项目进度、归集项目成本。

市场运营人员 流量投放、活动策划 配置引流话术、生成优惠码、管理Link-in-bio页面、查看引流效果报表、配置自动化营销流程。

网站设计师 网站自定义 拥有私域商城页面构建器的全部权限，可自由设计网站结构、样式、发布页面。

税务专员 税务处理 管理GNRE生成、发送、缴款，查看税务报表，处理税务异常。

系统管理员 系统配置、权限分配 最高权限，可配置所有规则、套餐、用户、界面模板、开放平台接入，执行第三方数据迁移，管理全局防查模式，拥有物理删除权限。

线上客户 自助下单 查看订单状态、付款状态、合约信息。

开发者 基于开放平台进行二次开发 可访问API文档、沙箱环境，订阅Webhook事件。

系统运维人员（商户内部） 负责商户内部系统的日常运维，监控系统健康状态，处理异常 查看系统监控面板、日志、性能指标；接收AI运维助手的故障诊断报告；执行系统维护操作。

软件公司管理员 管理整个SaaS平台，发布公告，组织投票，处理用户反馈 拥有用户互动平台的管理权限，发布全局通知，创建投票，查看需求提交记录。

普通员工（内部协作） 参与公司内部交流 查看内部公告，参与内部论坛讨论，使用即时通讯。

打印机管理员 负责打印机配置、维护、耗材管理 在后台添加/删除打印机，配置打印机参数（连接方式、默认模板、纸张类型），查看打印任务日志

翻译管理员 管理多语言翻译质量 维护术语库、审校翻译、处理用户翻译反馈、更新语言包

变量管理员 管理界面文本变量 维护变量定义、设置多级作用域值、管理导入导出、查看变量使用情况

生产主管 生产计划与调度 创建工单、分配任务、监控生产进度、处理异常

车间主任 车间现场管理 派工、报工审批、在制品监控

生产操作员 执行生产任务 扫码报工、查看当前任务

生产计划员 制定生产计划 根据销售预测和库存制定工单计划

进口专员 处理进口报关 导入DI/DIR文件、核对进口成本、生成采购入库单

数据管理员 主数据清洗与管理 查看重复数据报表、执行合并操作、配置重复检测规则

佣金管理员 佣金规则配置与审核 配置佣金规则、查看佣金报表、处理佣金结算异常

后厨操作员 负责外卖订单的制作与出餐 查看外卖订单列表，更新制作状态（制作中、已完成），无需查看价格和财务信息

配送管理员 管理配送任务，跟踪骑手状态 查看配送中的订单，分配自配送任务，监控配送轨迹

外卖平台管理员 配置外卖平台对接参数，监控对接状态 设置平台API密钥，查看平台订单同步日志，处理对接异常

2.3 假设与依赖

•系统需部署在Windows/Linux服务器，客户端支持PC、PDA、手机PWA。

•依赖第三方税务API服务（如Nuvem Fiscal、FlexDocs、ACBr）完成NFe/NFCe/GNRE的发送与授权。支持多种渠道切换。

•依赖巴西官方数据源（Receita Federal、SEFAZ各州API）进行CNPJ/CPF信息自动填充及税务处理。

•网络中断时，本地订单系统仍可运行，网络恢复后自动同步数据并补开发票。

•本地数据库采用PostgreSQL（主库） + SQLite（离线缓存）。

•第三方平台（MercadoLivre、Shopee、TikTok等）的开放API需具备相应权限。

•依赖AI服务（如大语言模型API）实现智能故障诊断。

•内部协作功能可集成第三方即时通讯工具（如企业微信、钉钉）或自建轻量模块。（注：内部协作可对接企业微信或者钉钉）

•用户互动平台需支持Web端和移动端访问。

•打印相关依赖：

–依赖移动操作系统（Android/iOS）的蓝牙、Wi-Fi、网络服务API。

–依赖打印机厂商提供的标准协议（IPP、ESC/POS、云打印API）。

–PC共享USB打印依赖Windows系统的文件与打印机共享功能，或需安装轻量级代理软件。

•翻译质量相关依赖：

–依赖专业翻译管理系统（TMS）或自建术语库管理模块。

–依赖人工审校流程，需配置翻译管理员角色。

•变量管理相关依赖：

–依赖高性能缓存（如Redis）以支持大规模变量查询。

–依赖前端框架的变量渲染机制。

•进口成本核算依赖：

–依赖巴西Receita Federal发布的DI XML Schema版本。

–依赖SISCOMEX系统导出的文件格式规范。

–需要配置各税费的会计处理规则（是否计入成本）。

•生产管理依赖：

–依赖已有工厂/仓库管理模块。

–依赖BOM（物料清单）的准确维护。

–需要定义标准工艺路线。

•重复数据检测依赖：

–依赖高效的字符串相似度算法（如Levenshtein、Jaro-Winkler）。

–可选依赖第三方数据清洗服务以增强匹配准确性。

•DIR导入依赖：（注：参考老系统完善DI导入自动计算逻辑）

–依赖对SISCARGA预申报数据格式的理解（需与报关行或第三方系统对接）。

–依赖OCR技术用于非结构化文件的辅助识别（可选）。

•佣金规则引擎依赖：

–依赖规则引擎组件（如Drools、EasyRules）或自研规则解释器。

–依赖与财务结算模块的紧密集成。

•外卖平台对接相关依赖：（注：外卖部分二期）

–依赖iFood、Rappi、Uber Eats等平台开放的API或Webhook接口。

–需获得平台开发者账号及相应权限（如API密钥、商家授权）。

–依赖平台对订单推送的响应时限要求（通常需90秒内确认接单）。

–配送跟踪依赖平台提供的配送轨迹API或第三方地图服务。



3. 系统特性（功能需求）

3.1 基础支撑模块

3.1.1 多语言与国际化

•语言支持：系统界面可切换任意语言，通过语言包文件动态加载。初始提供葡萄牙语（巴西）、英语、简体中文。

•打印语言：打印订单时，可根据客户偏好选择产品名称的翻译语言，支持混合语言打印（如标题葡语、备注中文）。

•RTL布局：UI组件库支持从右至左语言布局（为中东市场预留）。

•时区处理：所有时间戳存储为UTC，前端根据用户时区动态显示。

•地址格式库：建立全球地址格式库，确保巴西、美国、欧洲等地的地址输入和显示符合本地习惯。

•用户语言偏好：每个用户可在个人资料中设置语言偏好；登录页面支持语言切换；管理员可为新员工预设语言。

3.1.1.1 翻译质量管理机制

为确保多语言翻译的地道性与一致性，避免机器翻译生硬问题，系统需实现以下机制：

1.专业术语库（Term Base）强制绑定

–系统内置业务术语管理模块，覆盖财务、税务、库存、零售、POS等核心领域的标准译法。

–所有动态语言包加载时，必须优先匹配术语库，确保专业词汇（如 CFOP、NFe、安全库存、应收账款、收银员、折扣）在全系统翻译统一且符合行业习惯。

–术语库支持热更新，翻译管理员可随时新增或修正术语，修改后实时生效。

2.上下文感知翻译（Context-aware Translation）

–翻译管理后台需提供界面截图预览功能。翻译人员在翻译某个字段时，能看到该字段在 POS 界面、打印小票、移动端的具体位置截图，理解语境后再进行翻译，避免脱离语境的直译。

–对于关键业务流程（如开单、退款），应提供操作流程视频或分步截图。

3.翻译记忆库（Translation Memory）辅助

–系统记录每一次人工修正后的翻译结果（句段级别）。当再次出现相同或相似句子时，优先调用历史人工翻译，而非重新机器翻译，逐步沉淀高质量语料。

–翻译记忆库支持全文检索和复用统计。

4.动态语言包与热修复

–语言包独立于代码部署，支持版本化管理（可按日期、版本号回滚）。

–发现翻译错误或生硬表述时，翻译管理员可在后台直接修改，修改后实时生效，无需停机发版。修改记录记入审计日志。

5.用户反馈闭环

–界面增加“报告翻译问题”入口（如悬浮按钮或菜单项），用户（收银员、销售员等）可随时提交翻译不准确的反馈。

–反馈自动附带当前界面截图、功能路径、用户语言环境，管理员收到后可快速定位并修正。

–系统支持对高频反馈的翻译问题进行统计分析，指导优化重点。

6.多语言数据完整性要求（增强商品管理）

–在商品管理模块（3.3.1），多语言名称字段设为强提醒（非强制但需人工确认）。商品发布前，若主要语言（如葡语）名称为空或由机器翻译填充未审校，系统应提示管理员或运营人员确认。

–系统可提供“批量机器翻译”功能（调用第三方翻译API）生成商品多语言名称草稿，但必须经过人工审核确认后才能上架销售，确保前台展示语言质量。

7.翻译审校流程

–系统支持定义翻译审校工作流：机器初翻 -> 人工审校 -> 发布。

–翻译管理员可分配审校任务给内部译员或外部服务商，审校完成后标记为“已校对”，方可进入正式语言包。

–支持对比不同版本翻译，查看修改历史。

3.1.2 部门与权限管理（精细化）

•内置部门：采购部、销售部、财务部、库存部、客服部、生产部、人事部、市场部、售后部、项目部。

•数据隔离：

–销售员只能查看、操作自己名下的客户和订单。

–采购员只能查看供应商和采购订单。

–财务人员可查看所有财务相关数据，但不可修改商品价格。

–仓库人员只能访问库存和发货模块。

–市场人员可配置引流话术、生成优惠码、查看效果报表，但不能修改商品价格和库存。

–售后专员只能访问售后工单、维修记录。

–项目经理只能访问自己负责的项目。

–财务部内部可按科目级权限细分（如出纳只能查看现金/银行科目）。

•权限分级：

–超市收银员模式：开班需登记备用金；日常收银无权修改价格/折扣，如需修改需主管授权；交班时系统自动结算差异。

–销售员模式：可修改金额与折扣，所有修改记录审计日志；不涉及储备金管理。

•敏感操作审计日志：记录所有价格修改、折扣调整、退货、删除客户、权限变更、开班/交班、物理删除等操作。

3.1.2.1 个性化快捷菜单

•角色默认菜单：系统管理员可为每个角色配置默认常用功能菜单。

•个人自定义菜单：用户可将常用功能添加到“我的快捷菜单”，支持拖拽排序。

•自定义名称：允许为收藏的菜单项（包括功能按钮）设置自定义显示名称，如将“创建销售订单”改为“新开单”。

•组合快捷方式：支持将多个操作串联成组合快捷方式，点击后自动执行（如“开单→收款→打印”）。

•智能推荐菜单（自动收藏）：系统根据操作频率自动将常用功能加入快捷菜单，无需手动操作。自动收藏跟随用户和角色。

•多设备同步：个性化菜单在不同终端间自动同步。

3.1.2.2 订单列表可见性权限

•权限项：在角色权限管理中增加“订单查看范围”选项，可选值：

–全部订单（含未开票）：可查看所有订单。

–仅已开票订单：只能查看已生成发票的订单，未开票订单在列表中不可见。

–本部门订单：只能查看自己所属部门的订单（需与部门数据权限关联）。

–本人名下订单：只能查看自己负责的客户或自己创建的订单（如销售员）。

•应用场景：

–收银员角色可配置为“仅已开票订单”，使其在订单列表中看不到未开票记录，避免误操作或信息泄露。

–销售员角色可配置为“本人名下订单”，同时可配置是否允许查看已开票订单。

–财务角色默认拥有“全部订单”权限。

•实现方式：后端API根据当前用户的权限动态过滤订单列表返回的数据，前端不显示无权限的订单。

3.1.3 离线能力与数据同步（增强版）

•客户端离线运行：

–收银机、仓库终端可完全离线运行。

–本地数据库采用SQLite，存储所有订单、商品、客户基础信息。

–断网时正常开单、录入订单、打印临时小票。

•网络恢复后自动同步：

–订单数据上传至云端PostgreSQL主库。

–待开票订单根据配置渠道自动发送至SEFAZ获取授权。

–库存变动同步至中央库存。

•数据删除策略：

–逻辑删除：所有核心业务数据默认采用逻辑删除。

–物理删除权限：仅系统管理员可物理删除，记录详细审计日志。

•同步冲突处理：最后写入优先（可配置）；字段级合并；冲突记录留痕。

3.1.3.1 冲突解决详细要求

•字段级合并：当两个终端修改同一订单的不同字段时（如A改数量，B改地址），系统必须能自动合并两个修改，保留两个字段的最新值，不得简单覆盖整个订单。

•冲突检测：当两个终端修改同一字段时（如都改价格），系统必须检测到冲突，并记录两个版本。

•冲突解决界面：必须提供可视化的冲突解决工作台，展示冲突双方的原始值、修改时间、修改人，支持管理员选择保留哪一方，或手动输入新值。

•自动解决策略：允许管理员配置默认解决策略（如“以销售员修改为准”“以金额大的为准”），配置后系统可自动处理部分冲突。

•冲突通知：发生冲突时，应通过站内信或邮件通知相关管理员。

3.1.4 合约管理与授权控制（核心资产）

•合约生成：支付成功自动为服务类商品生成服务合约。

•状态机：待生效、生效中、已暂停、已过期、已终止。

•暂停处理：欠费或主动申请可暂停；宽限期内付费可恢复。

•续费与变更：续费订单支付后更新原合约失效日；支持升级/降级。

•到期预警：多级预警（短信、邮件、站内信）。

•客户视图：客户可查看自己的所有合约。

•后台管理：管理员可查询、导出、调整合约。

•离线授权控制（本地安装版）：

–License文件机制：通过License文件控制合约期限和功能权限。License包含客户ID、套餐类型、功能特性列表、过期时间、硬件指纹、数字签名。

–签名验证：软件启动时用内置公钥验证签名，防止篡改。

–时间回拨检测：记录上次运行时间，若当前时间小于上次时间，拒绝运行。

–硬件绑定：可选绑定硬件指纹（如CPU ID、MAC地址），防止复制。支持换绑申请。

–心跳验证：若偶尔联网，可定期进行心跳验证，超过宽限期未联网则功能受限。

–核心算法云端化：税务计算等关键算法可放在云端，每次调用需联网验证合约。

3.1.5 数据所有权与迁移工具

•数据导出：客户可通过后台一键导出所有历史数据（CSV/JSON/XML）。

•数据迁移工具：详见3.3.4节，支持从异构数据源平滑迁移。

3.1.6 多级审批工作流

•审批流程可配置：支持自定义审批流程，应用于采购订单、费用报销、价格调整、信用额度变更、科目变更等。

•审批提醒：待审批任务通过邮件、站内信、移动端推送通知。

•审批历史：完整记录每个审批节点的操作人、时间、意见、附件。

•审批模板：管理员可预置常用审批模板。

3.1.7 系统监控与运维

•系统健康监控：实时监控各服务状态（API服务、数据库、消息队列、缓存），异常时自动报警。

•性能分析：记录慢查询、高频接口调用情况，提供可视化分析。

•用户行为分析：统计各功能模块使用频率、用户活跃度、留存率。

•日志审计：操作日志和登录日志可检索，存储至少6个月。

•告警规则配置：管理员可自定义告警阈值和接收人。

•智能故障诊断：

–错误分类：在日志中明确区分内部错误（系统代码、数据库异常）和外部错误（用户输入、网络超时、第三方API错误），并在前端友好提示。

–AI运维助手：集成AI模型分析日志、指标，故障时自动生成诊断报告，包含可能原因、推荐解决方案、相似历史故障。

–自助修复建议：常见故障可提供一键修复脚本或操作步骤。

–故障知识库：诊断结果自动归档，支持检索。

3.1.8 数据归档策略

•历史数据归档：支持将超过指定期限的订单、日志等数据自动迁移至归档数据库或对象存储。

•归档数据查询：提供专门的历史数据查询界面，支持按条件检索。

•归档策略配置：管理员可配置哪些表、多长时间归档。

3.1.9 软件公司-用户互动平台

•系统公告：软件公司管理员可发布全局公告（维护通知、新功能、故障通报），支持富文本、置顶、定时、指定用户群。

•服务器状态通知：实时显示各区域服务器健康状态，故障时自动推送通知。

•新功能需求提交与投票：用户可提交需求，其他用户可点赞投票，管理员可回复并标记状态。

•交流栏目：公共讨论区，用户发帖提问、分享经验，技术支持人员定期回复。

•权限：仅软件公司管理员可发布公告、管理需求；所有登录用户可查看、提交、投票、讨论。

3.1.10 内部协作与交流

•功能概述：为商户内部员工提供便捷的沟通与协作工具，提升团队效率。支持内部公告、论坛讨论以及与巴西本地主流即时通讯工具的集成（注：对接企业微信或者钉钉，其他即时通讯二期）。

•内部公告：

–商户管理员（如老板、人事）可发布公司内部通知，如放假安排、公司制度、活动通知等。

–员工登录系统后可在工作台看到内部公告，支持已读标记。

•内部论坛/话题：

–员工可在内部论坛发布话题，分享工作心得、求助、讨论业务问题。

–支持按部门、项目创建私密圈子，仅圈内成员可见。

–支持回复、点赞、@同事。

•即时通讯（巴西本地化集成）：（注：对接企业微信或者钉钉，其他即时通讯二期）

–系统提供与 WhatsApp Business API 的集成接口，商户可配置官方 WhatsApp 账号，实现内部工作群组、一对一沟通、文件传输等功能。

–可选集成其他巴西本地常用的即时通讯工具（如 Telegram），通过开放接口实现消息互通。

–若商户已有自建聊天系统，也可通过 Webhook 方式对接，将内部协作消息推送至员工常用的聊天客户端。

–聊天记录可选择保存至系统（需符合 LGPD 隐私规定），支持搜索历史消息。

•任务协作：

–可在内部论坛或聊天中快速创建任务，指派给同事，设置截止日期。

–任务与项目模块（3.18）联动，可在项目看板中查看。

•权限：商户管理员可管理内部公告、创建讨论圈子；所有员工可参与。

3.1.11 变量管理功能

为实现界面文本的全面可配置，统一管理多语言、自定义菜单、个性化字段等，系统需提供变量管理功能。该功能将界面上所有文本（菜单名、按钮文字、提示信息、字段标签等）抽象为可配置的变量，每个变量有唯一标识符，并支持多级作用域覆盖。

3.1.11.1 核心概念

•变量（Variable）：每个可配置的界面文本项对应一个唯一ID，如 button.save、menu.dashboard、label.welcome。

•作用域（Scope）：变量值可以在不同层级定义，按优先级覆盖：

–全局（Global）：系统默认值，适用于所有用户和客户。

–客户/公司（Customer）：针对某个客户（如一家连锁超市）的统一值，覆盖全局值。

–用户（User）：个人用户的自定义值，覆盖客户级和全局值。

•语言（Language）：变量值可附带语言标记（如 pt-BR、en-US、zh-CN），实现多语言支持。语言筛选在作用域之后应用。

3.1.11.2 变量定义与管理

•变量定义：管理员可在后台定义变量，包括：

–变量ID（唯一，建议采用点分命名空间，如 module.component.element）

–描述（说明该变量的用途）

–默认值（当没有任何作用域覆盖时使用的值）

–分组（如“按钮”、“菜单”、“标签”），便于分类管理

–变量类型（普通文本、富文本、带占位符的模板等）

•变量列表：提供可视化的变量列表，支持按ID、分组、描述搜索筛选。

•变量版本：修改变量定义时保留历史版本，支持回滚。

3.1.11.3 多级作用域值配置

•全局作用域：可设置各语言的默认值。例如，button.save 在全局下：中文=“保存”，葡语=“Salvar”，英语=“Save”。

•客户作用域：针对特定客户设置覆盖值。例如，客户A（大型连锁超市）希望将“保存”按钮在所有门店统一改为“Gravar”（葡语），可在此设置。

•用户作用域：允许用户在个人设置中自定义部分变量。例如，某收银员习惯将“保存”称为“Salvar”，可覆盖为自己偏好的值。

•值继承规则：系统加载变量值时，按以下顺序查找：

1.用户作用域（匹配当前用户ID和当前语言）

2.客户作用域（匹配当前客户ID和当前语言）

3.全局作用域（匹配当前语言）

4.变量定义的默认值

•批量设置：支持为多个变量同时设置同一作用域的值，例如为某个客户批量导入所有变量的葡语翻译。

3.1.11.4 导入导出功能

•导出：支持将变量定义及所有作用域的值导出为Excel/CSV文件。文件格式示例：

var_id description default_value global:en global:pt-BR global:zh-CN customer:123:pt-BR user:456

button.save 保存按钮 Save Save Salvar 保存 Gravar Salvar

•导入：支持导入Excel/CSV文件，批量更新变量值。导入时可选择覆盖策略（如仅更新空白、强制覆盖等），并提供预览变更功能。

•冲突处理：导入时若发现同一变量同一作用域存在多个值，需提示用户确认。

3.1.11.5 用户级自定义界面

•个人变量设置：在用户个人资料或偏好设置中，提供“自定义界面文本”入口，列出用户有权修改的变量（如常用菜单、按钮名称），允许用户修改为自己偏好的文本。

•权限控制：普通用户只能修改自己作用域的变量；客户管理员可修改本客户作用域的变量；系统管理员可管理所有作用域。

3.1.11.6 前端集成

•变量渲染：前端框架需提供全局方法或组件，根据变量ID获取当前生效的文本。例如，在Vue/React中使用 {{ $var('button.save') }}。

•缓存机制：用户登录时，后端根据用户ID、客户ID、语言偏好，计算所有变量的最终值，生成键值对映射，缓存在Redis或内存中。前端通过API获取该映射，或由后端直接注入页面。

•实时更新：当管理员修改变量值后，应通过WebSocket或版本号机制通知前端刷新缓存，实现热更新。

3.1.11.7 术语统一保障

•变量ID本身强制了同一概念在不同地方使用相同标识。例如，所有表示“客户”的地方都使用变量 label.customer，确保术语一致性。

•术语库（见3.1.1.1）可与变量管理结合：在修改变量值时，系统可提示术语库中的推荐翻译，辅助管理员保持术语统一。

3.1.11.8 审计与历史

•所有对变量定义和变量值的修改，均需记录审计日志，包括操作人、时间、修改前后内容。

•支持按变量查看历史修改记录，并可回滚至任一历史版本。

3.1.11.9 性能要求

•变量数量支持至少10万条以上，系统需通过缓存和索引保证查询性能。

•用户登录时变量映射生成时间不超过2秒。

•变量值修改后，缓存更新应在5秒内生效。

3.1.11.10 与现有功能的整合

•多语言：通过语言作用域实现，替代传统语言包。

•个性化快捷菜单：菜单文本本身也是变量，用户自定义菜单名即修改自己作用域下的变量值。

•自定义字段标签：未来如有需要，可扩展变量管理至动态字段标签。

3.2 客户/供应商管理（CRM）

3.2.1 客户/供应商登记

•基础字段：公司名称、CNPJ/CPF、电话、邮箱、地址、绑定内部销售员、常用运输公司、客户等级、折扣率、价格体系、语言偏好、程序合约到期日、来源平台、首次访问渠道、首次优惠码、注册时间、首次下单时间、信用额度、信用账期、可用信用余额、信用状态、信用审批人、最近信用评估时间。

•智能填充：通过CNPJ/CPF自动从Receita Federal API查询并填充企业信息。

•附件管理：保存客户照片、公司资质文件。

•数据隔离：销售员只能查看自己绑定的客户；采购员不能查看客户信息。

•通信渠道：电话、邮箱作为线上客户账号依据。

3.2.2 智能检索

•提供统一的搜索框，支持按条码、SKU、型号、品名、品牌、拼音首字母、助记码、别名、客户电话/名称、来源平台、优惠码实时检索。

3.2.3 销售员智能助手

•客户画像弹窗：当销售员打开客户详情时，自动弹出客户画像（购买力、偏好、上次购买时间、合约到期情况）并推荐交叉销售/向上销售建议。

•销售指导：根据客户等级和近期行为，提示销售员优先跟进高价值潜在客户。

3.2.4 信用管理

•信用额度管理：可为客户设置信用额度和信用账期，支持按等级统一设置或个别调整。额度变更需审批。

•信用控制：当订单金额超过可用信用余额时，可配置禁止下单、需审批或发出预警。

•应收账款催收：自动生成对账单，支持一键发送；记录催收历史；逾期自动计算利息；提供应收账款账龄分析表。

•信用评估：支持定期重新评估客户信用。

3.2.5 重复数据检测与报警

为确保主数据的唯一性与清洁度，避免重复创建客户、供应商、运输公司等档案，系统需内置重复数据检测与报警机制。

3.2.5.1 适用范围

•客户（含个人/企业）

•供应商

•运输公司

3.2.5.2 检测规则

系统支持两种检测模式，可同时启用或单独配置：

1.精确匹配（Exact Match）

–CNPJ/CPF：巴西企业税号或个人税号完全一致时，判定为重复。

–身份证/护照号（若有）：完全一致时判定重复。

–注册邮箱：完全一致时判定重复。

–自定义字段：管理员可配置其他字段（如电话号码、银行账号）进行精确匹配。

2.模糊匹配（Fuzzy Match）

–名称相似度：对客户/供应商/运输公司的名称（公司名称或姓名）进行相似度计算（如编辑距离、Jaccard相似度）。当相似度高于阈值（默认85%，可配置）时，系统提示可能重复。

–地址相似度：对主要地址（省、市、街道）进行相似度匹配，若地址高度相似且其他信息（如CNPJ为空）接近，则提示。

–联系电话：对电话号码进行归一化处理后进行精确或模糊匹配（如去除空格、国家代码后对比）。

3.2.5.3 触发时机

•新建档案时：用户填写完必填信息并点击“保存”前，系统自动在后台发起重复检测。

•编辑档案时：若修改了可能引起重复的关键字段（如CNPJ、名称），保存前重新检测。

•批量导入时：在数据导入的预览阶段，系统对导入数据进行批量重复检测，并生成重复报告。

3.2.5.4 报警与处理方式

•轻度警告（可忽略）：

–当仅触发模糊匹配且置信度未达到强制阈值时，系统弹窗提示：“检测到可能存在重复记录，请核对：XXX（相似记录名称）”。用户可选择“继续保存”或“查看详情”。

•中度警告（需确认）：

–当触发精确匹配（如CNPJ重复）时，系统强制提示：“CNPJ已存在，无法创建新记录。是否查看已有记录？”用户点击“查看”后跳转至已有记录详情页。

•重度阻止（无法保存）：

–若系统配置为“禁止重复创建”（如企业级要求），则当检测到精确匹配时，保存按钮置灰，并提示“已存在相同CNPJ的记录，请勿重复创建”。

3.2.5.5 重复记录合并建议

•当检测到可能重复时，系统可提供“合并建议”功能：

–列出两条或多条疑似重复记录，并高亮显示冲突字段（如不同的电话、地址）。

–用户可选择保留其中一条，并将其他记录的数据合并过来（如合并联系人、交易历史等），合并后逻辑删除被合并的记录。

•合并操作需记录审计日志，且合并后的记录需重新验证唯一性。

3.2.5.6 全局重复检测报表

•提供专门的“重复数据分析”报表，可按实体类型（客户/供应商/运输公司）列出所有疑似重复的记录对，并支持标记“已处理”或“忽略”。

•支持导出重复记录列表，便于线下清理。

3.2.5.7 性能与可扩展性

•检测算法需在用户输入后1秒内返回结果，不影响正常操作流程。

•支持自定义匹配字段和相似度阈值（管理员可配置）。

•支持接入第三方数据清洗服务（如CNPJ查询API）以增强匹配准确性。

3.2.5.8 与现有模块的集成

•与审计日志集成：所有重复检测警告、用户操作（忽略、合并）均记录审计日志。

•与通知中心集成：对于批量导入产生的重复，可通过站内信通知导入操作人。

3.3 产品管理

3.3.1 产品登记

•基础信息：SKU、国际条码、店内码、型号、品名（多语言）、品牌、类别、NCM、CFOP默认、CST/CSOSN默认、来源码、是否项目型商品。

•价格体系：零售价、批发价、刷卡价、含税价、拿货到柜价；可设置订单默认使用哪种价格。

•库存信息：当前库存、安全库存、最大库存；批次管理；有效期到期提醒。

•服务类商品：可定义默认有效期规则、是否允许续费、预警规则。

•商品佣金：可为每个商品设置推销员佣金比例。

•图片管理：支持多图片上传。

•前台备注：

–支持多语言文本（如葡萄牙语、英语、中文），用于向客户展示的额外说明或联系方式。

–此字段内容可在前台（私域商城、POS、移动端）对登录会员可见。

–管理员可配置是否显示该字段，以及显示的位置（如商品详情页、列表页浮层等）。

–支持富文本格式（可选，如允许简单HTML或Markdown），但需防范XSS攻击。

–若平台启用中介模式，可在此字段中添加供应商的联系方式或特殊说明，但需遵守平台审核规则。

3.3.2 父子商品与组合商品

•单一商品：单个销售单位，直接管理库存。

•组合商品：由多个子商品组成，销售时自动扣减子商品库存。可配置当子商品库存不足时的处理策略。

•单位换算：支持双单位（如箱/个），销售时自动换算。

3.3.3 批量导入与导出

•导入格式：Excel、CSV、XML ，txt（DI进口报关单、NF-e采购发票）、图像文件（OCR识别）。

•批量修改：按属性生成阵列、批量调整价格、批量替换图片、批量更新库存。

•导出功能：可导出产品资料供下游采购单导入。

3.3.4 第三方系统迁移工具（异构数据源支持）(注：可采用成熟的第三方迁移工具，如：navicat商业版)

•核心架构：适配器模式 + 管道处理。定义标准数据源适配器接口，新增数据源只需开发新适配器。

•支持的数据源类型：关系型数据库（MySQL, Oracle, SQL Server, PostgreSQL）、文件型数据（Excel, CSV, XML, JSON）、数据库备份文件、特定系统导出格式（Linx, Totvs, Bling等）。

•迁移流程：

1.连接与读取：选择或上传数据源，预览数据。

2.可视化字段映射：自动匹配、手动映射、表达式/脚本映射、常量映射、模板保存。

3.数据处理管道：数据清洗、类型转换、数据校验。

4.预览与执行：模拟运行、高性能导入、断点续传、冲突处理。

5.导入报告：生成详细报告，支持导出失败记录。

•安全与审计：仅系统管理员有导入权限；所有操作记录审计日志。

3.3.5 条码管理

•条码打印：支持打印店内条码（一维码/二维码），可自定义格式。

•扫码识别：扫描正规EAN条码自动填充商品信息；扫描内部码仅用于库存管理。

3.3.6 政府拉取进货发票

•支持从政府税务系统拉取进货发票（XML），自动生成采购单和商品信息。

•国际采购单DI XML ，txt 新格式导入，一键生成自动化计算进口发票。

3.3.7 进口报关单（DI/DUIMP）导入与进口成本核算 （注：参考老系统完善DI导入自动计算逻辑）

功能概述：支持导入巴西政府标准格式的进口报关单（如DI电子文件、DUIMP导出文件，格式包括XML和特定结构的TXT），自动解析报关数据，计算商品进口总成本，并一键生成对应的进口采购入库单（或称进口成本核算单），实现进口流程的自动化与合规化。

3.3.7.1 支持的文件格式

•DI XML：符合Receita Federal发布的DI电子文件Schema（版本X.XX）。

•DUIMP导出文件：符合SISCOMEX新系统导出的JSON/XML格式（需明确版本）。

•SISCOMEX TXT：符合标准列宽或分隔符的特定版本格式（如SISCOMEX Exportação/Importação registro类型）。

•通用CSV模板：提供用户自行映射字段的导入模板，用于非标准格式的辅助导入。

3.3.7.2 核心处理流程

1.文件解析与数据映射

–系统根据文件格式自动识别并解析关键字段，包括：

•收发货方信息（CNPJ/CPF、名称、地址）

•报关单号、注册日期、清关日期

•商品项次（adição）、NCM、商品描述、原产国

•数量、计量单位、CIF外币价值、运费、保险费

•官方汇率（数据来源：DI文件中的汇率字段，或系统配置的当日汇率）

•各项税费明细：II（进口税）、IPI、PIS-Importação、COFINS-Importação、ICMS-Importação（含税基、税率、税额）

–支持对文件进行数字签名验证（DI XML通常包含签名），确保文件未被篡改。

2.商品匹配与创建

–系统根据NCM和商品描述（可配置匹配规则，如NCM+描述相似度阈值）自动匹配现有商品档案。

–若匹配成功，则关联到该商品；若未匹配成功，则进入“待处理商品”列表，允许用户：

•创建新商品，并自动填充从DI解析出的基础信息（NCM、描述等）。

•挂起待人工处理。

–支持批量匹配和人工干预界面。

3.进口成本自动化计算（注：在老系统基础上升级）

–汇率换算：使用DI文件中的官方汇率（或系统预设汇率），将所有外币金额转换为本币（BRL）。

–成本构成计算：根据巴西会计准则和进口成本核算规则，将以下费用分摊到每个商品项次：

•CIF本币价值（货款+运费+保险费）

•II（进口税）：计入商品成本

•IPI：若可抵扣，则部分计入成本；若不可抵扣，则全额计入成本（可配置）

•PIS/COFINS-Importação：根据企业税制（累积制/非累积制）决定是否计入成本

•ICMS-Importação：通常作为可抵扣税额，不计入成本，但需在会计上单独处理

•其他费用（如报关行费用、码头费、商检费等）：支持用户手动添加或按比例分摊

–单位成本计算：最终计算出每个商品项次的本币单位成本 = (该商品分摊后的总成本) / 进口数量。

–提供成本计算明细预览，供用户核对。

4.一键生成采购入库单

–用户确认数据无误后，点击“生成入库单”。

–系统自动创建一张状态为“待审核”的采购入库单（或直接生成已审核入库单，取决于配置）。

–入库单关联DI号作为来源凭证，并可记录报关单关键信息。

–入库单明细包含商品、数量、计算得出的单位成本、总成本、各项税费金额等。

–完成入库后，相应商品的库存成本价按新计算的单位成本更新（若采用移动平均法，则重新计算平均成本）。

3.3.7.3 业务规则与校验

•重复导入校验：系统根据DI号（Número do DI）进行唯一性校验，防止同一张报关单重复导入。

•金额平衡校验：系统自动校验DI文件中的总金额与解析后各商品项金额之和是否一致，若不一致则提示用户。

•税费完整性校验：检查关键税费（II、IPI、ICMS）是否均有值，若无则标记为异常，需人工补充。

•汇率有效性：若DI文件中未提供汇率，或汇率日期不在合理范围内，系统允许用户手动输入或调用当日官方汇率。

3.3.7.4 异常处理

•解析失败：若文件格式错误、字段缺失或数字签名验证失败，系统给出明确错误提示，并拒绝导入。

•商品匹配异常：若大量商品匹配失败，系统可生成待处理任务列表，允许用户批量创建或匹配。

•成本计算异常：若因税率缺失（如NCM未配置IPI税率）导致无法完成计算，系统停止生成入库单，并高亮提示缺失项。

3.3.7.5 与现有模块的联动

•与商品管理联动：自动创建或更新商品档案，包括NCM、原产国等属性。

•与采购管理联动：生成的采购入库单纳入采购模块，支持后续付款、供应商对账。

•与库存管理联动：入库后实时更新库存数量和成本价。

•与财务管理联动：自动生成应付账款凭证（借：库存商品，借：应交税费-进项（如ICMS、IPI可抵扣部分），贷：应付账款/银行存款）。

•与税务模块联动：记录进口税费明细，供后续税务申报（如SPED Fiscal）使用。

•与审计日志联动：所有导入、计算、生成操作均记录审计日志。

3.3.7.6 界面要求

•提供统一的“进口报关单导入”入口。

•导入向导分步进行：选择文件 → 数据预览 → 商品匹配 → 成本计算预览 → 生成入库单。

•数据预览界面支持表格形式展示解析后的商品项及税费明细。

•商品匹配界面提供搜索、筛选、批量操作功能。

•成本计算预览界面显示每个商品项的成本构成明细，并允许用户微调（如调整分摊比例，需记录审计日志）。

•导入报告：生成完成后，显示成功/失败记录，并提供下载失败明细的功能。

3.3.7.7 性能要求

•单次导入支持最多500个商品项，解析与成本计算时间不超过10秒。

•支持批量导入多个文件（如每日集中处理）。

3.3.7.8 商业发票（DIR）导入与预申报处理【V9.4新增】

•功能描述：支持导入进口商业发票（Commercial Invoice / DIR），自动提取商品明细、金额、运费等信息，并生成预进口单或直接生成DI草稿。适用于企业在货物发运前收到供应商发票、内部预申报或对接SISCARGA系统。

•支持的文件格式：

–标准化Excel/CSV：提供可配置的字段映射模板，用户可将自定义列（如“商品描述”“数量”“单价”“NCM”）映射到系统字段。支持模板保存和复用。

–SISCARGA电子数据：支持符合巴西海关SISCARGA预申报规范的XML/EDI格式，可直接对接报关行或SISCARGA系统。

–自定义XML：支持对接常用报关行软件的导出格式（需配置解析规则，可通过XPath或JSONPath定义）。

–PDF辅助导入：提供OCR辅助工具，自动识别关键字段（如发票号、金额、商品列表），但需人工核对确认，准确率不低于90%。

•处理流程：

1.用户上传DIR文件，选择文件类型（Excel/CSV/XML/PDF）。

2.若为Excel/CSV，进入字段映射界面，用户将文件列与系统字段关联；若为XML，系统自动尝试按预设规则解析；若为PDF，触发OCR识别并展示结果供确认。

3.系统解析后生成数据预览，展示商品明细、总金额、运费、保险费等信息，允许用户修改、补充缺失信息（如NCM码）。

4.用户确认后，点击“生成预进口单”，系统创建状态为“待申报”的进口预记录（预进口单），包含所有商品信息和预估成本。

5.预进口单可后续关联到正式的DI申报流程：用户可选择“转换为DI草稿”，系统将预进口单数据填充至DI草稿界面，供进一步编辑和提交。

6.支持将预申报数据推送至SISCARGA系统（需集成接口），并接收回执更新状态。

•与现有DI模块的集成：

–预进口单与DI草稿可双向转换，数据可复用。

–预进口单可作为进口成本预估的依据，用于财务预算。

–支持将多个预进口单合并生成一个DI（如同一批次多份发票）。

•业务规则与校验：

–重复导入校验：根据发票号和供应商信息防止重复导入。

–金额一致性校验：商品明细金额之和应与发票总金额一致，否则提示。

–NCM校验：若商品NCM缺失，系统可调用NCM推荐服务（基于描述）或提示用户手动填写。

•界面要求：

–提供分步向导，每一步都有明确指引。

–字段映射界面支持拖拽、下拉选择、示例数据预览。

–OCR结果界面高亮显示识别内容，用户可点击修改。

•性能要求：

–Excel/CSV解析时间不超过5秒（1000行以内）。

–OCR处理时间不超过10秒（单页PDF）。

3.4 运输公司管理

3.4.1 增删改查

•增删改查：运输公司名称、CNPJ、联系人、电话、邮箱、地址。

•CNPJ自动填充：通过CNPJ自动查询并填充信息。

•运费模板：可配置按重量、体积、距离计算的运费规则。

3.4.2 重复数据检测与报警

运输公司作为主数据之一，同样适用3.2.5节定义的重复检测规则。在创建或编辑运输公司时，系统根据CNPJ、名称、电话等字段进行精确和模糊匹配，并按照3.2.5.4的规则进行报警和处理。

3.5 人事管理

3.5.1 员工信息登记

•角色：会计、采购员、内部销售员、外部推销员、仓库员、超市收银员、市场运营、售后专员、项目经理、网站设计师、翻译管理员、变量管理员等。

•字段：姓名、CPF、邮箱、电话、入职日期、工资标准、佣金比例。

•CNPJ/CPF自动填充：预留接口。

3.5.2 考勤与工资

•考勤管理：连接考勤机，自动同步打卡记录；可设置考勤规则。

•工资计算：根据考勤、工资标准、销售佣金自动计算每月工资；生成工资表；支持定时发送至会计邮箱。

3.5.3 销售员佣金

•佣金计算：基于订单金额和商品佣金比例自动计算；支持按订单、按商品、按客户分类计算。

•多级分销/批发返利：支持多级分销体系，返利可累计至阈值后提现或抵扣货款。

•佣金报表：销售员可查看自己的佣金明细、状态；自动生成报表定期发送至邮箱。

3.6 极速打印POS模块（核心）

3.6.1 开单界面（分角色且可自定义）

•界面自定义配置：管理员可在后台为不同角色创建界面模板，配置显示的字段、是否可编辑、快捷键等。

•触摸屏优化：触控区域尺寸适配手指点按；支持常用手势；可配置触摸反馈。

•超市收银员界面：极简模式，无价格修改按钮；开班强制登记备用金；交班强制结算。

•销售员界面：完整界面，支持修改价格、添加折扣；可查看客户信息。

•快捷操作栏：界面顶部提供可配置的快捷操作栏，显示常用功能按钮，支持用户自定义。

3.6.2 商品展示与录入

•商品展示：显示产品图片、名称、规格、数量、单价、小计；同类商品可手动合并/拆分显示。

•快速录入：支持扫描一维码/二维码添加商品；扫码时语音提示；支持手动输入SKU/条码模糊搜索。

•触摸录入增强：内置可配置的屏幕数字键盘；支持手写输入；连接外部扫描枪时虚拟键盘自动隐藏。

•电子秤集成：连接电子秤，自动读取重量；支持“去皮”计算。

•前台备注显示：在商品列表中，可配置是否显示“前台备注”字段（例如作为小图标，点击查看详情），方便收银员或销售员向客户传达商品特殊说明。该显示开关可由管理员在角色模板或界面配置中控制。

3.6.3 价格与折扣权限（增强版）

•超市收银员：价格/折扣字段只读；如需修改，需申请主管授权。授权方式必须至少支持以下一种便捷方式：

–扫码授权：主管扫描收银员手机上的二维码完成授权。

–密码授权：主管输入专用授权密码（可设置有效期）。

–手机审批：主管手机收到审批请求，点击确认后完成授权。

–指纹/人脸识别：主管在收银终端上验证生物特征。

•销售员：可自由修改金额与折扣，所有修改记录审计日志。

•价格策略：支持按数量或金额自动应用批发价或零售价。

•折扣显示：打印订单时显示折扣金额与百分比。

•所有授权操作必须记录审计日志，包括授权人、时间、授权内容。

3.6.4 支付方式与收款

•超市收银员：支持现金收款（自动计算找零）、Pix（生成二维码）、银行卡刷卡；支持支票支付（引导至支票管理）；可配置刷卡手续费率；交班时按支付方式汇总销售额。

•销售员：无找零功能，订单支付由财务或客户直接支付，系统记录支付状态。

3.6.5 发票生成

•开票触发：订单完成后可手动选择生成NFCe或NFe，也可配置自动开票。

•合并开票：支持将同一客户的多个订单合并生成一张NFe。

•数据映射：自动将订单中的商品信息复制到发票草稿；若商品条码为正规EAN，自动带入发票；可配置强制NCM检查。

•税务自动化：CFOP、CST/CSOSN自动判断；税率自动计算。

3.6.5.1 分批开票（按比例开票）

•功能描述：支持将一张订单根据实际发货进度或服务完成进度，按比例分多次开具发票。每张发票金额不超过订单剩余未开票金额，且必须关联真实的业务事件（如发货单、服务确认单）。适用于分批发货、长期服务合同分期结算、工程项目按里程碑开票等合规场景。

•业务规则：

1.订单需增加“已开票总额”、“未开票总额”、“开票状态”（待开票、部分开票、已全部开票）字段，每次开票后实时更新。

2.用户发起分批开票时，必须选择本次开票依据的业务单据（如发货单、服务进度报告）。系统自动计算该单据对应的商品/服务金额，作为本次可开票的上限。

3.若业务单据金额小于订单剩余未开票总额，用户可手动调整本次开票金额，但不得超过该业务单据金额。

4.系统支持按百分比输入（如输入50%，系统自动计算为订单剩余未开票金额的50%），但仍需受业务单据金额约束。

5.每张发票独立生成，关联原订单号和对应的业务单据号，并记录开票历史。

6.分批开票完成后，订单“未开票总额”相应减少；当未开票总额为0时，订单状态自动更新为“已全部开票”。

•税务合规约束：

–分批开票必须严格对应真实的货物交付或服务提供。系统禁止在无任何业务单据的情况下随意拆分发票金额。

–若用户试图对未发货商品进行部分开票，系统需弹出警告并阻止操作，提示“请先创建发货单”。

–每张发票的计税（CFOP、CST、税率）根据发票上的商品明细自动计算，确保税务准确。

•财务联动：

–每生成一张分批发票，财务模块自动确认部分收入，生成应收账款凭证（借：应收账款，贷：主营业务收入，贷：应交税费）。

–后续收款时，系统自动核销对应发票的应收账款，支持部分收款。

•权限控制：分批开票权限默认授予财务人员、项目经理等角色，可由管理员在角色权限中配置。

•界面要求：

–订单详情页增加“分批开票”按钮（仅限有权限用户）。

–点击后弹出窗口，显示订单已开票/未开票概况，并列出可关联的业务单据（发货单、服务确认单等）。

–用户选择单据后，系统自动带入建议开票金额，允许微调（不得超过单据金额）。

–确认后生成发票草稿，用户可预览并最终提交。

•审计日志：所有分批开票操作记录审计日志，包括操作人、时间、本次开票金额、关联单据号、生成的发票号等。

3.6.5.2 发票作废与红字发票

•支持已开发票的作废申请（需符合巴西税务规定的时间窗口，通常为24小时内）。

•作废成功后，系统自动更新订单状态，并生成红字凭证冲销应收账款。

•对于退货场景，支持生成红字发票（Carta de Correção ou NF-e de devolução）。

3.6.5.3 选择性开票与发票列表分离

•功能概述：为满足企业对开票流程的精细化管控，实现订单管理与发票管理的解耦，提供以下能力：

–订单列表与发票列表分离：两个独立的菜单界面，分别展示订单和发票数据，职责清晰。

–选择性生成发票：支持从订单列表中勾选一个或多个订单，手动触发开票（可配置为合并开票或分别开票）。

–订单列表可见性控制：通过权限配置，可限制特定角色（如收银员、销售员）查看未开票订单，仅显示已开票或允许操作的订单，满足内部管控或应对检查的需求（非逃税设计，仅用于权限隔离）。

–客户申请开票与同步：允许客户在自助端（如私域商城）申请开票，系统生成发票后可选择手动或自动同步至税务系统及客户邮箱。

3.6.5.3.1 订单列表与发票列表分离

•菜单设计：

–左侧导航栏增加“订单管理”和“发票管理”两个独立入口。

–订单管理：展示所有订单（含未开票、部分开票、已开票），支持按状态、时间、客户等筛选。

–发票管理：展示所有已生成的发票（含草稿、待发送、已发送、已作废等状态），支持按发票号、订单号、状态等筛选。

•数据隔离：两个列表的数据源独立，但发票列表中的每张发票均可追溯来源订单（关联订单号）。

3.6.5.3.2 选择性生成发票

•操作入口：在订单列表页面，提供复选框选择单个或多个订单，点击“生成发票”按钮。

•开票规则配置：

–管理员可在后台配置“批量开票规则”：

•合并开票：将所选订单合并生成一张NFe（需符合税务合并条件，如同一客户、同一地址等）。

•分别开票：每个订单独立生成一张发票。

•按商品合并：若所选订单包含相同商品，可合并商品行（需符合税务要求）。

–若所选订单不符合合并条件（如不同客户），系统自动拆分为多张发票。

•分批开票联动：若订单已部分开票，再次选择该订单时，系统仅对剩余未开票金额执行开票（需调用分批开票逻辑，见3.6.5.1）。

•开票预览：点击生成后，弹窗展示即将生成的发票摘要（合并后的金额、商品明细等），用户确认后正式提交开票。

3.6.5.3.3 订单列表可见性控制（权限过滤）

•权限设计：在角色权限管理中，增加以下权限项：

–“查看全部订单”（含未开票）

–“仅查看已开票订单”

–“查看本部门订单”（需结合部门数据权限）

•应用场景：

–收银员角色：可配置为“仅查看已开票订单”，使其在订单列表中看不到未开票记录，避免误操作或信息泄露。

–销售员角色：可配置为“查看本部门订单”，能看到自己客户的未开票订单，便于催款或跟进。

–财务角色：默认拥有“查看全部订单”权限。

•界面实现：

–根据用户权限，订单列表自动过滤数据（后端API根据权限返回对应数据）。

–对于无权限查看的订单，前端不显示任何痕迹（包括统计数字）。

•与防查模式的关系：此功能为常规权限控制，与3.16节“防查模式”无关；防查模式是应对突击检查的全局隐藏，两者可并存。

3.6.5.3.4 客户申请开票与选择性同步

•客户自助申请：

–在私域商城（3.11）的个人中心，增加“申请开票”入口。

–客户可选择已完成支付的订单，填写发票抬头（企业需CNPJ）、邮箱等信息，提交申请。

–系统生成“开票申请单”，状态为“待处理”。

•后台处理：

–财务人员进入“开票申请”列表，查看申请详情，可手动触发开票（调用3.6.5.2生成发票）。

–支持批量处理多个申请。

•发票同步选项：

–自动同步：开票成功后，系统自动将电子发票（XML+PDF）发送至客户邮箱，并同步至税务系统（根据3.8.1配置的渠道）。

–手动同步：开票后暂不发送，状态为“待发送”。财务人员可在发票列表中勾选发票，点击“发送”手动触发同步（可重发）。

–客户自助下载：客户在商城的个人中心可查看已开具的发票，并自行下载PDF。

•通知机制：

–开票成功/失败后，通过站内信、邮件或短信通知客户。

–失败时提示原因，引导客户修改信息后重新申请。

3.6.5.3.5 与现有模块的集成

•与分批开票（3.6.5.1）集成：客户申请开票时，若订单支持分批开票，可指定本次开票金额（如部分开票）。

•与财务模块（3.9）集成：开票后自动生成应收账款凭证。

•与税务模块（3.8）集成：发票同步调用多渠道发送逻辑。

•与审计日志集成：所有开票申请、处理、同步操作均记录审计日志。

3.6.6 打印设置（增强版）

3.6.6.1 支持的打印机连接类型

系统必须支持以下四种打印机连接方式，确保手机端可在任意位置自由打印，不受物理线缆限制：

1.蓝牙打印

–支持通过蓝牙直连便携式热敏打印机（如用于仓库拣货、移动销售）。

–手机与打印机配对后，系统应能自动发现并选择该打印机。

–打印任务发送后，应在10秒内完成输出（取决于打印机速度）。

–支持主流蓝牙打印机品牌（如Epson、Zebra、Bematech等）。

2.Wi-Fi网络打印

–支持通过局域网连接支持Wi-Fi的打印机（如固定在前台、仓库的无线打印机）。

–系统应能自动扫描局域网内的网络打印机（通过mDNS、SNMP或IPP协议），并提供列表供用户选择。

–支持标准IPP协议，兼容主流品牌（Epson、HP、Brother、Kyocera等）。

–允许用户手动添加打印机IP地址。

3.通过PC共享的USB打印机

–支持将连接在PC上的USB打印机通过网络共享，手机通过PC转发打印任务。

–共享方式包括：

a) Windows网络共享（SMB协议）：手机通过支持SMB的打印App或系统打印服务发送任务。

b) PC端代理服务：PC安装轻量级打印代理软件，手机通过局域网将打印数据发送至代理，由代理转发给USB打印机。

–系统不应假设打印机直接连接手机，必须支持通过中间设备（PC）转发。

–PC代理服务需支持后台运行，不影响PC正常办公。

4.云打印

–支持通过云打印服务（如打印机厂商自有云、Google Cloud Print替代方案）发送打印任务。

–打印机可不在同一局域网，手机通过互联网将任务发送至云端，打印机从云端拉取任务打印。

–需支持主流云打印协议（如Mopria、Apple AirPrint、厂商私有云API）。

–允许用户在系统中配置云打印账户（如邮箱、API密钥）。

3.6.6.2 打印机发现与配置

•系统应提供统一的打印机管理界面，支持手动添加、自动发现和配置以上各类打印机。

•对每种连接方式，应提供清晰的设置向导，普通用户无需专业技术即可完成配置。

•支持为不同业务场景（如前台收银、仓库拣货、办公室）预设默认打印机，并根据订单类型（NFCe小票、发货面单、拣货单）自动路由。

•支持打印机状态监控（在线/离线、缺纸、低电量等），并在状态异常时提示用户。

3.6.6.3 移动打印体验要求

•手机在打印过程中不应受物理位置限制：

–使用蓝牙打印机时，手机可在蓝牙覆盖范围内（通常10米以上）自由移动。

–使用Wi-Fi/云打印/PC共享时，手机可在整个网络覆盖区域内任意位置操作。

•打印任务发送后，应提供实时反馈（如“发送成功”“打印机已接收”“打印中”“打印完成”）。

•支持打印任务队列管理，可查看历史任务、重新打印、取消任务。

3.6.6.4 纸张格式与模板

•支持80mm热敏纸、A4、A5、10×15cm热敏纸等；可自定义边距、字体大小。

•打印内容可隐藏所有价格；可选显示辅助单位；支持独立设置同类商品是否合并。

•支持自定义打印模板（如LOGO、公司信息、免责条款、税务二维码）。

•外卖场景增强：支持外卖小票专用模板，可包含以下元素：

–顾客姓名、电话、配送地址

–订单备注（特殊要求）

–取餐码（二维码和数字码，用于自取或骑手核销）

–预计送达时间或取餐时间

–配送方式（平台配送/商家自配）

–商品列表（可包含口味、规格）

–商家自定义信息（如感谢语、促销信息）

•支持按商品分类自动分单打印（如热菜、冷饮分别打印至不同厨房的打印机），减少错单。

3.6.6.5 打印输出格式

•系统必须采用标准打印输出格式，确保兼容性：

–热敏小票：ESC/POS指令集。

–面单/标签：ZPL（Zebra编程语言）或PDF。

–A4/A5单据：PDF。

•所有输出应包含巴西税务要求的强制元素（如NFCe二维码、授权号、CFOP等）。

3.6.7 订单操作

•开单后：默认自动开始新订单；支持复制订单。

•订单修改与快照：修改已完成的订单时，系统自动创建历史快照。

•订单重复弹出提醒：扫描相同商品/客户时，提示近期相似订单。

•批量修改与撤销：支持批量修改价格、折扣等；提供“撤销”功能，可在限定时间窗口内一键回滚。

•序列号管理：支持为商品添加序列号，打印订单时显示。

3.6.8 储备金管理

•功能描述：管理收银员每日备用金的领用、交回、盘点。

•数据记录：开班记录、交班记录、差异金额。

•报表：储备金交接报表，可按收银员、日期范围查询。

•权限：仅财务主管及以上可查看差异详情，并可调整差异。

3.6.9 监控系统集成

•刷单字符实时添加到监控系统，用于防损分析。

•智能防损预警：利用AI分析收银员操作行为，实时向主管推送疑似内盗或作弊的风险警报。

3.7 订单管理库存记录（OMS）

3.7.1 全渠道订单汇聚

•订单来源：POS端、私域商城、电商平台（MercadoLivre, Shopee, Shein, TikTok等）、外卖平台（iFood、Rappi、Uber Eats等）（注：外卖二期）。

•统一订单状态：待分配、待开票、待发货、待打印运单、待揽收、在途、售后维权、确认收货。针对外卖订单增加状态：待接单、待制作、制作中、待取餐、配送中、已完成。

•平台对接：通过API自动拉取电商平台订单；同步产品上下架、库存、价格；对接平台客服消息接口。针对外卖平台，需支持实时订单推送Webhook，并满足平台响应时限要求（通常90秒内确认）。

3.7.2 退换货处理

•退货类型：销售退货、采购退货。

•流程：关联原订单，自动更新库存；退货时可选择恢复原发票或另开发票；退货需审批。

3.7.3 库存管理（增强版）

•多库存状态管理：

–可用库存：当前可销售或可使用的实际库存数量。

–在途库存：已采购但尚未入库的库存数量（采购订单已确认，但未收货）。

–锁定库存：已被订单预占但尚未出库的库存数量（下单预扣库存时）。

–安全库存：为防止缺货而设定的最低库存警戒线，用于预警。

–库存看板可同时展示各状态的数值，并支持钻取查看明细（如查看锁定库存对应的订单列表）。

•实时库存：订单支付成功后扣减库存（或下单预扣，可配置）；采购入库增加库存。

•库存预警：低于安全库存时弹窗提醒，并可一键生成采购建议单。

•智能采购预测：基于历史销售数据、季节性因素、促销活动、天气预报，利用机器学习模型自动计算未来的安全库存和补货点。

•批次/有效期管理：先进先出（FIFO）策略；过期商品禁止销售并报警。

•父子商品库存联动：销售父商品自动扣减子商品库存。

3.7.3.1 库存状态定义与计算规则

•可用库存 = 物理库存 - 锁定库存（若锁定库存已预扣）。物理库存为实际入库并质检合格的数量。

•在途库存 = 已确认采购订单但未完成入库的数量 + 已发货但未确认收货的调拨单数量。

•锁定库存 = 已下单但未支付订单预扣的数量（若配置为下单预扣） + 已支付但未发货订单占用的数量。

•安全库存：由管理员手动设置，或由系统根据历史销售数据自动计算（公式：平均日销量 × 采购提前期 × 安全系数）。

•联动规则：

–当可用库存 ≤ 安全库存时，系统自动触发预警。

–当可用库存 ≤ 0时，禁止继续销售（除非配置允许超卖）。

–在途库存到货入库时，自动增加可用库存，减少在途库存。

3.7.4 拣货发货（手机端PWA）

•功能：手机端展示待拣货订单；扫描订单条码，语音提示拣货商品与数量；扫描商品条码确认拣货。

•打印：支持打印拣货单、发货单、运单；对接物流商自动获取单号。

3.7.5 预售与定金管理

•预售流程：支持客户支付定金预定未来商品。

•资金管理：管理定金、尾款支付节点，以及客户违约或商家违约的财务处理。

•状态跟踪：预售订单状态包括“待付定金”、“定金已付”、“待付尾款”、“尾款已付”、“发货中”等。

3.7.6 智能打单与配货优化

•爆款优先打印：支持按商品SKU筛选待处理订单，将包含指定爆款商品的订单优先打印。

•按商品批量打印：在订单列表页面选择特定商品，系统自动列出所有包含该商品的待处理订单，并支持一键打印所有关联面单。

3.7.7 售后与维修管理

•售后工单管理：客户可通过客服或自助渠道提交售后申请，系统自动生成售后工单并关联原订单。

•维修流程管理：工单状态包括待检测、检测中、待报价、待客户确认、维修中、已完成等；支持检测记录、报价管理、维修记录。

•备件管理：维修使用的备件从备件库扣减，备件库可独立管理库存；支持备件采购建议。

•售后统计：按故障类型、维修周期、维修成本、客户满意度等维度分析售后质量。

3.8 NFCe/NFe电子发票模块（税务核心）

3.8.1 多渠道发票发送（增强版）

•本地渠道：

–FlexDocs：通过本地DLL与SEFAZ通信，发票从客户电脑发出，责任在客户。

–ACBr：开源方案，通过本地DLL集成，免费但需技术支持。

•云端渠道：

–Nuvem Fiscal：通过API由服务器代发，发票从你的服务器发出，责任在你。

–nfe.io：云端服务，需确认计费方式。

•自研API渠道：（注：提供标准接口供其他系统来拉取数据）

–系统需支持接入甲方（或乙方）自行开发的税务API，该API负责接收订单数据、完成税务计算、生成并发送NFe/NFCe/GNRE。

–自研API应作为可选渠道之一，与现有渠道并列，商户可在后台根据配置自由切换。

–自研API的接口规范由甲方另行提供，乙方需按照该规范实现调用逻辑，包括：

•订单数据封装格式（JSON/XML）

•认证方式（API Key / JWT）

•重试机制与错误处理（如指数退避、最大重试次数）

•异步回调或轮询获取发票授权结果

–自研API的稳定性、准确性由甲方负责，但乙方需保证调用层的正确性（如超时处理、日志记录、异常捕获）。

–若自研API不可用，系统应支持自动切换到备用渠道（需配置）。

•配置切换：可在客户资料中选择渠道，支持灵活切换。支持按州配置渠道（如某些州不支持NFCe的本地渠道时，自动切换云端）。同时也支持按业务类型或客户等级选择不同渠道。

3.8.1.1 发票发送模式配置

•支持在客户资料或系统全局配置中，设置发票发送模式：

–自动发送：发票生成后立即通过所选渠道发送至SEFAZ及客户。

–手动发送：发票生成后状态为“待发送”，需用户在发票列表中手动触发发送。

•支持按客户等级、订单类型等条件自动选择发送模式（例如VIP客户自动发送，普通客户手动发送）。

3.8.1.2 发票重发与补发

•对于已发送失败的发票，提供“重发”按钮，支持手动重试。

•对于客户未收到的情况，支持重新发送至指定邮箱（需记录审计）。

3.8.2 CFOP自动化判断

•规则引擎：根据操作类型、买卖双方地址、企业类型、业务场景自动推荐CFOP。

•CFOP表：内置巴西官方CFOP表，支持热更新。

•准确率要求：CFOP自动推荐的准确率必须达到95%以上（以人工复核为准）。

•异常处理：当系统无法确定CFOP（如多个候选且置信度低于80%）时，必须提示用户手动选择，并提供推荐选项和说明。

•学习机制：系统应记录用户手动修正的CFOP，用于优化推荐算法。

3.8.3 CST/CSOSN自动化判断

•企业税制判断：CRT=1使用CSOSN，CRT=3使用CST。

•来源码：从商品主数据获取。

•情况码自动化：根据购买方类型、是否涉及ST、是否免税、操作类型动态匹配。

•MEI企业限制：MEI企业只能使用特定CSOSN，CFOP需对应。

3.8.4 税率计算引擎

•可配置税率：ICMS（按州）、PIS/COFINS（累积制/非累积制）、IPI（按NCM）、MVA。

•自动计算：根据商品NCM、CFOP、买卖方地址自动计算税额；支持税基减免、免税、暂停征税等场景。

3.8.5 发票生命周期管理

•状态：待发送、已发送待授权、已授权、被拒、已取消。

•操作：发送、查询、取消（需符合法定时间窗口）、PDF导出。

•异常处理：被拒时返回错误原因，提示用户修改后重试；自动重试3次，记录日志。

3.8.6 离线补开

•流程：断网时订单只记录在本地，不生成正式发票；网络恢复后自动将待开票订单通过所选渠道发送；若发送成功，更新订单状态并同步至云端；若失败，提示用户手动处理。

3.8.7 会计拉取XML

•功能：会计/财务人员可登录系统，按日期范围拉取已开具的NFe/NFCe XML文件，支持批量下载。

3.9 业务财务（FMS）

3.9.1 财务基础设置

3.9.1.1 会计科目表（增强版）

•预置科目：系统预置巴西标准会计科目表（基于Lei das S/A），包含资产、负债、权益、收入、费用等科目，支持层级结构。

•科目属性：科目代码、名称（多语言）、类型、方向、是否末级、外币核算、辅助核算。

•科目层级与继承：支持无限级科目层级；子科目自动继承父科目属性。

•科目预算管理：可为科目设置年度/月度预算；预算预警；预算报表。

•科目多版本与生效日期：修改时保留历史版本；支持设置生效/失效日期。

•辅助核算增强：支持多辅助核算组合（如客户、供应商、商品、部门、项目）；支持辅助核算项的分层结构；支持批量导入。

•科目级权限控制：支持按角色设置科目的查看、录入、修改权限；支持按部门、公司实体隔离。

•外币核算增强：一个科目可关联多个币种；汇率管理（手动或自动拉取）；外币重估。

•科目变更审批流：支持配置科目变更的审批流程；变更记录对比。

•自定义科目：允许用户新增、修改、禁用科目。

•性能要求：支持至少10级科目层级，查询任意科目及其下级科目时，响应时间不超过3秒。

•测试标准：在包含5000个科目的数据库中，查询最深10级科目的完整路径，响应时间符合要求。

3.9.1.2 凭证类型与编号规则

•预定义凭证类型：RC（收款）、PG（付款）、TR（转账）、GL（通用）。

•自定义凭证类型：支持用户新增，配置类型代码、名称、编号规则、是否限制借贷方。

•凭证编号：系统自动按规则生成，支持手工修改（需权限）。

3.9.1.3 自动凭证模板

•模板定义：管理员可配置各业务事件触发的自动凭证模板（销售、采购、收款等）。

•模板组成：触发事件、条件、分录模板（借/贷方科目、金额公式）。

3.9.1.4 财务期间与关账

•会计期间：按月划分，支持自定义期间起止。

•关账控制：关账后禁止录入或修改该期间凭证；允许反关账（需权限）。

•年末处理：自动结转损益；生成下一年初余额。

3.9.2 日常业务自动化处理

3.9.2.1 销售与收款

•销售出库：自动生成收入凭证（借：应收账款，贷：主营业务收入，贷：应交税费）。

•收款：自动生成收款凭证（借：银行存款，贷：应收账款）；支持手续费拆分。

•分期收款：支持多期收款计划，自动生成每期收款凭证。

•分批开票联动：若订单采用分批开票，则每批发票独立生成应收账款；后续收款时自动核销对应发票。

3.9.2.2 采购与付款

•采购入库：自动生成采购凭证（借：库存商品，借：应交税费，贷：应付账款）。

•付款：自动生成付款凭证（借：应付账款，贷：银行存款）。

3.9.2.3 费用管理

•周期性费用：可配置周期性模板，到期自动生成费用凭证。

•单笔费用报销：员工提交报销单，审批通过后自动生成凭证。

•费用分摊：支持将费用按比例分摊到多个部门。

3.9.2.4 库存核算

•成本计算方法：支持移动平均、先进先出，按商品配置。

•存货跌价准备：可配置计提规则，自动生成准备凭证。

3.9.2.5 银行与现金管理

•银行对账：导入银行流水，自动匹配系统收付款记录；生成余额调节表。

•现金盘点：收银员交班时，差异自动生成现金溢余/短缺凭证。

3.9.2.6 支票管理

•功能概述：提供支票从购入、领用、开具、背书、报销到作废的全生命周期管理。

•支票本管理：登记支票本，追踪每张支票的实时状态。

•领用与审批：出纳领用支票需填写用途、预计金额，并提交审批。

•支票开具：开出支票时自动填充支票号码、出票日期；收到支票时记录出票人；背书转让时记录背书历史。

•报销与核销：支票兑现后标记为“已报销”；导入银行流水时自动匹配对账。

•到期预警与提醒：对长期未兑现的支票设置预警。

•报表与审计：提供支票台账，所有操作记录审计日志。

3.9.3 期末处理

3.9.3.1 汇兑损益

•对外币科目，期末按当前汇率自动计算汇兑损益，生成凭证。

3.9.3.2 待摊与预提

•待摊费用：支付时计入长期待摊费用，按月摊销。

•预提费用：按期计提，生成预提凭证。

3.9.3.3 税费计提与缴纳

•计提：根据税务模块的申报数据，自动生成各项税费的计提凭证。

•缴纳：根据付款单，生成缴纳凭证。

3.9.3.4 成本结转

•销售成本结转：根据当期销售出库数量和成本计算方法，自动计算销售成本并生成凭证。

3.9.3.5 损益结转

•期末自动将收入、费用类科目余额结转至“本年利润”。

3.9.4 财务报表与分析

3.9.4.1 标准财务报表

•资产负债表：支持按年、月、自定义期间生成。

•利润表：支持多期间对比（本月、本年累计、上年同期）。

•现金流量表：支持直接法和间接法。

3.9.4.2 管理报表

•销售毛利分析表、应收账款账龄分析表、应付账款到期预警表、费用明细表、收银员交班差异汇总表、引流效果报表、预算执行分析表、项目损益表。

3.9.4.3 自定义报表生成器

•拖拽式报表设计：用户可从数据源中拖拽字段，自由组合生成报表。

•数据源选择：支持单表或关联多表。

•字段配置：可选择显示字段，设置别名、排序、汇总方式。

•过滤条件：支持设置动态过滤条件。

•图表支持：可将报表数据一键转换为图表。

•报表模板保存：设计好的报表可保存为模板，供以后使用。

•报表调度：支持定时生成并通过邮件发送。

3.9.4.4 仪表盘自定义

•个人驾驶舱：用户可自由组合图表、报表、KPI，创建个人工作台。

•组件库：提供丰富的组件，支持拖拽布局。

•数据钻取：点击图表可下钻查看明细数据。

•多页仪表盘：支持创建多个仪表盘标签页。

•分享与导出：支持分享仪表盘或导出为PDF/图片。

3.9.4.5 报表导出与打印

•支持导出 Excel、PDF，可配置报表模板；支持定时发送至邮箱。

•会计账户（明细账）自定义：支持自定义明细账的显示字段、打印格式；支持按自定义标签筛选账户；支持保存多个显示模板。

3.9.5 税务与会计集成

3.9.5.1 税务凭证对接

•销售发票：自动从税务模块获取已授权的NFe/NFCe信息，生成销售相关的税务凭证。

•采购发票：从税务模块获取采购发票，自动生成采购入库凭证及进项税抵扣凭证。

•税务申报表导出：支持按会计期间导出SPED Fiscal、SPED Contribuições等申报所需数据。

3.9.5.2 外部会计系统对接

•提供标准API接口，将生成的记账凭证推送至第三方会计系统（Conta Azul、Omie等）。

3.9.6 复杂促销引擎的财务处理

•促销优惠分摊：优惠金额需按比例分摊到各商品。

•赠品视同销售：自动生成收入凭证和税金凭证。

•凭证自动生成：根据促销活动规则，自动生成对应的调整凭证。

3.9.7 佣金计算规则引擎【V9.4新增】 （注：外卖的佣金在二期，其他商城和销售员的佣金规则在一期）

为满足复杂的佣金计算需求（如销售员佣金、多级分销、中介服务费、平台抽成等），系统需提供灵活的佣金规则引擎，支持多种计算模式和多角色分账。

3.9.7.1 核心概念

•佣金主体：可获得佣金的实体，包括销售员、分销商、合作伙伴、平台等。

•佣金规则：定义佣金计算的逻辑，包括适用条件、计算基数、计算方式、封顶/保底等。

•佣金明细：每笔交易生成的佣金记录，包含主体、金额、状态、关联单据。

3.9.7.2 佣金规则定义

•适用范围：

–按商品/商品分类：可为特定商品或类别设置佣金规则。

–按客户等级：可为不同等级的客户设置不同的佣金比例（例如高级客户交易佣金更高）。

–按订单金额/数量：可设置阶梯规则，如订单金额越大佣金比例越高。

–按时间：可设置有效期，仅当订单在有效期内才计算佣金。

–按销售区域：可按门店、地区设置不同规则。

–按外卖平台：可为不同平台（iFood、Rappi、Uber Eats）配置独立的佣金比例，适用于平台抽成场景。

•计算基数：

–订单商品销售额（不含税）

–订单毛利（销售额 - 成本）

–订单实收金额（含税或不含税，可配置；对于外卖平台，可配置为扣除顾客小费后的金额）

–固定金额（如每单固定佣金）

•计算方式：

–比例：按基数乘以百分比（如销售额的5%）。

–固定金额：每笔订单或每件商品固定佣金。

–阶梯比例：根据基数大小自动切换比例（例如0-1000元佣金5%，1000-5000元佣金8%）。

–累进/累退：可配置随基数增加比例升高或降低。

–混合模式：支持固定金额+比例的组合。

•封顶与保底：

–可设置单笔佣金最高金额（封顶）。

–可设置单笔佣金最低金额（保底），若计算值低于保底则按保底发放。

•多角色分账：

–支持一个订单的佣金分配给多个主体（如销售员、上级经理、平台）。

–可配置分配比例（如销售员得70%，上级得20%，平台得10%），或固定金额。

–支持按层级定义（如一级分销、二级分销）。

•规则优先级：可配置多条规则同时生效时的处理方式（如取最高、取最低、累加），或指定优先级顺序。

3.9.7.3 佣金计算与执行

•触发时机：

–订单完成（支付成功且未发生退款）时自动计算。

–支持手动重新计算（如规则变更后批量重算）。

–支持预览计算（查看某订单预计佣金）。

•计算流程：

1.系统根据订单商品、客户、销售员等信息，匹配所有适用的佣金规则。

2.按规则优先级依次计算，生成初步佣金明细。

3.应用封顶/保底调整。

4.若涉及多角色分账，拆分为多个主体的佣金记录。

5.生成佣金明细记录，状态为“待确认”。

•审核与确认：

–佣金明细可经财务人员审核后生效，也可配置为自动生效。

–支持批量审核、驳回（需填写原因）。

–审核通过后，状态变更为“待结算”。

•结算与支付：

–支持按周期（周、月）生成佣金结算单，汇总应付佣金。

–结算单可与工资模块（3.5.2）联动，计入员工工资。

–支持导出结算明细，用于线下支付或通过银行转账。

–支付完成后，更新佣金状态为“已结算”。

3.9.7.4 佣金报表与分析

•佣金明细表：按时间、销售员、订单等维度查看佣金明细。

•佣金汇总表：按销售员、部门统计期间内应付/已付佣金总额。

•佣金对比分析：佣金与销售额、毛利的对比，评估佣金效果。

•未结算佣金预警：提醒即将到结算周期的佣金。

3.9.7.5 与现有模块的集成

•与销售员管理（3.5.3）集成：佣金计算与现有销售员佣金功能合并，统一由规则引擎处理。

•与订单管理（3.7）集成：订单状态变化触发佣金计算；退款时自动冲销或扣回佣金。

•与财务模块（3.9）集成：结算时自动生成应付凭证（借：销售费用-佣金，贷：应付佣金）。

•与审计日志集成：所有规则配置、计算、审核、结算操作记录审计日志。

3.9.7.6 界面要求

•规则配置界面：提供可视化规则配置器，支持条件、基数、计算方式的拖拽式组合。

•规则测试工具：允许输入模拟订单，预览佣金计算结果。

•佣金明细列表：支持按多种条件筛选、导出，提供图表分析。

3.9.7.7 性能要求

•单订单佣金计算时间 ≤ 1秒。

•支持每日处理百万级订单的佣金计算（可异步队列）。

3.10 电商平台集成

3.10.1 平台对接

•支持平台：MercadoLivre、Shopee、Shein、TikTok、Shopfay，Amazon，Magazine Luiza、Americanas、aliexress、Temu，kwai，tiktok （注：对接平台固定优先对接6个：MercadoLivre、Shopee、Amazon、TikTok、Magazine Luiza、Temu）。

•功能：商品同步（上下架、库存、价格）；订单自动拉取；发货状态同步；平台客服消息接口对接。

3.10.2 发货管理

•流程：订单状态流转；手机端配货扫描；打印发货单、运单。

•物流对接：集成主流物流商（Correios、Jadlog），自动获取单号；支持自定义面单配置。

3.10.3 售后处理

•15天维权期：平台订单退货退款自动同步至OMS；退货审批后自动更新库存并生成红字发票。

3.10.4 外卖平台对接【V9.5新增】（注：外卖部分二期）

3.10.4.1 功能概述

实现与巴西主流外卖平台（iFood、Rappi、Uber Eats）的深度集成，支持外卖订单的自动接入、处理、配送跟踪及财务结算，帮助餐饮及零售商户高效管理外卖业务。

3.10.4.2 支持的外卖平台

•iFood：巴西最大的外卖平台，需对接其商家API（iFood Partner API）。

•Rappi：拉丁美洲平台，在巴西广泛使用，需对接Rappi商家API。

•Uber Eats：全球平台，需对接Uber Eats商家API。

•预留扩展能力，支持未来接入其他平台（如Aiqfome、James Delivery等）。

3.10.4.3 核心功能要求

3.10.4.3.1 订单接入与确认

•实时订单推送：通过平台Webhook或API轮询方式，实时获取新订单。

•订单数据转换：将平台订单数据（顾客信息、商品列表、配送地址、特殊要求、支付方式等）转换为系统内部标准订单格式。

•订单校验：

–自动校验订单完整性（商品是否存在、库存是否充足）。

–若商品缺货或异常，可根据配置自动拒绝订单（调用平台拒单接口）或标记待人工处理。

•接单确认：校验通过后，必须在平台规定的时限内（通常90秒）向平台返回“确认接单”状态，否则订单可能被自动取消。

•去重处理：根据平台订单号检查订单是否已存在，防止重复处理。

3.10.4.3.2 库存管理与预占

•库存检查：根据订单商品列表，实时检查对应门店/仓库的可用库存（若为菜品则检查食材库存）。

•库存预占：确认接单后，自动锁定相应库存（减少可用库存，增加锁定库存），防止超卖。

•库存同步：支持将门店库存状态实时同步至外卖平台（可选），如菜品售罄时自动下架。

3.10.4.3.3 订单分发与厨房显示

•自动路由：根据订单中的门店标识（或商品所属门店），将订单自动分发给对应门店的POS或厨房显示系统（KDS）。

•厨房显示（KDS）：

–提供专门的KDS界面或模块，实时展示外卖订单列表，包括商品明细、数量、特殊要求、倒计时等。

–支持后厨操作员更新订单状态（如“制作中”、“已完成”）。

–支持按商品分类分屏显示（如热菜、冷饮、烧烤等）。

•打印厨房小票：若门店未使用KDS，可配置自动打印外卖小票（通过蓝牙/Wi-Fi/云打印机），后厨凭小票制作。支持按商品分类分单打印到不同打印机。

3.10.4.3.4 状态同步与通知

•制作状态同步：后厨完成制作后，系统将状态更新为“待取餐”，并通过API同步至外卖平台。

•取餐核销：

–为自取订单生成唯一的取餐码（支持二维码和数字码），通过短信或App发送给顾客。

–支持POS或移动端扫码核销：顾客到店出示取餐码，店员扫描后确认取餐，系统更新订单状态为“已完成”。

–对于骑手取餐，可支持骑手App扫码确认取餐（需对接平台配送API）。

•配送状态跟踪：

–对于平台配送订单，通过平台API获取配送状态（骑手已接单、已取餐、配送中、已送达），并同步至系统。

–对于商家自配送，系统需提供配送任务管理功能，或集成第三方配送平台（如Loggi），实现配送员接单、轨迹跟踪、送达确认。

3.10.4.3.5 异常处理

•拒单/取消：若因库存不足或其他原因需拒绝订单，系统应调用平台拒单接口，并释放预占库存。

•平台推送重试：若系统临时不可用，平台推送失败时应自动重试（需实现幂等处理）。

•退款处理：当平台发起退款时，系统需接收退款通知，自动冲销库存并生成财务凭证。

•配送异常：若骑手无法联系顾客导致订单取消，系统应支持商品退回入库，并记录异常。

3.10.4.3.6 财务结算

•平台佣金处理：根据与各平台约定的佣金比例，自动计算每笔订单的平台佣金（可复用3.9.7佣金规则引擎）。

•配送费处理：区分平台配送费和商家自配费，自动计入成本或收入。

•顾客小费：记录顾客支付的小费，全额归配送员（可计入工资模块）。

•结算对账：

–每日自动拉取平台结算文件或通过API获取结算数据，与系统内订单进行逐笔匹配对账。

–生成对账差异报告，标记异常交易供人工处理。

•凭证生成：根据对账结果，自动生成应收账款（对平台）、应付佣金、配送费等财务凭证。

3.10.4.3.7 菜单与价格同步

•菜品/商品同步：支持将系统的商品信息（名称、价格、描述、图片、库存、分类）自动同步至外卖平台。

•上下架管理：支持在系统后台控制商品在外卖平台的上下架状态。

•价格策略：可配置外卖平台专用价格（如略高于堂食价格），或应用促销活动（如满减、折扣），并同步至平台。

3.10.4.3.8 数据报表与分析

•外卖订单报表：按平台、门店、时间段统计订单量、销售额、客单价、热门商品等。

•配送分析：平均配送时间、准时率、配送员绩效。

•平台对账报表：按平台汇总应收、实收、差异金额。

•顾客评价分析：获取平台提供的顾客评分和评价内容，进行分析和预警。

3.10.4.4 技术实现要求

•接口方式：支持平台Webhook实时推送和API主动拉取两种模式。

•响应时限：对接单确认接口的响应时间需满足平台要求（通常<90秒），系统需确保高可用。

•重试机制：对于调用平台接口失败的情况，需实现指数退避重试，最大重试次数可配置。

•安全：使用平台提供的OAuth2或API密钥认证，敏感信息加密存储。

•日志：记录所有与平台交互的请求和响应日志，便于排查问题。

3.10.4.5 与现有模块的集成

•与订单管理（3.7）集成：外卖订单作为订单的一种类型，纳入统一订单视图。

•与库存管理（3.7.3）集成：接单时预占库存，完成时扣减库存。

•与打印模块（3.6.6）集成：支持打印外卖小票、厨房单。

•与财务模块（3.9）集成：自动处理平台佣金、配送费、对账凭证。

•与移动端（3.20）集成：支持骑手App或店员移动端核销取餐。

•与客户管理（3.2）集成：记录外卖顾客信息，用于后续营销。

3.11 私域商城（DTC）

3.11.1 商城前台

•技术选型：自适应PC/手机/PWA；支持多语言切换。

•页面元素：产品展示、搜索功能、悬浮注册弹窗、优惠码输入框。

•客户注册/登录：可配置开启/关闭自助注册；支持上传资质文件；支持一键注册并自动关联来源渠道。

3.11.2 购物流程

•下单：支持预扣库存或支付成功扣库存；支付方式：Pix、信用卡、银行转账。

•支付后：自动转入OMS；客户可在个人中心查看订单状态。

•未支付订单：保留为“寻价单”，可联系销售员修改价格后支付。

3.11.3 会员与营销

•会员等级：按消费金额自动升级，不同等级享受不同折扣。

•积分：消费送积分，积分可抵扣现金。

•营销工具：优惠券、满减活动、限时折扣、组合促销（与促销引擎联动）。

3.11.4 网站结构与样式自定义

•主题管理：预设主题库；支持颜色、字体、圆角、间距、Logo等自定义；主题复制与重置。

•可视化页面构建器：拖拽式编辑；组件库（基础、商品、营销、互动、自定义HTML）；组件可配置数据源、显示样式；多页面管理；实时预览；草稿与发布。

•移动端适配：响应式设计；支持为移动端单独设计布局。

•自定义代码注入：允许在或前注入自定义代码；支持页面级注入。

•多语言适配：页面文本内容支持多语言录入，系统根据用户偏好自动切换。

•权限与协作：可设置“网站设计师”角色，拥有全部权限；所有修改操作记录审计日志。

3.11.5 价格展示策略

•支持根据登录客户的身份（如客户等级、客户类型、是否批发客户）动态展示对应价格。

•商品列表和详情页默认显示该客户适用的价格（如批发客户显示“批发价”，普通客户显示“零售价”）。

•若客户未登录，则显示默认价格（如零售价）或提示登录查看专属价格。

•管理员可在后台配置“价格展示规则”，例如：

–等级A客户 → 显示批发价

–等级B客户 → 显示零售价×折扣率

–特定客户标签 → 显示自定义价格

3.11.6 商品备注显示

•功能描述：在私域商城的商品列表页和商品详情页，展示商品的前台备注字段内容。

•显示规则：

–仅对已登录的会员显示，未登录用户不显示或显示提示信息（如“登录后查看联系方式”）。

–支持多语言：根据会员的语言偏好自动切换备注内容（若该商品有对应语言的备注）。

–显示位置和样式可由商户在网站主题或页面构建器中自定义（例如显示在价格下方、作为角标、或通过“查看详情”弹窗展示）。

•配置选项：

–商户可在后台商品管理或商城设置中，开启/关闭前台备注的显示。

–可控制备注是否允许包含超链接（需注意安全，防止钓鱼）。

–支持对备注内容进行敏感词过滤（如联系方式可能被滥用，可配置是否启用审核）。

•中介模式应用：平台可利用此字段向会员展示供应商的联系方式（如WhatsApp号码、微信号），同时隐藏供应商真实身份，由会员自行联系。

3.11.7 其他商城功能

…（此节原无内容，保留空白）

3.12 外部系统集成（注：外卖部分二期）

3.12.1 聚合支付平台深度集成

•对接平台：Stone, PagSeguro, Cielo等。

•自动对账：每日自动拉取支付平台结算文件，与系统内交易流水逐笔匹配。

•分期付款管理：支持信用卡分期场景，财务凭证自动拆分。

3.12.2 会计系统一键对接

•对接目标：Conta Azul, Omie等。

•功能：将记账凭证、财务报表通过API一键推送。

3.12.3 WMS集成接口

•对接目标：第三方WMS。

•功能：OMS订单下发后可推送至外部WMS，WMS作业完成后回传发货状态和库存变动。

3.13 AI智能客服与数字人直播 （注：AI部分二期）

3.13.1 智能客服

•技术：集成大模型API，基于知识库自动回复。

•功能：7x24小时在线；可转人工；多语言支持；自动识别用户来源渠道并植入引流话术。

3.13.2 数字人直播

•对接：对接第三方数字人SaaS。

•功能：自动生成直播脚本；智能互动；自动讲解商品、发放优惠券、引导下单；直播中可推送独立站专属链接。

3.14 AI智能运营与决策支持

3.14.1 智能采购预测

•数据基础：历史销售、季节性、促销、天气等。

•模型输出：自动计算未来安全库存和补货建议，支持一键生成采购订单。

•可视化：展示预测曲线与实际对比。

3.14.2 动态定价引擎

•策略配置：管理员可设定定价规则（如毛利率底线、竞争对手价格来源）。

•实时调价：根据库存时间、销量、竞品价格自动微调。

•执行记录：所有自动调价操作记录审计日志。

3.14.3 智能防损预警

•行为分析：监控收银员操作频率，通过机器学习模型识别异常模式。

•实时推送：触发阈值后向主管发送预警信息。

3.14.4 销售员智能助手

•客户画像弹窗：销售员打开客户详情时，自动展示客户偏好并推荐交叉销售/向上销售产品。

•话术建议：基于客户咨询内容，从知识库中匹配最佳回复话术。

3.15 开放平台与开发者生态 （注：开放生态平台二期）

3.15.1 开发者门户

•文档中心：提供完整的API参考文档、SDK、使用指南。

•沙箱环境：提供独立的测试环境。

3.15.2 Webhook机制

•事件订阅：允许开发者订阅系统内部事件（订单创建、库存更新、发票授权等）。

•实时回调：事件发生时通过HTTP POST推送数据。

•重试机制：推送失败自动重试，记录日志。

•新增事件：用户注册、优惠券领取、引流点击、售后工单创建、项目里程碑完成、页面发布等。

3.15.3 应用市场

•第三方应用展示：列出基于开放平台开发的插件或应用。

•应用管理：商户可在后台管理已授权的第三方应用。

3.16 进销存系统防查模式（混合策略）

3.16.1 总体目标

满足突击检查时的数据隐蔽需求，同时保证日常操作高效。

3.16.2 核心策略（增强版）

•策略A（本地隐藏 - 离线友好）：所有订单存储在本地，防查模式下隐藏未开票订单。

–隐藏实现要求：

•隐藏方式必须从数据库层面或文件系统层面实现，不得仅在前端UI隐藏（防止懂技术的检查人员查看源代码或网络请求）。

•隐藏的订单数据应加密存储，密钥与终端绑定，防止数据库文件被直接读取。

•隐藏模式下，系统界面不得显示任何未开票订单的痕迹（包括订单数量统计、最近订单列表等）。

•解除隐藏后，所有数据必须完整恢复，不得丢失。

•策略B（云端存储 - 安全优先）：未开票订单创建后立即同步云端，本地物理删除；需查看时从云端下载。

3.16.3 全局检查模式

•触发方式：扫码、管理端、热键。

•触发效果：策略A终端立即隐藏未开票订单；策略B终端无变化。

•解除方式：同样支持扫码、管理端或热键。

3.16.4 多终端同步与状态监控

•实时推送：服务器通过WebSocket维护全局状态，确保在线终端1秒内同步。

•心跳监控：终端定期上报状态，服务器展示未同步终端列表。

3.16.5 离线终端处理

•策略A终端离线：超时自动进入本地防查模式。

•策略B终端离线：未开票订单临时保留本地，超时强制锁定开单功能。

3.16.6 界面与提示

•终端界面顶部常驻显示全局检查模式状态和本终端所用策略。

3.16.7 安全与审计

•记录所有全局模式触发、策略变更、同步操作；本地数据库加密。

3.17 第三方平台流量引导模块（跨域引流）(注：该部分属于第三方引流项目，不属于业务核心部分，建议二期或者三期再考虑)

3.17.1 功能概述

打通第三方平台与独立站之间的流量通道，实现“平台引流+独立站转化”的闭环。

3.17.2 流量引导核心策略

•平台客服引导系统：配置引流话术模板，自动回复中嵌入独立站链接，追踪客服绩效。

•包裹物料引流系统：生成品牌卡片（含二维码、优惠码），智能插单规则。

•社交媒体引流增强：Link-in-bio管理工具，短视频引流组件。

•专属优惠码系统：为不同平台生成独立优惠码，追踪码后效。

3.17.3 引流活动管理

•平台活动同步：自动同步生成独立站专属活动页。

•限时引流活动模板：新品预热、平台独享+独立站专享组合、直播引流。

3.17.4 用户身份识别与沉淀

•跨域用户识别：UTM参数追踪、设备指纹识别、Cookie同步。

•私域沉淀机制：一键注册引导、社交登录集成、私域社群入口。

3.17.5 数据分析与效果追踪

•引流仪表盘：实时数据监控、渠道效果对比。

•用户旅程追踪：全链路追踪、归因分析。

•智能优化建议：引流效果预测、建议优化策略。

3.17.6 技术实现要求

•外部平台API对接：电商平台、社交媒体、支付平台。

•追踪技术实现：短链接服务、二维码动态生成、Webhook事件。

•隐私合规设计：LGPD合规、数据脱敏、支持数据导出与删除。

3.17.7 与现有模块的联动

•客户管理、POS、OMS、财务、开放平台联动。

3.18 项目型业务管理

3.18.1 项目立项与基础信息

•项目创建：为大型订单、长期合约或内部任务创建项目，包含基本信息、附件、项目模板。

3.18.2 项目任务与进度管理

•任务分解（WBS）：支持多级任务，指定负责人、计划时间、状态；支持任务依赖。

•进度跟踪：甘特图展示；超时任务自动预警。

3.18.3 项目成本与收入

•项目预算：按任务或费用类型设置预算；实时监控超支预警。

•项目收入：订单收入自动归集到项目；支持分期收款计划。

•项目成本归集：人力成本、物料成本、外协成本、其他费用自动或手动计入。

•项目损益表：实时计算项目利润。

3.18.4 项目报表

•项目列表、任务明细表、成本明细表、工时统计表。

3.19 营销自动化

3.19.1 自动化营销工作流

•触发条件：用户行为（注册、下单、加购未支付等）、时间条件、自定义事件。

•执行动作：发送邮件、短信、WhatsApp消息；发放优惠券；更新用户标签；触发Webhook。

•流程编辑器：可视化拖拽式编辑，支持条件分支、延迟、A/B测试。

3.19.2 用户分群与标签

•标签管理：支持手动打标签、规则自动打标签。

•RFM模型分析：自动计算R、F、M，划分客户价值层级。

3.19.3 营销活动管理

•活动创建：填写名称、时间、目标人群、执行动作、预算。

•活动执行：系统根据配置自动执行，记录每次触达。

•活动效果分析：触达率、打开率、点击率、转化率、ROI。

3.20 移动端应用（增强版）

3.20.0 移动端功能一致性要求

•移动端（手机/PDA）必须实现以下核心功能，功能完整度不低于PC端的80%：

–订单创建、修改、查询（含历史订单）

–商品扫描、添加、修改数量/价格（权限控制同PC）

–客户信息查看、编辑

–打印（支持本文3.6.6规定的全部连接方式）

–库存查询、盘点、移库（仓库人员）

–审批（管理人员）

•移动端界面需针对触摸操作优化，不得简单缩放PC界面。

3.20.1 移动端仓库管理（PDA/手机）

•拣货：离线模式、语音提示、扫描确认、连续扫描。支持通过蓝牙打印机直接打印面单/标签。

•盘点：支持按货架、按品类、按批次盘点；实时比对差异。

•入库：扫描采购单号，完成入库；支持打印批次条码。

•移库：扫描商品条码，输入源货位和目标货位。

3.20.2 移动端销售助手（手机）

•客户管理：查看名下客户、详情、历史订单、信用额度。

•快速开单：手机创建订单，扫描商品添加，修改价格/折扣。开单后可直接通过Wi-Fi/云打印/PC共享发送至前台打印机，或通过蓝牙便携机立即打印小票。

•拜访计划：查看今日拜访计划，签到（GPS定位），记录拜访纪要。

•业绩看板：查看个人销售额、佣金、目标完成进度。

•商品备注显示：在商品选择或详情界面，展示商品的前台备注，方便销售员向客户传达特殊信息。

3.20.3 移动端审批

•待审批列表：展示所有待审批任务。

•审批操作：支持通过、驳回、转交，可填写审批意见。

•消息推送：新待审批任务时推送通知。

3.20.4 移动打印场景

•场景一：仓库移动拣货

仓库人员手持手机/PDA，扫描订单条码，系统显示需拣货商品。拣货完成后，点击“打印面单”，手机通过蓝牙连接随身便携打印机，立即输出面单并粘贴。

•场景二：门店销售开单

销售员在客户现场用手机开单，客户付款后，销售员点击“打印小票”，手机通过店内Wi-Fi将任务发送至前台热敏打印机，客户可立即拿到小票。

•场景三：办公室打印报表

经理在手机端查看销售报表，点击“打印”，通过云打印将报表发送至办公室的A4网络打印机，无需连接任何线缆。

•场景四：应急打印

当网络中断时，手机仍可通过蓝牙直连打印机打印已保存的订单，确保业务不中断。

3.20.5 移动端外卖核销【V9.5新增】

•场景：店员使用手机或PDA扫描顾客出示的取餐码（二维码），快速核销外卖订单。

•功能：

–扫描后显示订单详情，确认无误后点击“核销”，订单状态更新为“已完成”。

–支持离线核销：断网时本地记录核销，联网后同步至云端。

–核销记录可追溯。

3.21 多公司/多门店/多仓库管理

3.21.1 多公司架构

•公司管理：支持创建多个独立法人公司，数据完全隔离；总公司可查看所有子公司报表。

•公司间交易：支持公司间采购、销售，自动生成内部应收应付。

3.21.2 多门店管理

•门店管理：每个门店可设置独立信息、收银员、销售员、库存、定价策略。

•门店库存：按门店独立核算，支持门店间调拨。

•门店销售数据：总部可实时查看各门店销售报表。

3.21.3 多仓库管理

•仓库类型：中心仓、区域仓、前置仓、门店仓。

•仓库库存：按仓库独立核算，支持仓库间调拨；智能发货路由。

•仓库权限：仓库管理员只能查看和管理自己负责的仓库。

3.22 国际化支付方式

3.22.1 国际支付网关对接

•支持网关：PayPal、Stripe、Sofort、Klarna、Afterpay（注：固定对接2家或者对接一个聚合支付的平台）等。

•功能：用户下单时可选择国际支付方式；支付时自动切换对应币种；支付成功后订单创建。

3.22.2 多币种结算

•币种管理：系统支持多币种（BRL、USD、EUR、CNY）；汇率管理。

•财务处理：订单支付时按当时汇率折算为本币入账；外币户直接记录外币金额，期末重估汇兑损益。

3.23 税务规则细化

3.23.1 各州差异化税务规则

•按州配置：支持为巴西每个州独立配置ICMS税率、MVA、特定CST/CSOSN限制；跨州交易自动应用相关规则。

•规则热更新：税务规则变更时可通过后台配置更新，无需停机。

3.23.2 NF-e/NFCe高级功能

•发票作废申请：支持在系统内提交发票作废请求，自动跟踪结果。

•发票补打：支持重新打印已开具的发票PDF。

•发票PDF自定义模板：商户可自定义发票PDF的样式。

3.23.3 其他国家税务预留

•美国销售税：预留销售税计算引擎，支持按州、县、城市设置税率。

•欧洲VAT：预留增值税计算引擎，支持跨境B2B、B2C不同税率规则。

•税码映射：通过配置实现不同国家税码与系统内部税码的映射。

3.24 GNRE自动生成模块

3.24.1 功能概述

GNRE是巴西用于跨州交易时缴纳州税的统一缴款单。本模块实现GNRE的自动生成、发送、打印和状态追踪。

3.24.2 核心功能

•GNRE数据自动生成：NFe开具时若涉及跨州交易且需缴纳GNRE，自动触发；支持手动创建。

•税款计算与配置：按UF、receita配置税率规则；自动计算应缴税额；支持多期生成。

•GNRE生成与发送：支持单张或批量生成；发送渠道（本地ACBrGNRE/FlexDocs DLL或云端API）；生成XML和PDF。

•GNRE生命周期管理：状态（待生成、已发送待授权、已授权、被拒、已取消、已缴款）；操作（发送、查询、取消、PDF导出）。

•缴款状态追踪：支持手动标记已缴款或集成银行自动获取；逾期提醒；历史查询。

3.24.3 与现有模块的联动

•与NFe/NFCe模块联动：开票时自动触发，取消时自动作废。

•与财务模块联动：缴款后自动生成付款凭证。

•与OMS联动：跨州订单标记需生成GNRE，发货前校验状态。

•与离线能力联动：断网时本地生成，联网后自动发送。

3.24.4 技术实现要求

•税务规则引擎：支持各州规则差异和热更新。

•集成方式：ACBrGNRE方案、FlexDocs方案、云端方案。

•证书管理：使用与NFe/NFCe相同的数字证书，支持到期提醒。

3.25 分布式生产管理【V9.0新增】

3.25.1 功能概述

为满足多工厂、多工序协同生产的需求，提供生产工单、工序流转、在制品跟踪、半成品库存管理、工厂间调拨等功能，实时掌握每个工厂的成品、半成品和在制品数量，实现生产过程透明化。

3.25.2 基础数据设置

3.25.2.1 工厂（车间）定义

•在已有的多公司/多门店/多仓库管理（3.21）基础上，明确每个工厂（或车间）作为一个独立的生产单元，可拥有独立的仓库（原材料仓、半成品仓、成品仓）。

•每个工厂可配置负责人、联系方式、地址等。

3.25.2.2 生产工艺流程定义(注：二期实现工艺流程，一期只实现生产的物料和库存明细管理)

•工序主数据：定义所有可能的工序，如“裁剪”、“缝制”、“组装”、“测试”、“包装”等，包含工序编码、名称、描述、标准工时（分钟/件）、计件单价（可选）。

•产品工艺路线：为每个可生产的产品（成品或半成品）定义其生产所需的工序顺序、每道工序的标准工时、可替换工序、所需设备、技能要求等。

–支持一个产品有多条工艺路线（如不同工厂因设备差异采用不同路线）。

–支持版本管理，工艺路线变更后保留历史。

3.25.2.3 物料清单（BOM）

•成品BOM：定义生产一个成品所需的所有原材料、半成品及其数量。

•半成品BOM：如果半成品也是自制的，需定义其BOM。

•与工序关联：可在工艺路线中指定每道工序需要投入的物料和产出的中间品（可选）。(注：二期实现工艺流程，一期只实现生产的物料和库存明细管理)

3.25.3 生产工单管理

3.25.3.1 工单创建

•来源：可由销售订单直接生成（MTS或MTO），也可由计划员手动创建。

•工单信息：

–工单号（自动生成）

–生产产品（成品或半成品）

–计划数量

–计划开始日期、计划结束日期

–负责工厂（车间）

–工艺路线（选择该工厂适用的路线）

–状态（草稿、已下达、执行中、已完成、已取消）

–优先级

–关联的销售订单号（可选）

•物料需求计算：工单下达时，系统根据BOM自动计算所需原材料和半成品的需求量，并检查可用库存。若库存不足，可生成采购建议或预留。

3.25.3.2 工单下达与派工

•工单经审批下达后，自动生成各工序的任务（工序任务），并分配给对应工序的工作中心（可指定班组、设备）。

•支持打印派工单或通过移动端推送任务给操作员。

3.25.3.3 工单进度跟踪

•实时显示每个工序的计划数量、已完成数量、在制品数量、合格率。

•甘特图展示工单整体进度及各工序时间安排。

3.25.4 工序执行与在制品跟踪(注：二期实现报工，一期只实现生产的物料和库存明细管理)

3.25.4.1 工序报工

•操作方式：操作员通过PC端、PDA或手机扫描工单条码，进入当前工序报工界面，输入：

–本次完成合格数量

–报废数量

–实际工时

–设备编号、操作员（默认当前登录用户）

•系统自动处理：

–更新该工序的已完成数量。

–减少上一工序的在制品数量（或原材料库存）。

–增加本工序的在制品数量（若本工序未产出最终品）。

–若本工序产出可入库的半成品或成品，则增加相应库存，减少在制品。

•支持批量报工：连续扫描多个产品条码，系统自动累加数量。

3.25.4.2 工序转移

•当工序完成后，在制品需转移到下一工序的暂存区或直接投料。

•系统记录每次转移：来源工序、目标工序、转移数量、转移时间、操作人。

•若工序间有物理距离（如不同车间），可启用“在途”状态，转移途中视为在途库存。

3.25.4.3 在制品库存视图

•提供多维度的在制品查询：

–按工厂、按工序汇总在制品数量。

–按工单、按产品查询在制品明细。

–实时展示每个工序当前积压的在制品数量，帮助发现瓶颈。

•在制品数量 = 该工序累计投入数量 - 累计产出数量（合格+报废） - 已转移到下一工序的数量（若未转移则仍在本工序暂存）。

3.25.4.4 报废与返工处理

•报工时录入的报废数量，系统自动从在制品中扣除，并生成报废记录，可关联财务核算。

•返工：支持将不合格品重新投入指定工序进行返工，系统需支持返工工单或在原工单中标记返工数量。

3.25.5 半成品与成品入库

3.25.5.1 半成品入库

•若某工序产出的中间品可作为独立物料（半成品）入库，供其他工厂或后续生产使用，则支持在该工序报工后选择“半成品入库”。

•入库后，半成品进入工厂的半成品仓库，库存数量增加，同时在制品减少。

•半成品物料需在系统中预先定义（有SKU、BOM等）。

3.25.5.2 成品入库

•最后一道工序报工合格后，自动触发成品入库（或手动确认入库）。

•成品进入工厂的成品仓库，同时该工单的在制品清零，工单状态更新为“已完成”。

•支持关联销售订单发货。

3.25.6 工厂间物料调拨与在途跟踪

3.25.6.1 调拨单创建

•当工厂A需要将原材料、半成品或成品调拨给工厂B时，创建调拨单。

•调拨单信息：调出工厂、调入工厂、物料、数量、计划调拨日期、状态（草稿、已出库、在途、已入库）。

3.25.6.2 调拨出库

•调出工厂确认发货后，系统扣减调出工厂的库存，生成在途库存（增加调入工厂的在途库存字段，或创建在途库存记录）。

3.25.6.3 调拨入库

•调入工厂收到货物并扫描确认后，增加调入工厂的库存，同时减少在途库存。

•系统记录调拨完成时间，调拨单状态变更为“已完成”。

3.25.6.4 在途库存查询

•支持查询所有在途物料的数量、预计到达时间、运输方式等。

•在途库存作为库存的独立状态，不影响可用库存计算（但可配置是否参与可用库存判断）。

3.25.7 多工厂生产协同

3.25.7.1 协同工单

•当一个成品的生产需要多个工厂协作完成时（如A厂做前两道工序，B厂做后三道工序），可创建协同工单。

•协同工单下可拆分为多个子工单，每个子工单负责部分工序，分别下达给不同工厂。

•子工单间通过“工序外协”或“半成品转移”衔接：

–A厂完成前工序后，产出半成品入库，然后通过调拨单将半成品发给B厂。

–B厂接收半成品后，创建后续工序的工单（或直接使用原协同工单的后续工序），投入半成品继续生产。

•系统需跟踪半成品在工厂间的流转，确保数量准确。

3.25.7.2 外协加工

•若某工序外包给第三方工厂（非内部工厂），则创建外协工单，关联外部供应商。

•外协加工发料时，将原材料调拨给供应商（减少自有库存，增加外协在途）。

•外协加工完成后，供应商送回半成品/成品，经检验后入库，扣减外协在途，增加库存，并记录加工费。

3.25.8 生产报表与分析

3.25.8.1 在制品报表

•按工厂、按工序、按产品类别统计当前在制品数量。

•支持钻取查看具体工单、工序的在制品明细。

•图表展示各工序在制品堆积情况，辅助识别瓶颈。

3.25.8.2 生产进度报表

•各工单的完成百分比、预计完成时间、实际耗时 vs 标准工时。

•各工厂的产能利用率、产量趋势。

3.25.8.3 工厂库存报表

•每个工厂的原材料、半成品、成品库存数量、金额。

•在途库存明细（调拨中、外协中）。

3.25.8.4 生产成本核算

•根据报工工时、物料消耗、计件工资等，自动计算每个工单、每个产品的实际生产成本。

•支持与实际成本对比分析。

3.25.9 与现有模块的集成

•与库存管理（3.7.3）集成：在制品作为虚拟库存或独立库存状态管理；半成品、成品入库后进入实物库存；调拨产生在途库存。

•与订单管理（3.7）集成：销售订单可关联生产工单，实现以销定产；生产完工后自动通知发货。

•与采购管理（3.3.7）集成：外协加工视同采购服务，产生应付账款。

•与财务管理（3.9）集成：生产报工、物料消耗自动生成成本核算凭证；外协加工费生成应付凭证；在制品价值可体现在资产负债表中。

•与移动端（3.20）集成：支持移动端报工、工序扫码、调拨收货等操作。

•与AI智能运营（3.14）集成：利用历史生产数据预测产能瓶颈，优化排产。

3.25.10 非功能性要求

•性能：

–在制品查询响应时间 ≤ 3秒（百万级在制品记录）。

–报工操作响应时间 ≤ 1秒。

–支持每天处理10万次报工操作。

•数据一致性：通过数据库事务保证工序报工、库存变动、在制品更新的原子性。

•可扩展性：支持未来增加新的工序类型、自定义字段；支持对接MES系统。



4. 非功能需求

4.1 性能

•POS开单响应时间 ≤ 1秒（本地）。

•发票生成与发送 ≤ 3秒（网络正常）。

•支持并发100+用户同时操作。

•合约预警定时任务在业务低峰期执行。

•数据库查询优化：索引、分页，大数据量表按月分区。

•Webhook推送延迟 ≤ 5秒。

•数据迁移工具处理速度：百万级数据量不超过2小时。

•引流页面加载速度：首屏 ≤ 3秒。

•移动端扫码响应时间 ≤ 1秒（本地）。

•报表生成时间：复杂报表 ≤ 30秒。

•打印任务发送响应时间 ≤ 2秒（从点击打印到打印机接收）。

•蓝牙打印任务从发送到开始输出 ≤ 5秒。

•云打印任务从发送到打印机开始输出 ≤ 30秒（取决于互联网速度）。

•4.1.7 批量操作性能：

–单次批量导入Excel数据，支持至少1万行记录，处理时间不超过30秒。

–单次批量修改订单，支持至少1000个订单同时操作，响应时间不超过10秒。

–批量操作过程中不得阻塞其他用户操作。

•翻译相关性能：

–术语库查询响应时间 ≤ 1秒。

–语言包热更新生效时间 ≤ 10秒（全用户可见）。

•变量管理相关性能：

–变量数量支持至少10万条。

–用户登录时变量映射生成时间 ≤ 2秒。

–变量值修改后，缓存更新应在5秒内生效。

•DI导入处理性能：单次导入最多500个商品项，从文件上传到生成入库单的总时间 ≤ 10秒。

•生产报工响应时间 ≤ 1秒。

•在制品查询响应时间 ≤ 3秒。

•工厂库存报表生成时间 ≤ 10秒。

•重复数据检测响应时间 ≤ 1秒（从用户输入到弹出提示）。

•DIR导入处理性能：

–Excel/CSV解析时间 ≤ 5秒（1000行以内）。

–OCR处理时间 ≤ 10秒（单页PDF）。

•佣金计算性能：

–单订单佣金计算时间 ≤ 1秒。

–支持每日处理百万级订单的佣金计算（异步队列）。

•外卖平台对接性能：

–订单推送处理响应时间 ≤ 3秒（从接收Webhook到返回确认）。

–接单确认必须在平台要求的90秒内完成，系统需保证高并发下稳定处理。

–状态同步延迟 ≤ 5秒（从系统状态变更到平台可见）。

–支持每秒处理至少50个并发订单推送。

4.2 安全性

•传输加密：所有网络通信HTTPS，敏感数据加密存储。

•权限控制：RBAC模型，最小权限原则。

•审计日志：所有敏感操作记录日志，存储至少6个月。

•数据隐私：符合巴西LGPD，客户数据导出需权限，个人数据脱敏。

•备份恢复：每日自动备份数据库，保留30天。

•防查模式数据安全：策略B中本地物理删除的数据不可恢复，云端数据加密存储。

•打印安全：

–打印任务数据在传输过程中应加密（HTTPS、蓝牙加密）。

–涉及敏感信息（如客户地址、电话）的打印内容，可根据权限控制是否隐藏。

–PC共享USB打印时，代理软件需保证数据不被中间人窃取。

•4.2.6 审计日志要求：

–所有审计日志必须在线存储至少6个月，离线归档至少2年。

–提供审计日志查询界面，支持按操作人、时间范围、模块、操作类型筛选。

–支持导出审计日志为CSV/Excel格式。

•变量管理安全：

–修改变量值需权限控制，记录审计日志。

–防止普通用户修改全局或客户作用域变量。

4.3 可靠性

•离线能力：本地订单系统可无限期运行，本地数据库定期备份。

•最终一致性：订单支付→合约创建使用消息队列，失败重试。

•发票发送：自动重试3次，记录失败原因，人工介入。

•Webhook重试：推送失败重试至少3次，间隔递增。

•防查模式同步可靠性：策略B中必须收到云端成功确认后才执行本地删除。

•系统可用性：核心业务系统全年可用性 ≥ 99.9%。

•打印可靠性：

–打印任务应有重试机制：发送失败自动重试3次，失败后记录并通知用户。

–蓝牙断连后，系统应在重连后自动恢复未完成的任务。

–云打印任务状态应实时同步，若打印机离线，应提示用户。

4.4 可扩展性

•模块化：功能以插件形式开发，新模块可动态加载。

•税务引擎：支持配置化，适应未来税改。

•API优先：所有功能对外开放API。

•开放平台：支持Webhook动态注册。

•数据迁移适配器：可动态添加新的数据源适配器。

•引流渠道扩展：支持快速接入新的第三方平台。

•会计科目扩展：支持动态添加新的辅助核算维度。

•多公司/多门店扩展：新增公司或门店无需停机。

•网站模板扩展：支持上传自定义页面模板。

•打印机兼容性：系统必须采用标准打印输出格式（ESC/POS、PDF、ZPL），确保可适配不同品牌、型号的打印机，无论其连接方式如何。对新出现的打印机连接方式（如5G打印、新型无线协议），系统应能通过配置或插件快速支持，无需重构核心代码。

•4.4.8 兼容性测试要求：所有“支持XX品牌/设备”的声明，必须提供至少3个经过完整测试的型号列表，并承诺在客户遇到未测试型号时提供调试支持。

•翻译可扩展性：术语库和翻译记忆库支持动态添加新语言，无需修改代码。

•变量管理可扩展性：支持新增作用域（如门店级、角色级）而无需重构。

4.5 易用性

•界面：符合巴西本地习惯。

•快捷键：支持全键盘操作。

•语音提示：扫码、拣货时语音播报。

•界面可配置性：管理员可通过可视化界面配置角色模板。

•迁移向导：第三方数据迁移提供清晰的向导式界面。

•触摸交互设计：所有门店终端遵循移动端触摸交互规范。

•科目配置向导：提供分步式科目配置向导。

•审批流程可视化：提供审批流程图。

•页面构建器易用性：提供新手引导视频、组件说明、一键复位。

•打印易用性：

–打印机配置界面应提供分步向导，支持扫码添加（如扫描打印机二维码自动配置）。

–打印模板设计提供可视化拖拽工具，非技术人员可调整。

•翻译易用性：

–翻译管理后台提供术语库管理、翻译记忆库检索、用户反馈查看界面，操作直观。

–支持批量导入/导出术语（Excel/CSV格式）。

•变量管理易用性：

–变量管理后台提供清晰的列表、搜索、批量操作界面。

–支持按作用域筛选变量，直观展示当前生效值。

–提供变量使用情况分析，帮助管理员了解哪些变量被频繁修改。

•4.5.6 配置易用性要求：所有业务规则配置（如CFOP规则、打印路由规则）必须提供可视化配置界面，不得要求用户编写代码或修改配置文件。配置向导应提供示例和说明。

•DI导入易用性：提供分步向导，数据预览直观，错误提示明确。

•生产管理易用性：报工界面简洁，支持扫码快速录入，在制品报表可视化。

•重复数据检测易用性：警告信息明确，提供快捷查看和合并操作。

•DIR导入易用性：字段映射向导清晰，OCR结果可编辑，错误提示明确。

•佣金规则配置易用性：提供可视化规则配置器，支持规则测试和预览。



5. 数据需求

5.1 核心实体关系

•公司 (id, name, cnpj, 地址, 电话, 联系人, 逻辑删除标志…)

•门店 (id, name, 所属公司id, 地址, 店长id…)

•仓库 (id, name, 类型, 所属公司id, 所属门店id, 地址…)

•客户 (id, name, cnpj/cpf, 联系人, 地址, 等级, 销售员id, 语言偏好, 来源平台, 首次优惠码, 注册时间, 信用额度, 信用账期, 信用余额, last_sync_time…)

•供应商 (类似客户)

•运输公司 (id, name, cnpj, 联系人, 电话, 邮箱, 地址…)

•商品 (id, sku, 条码, 品名, ncm, 来源码, 价格体系json, 库存, 批次管理, 是否项目型, last_sync_version, front_remark (JSON))

•订单 (id, 订单号, 客户id, 订单类型, 来源, 来源渠道, 优惠码, 所属公司id, 所属门店id, 发货仓库id, 状态, 支付状态, 总金额, 币种, 汇率, sync_status, terminal_id, offline_id, 已开票金额, 未开票金额, 开票状态（待开票/部分开票/已全部开票）…)

•订单项 (id, 订单id, 商品id, 数量, 单价, 折扣, cfop, cst/csosn, original_price…)

•订单快照 (id, 原订单id, 快照数据json, 创建时间, 操作人…)

•发票 (id, 订单id, 发票号, 授权号, xml, 状态, 发送渠道, 发送时间, 关联业务单据类型, 关联业务单据号…)

•合约 (id, 客户id, 商品id, 订单项id, 生效日, 失效日, 状态…)

•付款记录 (id, 订单id, 支付方式, 金额, 手续费, 交易号, 币种…)

•会计科目 (id, 科目代码, 名称, 类型, 方向, 是否末级, 父科目id, 预算年度, 预算金额…)

•辅助核算项 (id, 科目id, 核算维度类型, 核算项id, 核算项名称…)

•会计凭证 (id, 凭证号, 日期, 摘要, 借项科目, 贷项科目, 金额…)

•库存变动 (id, 商品id, 变动类型, 数量, 关联单号, 批次号, 操作人, 仓库id…)

•审计日志 (id, 操作人, 操作时间, 模块, 操作类型, 旧值, 新值, IP…)

•考勤记录 (id, 员工id, 打卡时间, 类型…)

•工资表 (id, 员工id, 月份, 基本工资, 佣金, 实发…)

•shift_record (id, cashier_id, start_time, end_time, starting_cash, expected_cash, actual_cash, difference…)

•webhook_subscription (id, 商户id, 事件类型, 回调URL, 状态, 密钥)

•webhook_delivery (id, 订阅id, 事件数据, 请求结果, 重试次数)

•支票本 (id, 银行, 账号, 起始号码, 结束号码, 当前号码, 状态…)

•支票 (id, 支票本id, 支票号码, 类型, 状态, 出票人id, 收款人id, 金额, 出票日, 到期日…)

•背书记录 (id, 支票id, 背书人id, 被背书人id, 背书日期, 类型…)

•批量操作记录 (id, 操作人, 操作类型, 操作参数json, 执行时间, 是否可撤销…)

•终端状态 (id, 终端ID, 最后在线时间, 防查策略, 当前本地模式, 同步状态…)

•引流链接 (id, 活动名称, 目标URL, 短链, UTM参数, 生成时间, 点击次数…)

•优惠码 (id, 码值, 类型, 折扣, 适用范围, 来源平台, 领取次数, 使用次数…)

•引流点击日志 (id, 引流链接id, 用户IP, 设备指纹, 来源平台, 目标页, 点击时间…)

•科目变更审批 (id, 科目id, 变更前json, 变更后json, 申请人, 审批状态…)

•售后工单 (id, 工单号, 订单id, 客户id, 问题描述, 处理方式, 状态…)

•维修记录 (id, 工单id, 检测结果, 报价, 维修人员, 维修工时, 更换配件json…)

•项目 (id, 项目编号, 名称, 客户id, 项目经理id, 预算金额, 实际收入, 实际成本, 状态…)

•项目任务 (id, 项目id, 任务名称, 负责人id, 计划工时, 实际工时, 计划开始, 计划结束…)

•项目成本 (id, 项目id, 成本类型, 关联单据id, 金额, 发生时间…)

•自动化营销规则 (id, 名称, 触发条件json, 执行动作json, 状态…)

•用户标签 (id, 客户id, 标签名称, 生成规则…)

•gnre (id, uf_favorecida, receita, detalhamento_receita, valor_principal, valor_total, data_vencimento, competencia, emitente_cnpj, emitente_nome, emitente_ie, destinatario_info, doc_origem_id, tipo_doc_origem, status, xml, pdf_url…)

•网站主题 (id, 名称, 配色方案json, 字体配置json, 圆角设置, Logo图片url, 自定义css…)

•网站页面 (id, 名称, 路径, 布局json, 所属主题id, 状态, 版本号, 创建人…)

•页面组件 (id, 类型, 配置json, 所属页面id, 排序…)

•页面发布历史 (id, 页面id, 版本号, 布局json快照, 发布时间, 操作人…)

•库存状态视图（概念性，可由库存变动表聚合生成）

•故障诊断记录 (id, 故障时间, 错误类型, 日志摘要, AI分析结果, 推荐解决方案, 状态…)

•系统公告 (id, 标题, 内容, 发布人, 发布时间, 目标用户群, 置顶标志…)

•需求投票 (id, 标题, 描述, 提交人, 提交时间, 票数, 状态…)

•内部论坛帖子 (id, 标题, 内容, 作者, 圈子id, 发布时间, 回复数…)

•内部公告 (id, 标题, 内容, 发布人, 发布时间, 已读列表…)

•打印机 (id, 名称, 类型, 连接方式, IP地址/蓝牙MAC, 云账号, 所在门店id, 状态, 默认纸张类型, 默认模板id, connection_params…)

•打印任务 (id, 订单id/报表id, 打印机id, 任务状态, 发送时间, 完成时间, 重试次数, 错误信息…)

•打印模板 (id, 名称, 类型, 模板内容json, 适用纸张, 创建人…)

•术语库 (id, 源语言词条, 目标语言, 译文, 领域, 状态, 版本…)

•翻译记忆库 (id, 源句, 目标句, 上下文, 使用次数…)

•翻译反馈 (id, 用户id, 界面路径, 反馈内容, 截图url, 处理状态…)

•变量定义 (id, var_id, description, default_value, group_id, var_type, created_at, updated_at)

•变量值 (id, var_id, scope_type, scope_id, language, value, created_at, updated_at)

•进口报关单记录（可新增实体或作为采购入库单的扩展）

–表名：import_declaration

–字段：id, di_number, registration_date, clearance_date, importer_cnpj, exporter_info, total_cif_foreign, total_cif_brl, exchange_rate, exchange_rate_date, file_name, file_hash, status, created_at, created_by

•进口商品项（可关联采购入库单明细）

–表名：import_item

–字段：id, declaration_id, item_sequence, ncm, description, quantity, unit, cif_foreign, cif_brl, ii_amount, ipi_amount, pis_import_amount, cofins_import_amount, icms_import_amount, other_costs, unit_cost_brl, product_id (匹配后)

•工厂 (id, name, type, company_id, address, contact…)

•工序 (id, code, name, description, standard_time, unit…)

•工艺路线 (id, product_id, version, status, created_by…)

•工艺路线明细 (id, route_id, sequence,工序_id, next_工序_id, work_center…)

•BOM (id, product_id, component_id, quantity, effective_date…)

•生产工单 (id, order_no, product_id, planned_qty, start_date, end_date, factory_id, route_id, status, priority, sales_order_id…)

•工序任务 (id, work_order_id, 工序_id, sequence, planned_qty, completed_qty, scrap_qty, status, start_time, end_time…)

•报工记录 (id, task_id, operator_id, 工序_id, completed_qty, scrap_qty, actual_time, report_time…)

•在制品库存（可实时计算，也可设计物化视图）

–维度：工厂_id, 工序_id, 产品_id（若跨工序产品不变，可省略产品；若工序产出不同半成品，则需区分）

–数量：当前在制品数量

•调拨单 (id, from_factory_id, to_factory_id, status, planned_date…)

•调拨明细 (id, transfer_id, product_id, quantity, status, outbound_time, inbound_time…)

•外协工单 (id, work_order_id, supplier_id,工序_id, status…)

•佣金规则：

–表名：commission_rule

–字段：id, name, description, apply_to (product/category/customer_level), conditions_json, base_type (sale_amount/gross_profit/fixed), calculation_type (percentage/fixed/阶梯), calculation_params_json, cap_amount, floor_amount, priority, effective_start, effective_end, status, created_at, updated_at

•佣金规则分配：

–表名：commission_rule_assignment

–字段：id, rule_id, entity_type (product/category/salesperson), entity_id, created_at

•佣金明细：

–表名：commission_detail

–字段：id, order_id, order_item_id, salesperson_id, rule_id, base_amount, commission_amount, status (待确认/已确认/已结算/已冲销), settled_at, created_at

•佣金结算单：

–表名：commission_settlement

–字段：id, salesperson_id, period_start, period_end, total_commission, status (待结算/已结算), settled_at, payment_method, remarks

•DIR导入记录：

–表名：dir_import_record

–字段：id, file_name, file_type, import_time, status, total_items, success_items, error_message

•预进口单：

–表名：pre_import_order

–字段：id, dir_import_id, invoice_number, supplier_id, total_amount, currency, exchange_rate, status (待申报/已转换/已作废), created_at, converted_to_di_id

•外卖平台配置 (delivery_platform_config)：id, platform_type (iFood/Rappi/Uber), store_id, api_key, api_secret, webhook_url, status, sync_menu, sync_inventory, commission_rate, created_at

•外卖订单扩展 (delivery_order_ext)：id, order_id, platform_order_id, platform_type, pickup_code (取餐码), estimated_pickup_time, delivery_mode (平台配送/商家自配), delivery_status, tracking_url, platform_commission, delivery_fee, customer_tip, platform_status (原始状态)

•取餐核销记录 (pickup_verification)：id, order_id, pickup_code, verified_by, verified_at, device_id

•平台对账记录 (platform_reconciliation)：id, platform_type, store_id, settlement_date, total_orders, total_amount, platform_fee, net_amount, status, matched, difference

5.2 规则表

•cfop_rules (cfop_code, description, operation_type, condition_json)

•cst_rules (cst_code, description, tax_regime, condition_json)

•csosn_rules (csosn_code, description, condition_json)

•alert_rules (id, type, trigger_days, channels, template)

•price_policies (id, name, rules_json)

•dynamic_pricing_rules (id, 商品范围, 条件, 调价策略, 生效时间)

•promotion_rules (id, 名称, 类型, 配置json, 优先级)

•引流话术规则 (id, 平台, 关键词, 话术模板, 链接, 启用状态)

•审批流程定义 (id, 流程名称, 适用业务类型, 节点定义json, 版本号…)

•gnre_rules (id, uf, receita, aliquota, regras_calculo_json, ativo…)

•故障知识库规则：存储历史故障及解决方案，供AI检索匹配。

•打印路由规则 (id, 条件（订单类型、金额、门店）, 目标打印机id, 优先级…)

•翻译术语强制规则 (id, 源词, 强制译文, 适用模块…)

•进口税费计算规则：可配置哪些税费计入成本，哪些作为可抵扣进项。

•工序报废率规则：可配置各工序标准报废率，用于成本预估。

•成本分摊规则：制造费用如何分摊到产品。



6. 套餐组合

套餐 包含模块

套餐1 极速打印 + 客人对账

套餐2 极速打印 + 订单管理 + 库存记录

套餐3 极速打印 + NFe

套餐4 极速打印 + NFCe

套餐5 极速打印 + 订单管理/库存 + 电商平台集成 + AI智能客服

套餐6 极速打印 + 订单管理/库存 + 私域商城（含基础网站模板） + AI智能客服

套餐7 极速打印 + 订单管理/库存 + 业务财务(FMS)（含分批开票、基础科目自定义、选择性开票与发票列表分离）

套餐8 基础版 + 第三方平台引流模块（含客服话术、包裹卡片、优惠码、基础追踪）

套餐9 专业财务版（含多维度辅助核算、预算管理、多版本科目、外币重估、科目级权限、分批开票、选择性开票、佣金规则引擎）

套餐10 连锁企业版（含多公司/多门店/多仓库管理、移动端PDA、信用管理、售后维修、进口成本核算、DIR导入）

套餐11 项目管理版（含项目型业务、任务分解、项目成本核算）

套餐12 营销自动化版（含自动化工作流、用户分群、RFM分析）

套餐13 税务专家版（含NFe/NFCe、GNRE、税务规则细化、税务报表、进口成本核算、DIR导入）

套餐14 私域商城增强版（含套餐6 + 可视化页面构建器、主题自定义、多页管理）

套餐15 生产制造版（含分布式生产管理、工序跟踪、在制品报表、工厂调拨）

套餐16 外卖平台集成版（含与iFood、Rappi、Uber Eats等平台的订单接入、状态同步、厨房显示、配送跟踪、财务对账）

套餐17 全渠道全能版（含以上所有功能）

可选增值模块：

•数字人直播

•高级报表（含AI预测）

•考勤与工资管理

•智能采购预测

•动态定价

•开放平台接入

•支票管理

•防查模式（混合策略）

•高级引流模块（含Link-in-bio、全链路归因、跨域识别）

•高级财务模块（含多维度辅助核算、预算预警、多版本科目、外币重估、科目级权限、科目变更审批）

•移动端仓库管理（PDA）

•移动端销售助手

•移动端审批

•国际支付网关

•多级审批工作流

•GNRE模块

•网站高级自定义（含自定义代码注入、自定义字体上传、页面模板保存）

•高级翻译管理模块（含术语库管理、翻译记忆库、用户反馈闭环、多语言审校工作流）

•变量管理模块（含变量定义、多级作用域配置、导入导出、用户自定义界面）

•进口成本核算模块（含DI/DIR导入、税费计算、采购入库单生成）

•生产制造模块（含分布式生产管理、工序跟踪、在制品报表、工厂调拨）

•客户自助开票申请（私域商城增值模块）

•佣金规则引擎（单独订阅）

•外卖平台对接（单独订阅，含iFood、Rappi、Uber Eats等）

备注：所有套餐均包含基础打印功能，支持蓝牙、Wi-Fi网络、PC共享USB、云打印四种连接方式。具体打印机兼容性取决于硬件设备。所有套餐均包含基础多语言支持，高级翻译管理模块和变量管理模块为可选增值模块。重复数据检测功能作为基础模块包含在所有套餐中。



7. 附录

7.1 术语表

（已包含在1.4节）

7.2 业务规则清单（补充）

规则ID 规则内容 模块

R034 跨州NFe开具时，若需缴纳GNRE，必须先生成GNRE才能打印发票 GNRE

R035 GNRE发送失败自动重试3次，超过则进入人工处理队列 GNRE

R036 已生成的GNRE在未发送前可修改，发送后不可修改 GNRE

R037 GNRE作废需符合各州规定的时间窗口（通常与NFe作废窗口一致） GNRE

R038 网站页面发布前必须经过预览确认，发布后自动生成历史版本，支持回滚。 私域商城

R039 自定义主题修改后需保存为草稿，预览确认后方可发布，发布后实时生效。 私域商城

R040 当可用库存低于安全库存时，系统自动触发预警，并生成采购建议 库存管理

R041 AI运维助手每日凌晨分析前一日日志，生成健康报告，异常时自动告警 系统监控

R042 软件公司发布的紧急故障通知，需在所有登录用户界面弹窗提示，直至手动确认 用户互动平台

R043 打印任务发送失败后，系统自动重试3次，若仍失败则记录并通知打印机管理员。 打印模块

R044 手机端打印时，必须优先使用已配置的默认打印机，若打印机离线则提示用户选择其他可用打印机。 打印模块

R045 PC共享USB打印的代理服务必须支持开机自启动，且不得要求用户每次手动开启。 打印模块

R046 术语库中的强制术语必须在所有界面翻译中生效，任何绕过术语库的翻译均视为缺陷。 翻译管理

R047 用户提交的翻译反馈必须在24小时内标记处理状态，48小时内完成初步修正。 翻译管理

R048 变量值加载顺序：用户作用域 > 客户作用域 > 全局作用域 > 变量默认值。 变量管理

R049 修改变量值必须记录审计日志，包括修改前和修改后的值。 变量管理

R050 分批开票金额不得超过关联业务单据的商品/服务总金额。 发票生成

R051 无关联业务单据的订单不得进行分批开票。 发票生成

R052 分批开票后，订单未开票金额相应减少，开票状态自动更新。 发票生成

R053 DI导入时，若文件数字签名验证失败，系统拒绝导入并提示原因。 进口成本核算

R054 同一DI号不可重复导入，重复时系统提示“该报关单已导入”。 进口成本核算

R055 进口成本计算中，II金额必须全额计入商品成本。 进口成本核算

R056 若商品匹配失败，用户可选择创建新商品或挂起，挂起商品不影响其他商品入库。 进口成本核算

R057 工单下达时，若所需原材料库存不足，可配置是否允许超发或生成采购建议。 生产管理

R058 工序报工录入的报废数量不得超过该工序累计投入数量的剩余可报废量。 生产管理

R059 在制品库存 = 各工序累计投入 - 累计产出 - 累计转移至下工序（已接收）。 生产管理

R060 工厂间调拨在途物料不计入调入工厂的可用库存，但需在报表中单独显示。 生产管理

R061 客户/供应商/运输公司创建时，若CNPJ已存在，系统必须阻止保存并提示。 主数据管理

R062 模糊匹配的相似度阈值可由管理员在后台配置，默认85%。 主数据管理

R063 重复记录合并操作需记录审计日志，合并后原记录逻辑删除。 主数据管理

R064 前台备注仅对已登录会员显示，未登录用户不可见。 私域商城

R065 前台备注支持多语言，展示时根据会员语言偏好匹配。若无对应语言，则显示默认语言（如葡语）或留空。 产品管理

R066 DIR导入时，若发票号已存在，系统应提示重复并允许覆盖或跳过。 进口成本核算

R067 佣金计算时，若订单发生退款，已计算的佣金应自动冲销或按规则扣回。 佣金规则引擎

R068 佣金规则支持按优先级排序，高优先级规则优先计算。 佣金规则引擎

R069 外卖订单必须在收到推送后90秒内确认接单，超时未确认则自动拒绝或按平台规则处理。 外卖平台对接

R070 外卖订单接单前必须校验库存，库存不足时自动拒绝。 外卖平台对接

R071 自取订单的取餐码需在订单确认后30分钟内生成，并通过短信/App推送顾客。 外卖平台对接

R072 平台对账差异超过阈值（如1%）时，需自动标记并通知财务人员处理。 外卖平台对接

7.3 2026年税改应对

•时间表：

–2025年9月-10月：新CST在测试环境可用。

–2025年10月-12月：生产环境可用，但非强制。

–2026年1月1日：全面强制生效。

•应对措施：

–系统需预留新CST字段（CBS、IBS、IS）。

–税务引擎支持配置新税率计算规则。

–旧发票与新发票并行期需兼容。

–科目多版本功能确保新旧税制科目平滑过渡，历史凭证按当时版本展示。

7.4 验收标准示例（补充）

功能 验收标准

GNRE自动触发生成 开具一张跨州NFe（如SP→RJ），系统自动生成GNRE草稿，数据正确映射

GNRE手动生成 在GNRE管理界面手动创建一张GNRE，填写必要信息后成功生成XML

GNRE批量生成 选择多笔跨州交易，合并生成一个GNRE批次，发送后各州SEFAZ返回正确授权

GNRE发送与查询 GNRE发送成功后，状态更新为“已授权”；通过查询接口可获取最新状态

GNRE PDF打印 已授权的GNRE可导出PDF格式缴款单，包含所有必填字段和二维码

GNRE缴款确认 手动标记GNRE为“已缴款”后，财务模块自动生成付款凭证

GNRE逾期提醒 配置提前3天提醒，系统在GNRE到期前3天自动发送邮件通知

网站主题切换 商户在后台选择“节日红”主题，网站首页主色立即变为红色，按钮样式同步更新

页面拖拽设计 在页面构建器中，将“商品列表”组件拖至轮播图下方，保存后首页对应位置显示商品列表

移动端独立布局 在移动端视图中隐藏首页的第三个模块，发布后在手机上访问该模块不显示，PC端仍显示

自定义代码注入 在头部注入Google Analytics代码，访问网站时统计代码正常加载

多库存状态 创建采购订单后，在途库存增加；下单预扣后，锁定库存增加；出库后，可用库存减少

AI故障诊断 模拟一个数据库连接失败，AI运维助手自动生成诊断报告，包含可能原因和重启建议

软件公司公告 软件公司发布维护公告，所有在线用户收到弹窗通知

内部论坛 员工在内部论坛发帖，同部门同事可回复

智能客服 在1000条常见问题测试集中，准确识别用户意图并给出正确答案的比例 ≥ 85%

智能采购预测 连续测试3个月，预测补货量与实际销量的误差 ≤ 20%

动态定价 在测试环境中运行1个月，对比未调价商品，毛利率提升 ≥ 3%

智能防损预警 在历史数据中识别异常行为的准确率 ≥ 80%，误报率 ≤ 10%

销售员智能助手 推荐的交叉销售产品被客户接受的转化率提升 ≥ 5%

蓝牙打印 手机在距离蓝牙打印机15米处，成功打印一张NFCe小票，打印内容完整、格式正确。

Wi-Fi网络打印 手机连接店内Wi-Fi，在仓库区域选择前台Wi-Fi打印机，成功打印拣货单。

PC共享USB打印 在一台普通PC上连接USB打印机并开启共享，手机通过同一局域网成功打印订单，期间PC正常办公不受影响。

云打印 手机通过4G网络，将订单发送至已配置的云打印机，打印机成功输出。

多手机并发打印 5台手机同时向同一台Wi-Fi打印机发送不同订单，所有任务按顺序正确打印，无丢失或混乱。

断网应急打印 手机断网时，通过蓝牙打印机仍可打印本地已保存的订单小票。

术语库强制生效 在术语库中定义“订单”的葡语为“Pedido”，系统中所有出现“订单”的地方（包括POS、OMS、报表）均显示“Pedido”，无任何“Ordem”或“Comando”等错误翻译。

用户翻译反馈闭环 用户通过“报告翻译问题”提交反馈后，管理员在后台收到通知，修正后用户端翻译实时更新，反馈状态变更为“已处理”。

变量多级覆盖 设置全局变量 button.save 默认=“Save”；客户A的葡语覆盖=“Salvar”；用户B的葡语覆盖=“Gravar”。用户B（属于客户A，语言葡语）登录后，看到该按钮显示”Gravar”。

变量导入导出 管理员导出所有变量为Excel，修改其中一条后导入，系统更新对应变量值，界面立即生效。

用户自定义变量 用户在个人设置中修改 menu.dashboard 为自己偏好的名称，保存后其菜单立即更新，且不影响其他用户。

分批开票 - 分批发货 订单A含商品X（1000元）、Y（2000元），先发X，生成发货单。财务在订单中点击“分批开票”，关联该发货单，系统建议开票1000元，确认后生成一张1000元NFe。订单未开票金额更新为2000元。

分批开票 - 按服务进度 服务合同订单B总金额5000元，完成30%时项目经理上传服务确认单，财务关联该单据并输入30%（1500元），系统生成1500元NFe，服务剩余金额3500元。

分批开票 - 禁止无依据 订单C未关联任何发货单/服务单，财务尝试分批开票，系统提示“请先创建业务单据”，操作被阻止。

DI XML导入 上传一份标准DI XML文件，系统正确解析出报关单号、商品项、税费明细，并预览数据。

商品自动匹配 系统中已存在NCM为“84713000”的商品，DI中某商品项NCM相同，系统自动匹配成功。

进口成本计算 DI中CIF总值为1000 USD，汇率5.0，II税率10%，系统计算II为500 BRL，商品单位成本正确。

生成采购入库单 在成本预览界面点击“生成入库单”，系统创建状态为“待审核”的采购入库单，库存成本更新。

重复导入校验 再次导入同一DI文件，系统提示“该报关单已导入，不允许重复操作”。

工艺路线定义 为产品A定义5道工序，分别设置标准工时，保存后可在工单中选择。

工单下达与派工 创建工单产品A数量100，下达后自动生成5个工序任务，状态为“待执行”。

工序报工 操作员扫描工单条码，在第一道工序报工完成30件，系统显示该工序完成30，在制品30。

多工序流转 第二道工序报工时，系统自动扣除上一工序在制品，本工序在制品增加。

半成品入库 第三道工序产出半成品，报工时勾选“半成品入库”，系统增加半成品库存，扣减在制品。

工厂间调拨 将半成品X从A厂调拨10件到B厂，A厂出库后在途库存增加，B厂入库后库存增加，在途减少。

在制品报表 查看A厂在制品报表，显示各工序在制品数量，并与实际盘点一致。

多工厂协同 创建协同工单，A厂完成前2道工序后产出半成品，调拨给B厂，B厂完成后3道工序产出成品，全过程数量准确。

订单列表与发票列表分离 登录财务账号，左侧菜单有“订单管理”和“发票管理”，点击后分别显示对应列表。

选择性生成发票 在订单列表勾选2个同一客户的订单，点击“生成发票”，选择“合并开票”，成功生成一张包含两个订单商品行的NFe。

权限控制 - 仅看已开票 设置收银员角色权限为“仅查看已开票订单”，登录收银员账号，订单列表只显示已开票订单，无未开票订单痕迹。

客户申请开票 客户在前端提交开票申请（填写CNPJ），财务后台收到申请，点击处理后生成发票，客户邮箱收到PDF。

手动发送发票 发票生成后状态为“待发送”，财务勾选该发票点击“发送”，系统调用税务API成功，状态更新为“已发送”。

精确匹配阻止 创建一个CNPJ为“12.345.678/0001-99”的客户，再次用同一CNPJ创建新客户，系统提示“CNPJ已存在”，无法保存。

模糊匹配提醒 创建客户名称为“ABC Comércio Ltda”，系统中已存在“ABC Comercio LTDA”（相似度95%），系统弹窗提示“可能存在重复，请核对”。

合并功能 在重复列表中勾选两条疑似重复客户，点击“合并”，选择主记录，系统将副记录的交易历史合并到主记录，副记录逻辑删除。

批量导入重复检测 导入Excel包含10条客户记录，其中2条CNPJ重复，预览阶段系统标记重复行，生成报告，用户可选择跳过或覆盖。

前台备注显示 在后台为某商品添加葡语备注“Contato: 11 99999-8888”，英语备注“Contact: +55 11 99999-8888”。登录葡语会员进入商城商品详情页，看到备注显示为葡语内容；登录英语会员看到英语内容。未登录用户不显示任何备注。

POS端备注显示 在POS开单界面添加该商品，收银员在商品列表中可看到备注图标，点击后显示备注内容。

移动端备注显示 销售员在手机端开单时，选择该商品，界面显示备注内容。

DIR Excel导入 上传一份包含10行商品的Excel商业发票，正确映射字段后生成预进口单，商品明细与文件一致。

DIR PDF OCR导入 上传一份PDF格式的商业发票，OCR识别后提取出发票号、总金额、商品列表（至少80%准确率），人工修正后可生成预进口单。

DIR转DI 从预进口单点击“转换为DI草稿”，系统将数据填充至DI生成界面，商品信息完整。

佣金规则-比例计算 配置规则：订单销售额的5%作为佣金。创建一笔1000元订单，佣金明细中自动生成50元。

佣金规则-阶梯计算 配置阶梯规则：0-1000元佣金5%，1000-2000元佣金8%。创建一笔1500元订单，佣金应为10005% + 5008% = 50+40=90元。

佣金规则-多角色分账 配置规则：销售员70%，上级20%，平台10%。订单佣金总额100元，系统自动生成三条佣金记录：销售员70元、上级20元、平台10元。

佣金结算与支付 财务审核通过一批佣金记录，生成结算单，标记为“已结算”后，应付账款中自动增加对应金额。

外卖订单自动接入 在iFood平台创建一个测试订单，系统在5秒内收到Webhook并生成内部订单，订单信息完整无误。

接单确认 系统在收到订单后自动校验库存，并在60秒内通过API向iFood返回接单确认，平台显示订单状态为“商家已确认”。

库存预占 确认接单后，对应商品可用库存减少，锁定库存增加，数量准确。

厨房小票打印 订单自动路由至指定门店的蓝牙打印机，小票内容包含顾客姓名、商品明细、取餐码等，打印格式符合模板。

制作状态同步 后厨在KDS点击“制作完成”，系统同步至iFood，平台状态更新为“待取餐”。

取餐码核销 顾客到店出示取餐码（二维码），店员用手机扫描后成功核销，订单状态更新为“已完成”。

配送状态跟踪 骑手取餐后，系统通过Uber Eats API获取配送状态，在订单详情中实时显示“配送中”及骑手位置。

平台佣金计算 配置iFood佣金比例15%，订单金额100 BRL，系统自动计算佣金15 BRL，并计入财务应付科目。

对账自动匹配 每日定时拉取iFood结算文件，与系统内订单逐笔匹配，对账报告显示匹配成功和差异记录。

库存同步 在系统后台将某商品库存设为0，iFood平台该商品自动下架，无法下单。



收到支票时即减少应收账款，转入应收票据过渡；兑现后再转入银行存款。 这样既符合会计准则，又能在退票时保留完整追溯能力，同时确保客户对账单反映真实的未结款项。系统已通过自动化凭证和状态管理完整支持这一流程。