# Mã lỗi

> Trang này liệt kê các mã lỗi có thể xuất hiện trong bản ghi nút của RPA trình duyệt (`error` trong `nodes.list` / `GET /runs/{id}/nodes`), kết quả lượt chạy (`run.error`) và các yêu cầu Local API.
Khi bạn đọc `docs/api/error-codes.md` qua Local API, phiên bản theo ngôn ngữ của yêu cầu sẽ được trả về. Quy tắc giống như với `message`: `Accept-Language` được ưu tiên, ngôn ngữ giao diện ứng dụng được dùng khi không có header này, và ngôn ngữ không được hỗ trợ sẽ trả về en-US. Để đọc một ngôn ngữ cố định, hãy dùng `error-codes.<language>.md`. Phiên bản tiếng Trung là `error-codes.zh-CN.md`.


## Đối tượng lỗi

```json
{"code": "ELEMENT_NOT_FOUND", "message": "No matching element was found. Check that the selector is correct and that the page has finished loading", "retryable": false, "details": {"phase": "selector", "matchedCount": 0}}
```

- `code`: Mã lỗi ổn định. Hãy dựa vào mã này để xây dựng logic khôi phục và rẽ nhánh.
- `message`: Thông báo dành cho người đọc. Đây chính là câu mà giao diện ứng dụng hiển thị cho cùng lỗi đó. Thông báo được trả về bằng ngôn ngữ của header yêu cầu `Accept-Language`, hoặc bằng ngôn ngữ giao diện ứng dụng khi không có header này. Nội dung thay đổi theo phiên bản và ngôn ngữ, vì vậy chương trình nên ra quyết định dựa trên `code` và `details` và không nên phân tích `message`. Cột "Mô tả" trong các bảng dưới đây là mô tả dành cho nhà phát triển của từng mã lỗi. Đây không phải là `message` mà API trả về.
- `details`: Ngữ cảnh có cấu trúc tùy chọn, hoặc `null` khi không có thông tin. Chỉ các trường trong bảng dưới đây mới có thể xuất hiện. Ngoài `cause`, trường này không bao giờ chứa văn bản ngoại lệ thô, URL, bộ chọn, đường dẫn cục bộ, nội dung trang hay đầu vào riêng tư. `cause` chỉ xuất hiện ở `ATOM_FAILED` / `CONTROL_FAILED` (lỗi dự phòng dùng khi không xác định được nguyên nhân cụ thể), `CDP_ERROR` (trình duyệt từ chối một lệnh) và `SCRIPT_FAILED` (script ném ra ngoại lệ). Trường này chứa văn bản nguyên nhân gốc (một dòng, tối đa 300 ký tự) và không thay thế nội dung nào.


| Trường | Kiểu | Ý nghĩa |
|  --- | --- | --- |
| field | string | Trường đầu vào của nút gây ra lỗi, chẳng hạn `selector`, `exception.retryTimes` hoặc `fields[0].key` |
| reason | string | `required` (thiếu giá trị bắt buộc), `type` (sai kiểu), `range` (ngoài phạm vi), `enum` (không phải giá trị được phép), `format` (định dạng không hợp lệ), `conflict` (các trường xung đột), `limit` (vượt quá giới hạn), `timeout` (hết thời gian chờ), `cancelled` (đã bị hủy), `unknown` (trường hoặc giá trị không xác định), `duplicate` (bị trùng lặp), `empty` (danh sách hoặc nội dung rỗng) |
| expected | string | Kiểu mong đợi: string / number / integer / boolean / object / array / null |
| min / max / limit | number | Cận dưới của phạm vi, cận trên của phạm vi, hoặc giới hạn về số lượng/byte/mili giây |
| httpStatus | number | Mã trạng thái HTTP |
| netError | string | Lỗi mạng của Chromium, chẳng hạn `ERR_NAME_NOT_RESOLVED`, `ERR_CONNECTION_REFUSED` hoặc `ERR_BLOCKED_BY_CLIENT` |
| systemCode | string | Mã lỗi hệ thống, chẳng hạn `ENOENT`, `EROFS` hoặc `ECONNREFUSED` |
| matchedCount | number | Số phần tử thực sự khớp |
| phase | string | Giai đoạn xảy ra lỗi: navigation / selector / script / download / upload / network / file / host / mail / output |
| errorName | string | Kiểu ngoại lệ chuẩn do script của người dùng ném ra: Error / TypeError / ReferenceError / SyntaxError / RangeError / EvalError / URIError / AggregateError |
| format | string | Định dạng mong đợi: absolutePath (đường dẫn cục bộ đầy đủ) / fileName / url / json / regex (biểu thức chính quy) / numericExpression / cookie / a1Range (vùng bảng tính) / spreadsheetId / serviceAccountKey / hostname / selector / dateTime / fieldPath / identifier |
| allowed | string[] | Các giá trị hoặc phần mở rộng tệp được phép (giá trị cấu hình, không bao giờ là dữ liệu người dùng), chẳng hạn `["append","overwrite"]` hoặc `[".txt"]` |
| reference | string | Tham chiếu trong mẫu không thể phân giải, chẳng hạn `node_3.data.title` hoặc `parameters.keyword` |
| cause | string | Chỉ có ở `ATOM_FAILED` / `CONTROL_FAILED` (lỗi dự phòng), `CDP_ERROR` và `SCRIPT_FAILED`: bản tóm tắt một dòng của thông báo ngoại lệ gốc (đã bỏ ngắt dòng, tối đa 300 ký tự, hiển thị nguyên văn và không thay thế nội dung nào). Trường này giúp xác định các lỗi chưa được phân loại hoặc giải thích lý do trình duyệt từ chối một lệnh (chẳng hạn `Cannot navigate to invalid URL`). Với `SCRIPT_FAILED`, đây là thông báo ngoại lệ của chính script (chẳng hạn `kw is not defined`). |
| causeName | string | Chỉ có ở `ATOM_FAILED` / `CONTROL_FAILED` / `CDP_ERROR`: tên kiểu ngoại lệ gốc (1–64 chữ cái ASCII), chẳng hạn `Error` hoặc `ProtocolError` |
| upstreamCode | number | string | Chỉ có ở `RPA_HOST_REQUEST_FAILED`: mã lỗi mà máy chủ trả về khi ứng dụng yêu cầu dữ liệu môi trường từ đám mây. Trong trường hợp này, `message` là "Lượt chạy RPA thất bại: {thông báo của máy chủ}". Thông báo của máy chủ dùng ngôn ngữ giao diện ứng dụng tại thời điểm thất bại, có thể khác với ngôn ngữ của yêu cầu. Trường này không xuất hiện khi không có mã lỗi từ máy chủ, chẳng hạn sau khi xảy ra lỗi mạng hoặc hết thời gian chờ. Khi đó, `message` là "Lượt chạy RPA thất bại: Lỗi mạng. Hãy kiểm tra kết nối mạng rồi thử lại". |


