美亚航旅机票B2B接口

这是本文档旧的修订版！

= 供应商代理接口说明 =

[toc]

一、接口说明及约定

所有接口返回都会由 SearchResponse 或 GetResponse 包装返回

1. SearchResponse 列表类

1. 结构说明

序号	字段名	类型	备注
—-	———–	——	——————————–
1	Code	string	成功返回“20000”，错误提示“400”
2	Description	string	详情描述：成功可空，错误得有提示
3	ResultCount	int	结果总数
4	Models	object	包含的返回的类型的列表

2. 示例 ```json {

  "Code": "20000",
  "Description": "",
  "ResultCount": 2,
  "Models": [
      {
          // Model 1
      },
      {
          // Model 2
      }
  ]

} ```

2. GetResponse 实体类

1. 结构说明

序号	字段名	类型	备注
—-	———–	——	——————————–
1	Code	string	成功返回“20000”，错误提示“400”
2	Description	string	详情描述：成功可空，错误得有提示
3	Model	object	返回的类型

2. 示例 ```json {

  "Code": "20000",
  "Description": "",
  "Model": {
      // Model
  }

} ```

二、接口列表

1. SearchProductType 查询产品类型接口

1. 定义查询产品类型，返回列表

2. 输入无

3. 输出 SearchResponse，Models

序号	字段名	类型	备注
—-	—————	——	————
1	ProductTypeID	int	产品类型 ID
2	ProductTypeName	string	产品类型名称

=== 2. SearchProductSubType 查询产品子类接口

1. 定义根据输入参数，查询产品子类型，返回列表

2. 输入

序号	字段名	类型	是否必填	备注
—-	————-	—-	——–	—————–
1	ProductTypeID	int	否	产品类型 ID，必填

3. 输出 SearchResponse，Models

序号	字段名	类型	备注
—-	——————	——	————
1	ProductSubTypeID	int	产品子类 ID
2	ProductSubTypeName	string	产品子类名称
3	ProductTypeID	int	产品类型 ID

3. SearchProductDetailType 查询产品细类接口

1. 定义根据输入参数，查询产品细类，返回列表

2. 输入

序号	字段名	类型	是否必填	备注
—-	———	—-	——–	—————–
1	SubTypeID	int	否	产品子类 ID，必填

3. 输出 SearchResponse，Models

序号	字段名	类型	备注
—-	———————	——	————
1	ProductDetailTypeID	int	产品细类 ID
2	ProductDetailTypeName	string	产品细类名称
3	SubTypeID	int	产品子类型ID

4. SearchSupplierType 查询供应商类型接口

1. 定义根据输入参数，查询供应商类型，返回列表

2. 输入无 3. 输出 SearchResponse，Models

序号	字段名	类型	备注
—-	————–	——	——–
1	SupplierTypeID	int	ID
2	TypeName	string	类型名称

=== 5. SearchContractType 查询合同类型接口

1. 定义

根据输入参数，查询供应商合同类型，返回列表

2. 输入无

3. 输出 SearchResponse，Models

序号	字段名	类型	备注
—-	————	——	——————–
1	ContTypeCode	string	合同类型编码
2	ContTypeName	string	合同类型名称

6. SearchSupplier 查询供应商接口

1. 定义

根据输入参数，查询供应商，返回列表

2. 输入

序号	字段名	类型	是否必填	备注
—-	———————-	———-	——–	————————————————————
1	IsPaging	bool	否	是否分页
2	PageIndex	int	否	当前页码
3	PageSize	int	否	每页数据行数
4	ProductTypeID	list<int\>	否	产品类型 ID，0 个或多个，如：[ 5, 6, 7, 8 ]
5	ProductSubTypeID	list<int\>	否	产品子类型 ID，0 个或多个，如：[ 5, 6, 7, 8 ]
6	ProductDetailTypeID	list<int\>	否	产品细类型 ID，0 个或多个，如：[ 5, 6, 7, 8 ]
7	SupplierName	string	否	供应商名字，模糊查询<br />（同时模糊查询【供应商全称】、【供应商简称】、【供应商编号】）
8	SupplierCode	string	否	供应商编号，精确查询
9	AscriptionContractCode	string	否	签约主体编码，精确查询
10	IsVerify	bool	否	是否已通过审核(默认为合作中)，当值为 true 时查询合作中，<br />为 false 时查出全部

3. 输出 SearchResponse，Models

序号	字段名	类型	备注
—-	———————-	——	————————————————————
1	SupplierCode	string	供应商代码
2	SupplierName	string	供应商名称
3	SupplierShortName	string	供应商简称
4	AscriptionContractCode	string	签约主体编码
5	AscriptionContract	string	签约主体全称
6	SubAscriptionContract	string	签约主体简称
7	SupplierTypeID	int	供应商类型
8	SupplierTypeName	string	供应商类型名
9	VerifyStatus	int	供应商状态，1-待生效，2-合作中，<br />3-暂停合作，4-新建，5-待审批，6-审批不通过，<br />7-待清查，8-终止合作，9-关闭
10	contractType	int	合同类型ID
11	contractTypeName	string	合同类型ID

7. GetSupplierDetail 取供应商详情接口

1. 定义

根据输入参数，供应商（不限状态），返回供应商实体

2. 输入

序号	字段名	类型	是否必填	备注
—-	———————-	——	——–	———————-
1	SupplierCode	string	是	供应商代码

3. 输出 GetResponse，Model

序号	字段名	类型	备注
—-	———————-	————–	————————————————————
1	SupplierCode	string	供应商代码
2	SupplierName	string	供应商名称
3	SupplierShortName	string	供应商简称
4	AscriptionContractCode	string	签约主体编码
5	AscriptionContract	string	签约主体全称
6	SubAscriptionContract	string	签约主体简称
7	SupplierTypeID	int	供应商类型
8	SupplierTypeName	string	供应商类型名
9	VerifyStatus	int	供应商状态，1-待生效，2-合作中，<br />3-暂停合作，4-新建，5-待审批，6-审批不通过，<br />7-待清查，8-终止合作，9-关闭
10	AccountList	list<Account\>	账号列表 (只返回有效账号)

4. 子模型 Account，Model

序号	字段名	类型	备注
—-	———————-	——	————–
1	Account	string	账号
2	AccountName	string	账号名称
3	CurrCode	string	币种
4	OpenBankName	string	开户行名称

美亚航旅机票B2B接口

用户工具

站点工具

一、接口说明及约定

1. SearchResponse 列表类

2. GetResponse 实体类

二、接口列表

1. SearchProductType 查询产品类型接口

3. SearchProductDetailType 查询产品细类接口

4. SearchSupplierType 查询供应商类型接口

6. SearchSupplier 查询供应商接口

7. GetSupplierDetail 取供应商详情接口

页面工具