Kết nối Nhà cung cấp & Sync Hub

Sellfern Sync Hub tự động hóa việc lấy chi phí sản xuất (COGS) và thông tin mã vận đơn trực tiếp từ các đối tác sản xuất và xưởng in, loại bỏ việc nhập liệu thủ công và đảm bảo số liệu lợi nhuận luôn chính xác. Bạn có thể kết nối nhà cung cấp theo 4 phương thức:

1. Thư viện Mẫu (Template Library) — Kết nối 1-click cho các đơn vị POD hàng đầu (Printify, Printful, Gelato, FlashPOD,…).
2. Kết nối REST API Tùy chỉnh — Kết nối bất kỳ xưởng in hoặc hệ thống riêng nào bằng JSONPath.
3. Inbound Webhooks — Đẩy dữ liệu đơn hàng ngay tức thì từ Make.com, Zapier hoặc hệ thống xưởng.
4. Google Sheets — Đồng bộ chi phí từ bảng tính Google Sheets dùng chung.

---

​

Truy cập Sync Hub

1. Đi tới Cài đặt → Nhà cung cấp (Settings → Suppliers).
2. Chọn tab Sync Hub (hoặc truy cập /admin/suppliers?view=sync).
3. Nhấp vào nút + Add Supplier ở góc trên bên phải để mở cửa sổ thiết lập.

---

​

1. Thư viện Mẫu (Template Library)

​

Printify

1. Đăng nhập Printify và vào Settings → Developer → API Tokens.
2. Nhấp Generate New Token, cấp quyền đọc Đơn hàng (Orders).
3. Lấy Shop ID từ đường dẫn URL trang quản lý cửa hàng (ví dụ: https://printify.com/app/store/{shopId}).
4. Trong Sellfern, chọn + Add Supplier → Template Library → Printify, nhập Shop ID và API Token.
5. Nhấp Save & Connect. Hệ thống tự động nhân hệ số 0.01 để chuyển đổi cents thành USD chính xác.

​

Printful

1. Đăng nhập Printful Developer Portal.
2. Tạo Personal Access Token với quyền orders_read.
3. Trong Sellfern, chọn + Add Supplier → Template Library → Printful, dán token và nhấp Save & Connect.

​

Zenith Fulfillment

1. Nhận thông tin token hoặc phản hồi JSON từ Zenith.
2. Dán Access Token, Refresh Token hoặc toàn bộ chuỗi JSON trả về vào ô nhập liệu. Hệ thống sẽ tự động trích xuất và làm mới token định kỳ.

---

​

2. Kết nối REST API Tùy chỉnh

Dành cho các xưởng in hoặc nhà cung cấp độc lập có cung cấp REST API:

1. Chọn + Add Supplier → Custom REST API.
2. Nhập Tên hiển thị, Endpoint URL và chọn Loại xác thực (Bearer Token, Custom Header, URL Param hoặc Basic Auth).
3. Cấu hình trích xuất JSONPath:
   • Items Array Path: Đường dẫn tới mảng danh sách đơn hàng (ví dụ: data hoặc orders).
   • Order ID Path: Trường mã đơn hàng (ví dụ: order_id hoặc external_id).
   • Cost Path: Trường tổng chi phí (ví dụ: total_cost hoặc price).
   • Cost Multiplier: Nhập 1 (hoặc 0.01 nếu xưởng trả về đơn vị cents).
   • Tracking Code Path: Trường mã vận đơn (ví dụ: tracking_code hoặc shipments[0].tracking_number).
4. Nhấp Save Custom Connector.

---

​

3. Webhook Thời gian thực (Inbound Webhooks)

1. Chọn + Add Supplier → Inbound Webhook.
2. Nhập tên và nhấp Create Webhook Endpoint.
3. Sellfern sẽ tạo một URL Webhook duy nhất và Secret Token:
   • Header: X-Webhook-Token: <token>
   • Payload JSON gửi qua phương thức POST:
   {
     "orders": [
       {
         "orderId": "1001",
         "cost": 14.50,
         "trackingCode": "9400111899223192000000",
         "carrier": "USPS"
       }
     ]
   }