跳到主要内容
美美途 AI 旅行社 ERP

美途 ERP · OpenAPI

把美途 ERP 接进你的系统

REST 接口，用代码读写本社的产品、订单、团单和客户数据。

适合自建系统集成、批量数据处理、对接财务或 CRM。

美途可以用鼠标点，也可以用嘴说，也可以用代码写。

看第一个请求
不想写代码？用 MCP 自然语言操作

两种用法，同一份数据

MCP · 用嘴说

「今天出了几团？把这条线路导入。」

OpenAPI · 用代码写

GET /orders?page=1&size=10

同一枚 Token · 本社数据自动隔离

效率对比

接入 AI 后，一家 20 人旅行社平均每天节省 3–4 小时重复操作时间，相当于每月多出 1 个全职人力。

场景示意

一家国旅接入后，线路上新从每天 5 条提升到 20 条，订单同步零遗漏。

怎么选

OpenAPI 和 MCP

两个接口共用同一枚 Token，数据完全一致。

  • 怎么调

    MCP：AI 对话，自然语言

    OpenAPI：写代码，HTTP 请求

  • 适合谁

    MCP：运营、计调、管理者

    OpenAPI：开发、技术团队

  • 典型场景

    MCP：「今天出了几团？」「导入这条线路」

    OpenAPI：批量同步产品数据、对接自有小程序

  • 鉴权

    MCP：同一枚 Token

    OpenAPI：同一枚 Token

接口

按业务分组

版本 v1 · Base URL https://service.meitu.io/api/open/erp/v1

在 ERP 管理台「用户 → OpenAPI Token」生成并管理 Bearer Token（与 MCP 共用 PAT）。 写接口需在 Token 上授予对应权限，字段以 Swagger 为准。

订单

  • GET/orders

    订单列表（按日期 / 状态 / 客户筛选）

    Query: page, size, orderStatus, travelStartDate

  • GET/orders/{orderId}

    订单详情

  • POST/orders/query

    订单列表（JSON 体复杂筛选，与 GET 能力一致）

  • POST/orders

    创建草稿订单

  • PATCH/orders/{orderId}

    更新订单字段

  • PATCH/orders/{orderId}/status

    修改订单状态

  • POST/orders/batch-status

    批量修改订单状态

产品 / 线路

  • GET/products

    线路列表

    Query: page, size, keyword

  • GET/products/{productId}

    产品详情（含行程、相册）

  • POST/products/query

    线路列表（JSON 体复杂筛选，与 GET 能力一致）

  • POST/products

    创建线路

  • PATCH/products/{productId}

    更新线路

  • POST/products/images/import

    相册图片转存

  • POST/products/{productId}/images/delete

    删除产品相册图片

  • GET/products/h5-page/design-guide

    H5 页面设计模板

  • GET/products/{productId}/h5-page

    读取商城页草稿和发布状态

  • PUT/products/{productId}/h5-page/draft

    保存商城页草稿

  • POST/products/{productId}/h5-page/publish

    发布商城页

  • GET/products/{productId}/channel-mappings

    查询该产品在各直连商户上的渠道端产品 ID

  • PUT/products/{productId}/channel-mappings

    设置或清除一条产品与渠道端产品的映射（body：customerId、channelLineId）

  • GET/channel-mappings

    按渠道端产品 ID、直连商户或平台渠道反查 ERP 产品

    Query: productId, customerId, channelId, channelLineId

团单

  • GET/groups

    团单列表

    Query: page, size

  • GET/groups/{groupId}

    团单详情（用 groupId，不用 groupNo）

  • POST/groups/query

    团单列表（JSON 体复杂筛选，与 GET 能力一致）

  • POST/groups/pack

    组团（新建或并入）

  • PATCH/groups/{groupId}/status

    修改团单状态

报价 / 客户

  • GET/quotations

    定制游报价列表

  • POST/quotations/query

    报价列表（JSON 体复杂筛选）

  • GET/quotations/{quotationId}

    报价详情

  • POST/quotations

    保存报价，finalize=true 时成单

  • GET/customers

    客户 / 同行列表

  • POST/customers/query

    客户列表（JSON 体复杂筛选）

  • GET/customers/{customerId}

    客户详情

  • POST/customers

    创建客户

  • GET/guests

    查询订单或报价的游客名单

    Query: orderId 或 quotationId

  • POST/guests

    全量替换游客名单

经营数据

  • GET/stats/today-realtime

    今日实时：新单 / 成团 / 待出行

  • GET/stats/dashboard

    首页订单仪表盘汇总

  • GET/finance/period-summary

    某期间收支汇总

    Query: startDate, endDate 或 year, month

基础数据

  • GET/dictionaries

    城市、线路类型、成团类型

    Query: types, keyword

  • GET/health

    健康检查（无需 Token）

工作流

接口怎么串起来

把OTA线路导入 ERP 并发布商城页

  1. POST /products — 创建线路，拿到 productId
  2. POST /products/images/import — 转存相册图片
  3. GET /products/h5-page/design-guide — 拿页面模板
  4. PUT /products/{productId}/h5-page/draft — 填入图片和卖点
  5. POST /products/{productId}/h5-page/publish — 发布
  6. PUT /products/{productId}/channel-mappings — 把 OTA 产品 ID 记到直连商户

用渠道端产品 ID 匹配 ERP 产品

  1. GET /products/{productId}/channel-mappings — 看有哪些直连商户、哪些已经映射
  2. GET /channel-mappings?channelLineId=渠道端产品ID — 反查已经对应的 ERP 产品
  3. PUT /products/{productId}/channel-mappings — body 带 customerId 与 channelLineId

每日订单同步 + 自动组团

  1. GET /orders?orderStatus=3&travelStartDate=出行日 — 查已确认订单
  2. POST /groups/pack — 按出行日组团
  3. PATCH /orders/{orderId}/status — 更新订单状态

快速开始

发第一个请求

  1. 在 ERP 后台「用户 → OpenAPI Token」生成 Token。
  2. 把 Token 放进 Authorization 头。
curl -s "https://service.meitu.io/api/open/erp/v1/orders?page=1&size=10" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"

响应格式：{ code, msg, data, timestamp }。分页字段为 records / page / size / total / pages。

完整接口参数见 Swagger 文档 →

已在用美途 ERP？

两分钟接好你的 AI 助手。

登录生成 Token →

还没用美途？ 预约演示 →