1. 销售回传（海鼎 → ERP）

海鼎收银时调用此接口，扣减库存、触发售罄广播：

POST /api/haiding/sale_callback

Content-Type: application/json



{

  "haiding_store_id": "HD001",      // 海鼎门店ID

  "haiding_order_no": "POS20260708001",  // 海鼎订单号

  "items": [

    {"sku": "P001", "quantity": 2, "unit_price": 12.5}

  ]

}

返回：

{

  "code": 0,

  "data": {

    "available": 28,

    "is_soldout": false,

    "broadcast_to": ["taobao", "haiding", "hiboos", "qianniuhua", "jianfu"]  // 售罄时广播的平台

  }

}

2. 库存同步（ERP → 海鼎）

系统会主动推送库存变化给海鼎，无需海鼎调用。

推送地址：海鼎提供的 webhook URL（需在海鼎后台配置）

订单回调（外卖 → ERP）

外卖平台有新订单时，调用此接口预占库存：

POST /api/takeaway/<platform>/order_callback

其中 platform = meituan | eleme | jd



Content-Type: application/json



{

  "platform_order_no": "MT202607081234",

  "platform_shop_id": "MT-S001",      // 平台店铺ID

  "items": [

    {"sku": "P001", "quantity": 1}

  ],

  "customer": {

    "name": "张三",

    "phone": "13800138000",

    "address": "北京市朝阳区..."

  },

  "total_amount": 28.5

}

返回：

{

  "code": 0,

  "data": {

    "order_no": "ORD20260708001",

    "status": "confirmed",

    "reserved": 1  // 预占数量

  },

  "msg": "订单已确认"

}

库存推送（ERP → 外卖）

售罄时系统自动推送售罄信息到外卖平台，无需平台调用。

推送地址：各外卖平台开放平台 webhook URL（在 ERP 端配置）

1. 提交小票打印

POST /api/print/receipt

Content-Type: application/json



{

  "device_id": "PRINT-001",

  "order_no": "ORD20260708001",

  "items": [

    {"name": "金枪鱼饭团", "qty": 2, "price": 12.5, "subtotal": 25}

  ],

  "total": 25.0

}

2. 提交标签打印

POST /api/print/label

Content-Type: application/json



{

  "device_id": "PRINT-L01",

  "product_name": "金枪鱼饭团",

  "price": 12.5,

  "production_time": "2026-07-08 06:00:00",

  "shelf_life_hours": 12

}

每个门店都需要独立配置各平台 ID：

修改路径：菜单 → 门店管理 → 点击「编辑」

   ┌─────────┐

   │ 美团/饿了么/京东 │ ──订单回调──> ERP库存中心 ──预占库存──> 确认接单

   └─────────┘                  │

                                ├── 库存变化时

                                ▼

                          ┌──────────┐

                          │ 推送库存 │

                          └──────────┘

                                │

                ┌───────────────┼───────────────┐

                ▼               ▼               ▼

            ┌──────┐        ┌──────┐        ┌──────┐

            │ 海鼎  │        │ 淘宝  │        │ 海博 │   ← 售罄时立即同步

            └──────┘        └──────┘        └──────┘

                                              │

                                              ▼

                                        ┌─────────┐

                                        │ 京东     │

                                        └─────────┘



   ┌─────────┐

   │  海鼎POS  │ ──销售回传──> ERP库存中心 ──扣减库存──> 触发各平台同步

   └─────────┘

                            

当前为演示版本，未启用签名验证。

生产环境建议：

• 所有 API 调用加 timestamp + sign 签名
• 使用 HTTPS 传输
• 每个平台/门店分配独立 app_key 和 app_secret
• IP 白名单限制