Bản ghi do các phiên bản cũ tạo ra có `details` là `null`. `message` của các bản ghi này ban đầu chính là mã lỗi. Khi đọc các bản ghi này, mô tả trong các bảng ở đây sẽ được trả về thay thế.

## Đầu vào và cấu hình

| code | Mô tả |
|  --- | --- |
| INVALID_INPUT | Đầu vào của nút không hợp lệ. details.field xác định trường, còn details.reason cho biết lý do (required, type, range, enum hoặc format). |
| INVALID_SELECTOR | Cú pháp bộ chọn không hợp lệ. Hãy kiểm tra bộ chọn CSS / XPath / văn bản. |
| INVALID_REGEX | Biểu thức chính quy không hợp lệ hoặc vượt quá giới hạn độ dài. |
| INVALID_REFERENCE | Tham chiếu phần tử/frame không hợp lệ. Tham chiếu phải trỏ tới một ElementRef hoặc FrameRef do một nút trước đó trong lượt chạy này xuất ra. |
| MISSING_VARIABLE | Biến hoặc đầu ra của nút được tham chiếu không tồn tại. details.reference là tham chiếu không thể phân giải, còn details.field là trường đầu vào chứa tham chiếu đó. |
| VARIABLE_TYPE_MISMATCH | Kiểu giá trị không đáp ứng yêu cầu. |
| LIMIT_EXCEEDED | Đã vượt quá số lượng tối đa mà nút cho phép. |
| RPA_INVALID_NODE | Cấu hình nút không hợp lệ. Giá trị path trong issues chỉ ra vị trí của trường. |


## Phần tử

| code | Mô tả |
|  --- | --- |
| OPTION_NOT_FOUND | Danh sách thả xuống không có tùy chọn đích nào có thể chọn (tùy chọn không tồn tại, bị vô hiệu hóa, hoặc không khớp với chế độ chọn một hay chọn nhiều). |
| ELEMENT_NOT_FOUND | Không tìm thấy phần tử khớp trong thời gian chờ. Hãy kiểm tra bộ chọn, chỉ số và trang đã tải xong hay chưa. |
| ELEMENT_NOT_VISIBLE | Phần tử tồn tại nhưng không hiển thị hoặc không thể nhấp (bị ẩn, có kích thước bằng 0 hoặc bị che khuất). |
| ELEMENT_NOT_FOCUSABLE | Phần tử không thể nhận tiêu điểm. |
| ELEMENT_NOT_EDITABLE | Phần tử không thể chỉnh sửa (chỉ đọc, bị vô hiệu hóa hoặc không phải là điều khiển nhập liệu). |
| ELEMENT_TYPE_MISMATCH | Loại phần tử không đáp ứng yêu cầu của nút. Ví dụ, đích của nút Chọn tùy chọn danh sách không phải là phần tử select. |
| FRAME_NOT_FOUND | Phần tử đích không phải là iframe, hoặc không thể truy cập nội dung iframe. |
| STALE_REFERENCE | Tham chiếu phần tử không còn hợp lệ (trang đã điều hướng hoặc phần tử đã bị xóa). Hãy lấy lại phần tử. |


## Trang và tab

