13 · 移动应用

Factuzam 提供独立移动应用，用于在 Windows 工作站以外查询信息或采集数据。每个应用使用自己的凭据和权限，不会直接连接 MariaDB。

Factuzam Control U：在浏览器和移动端查询库存

Control U 是只读查询工具，使用 Factuzam 的凭据和权限，不会直接连接 MariaDB。可按商品、SKU 或 EAN 搜索，并按颜色、尺码和仓库查看 Stock、 Entradas、Ventas 和 Pendiente de recibir。

Android 应用可用相机和闪光灯扫描 EAN-8/EAN-13。网页版支持手工输入或键盘扫码枪（不使用相机），并提供多重筛选、颜色/仓库透视、历史记录和图片放大。

Factuzam Control U 登录与库存示例 仅在可信本地网络中使用 http://；访问超出该网络时请使用 https://。

Factuzam Fotos Nube：使用 Android 拍摄商品照片

Factuzam Fotos Nube 可以用手机相机拍照或从相册选择图片，将其关联到商品和颜色，再批量上传到照片服务。之后可在 Factuzam 中下载并整合到商品目录。

Factuzam Fotos Nube 的拍摄和队列

初始配置

在 Configuración 标签页中填写：

字段	内容
URL	管理员提供的 `upload_foto.php` 服务地址。
API key	照片服务访问凭据。
Carpeta de cliente	服务器上的安装标识符。该文件夹必须预先存在；为防止输入错误造成重复，不会从手机创建。
Resolución máxima	图片最长边的最大尺寸。默认值为 1000 px，安全上限为 4000 px。

点击 Guardar configuración。这些值保存在应用的私有存储中，界面会显示配置文件路径。

Factuzam Fotos Nube 配置

API key 是凭据。不要让它以可读形式出现在截图、电子邮件或故障报告中；分享界面前请将其遮盖。

拍摄并上传一批照片

输入准确的商品代码。
输入颜色。它必须与 Factuzam 中构成 SKU 的颜色文本一致，而不是仅用于分类的基础颜色。
点击 Hacer foto 或 Elegir de galería。图片会缩小到配置分辨率，并以 Pendiente 状态加入队列。
对该批次所有商品和颜色重复此过程。
点击 Subir todas。每项先进入 Subiendo...，然后以 Subida OK 或 Error 结束。底部日志显示结果。

如果同一商品/颜色有多张图片，应用会按队列顺序分配索引 1、2、3…… 例如，BLUSA01 的 011-AZ 第一张照片会发布为该组的第 1 张图片。

为保证可靠匹配，Factuzam 会按与 SKU 相同的规则清理颜色：转为大写、空格改为连字符，并删除 /、%、€ 等符号。如果供应商颜色为 011-AZ，基础颜色为 AZUL，应用中应输入 011-AZ。

将照片加入 Factuzam 商品目录

上传到服务器不会自动替换本地照片。在 Windows 工作站中：

在 Otros ▸ Parámetros del entorno ▸ Fotos/Servicios web 中配置服务和照片共享文件夹。
打开商品或采购会话明细。
使用 Bajar fotos del servidor。Factuzam 会下载图片，将颜色关联到 SKU，并在 appDirFotos 中创建 300 px、600 px 和原始分辨率副本。
使用 [Ctrl]+[F] 或在库存查询中检查结果。

VentasFzam 与销售网页版：查看当日销售

VentasFzam 与网页版均为只读工具。无需打开 POS，即可从手机或浏览器查看每日销售，也不会修改发票、收款或库存。

使用虚构数据的 Factuzam 销售网页版 演示无需连接任何安装，即可查看合计、筛选、分组和收银结算。

网页版新增 Ver ticket PDF、在个人设备上记住访问 30 天、 Mi instalación、Olvidar 和 Reintentar。可配置零至三级分组，并重新计算各级小计。

显示内容

每条销售明细包括：

时间、SKU 和说明。
季节和供应商。
销售金额。
如果可用，显示 300 px 分辨率商品照片。

点击一行会打开详情，其中包括类别、颜色、成本价、PVP、百分比和金额折扣、销售价及合计。

表头汇总当日四项指标：

指标	内容
Venta	含增值税销售总额，用于与收银核对。
Coste	所显示商品的累计成本。
Margen	按计税基础而非含税销售额计算的金额和百分比。
Descuento	已应用折扣总额。

日常操作

◀ / ▶ 切换到前一天或后一天。
点击日期直接返回今天。
搜索框在手机上筛选已下载数据；结果立即显示，四项合计重新计算。搜索有效时，表头会显示 (filtrado)。
已作废或被替代的销售不会显示，也不会计入合计。正确的替代更正会显示；差额更正则按其正负号计入。

照片会在列表显示后再下载，避免拖慢查询，并缓存在手机中。如果下载期间切换日期，应用会丢弃上一查询尚未完成的图片。

日期以发票日期为准，而不是服务器收到事件的时间。因而合计会遵循企业结账日和安装所在地时区。

上线配置（管理员）

移动查询要求当前安装将销售发布到 Web 服务：

在 Otros ▸ Parámetros del entorno ▸ Servicios web 中配置 appApiUrl（通用 URL）、appApiToken（API key/token）和 appApiReferencia（安装参考）。
在 TPV ▸ Parámetros de Caja ▸ Servicios web 中，针对相应配置或收银台启用 Enviar ventas completas al webservice de respaldo （vgerEnviarVentasWS）。初始值为 False。
创建拥有销售读取权限的移动凭据。
在 VentasFzam ▸ Configuración (⚙) 中填写基础 URL、token 和参考。

Factuzam 会把销售的每次变更作为事件保存到本地队列，并在后台发送。收银台无需等待网络，Verifactu 税务队列也独立运行。事件使用同一标识符重试，以防止重复。

监控发送

打开 Otros ▸ Colas de envíos ▸ Web Service Fzam，检查每个事件的状态、尝试次数和 HTTP 历史。Actualizar 刷新查询，Ir a Documento 打开关联销售；该界面不能修改或重试记录。待发送事件默认每 60 秒处理一次，并使用指数等待；用尽配置的 20 次尝试后进入 ERROR。

状态、权限和恢复方式见 Otros ▸ Colas de envíos ▸ Web Service Fzam。

在增加新数据项（例如季节）前已经同步的历史销售，可能会一直显示为空，直到重新发送。新销售从首次发送起就会包含该数据。

移动库存盘点

盘点应用允许使用 Android 终端扫描库存，并将数量返回到打开的盘点。发送和取回由 Factuzam 控制；移动设备本身不会调整库存。

完整流程见 Almacén ▸ Inventarios ▸ 移动盘点。

◀ 变更与新功能 · 目录 · 下一章 ▶ 架构与开发