# Các lỗi thường gặp

### I. Lỗi vận đơn rỗng

1. **Hình ảnh minh hoạ**

<figure><img src="/files/1v1ChnylMnkIB7KubCuO" alt=""><figcaption></figcaption></figure>

2. **Nguyên nhân:**

* **TH1:** Vấn đề này thường xảy ra ở shopee do việc trả vận đơn từ Shopee về hệ thống thường mất 1 - 2p để tải. Nếu trong trường hợp tại thời điểm chuẩn bị hàng Sàn chưa trả vận đơn -> lỗi chưa có vận đơn, hệ thống 5p 1 lần sẽ tự động gọi lấy vận đơn.
* **TH2:** Do nhà bán hàng thao tác Chuẩn bị hàng trực tiếp trên seller, sau đó lại lên UpS để xử lý đơn -> UpS không tự lấy vận đơn về được

3. **Giải pháp:**

* **TH1:**

B1: Tải lại vận đơn khi thấy đơn lỗi

B2: Trường hợp tải lại nhiều lần và đợi 30p không có vận đơn thì báo lại nhân sự Upbase hỗ trợ

B3: Phía UpBase sẽ tối ưu hệ thống thêm về thời gian lấy vận đơn để hạn chế lỗi

* **TH2:** Cần thao tác tải lại vận đơn để UpS lấy vận đơn từ sàn về

*Cách 1: Nếu xử lý đơn hàng loạt:*

Tại màn xử lý hàng loạt -> đang đóng gói -> chưa có vận đơn -> ấn Tải vận đơn

*Cách 2: Nếu xử lý đơn theo danh sách*

Tại màn danh sách đang xử lý -> chưa có vận đơn -> tích chọn các đơn này -> ấn Tải vận đơn hàng loạt<br>

### II. Lỗi thiếu liên kết đơn

1. **Hình ảnh minh hoạ:**

<figure><img src="/files/gCm7hda3gZqwAIjnHuA5" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/n8IxRiIWbnoL4rRKGF6k" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/gsJNCqH72OD8kB6tw3Re" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ThBLmfeejUT8YyuCYqbS" alt=""><figcaption></figcaption></figure>

2. **Nguyên nhân:**

* Bỏ sót trong quá trình chuẩn hoá kho
* Phát sinh sản phẩm mới listing trên sàn nhưng không tải sản phẩm về UpS
* Sản phẩm đã tải về UpS nhưng sau đó chỉnh sửa trên sàn (đổi tên, đổi phân loại, thêm phân loại, đổi SKU) và không tải lại sản phẩm trên UpS.

3. **Giải pháp:**

* Quickwin: Tại màn Tất cả -> chọn đơn bị lỗi thiếu liên kết -> Chọn -> Chi tiết -> Liên kết đơn
* Rà soát kĩ phần liên kết trong quá trình chuẩn hoá kho ban đầu
* Sản phẩm mới listing trên sàn và chưa có trên UpS: tải lại sản phẩm toàn bộ gian hàng để đồng bộ sản phẩm còn thiếu về UpS

*Thao tác: Cài đặt -> Quản lý gian hàng -> Chọn gian hàng có sản phẩm mới -> Tải lại sản phẩm*

<figure><img src="/files/KGsWFiMXVJ2CQSVb0Ez1" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/aTUXZvWkVYFfa3goIeJW" alt=""><figcaption></figcaption></figure>

* Sản phẩm đã có trên UpS nhưng chỉnh sửa thông tin trên sàn: chỉ tải lại sản phẩm đã chỉnh sửa

*Thao tác: Quản lý sản phẩm sàn -> Danh sách sản phẩm sàn -> Lọc theo sàn/gian hàng hoặc nhập chính xác SKU sản phẩm đã chỉnh sửa -> Tích chọn sản phẩm -> Thao tác hàng loạt -> Tải lại sản phẩm.Sau khi đã tải lại sản phẩm -> Bổ sung liên kết.*

<figure><img src="/files/3Q2jdQWP0eRyH7msS9tL" alt=""><figcaption></figcaption></figure>

* *Sau khi tải lại sp thành công -> Liên kết lại*
* *Quản lý đơn hàng -> Tất cả -> Tìm đơn hàng đang thiếu liên kết -> Chọn -> Tải lại*

### III. Lỗi chuẩn bị hàng

1. **Hình ảnh minh hoạ:**