| code | Mô tả |
|  --- | --- |
| TAB_NOT_FOUND | Không có tab nào khớp với điều kiện. |
| NO_ACTIVE_PAGE | Không có tab nào để thao tác. |
| PAGE_CLOSED | Trang hoặc trình duyệt đã bị đóng trong lúc thao tác. |
| PAGE_NAVIGATED | Trang đã điều hướng hoặc một frame đã bị xóa trong lúc thao tác. Hãy thử lại sau khi trang ổn định. |
| CDP_ERROR | Trình duyệt đã từ chối một lệnh tự động hóa. details.cause là bản tóm tắt lỗi do trình duyệt trả về, chẳng hạn Cannot navigate to invalid URL. |
| CDP_NOT_READY | Kết nối gỡ lỗi của trình duyệt chưa sẵn sàng. |


## Điều hướng

| code | Mô tả |
|  --- | --- |
| NAVIGATION_FAILED | Trình duyệt không thể mở URL. details.netError là lỗi mạng của Chromium (chẳng hạn ERR_NAME_NOT_RESOLVED hoặc ERR_CONNECTION_REFUSED). |


## Mạng và yêu cầu bên ngoài

| code | Mô tả |
|  --- | --- |
| HTTP_ERROR | Yêu cầu HTTP trả về trạng thái không thành công. details.httpStatus là mã trạng thái. |
| NETWORK_REQUEST_FAILED | Yêu cầu mạng thất bại (kết nối bị từ chối, hết thời gian chờ, lỗi DNS hoặc lỗi chứng chỉ). details.systemCode cho biết lý do. |
| NETWORK_DOWNLOAD_FAILED | Không thể tải xuống tệp từ xa trước khi tải lên tệp đính kèm. Trong details, httpStatus / netError / systemCode cho biết lý do. |
| NETWORK_WAIT_TIMEOUT | Không ghi lại được yêu cầu hoặc phản hồi mạng nào khớp trong thời gian chờ. details.matchedCount là số yêu cầu đã được ghi lại nhưng vẫn chưa có phản hồi (0 nghĩa là không có yêu cầu nào khớp). |
| LISTENER_NOT_FOUND | Không có trình theo dõi mạng nào đang chạy, hoặc ID trình theo dõi không tồn tại. Hãy chạy "Bắt đầu theo dõi mạng" trước. |
| RESPONSE_BODY_UNAVAILABLE | Không thể đọc phần thân phản hồi (đây là phản hồi chuyển hướng, đã bị chặn bắt, đã bị giải phóng hoặc là dữ liệu nhị phân). |
| RESPONSE_LIMIT | Nội dung phản hồi vượt quá giới hạn kích thước. |
| PROVIDER_CONNECTION_ERROR | Không thể kết nối tới dịch vụ bên ngoài. |
| PROVIDER_HTTP_ERROR | Dịch vụ bên ngoài trả về trạng thái lỗi. |
| INVALID_PROVIDER_RESPONSE | Dịch vụ bên ngoài trả về dữ liệu có định dạng không hợp lệ. |


## Script và đầu ra

| code | Mô tả |
|  --- | --- |
| OUTPUT_TYPE_MISMATCH | Giá trị trả về không khớp với định dạng đầu ra đã cấu hình. details.expected là kiểu mong đợi. |
| SCRIPT_FAILED | Script của người dùng đã ném ra ngoại lệ trong khi thực thi. details.errorName là kiểu ngoại lệ (chẳng hạn TypeError hoặc ReferenceError), còn details.cause là bản tóm tắt thông báo ngoại lệ, chẳng hạn kw is not defined. |


## Tệp

| code | Mô tả |
|  --- | --- |
| ENOENT | Tệp hoặc thư mục không tồn tại. |
| EACCES | Bạn không có quyền truy cập tệp hoặc thư mục. |
| EPERM | Hệ thống không cho phép thao tác tệp này. |
| EROFS | Vị trí đích nằm trên hệ thống tệp chỉ đọc. |
| EEXIST | Tệp đích đã tồn tại. |
| ENOTDIR | Một thành phần của đường dẫn không phải là thư mục. |
| EISDIR | Đích là một thư mục, không phải tệp. |
| ENOSPC | Không đủ dung lượng ổ đĩa. |
| EBUSY | Tệp đang được sử dụng. |
| ENAMETOOLONG | Đường dẫn tệp quá dài. |
| EMFILE | Có quá nhiều tệp đang mở. |
| ENOTEMPTY | Thư mục không rỗng. |
| EXDEV | Không thể di chuyển tệp giữa các ổ đĩa. |
| FILE_IN_USE | Tệp đích đang được một chương trình khác sử dụng (ví dụ, đang mở trong Excel). Hãy đóng tệp rồi thử lại. Tệp gốc chưa bị sửa đổi. |
| FILE_NOT_WRITABLE | Tệp đích đã tồn tại và không thể ghi (do thuộc tính chỉ đọc hoặc hạn chế về quyền), nên không thể ghi đè hay ghi vào tệp. Hãy đổi tên hoặc bỏ thuộc tính chỉ đọc của tệp. |
| FILE_LIMIT | Kích thước tệp hoặc số lượng tệp vượt quá giới hạn. |
| UPLOAD_FAILED | Trình duyệt không chấp nhận tệp đã chọn. |
| ARTIFACT_WRITE_FAILED | Không thể ghi tệp tạo phẩm khi kết thúc lượt chạy. |


