> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sellfern.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Tiếp nhận đơn hàng
> Nhập đơn hàng vào Sellfern từ Gmail, tệp CSV hoặc nhập thủ công.
Tiếp nhận đơn hàng là cách đơn hàng vào Sellfern. Mọi đơn hàng đi qua tính chi phí, xử lý đơn và báo cáo đều bắt đầu tại đây. Bạn có thể đưa đơn hàng vào từ Gmail, tệp CSV hoặc nhập thủ công tùy theo cách làm việc của nhóm.
Kết nối tài khoản Google và để Sellfern quét hộp thư của bạn tìm email xác nhận đơn hàng Etsy theo lịch bạn kiểm soát. Cần admin cài đặt trước — xem bên dưới.
Cài đặt tiện ích mở rộng Chrome/Edge để lấy đơn hàng trực tiếp từ Etsy Mission Control API trong phiên trình duyệt của bạn và đẩy vào Sellfern.
Tải lên đơn hàng lịch sử hoặc đơn hàng bên ngoài từ một bảng tính. Sellfern hiển thị bản xem trước trước khi commit bất kỳ thay đổi nào.
Tạo hoặc chỉnh sửa một đơn hàng trực tiếp cho đơn hàng tùy chỉnh, chỉnh sửa và dọn dẹp các bản ghi nhập thất bại.
Tải lên hóa đơn PDF của Etsy để chuyển thành bảng sản xuất, tự sửa địa chỉ, sửa SKU và bổ sung dữ liệu còn thiếu.
Trong thanh bên, menu **Nhập đơn hàng** chia thành ba nhóm: **Nhập** (các phương thức đưa đơn vào), **Xem xét** (Nhập thất bại, Không cân đối, Store Mismatch — kèm số đếm cảnh báo màu đỏ/vàng) và **Lịch sử** (Sync History).
## Tiện ích mở rộng Etsy (Browser Extension)
Đối với các nhà bán hàng Etsy muốn đồng bộ đơn hàng trực tiếp mà không cần cài đặt Gmail Live Sync, Sellfern cung cấp một tiện ích mở rộng (Chrome/Edge Extension). Tiện ích này sẽ lấy đơn hàng trực tiếp từ Etsy Mission Control API thông qua phiên đăng nhập trình duyệt của bạn và đẩy vào Sellfern.
### Cài đặt và Cấu hình
Cài đặt tiện ích mở rộng từ các cửa hàng chính thức:
* **Chrome**: [Chrome Web Store](https://chromewebstore.google.com/detail/sellfern-etsy/ehildmppcmdnlclnbpbnigkolodanadj)
* **Edge**: [Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/sellfern-etsy/ngcfnobaoggjjljpliimoagnnclggigi)
Bấm vào biểu tượng tiện ích Sellfern trên thanh công cụ trình duyệt và đăng nhập trực tiếp bằng email và mật khẩu tài khoản Sellfern của bạn. Nếu tài khoản của bạn thuộc nhiều tổ chức, hãy chọn tổ chức hoạt động khi được nhắc.
1. Mở một tab Etsy Shop Manager trên cùng trình duyệt.
2. Mở cửa sổ tiện ích Sellfern và bấm **Auto Detect** (Tự động nhận diện).
3. Tiện ích sẽ tự động nhận diện Etsy Shop ID và Tên cửa hàng của bạn.
Tên cửa hàng được nhận diện phải khớp với một trong các cửa hàng đã được tạo trong tài khoản Sellfern của bạn (**Cài đặt → Cửa hàng**). Nếu cửa hàng chưa tồn tại, hệ thống sẽ hiển thị cảnh báo.
### Đồng bộ đơn hàng
1. Truy cập vào Etsy Shop Manager hoặc bất kỳ trang Etsy nào trên cùng trình duyệt.
2. Bấm vào biểu tượng tiện ích Sellfern để mở cửa sổ phụ (popup).
3. Chọn trạng thái đơn hàng (**Order State**) và khoảng thời gian hoàn thành nếu áp dụng.
4. Bấm **Tải đơn hàng** (Fetch Orders) để tải đơn từ Etsy.
5. Xem lại các đơn hàng trong bảng xem trước, sau đó bấm **Đẩy lên Sellfern** (Push to Sellfern) để đưa đơn hàng vào hệ thống.
## Gmail Live Sync
Gmail Live Sync kết nối một tài khoản Google với Sellfern và định kỳ quét hộp thư đó tìm email xác nhận đơn hàng Etsy. Mỗi email khớp được phân tích để lấy dữ liệu đơn hàng — khách hàng, mặt hàng, SKU, tổng tiền — và tự động chuyển thành đơn hàng, theo lịch và phạm vi tìm kiếm bạn cấu hình. Các email không phân tích được sẽ vào **Nhập thất bại** thay vì chặn cả lô.
Gmail Live Sync không tự cài đặt được. Cần Sellfern cấu hình một lần (cấp quyền Google API cho tổ chức của bạn) trước khi có thể kết nối bất kỳ tài khoản nào. Nếu bạn muốn dùng dịch vụ này, hãy liên hệ admin của Sellfern để được bật — chỉ sau đó Admin mới kết nối tài khoản Google và chạy đồng bộ được.
## Nhập hàng loạt CSV
Nhập hàng loạt CSV, gọi là **Legacy Bulk** trong ứng dụng, cho phép bạn tải lên đơn hàng lịch sử hoặc đơn hàng dựa trên bảng tính.
Vào **Đơn hàng → Tiếp nhận → Legacy Bulk**.
Bấm **Chọn CSV** và chọn một tệp `.csv` từ máy tính.
Kiểm tra định dạng được phát hiện, số lượng đơn hàng, 50 hàng đầu tiên của bản xem trước, và các trường tài chính trước khi commit bất kỳ thay đổi nào.
Bấm **Hoàn tất nhập** để commit các đơn hàng đã phân tích, hoặc **Hủy** để bỏ qua việc tải lên mà không lưu gì.
## Xử lý hóa đơn Etsy (Etsy Processor)
Etsy Processor chuyển hóa đơn PDF của Etsy thành bảng sản xuất và bổ sung dữ liệu còn thiếu.
Vào **Nhập đơn hàng → Etsy Processor**.
Chọn tệp PDF hóa đơn tải về từ Etsy và bấm **Chuyển đổi & Bổ sung**.
Sellfern phân tích PDF và hiển thị bảng xem trước cùng số liệu: đơn hàng đã tạo, sản phẩm đã tạo, địa chỉ đã sửa, SKU đã sửa và sản phẩm mới phát hiện.
Bấm **Lưu ánh xạ SKU** để hệ thống ghi nhớ các SKU đã sửa cho lần sau, và **Xuất Excel** nếu cần gửi bảng kê cho nhà cung cấp. Lịch sử các lần xử lý hiển thị ngay bên dưới.
## Nhập thủ công
Nhập thủ công cho phép bạn tạo hoặc cập nhật một đơn hàng trực tiếp trong Sellfern. Sử dụng cho đơn hàng tùy chỉnh, đơn qua điện thoại, công việc bán sỉ, chỉnh sửa và giải quyết các nhập thất bại hoặc bản ghi không cân đối.
Các hành vi chính:
* **Order ID là bắt buộc.**
* **Cần ít nhất một dòng mặt hàng.**
* **Số tiền hoàn không được âm.** Nhập số tiền khấu trừ dưới dạng giá trị dương.
* Nếu trường cửa hàng để trống, Sellfern dùng **Manual Entry** làm tên cửa hàng.
* Nếu tên khách hàng để trống, Sellfern dùng **Walk-in**.
* Tiền tệ mặc định là **USD**.
* Thay đổi subtotal, vận chuyển, thuế và giảm giá sẽ tự động tính lại tổng.
* Trạng thái mặt hàng trở thành **Hoàn thành** khi cung cấp chi phí cơ bản; nếu không nó vẫn ở **Chờ chi phí**.
Để tải và chỉnh sửa một đơn hàng hiện có, hãy nhập order ID và bấm hành động tải. Sellfern điền sẵn biểu mẫu để bạn có thể chỉnh sửa chính xác.
## Xem xét các lần nhập
Sau bất kỳ phương thức nhập nào, hãy sử dụng các tab xem xét **Nhập thất bại** và **Không cân đối** để phát hiện và sửa lỗi.
### Nhập thất bại
Tab **Nhập thất bại** liệt kê các bản ghi nguồn không thể phân tích thành đơn hàng. Từ đây, bạn có thể xem bản ghi gốc và ngữ cảnh lỗi, mở một bản ghi thất bại trong Nhập thủ công, hoặc xóa các thất bại không còn cần. Khi bạn xử lý một nhập thất bại qua Nhập thủ công và lưu thành công, Sellfern tự động xóa bản ghi nhập thất bại.
### Không cân đối
Tab **Không cân đối** liệt kê các đơn hàng có tổng được ghi không khớp với tính toán chi tiết của đơn hàng. Sử dụng bộ lọc cửa hàng, khoảng thời gian và điều khiển phân trang để thu hẹp danh sách, sau đó mở một đơn hàng trong Nhập thủ công để sửa tổng hoặc các dòng mặt hàng.
### Store Mismatch
Tab **Store Mismatch** (chỉ Admin) liệt kê các đơn hàng có tên cửa hàng không khớp với danh sách cửa hàng đã cấu hình trong **Cài đặt → Cửa hàng** — thường do lỗi chính tả trong dữ liệu nguồn hoặc cửa hàng chưa được tạo. Gán lại đơn về đúng cửa hàng để báo cáo theo cửa hàng chính xác.
### Sync History
Tab **Sync History** ghi lại tất cả các lần đồng bộ/nhập đã chạy, thời điểm, trạng thái và số bản ghi được xử lý — dùng để kiểm tra xem một lô đơn đã được nhập chưa và có lỗi gì không.
## Hướng dẫn tự động hóa và API
Đối với các mẫu tự động hóa công khai được hỗ trợ, hãy sử dụng tài liệu nhà phát triển V1 thay vì các route nội bộ của ứng dụng. Bắt đầu với [bắt đầu nhanh cho nhà phát triển](/vi/developers/quickstart) hoặc [Tham chiếu API](/api-reference/order-items/list-order-items).
## Khắc phục sự cố
Hãy kết nối tài khoản Gmail trước, hoặc đợi đồng bộ hiện tại kết thúc trước khi bắt đầu một đồng bộ mới.
Bật popup cho Sellfern trong cài đặt trình duyệt, sau đó bấm Kết nối lại.
Kết nối lại tài khoản Google bị ảnh hưởng từ danh sách kết nối Live Sync.
Hủy việc tải lên mà không hoàn tất, sửa tệp CSV, và tải lên lại.
Xác nhận đơn hàng có Order ID, ít nhất một dòng mặt hàng, và bất kỳ số tiền hoàn nào đều được nhập dưới dạng số dương.