指南 API 业务

文档

在wallmarkets中运行配送、退货、产品、B2B入职、超市账户、报告和集成的指南、示例和参考路径。

按工作流浏览

查找您需要的系统部分

先短路径,下方更深层参考。选择与当前任务匹配的工作流。

推荐首次运行 使用真实分支创建一个真实配送,然后打印记录并查看其在报告中的位置。
跟随快速入门 →

入门

快速路径

当您希望从新账户到一条可查看、可打印、可报告的真实配送记录的最短可靠路径时,请使用此部分。

1创建账户 2添加目录和分支 3保存首次配送

什么是 Wallmarkets?

wallmarkets帮助供应商在一个工作系统中保存送货、退货、产品和超市账户。使用它可以创建干净的送货记录,将退货与原始货物联系起来,并在报告和分析中查看数字。

先做 证明一次正常配送

使用真实的产品、分支、数量和价格数据,以便工作流的其余部分能展示有用信息。

避免 尝试所有边缘情况

最快的信心来自一条平淡但准确的记录,如果团队需要,再做一个退货。

结果 一条源记录

您将获得一个配送详情页面,可支持打印、导出、退货、报告和后续审查。

先决条件
现代浏览器(Chrome、Firefox、Safari、Edge)
电子邮件地址或 Google 账户
无需安装软件
支持移动设备上的 PWA
最佳首次运行:一次实际交付

利用首次交付的真实数据来证明工作流程,而不是一次性对每个边缘进行压力测试。

快速入门

1
创建账户
使用电子邮件或 Google OAuth 注册。验证电子邮件以激活所有功能。
2
添加您的产品
输入您交付的每件产品的名称、重量、价格和类别。
3
注册超市
添加您提供的连锁店和分支机构,以及地址和联系方式。
4
创建首次交付
选择产品、数量、目标超市和交货日期。
5
跟踪一切
查看记录、任何链接的申报表以及说明更改内容的报告视图。

移动接入

在移动设备上,您可以将 wallmarkets 安装为渐进式网络应用程序 (PWA),以加快重复访问速度,并在连接不稳定时进行有限的缓存浏览。 如何学习 →

交货

主要任务

创建清晰的发货记录,回答货物去向、包含内容以及如有退货应如何处理。

1选择目的地 2添加产品线 3打印或导出

创建交付

导航至送货 > 新送货。选择目标超市和分店,添加一个或多个产品和数量,选择交货日期,然后提交。

由此产生的详细页面将成为源记录,您可以查看、打印、导出,或用作以后链接退货的起点。

交货记录形状

delivery.yaml
supermarket: E-mart
branch: Central Branch
delivery_date: 2026-03-15

lines:
  Whole Milk 1L x 50 @ 2850
  Greek Yogurt 500g x 30 @ 4200

重要的不是格式本身,而是在保存记录前目的地、数量和价格是否正确。

应用程序中如何显示送货信息

目前的工作流程是以清查记录为中心,而不是深入状态机。在实践中,团队会在列表视图、详细页面和任何链接的返回记录之间移动。

列表视图 详细页面 PDF / 打印 关联回报

清单参考

仪表盘字段 操作含义 决策影响
日期 交货记录的计划时间和创建时间 有助于审查时间和期间活动
目的地 超市和分店 这通常是分支层面的错误最先出现的地方
价值 细列项目的总交货价值 帮助您快速发现超大货物
已完成/返回 交货目前是独立的还是已经有链接的退货记录 后续工作的快速信号

跟踪与过滤

交货页面是一个有日期的工作列表。使用它可以打开记录、导出CSV、查看值,并发现哪些交货已经链接了退货。如果有需要解释的地方,请进入交货详情页,而不要试图仅从表格中推断出太多东西。

返回

主要任务

将退货商品保留在原配送单上,以便在运营、财务和报告中保持可追溯性。

1选择配送单 2确认数量 3查看影响

处理退货

转到退货 > 新退货,或从交货详情页开始。选择原始交货,确认要退货的产品和数量,选择退货日期,然后保存记录。

每一份退货都与最初的交付保持联系,这就保证了历史记录在以后的报告和后续工作中的可读性。

返回验证规则

验证检查 执行规则 防范风险
交付范围 所选交货必须属于当前业务 防止退货与错误账户关联
返回日期 不能是在交货日期之前或将来 保持返回历史的时间顺序和可信度
数量 退货数量不能超过交付数量减去之前的退货数量 防止团队在纸上过度退回相同的货物
价格 退还的线路必须仍有正单价 在报告和导出中保持返回值的意义

关联记录和文件

每份退货都与原始交货保持直接关系,可以查看、打印或下载 PDF 格式。这种关联结构使得日后的分析和对账工作比以自由浮动的笔记形式跟踪退货更容易。

回报分析

通过报告视图,可以更轻松地阅读退货总数和送货总数,然后在需要解释某种模式时,在分析中按超市和类别进行更深入的过滤。

产品

主要任务

在配送使用前确保目录可信。产品数据应规范、一致且易于批量导入。

