云上客酒店、餐饮对接接口文档
1 产品接口
暂不对接，双方各自保存对方的产品ID。
2 订单接口
2.1 创建订单接口（供应商提供）
方法名：CreateOrder
调用方：分销平台
响应方：供应商
接口说明：本接口可用于分销平台从供应商下单。
2.1.1 业务请求参数
| 参数名 |
类型 |
描述 |
是否必传 |
| ProductNo |
int |
供应商产品（酒店产品、餐饮产品等）编号 |
是 |
| VisitDate |
string |
使用日期（酒店产品为入住日期），格式yyyy-MM-dd |
是 |
| Count |
int |
购买数量 |
是 |
| OrderNo |
int |
分销平台单号 |
是 |
| GuestName |
string |
游客姓名，多个逗号分隔 |
是 |
| MobileNo |
string |
游客手机号，多个逗号分隔 |
否 |
| IdNo |
string |
游客身份证号，多个逗号分隔 |
否 |
| TotalPrice |
decimal |
订单总价，单位元 |
是 |
| SellerNo |
string |
渠道账号 |
是 |
| SellerName |
string |
渠道名称，如美团 |
是 |
2.1.2 业务响应参数
| 参数名 |
类型 |
描述 |
是否必传 |
| ResultCode |
string |
响应编码 |
是 |
| ResultMessage |
string |
响应消息 |
是 |
| OrderNo |
int |
分销平台单号 |
是 |
| PurchaseOrderNo |
string |
供应商单号 |
是 |
| BarcodeNo |
stirng |
供应商码号 |
是 |
| Stock |
int |
剩余总库存 |
是 |
2.2 退单接口（供应商提供）
方法名：RefundOrder
调用方：分销平台
响应方：供应商
接口说明：本接口可用于分销平台从供应商退单。
2.2.1 业务请求参数
| 参数名 |
类型 |
描述 |
是否必传 |
| orderNo |
string |
平台订单编号 |
是 |
| reserveNo |
string |
供应商码号 |
否 |
| refundCount |
string |
退单数量 |
是 |
2.2.2 业务响应参数
| 参数名 |
类型 |
描述 |
是否必传 |
| ResultCode |
string |
响应编码 |
是 |
| ResultMessage |
string |
响应消息 |
是 |
2.3 消费通知接口（分销平台提供）
方法名：这里为分销平台主动通知地址，具体方法名称在参数中体现
调用方：供应商
响应方：分销平台
接口说明：本接口可用于供应商通知分销平台订单已核销。
2.3.1 业务请求参数
| 参数名 |
类型 |
描述 |
是否必传 |
| orderInfoList |
object[] |
订单列表 |
是 |
| orderNo |
int |
分销平台订单号 |
是 |
| pushType |
string |
推送通知类型，固定为ORDER_CHECK_TICKET |
是 |
orderInfoList中的单个对象数据结构
| 参数名 |
类型 |
描述 |
是否必传 |
| ticketNo |
string |
供应商码号 |
否 |
| ticketCount |
int |
验证总数量 |
|
2.3.2 业务响应参数
| 参数名 |
类型 |
描述 |
是否必传 |
| Code |
string |
响应编码 |
是 |
| Msg |
string |
响应消息 |
是 |
| Data |
string |
业务消息，success或fail |
是 |
