# Alibaba Cloud btripOpen API > Alibaba Cloud btripOpen API on Apizie: 235 endpoints (This API is no longer maintained (existing enterprise users are not affected). Currently, only the…, Syncs department information to Alibaba Business Travel (Alitrip), typically used to create a new department, Synchronizes employee information to Alibaba Business Travel. This operation is applicable to scenarios such…, Adds members in batch to a custom enterprise role, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month. - Project key: `cloud:aliyun-btripopen` - Category: Cloud - Status: byok - Source: https://api.alibabacloud.com/product/btripopen - Page: https://zieapi.vercel.app/api/cloud/aliyun-btripopen - OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-btripopen/openapi.json Alibaba Cloud OpenAPI for btripOpen (btripopen, version 2022-05-20). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret. ## Endpoints ### This API is no longer maintained (existing enterprise users are not affected). Currently, only the… `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/access-token` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | app_secret | string | yes | The API secret of the application. For information about how to obtain the secret, see [Application… | ### Syncs department information to Alibaba Business Travel (Alitrip), typically used to create a new department `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/add-department` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | out_dept_id | string | yes | The custom department ID defined by the enterprise. Ensure that this parameter value is unique. The default root department ID is 1. Do… | | out_dept_pid | string | no | The parent department ID. The parent department ID cannot be the same as the department ID. Ensure that the parent department information… | | dept_name | string | yes | The department name | | manager_employee_id_list | string | no | The department manager information (JSON-encoded) | | x-acs-btrip-corp-token | string | no | The enterprise access token. This is a required HTTP header parameter. For information about how to obtain it, refer to Enterprise access… | ### Synchronizes employee information to Alibaba Business Travel. This operation is applicable to scenarios such… `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/add-employee` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | user_id | string | yes | The employee ID, which is the unique identifier of the employee within the enterprise. Ensure that this value is unique | | union_id | string | no | The unique identifier of the same employee across multiple enterprises (parent enterprise and subsidiaries) | | user_nick | string | yes | The nickname of the employee | | real_name | string | no | The name of the employee | | real_name_en | string | no | The English name of the employee. Specify the value in the following format: Separate the last name and first name with a forward slash… | | avatar | string | no | The avatar of the employee. Specify the URL of the image | | gender | string | no | The gender of the employee | | birthday | string | no | The birthday of the employee. Format: yy-MM-dd | | out_dept_id_list | string | no | The list of departments to which the employee belongs (JSON-encoded) | | position_level | string | no | The position level of the employee, which is commonly used to match different travel standards | | job_no | string | no | The employee number, which serves as a unique identifier along with `user_id`. Ensure that this value is unique | | email | string | no | The email address of the employee | | phone | string | no | The mobile phone number of the employee. This field is commonly used for booking business travel services across various categories. In… | | manager_user_id | string | no | The ID of the direct manager of the employee | | base_city_code_list | string | no | The 6-digit administrative code of the work location. You can specify up to two different administrative codes (JSON-encoded) | | base_location_list | string | no | The base location information of the employee (JSON-encoded) | | cert_list | string | no | The certificate information of the employee (JSON-encoded) | | custom_role_code_list | string | no | The collection of role IDs associated with the employee. An employee can be associated with a maximum of 200 roles. Otherwise, the… | | is_admin | string | no | Specifies whether the employee is an Alibaba Business Travel enterprise administrator | | is_dept_leader | string | no | Specifies whether the employee is a department manager | | is_boss | string | no | Specifies whether the employee is the boss | | x-acs-btrip-corp-token | string | no | The enterprise access token. When calling the operation over HTTP, include this as a required parameter in the request URL. For… | | attribute | string | no | The custom extension field for the employee, which supports key-value pairs. Format: JSON string | | account_phone | string | no | The account phone number. For enterprises that have enabled international phone numbers, specify international numbers, Hong Kong (China),… | | account_email | string | no | The account email address. This parameter can be specified when the enterprise activation method is email activation | ### Adds members in batch to a custom enterprise role `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/add-employees-to-custom-role` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | role_id | string | yes | The ID of the custom enterprise role | | user_id_list | string | yes | The list of member IDs. The maximum number of members per request is 500 (JSON-encoded) | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise access token" operation. Add it to the header. In HTTP mode, you can use corp_token=value… | ### Adds applicable personnel to an invoice title `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/add-invoice-entity` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | third_part_id | string | yes | The third-party invoice ID | | entities | string | yes | The list of entities (JSON-encoded) | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation. Add it to the header. In HTTP mode, you can use… | ### Adds project managers `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/add-project-manager` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | project_id | integer | no | The internal project ID. You must specify at least one of project_id and out_project_id | | out_project_id | string | no | The third-party project ID. You must specify at least one of project_id and out_project_id | | org_entities | string | no | The list of manager group entities. Currently, entityType only supports "1" (employee). The maximum number is 10 (JSON-encoded) | | x-acs-btrip-corp-token | string | no | The enterprise access token. This is a required header parameter for HTTP calls. For information about how to obtain it, refer to… | ### 商旅功能页跳转 `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/address-get` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | user_id | string | yes | 无userId时传缺省值superAdmin | | itinerary_id | string | no | The itinerary_id | | type | integer | no | The type | | phone | string | no | The phone | | action_type | integer | yes | The action_type | | sub_corp_id | string | no | The sub_corp_id | | car_scenes_code | string | no | The car_scenes_code | | taobao_callback_url | string | no | The taobao_callback_url | | dep_city_name | string | no | The dep_city_name | | dep_city_code | string | no | The dep_city_code | | arr_city_name | string | no | The arr_city_name | | arr_city_code | string | no | The arr_city_code | | dep_date | string | no | The dep_date | | order_Id | string | no | The order_Id | | x-acs-btrip-so-corp-token | string | no | The x-acs-btrip-so-corp-token | | use_booking_proxy | integer | no | The use_booking_proxy | | traveler_id | string | no | The traveler_id | | middle_page | integer | no | The middle_page | | thirdpart_apply_id | string | no | The thirdpart_apply_id | | session_parameters | string | no | 会话参数，格式要求key和value都是String的json字符串。 数据示例："{\"returnURL\":\"https://open.alibtrip.com/\"}" | ### Queries airport data `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/airport-search` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | keyword | string | yes | The search keyword | | type | integer | no | The airport type. Valid values: 0: domestic airports. 2: domestic airports and nearby airports. 3: international airports | | x-acs-btrip-so-corp-token | string | no | The header parameter obtained from the enterprise access credential operation. Add this parameter to the header. In HTTP mode, you can use… | ### Queries all administrative division codes for business travel cities `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/all-base-city-info-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | x-acs-btrip-access-token | string | no | The header parameter obtained from the "Application Access Credential" operation. Add it to the header. In HTTP mode, you can use… | ### Creates a business trip approval form in Alibaba Business Travel. This operation is typically used to… `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/apply-add` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | corp_name | string | no | The name of the enterprise | | sub_corp_id | string | no | [Deprecated] The enterprise ID. Use [group enterprise… | | user_id | string | yes | The ID of the applicant. This is the third-party user ID | | user_name | string | no | The name of the user. Specify the real name of the employee. If you do not specify this parameter, the system uses the name associated… | | depart_id | string | no | The ID of the department. If you do not specify this parameter, the system obtains the department information based on the user… | | depart_name | string | no | The name of the department | | thirdpart_depart_id | string | no | The third-party department ID. You can specify either the third-party department ID or the department ID. If you specify both, the… | | trip_day | integer | no | The number of days for the business trip | | trip_cause | string | yes | The reason for the business trip | | trip_title | string | yes | The title of the application form | | thirdpart_apply_id | string | yes | The ID of the external application form | | type | integer | no | The type of the applicant | | itinerary_rule | integer | no | The itinerary city rule for the application form. If you set this parameter to 0, the `itinerary_list` parameter is required. If you set… | | itinerary_set_list | string | no | The itinerary list of the city set (JSON-encoded) | | itinerary_list | string | no | The itinerary list (JSON-encoded) | | traveler_list | string | no | The traveler list (JSON-encoded) | | external_traveler_list | string | no | The list of external travelers (JSON-encoded) | | status | integer | no | The status of the approval form | | thirdpart_business_id | string | no | The ID of the external approval form | | union_no | string | no | The associated form number | | hotel_budget | integer | no | The domestic hotel budget. Currency unit: CNY, cents. Incidental expenses (such as dining and in-room merchandise) incurred by specially… | | flight_budget | integer | no | The domestic flight budget. Currency unit: CNY, cents | | train_budget | integer | no | The train ticket budget. Currency unit: CNY, cents. For example, if the seat type is "hard sleeper" and prices vary among upper, middle,… | | vehicle_budget | integer | no | The car service budget. Currency unit: CNY, cents. Uncontrollable factors in ride-hailing scenarios may cause the actual fare to exceed… | | intl_flight_budget | integer | no | The international and China Hong Kong, Macao, and Taiwan flight budget of the approval form (in cents) | | intl_hotel_budget | integer | no | The international hotel budget of the approval form (in cents) | | meal_budget | integer | no | The meal budget of the approval form (in cents) | | budget | integer | no | The total budget, including domestic flights, domestic hotels, train tickets, and car services. Currency unit: CNY, cents | | warning_amount | integer | no | The alert threshold. Currency unit: CNY, cents | | budget_merge | integer | no | Specifies whether to merge the budgets of multiple business travel approval forms | | limit_traveler | integer | no | Specifies whether to limit the travelers. If the approval form does not limit travelers and the default travel standard (default_standard)… | | together_book_rule | integer | no | The simultaneous booking (flight and train ticket) rule | | extend_field | string | no | The extended information. You can pass supplementary descriptions to this field, and the corresponding content is reflected in the bill.… | | payment_department_id | string | no | The ID of the department to which the expense belongs | | payment_department_name | string | no | The name of the department to which the expense belongs | | hotel_share | string | no | The travel standard calculation rule for hotel room sharing (JSON-encoded) | | car_rule | string | no | The business travel car service rules (JSON-encoded) | | external_traveler_standard | string | no | The travel standard for external travelers (JSON-encoded) | | default_standard | string | no | The default travel standard for the application form. If the travelers are not determined when the enterprise submits the application… | | traveler_standard | string | no | The list of travel standards for internal employees (JSON-encoded) | | x-acs-btrip-so-corp-token | string | no | The enterprise access credential. When you call the API operation over HTTP, you must append this parameter as a required parameter to the… | | ai_plan_id | string | no | The ID of the AI plan | | international_flight_cabins | string | no | [Deprecated] This field is deprecated | ### Updates the status of a business travel approval form `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/apply-approve` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | apply_id | string | yes | The ID of the external application form | | status | integer | yes | The status of the approval form. You can change the status to Approved or Rejected only when the current status is Pending Approval. No… | | user_name | string | no | The name of the approver | | operate_time | string | yes | The time when the operation is performed | | note | string | no | The remarks | | sub_corp_id | string | no | ~~Sub-enterprise ID~~ Deprecated. Use [Group Enterprise… | | user_id | string | yes | The ID of the approver (third-party user ID) | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the Enterprise Access Credential operation (added in the header). In HTTP mode, you can use… | ### Synchronizes the status of an external approval node for business travel `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/apply-external-node-status-update` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | node_id | string | yes | The node ID | | process_action_result | string | yes | The process execution result | | operation_records | string | no | The external approval information (JSON-encoded) | | x-acs-btrip-corp-token | string | no | A header parameter. Obtained from the "Enterprise access credential" API (added in the header). In HTTP mode, you can use corp_token=value… | ### Applies for an invoice by billing cycle `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/apply-invoice-task` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | invoice_task_list | string | yes | The adjusted invoice task list (JSON-encoded) | | bill_date | string | yes | The billing date | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" interface. Add it to the header. In HTTP mode, you can use… | ### Retrieves a list of business travel approval forms `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/apply-list-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | depart_id | string | no | The department ID of the applicant | | start_time | string | no | The start time in the format of yyyy-MM-dd HH:mm:ss | | end_time | string | no | The end time in the format of yyyy-MM-dd HH:mm:ss | | gmt_modified | string | no | The approval forms with an update time greater than or equal to this time. Format: yyyy-MM-dd HH:mm:ss | | page | integer | no | The page number, starting from 1 | | page_size | integer | no | The number of entries per page. Default value: 10. Maximum value: 50 | | type | integer | no | The submission type of the application form. Valid values: 1: Submitted on behalf of another person. 2: Submitted by the applicant. Note:… | | all_apply | string | no | Specifies whether to include reimbursed application forms. Valid values: false: Unreimbursed application forms. true: Reimbursed… | | union_no | string | no | The third-party associated order number | | only_shang_lv_apply | string | no | Specifies whether to return only business travel application forms. Valid values: true: Business travel application forms only. false: All… | | user_id | string | no | The applicant ID (third-party user ID) | | sub_corp_id | string | no | ~~Sub-enterprise ID~~ Deprecated. Use [Group Enterprise… | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise Access Credential" operation (added in the header). In HTTP mode, you can use… | ### Modifies an approval request `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/apply-modify` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | corp_name | string | no | The enterprise name | | user_id | string | yes | The ID of the applicant (third-party user ID) | | user_name | string | no | The username. If you specify this parameter, you must enter the real name. If you do not specify this parameter, the system uses the name… | | depart_id | string | no | The department ID. If you do not specify this parameter, the system obtains the department information based on the user information. If… | | depart_name | string | no | The department name | | thirdpart_depart_id | string | no | The third-party department ID. If you specify either the third-party department ID or the department ID, the specified field prevails. If… | | sub_corp_id | string | no | [Deprecated] The subsidiary enterprise ID. Use [group enterprise… | | trip_day | integer | no | The number of business travel days | | trip_cause | string | yes | The reason for business travel | | trip_title | string | yes | The title of the approval request | | thirdpart_apply_id | string | yes | The ID of the external approval request | | itinerary_rule | integer | no | The approval request city rule. Valid values: 0: One-to-one mapping between departure and destination cities. Pass the itinerary as a… | | itinerary_set_list | string | no | The city set itinerary list (JSON-encoded) | | itinerary_list | string | no | The itinerary list (JSON-encoded) | | traveler_list | string | no | The traveler list (JSON-encoded) | | external_traveler_list | string | no | The list of external travelers (JSON-encoded) | | status | integer | no | The status of the approval request | | thirdpart_business_id | string | no | The external approval request ID displayed to the user | | union_no | string | no | The associated request number | | hotel_budget | integer | no | The domestic hotel budget. Currency: CNY, in cents. Incidental expenses (such as dining and in-room items) incurred by specially… | | flight_budget | integer | no | The domestic flight budget. Currency: CNY, in cents | | train_budget | integer | no | The train ticket budget. Currency: CNY, in cents. For example, if the seat type is "hard sleeper" and there are price differences among… | | vehicle_budget | integer | no | The car service budget. Currency: CNY, in cents. Uncontrollable factors in ride-hailing scenarios may cause the actual fare to exceed the… | | intl_flight_budget | integer | no | The international and China Hong Kong, Macao, and Taiwan flight budget of the approval request, in cents | | intl_hotel_budget | integer | no | The international hotel budget of the approval request, in cents | | meal_budget | integer | no | The meal budget of the approval request, in cents | | budget | integer | no | The total budget. This includes domestic flights, domestic hotels, train tickets, and car services. Currency: CNY, in cents | | budget_merge | integer | no | Specifies whether to merge the budgets of multiple business travel approval requests. For multiple approval requests with the same… | | limit_traveler | integer | no | Specifies whether to limit the travelers. 0: Do not limit travelers. 1: Limit to travelers in the request. If the approval request does… | | together_book_rule | integer | no | The rule for simultaneous booking of flights and train tickets | | extend_field | string | no | Pass a supplementary description to this field. The value will be reflected in the bill and can be used for enterprise statistics and… | | payment_department_id | string | no | The ID of the department to which the expense belongs | | payment_department_name | string | no | The name of the department to which the expense belongs | | car_rule | string | no | The business travel car service rules (JSON-encoded) | | hotel_share | string | no | The hotel room sharing rules (JSON-encoded) | | external_traveler_standard | string | no | The travel standard for external travelers (JSON-encoded) | | default_standard | string | no | The default travel allowance standard for the application form. If the travelers are undetermined when an enterprise submits an… | | traveler_standard | string | no | The travel standards for internal staff (JSON-encoded) | | x-acs-btrip-so-corp-token | string | no | The header parameter. You can obtain this token from the enterprise access credential API and add it to the request header. In HTTP mode,… | | warning_amount | integer | no | The alert threshold. The currency is CNY, and the unit is cents | ### Queries the details of a business travel approval form `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/apply-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | type | integer | no | The submission type of the application form. Valid values: 1: Submitted on behalf of others. 2: Submitted by the applicant. Note: If the… | | apply_id | integer | no | The ID of the Alibaba Business Travel approval form | | apply_show_id | string | no | The display ID of the Alibaba Business Travel approval form | | thirdpart_apply_id | string | no | The ID of the third-party approval form | | sub_corp_id | string | no | ~~Subsidiary enterprise ID~~ [Deprecated] Use [group enterprise… | | x-acs-btrip-so-corp-token | string | no | The header parameter. This parameter is obtained from the Enterprise access credential operation and added to the request header. In HTTP… | ### Approves or rejects an approval task `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/apply-trip-task-execute` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | user_id | string | yes | The userId of the current operator | | user_name | string | no | The name of the current operator | | task_id | integer | yes | The task ID | | task_action | string | yes | Specifies whether to approve or reject the approval task | | action_from | string | yes | The source of the task execution | | comment | string | no | The approval comment | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation (added in the header). In HTTP mode, you can use… | ### Queries city information by using a city name as the keyword. This operation applies to both domestic and… `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/base-city-info-search` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | keyword | string | yes | The search keyword, which is the city name | | region | string | yes | The search region | | x-acs-btrip-access-token | string | no | The enterprise access credential. This is a required header parameter for HTTP calls. To obtain the credential, refer to Enterprise access… | ### Queries departments in batch or individually `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/batch-query-department` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | out_dept_id | string | no | The third-party department ID. If this parameter is not empty, a single query is performed based on this ID, and pagination and time… | | modified_time_greater_or_equal_than | string | no | The incremental filter for the department update time. If specified, only departments with gmt_modified >= this time are returned.… | | page_token | string | no | The pagination token (opaque cursor). Do not pass this parameter for the first page. For subsequent pages, pass the next_cursor_token… | | page_size | integer | no | The page size. Minimum value: 1. Maximum value: 1000. Default value: 10 | | x-acs-btrip-corp-token | string | no | The enterprise token | ### Submits a batch `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/batch-submit-pre-bill` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "enterprise access credential" operation (added in the header). In HTTP mode, you can use… | | bill_batch | string | yes | The bill batch date in the format of yyyy-MM-dd, such as 2026-06-21 | | dimension | integer | yes | The dimension type. Valid values: 1: bill ID. 2: order number. 3: approval form. 4: invoice title | | values | string | yes | The values determined by the dimension parameter. For example, if dimension is set to 1, the values should be bill IDs (JSON-encoded) | | customer_decision | integer | no | The customer decision. Valid values: 1: bill in the current period. 2: deferred billing. null: bill according to the current billing… | | app_ip | string | no | A system parameter. You do not need to manually specify this parameter | ### Adjusts the information of a specified bill `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/btrip-bill-info-adjust` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | primary_id | integer | yes | The bill ID | | third_part_invoice_id | string | no | The third-party invoice header ID associated with this bill | | third_part_cost_center_id | string | no | The third-party cost center ID associated with this bill | | third_part_project_id | string | no | The third-party project ID associated with this bill | | third_part_department_id | string | no | The third-party department ID associated with this bill | | user_id | string | no | The employee ID associated with this bill | | x-acs-btrip-corp-token | string | no | The enterprise access token. This is a required HTTP header parameter. For information about how to obtain it, refer to Enterprise access… | ### Synchronizes an intra-city car service approval form `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/car-apply-add` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | third_part_apply_id | string | yes | The ID of the third-party approval form | | title | string | yes | The title of the approval form | | cause | string | yes | The reason for the business trip | | times_type | integer | no | The type of available usage count for the approval form. Valid values: 1: Unlimited count. 2: User-specified count. If your enterprise… | | times_total | integer | no | The total available count for the approval form | | times_used | integer | no | The used count for the approval form | | status | integer | yes | The approval status | | city | string | no | The car service cities. Separate multiple cities with Chinese commas (，). Note: You can specify up to 10 cities. The values of city and… | | city_code_set | string | no | The set of city codes for intra-city car service. Separate multiple cities with Chinese commas (，). Note: 1) Either city_code_set or city… | | traveler_standard | string | no | The intra-city car service rules (JSON-encoded) | | itinerary_list | string | no | The intra-city car service itinerary (JSON-encoded) | | date | string | no | The car service date. Control is applied on a daily basis. For example, a value of 2021-03-18 20:26:56 indicates that the car service is… | | finished_date | string | no | The car service end date. Control is applied on a daily basis. For example, if date is set to 2021-03-18 20:26:56 and finished_date is set… | | third_part_invoice_id | string | no | The third-party invoice header ID associated with the approval form. This field is required. To configure it as optional, contact… | | third_part_cost_center_id | string | no | The third-party cost center ID associated with the approval form. This field is required. To configure it as optional, contact operations.> | | project_code | string | no | The project code associated with the approval form | | project_name | string | no | The project name associated with the approval form | | user_id | string | yes | The third-party employee ID of the user who initiates the approval | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise Access Credential" operation (added in the header). In HTTP mode, you can use… | ### Updates an intra-city car service approval order (status/trip information) `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/car-apply-modify` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | third_part_apply_id | string | yes | The third-party approval order ID | | status | integer | yes | The approval result | | operate_time | string | no | The approval time. The time must be in the yyyy-MM-dd HH:mm:ss format | | remark | string | no | The approval remarks | | user_id | string | yes | The third-party employee ID of the approval order | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the Enterprise Access Credential operation. Add it to the header. In HTTP mode, you can use… | ### Queries intra-city car service approval orders `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/car-apply-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | third_part_apply_id | string | no | The third-party approval order ID | | created_start_at | string | no | The start time for filtering approval orders by creation time (greater than or equal to). The time must be in the yyyy-MM-dd HH:mm:ss format | | created_end_at | string | no | The end time for filtering approval orders by creation time (less than). The time must be in the yyyy-MM-dd HH:mm:ss format | | page_size | integer | no | The number of entries per page. The value must be greater than or equal to 1. Default value: 20 | | page_number | integer | no | The page number. The value must be greater than or equal to 1. Default value: 1 | | user_id | string | no | The third-party employee ID | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise Access Credential" operation (added in the header). In HTTP mode, you can use… | ### Queries the car service billing data generated by a specified enterprise within a specific time period `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/car-bill-settlement-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | period_start | string | no | The start time for querying billing data. Format: `yyyy-MM-dd` or `yyyy-MM-dd HH:mm:ss` | | period_end | string | no | The end time for querying billing data. Format: `yyyy-MM-dd` or `yyyy-MM-dd HH:mm:ss`. Maximum value: current time - 1h. Range… | | page_no | integer | yes | The page number, starting from 1 | | page_size | integer | yes | The page size. Default: 10. Maximum: 100 | | x-acs-btrip-so-corp-token | string | no | The enterprise access token. This is a required header parameter for HTTP calls. For information about how to obtain it, refer to… | | bill_batch | string | no | The bill batch in yyyyMMdd format | | scroll_id | string | no | The scroll ID. In scroll mode, pass the scroll ID returned from the previous query | | scroll_mod | string | no | Specifies whether to use scroll mode. Default: no. Scroll mode bypasses the query limit. Otherwise, only one day of data can be queried | | order_id | integer | no | The business travel order ID | | bill_record_time_start | string | no | The bill record start time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format | | bill_record_time_end | string | no | The bill record end time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format | | apply_id | string | no | The approval ID | ### 查询用车订单列表 `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/car-order-list-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | user_id | string | no | 无userId时传缺省值superAdmin | | depart_id | string | no | The depart_id | | start_time | string | no | The start_time | | end_time | string | no | The end_time | | update_start_time | string | no | The update_start_time | | update_end_time | string | no | The update_end_time | | page | integer | no | The page | | page_size | integer | no | The page_size | | apply_id | integer | no | The apply_id | | thirdpart_apply_id | string | no | The thirdpart_apply_id | | all_apply | string | no | The all_apply | | x-acs-btrip-so-corp-token | string | no | The x-acs-btrip-so-corp-token | ### 用车订单查询 `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/car-order-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | integer | no | The order_id | | sub_order_id | integer | no | The sub_order_id | | x-acs-btrip-so-corp-token | string | no | The x-acs-btrip-so-corp-token | ### Queries enterprise car service scenario templates `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/car-scene-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation (added in the header). In HTTP mode, you can use… | ### Creates a business travel enterprise for a channel partner's counterpart, automatically establishing the… `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/channel-corp-create` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | third_corp_id | string | yes | The custom business travel enterprise ID of the counterpart. Character length limit: 5 ≤ length ≤ 20. Use the counterpart name plus a… | | corp_name | string | yes | The custom business travel enterprise name of the counterpart. Character length limit: 5 ≤ length ≤ 20. Use the actual enterprise name of… | | user_id | string | no | The user ID of the counterpart enterprise. This parameter is optional. If not specified, the system automatically generates one | | administrator_phone | string | no | The phone number of the counterpart enterprise administrator | | administrator_name | string | yes | The name of the counterpart enterprise administrator | | scope | integer | no | The travel scale of the counterpart | | province | string | no | The province where the counterpart enterprise is located | | city | string | no | The city where the counterpart enterprise is located | | x-acs-btrip-corp-token | string | no | The enterprise access token. When calling this operation over HTTP, include this as a required parameter in the request URL. For… | | extend_field | string | no | A JSON string with key-value pairs where both key and value are strings | | btrip_region | string | no | The Alibaba Business Travel region version. Select GLOBAL for enterprises that do not settle in RMB. Valid values: ● CN: Chinese mainland… | | base_currency | string | no | The enterprise base currency (settlement currency). Required when btrip_region is GLOBAL. Not used when btrip_region is CN. Valid values:… | | corp_name_en | string | no | The custom English name of the counterpart business travel enterprise, used for the internationalized version display | | administrator_email | string | no | The counterpart enterprise administrator email address. ⚠️Either the phone number or this field is required. When this field is specified,… | ### Queries basic data of administrative divisions (cities and districts) `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/city-search` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | keyword | string | yes | The search keyword | | x-acs-btrip-so-corp-token | string | no | The header parameter obtained from the "Enterprise access credential" operation (added in the header). In HTTP mode, you can use… | ### Queries the approval information for refund or change requests `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/common-apply-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | apply_id | integer | no | The business travel approval ID | | biz_category | integer | yes | The business type | | user_id | string | no | The third-party user ID | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation (added in the header). In HTTP mode, you can use… | | business_instance_id | string | no | Either this parameter or apply_id is required | ### Synchronizes the approval result for a refund or change request `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/common-apply-sync` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | apply_id | integer | yes | The business travel over-budget approval order ID | | thirdparty_flow_id | string | no | The third-party process instance ID | | status | integer | yes | The approval order status | | user_id | string | yes | The third-party user ID of the approver. Separate multiple values with commas | | remark | string | no | The approval comment | | biz_category | integer | no | The business type of the approval order | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the Enterprise Access Credential operation. Add it to the request header. In HTTP mode, you can use… | ### Confirms a pre-billing bill `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/confirm-pre-bill` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "enterprise access credential" operation (added in the header). In HTTP mode, you can use… | | bill_batch | string | yes | The bill batch in the format of yyyy-MM-dd, such as 2026-06-21 | ### Queries flight billing data generated by a service provider enterprise within a specified time period `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/cooperator-flight-bill-settlement-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | period_start | string | no | The start time for querying billing data. Format: `yyyy-MM-dd or yyyy-MM-dd HH:mm:ss` | | period_end | string | no | The end time for querying billing data. Format: yyyy-MM-dd or yyyy-MM-dd HH:mm:ss. Maximum value: current time - 1h. Range requirement:… | | cooperator_id | string | no | The service provider ID | | page_no | integer | yes | The page number, starting from 1 | | page_size | integer | yes | The page size. Default value: 10. Maximum value: 100 | | x-acs-btrip-corp-token | string | no | The enterprise access token. This is a required header parameter for HTTP calls. For information about how to obtain it, refer to… | | bill_batch | string | no | The bill batch in the format yyyyMMdd | | scroll_id | string | no | The scroll ID. In scroll mode, pass the scroll ID returned from the previous query | | scroll_mod | string | no | Specifies whether to use scroll mode. Default value: false. Scroll mode bypasses the query limit. Otherwise, only one day of data can be… | | order_id | integer | no | The business travel order ID | | bill_record_time_start | string | no | The bill recording start time in the format yyyy-MM-dd or yyyy-MM-dd HH:mm:ss | | bill_record_time_end | string | no | The bill recording end time in the format yyyy-MM-dd or yyyy-MM-dd HH:mm:ss | | apply_id | string | no | The approval ID | ### Queries hotel billing data generated by a service provider enterprise within a specified time period `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/cooperator-hotel-bill-settlement-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | period_start | string | no | The start time for querying billing data. Format: `yyyy-MM-dd` or `yyyy-MM-dd HH:mm:ss` | | period_end | string | no | The end time for querying billing data. Format: `yyyy-MM-dd` or `yyyy-MM-dd HH:mm:ss`. Maximum value: current time - 1h. Range… | | cooperator_id | string | no | The service provider ID | | page_no | integer | yes | The page number, starting from 1 | | page_size | integer | yes | The page size. Default: 10. Maximum: 100 | | x-acs-btrip-corp-token | string | no | The enterprise access token. This is a required header parameter for HTTP calls. For information about how to obtain it, refer to… | | scroll_mod | string | no | Specifies whether to use scroll mode. Default: no. Scroll mode bypasses the query limit. Otherwise, only one day of data can be queried | | scroll_id | string | no | The scroll ID. In scroll mode, pass the scroll ID returned from the previous query | | bill_batch | string | no | The bill batch in the format yyyyMMdd | | order_id | integer | no | The business travel order ID | | bill_record_time_start | string | no | The bill recording start time in the format yyyy-MM-dd or yyyy-MM-dd HH:mm:ss | | bill_record_time_end | string | no | The bill recording end time in the format yyyy-MM-dd or yyyy-MM-dd HH:mm:ss | | apply_id | string | no | The approval ID | ### Pushes order events from the service provider to the Zhongzhou platform. Events are of two types:… `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/cooperator-hotel-event-push` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | string | yes | The order ID on the Zhongzhou platform | | cooperator_order_id | string | yes | The order ID of the service provider | | event_time | string | yes | The time when the event occurred. Format: yyyy-MM-dd HH:mm:ss | | event | string | yes | The event type | | event_desc | string | no | The description of the event | | change_order_status | integer | no | The order status after the change. Leave empty unless a special scenario applies | | change_order_status_desc | string | no | The description of the order status after the change | | x-acs-btrip-corp-token | string | no | The enterprise token | ### Pushes the personal payment result `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/cooperator-sync-pay-status` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | cooperator_pay_no | string | yes | The personal payment order number | | cooperator_order_id | string | yes | The service provider order number | | order_id | string | yes | The service provider order number | | pay_time | integer | yes | The payment time (UNIX timestamp) | | pay_status | string | yes | The payment status. Valid values: SUCCESS: Payment succeeded. | | x-acs-btrip-corp-token | string | no | The enterprise token | ### 获取关联可调用企业接口 `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/corp-auth-link-info-query` (byok) ### Retrieves a token that is used as an authorization credential when calling APIs to access enterprise data `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/corp-token` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | type | integer | yes | The enterprise type | | corp_id | string | yes | The enterprise agent ID, which is used to establish the bindingrelationship between the enterprise and the application. For information… | | x-acs-btrip-access-token | string | no | Deprecated. Use `app_secret` instead | | app_secret | string | no | Required. The API secret key of the application. For information about how to obtain it, refer to: Application Basic Information -… | ### Deletes a cost center `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/cost-center-delete` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | thirdpart_id | string | yes | The ID of the third-party cost center | | x-acs-btrip-so-corp-token | string | no | The header parameter obtained from the "Enterprise access credential" operation (added in the header). In HTTP mode, you can use… | ### Modifies a cost center `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/cost-center-modify` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | title | string | yes | The name of the cost center | | number | string | no | The number of the cost center | | alipay_no | string | no | The bound Alipay account | | thirdpart_id | string | yes | The third-party cost center ID | | scope | integer | yes | The scope of the cost center. Valid values: 1: all employees. 2: partial employees | | disable | integer | no | Specifies whether to disable the cost center. Valid values: 0: Not disabled. 1: Disabled | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation (added in the header). In HTTP mode, you can use… | ### Queries cost centers `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/cost-center-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | user_id | string | no | The third-party user ID | | thirdpart_id | string | no | The third-party cost center ID | | need_org_entity | string | no | Specifies whether to display member information. This parameter is returned when the cost center applies to partial members | | title | string | no | The cost center name | | disable | integer | no | Specifies whether the cost center is disabled. Valid values: 0: Not disabled. 1: Disabled. If this parameter is not specified, all data is… | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation (added in the header). In HTTP mode, you can use… | ### Synchronizes cost center data to Alibaba Business Travel `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/cost-center-save` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | title | string | yes | The name of the cost center | | number | string | no | The third-party cost center number | | alipay_no | string | no | The bound Alipay account | | thirdpart_id | string | yes | The third-party cost center ID | | scope | integer | yes | The applicable scope | | disable | integer | no | Specifies whether to disable the cost center. If this parameter is not specified, the cost center is enabled by default | | x-acs-btrip-so-corp-token | string | no | The enterprise access token. This is a required header parameter for HTTP calls. For information about how to obtain the token, refer to:… | ### Creates a custom enterprise role. After binding employees to the role, you can select employees in batches… `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/create-custom-role` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | role_id | string | yes | The custom role ID. This is the unique identifier of the role. Ensure that the value is unique for each request | | role_name | string | yes | The custom role name | | x-acs-btrip-corp-token | string | no | The enterprise access token. This is a required header parameter for HTTP calls. For information about how to obtain it, refer to:… | ### Creates a sub-enterprise for a group-type enterprise customer `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/create-sub-corp` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | user_id | string | yes | The employee ID that exists in an enterprise that has signed the Alibaba Business Travel Parent Account Agreement | | outer_corp_id | string | yes | The unique ID of the sub-enterprise created through this operation. Reusing this ID causes the call to fail | | outer_corp_name | string | yes | The unique name of the sub-enterprise created through this operation. Reusing this name causes the call to fail | | x-acs-btrip-corp-token | string | no | The enterprise access token. When calling this operation over HTTP, include this as a required parameter in the request URL. For… | ### Deletes a custom enterprise role `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/delete-custom-role` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | role_id | string | yes | The ID of the custom enterprise role | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise access token" operation. Add it to the header. In HTTP mode, you can use corp_token=value… | ### Deletes department information that has been maintained in Alibaba Business Travel `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/delete-department` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | out_dept_id | string | yes | The custom department ID defined by the enterprise. Ensure this parameter is correct. Otherwise, the wrong department may be deleted | | x-acs-btrip-corp-token | string | no | The enterprise access token. When calling the operation over HTTP, this parameter must be included in the request URL. For information… | ### Removes members in bulk from a custom enterprise role `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/delete-employees-from-custom-role` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | role_id | string | yes | The ID of the custom enterprise role | | user_id_list | string | yes | The list of member IDs. The maximum number of members per request is 500 (JSON-encoded) | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise access token" API (added in the header). In HTTP mode, you can use corp_token=value in… | ### Deletes applicable personnel from an invoice header `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/delete-invoice-entity` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | third_part_id | string | yes | The third-party invoice ID | | del_all | string | no | Specifies whether to delete all applicable personnel. If del_all is set to true, all entities under the invoice header are deleted and the… | | entities | string | no | The entity list. This parameter is required when del_all is set to false or null (JSON-encoded) | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation. Add it to the header. In HTTP mode, you can use… | ### This operation is no longer maintained. New enterprises should use the Create Enterprise Department, Modify… `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/department-save` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | depart_list | string | no | The list of request parameters (JSON-encoded) | | x-acs-btrip-so-corp-token | string | no | The enterprise access token. This is a required header parameter for HTTP calls. For information about how to obtain it, refer to… | ### Applies for electronic itinerary receipts in batches `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/electronic-itinerary-batch-apply` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | can_reprint | string | no | Specifies whether reprinting is allowed | | apply_itinerary_list | string | yes | The list of electronic itinerary receipt applications in the batch (JSON-encoded) | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the Enterprise Access Credential operation. Add it to the request header. In HTTP mode, you can use… | ### Retrieves the results of an electronic itinerary receipt application `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/electronic-itinerary-get-apply-result` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | batch_apply_no | string | yes | The batch number | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise Access Credential" interface (added in the header). In HTTP mode, you can use… | ### Adds personnel information to a cost center `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/entity-add` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | thirdpart_id | string | yes | The ID of the third-party cost center | | entity_d_o_list | string | no | The list of employee, department, or role information (JSON-encoded) | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the enterprise access credential operation. Add it to the request header. In HTTP mode, you can use… | ### Deletes personnel information from a cost center `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/entity-delete` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | thirdpart_id | string | yes | The ID of the third-party cost center | | del_all | string | yes | Specifies whether to delete all members | | entity_d_o_list | string | no | The list of members to delete. This parameter is not required when delAll is set to true (JSON-encoded) | | x-acs-btrip-so-corp-token | string | no | The header parameter obtained from the "Enterprise access credential" operation (added in the header). In HTTP mode, you can use… | ### Performs a full update of available employees for a cost center `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/entity-set` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | thirdpart_id | string | yes | The ID of the third-party cost center | | entity_d_o_list | string | no | The list of available scope entries (JSON-encoded) | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation (added in the header). In HTTP mode, you can use… | ### Queries the estimated price `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/estimated-price-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | itinerary_id | string | no | The itinerary ID. For internal enterprise applications, obtain this value by calling the list approval orders interface. For third-party… | | category | string | yes | The category. Valid values: flight: flight ticket hotel: hotel train: train | | start_time | integer | yes | The departure time. Unit: millisecond timestamp | | end_time | integer | yes | The return time. Unit: millisecond timestamp | | dep_city | string | yes | The departure city | | arr_city | string | yes | The destination city | | user_id | string | yes | The user ID | | sub_corp_id | string | no | The sub-enterprise corp ID | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" interface (added in the header). In HTTP mode, you can use… | ### Queries estimated prices (version 2.0) `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/estimated-price-query-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | biz_type | string | yes | The category | | depart_date | string | yes | The departure date | | leave_date | string | yes | The arrival date | | from_city | string | yes | The departure or check-in city | | to_city | string | yes | The arrival or check-out city | | user_id | string | no | The user ID. This parameter is required for the hotel category | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the enterprise access credential operation. Add it to the request header. In HTTP mode, you can use… | ### Synchronizes over-budget approval results to the business travel system `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/exceed-apply-sync` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | apply_id | integer | yes | The business travel over-budget approval order ID | | thirdparty_flow_id | string | no | The third-party process instance ID | | status | integer | yes | The approval order status. Valid values: 1: approved. 2: rejected | | user_id | string | yes | The third-party user ID of the approver. Separate multiple values with commas | | remark | string | no | The approval remarks | | biz_category | integer | no | The business type of the approval order. Valid values: 3: over-budget approval. 10: over-budget automatic order approval | | x-acs-btrip-so-corp-token | string | no | The enterprise access token. When calling the operation over HTTP, include this as a required parameter in the request URL. For… | ### Creates an external traveler and the associated certificate information `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/external-user-add` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | external_user_id | string | yes | The unique ID of the external traveler within the enterprise scope | | user_type | integer | yes | The user type | | real_name | string | no | The real name in Chinese | | real_name_en | string | no | The passport name in pinyin, in the format LastName/FirstName | | phone | string | no | The phone number. This parameter is required. For specific enterprises, contact the administrator to apply for an exemption | | email | string | no | The email address | | birthday | string | no | The date of birth in the format yyyy-MM-dd | | cert_request_list | string | no | The list of certificates (JSON-encoded) | | x-acs-btrip-corp-token | string | no | The token. Include it in the request header or append it to the URL as corp_token=xxxx | ### Deletes an external traveler `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/external-user-delete` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | external_user_id | string | yes | The ID of the external traveler, passed in through the path | | x-acs-btrip-corp-token | string | no | The token. Include it in the header or append corp_token=xxxx to the URL | ### Queries the basic information of an external traveler `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/external-user-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | external_user_id | string | yes | The ID of the external traveler | | x-acs-btrip-corp-token | string | no | The token. Include it in the header or append corp_token=xxxx to the URL | ### Modifies the information of an external traveler and their identity documents. Only the fields that are… `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/external-user-update` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | external_user_id | string | yes | The unique external traveler ID within the enterprise scope, passed through the path | | real_name | string | no | The Chinese real name | | real_name_en | string | no | The passport name in pinyin, in the format LastName/FirstName | | phone | string | no | The phone number | | email | string | no | The email address | | birthday | string | no | The date of birth in the format yyyy-MM-dd | | cert_request_list | string | no | The list of identity documents (JSON-encoded) | | x-acs-btrip-corp-token | string | no | The token. Place it in the header or append it to the URL as corp_token=xxxx | ### 查询机票记账数据 `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-bill-settlement-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | period_start | string | no | 记账更新日期起 yyyy-MM-dd | | period_end | string | no | 记账更新日期止 yyyy-MM-dd | | page_no | integer | yes | 分页页数（第几页） | | page_size | integer | yes | 分页数量（每页多少条） | | bill_batch | string | no | 账单批次，格式yyyyMMdd | | x-acs-btrip-so-corp-token | string | no | The x-acs-btrip-so-corp-token | | scroll_mod | string | no | The scroll_mod | | scroll_id | string | no | The scroll_id | | order_id | integer | no | 商旅订单号 | | bill_record_time_start | string | no | 账单入账时间开始 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss | | bill_record_time_end | string | no | 账单入账时间结束 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss | | apply_id | string | no | 审批单号 | ### Cancels a flight order `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-cancel-order` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dis_order_id | string | yes | The external order ID | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation. Add it to the request header. In HTTP mode, you can use… | ### Cancels a flight order `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-cancel-order-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | out_order_id | string | no | The external order ID | | order_id | string | no | The business travel order ID. Either the external order ID or the business travel order ID is required | | isv_name | string | yes | The custom channel name defined by the user | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise Access Credential" operation. Add this parameter to the request header | ### 航班订单创建 `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-create-order` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dep_city_code | string | yes | 出发城市编码 | | arr_city_code | string | yes | 到达城市编码 | | dep_airport_code | string | no | 出发机场编码 | | arr_airport_code | string | no | 到达机场编码 | | dep_date | string | yes | 出发日期 | | trip_type | integer | yes | 行程类型 | | price | integer | yes | 价格 | | contact_info | string | yes | 联系人 (JSON-encoded) | | traveler_info_list | string | yes | 乘机人列表 (JSON-encoded) | | order_params | string | yes | 预定下单加密参数 | | order_attr | string | no | 需要订单标记字段 (JSON-encoded) | | auto_pay | integer | no | 自动支付 | | receipt_target | integer | no | 1:个人，2：公司 | | receipt_title | string | no | 需要统一邮寄发票时，不能为空 | | receipt_address | string | no | 需要统一邮寄发票时，不能为空 | | ota_item_id | string | yes | 商品id | | dis_order_id | string | yes | 分销商订单id | | buyer_name | string | no | 买家姓名 | | buyer_unique_key | string | yes | 分销场景，外部渠道用户唯一标识 | | x-acs-btrip-corp-token | string | no | The x-acs-btrip-corp-token | ### Creates a flight order `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-create-order-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | async_create_order_mode | string | no | Specifies whether to use asynchronous order creation mode. If asynchronous order creation is used, only a key is returned before the final… | | async_create_order_key | string | no | The asynchronous order creation key | | out_order_id | string | yes | The external order ID | | travelers | string | yes | The list of passengers. This parameter is required (JSON-encoded) | | ota_item_id | string | yes | The quote item ID. This parameter is required | | contact_info | string | yes | The contact information (JSON-encoded) | | total_price_cent | integer | no | The total price. Unit: cents. If this parameter is not specified, the price is calculated from the quote item. If this parameter is… | | isv_name | string | yes | The user-defined channel name | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the enterprise access credential operation. Add this parameter to the request header | | btrip_user_id | string | no | The business travel user ID | | buyer_name | string | no | The buyer name | ### Queries the list of flight excess approval orders `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-exceed-apply-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | apply_id | integer | no | The ID of the business travel excess approval order | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation. Add this parameter to the request header. In HTTP mode, you… | | business_instance_id | string | no | The approval instance ID. You must specify either this parameter or apply_id | ### Queries the details of flight itinerary receipts `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-itinerary-scan-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | bill_date | string | no | The billing date. If the billing date is not specified, you must specify the order ID, itinerary receipt print serial number, or ticket… | | bill_id | integer | no | The bill ID. Deprecated | | invoice_sub_task_id | integer | no | The invoice subtask ID. Deprecated | | page_size | integer | no | The number of entries per page. Default value: 20. Maximum value: 100 | | page_no | integer | no | The page number. Pages start from page 1 | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" interface (added in the header). In HTTP mode, you can use… | | ticket_no | string | no | The ticket number | | itinerary_num | string | no | The itinerary receipt print serial number | | order_id | integer | no | The order ID | | invoice_date_start | string | no | The start time of the invoice issuance period. Format: yyyy-MM-dd HH:mm:ss. If this parameter is specified, invoice_date_end must also be… | | invoice_date_end | string | no | The end time of the invoice issuance period. Format: yyyy-MM-dd HH:mm:ss. If this parameter is specified, invoice_date_start must also be… | ### Queries the flight list `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-listing-search` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dep_city_code | string | yes | The three-letter code of the departure city | | arr_city_code | string | yes | The three-letter code of the arrival city | | dep_date | string | yes | The departure time | | airline_code | string | no | The two-letter code of the airline | | cabin_class | string | no | The cabin class. Valid values: 0: all cabin classes 1: economy class 2: business class | | x-acs-btrip-corp-token | string | no | The enterprise access credential. When calling this operation over HTTP, this parameter is required and must be appended to the request… | ### Searches for a list of available flights `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-listing-search-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | need_multi_class_price | string | no | Specifies whether to query multi-cabin prices (aggregated OTA search). Default value: FALSE. Deprecated | | need_y_c_best_price | string | no | Specifies whether to separately query the lowest prices for Y (economy) and C (business) cabins. Default value: FALSE. Specifies whether… | | need_query_service_fee | string | no | Specifies whether to query service fees. Default value: TRUE. Deprecated | | airline_code | string | no | The two-letter IATA airline code | | search_journeys | string | yes | The search journeys (JSON-encoded) | | trip_type | integer | yes | The trip type | | search_mode | integer | yes | The search mode. Search mode: For one-way search: pass 0 (outbound). For round-trip outbound search: pass 0 (outbound). For round-trip… | | cabin_type_list | string | no | The cabin class type for search. Default value: 0 (ALL_CABIN, all cabins). Although the parameter structure is a list, only a single cabin… | | need_share_flight | string | no | Specifies whether to include codeshare flights. Default value: TRUE | | direct_only | string | no | Specifies whether to show only direct flights. Default value: TRUE | | isv_name | string | yes | The user-defined channel name | | x-acs-btrip-corp-token | string | no | The enterprise access token. When calling this operation over HTTP, this parameter is required and must be appended to the request URL.… | ### Submits a flight ticket change request `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-modify-apply-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | integer | no | The business travel order ID (sales order ID) | | out_order_id | string | no | The external order ID for distribution | | out_sub_order_id | string | no | The external sub-order ID for distribution | | session_id | string | no | sessionId | | voluntary | string | no | Specifies whether the change is voluntary | | reason | string | no | The reason for the ticket change | | passenger_segment_relations | string | no | The passenger-segment relations. Required at the passenger-segment level (JSON-encoded) | | item_id | string | no | The item ID | | contact_phone | string | no | The contact phone number. Sending change notification SMS to the contact phone number specified in the change order is not currently… | | cache_key | string | no | The cached data key | | isv_name | string | no | The user-defined channel name | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" API. Add this parameter to the request header | ### Cancels a flight rebooking order `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-modify-cancel-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | integer | no | The business travel order ID | | out_order_id | string | no | The distribution external order ID | | sub_order_id | integer | no | The business travel sub-order ID (rebooking sales order ID) | | out_sub_order_id | string | no | The distribution external sub-order ID (rebooking) | | isv_name | string | no | The custom channel name | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation. Add this parameter to the request header | ### Searches the flight change list `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-modify-listing-search-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | integer | no | The business travel order ID (sales order ID) | | out_order_id | string | no | The external order ID | | dep_date | string | no | The intended departure date for the flight change (JSON-encoded) | | passenger_segment_relations | string | no | The passenger-segment relations. Required at the passenger-segment level (JSON-encoded) | | cabin_class | string | no | The cabin class. This parameter is deprecated. Currently only the lowest price is returned (JSON-encoded) | | voluntary | string | no | Specifies whether the change is voluntary | | search_mode | integer | no | The search mode | | session_id | string | no | The session ID. This parameter is optional | | selected_segments | string | no | The flight information that the user has selected during the search. For round trips: has a value when searching for the return leg. For… | | isv_name | string | no | The user-defined channel name | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise Access Credential" operation. Include this in the request header | | interface_caller_is_support_retry | string | no | Specifies whether the caller supports retry. true: The caller supports retry. When the operation requires a retry, the response returns… | | search_retry_token | string | no | The search retry token | ### Queries the details of a flight change order `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-modify-order-detail-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | string | no | The business travel order ID. Either the external order ID or the business travel order ID is required | | out_order_id | string | no | The external order ID | | modify_apply_id | string | no | The business travel change order ID. Either the business travel change order ID or the external change order ID is required | | out_modify_apply_id | string | no | The external change order ID | | need_query_service_fee | string | no | Specifies whether to query the service fee. This parameter is optional | | isv_name | string | no | The custom channel name defined by the user | | x-acs-btrip-corp-token | string | no | The enterprise access credential. When calling this operation over HTTP, this parameter is required and must be appended to the request… | ### Searches for flight change quotation prices `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-modify-ota-search-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | integer | no | The business travel order ID (sales order ID) | | out_order_id | string | no | The external order ID | | dep_date | string | no | The intended departure date for the flight change (JSON-encoded) | | passenger_segment_relations | string | no | The passenger-segment relations. Required at the passenger-segment level (JSON-encoded) | | cabin_class | string | no | The cabin class. This parameter is deprecated. Currently only the lowest price is returned (JSON-encoded) | | voluntary | string | no | Specifies whether the change is voluntary | | session_id | string | no | The session ID. This parameter is required | | selected_segments | string | no | The flight information selected by the user during search. This parameter is required (JSON-encoded) | | isv_name | string | no | The user-defined channel name | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise Access Credential" operation. Add this parameter to the request header | ### Pays for a flight ticket change `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-modify-pay-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | integer | no | The business travel order ID | | out_order_id | string | no | The distribution external order ID | | sub_order_id | integer | no | The business travel sub-order ID (change sales order ID) | | out_sub_order_id | string | no | The distribution external sub-order ID for the ticket change | | modify_pay_amount | integer | no | The payment amount for the ticket change | | ext_params | string | no | The payment extension fields (JSON-encoded) | | isv_name | string | no | The user-defined channel name | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the enterprise access credential operation. Add this parameter to the request header | ### 航班订单明细信息 `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-order-detail-info` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dis_order_id | string | yes | 分销外部订单号 | | x-acs-btrip-corp-token | string | no | The x-acs-btrip-corp-token | ### Queries the details of a flight order `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-order-detail-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | out_order_id | string | no | The external order ID | | order_id | integer | no | The business travel order ID. Either the external order ID or the business travel order ID is required | | isv_name | string | yes | The user-defined channel name | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the enterprise access credential operation. Include this parameter in the request header | ### Queries the list of flight orders `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-order-list-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | user_id | string | no | The third-party user ID | | depart_id | string | no | The ID of the department to which the user belongs | | start_time | string | no | The start time. The time must be in the yyyy-MM-dd HH:mm:ss format | | end_time | string | no | The end time. The time must be in the yyyy-MM-dd HH:mm:ss format | | update_start_time | string | no | The update start time. The time must be in the yyyy-MM-dd HH:mm:ss format | | update_end_time | string | no | The update end time. The time must be in the yyyy-MM-dd HH:mm:ss format | | page | integer | no | The page number | | page_size | integer | no | The number of entries per page. Default value: 10. Maximum value: 50 | | apply_id | integer | no | The business travel approval ID | | thirdpart_apply_id | string | no | The third-party application ID | | all_apply | string | no | false: searches for unreimbursed orders | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the enterprise access credential operation. Add it to the header. In HTTP mode, you can use… | ### Queries the list of domestic flight orders for a specified enterprise `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-order-list-query-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | booker_id | string | no | The list of booker IDs (JSON-encoded) | | depart_id | string | no | The list of booker department IDs (JSON-encoded) | | start_date | string | no | The start time of the order booking period. The time parameter must be in the yyyy-MM-dd HH:mm:ss string format. | | end_date | string | no | The end time of the order booking period. The time parameter must be in the yyyy-MM-dd HH:mm:ss string format. | | update_start_date | string | no | The start time of the order update period. The time parameter must be in the yyyy-MM-dd HH:mm:ss string format. | | update_end_date | string | no | The end time of the order update period. The time parameter must be in the yyyy-MM-dd HH:mm:ss string format. | | approve_id | string | no | The list of business travel approval IDs (JSON-encoded) | | thirdpart_approve_id | string | no | The list of third-party approval IDs (JSON-encoded) | | supplier | string | no | The list of supplier names (JSON-encoded) | | page_Size | integer | no | The page size | | scroll_id | string | no | The scroll ID | | x-acs-btrip-corp-token | string | no | The enterprise access credential. When calling this operation over HTTP, this parameter is required and must be appended to the request… | ### Queries the details of a flight order, including ticket information `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-order-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | integer | yes | The order ID | | user_id | string | no | The third-party user ID | | x-acs-btrip-so-corp-token | string | no | The enterprise access credential. When calling this API over HTTP, this parameter must be included as a required parameter in the request… | ### Queries refund/change rules and baggage allowance `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-ota-item-detail` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | ota_item_id | string | yes | The product ID. If querying a rebooking product, pass in the rebooking product otaItemId.> | | isv_name | string | yes | The user-defined channel name | | order_id | string | no | The business travel order ID. Either the external order ID or the business travel order ID is required. Pass in this parameter when… | | out_order_id | string | no | The external order ID. Pass in this parameter when querying refund/change and baggage rules for a rebooking product. The rules may not be… | | x-acs-btrip-corp-token | string | no | The enterprise access credential. When calling this operation over HTTP, this parameter is required and must be appended to the request… | ### Searches for the lowest-price flights `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-ota-search` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dep_city_code | string | yes | The three-letter code of the departure city | | arr_city_code | string | yes | The three-letter code of the arrival city | | dep_date | string | yes | The departure time | | flight_no | string | yes | The flight number | | carrier_flight_no | string | no | The operating flight number | | airline_code | string | no | The two-letter code of the airline | | cabin_class | string | no | The cabin class | | x-acs-btrip-corp-token | string | no | The enterprise access token. When calling this API over HTTP, this parameter is required and must be appended to the request URL. For… | ### Searches for fare quotes for a single flight `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-ota-search-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | search_journeys | string | yes | The search journeys (JSON-encoded) | | trip_type | integer | yes | The trip type | | search_mode | integer | yes | The search mode | | cabin_type_list | string | no | The cabin type for search. Default value: ALL_CABIN (all cabins). Although the parameter structure is a list, only a single cabin type is… | | need_share_flight | string | no | Specifies whether codeshare flights are needed. Default value: TRUE | | direct_only | string | no | Specifies whether to show only direct flights. Default value: TRUE | | isv_name | string | yes | The user-defined channel name | | x-acs-btrip-corp-token | string | no | A header parameter. Obtained from the "Enterprise Access Credential" operation (added in the header) | ### 航班订单支付 `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-pay-order` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dis_order_id | string | yes | 分销外部订单号 | | total_pay_price | integer | yes | 订单支付总金额 | | corp_pay_price | integer | yes | 企业支付金额 | | personal_pay_price | integer | yes | 个人支付金额 | | extra | string | no | 扩展信息 (JSON-encoded) | | x-acs-btrip-corp-token | string | no | The x-acs-btrip-corp-token | ### Pays for a flight order `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-pay-order-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | string | no | The business travel order ID. Either the external order ID or the business travel order ID is required | | out_order_id | string | no | The external order ID | | total_price | integer | no | The total ticket price, excluding service fees | | total_service_fee_price | integer | no | The total service fee. Unit: cents | | isv_name | string | no | The custom channel name defined by the user | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the enterprise access credential operation. Add this parameter to the request header | ### 航班退票申请 `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-refund-apply` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dis_order_id | string | yes | 分销外部订单号 | | dis_sub_order_id | string | yes | 分销外部订单号 | | passenger_segment_info_list | string | no | 选择的要退票的乘客航段列表 (JSON-encoded) | | is_voluntary | integer | yes | 是否自愿:0自愿，1非自愿F | | reason_type | integer | yes | 退票原因类型(1：自愿退票（我要改变行程计划、我不想飞）；2：自愿退票（填错名字、选错日期、选错航班）；3：自愿退票（没赶上飞机、证件忘带了）；4：自愿退票（生病了无法乘机（无二甲医院证明））；5：自愿退票（其他）；6：非自愿退票（航班延误或取消、航班时刻变更等航司原因）；7：… | | refund_voucher_info | string | no | 退票上传凭证信息(json格式) (JSON-encoded) | | reason_detail | string | no | 退票原因 | | total_refund_price | integer | no | 订单退款总金额 | | corp_refund_price | integer | no | 企业退款金额 | | personal_refund_price | integer | no | 个人退款金额 | | extra | string | no | 扩展信息 (JSON-encoded) | | item_unit_ids | string | yes | The item_unit_ids | | display_refund_money | string | yes | The display_refund_money | | session_id | string | yes | The session_id | | x-acs-btrip-corp-token | string | no | The x-acs-btrip-corp-token | ### Submits a flight ticket refund request `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-refund-apply-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | string | no | The business travel order ID. Either the external order ID or the business travel order ID is required | | out_order_id | string | no | The distribution external order ID | | out_sub_order_id | string | no | The distribution external sub-order ID | | refund_reason_type | integer | no | The refund reason type. This parameter is required. Valid values: 1: Involuntary request (force majeure). 2: Change of travel plan or no… | | refund_reason | string | no | The refund reason description. This parameter is required | | voluntary | string | no | Specifies whether the refund is voluntary. This parameter is required | | pre_cal_type | integer | no | The refund dimension. This parameter is required. Valid values: 1: Ticket number dimension. 2: Passenger-segment dimension | | ticket_nos | string | no | The ticket numbers to refund. This parameter is required when the refund dimension is ticket number (JSON-encoded) | | passenger_segment_relations | string | no | The passenger-segment relations. This parameter is required when the refund dimension is passenger-segment (JSON-encoded) | | total_refund_price | integer | no | The pre-calculated refund amount. This parameter is required after successful pre-calculation | | upload_pict_urls | string | no | The refund attachment URLs | | isv_name | string | no | The user-defined channel name | | x-acs-btrip-corp-token | string | no | A header parameter. Obtained from the "Enterprise Access Credential" operation and included in the request header | ### 航班退票详情 `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-refund-detail` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dis_order_id | string | yes | 分销外部订单号 | | dis_sub_order_id | string | yes | 子订单号 | | x-acs-btrip-corp-token | string | no | The x-acs-btrip-corp-token | ### Queries the details of a flight ticket refund `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-refund-detail-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | string | no | The business travel order ID. Either the business travel order ID or the external order ID is required | | out_order_id | string | no | The distribution external order ID | | refund_apply_id | string | no | The business travel refund order ID. Either the business travel refund order ID or the external refund order ID is required | | out_refund_apply_id | string | no | The external refund order ID | | isv_name | string | no | The custom channel name | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation. Add this parameter to the request header | ### 机票退票预计算 `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-refund-pre-cal` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dis_order_id | string | yes | 分销外部订单号 | | passenger_segment_info_list | string | yes | 选择的要退票的乘客航段列表 (JSON-encoded) | | x-acs-btrip-corp-token | string | no | The x-acs-btrip-corp-token | | is_voluntary | string | no | The is_voluntary | ### Pre-calculates flight ticket refund fees `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-refund-pre-cal-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | string | no | The business travel order ID. Either the external order ID or the business travel order ID is required | | out_order_id | string | no | The external order ID | | pre_cal_type | integer | no | The refund dimension. This parameter is required. Valid values: 1: ticket number dimension. 2: passenger-segment dimension | | ticket_nos | string | no | The ticket numbers to be refunded. This parameter is required when the refund dimension is set to ticket number (JSON-encoded) | | passenger_segment_relations | string | no | The passenger-segment relations. This parameter is required when the refund dimension is set to passenger-segment (JSON-encoded) | | voluntary | string | no | Specifies whether the refund is voluntary. This parameter is required | | isv_name | string | no | The user-defined channel name | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the enterprise access credential operation. Add this parameter to the request header | ### Searches for a list of available flights `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/flight-search-list` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dep_city_code | string | yes | The three-letter code of the departure city | | arr_city_code | string | yes | The three-letter code of the arrival city | | trip_type | string | yes | The trip type | | dep_date | string | yes | The departure date | | arr_date | string | no | The return date | | airline_code | string | no | The two-letter code of the airline | | cabin_class | string | no | The cabin class | | dep_city_name | string | no | The departure city | | arr_city_name | string | no | The arrival city | | flight_no | string | no | The flight number. Optional | | transfer_flight_no | string | no | The transfer flight number (second leg). Optional | | transfer_city_code | string | no | The three-letter code of the transfer city. Optional. Required if the transfer flight number is specified | | transfer_leave_date | string | no | The departure time of the transfer flight. Optional. Required if the transfer flight number is specified | | need_multi_class_price | string | no | Specifies whether to query multi-cabin prices. Optional | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation (added in the header). In HTTP mode, you can use… | ### Queries the Fudou (reward points) billing data generated by a specified enterprise within a specific time… `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/fu-point-bill-settlement-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | period_start | string | no | The billing update start date in the format yyyy-MM-dd | | period_end | string | no | The billing update end date in the format yyyy-MM-dd | | cooperator_id | string | no | The service provider ID | | bill_batch | string | no | The bill batch in the format yyyyMMdd | | page_no | integer | yes | The page number to return | | page_size | integer | yes | The number of entries per page | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise Access Token" operation (added in the header). In HTTP mode, you can use… | | scroll_id | string | no | The scroll ID. In scroll mode, pass in the scroll ID returned from the previous query | | scroll_mod | string | no | Specifies whether to use scroll mode. Default value: false. Scroll mode bypasses the query limit. Otherwise, only one day of data can be… | | order_id | integer | no | The business travel order ID | | bill_record_time_start | string | no | The bill recording start time in the format yyyy-MM-dd or yyyy-MM-dd HH:mm:ss | | bill_record_time_end | string | no | The bill recording end time in the format yyyy-MM-dd or yyyy-MM-dd HH:mm:ss | | apply_id | string | no | The approval ID | ### Retrieves a token for a group enterprise to use as an authorization credential when calling APIs to access… `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/group-corp-token` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | corp_id | string | yes | The enterprise proxy ID, which is used to establish the bindingrelationship between the enterprise and the application. For information… | | sub_corp_id | string | yes | The subsidiary enterprise ID. View permission: Only enterprise administrators have view permission. View path: Log on to the Enterprise… | | app_secret | string | yes | The API call secret key of the application. For information about how to obtain it, refer to Application Basic Information - Application… | | x-acs-btrip-access-token | string | no | The application credential, which is one of the header parameters in the HTTP method. Deprecated. Use the `app_secret` field instead | ### Synchronizes department information to a group enterprise (parent/subsidiary enterprises) `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/group-depart-save` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | outer_dept_id | string | yes | The department ID. The default root department ID in Alibaba Business Travel is 1. Do not use this value when passing parameters to avoid… | | dept_name | string | yes | The department name | | outer_dept_pid | string | no | The parent department ID. The default root department ID in Alibaba Business Travel is 1. Do not use this value when passing parameters to… | | status | integer | yes | Specifies whether the department is active. Valid values: 0: Active. 1: Inactive | | manager_ids | string | no | The department manager ID. If the department has multiple managers, pass the values in the format `[manager1/manager2/manager3]` | | sub_corp_id_list | string | no | The list of enterprise IDs to which the department belongs. Required parameter (JSON-encoded) | | sync_group | string | no | Deprecated. No input required | | x-acs-btrip-corp-token | string | no | The enterprise access token. When calling this operation over HTTP, include this as a required parameter in the request URL. For… | ### Synchronizes employee information to a specified group enterprise (parent or subsidiary) `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/group-user-save` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | user_id | string | yes | The employee ID | | user_name | string | yes | The employee name | | real_name_en | string | no | The English name. Use "/" as a separator with no spaces. Format: last_name/first_name | | job_no | string | no | The employee number | | phone | string | no | The mobile phone number | | sub_corp_id_list | string | yes | The list of affiliated enterprises (JSON-encoded) | | base_city_code | string | no | The 6-digit administrative code. A maximum of two codes are supported, separated by commas (,) | | birthday | string | no | The date of birth in the format yyyy-MM-dd | | gender | string | no | The gender. Valid values: F: female. M: male | | cert_list | string | no | The list of certificates (JSON-encoded) | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise access credential" operation. Add it to the request header. In HTTP mode, you can use… | ### Queries the cached price information for a specified hotel within the check-in and check-out dates `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-asking-price` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | city_code | string | no | The city code | | shids | string | yes | The hotel IDs for filtering. A maximum of 20 IDs per page are supported (JSON-encoded) | | city_name | string | no | The city name | | check_in_date | string | yes | The check-in date in the format of YYYY-MM-DD HH:mm:ss | | check_out_date | string | yes | The check-out date in the format of YYYY-MM-DD HH:mm:ss | | sort_code | integer | no | The sort method | | dir | integer | no | The sort direction | | is_protocol | string | no | Specifies whether to query only contracted hotels | | hotel_star | string | no | The list of star ratings for filtering | | adult_num | string | no | The number of adults | | payment_type | integer | no | The payment method. Valid values: 0: enterprise payment. 1: personal payment | | btrip_user_id | string | no | The user ID. If organization members are synchronized, use btripUserId. Otherwise, pass the userId corresponding to the distributor's own… | | x-acs-btrip-corp-token | string | no | The enterprise token | ### 查询酒店记账数据 `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-bill-settlement-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | period_start | string | no | 记账更新日期起 yyyy-MM-dd | | period_end | string | no | 记账更新日期止 yyyy-MM-dd | | page_no | integer | yes | 分页页数（第几页） | | page_size | integer | yes | 分页数量（每页多少条） | | x-acs-btrip-so-corp-token | string | no | The x-acs-btrip-so-corp-token | | bill_batch | string | no | 账单批次，yyyyMMdd | | scroll_mod | string | no | The scroll_mod | | scroll_id | string | no | The scroll_id | | order_id | integer | no | 商旅订单号 | | bill_record_time_start | string | no | 账单入账时间开始 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss | | bill_record_time_end | string | no | 账单入账时间结束 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss | | apply_id | string | no | 审批单号 | ### Retrieves the list of hotel cities `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-city-code-list` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | country_code | string | no | The two-letter country code. This parameter does not need to be specified | | x-acs-btrip-corp-token | string | no | The enterprise token | ### Queries the details of a hotel policy-violation approval `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-exceed-apply-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | apply_id | integer | no | The ID of the business travel policy-violation approval | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the "Enterprise Access Credential" operation. Add it to the request header. In HTTP mode, you can use… | | business_instance_id | string | no | The approval instance ID. Either this parameter or apply_id is required | ### Retrieves real-time hotel pricing information `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-goods-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | begin_date | string | yes | The start date in yyyy-MM-dd format | | end_date | string | yes | The end date in yyyy-MM-dd format. The maximum span between check-in and check-out dates per query is 30 days | | adult_num | string | no | The number of adults | | city_code | string | no | The city code. This parameter is optional | | hotel_id | string | yes | The hotel code | | payment_type | integer | no | The payment method. Valid values: 0: corporate payment. 1: personal payment | | special_invoice | string | no | Specifies whether special VAT invoices are available | | agreement_price | string | no | Specifies whether the price is a negotiated rate | | breakfast_included | string | no | Specifies whether breakfast is included | | super_man | integer | no | The role type. Valid values: 0: regular user. 1: special applicant | | pay_over_type | integer | no | Specifies whether mixed payment is supported. Valid values: 0: Supported. 1: Not supported | | btrip_user_id | string | yes | The user ID. If organization members are synchronized, use btripUserId. Otherwise, pass the userId corresponding to the distributor's own… | | x-acs-btrip-corp-token | string | no | The enterprise token | | need_clock_room_product | string | no | 是否需要小时房 | | need_full_day_room | string | no | 是否需要全日房 | ### Retrieves hotel IDs `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-index-info` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | page_size | integer | yes | The page size | | city_code | string | no | The city ID | | page_token | string | no | The pagination token. Leave this parameter empty for the first request. For subsequent requests, pass in the page_token returned from the… | | hotel_status | integer | no | The hotel status | | x-acs-btrip-corp-token | string | no | The enterprise token | | internation | string | no | Specifies whether to retrieve international hotel IDs. Valid values: true: international hotels. false: domestic hotels. Set this… | ### Cancels a hotel order `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-order-cancel` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dis_order_id | string | no | The distributor order ID | | btrip_order_id | string | no | The supplier order ID, which is returned when the order is created | | x-acs-btrip-corp-token | string | no | The enterprise token | ### Submits a modification request for a hotel order `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-order-change-apply` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dis_order_id | string | yes | The distributor order ID | | sale_order_id | string | yes | The order ID | | reason | string | yes | The reason for the order modification | | room_info_list | string | yes | The list of rooms to be modified (JSON-encoded) | | btrip_user_id | string | no | The external user ID. If organization members have been synchronized, use btripUserId. Otherwise, pass the userId corresponding to the… | | x-acs-btrip-corp-token | string | no | The enterprise token | ### Queries the details of a hotel order modification `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-order-change-detail` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | change_order_id | string | no | The change order ID | | dis_order_id | string | no | The distributor order ID | | sale_order_id | string | no | The sales order ID | | btrip_user_id | string | no | The external user ID. If organization members are synchronized, use btripUserId. Otherwise, pass the userId corresponding to the user in… | | x-acs-btrip-corp-token | string | no | The enterprise token | ### Creates a hotel order for distribution users `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-order-create` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dis_order_id | string | yes | The distributor order ID. Regardless of whether the order is created successfully, the distributor order ID is recorded. Do not use the… | | itinerary_no | string | yes | The btrip itinerary ID | | rate_plan_id | integer | yes | The rate plan ID | | room_num | integer | yes | The number of rooms | | check_in | string | yes | The check-in date | | check_out | string | yes | The check-out date | | item_id | integer | yes | The item ID | | seller_id | integer | yes | The seller ID | | shid | integer | yes | The standard hotel ID | | room_id | integer | yes | The room ID | | total_order_price | integer | yes | The total order price. Unit: cents | | corp_pay_price | integer | yes | The corporate payment amount. Unit: cents | | person_pay_price | integer | yes | The personal payment amount. Unit: cents | | contract_phone | string | yes | The contact person's mobile phone number | | contract_name | string | no | The contact person's name | | contract_email | string | no | The contact person's email address. This parameter is required if the need_email parameter returned by the pre-order validation operation… | | occupant_info_list | string | yes | The occupant information. The number of occupants cannot exceed the number specified during price validation. A maximum of two occupants… | | invoice_info | string | no | The invoice information (JSON-encoded) | | promotion_info | string | no | The promotion information (JSON-encoded) | | extra | string | no | The extended information in JSON format | | member_info | string | no | The GDS membership card information (JSON-encoded) | | validate_res_key | string | yes | The validation result | | btrip_user_id | string | yes | The external user ID. If organization personnel synchronization is enabled, use the btripUserId. Otherwise, pass the userId corresponding… | | x-acs-btrip-corp-token | string | no | The enterprise token | | rp_type | integer | no | The rp_type | | arrival_time | string | no | The arrival_time | | leave_time | string | no | The leave_time | ### Queries the details of a hotel order for distribution users `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-order-detail-info` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | dis_order_id | string | no | The distributor order ID | | btrip_order_id | string | no | The supplier order ID (obtained from the order ID returned during order creation) | | x-acs-btrip-corp-token | string | no | The enterprise token | ### Queries the details of a self-operated hotel order `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-order-info-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | string | yes | The unique identifier of the hotel business order, that is, the order ID | | x-acs-btrip-corp-token | string | no | A header parameter obtained from the "Enterprise Access Credential" operation (added in the header). In HTTP mode, you can use… | ### Queries the list of hotel orders `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-order-list-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | user_id | string | no | The third-party user ID | | depart_id | string | no | The ID of the department to which the user belongs | | start_time | string | no | The start time. The time must be in the yyyy-MM-dd HH:mm:ss format | | end_time | string | no | The end time. The time must be in the yyyy-MM-dd HH:mm:ss format | | update_start_time | string | no | The start time of the update range. The time must be in the yyyy-MM-dd HH:mm:ss format | | update_end_time | string | no | The end time of the update range. The time must be in the yyyy-MM-dd HH:mm:ss format | | page | integer | no | The page number. Default value: 1 | | page_size | integer | no | The number of entries per page. Default value: 10. Maximum value: 50 | | apply_id | integer | no | The business travel approval ID | | thirdpart_apply_id | string | no | The third-party application ID | | all_apply | string | no | false: searches for unreimbursed orders | | x-acs-btrip-so-corp-token | string | no | A header parameter obtained from the Enterprise Access Credential operation. Add this parameter to the request header. In HTTP mode, you… | | category | integer | no | The category code | ### Pays for a hotel order `POST https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-order-pay` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | btrip_order_id | integer | yes | The supplier order ID, which is returned from the order creation operation | | total_price | integer | yes | The total room price excluding service fees. Unit: cents | | company_pay_fee | integer | yes | The enterprise payment amount. Unit: cents | | person_pay_fee | integer | yes | The personal payment amount. Unit: cents. You do not need to specify this field. If you need to use this field, contact the integration… | | third_pay_account | string | no | The third-party payment account. You do not need to specify this field. If you need to use this field, contact the integration helpdesk | | third_trade_no | string | no | The third-party transaction number. You do not need to specify this field. If you need to use this field, contact the integration helpdesk | | x-acs-btrip-corp-token | string | no | The enterprise token | | btrip_user_id | string | yes | The user ID. If organization members are synchronized, use the btripUserId. Otherwise, specify the userId that corresponds to the user in… | ### Retrieves hotel pre-order validation information `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-order-pre-validate` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | seller_id | integer | yes | The seller ID | | rate_plan_id | integer | yes | The rp_Id passed through from the rate query API | | room_num | integer | yes | The number of rooms | | number_of_adults_per_room | integer | no | The number of adults per room. The number must be consistent with the number specified when placing the order, or must not be less than… | | check_in | string | yes | The check-in date | | check_out | string | yes | The check-out date | | shid | integer | yes | The standard hotel ID | | room_id | integer | yes | The room ID | | item_id | integer | yes | The item ID | | rate_key | string | no | The rate key identifier for non-persisted items | | search_room_price | integer | yes | The total room price passed through from the rate query API, in cents. For multiple room nights, pass in the sum of last_discounts_price… | | daily_list | string | yes | The daily prices (JSON-encoded) | | occupant_info_list | string | no | The occupant information (JSON-encoded) | | btrip_user_id | string | yes | The external user ID. If organization personnel synchronization is enabled, use btripUserId. Otherwise, pass the userId corresponding to… | | x-acs-btrip-corp-token | string | no | The enterprise token | | rp_type | integer | no | The room type, which distinguishes between full-day rooms and hourly rooms. If not specified, the default is full-day room. Valid values:… | ### Queries the details of a hotel order `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-order-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | integer | yes | The order ID | | x-acs-btrip-so-corp-token | string | no | The enterprise access token obtained from the enterprise access token operation. Add this token to the request header. In HTTP mode, you… | ### Retrieves hotel pricing data for distributors to display on their landing pages `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-price-pull` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | city_code | integer | no | The city code | | hotel_ids | string | no | The list of hotel codes (JSON-encoded) | | check_in | string | no | The check-in date | | check_out | string | no | The check-out date | | payment_type | integer | no | The payment method | | btrip_user_id | string | no | The user ID. If organization members are synchronized, use btripUserId. Otherwise, pass the userId corresponding to the user in the… | | x-acs-btrip-corp-token | string | no | The enterprise token | ### Retrieves hotel room type information from the interface list `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-room-info` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | room_ids | string | yes | The list of room type IDs (JSON-encoded) | | x-acs-btrip-corp-token | string | no | The enterprise token | ### Queries the starting price information of hotels that match the specified check-in and check-out dates and… `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-search` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | city_code | string | no | The city code. Obtained from the basic city data in the travel approval. Required for international hotels | | shids | string | no | The list of hotel IDs. Maximum: 20 (JSON-encoded) | | district_code | string | no | The district code | | check_in_date | string | yes | The check-in date in the format of yyyy-MM-dd | | check_out_date | string | yes | The check-out date in the format of yyyy-MM-dd | | sort_code | integer | yes | The sort method. Valid values: 0: default 1: lowest price first 2: highest price first 3: nearest distance first 4: highest rating first | | dir | integer | no | The sort direction. This filter is not available for international hotels. Valid values: 0: descending 1: ascending | | page_no | integer | yes | The page number. Default value: 1 | | page_size | integer | yes | The number of entries per page. Maximum value: 20 | | key_words | string | no | The keywords for keyword-based search | | min_price | number | no | The minimum price. Unit: CNY | | max_price | number | no | The maximum price. Unit: CNY | | is_protocol | string | no | Specifies whether to query only protocol hotels | | hotel_star | string | no | The list of star ratings to filter by | | adult_num | string | no | The number of adults | | brand_code | string | no | The list of brand codes to filter by (JSON-encoded) | | location | string | no | The coordinates (AMAP). Longitude comes first, followed by latitude | | distance | integer | no | The search distance range. Unit: meters | | super_man | integer | no | The role. 0 indicates a regular user. 1 indicates a special applicant | | pay_over_type | integer | no | Specifies whether mixed payment is supported. 0: supported. 1: not supported | | payment_type | integer | no | The payment method. 0: corporate payment. 1: personal payment | | btrip_user_id | string | no | The user ID. If organization personnel synchronization is enabled, use btripUserId. Otherwise, pass the userId corresponding to the… | | x-acs-btrip-corp-token | string | no | The enterprise token | | poi | string | no | The poi | | room_type | integer | no | 入住类型 0：全日房，1：小时房，默认 0 | ### Retrieves the full static data of hotels `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-static-info` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hotel_ids | string | yes | The list of hotel IDs (JSON-encoded) | | x-acs-btrip-corp-token | string | no | The enterprise token | ### Searches for cities, hotels, and popular keywords `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/hotel-suggest-v2` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | city_code | string | no | The city code | | keyword | string | no | The keyword. Required when search_type is set to 0 | | check_in | string | no | The hotel check-in date in the format yyyy-MM-dd | | check_out | string | no | The hotel check-out date in the format yyyy-MM-dd | | search_type | integer | yes | The search type | | btrip_user_id | string | no | The external user ID. If organization members are synchronized, use btripUserId. Otherwise, pass the userId corresponding to the… | | x-acs-btrip-corp-token | string | no | The enterprise token | ### Queries the details of an international flight order `GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/iflight-order-detail-query` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | order_id | integer | yes | The order ID | | x-acs-btrip-corp-token | string | no | The enterprise access credential. When calling this API over HTTP, this parameter is required and must be appended to the request URL. For… | …and 115 more. See the OpenAPI spec. ## Example ``` curl "https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/access-token" \ -H "x-api-key: $APIZIE_KEY" \ -H "x-upstream-key: $PROVIDER_KEY" ``` ## FAQ ### How do I call the Alibaba Cloud btripOpen API? Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/cloud:aliyun-btripopen/access-token with the header x-api-key. Every endpoint returns { project, data, timestamp }. ### Is the Alibaba Cloud btripOpen API free on Apizie? Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud btripOpen itself also needs your own key from aliyuncs.com. ### Can AI agents use the Alibaba Cloud btripOpen API? Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-btripopen. ### What is the status of the Alibaba Cloud btripOpen API? Needs your own provider key (bring your own key)