1名称和重量 2价格和分类 3导入或编辑

管理产品目录

每个产品都有名称、重量、价格和类别。产品会被分配一个唯一的序列 ID,用于发货、退货和报告。可单独添加产品或通过 CSV 批量导入。

从产品详细页面编辑现有产品。对价格或重量的更改仅适用于未来的交货,历史记录将被保留。

产品数据模型

API字段 值类型 必填? 字段含义
name string 产品显示名称
weight decimal 重量(公斤
price decimal 单位价格
category string 用户自定义分组
sequential_id integer 汽车 唯一的、系统分配的

CSV 导入

通过上传 CSV 文件批量添加产品。导入程序会验证每一行,并在提交前报告任何错误。

products.csv
name,weight,price,category
"Whole Milk 1L",1.03,2850,"Dairy"
"Greek Yogurt 500g",0.52,4200,"Dairy"
"Orange Juice 2L",2.10,5600,"Beverages"

产品类别

将产品分门别类(如乳制品、饮料、冷冻产品),以便于在配送表单中进行筛选和分类报告。类别由用户定义--创建任何对您的业务有意义的分组。

超市

主要任务

将连锁店与分店分开,以便团队能够配送到正确的实体地点,而不是依赖模糊的账户名称。

1创建连锁 2添加分店 3用于配送

超市账户

每个超市账户都代表您配送的连锁店。在该账户中,您可以用自己的地址和联系方式注册分支机构。这种结构可以将送货和退货与正确的收货地点联系起来,而不是将所有东西都整合到一个连锁记录中。

分支层次结构

连锁超市(如 E-mart)
分部:中部(地址、联系方式)
分部:东区(地址、联系方式)
分行:机场路(地址、联系方式)

增设超市

1
转到超市 > 添加新内容
2
输入连锁名称和主要联系方式
3
添加一个或多个分支机构,并提供各自的地址和联系方式
4
节省 - 超市现在可以采用送货上门的形式

分支记录字段

当分支记录包含团队在创建交付和稍后审核过程中实际依赖的详细信息时,这些记录才最有用。

branch.yaml
name: Central Branch
address: Peace Avenue 10
contact_person: Receiving Manager
phone: +976-...
email: central@example.com

分支数据越清晰,以后就越容易避免目的地错误。

分支机构管理

使用超市和分店页面保持姓名、地址和联系人的准确性。整洁的分行数据会在以后的配送创建、退货和报告中发挥重要作用。

B2B 入门

主要任务

当超市希望在线接收产品推介,或当地供应商希望将真实目录商品推送到超市货架时,使用B2B入驻。

1选择角色 2发布或推介 3审批并下单

B2B入驻创建的内容

B2B入驻将货架访问转变为可追踪的工作流程。超市所有者可以打开买家门户,发布每个门店愿意接收的商品,查看当地供应商的推介,与供应商沟通,批准或拒绝推介,并开始首次库存请求。供应商可以从供应商端打开同一门户,发送带有目录证明的货架推介,然后在批准后协调请求、配送、发票和付款跟进。

买家路径 超市作为货架买家加入

买家路径从B2B入驻开始,启用门户,并将所有者引导至货架接收,以便在供应商推介前准备好门店。

供应商路径 本地企业以其目录进行推介

供应商路径可从公共B2B入驻目录开始,然后使用“寻找超市”发送产品证明、主打产品、上市条款和联系方式。

结果 受管理的合作轨迹

每次邀请、推介、备注、消息、批准、拒绝、库存请求、发票和管理审核都会附加到B2B记录中。

超市买家入驻

使用此路径适用于eMart风格的店主或品类买家,他们希望接收本地品牌的推介,并决定哪些产品上架。

1
创建企业账户
店主注册、确认邮箱,并为超市运营商创建企业资料。B2B需要现有企业,因为所有推介和请求都限定在该企业上下文中。
2
打开B2B入驻
店主打开 B2B > 开始使用 并选择 以超市买家身份开始. 表单提交时带有entry_mode=supermarket,标记B2B已启用,完成入驻步骤,并重定向到买家入驻页面。
3
创建或认领超市门店
每个超市门店成为供应商可提交推介的接收资料。资料应包含真实地址、联系人、电话或邮箱,以及门店级别的收货要求。
4
发布货架入驻信息
货架入驻信息记录买家联系方式、收货时间窗口、配送频率、最低订单金额、所需文件以及买家备注。这告诉供应商在发送推介前应包含哪些有用信息。
5
推介收件箱
推介收件箱显示待处理、活跃和已拒绝的供应商关系,包含目录数量、推介包、证明点、上市条款、买家备注、消息和操作按钮。
6
决定并开始首个货架订单
买家可以给供应商发消息、添加内部备注、批准推介、拒绝并说明原因,或将活跃推介转换为初始数量的库存请求。

本地供应商入驻

使用此路径适用于食品生产商、包装商品品牌或批发商,他们已有产品,并希望向超市买家展示产品为何值得上架。

1
准备目录证明
供应商应准备好产品名称、类别、价格、库存能力、证明点和上市条款。当提及主打产品以及客户为何已经想要它们时,推介会更有力。
2
开始供应商推介
供应商打开B2B入驻并选择 以本地供应商身份开始. 表单提交时带有entry_mode=supplier,启用B2B,并重定向到B2B仪表盘。
3
查找超市入驻信息
公共B2B入驻目录位于/b2b/intake,在登录前显示买家工作台。启用B2B后,“寻找超市”允许供应商打开工作台、阅读要求,并发送包含推介消息、重点产品、证明点、上市条款和联系方式的货架推介。
4
回复买家消息
合作消息传递将谈判保留在记录内。供应商可以回答买家问题,而无需依赖分散的电话、截图或邮件链。
5
批准后协调
一旦超市批准推介,关系变为活跃。库存请求、配送方案、发票、付款跟踪、分析和导出随后可在同一合作轨迹中进行。

生命周期参考

入驻时刻 发生事件 创建或更新的记录 店主决策
启用B2B 业务从仅普通物流切换至B2B门户。 已设置业务b2b_enabled,入职步骤标记为完成 选择买家路径、供应商路径或同时使用两者
货架入库 超市说明可接收的商品及所需凭证。 超市入库字段、联系人、窗口、文件、备注 使该地点具备上架条件
供应商推介 供应商请求货架权限并附上其目录故事。 合作关系行及推介包审核详情 审核、留言、备注、批准或拒绝
已批准的推介 供应商已获足够信任,可开始货架协调。 合作关系状态变更为活跃 创建初始库存请求
初始订单 买家请求选定产品的初始数量。 包含产品、超市、数量和请求用户的库存请求 批准、拒绝、转为配送、开票并跟踪付款

操作界面

B2B入职 货架入库 供应商发现 供应商推介 库存请求 发票

下一步操作

报告

报告工作流

将运营记录转化为决策

使用报告比较动销、退货和货值,无需将每个问题变成电子表格重建。

1选择周期 2比较退货 3需要时导出
仪表盘 CSV 筛选 API

仪表板关键绩效指标

主控制面板为您提供了大多数团队首先需要的快速读数:选定期间的收入、净收入、交付量和回报率。重点不是欣赏这些卡片。而是要注意其中某张卡片开始讲述与其他卡片不同的故事。

可用报告类型

用户界面 CSV 详细信息

配送摘要

所选时间段内的交货数量和价值,并可直接访问相关记录。

打开配送指南
用户界面 CSV 详细信息

回报细目

返回交付量旁边的计数和数值,以便查看哪些账户或时段产生了拖曳。

打开退货指南
仪表盘 CSV 分析

收入报告

阅读收益和净值旁边的总变动情况,使这一时期具有财务意义,而不仅仅是运营意义。

打开仪表盘指南
用户界面 分析 CSV

产品性能

使用产品和类别视图查看价值集中的地方,以及哪些项目会成为回头客。

打开分析指南

生成报告

导航至侧边栏中的报告,设置日期范围,先一起查看送货和退货情况。如果需要更深入的解释,请打开分析仪表板,按超市或类别进行筛选。

应用程序接口端点预览

GET /api/dashboard/stats
GET /api/dashboard/stats?range=30d

{
  "revenue": 12450000,
  "net": 11200000,
  "deliveries": 156,
  "returns": 8,
  "period_change": "+12.3%"
}

账户管理

主要任务

保持所有权、API密钥、计费预期和账户设置清晰,使运营不依赖于神秘访问。

1更新资料 2命名API密钥 3撤销过时访问

个人资料和密码

账户设置中更新您的姓名、公司、电子邮件、头像和用户名。同一页面还提供密码更改、语言偏好、通知切换、隐私链接和账户删除操作。

转到账户设置 →

当前的访问模式

产品领域 当前覆盖范围 推荐实践
业务数据范围 送货、退货、产品和超市与当前的业务环境息息相关 当似乎缺少某些东西时,首先检查业务环境
账户设置 个人资料、密码、语言、隐私链接和账户删除均在登录账户设置中进行 在团队内部明确所有权和所有者电子邮件
API 密钥 密钥由拥有密钥的账户创建和撤销 为每个集成使用单独命名的密钥,并快速撤销过时的密钥
团队控制 如今,该产品比完整的企业角色管理控制台更简单 不要围绕尚未实际出现的用户界面构建内部流程

API 密钥

账户设置 > API 密钥中生成命名的 API密钥。显示密钥时将其复制,安全存储,并在集成不再需要访问权限时将其撤销。

api-key-notes.txt
Key name: Production ETL
Rate limit tier: standard
Best practice: one key per integration
Action when retired: revoke immediately

账单

wallmarkets提供基于计划的访问,但并非每个账户都能直接在应用程序中使用完整的自助计费工作区。将计费变更视为所有者级别的工作,并在需要明确路径时使用计费指南。

准备好开始了吗?

在帮助中心探索我们的分步指南,或深入了解高级集成的 API 参考。