## Xử lý dữ liệu

| code | Mô tả |
|  --- | --- |
| MISSING_FIELD | Đường dẫn trường JSON đã chỉ định không tồn tại. |
| OUTPUT_TOO_LARGE | Đầu ra của nút vượt quá kích thước tối đa có thể ghi nhận (50 MB). details.limit là giới hạn tính bằng byte. |
| SHEET_NO_DATA | Trang tính không có dữ liệu. |
| SHEET_NOT_FOUND | Sổ làm việc không có trang tính nào mang tên đã chỉ định. details.field là trường tên trang tính. |
| SHEET_HEADER_INVALID | Hàng đầu tiên của trang tính (hàng tiêu đề) phải chứa các tên cột duy nhất và không rỗng, và các hàng dữ liệu không được có nhiều cột hơn hàng tiêu đề. |
| VALUE_CONVERSION_FAILED | Không thể chuyển đổi hoặc so sánh một giá trị trong dữ liệu theo yêu cầu. details.field là trường tương ứng, còn details.expected là kiểu mong đợi. |
| INVALID_JSON_RESPONSE | Nội dung trả về không phải là JSON hợp lệ. |


## Email

| code | Mô tả |
|  --- | --- |
| MAIL_CONNECTION_FAILED | Kết nối hoặc đăng nhập vào máy chủ thư thất bại. Hãy kiểm tra host, cổng, TLS và thông tin xác thực. |
| MAIL_TLS_MISMATCH | Máy chủ thư không trả về lời chào IMAP sau khi kết nối, hoặc quá trình bắt tay TLS bị từ chối. Điều này thường có nghĩa là cổng và thiết lập TLS không khớp nhau (ví dụ, cổng 993 yêu cầu TLS). |
| MAIL_PROVIDER_UNSUPPORTED | Dịch vụ email này không hỗ trợ phương thức xác thực hoặc thư mục đã chọn (OAuth2 và thư mục thư rác chỉ được hỗ trợ cho Outlook). |
| MAIL_JUNK_FOLDER_UNAVAILABLE | Hộp thư không có thư mục thư rác nào truy cập được. |
| MAIL_MESSAGE_LIMIT | Nội dung email vượt quá giới hạn đọc. |
| MAIL_SEARCH_LIMIT | Số email khớp vượt quá giới hạn đọc. Hãy thêm điều kiện lọc. |
| MAIL_SEARCH_FAILED | Máy chủ thư đã từ chối tiêu chí tìm kiếm (NO/BAD). Hãy điều chỉnh điều kiện lọc. |
| MAIL_CREDENTIAL_STORE_ERROR | Không thể đọc hoặc lưu thông tin ủy quyền của hộp thư. |


## Môi trường trình duyệt và ứng dụng

