> ## 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.

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

> Kết nối Printify, Printful, Zenith, API tùy chỉnh, Webhook thời gian thực và Google Sheets để tự động hóa giá vốn (COGS) và mã vận đơn.

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)](#1-thu-vien-mau-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](#2-ket-noi-rest-api-tuy-chinh)** — 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](#3-webhook-thoi-gian-thuc-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](#4-google-sheets-supplier-tabs)** — Đồ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](https://printify.com) 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](https://developers.printful.com).
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`:
   ```json theme={null}
   {
     "orders": [
       {
         "orderId": "1001",
         "cost": 14.50,
         "trackingCode": "9400111899223192000000",
         "carrier": "USPS"
       }
     ]
   }
   ```