智能售货机软件系统方案前期需要准备哪些资料？

做方案时，最容易出现的误会是把智能售货机理解成“屏幕加支付”。屏幕只是顾客看得见的部分。一次交易背后，设备主控要接收指令，货道要执行出货，传感器要回报结果，支付平台要通知收款，库存和订单还得同步变化。任何一处没有约定清楚，都会留下待确认项。

从红数科技接收软件需求的角度看，前期资料不用先写成几十页需求文档。把下面这些内容准备到能回答、能提供样例、能找到负责人确认，方案就能做得比较实。

先把生意怎么做说清楚

先确认谁在经营机器、机器放在哪里、卖什么、钱怎么结。直营、加盟、联营和场地方分成，看上去只是商务模式不同，落到软件里会改变账号层级、设备归属、商品定价、库存责任和账单口径。

建议先整理一页项目底稿，写清这些信息：

• 经营主体名称，以及营业执照上的主体信息；
• 计划投放的城市、场景和首批设备数量，例如工厂、学校、医院、商场或社区；
• 直营网点还是多级代理，设备是否会在不同运营商之间划转；
• 销售的是常温预包装食品、冷藏食品、现制饮品，还是日用品、文创、药械等其他商品；
• 顾客直接在机器屏幕购买，还是还要接入小程序、会员系统或企业内部福利账户；
• 项目计划什么时候试点、什么时候正式投放，首期必须上线哪些能力。

这里不急着把几年后的功能都塞进第一期。先划出首批设备真实会用到的范围，后面的报价、排期和验收才有共同依据。

设备资料往往比页面原型更要紧

软件能不能控制机器，取决于设备端愿意提供什么。前期至少要有一台可联调的样机，以及设备厂商能够确认的接口资料。只有机器照片和尺寸图，无法判断出货控制、状态采集和远程运维能做到哪一步。

比较完整的设备资料通常包括：

• 整机型号、主控板型号、工控机或安卓板配置、操作系统版本；
• 触摸屏分辨率、横竖屏方向，以及页面是否需要适配不同尺寸；
• 货道类型、货道编号规则、最大货道数，弹簧、履带、格口或机械臂分别怎样执行出货；
• 控制板通信协议和接口文档，实际采用串口、RS-485、MDB、TCP/IP、HTTP、MQTT或厂商私有协议中的哪一种；
• 出货成功怎样判定，是否有掉货检测、柜门检测、温度传感、升降台到位、卡货反馈等信号；
• 制冷、加热、照明、除雾和屏幕等部件是否允许远程控制；
• 设备编号、主板序列号、SIM卡或物联网卡信息怎样对应；
• 断网后能否继续交易，缓存多少条指令，重新联网后怎样补传订单和状态；
• 固件升级、应用更新、日志导出、远程重启的现有方式；
• 协议联系人、样机负责人和出现硬件异常时的判定边界。

有些设备厂商给的协议只有命令字，没有异常码说明。这样的文档还不够。开发方需要知道指令发出后多久算超时、设备可能返回哪些状态、同一指令能不能重发。否则网络一抖，系统可能不知道货到底出了没有，退款也就失去了依据。

商品资料不能只给名称和价格

商品表当然要有商品名称、分类、图片、规格、售价和条码，但真正影响系统的是商品怎样上架、怎样占用库存、什么时候不能卖。

如果一台机器的不同货道可以放同一种商品，需要确认库存按设备、货道还是商品汇总。临期商品是否提前下架，冷藏商品温度超限后是暂停销售还是只告警，也要定下来。涉及批次、保质期和追溯时，补货人员上货时要录入什么，后台又保留到什么粒度，都应在方案阶段说明。

最好同时给一份真实商品样表和一张实际货道图。哪怕只有十来个商品，也比一份空白字段模板有用。开发人员可以据此验证长名称怎么显示、多规格怎么区分、图片比例是否合适、一个商品分布在多个货道时如何选择出货。

促销规则也要用具体例子表达。比如“第二件半价”需要说明能否混搭、优惠由谁承担、退款时怎样退；会员价要说明身份从哪里来、机器断网时还能不能用。只写“支持优惠活动”，系统范围会一直悬着。

把顾客的一次购买走完

把顾客站到机器前之后的动作按顺序走一遍，很多遗漏会自己冒出来。选商品前是否必须登录，微信和支付宝是否都能付，支付后机器多久出货，卡货、空货道、关门未到位分别提示什么，退款原路退还是进入人工审核，这些都属于交易主流程，不是上线后的运营细节。

建议准备三类流程：正常购买、可预见的异常、人工介入。异常至少覆盖支付成功但未出货、重复支付通知、设备离线、出货超时、部分出货、顾客取消、库存与实物不一致。人工介入则要写清运营人员在哪里看到问题，能做补发、退款还是只登记，动作完成后订单状态怎样变化。

如果还要做小程序或会员体系，需补充登录方式、手机号是否必需、优惠券来源、积分规则、发票申请、订单查询和注销入口。没有必要为了一个匿名购买场景强制收集手机号。需要收集时，也应先说明用途、保存期限和删除方式，再决定页面怎么设计。

支付和对账，先确认账户再谈接口

支付接入前要确定实际收款主体。是经营公司自己的微信支付、支付宝商户号，还是由平台服务商进件；加盟商各自收款，还是平台统一收款后再结算；场地方分成依据支付流水、完成订单还是扣除退款后的净额。不同答案对应的支付产品、接口权限和账务设计并不相同。

