Cửa hàng và Nhà cung cấp

Cửa hàng và nhà cung cấp là các thực thể nền tảng trong Sellfern. Đơn hàng gắn với cửa hàng, và chi phí được điều khiển bởi việc gán nhà cung cấp. Cấu hình cả hai trước khi nhập đơn hàng để tránh các bản ghi không khớp và giảm công việc dọn dẹp.

​

Thêm cửa hàng

Vào Cài đặt → Cửa hàng để định nghĩa các storefront mà đơn hàng của bạn thuộc về. Đối với mỗi cửa hàng, cung cấp:

• Tên cửa hàng — tên hiển thị cho storefront (ví dụ “My Etsy Shop”).
• Mã cửa hàng — định danh ngắn được sử dụng cho khớp SKU và báo cáo (ví dụ ST-001).
• Nền tảng (Platform) — chọn Etsy (OAuth 2.0 PKCE) hoặc Shopify (Webhook/Custom App).
• Etsy Shop ID — mã ID số của cửa hàng Etsy tự động nhận diện từ API Etsy khi ủy quyền hoặc tạo cửa hàng.
• Trạng thái hoạt động — cửa hàng có đang được sử dụng hay không.

​

Tích hợp trực tiếp Etsy OAuth 2.0 PKCE

Để kích hoạt tự động đồng bộ đơn hàng (GET /receipts) và tự động đẩy mã vận đơn (POST /tracking), hãy ủy quyền cửa hàng của bạn qua OAuth chính thức của Etsy:

1. Kích hoạt ủy quyền qua 1 trong 3 vị trí giao diện:
   • Bấm nút Connect / Reconnect Etsy API trên banner cảnh báo ở đầu trang (khi có cửa hàng ngắt kết nối).
   • Nhập thông tin trong khung Thêm / Chỉnh sửa Cửa hàng (chọn Nền tảng Etsy) và bấm Connect via Etsy OAuth 2.0 (hoặc Reconnect via Etsy OAuth 2.0).
   • Bấm 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.
2. Cấp quyền truy cập đọc/ghi (transactions_r, transactions_w, shops_r, email_r).
3. Khi quay lại Sellfern, hệ thống lưu mã access & refresh token mã hóa, tự động làm mới access token trước khi hết hạn.
4. Trạng thái kết nối API: Kiểm tra nhãn trạng thái bên cạnh cửa hàng Etsy:
   • Connected (Màu xanh): Token OAuth hoạt động bình thường.
   • Disconnected (Màu vàng): Thiếu token hoặc hết hạn — bấm Reconnect để ủy quyền lại.
   • Banner nhắc kết nối lại: Nếu có cửa hàng Etsy bị mất kết nối API, banner cảnh báo xuất hiện ở đầu trang Cài đặt → Cửa hàng.
   • Hành động ngắt kết nối: Sử dụng Disconnect API Integration để ngắt kết nối an toàn mà vẫn giữ nguyên lịch sử đơn hàng.

Sellfern hiện tại hỗ trợ tích hợp trực tiếp với Etsy và các storefronts kết nối, đồng thời có kế hoạch hỗ trợ Amazon, WooCommerce, Faire trong tương lai. Sau khi cửa hàng được cấu hình, bộ chọn cửa hàng trên thanh bên có thể lọc dữ liệu trên toàn bộ không gian làm việc, bao gồm đơn hàng, phân tích và chế độ xem xử lý đơn.

​

Email Map

Email Map kết nối địa chỉ email người gửi với các cửa hàng cụ thể. Sellfern dùng các ánh xạ này trong quá trình Gmail Live Sync để định tuyến đơn hàng đến đúng storefront một cách tự động. Để thêm ánh xạ, vào Cài đặt → Email Map, nhập địa chỉ email người gửi và chọn cửa hàng đích. Thêm một ánh xạ cho mỗi địa chỉ người gửi cần định tuyến đến một cửa hàng.

​

Thêm nhà cung cấp

Vào Cài đặt → Nhà cung cấp để tạo hồ sơ nhà cung cấp cho các đối tác tham gia sản xuất và xử lý đơn. Hồ sơ nhà cung cấp phục vụ hai mục đích:

1. Quy trình chi phí — khi bạn gán nhà cung cấp cho một mặt hàng trong Ledger, Sellfern sử dụng hồ sơ nhà cung cấp để theo dõi chi phí sản xuất đối với đối tác đó.
2. Người dùng vai trò Nhà cung cấp — nếu bạn tạo người dùng với vai trò Nhà cung cấp, tài khoản đó phải được liên kết với một hồ sơ nhà cung cấp. Hồ sơ được liên kết kiểm soát những gì đối tác bên ngoài có thể truy cập.

Đối với nhà cung cấp tích hợp như Printway và BurgerPrints, hãy kết nối hồ sơ nhà cung cấp từ COGS / Xử lý đơn → Sync Hub. Sau khi kết nối, Sellfern có thể lấy thông tin chi phí và mã vận đơn qua quy trình sản phẩm thay vì yêu cầu cập nhật thủ công mỗi lần.

​

Ánh xạ VAT/IOSS

Vào Cài đặt → VAT/IOSS để cấu hình ánh xạ VAT và IOSS cho các đơn hàng EU và quốc tế. Sellfern áp dụng các ánh xạ này trong quá trình tiếp nhận đơn hàng để các đơn hàng đến với định danh thuế phù hợp được gán sẵn. Thiết lập ánh xạ VAT/IOSS trước khi nhập đơn hàng từ các khu vực yêu cầu các định danh này. Cấu hình sau có nghĩa là các đơn hàng hiện có có thể cần xem xét thủ công.

​

Tỷ giá hối đoái

Vào Cài đặt → Tỷ giá hối đoái để cấu hình ánh xạ tiền tệ và hành vi chuyển đổi cho các đơn hàng đa tiền tệ. Khi đơn hàng đến bằng đồng tiền khác với tiền cơ sở của bạn, Sellfern dùng các cài đặt này để chuyển đổi số tiền nhất quán giữa các báo cáo và phân tích.

​

Hướng dẫn API và tự động hóa

Không dựa vào các route nội bộ của cài đặt hoặc nhà cung cấp cho tích hợp công khai. Sử dụng bắt đầu nhanh cho nhà phát triển và Tham chiếu API cho tự động hóa công khai được hỗ trợ.