| code | Mô tả |
|  --- | --- |
| NO_BROWSER | Không có môi trường trình duyệt nào được kết nối. |
| NO_ACTIVE_ENVIRONMENT | Không có môi trường trình duyệt nào đang hoạt động (có thể môi trường đã bị đóng). Hãy khởi động hoặc chuyển sang một môi trường trước. |
| UNKNOWN_ENVIRONMENT | Môi trường không tồn tại, hoặc lượt chạy này không mở môi trường đó. |
| INVALID_ENVIRONMENT | Thông tin môi trường không hợp lệ, hoặc môi trường không phải là môi trường Chromium. |
| ENVIRONMENT_CLOSED | Môi trường đã bị đóng. |
| ENVIRONMENT_STILL_RUNNING | Môi trường vẫn đang chạy sau khi đã đóng, nên không thể xác nhận việc đóng. |
| RPA_BROWSER_CORE_MISSING | Máy tính này không có nhân trình duyệt mà môi trường yêu cầu. Ứng dụng sẽ tự động bắt đầu tải xuống nhân này (bạn có thể xem tiến độ trong Trung tâm cập nhật). Hãy chạy lại sau khi tải xuống xong. |
| RPA_BROWSER_CORE_UPDATE_REQUIRED | Môi trường yêu cầu cập nhật nhân trình duyệt. Ứng dụng sẽ tự động bắt đầu tải xuống nhân mới (bạn có thể xem tiến độ trong Trung tâm cập nhật). Hãy chạy lại sau khi tải xuống xong. |
| RPA_BROWSER_CORE_SYSTEM_UNSUPPORTED | Hệ điều hành hiện tại không hỗ trợ nhân trình duyệt này. |
| RPA_BROWSER_CORE_OFFLINE | Nhân trình duyệt đã ngừng cung cấp. Hãy chuyển sang một phiên bản nhân khác. |
| RPA_BROWSER_CACHE_PATH_INVALID | Thư mục bộ nhớ đệm của trình duyệt không hợp lệ. |
| RPA_CLIENT_UPDATE_REQUIRED | Phiên bản ứng dụng quá cũ. Hãy cập nhật ứng dụng rồi thử lại. |
| RPA_BROWSER_NOT_READY | Trình duyệt đã khởi động, nhưng kết nối gỡ lỗi chưa sẵn sàng. |
| RPA_BROWSER_START_FAILED | Môi trường trình duyệt khởi động thất bại (bao gồm cả trường hợp bước kiểm tra môi trường của tiện ích mở rộng tích hợp sẵn thất bại). Hãy mở môi trường thủ công từ danh sách môi trường để khắc phục sự cố. |
| RPA_BROWSER_CONNECT_FAILED | Môi trường trình duyệt đã mở, nhưng không thể thiết lập kết nối tự động hóa. Hãy đóng môi trường rồi thử lại. |
| RPA_BROWSER_CLOSE_TIMEOUT | Đã hết thời gian chờ trình duyệt đóng. |
| RPA_HEADLESS_CORE_UNSUPPORTED | Trình duyệt headless chỉ hỗ trợ nhân trình duyệt phiên bản 130 trở lên. |
| RPA_ENVIRONMENT_NOT_FOUND | Không tìm thấy môi trường đã chỉ định (ID hoặc số thứ tự không tồn tại). |
| RPA_ENVIRONMENT_AMBIGUOUS | Điều kiện đã chỉ định khớp với nhiều hơn một môi trường. Hãy dùng ID môi trường. |
| RPA_ENVIRONMENT_ID_REQUIRED | Thiếu ID môi trường. |
| RPA_ENVIRONMENT_ID_MISMATCH | Môi trường do ứng dụng trả về không khớp với yêu cầu. |
| RPA_UNSAFE_ENVIRONMENT_ID | ID môi trường vượt quá phạm vi số nguyên an toàn. Hãy truyền ID dưới dạng chuỗi. |
| RPA_ENVIRONMENT_OUTSIDE_TASK | Môi trường này nằm ngoài phạm vi được phép của lượt chạy này. |
| RPA_ENVIRONMENT_STATUS_UNAVAILABLE | Không thể đọc trạng thái môi trường. |
| RPA_CHROMIUM_ENVIRONMENT_REQUIRED | Chỉ hỗ trợ môi trường trình duyệt Chromium. |
| RPA_E2E_ENVIRONMENT_UNSUPPORTED | Môi trường mã hóa đầu cuối không hỗ trợ RPA trình duyệt. |
| RPA_ENVIRONMENT_LOCKED | Môi trường đang được một thành viên khác sử dụng (khóa bảo mật) nên hiện không thể mở. |
| RPA_ENVIRONMENT_TRANSFERRING | Môi trường đang được chuyển giao nên hiện không thể mở. |
| RPA_ENVIRONMENT_PROXY_DELETED | Proxy gắn với môi trường đã bị xóa, nên môi trường không thể khởi động. Hãy cập nhật thông tin proxy trong môi trường rồi thử lại. |
| RPA_ENVIRONMENT_QUOTA_EXCEEDED | Gói đăng ký của bạn không có đủ môi trường khả dụng, nên không thể mở môi trường này. |
| RPA_ENVIRONMENT_DAILY_OPEN_LIMIT | Đã đạt giới hạn số lần mở môi trường trong ngày. |
| RPA_TAG_ID_UNKNOWN_OR_AMBIGUOUS | ID thẻ không tồn tại hoặc không duy nhất. Chỉ có thể dùng các thẻ hiện có trong nhóm. |
| RPA_TAG_CATALOG_INVALID | Không thể đọc danh sách thẻ của nhóm. |
| RPA_TAG_READBACK_INVALID | Đã gửi thẻ, nhưng kết quả đọc lại không hợp lệ. |
| RPA_TAG_UPDATE_NOT_CONFIRMED | Không thể xác nhận việc cập nhật thẻ bằng cách đọc lại. |
| RPA_REMARK_READBACK_INVALID | Đã gửi ghi chú, nhưng kết quả đọc lại không hợp lệ. |


## Điều khiển quy trình

| code | Mô tả |
|  --- | --- |
| CONTROL_RUNTIME_REQUIRED | Nút điều khiển chỉ có thể chạy bên trong quy trình. |
| CONTROL_FAILED | Nút điều khiển thất bại. |
| BREAK_OUTSIDE_LOOP | Nút "Thoát vòng lặp" không nằm bên trong vòng lặp. |
| ITERATION_LIMIT | Số lần lặp của vòng lặp vượt quá giới hạn. |
| STEP_LIMIT | Số bước thực thi của quy trình vượt quá giới hạn. |
| CALL_DEPTH_LIMIT | Độ sâu lồng nhau của quy trình con vượt quá giới hạn. |
| WORKFLOW_RECURSION | Quy trình con không thể gọi đệ quy chính nó. |
| WORKFLOW_NOT_FOUND | Không tìm thấy phiên bản quy trình con được tham chiếu. |
| WORKFLOW_REPOSITORY_REQUIRED | Chưa cung cấp các phụ thuộc của quy trình con. |
| WORKFLOW_FAILED | Quy trình con thất bại. |
| NODE_FAILED | Nút thất bại. |
| END_FAILED | Quy trình kết thúc ở trạng thái thất bại. |
| NODE_REMOVED | Nút này đã ngừng được hỗ trợ. Hãy xóa nút khỏi quy trình. |
| UNKNOWN_NODE | Loại nút không xác định. |
| UNSUPPORTED_NODE | Phiên bản hiện tại không hỗ trợ nút này. |
| RPA_TASK_TIMEOUT | Tác vụ đã hết thời gian chờ và lượt chạy đã bị dừng. |
| RPA_ACTION_UNSUPPORTED | Phiên bản hiện tại không hỗ trợ nút này (nút đã ngừng được hỗ trợ hoặc không khả dụng). |


