墩墩门店API连接器是屏墩墩集团专为实体门店打造的统一API MCP连接器，支持对接主流门店管理系统（POS、ERP、CRM等），实现门店数据与AI智能体的无缝对接。通过本连接器，AI智能体可以直接读取门店经营数据、执行操作指令，为门店提供智能化服务。
1. 门店管理系统数据实时同步到连接器 → 2. AI智能体通过统一API读取门店数据 → 3. AI智能体生成操作指令 → 4. 连接器将指令转换为门店系统操作 → 5. 操作结果反馈给AI智能体
| 方法 | 路径 | 描述 | 认证 |
|---|---|---|---|
| GET | /api/v1/store/info |
获取门店基本信息 | API Key |
| GET | /api/v1/store/products |
获取商品列表 | API Key |
| GET | /api/v1/store/products/{sku} |
获取商品详情 | API Key |
| POST | /api/v1/store/products |
创建/更新商品 | API Key |
| GET | /api/v1/store/inventory |
获取库存信息 | API Key |
| POST | /api/v1/store/inventory/adjust |
调整库存 | API Key |
| GET | /api/v1/store/orders |
获取订单列表 | API Key |
| GET | /api/v1/store/orders/{order_id} |
获取订单详情 | API Key |
| POST | /api/v1/store/orders |
创建订单 | API Key |
| GET | /api/v1/store/customers |
获取会员列表 | API Key |
| GET | /api/v1/store/customers/{customer_id} |
获取会员详情 | API Key |
| POST | /api/v1/store/customers |
创建/更新会员 | API Key |
| GET | /api/v1/store/sales/daily |
获取日销售数据 | API Key |
| GET | /api/v1/store/sales/ranking |
获取销售排行 | API Key |
| POST | /api/v1/store/webhooks |
注册Webhook | API Key |
GET /api/v1/store/sales/daily?date=2026-09-07
Authorization: Bearer YOUR_API_KEY
// 或POST创建订单
POST /api/v1/store/orders
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
{
"customer_id": "cust_12345",
"items": [
{"sku": "PROD001", "quantity": 2, "price": 99.00},
{"sku": "PROD002", "quantity": 1, "price": 199.00}
],
"payment_method": "wechat",
"store_id": "store_001"
}{
"order_id": "order_789012",
"status": "completed",
"total_amount": 397.00,
"customer_id": "cust_12345",
"items": [...],
"payment": {
"method": "wechat",
"transaction_id": "wx_1234567890",
"paid_at": "2026-09-07T10:30:00Z"
},
"created_at": "2026-09-07T10:30:00Z",
"store_id": "store_001"
}| 状态码 | 名称 | 描述 |
|---|---|---|
| 400 | Bad Request | 请求参数错误 |
| 401 | Unauthorized | API Key无效或已过期 |
| 403 | Forbidden | 无权限访问该门店 |
| 404 | Not Found | 商品/订单/会员不存在 |
| 409 | Conflict | 库存不足或订单冲突 |
| 422 | Unprocessable Entity | 业务逻辑错误 |
| 429 | Too Many Requests | 请求频率超限 |
| 500 | Internal Server Error | 服务器内部错误 |
| 502 | Bad Gateway | 门店管理系统连接失败 |
| 503 | Service Unavailable | 门店管理系统不可用 |
A: 支持银豹、思迅、科脉、管家婆、有赞等主流POS系统，以及用友、金蝶等ERP系统。
A: 支持实时数据同步，延迟通常在1-3秒，具体取决于门店管理系统的API性能。
A: 在控制台选择门店管理系统类型，输入系统的API地址和密钥，即可完成接入。
A: 企业版支持私有化部署，可以部署在企业自有服务器上，数据完全本地化。