需要提前准备的通常有商户主体资料、已开通的支付产品、商户号或应用信息、技术对接文档、测试环境、回调地址要求和证书管理责任。正式密钥不要放进需求文档或聊天记录，应在约定的安全方式下配置。

对账样例也很重要。给出一份希望看到的日账单，写清订单号、设备、点位、商品、实付、优惠、退款、手续费和分成字段。财务按什么日期关账，跨日退款记在哪一天，差异由谁核对，都比“后台要有财务报表”更容易落地。

后台要按谁在使用来准备

智能售货机后台往往同时给总部、区域运营、加盟商、补货员、客服和财务使用。他们看到的数据不能完全一样，能做的动作也不同。前期先提供组织关系、角色名单和数据范围，页面原型才不会只围绕一个超级管理员来画。

可以用“谁、能看什么、能改什么、操作是否复核”四列做一张权限表。改价、批量开门、远程出货、退款、导出顾客信息这类高风险动作，是否需要二次确认或审批，也在表里标出来。

报表不要只列名称。日报、设备销售排行、缺货统计、商品动销、补货记录、温度曲线和故障告警，各给一张现有表格或手画样例，注明统计口径。比如销售额是否包含未出货订单、退款算在原交易日还是退款日，这些口径一旦进入系统，后期再统一会牵动历史数据。

现有系统和数据边界也要交底

企业已经有ERP、WMS、CRM、会员、财务或工单系统时，要列出由哪套系统维护商品、价格、库存和客户资料。每项数据只确定一个主要来源，避免两边都能改、最后互相覆盖。

提供给开发方的资料包括接口文档、字段说明、调用频率限制、测试账号、测试数据、签名方式、IP白名单要求和对接负责人。暂时没有接口的，也要明确首期采用人工导入、定时文件还是暂不打通，不能用一句“后面再对接”代替范围决定。

数据方面，要提前回答系统收集哪些顾客信息、设备定位精确到什么程度、日志和订单保留多久、谁能导出、是否交给云服务商或其他合作方处理、到期怎样删除。现行《网络数据安全管理条例》要求网络数据处理者采取加密、备份、访问控制、安全认证等措施；向其他处理者提供或委托处理个人信息、重要数据时，还应通过合同约定处理目的、方式、范围和安全义务。软件方案里至少要给这些责任留出明确位置，而不是等隐私政策上线时再补。

服务器部署在公有云、客户机房还是专有云，也会影响网络、域名、备案、证书、备份和运维方案。客户有等保、国产化、专线或日志审计要求的，应在选技术架构前提出。是否需要开展网络安全等级保护定级、备案和测评，要结合系统实际用途、数据和主管要求判断，不能把“做等保”当成所有项目完全一样的一项勾选。

卖食品的机器，还要准备经营合规材料

如果机器销售食品，经营资料和软件资料不能分开看。根据现行《食品经营许可和备案管理办法》，仅销售预包装食品的，应依法办理备案；开展其他需要许可的食品经营项目，则应取得相应食品经营许可。利用自动设备经营时，申请材料还涉及每台设备的具体放置地点、证照或备案编号的展示方法、食品安全风险管控方案等内容。

因此，项目前期至少要准备经营主体、经营项目、证照或备案情况、设备点位清单、证照在屏幕或机身上的展示方案，以及温控、清洁、补货、临期下架、问题商品召回和异常处置规则。设备显著位置还应按规定展示经营者联系方式、食品经营许可证复印件或电子证书、备案编号。跨省投放、设备放置地点或数量变化时，还有相应报告要求。

各地可以制定具体实施办法，现制饮品、散装食品、特殊食品等场景的要求也不一样。正式投放前，应按实际经营项目向设备放置地市场监管部门核实，软件页面和后台字段以核实后的材料为准。

最后准备验收口径，不然“能用”很难判断

验收资料不必等开发结束再写。方案阶段就可以把关键场景列出来：支付成功后设备在规定时间内收到出货指令；出货传感器未确认成功时订单进入异常处理；断网恢复后订单不重复出货；退款状态能与支付平台保持一致；不同角色看不到越权设备和数据。

每个场景写清前置条件、操作步骤、预期结果和需要留下的记录。性能指标也尽量带上场景，例如同时在线设备数、订单高峰量、后台报表允许等待多久、告警最晚多久送达。没有依据的数字不要硬填，可以先用首批投放量和扩容计划估算，再由双方确认。

交给软件服务方之前，可以按这张表核一遍：

资料有缺口并不可怕。真正影响项目的是缺口没人负责、决定没有期限、口头确认没有落到文档。把每个待定项后面写上确认人和确认时间，方案就能继续往前走；等到设备、支付和业务三边都开工后再补，改动通常会落到接口、订单状态和数据库这些不容易动的地方。

资料依据

• 《食品经营许可和备案管理办法》（国家市场监督管理总局令第78号），自2023年12月1日起施行。
• 《网络数据安全管理条例》（国务院令第790号），自2025年1月1日起施行。
• 全国人大常委会关于修改《中华人民共和国网络安全法》的决定，相关修改自2026年1月1日起施行。
• 《中华人民共和国个人信息保护法》，全国人民代表大会官网公开文本。