## Thực thi

| code | Mô tả |
|  --- | --- |
| INVALID_SEED | Kết quả nút được lưu đệm để gỡ lỗi là không hợp lệ. Hãy chạy lại các nút trước đó. |
| TASK_METADATA_REQUIRED | Thiếu thông tin tác vụ, nên không thể tạo đường dẫn tạo phẩm mặc định. |
| TIMEOUT | Nút đã hết thời gian chờ. Việc hết thời gian chờ được xử lý như một lần thất bại, và các thiết lập thử lại, chụp ảnh màn hình khi thất bại và xử lý ngoại lệ đã cấu hình đều được áp dụng. details.limit là thời gian chờ tính bằng mili giây, còn details.phase là giai đoạn mà nút đang thực hiện. |
| CANCELLED | Lượt chạy đã dừng do có yêu cầu hủy. |
| OUTCOME_UNKNOWN | Không thể xác nhận lượt chạy đã dừng hay chưa. Lượt chạy được hiển thị là failed, và môi trường thực thi vẫn bị cách ly cho đến khi xác nhận được việc dừng. Các tác động bên ngoài chưa được xác nhận, vì vậy không tự động chạy lại. |
| RPA_INTERRUPTED | Lượt chạy bị gián đoạn do ứng dụng thoát hoặc gặp lỗi, và lượt chạy được hiển thị là failed. Hãy kiểm tra kết quả thực tế trên trang trước khi chạy lại. |
| ATOM_FAILED | Một hành động trình duyệt thất bại và không xác định được nguyên nhân cụ thể. Hãy dựa vào đầu vào của nút thất bại, ảnh chụp màn hình và trạng thái trang để khắc phục sự cố. |
| ATOM_IN_FLIGHT | Đã có một hành động đang chạy trong cùng ngữ cảnh thực thi. |
| CONTEXT_ACTIVE | Ngữ cảnh thực thi vẫn đang được sử dụng. |
| CONTEXT_CLOSED | Ngữ cảnh thực thi đã bị đóng. |
| CONTEXT_QUARANTINED | Hành động trước đó không kết thúc một cách an toàn. Ngữ cảnh thực thi bị cách ly, và các nút còn lại sẽ không chạy. |
| EXECUTION_FENCED | Lượt chạy đã bị dừng và không còn nhận hành động mới. |
| WORKER_EXITED | Tiến trình thực thi script đã thoát bất ngờ. |
| RPA_EXECUTION_FAILED | Quy trình thất bại. Hãy kiểm tra bản ghi của các nút thất bại. |


## Ứng dụng chủ (host)

| code | Mô tả |
|  --- | --- |
| GOOGLE_SHEETS_CONFIG_REQUIRED | Dịch vụ Google Sheets chưa được cấu hình. |
| HOST_ADAPTER_REQUIRED | Nút này cần các khả năng do môi trường ứng dụng cung cấp, nhưng các khả năng này không có trong ngữ cảnh thực thi hiện tại. |
| RPA_INVALID_HOST_RESPONSE | Ứng dụng trả về dữ liệu không hợp lệ. |
| RPA_PERMISSION_DENIED | Tài khoản hiện tại không có quyền thao tác trên môi trường này. |
| RPA_HOST_FAILED | Ứng dụng xử lý yêu cầu thất bại. |
| RPA_HOST_REQUEST_FAILED | Yêu cầu của ứng dụng gửi lên đám mây để lấy dữ liệu môi trường hoặc tài khoản đã thất bại. Nếu máy chủ từ chối yêu cầu, details.upstreamCode là mã lỗi của máy chủ, và message có kèm thông báo của máy chủ. Nếu không, đó là lỗi mạng. Hãy kiểm tra mạng và trạng thái đăng nhập, rồi thử lại. |
| RPA_HOST_TIMEOUT | Ứng dụng đã hết thời gian chờ trong khi xử lý, và kết quả chưa được xác nhận. |
| RPA_HOST_LOST | Mất kết nối tới trang của ứng dụng, và kết quả chưa được xác nhận. |
| RPA_HOST_UNAVAILABLE | Cửa sổ chính của ứng dụng không khả dụng. |
| RPA_HOST_INVALID_RESPONSE | Ứng dụng trả về dữ liệu không hợp lệ. |
| RPA_SESSION_EXPIRED | Phiên của ứng dụng đã hết hạn. Hãy mở lại trang. |


## Yêu cầu Local API

Các mã lỗi sau đây do chính các yêu cầu Local API trả về (trong `error.code`, `issues[].code` và `warnings[].code`). Chúng không xuất hiện trong bản ghi nút hoặc bản ghi lượt chạy. Về trạng thái HTTP và các bước khôi phục, xem [Quy ước API](/vi/browser-rpa/api/common) và [Chi tiết lỗi và ma trận khôi phục](/vi/browser-rpa/api/recovery).

