Chuyển đến nội dung chính

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.

Order Ingestion là cách đơn hàng vào Sellfern. Mỗi đơn hàng chảy qua tính chi phí, hoàn tất và báo cáo tài chính đều bắt đầu ở đây. Bạn có thể đưa đơn hàng vào từ Gmail, BigQuery, tệp CSV hoặc nhập thủ công — tùy theo cách bạn vận hành doanh nghiệp.

​
Phương thức nhập

Gmail Live Sync

Kết nối tài khoản Google và để Sellfern quét hộp thư đến tìm email xác nhận đơn hàng Etsy theo lịch bạn kiểm soát.

BigQuery Sync

Lấy dữ liệu đơn hàng từ BigQuery bằng khoảng ngày và chế độ đồng bộ. Tốt nhất cho nhập khẩu khối lượng cao hoặc định hướng báo cáo.

CSV Bulk Import

Tải lên bảng tính chứa đơn hàng lịch sử hoặc đơn hàng bên ngoài. Sellfern xem trước dữ liệu trước khi commit bất cứ điều gì.

Manual Entry

Tạo hoặc chỉnh sửa một đơn hàng trực tiếp. Hữu ích cho đơn hàng tùy chỉnh, đơn hàng qua điện thoại, sửa lỗi và giải quyết các lần nhập thất bại.

​
Gmail Live Sync

Gmail Live Sync chỉ dành cho admin. Nó kết nối tài khoản Google và quét các tin nhắn phù hợp để tìm dữ liệu đơn hàng Etsy.
1

Mở Live Sync

Vào Orders → Ingestion và chọn Live Sync.
2

Kết nối tài khoản Google của bạn

Nhấp Connect trong thẻ Google Connection. Hoàn tất popup ủy quyền. Nếu popup không mở, hãy cho phép popup cho Sellfern và thử lại. Sau khi kết nối, địa chỉ email xuất hiện trong danh sách kết nối.
3

Đặt cấu hình đồng bộ

Cấu hình các điều sau trước khi bắt đầu:
  • Lookback Start và End Date — khoảng ngày email để tìm kiếm.
  • Batch Limit — xử lý 10, 50, 100 hoặc 500 email mỗi lần chạy.
  • Fetch All — xử lý mọi email phù hợp trong khoảng ngày thay vì dừng ở giới hạn lô.
  • Custom Query — cú pháp tìm kiếm Gmail tùy chọn để thu hẹp kết quả, chẳng hạn như dòng chủ đề hoặc người gửi cụ thể.
4

Bắt đầu đồng bộ

Nhấp Start Sync. Theo dõi Live Terminal để biết tiến độ, cảnh báo và lỗi. Sau khi đồng bộ kết thúc, Sellfern làm mới lịch sử đồng bộ, các bản ghi nhập thất bại và dữ liệu ứng dụng.
5

Gỡ lỗi một đơn hàng cụ thể (tùy chọn)

Nếu một đơn hàng Etsy cụ thể không nhập như mong đợi, hãy dùng Debug Extraction:
  1. Ở lại trên Live Sync.
  2. Nhập chính xác số đơn Etsy trong Enter Etsy Order #….
  3. Nhấp Test.
  4. Xem xét Extraction Details và đầu ra terminal.
Khi đơn hàng được tìm thấy, bảng debug hiển thị ID đơn hàng, tổng, tiền tệ và số lượng mặt hàng đã phân tích. Nếu phân tích thất bại, nhật ký xác định liệu email không được tìm thấy hay quá trình trích xuất thất bại sau khi tìm thấy email.
Nếu token Gmail đã kết nối hết hạn, Sellfern đánh dấu tài khoản là không hợp lệ. Kết nối lại tài khoản trước khi chạy đồng bộ khác.

​
BigQuery Sync

BigQuery Sync chỉ dành cho admin và được thiết kế cho việc nhập đơn hàng khối lượng cao hoặc định hướng báo cáo.
1

Mở BigQuery

Vào Orders → Ingestion → BigQuery.
2

Đặt khoảng ngày

Chọn ngày bắt đầu và kết thúc bắt buộc. Nút Run Sync vẫn bị vô hiệu hóa cho đến khi cả hai ngày được nhập.
3

Chọn chế độ đồng bộ

  • Full Sync — nhập cả doanh số và hoàn tiền.
  • Sales Only — chỉ nhập dữ liệu doanh số.
  • Refunds Only — chỉ nhập dữ liệu hoàn tiền.
4

Chọn cửa hàng đích

Để trống bộ chọn cửa hàng để đồng bộ tất cả cửa hàng, hoặc chọn một hoặc nhiều cửa hàng để giới hạn phạm vi. Sử dụng Select All để bao gồm rõ ràng mọi cửa hàng đã cấu hình.
5

Chạy đồng bộ

