Skip to main content
Sellfern cung cấp giải pháp tích hợp trực tiếp và độc lập cho các chủ cửa hàng Etsy. Việc kết nối cửa hàng Etsy giúp tự động đồng bộ đơn hàng, điều hướng sản xuất POD, cập nhật mã vận đơn lên Etsy và phân tích chi phí COGS & lợi nhuận thực tế.
Tích hợp Etsy của Sellfern hoàn toàn độc lập. Người bán kết nối trực tiếp qua OAuth 2.0 của Etsy mà không cần tài khoản nền tảng bên thứ ba hoặc ứng dụng trung gian nào.

​
Tính năng & Lợi ích cho Người bán Etsy

  • Đồng bộ hóa hóa đơn đơn hàng tự động: Tự động tải đơn hàng và thông tin giao dịch từ Etsy theo thời gian thực.
  • Điều hướng sản xuất & POD: Tự động gửi đơn hàng mica, tranh, cốc, áo đến các xưởng sản xuất và nhà cung cấp.
  • Tự động đẩy mã vận đơn (Tracking Push-Back): Cập nhật mã vận đơn (USPS, FedEx, DHL…) lên Etsy và đánh giá hoàn thành đơn hàng tự động.
  • Phân tích COGS & Lợi nhuận listing: Tính toán chi tiết chi phí sản phẩm, phí vận chuyển, phí sàn Etsy và lợi nhuận ròng cho từng listing.

​
3 bước kết nối cửa hàng Etsy đơn giản

​
Bước 1: Mở Workspace Sellfern

Đăng ký hoặc đăng nhập vào dashboard Sellfern tại https://sellfern.com. Workspace của bạn được khởi tạo với chế độ bảo mật riêng biệt cho từng shop.

​
Bước 2: Ủy quyền cửa hàng Etsy qua OAuth 2.0

Truy cập Cài đặt → Cửa hàng (Settings → Stores) và kích hoạt ủy quyền Etsy OAuth 2.0 thông qua một trong 3 vị trí sau:
  1. Banner thông báo kết nối lại ở đầu trang: Nhấn nút Connect / Reconnect Etsy API trên banner cảnh báo (hiển thị khi có cửa hàng thiếu token OAuth).
  2. Khung biểu mẫu Thêm / Sửa Cửa hàng: Chọn Nền tảng là Etsy trong khung Thêm / Chỉnh sửa Cửa hàng, sau đó nhấn Connect via Etsy OAuth 2.0 (hoặc Reconnect via Etsy OAuth 2.0 khi chỉnh sửa cửa hàng).
  3. Cột Trạng thái API trong danh sách Cửa hàng: Nhấn liên kết Reconnect trực tiếp dưới cột API Status bên cạnh cửa hàng đang bị ngắt kết nối trong danh sách.
Hệ thống sẽ chuyển hướng bạn đến trang ủy quyền chính thức của Etsy (etsy.com/oauth/connect) để cấp quyền truy cập an toàn với các scope: transactions_r, transactions_w, shops_r, email_r.

​
Bước 3: Kích hoạt tự động hóa xử lý & đẩy Tracking

Sau khi ủy quyền thành công, Sellfern sẽ tự động đồng bộ các đơn hàng chưa giao (GET /v3/application/shops/{shop_id}/receipts). Để kích hoạt tự động điều hướng xưởng sản xuất, tính toán chi phí COGS và đẩy mã vận đơn (tracking) về Etsy, bạn liên kết SKU listing Etsy với SPU catalog sản phẩm trên Sellfern theo 3 phương thức:
  1. Tự động ánh xạ theo quy tắc SKU (SKU Prefix Rules):
    • Truy cập Cài đặt → Danh mục → Quy tắc tiền tố SKU (SKU Prefix Rules).
    • Tạo quy tắc nhận diện SKU (ví dụ: tiền tố EMB-TSHIRT ánh xạ tự động sang SPU TSHIRT-GILDAN-5000).
    • Hỗ trợ độ ưu tiên quy tắc, lọc theo từng store và import hàng loạt bằng file CSV (SKU Prefix, Target SPU, Rule Type, Priority, Store ID).
  2. Ánh xạ trực tiếp SPU trong Catalog:
    • Truy cập System Products / Catalog.
    • Liên kết trực tiếp SKU của listing với mã SPU và biển thể tương ứng (Size/Màu sắc).
  3. Cấu hình nhà cung cấp cho SPU (SPU Definitions):
    • Truy cập Cài đặt → Danh mục → Khai báo SPU (SPU Definitions).
    • Gán từng mã SPU cho xưởng sản xuất tương ứng cùng khung giá gốc.

​
Sơ đồ luồng tự động hóa toàn trình (End-to-End Automated Workflow)

​
Quản lý kết nối Cửa hàng & Theo dõi trạng thái OAuth

Sellfern cung cấp chỉ báo trạng thái API theo thời gian thực và quy trình kết nối lại trong Cài đặt → Cửa hàng:
  • Chỉ báo trạng thái API: Hiển thị Connected (Đã kết nối) với dấu tích xanh khi token OAuth hoạt động, hoặc Disconnected (Đã ngắt kết nối) với cảnh báo màu vàng khi cần ủy quyền lại.
  • Banner cảnh báo cửa hàng ngắt kết nối: Hiển thị nổi bật các cửa hàng Etsy bị thiếu token OAuth để quản trị viên nhanh chóng kết nối lại.
  • Tự động nhận diện Etsy Shop ID: Tự động lấy Shop ID từ API của Etsy trong quá trình ủy quyền OAuth hoặc khi tạo/lưu cửa hàng.
  • Điều khiển Kết nối lại & Ngắt kết nối: Dễ dàng kích hoạt lại OAuth 2.0 hoặc hủy kết nối API một cách an toàn mà không làm mất lịch sử đơn hàng.

​
Sơ đồ luồng xử lý dữ liệu

​
Danh mục Endpoint Etsy OpenAPI v3 chi tiết

  • Tải đơn hàng chưa giao (Receipts): GET /v3/application/shops/{shop_id}/receipts (Scope: transactions_r, Params: was_paid=true, was_shipped=false, limit=100, offset=0 với phân trang tự động, Header: Authorization: Bearer <access_token>, x-api-key: <apiKey>:<sharedSecret>)
  • Tải chi tiết sản phẩm & ghi chú cá nhân hóa: GET /v3/application/shops/{shop_id}/receipts/{receipt_id}/transactions (Scope: transactions_r)
  • Tự động đẩy mã vận đơn (Tracking Push-Back): POST /v3/application/shops/{shop_id}/receipts/{receipt_id}/tracking (Scope: transactions_w)
  • Xác thực shop: GET /v3/application/shops/{shop_id} (Scope: shops_r)