EzEComOP 组件 · 交易能力层

给 Agent 用的 ERP 能力层

EzERP 连接商家正在使用的 ERP 和平台卖家后台，把订单、采购、库存等交易数据整理成带来源、可追溯的类型化工具，供 EzEComOP、EzBI 和商家授权的 Agent 调用。它不替换你现有的 ERP。

当前处于只读工具阶段：除 EzShop 发货回写外，所有工具只读取外部业务数据。各来源的真实店铺验收仍在进行，工具已注册不代表对应来源已通过验收。

现在能做什么

每项能力都是一组输入输出有固定结构的工具，HTTP 与 MCP 共用同一份定义。数据是某次采集时的观察：附来源和采集证据，缺失的字段明确标为缺失，不记为零。

发现当前委托覆盖的店铺账号，建立默认只读的来源；把一次采集登记为持久意图，响应中断后按原意图恢复而不是重新提交；逐页接收数据集并校验摘要。

sources.* · collections.*

读取美客多巴西站销售订单的观察：按来源和观察时间分页，可按来源记录号或 SKU 精确筛选，每条都能回到原采集任务。读取同一团队其他成员采集的订单需要单独的共享权限。

orders.*

把一次选中的订单观察固定为批次，供连接器跨请求连续读取；将订单的来源引用和逐行 SKU 关系保存为带版本的模型。模型不推断跨来源配对。

orders.export_* · models.*

对两个来源的冻结批次检查证据和可比条件，把发现项放进可确认、可重开的收件箱并保留处理历史。现阶段不输出漏单、差异或一致的结论。

reconciliations.*

团队录入马帮开放平台的 app key 与 secret，可轮换和撤销；EzERP 用它直接向马帮发起签名的只读请求，保存原始响应，并整理出采购、库存 SKU 和分仓调拨的观察，可按 SKU 串起三者。字段解释仍是待真实校准的候选版本。

mabang_connections.* · api_reads.* · purchases.* · skus.* · allocations.*
需要部署方配置凭据密钥

跟随独立站的订单变化保存订单镜像（不含买家联系方式与地址），为已付款订单准备发货单，仅在准备发货时读取收货信息，并把承运商和运单号回写到 EzShop。这是目前唯一会写入外部系统的能力。

ezshop.*
需要部署方配置 EzShop 地址，调用时另附 EzShop 委托

在客户 ERP 中代为操作（审单分仓、库存修正、采购单草稿）、巴西 NF-e 开票、FULL 补货对账，以及马帮之外的 ERP 适配器。

这个站点没有账号登录，也没有操作界面。EzERP 的使用者是 Agent 和服务，人通过 EzEComOP 授权。

调用方携带 EzEComOP 签发的短期服务委托（ezdg1），最长有效 5 分钟，只包含明确列出的动作和目标。EzERP 不接受 Cookie、查询参数里的令牌或调用方自报的身份。

每个请求都会向 EzEComOP 复核签发会话、成员和目标是否仍然有效。退出登录、撤销权限或无法确认授权时，不返回租户数据。

所有数据查询都限定在委托所属的租户内，调用方不能在请求里指定租户或成员。

马帮 API 凭据以 AES-256-GCM 加密后入库，密文绑定租户、连接和修订号，撤销即销毁。EzERP 不保存 ERP 或平台的登录密码、Cookie 和浏览器会话。已授权的工具调用先写审计记录再执行，审计只保存输入的摘要，不保存令牌和原始输入。

标 “需委托” 的入口要求请求头 Authorization: Bearer <ezdg1 委托>，其余可直接访问。