Nhấp Run Sync. Xem xét nhật ký quá trình và thẻ kết quả, hiển thị số lượng bản ghi đã xử lý, đã cập nhật và bị lỗi.

​
Nhập hàng loạt CSV

Đường dẫn 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 dựa trên bảng tính.
1

Mở Legacy Bulk

Vào Orders → Ingestion → Legacy Bulk.
2

Chọn tệp của bạn

Nhấp Select CSV và chọn tệp .csv từ máy tính.
3

Xem xét bản xem trước

Sellfern phân tích tệp và hiển thị bản xem trước trước khi commit bất kỳ điều gì. Kiểm tra định dạng được phát hiện, số lượng đơn hàng, 50 hàng xem trước đầu tiên và các trường tài chính như tổng phụ, giảm giá, tổng và giá trị ròng.
4

Hoàn tất hoặc hủy

Nhấp Finalize Import để commit các đơn hàng đã phân tích, hoặc Cancel để loại bỏ bản tải lên mà không lưu gì. Thẻ hoàn tất hiển thị số lượng đơn hàng được nhập thành công.

​
Nhập thủ công

Manual Entry 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 nó cho đơn hàng tùy chỉnh, đơn hàng qua điện thoại, công việc bán buôn, sửa lỗi và giải quyết các bản nhập thất bại hoặc mất cân đối. Các hành vi quan trọng cần biết trước khi bắt đầu:
  • Order ID là bắt buộc. Sellfern sẽ không lưu nếu thiếu.
  • Yêu cầu ít nhất một dòng mặt hàng.
  • Số tiền hoàn lại không thể âm. Nhập số tiền khấu trừ dưới dạng giá trị dương.
  • Nếu bạn để trống trường cửa hàng, Sellfern sử dụng Manual Entry làm tên cửa hàng.
  • Nếu bạn để trống tên khách hàng, Sellfern sử dụng Walk-in.
  • Tiền tệ mặc định là USD.
  • Các thay đổi tổng phụ, vận chuyển, thuế và giảm giá tự động tính lại tổng.
  • Các dòng mặt hàng mới mặc định ở số lượng 1, giá 0 và các trường SKU/style/type/size/color trống.
  • Trạng thái của một mặt hàng trở thành Complete khi cung cấp chi phí cơ bản; nếu không, nó vẫn ở Pending Cost.
Để tải và chỉnh sửa một đơn hàng hiện có, nhập ID đơn hàng và nhấp hành động tải. Sellfern điền vào biểu mẫu với các giá trị hiện có để bạn có thể thực hiện các chỉnh sửa có mục tiêu.

​
Xem xét các bản nhập

Sau bất kỳ phương thức nhập nào, hai tab trong nhóm Review giúp bạn phát hiện và sửa các vấn đề.

​
Failed ingestions

Tab Failed Ingestions (chỉ admin) 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 xét bản ghi thô và bối cảnh lỗi của nó.
  • Mở bản ghi thất bại trong Manual Entry để giải quyết thủ công.
  • Xóa từng lỗi riêng lẻ hoặc chọn nhiều bản ghi để xóa hàng loạt.
Khi bạn giải quyết một lần nhập thất bại qua Manual Entry và lưu thành công, Sellfern xóa bản ghi nhập thất bại tự động.

​
Out of balance

Tab Out of Balance liệt kê các đơn hàng có tổng được ghi không khớp với phép toán chi tiết của đơn hàng. Điều này bắt được các vấn đề về parser, chênh lệch giảm giá, chênh lệch vận chuyển và dữ liệu khách hàng bất thường. Sử dụng bộ lọc cửa hàng, khoảng ngày và điều khiển phân trang để thu hẹp danh sách, sau đó nhấp hành động chỉnh sửa để mở đơn hàng trong Manual Entry và sửa các tổng hoặc dòng mặt hàng.

​
Xử lý sự cố

Kết nối tài khoản Gmail trước, hoặc chờ đồng bộ hiện tại kết thúc trước khi bắt đầu cái mớ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.
Xác minh số đơn Etsy chính xác. Nếu bạn đang sử dụng truy vấn Gmail tùy chỉnh, hãy kiểm tra cú pháp hợp lệ và khớp với email bạn mong đợi.
Xem xét bảng Extraction Details để tìm manh mối. Nếu email không thể được phân tích tự động, hãy tạo đơn hàng bằng Manual Entry.
Nhập cả ngày bắt đầu và ngày kết thúc. Đồng thời kiểm tra rằng không có đồng bộ nào khác đang chạy.
Hủy bản 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 lại nào được nhập dưới dạng số dương.
Kiểm tra vai trò người dùng và quyền truy cập ingest. Người dùng không phải admin bắt đầu trên Legacy Bulk và không thấy Live Sync, BigQuery hoặc các tab Review chỉ dành cho admin.