门店与线下销售
您可以把门店中的购买与线上数据一起发送到 OneTrace.pro。收银小票会出现在顾客的档案中,紧挨着其网站访问、商品浏览和邮件。由此得到 ROPO 报表:此前在线上了解过商品的顾客,在门店完成了多少销售。分群和旅程也可以使用门店购买数据。
该板块位于数据 → 门店。拥有商品查看权限的角色可以查看,拥有商品修改权限的角色可以修改规则和门店列表。

如何识别门店购买
门店小票与网站订单是同一种购买事件,例如带有金额和商品的 order_completed。为了让 OneTrace.pro 区分小票和线上订单,小票带有单独的属性。规则在如何识别门店购买板块中设置:
- 购买事件属性(默认):小票以购买事件发送,带有
channel属性,值为offline。属性和值都可以修改。购买事件取自预测设置。 - 单独事件:如果小票已经以自己的事件发送,例如
store_purchase,请选择该事件。 - 门店 ID 属性(默认
store_id)把小票与门店列表中的网点关联起来。
规则对所有功能立即生效:ROPO 报表、分群条件、旅程触发器以及小票文件上传。
如何发送小票
小票的顾客按电话、邮箱或会员卡号识别。如果还没有对应的档案,会创建新档案。当顾客在网站上留下相同的电话或邮箱时,档案会合并,其线上历史就会与门店购买连接起来,参见档案合并。没有电话、邮箱和会员卡的小票无法与线上历史关联,因此对报表没有用处。
共有四种方式:
| 方式 | 适用场景 |
|---|---|
| 1C 扩展 | 来自 1C:Retail、1C:Small Business Management 或 1C:Trade Management 的小票,每 15 分钟自动发送 |
| API | 能够发送请求的自有收银系统或财务系统 |
| 使用线下小票模板的数据源 | 系统每晚以文件形式提供的小票导出,参见数据源 |
| 上传文件 | 一次性上传过去的小票,例如在接入收银系统之前先查看报表 |
无论选择哪种方式,在一天内重复发送同一张小票都不会产生重复记录。
1C 扩展
适用于 1C:Retail 2.3 和 3.0、1C:Small Business Management (UNF) 1.6 和 3.0、1C:Trade Management 11 的配置扩展,平台为 1C:Enterprise 8.3.21 及更高版本。配置本身不会被修改:所有内容都在扩展中。
- 每 15 分钟发送新过账的 Чек ККМ(收银小票):日期、编号、门店、金额和商品。顾客信息为小票上的电话、邮箱和会员卡。
- 每天发送一次门店列表。
- 没有顾客信息的小票会被跳过,并连同原因写入注册日志。其余小票正常发送。
- 如果 OneTrace.pro 不可用或密钥有误,小票不会丢失:它们会在下次运行时发送。
如果上传小票文件区块中有1C 扩展链接,可通过它获取扩展以及安装和设置说明。扩展需要具有“上传和删除商品”权限的私密 API 密钥:门店列表需要此权限。在扩展的设置处理程序中填写 OneTrace.pro 的地址和密钥,检查连接并保存设置。
小票中的商品通过品名的货号、代码或唯一标识符发送,请在设置中选择与目录中商品 ID 一致的一项。否则 ROPO 报表无法找到顾客在网站上浏览过的商品。
API
使用私密密钥通过 track 事件发送小票。顾客放在 context.traits 中,不需要 userId:
{
"event": "order_completed",
"messageId": "check-ber01-000123",
"timestamp": "2026-10-29T15:04:00+01:00",
"properties": {
"channel": "offline",
"store_id": "BER-01",
"order_id": "000123",
"amount": 89.90,
"products": [{ "product_id": "SKU-1", "price": 89.90, "quantity": 1 }]
},
"context": { "traits": { "phone": "+49 151 2345 6789", "loyalty_card": "2770 0001 5002" } }
}
- 请求为
POST /api/v1/track,批量发送使用POST /api/v1/batch,参见服务器集成。 - 只有使用私密密钥的请求才能按
context.traits查找顾客。网站的写入密钥不能这样做:否则访客可能冒用他人的电话。 messageId是小票的固定 ID,例如门店和小票号。使用相同messageId的重复请求会被丢弃。- 如果顾客已在网站上登录个人账户,且收银系统知道其 ID,请同时传入
userId。
门店通过请求 POST /api/v1/stores 发送到门店列表,请求体为 {"items": [{"id": "BER-01", "name": "Berlin Mitte", "city": "Berlin", "address": "…"}]}:每次最多 1000 个网点,相同 ID 的网点会被更新。需要“上传和删除商品”权限。
上传小票文件
- 在数据 → 门店的上传小票文件板块中点击选择文件。支持不超过 50 MB 的 CSV,或不超过 10 MB 的 Excel(.xlsx、.xls,第一个工作表)。第一行为列名。
- 指定每一列的内容:小票日期和时间(必填)、电话、会员卡、邮箱或顾客 ID(至少一列)、门店、小票号、金额、商品。名称相近的列会自动匹配。不需要的列请跳过,其余列可以保存为小票属性。
- 点击上传小票。上传进度和各行的错误显示在页面上。最近的上传显示在表单下方。

- 不含时区的时间,例如
2026-10-28 18:42或28.10.2026 18:42,按项目时区处理:收银系统通常记录本地时间。 - 同一单元格中的多个商品用
;、,或|分隔。 - 每一行都会按门店购买规则成为一张小票。没有顾客信息的行会被跳过并报错。
- 拥有修改档案权限的角色可以上传。已上传的小票计入套餐的每月事件配额。
门店列表
门店列表让 ROPO 报表中的网点显示易懂的名称,而不是小票中的 ID。门店包含门店 ID(小票中的 store_id 值)、名称、城市和地址。可以通过添加门店按钮、API 或 1C 扩展添加门店。
最近 30 天的小票板块显示每个网点的小票数和顾客数,以及最近一张小票的到达时间。列表中没有的网点会标注“不在列表中”,点击命名即可添加。如果删除门店,其小票会保留,报表中将显示 ID 而不是名称。