来福士接口

来福士接口模块旨在实现博远系统与来福士商场系统的数据同步。通过此功能，系统会将零售及退货数据上传至商场平台，以便商场进行销售额统计。

上传基本规则

在开始配置前，请先了解系统上传数据的核心逻辑：

数据来源与频率

• 数据范围：系统仅上传“零售单”及“零售退货单”数据（不含零售换机业务）。
• 上传时间：单据保存成功后，系统将自动异步上传。对于当天上传失败的数据，系统会在次日凌晨2点进行自动补传。
• 手动干预：若自动补传仍未成功，可以在“数据上传日志”中进行人工手动操作。

变更处理逻辑

• 单据删除：若单据已成功上传后被删除，系统会向商场补传一笔金额为负的记录以抵消。
• 金额修改：若单据已成功上传后修改了金额，系统将按差额部分进行上传。如果修改后金额变大，则上传正额；反之则上传退货记录。
• 单据编号：针对修改或删除后重新上传的记录，商场端的单据号会在原单据号后增加“-1”后缀（例如：23232-1），以便与原记录区分。

商品管理简化

• 统一编码：为了方便商场统计总额，来福士商场通常不关注具体的销售明细。可以配置一个统一的“货品编码”，该门店下所有的销售商品将统一以此编码上传。

来福士接口配置

功能介绍

此菜单用于手动添加并维护需要对接来福士系统的门店信息。

字段说明

• 门店：从下拉列表中选择需要开通接口的内部门店（必填）。
• 接口状态：此项为只读。显示接口是否已由后台人员正式启用。
• 启用时间：只读显示，记录接口正式开通的日期。
• 上传状态：默认为“上传”。若您因特殊原因需暂停数据同步，可手动切换为“关闭”。
• 商场编码：填写由来福士商场分配的固定商场识别代码。
• 店铺号：填写由商场分配的固定店铺编号。
• 用户名/密码：填写商场提供的接口访问凭证。
• 货品编码：填写商场分配的统一货品代码，用于代表该门店下销售的所有商品。

来福士收银编码设置

功能介绍

商场系统需要识别不同的付款方式。此菜单用于将系统内的收银方式与商场定义的编码进行匹配。

字段说明

• 门店选择：仅能选择已在“门店设置”中开通接口的门店。
• 自动读取：首次配置时，选择门店并点击查询，系统会自动加载该门店已有的收银方式。若门店未单独配置，则显示全部收银方式。
• 收银方式编码映射：请根据商场要求，为每个收银方式选择对应的代码：
  • CH：现金
  • CI：国内银行卡
  • CO：国外银行卡
  • AP：支付宝
  • WX：微信
  • OT：其他付款方式（若系统内收银方式未配置编码，将统一归为此类）

来福士数据上传日志

功能介绍

此菜单用于实时监控数据的同步状态，并对失败的记录进行人工处理。

查询条件

• 数据维度：列表以单据为维度展示信息，可以清晰看到每笔零售单或退货单的上传情况。
• 关键字段：显示每笔单据的总数量、总金额、交易日期、收银员及单据编号。
• 状态监控：记录每笔单据的上传结果。若显示失败，您可以直接查看具体的错误提示。
• 手动补传：对于显示为“失败”的记录，可以勾选对应行，点击“数据上传”按钮进行重新发送。

字段说明

• 交易日期/时间：系统记录单据发生或操作（如删除、修改）的具体时刻。
• 数量：销售单据显示为正数，退货单据显示为负数。
• 净金额：单据对应的合计金额（含本位币金额）。
• 销售员：系统会自动提取单据的制单人名称并同步至商场。