<figure><img src="/files/d2KV6Izc4jAtea5b7lVa" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/AzkmajQ9gEJUL6TlUsn4" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/tnMkqz38VOWnoJEZnt7n" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/xYhn4Nrnp0ZjsxfEL5mL" alt=""><figcaption></figcaption></figure>

2. **Nguyên nhân:** Tại thời điểm nhà bán hàng thao tác "Chuẩn bị hàng" thì trên sàn chưa cho phép chuẩn bị hàng, thông thường sẽ là các trường hợp:

* Sàn chưa trả API vận đơn về UpS/chưa có vận đơn trên sàn
* Đơn đang chờ xử lý huỷ
* Lỗi hệ thống từ sàn (không thể chuẩn bị hàng được ngay cả khi thao tác trực tiếp trên seller)

3. **Giải pháp:**

* Tất cả các lỗi có cảnh báo ở đầu dòng là lỗi chuẩn bị hàng thì giải pháp duy nhất là đợi thêm 10-30p (tuỳ thuộc thời gian sàn trả API về) và ấn chuẩn bị hàng lại, có thể thử thao tác 2-3 lần trong khoảng thời gian này, khi chuẩn bị hàng lại thành công thì hệ thống sẽ tự clear message lỗi đi.
* Trường hợp đã đợi quá lâu mà vẫn chưa thể chuẩn bị hàng trên UpS, nhà bán hàng có thể thử thao tác trên seller xem có thể CBH trên sàn được không, nếu có thể xử lý được trên seller mà không thể xử lý trên UpS -> raise lỗi lên nhóm chung để Upbase tiếp nhận và kiểm tra lỗi nếu có.

### IV. Lỗi hàng hóa không đủ tồn

1. **Hình ảnh minh họa**

<figure><img src="/files/Lr7pKwcKrHFSjqQhH8zX" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/rE34wxa9iodcNO4VjGj8" alt=""><figcaption></figcaption></figure>

2. **Nguyên nhân**

* Hàng hóa trong kho không đủ tồn
* Hạn sử dụng của hàng hóa đó không đủ tồn kho

3. **Giải pháp**

* Nhập tồn kho cho hàng hóa hết tồn
* Tải lại đơn hàng để xử lý đơn

### V. Lỗi đẩy đơn qua ĐVVC

1. **Hình ảnh mình họa**

2. **Nguyên nhân**

* Lỗi: Dịch vụ không hợp lệ ⇒ Dịch vụ của ĐVVC đã chọn không đáp ứng được&#x20;
* Lỗi: ĐVVC đã huỷ đơn. Cần chọn lại dịch vụ hoặc ĐVVC khác.
* Lỗi: : Địa chỉ lấy hàng: quận/ huyện Thành phố Huế không hợp lệ. Shop vui lòng kiểm tra và cập nhật lại thông tin
* Lỗi: 204: Price does not apply to this itinerary

3. **Giải pháp**

* Với các lỗi dịch vụ không hợp lệ, ĐVVC đã hủy đơn... ⇒ cần bấm vào chi tiết đơn ⇒ sửa và chọn lại ĐVVC để xử lý đơn hàng
* Với lỗi sai thông tin địa chỉ ⇒ cần bấm vào chi tiết đơn ⇒ Sửa lại thông tin địa chỉ đúng định dạng ⇒ Xử lý đơn hàng

### VI. Lỗi vận đơn trắng

1. **Hình ảnh minh họa**

<figure><img src="/files/se4NxUtIuD8qVHrgmYnY" alt=""><figcaption></figcaption></figure>

2. **Nguyên nhân**

* Tại thời điểm sàn trả vận đơn về hệ thống UpS chưa ghi nhận thông tin
* Kho chuẩn bị hàng và in vận đơn trắng, không có thông tin vận đơn

3. **Giải pháp**

* Thao tác truy cập vào Chi tiết đơn -> bấm Tải lại vận đơn

<figure><img src="/files/wC5pV2dxn0IdLZKiV890" alt=""><figcaption></figcaption></figure>

Sau khi tải lại hệ thống sẽ lấy vận đơn mới nhất từ sàn đầy đủ thông tin -> Kho tiến hành in vận đơn và đóng gói


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://upbase.gitbook.io/ups/tinh-nang-san-pham/van-hanh/don-hang/cac-loi-thuong-gap.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.