| code | Mô tả |
|  --- | --- |
| RPA_LOGIN_REQUIRED | Hãy đăng nhập vào ứng dụng MoreLogin trước. |
| RPA_NOT_FOUND | Tài nguyên không tồn tại hoặc không thuộc phạm vi dữ liệu của tài khoản/nhóm hiện tại. |
| RPA_INVALID_REQUEST | Định dạng yêu cầu không khớp với hợp đồng API. Hãy kiểm tra đường dẫn, tham số, header và phần thân. |
| RPA_INVALID_TEXT | Văn bản trống hoặc không đáp ứng giới hạn độ dài. |
| RPA_PRECONDITION_REQUIRED | Đặt If-Match thành ETag mạnh được trả về khi bạn đọc mẫu. |
| RPA_VERSION_CONFLICT | Mẫu đã bị sửa đổi. Hãy đọc lại mẫu, rồi xác thực bản đề xuất chỉnh sửa. |
| RPA_TEMPLATE_VERSION_CONFLICT | Phiên bản mẫu trong yêu cầu đã cũ. Hãy đọc phiên bản hiện tại. |
| RPA_CATALOG_CHANGED | Bản sửa đổi danh mục nút bị thiếu hoặc đã cũ. Hãy làm mới khả năng (capabilities) và các hợp đồng nút. |
| RPA_VALIDATION_FAILED | Xác thực quy trình thất bại. Hãy sửa các vấn đề tại các vị trí trong issues, rồi xác thực lại. |
| RPA_NODE_INPUT_INVALID | Đầu vào của nút không khớp với hợp đồng hoặc ràng buộc giá trị của nút. |
| RPA_REFERENCE_NOT_FOUND | Tham số, nút hoặc trường đầu ra được tham chiếu không tồn tại. |
| RPA_REFERENCE_ORDER_INVALID | Nút được tham chiếu chưa chạy tại vị trí hiện tại. |
| RPA_PRIVATE_DEFAULT_INVALID | Tham số riêng tư phải có kiểu string. Với publicState=retained, bạn chỉ có thể giữ lại giá trị mặc định hiện có của một trường riêng tư cùng tên trong cùng mẫu. |
| RPA_PRIVATE_DEFAULT_UNAVAILABLE | Không còn đọc được giá trị mặc định của tham số riêng tư từ kho lưu trữ an toàn cục bộ, nên lần này giá trị được trả về dưới dạng chưa đặt. Nếu cần giá trị mặc định, hãy gửi lại văn bản thuần. |
| RPA_NODE_TITLE_GENERIC | Tên của nút hoặc nhánh (data.title) bị thiếu, để trống hoặc vẫn là tên mặc định của trình chỉnh sửa (tên hành động, "Nhánh" hoặc "Nhánh mặc định"), nên trình chỉnh sửa không cho thấy bước này làm gì. Hãy dùng tên mô tả mục đích của bước, chẳng hạn "Chờ kết quả tìm kiếm xuất hiện" hoặc "Tìm video mục tiêu". Đây chỉ là lời nhắc và không ảnh hưởng đến việc lưu hay chạy. |
| RPA_UNKNOWN_PARAMETER | Yêu cầu chứa một tham số mà mẫu không khai báo. |
| RPA_REQUIRED_PARAMETER | Thiếu một tham số bắt buộc mà mẫu đã khai báo. |
| RPA_REQUEST_CONFLICT | Cùng một khóa idempotency đã được dùng cho một ý định yêu cầu khác. |
| RPA_REQUEST_NOT_COMMITTED | Đã xác nhận rằng chưa có gì được commit với khóa idempotency này. Nếu ý định ban đầu không thay đổi, bạn có thể thử lại bằng khóa ban đầu. |
| RPA_REQUEST_EXPIRED | Khoảng thời gian khôi phục của khóa idempotency này đã hết hạn. Trước tiên hãy kiểm tra trạng thái của tài nguyên. |
| RPA_DEPENDENCY_UNAVAILABLE | Mẫu con được tham chiếu đã bị xóa hoặc không khả dụng. Hãy cập nhật tham chiếu, rồi chạy lại. |
| RPA_ENVIRONMENT_BUSY | Môi trường đang chạy hoặc đang bị cách ly. Hãy chờ đến khi môi trường được giải phóng, rồi chạy lại bước kiểm tra trước. |
| RPA_RATE_LIMITED | Yêu cầu được gửi quá thường xuyên. Hãy chờ theo Retry-After, rồi thử lại. |
| RPA_VALIDATION_TIMEOUT | Bước xác thực chỉ đọc đã hết thời gian chờ. Không có thao tác ghi nào được commit. |
| RPA_SERVICE_BUSY | Dịch vụ tạm thời bận. Hãy truy vấn biên nhận của yêu cầu ban đầu trước khi quyết định có thử lại hay không. |
| RPA_OUTCOME_UNKNOWN | Không nhận được xác nhận cho thao tác ghi mẫu đám mây, nên kết quả chưa xác định. Thử lại với cùng khóa idempotency sẽ không ghi lại lần nữa. Trước tiên hãy kiểm tra danh sách mẫu. |
| RPA_INTERNAL | Dịch vụ xử lý yêu cầu thất bại. Hãy giữ lại requestId để khắc phục sự cố, và kiểm tra biên nhận ghi. |
| RPA_WORKFLOW_SCHEMA_INVALID | Cấu trúc quy trình không khớp với hợp đồng quy trình. Trường path cho biết vị trí, còn trường reason cho biết nguyên nhân (required, type, enum, range, format hoặc trường không xác định). |
| RPA_STRUCTURE_INVALID | Quy trình phải bắt đầu bằng đúng một nút start và kết thúc bằng đúng một nút end. |
| RPA_DUPLICATE_NODE | Một ID nút được dùng nhiều lần. Hãy dùng một ID duy nhất cho mỗi nút. |
| RPA_NODE_LIMIT | Số nút trong quy trình vượt quá giới hạn. Hãy tách quy trình thành các quy trình con. |
| RPA_DEPTH_LIMIT | Độ sâu lồng nhau của quy trình vượt quá giới hạn. Hãy giảm mức lồng nhau của nhóm hoặc nhánh. |
| RPA_LIMIT_EXCEEDED | Nội dung yêu cầu vượt quá giới hạn về kích thước hoặc số lượng. Trong details, limit / maxBytes cho biết giới hạn. |
| RPA_REFERENCE_NOT_VISIBLE | Nút được tham chiếu không nhìn thấy được tại vị trí hiện tại (nút nằm ở nhánh khác hoặc nằm sau nút này). Thay vào đó, hãy tham chiếu một nút luôn chạy trước vị trí này. |
| RPA_REFERENCE_FIELD_NOT_FOUND | Đầu ra của nút được tham chiếu không có trường này. Hãy sửa tên trường dựa trên outputVariants trong hợp đồng nút. |
| RPA_REFERENCE_EXPRESSION_UNSUPPORTED | ${…} chỉ có thể chứa đường dẫn tham chiếu biến, không được chứa phép tính số học hay biểu thức khác. Hãy viết phép tính số trong trường số có hỗ trợ biểu thức số (numericExpression), ví dụ "${loop.data.index}+1". |
| RPA_INVALID_REFERENCE | Cú pháp tham chiếu không hợp lệ. Một ref chỉ có thể chứa type và content, và content phải là mảng chuỗi không rỗng. Một constant chỉ có thể chứa type và content. |
| RPA_RUNTIME_CHECK_REQUIRED | Nút được tham chiếu có thể không chạy (nút nằm trong nhánh điều kiện hoặc vòng lặp). Nếu giá trị không được tạo ra khi chạy, lượt chạy sẽ thất bại. |
| RPA_AUTHORING_RESTRICTED | Nút hoặc trường này chứa cấu hình nhạy cảm chỉ có thể chỉnh sửa trong giao diện ứng dụng. Local API không thể ghi cấu hình này. |
| RPA_EXTERNAL_EXECUTION_RESTRICTED | Quy trình chứa các nút chỉ có thể chạy từ giao diện ứng dụng, nên không thể chạy qua Local API. |
| RPA_DEFAULT_CONFLICT | Cùng một tham số đặt cả default lẫn extra.defaultValue, và hai giá trị này khác nhau. Chỉ giữ lại một trong hai. |
| RPA_PRIVATE_DEFAULT_CLEARED | Lần ghi này không gửi giá trị mặc định cho tham số riêng tư (văn bản thuần hoặc publicState=retained), nên giá trị mặc định hiện có sẽ bị xóa. Để giữ lại, hãy gửi văn bản thuần hoặc retained. |
| RPA_REDACTED_CONTENT_READ_ONLY | Mẫu chứa các giá trị literal nhạy cảm cũ đã bị che. Hãy chuyển đổi chúng trong ứng dụng trước. Chỉ sau đó bạn mới có thể chỉnh sửa hoặc sao chép mẫu qua Local API. |
| RPA_INVALID_NODE_EDIT | Thao tác chỉnh sửa nút không hợp lệ. Giá trị path trong issues chỉ ra thao tác và trường bị lỗi. |
| RPA_UNSUPPORTED_MEDIA_TYPE | Phần thân yêu cầu phải là application/json. |
| RPA_DEPENDENCY_VERSION_UNAVAILABLE | Phiên bản mẫu con được tham chiếu không khả dụng. Hãy đọc mẫu mới nhất, rồi xác thực lại. |
| RPA_ENVIRONMENT_UNAVAILABLE | Không thể phân giải môi trường trình duyệt đã chỉ định. Hãy kiểm tra danh sách các môi trường hiện có và trạng thái của ứng dụng. |
| RPA_SERVICE_UNAVAILABLE | Dịch vụ RPA trình duyệt tạm thời không khả dụng (ứng dụng chưa đăng nhập, đang khởi động hoặc đã bị đóng). Hãy đảm bảo ứng dụng đã đăng nhập, rồi thử lại. |
| RPA_REQUEST_TIMEOUT | Ứng dụng đã hết thời gian chờ khi xử lý yêu cầu, và kết quả chưa được xác nhận. Với thao tác ghi, hãy truy vấn biên nhận bằng khóa idempotency ban đầu trước khi quyết định có thử lại hay không. |