> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.
# 目錄欄位與說明
## 商家資料表
| 欄位名稱 | 限制 | 說明 | 資料表 |
| ----------------------------------- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| `merchant_name` | Text | 這是特定禮品卡商家的名稱。若你呼叫的目錄會同時顯示同一商家的固定與可變面額優惠，則每一種優惠類型都會在該商家下有一筆獨立紀錄。 | Merchant |
| `merchant_slug` | Text | 這是商家的縮短名稱。可用於透過 API 將購買資料傳遞給 Fluz 的特定商家。同時也用於在 Fluz 網頁應用程式上產生商家 URL。URL 結構為 [https://fluz.app/store/merchant\_slug](https://fluz.app/store/merchant_slug) | Merchant |
| `updated_at` | Date, time stamp | 該商家資料表紀錄的最後更新時間 | Merchant |
| `created_at` | Date, time stamp | 此商家加入我們目錄的日期 | Merchant |
| `merchant_status` | Active or Inactive | 指示此商家目前是否可供購買。商家狀態可以是啟用或停用。若商家被封存，將會從目錄匯出中完全移除。 | Merchant |
| `logo_url` | URL | 商家標誌的圖片。這會是商家標誌的正方形圖片，為 300 x 300 像素的向量圖。 | Merchant |
| `faceplate_image` | JSON | 不同尺寸禮品卡圖片的 JSON 物件。這些是商家提供的官方禮品卡圖片。 | Merchant |
| `primary_color` | Hex Code | 為了在你的體驗中呈現，Fluz 會提供商家標誌圖片的主色。 | Merchant |
| `type` | Gift Card or Card Linked Offer | Fluz 同時提供禮品卡優惠與卡片連結優惠。這取決於特定商家。每個商家可以有任一選項。此欄位會確認優惠類型是禮品卡優惠或卡片連結優惠。 | Merchant |
| `category` | List | 這是商家在整體 Fluz 目錄中的分類對應。 | Merchant |
| `daily_limit-consumer` | Number | 在單一天內，單一商家可購買的最高金額上限。此為註冊為消費者帳戶的單一使用者帳戶。日曆天以 UTC 時區運行，限額每日重置。 | Merchant |
| `daily_limit-commercial` | Number | 在單一天內，單一商家可購買的最高金額上限。此為註冊為商業帳戶的單一使用者帳戶。日曆天以 UTC 時區運行，限額每日重置。 | Merchant |
| `monthly_limit-consumer` | Number | 在單一日曆月內，單一商家可購買的最高金額上限。此為註冊為消費者帳戶的單一使用者帳戶。日曆月以 UTC 時區運行，從每月第一天至該月最後一天，限額每月重置。 | Merchant |
| `monthly_limit-commercial` | Number | 在單一日曆月內，單一商家可購買的最高金額上限。此為註冊為消費者帳戶的單一使用者帳戶。日曆月以 UTC 時區運行，從每月第一天至該月最後一天，限額每月重置。 | Merchant |
| `website_url` | URL | 此特定商家的 URL。請注意，若商家有多個 URL 或子網域，Fluz 會僅提供該商家的單一 URL。 | Merchant |
| `redemption_information` | Text | 關於如何在該特定商家兌換禮品卡的詳細資訊。這些可以是特定規範 | Merchant |
| `parent_company` | Text | 若特定商家的禮品卡可用於其他零售品牌，我們會列出母公司的名稱 | Merchant |
| `redeemable_at_other_brands` | List | 此禮品卡可在哪些其他商家兌換。有時是同一母公司底下的其他子商家；其他時候則可能是多品牌卡可使用的一系列商家。
範例：
Uber 禮品卡可於 Uber + Uber Eats 兌換
Gap 禮品卡可於 Gap + Old Navy + Banana Republic + Athleta 兌換
Happy Card Retail Therapy 卡可於 Lululemon、Macys、Nike、Boohoo 等兌換 | Merchant |
| `merchant_gift_card_redemption_url` | Text | 若商家有特定的 URL 可將禮品卡餘額直接套用至你在該商家的帳戶，該特定 URL 會在此欄位提供。 | Merchant |
| `description` | Text | 商家的完整詳細描述。 | Merchant |
| `short_description` | Text | 該商家描述的精簡版本。 | Merchant |
| `merchant_support_phone_number` | Phone Number | 若商家提供專門處理其禮品卡計畫支援問題的電話號碼，會在此提供。 | Merchant |
| `merchant_support_email` | Email address | 若商家提供專門處理其禮品卡計畫支援問題的電子郵件地址，會在此提供。 | Merchant |
## 優惠資料表
| 欄位名稱 | 限制 | 說明 | 資料表 |
| ----------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
| `offer_id` | UUID | 這是你將參考使用的公開優惠 ID | Offer |
| `rate` | number | 這是該商家上的最佳回饋率。
若固定與可變面額具有相同回饋率，則只需包含可變面額。
若可變面額的回饋率低於固定面額，請同時包含可變與固定面額優惠，除非你呼叫的是僅含可變面額優惠的目錄。
若商家有多個不同面額的固定面額優惠且回饋率不同，則每個面額 + 回饋率組合都會有一筆獨立優惠。 | Offer |
| `denomination_type` | Fixed or Variable | 此欄位對應於該特定優惠的面額類型。每個最高價值的優惠都會有自己的紀錄。 | Offer |
| `denominations` | number range | 此欄位對應於該特定優惠的面額。
**可變面額優惠** - 我們會提供兩個數值作為面額範圍。第一個為下限，第二個為上限。下單時你可以傳入該範圍內的任何數值。
**固定面額優惠** - 我們會列出該優惠的所有面額。請注意，若某商家的不同固定面額有不同回饋率，每一個都會是獨立的優惠。在各自的優惠中，我們會列出該特定回饋率下的面額。 | Offer |
| `card_format` | URL or code | 有些商家僅允許以代管 URL 方式傳遞禮品卡。在此情況下，我們會告知你可預期的格式。 | Offer |
| `barcode_type` | 128, UPC, QR, None | 有些零售商需要條碼或 QR 碼，且其中部分需對禮品卡代碼進行處理以產生條碼號碼，例如加入前綴、刪除部分數字或加入 PIN。為了替客戶消除這些複雜性，我們會在 Issue 回應資料中回傳條碼資訊。 | Offer |
| `currency` | Text | 禮品卡面額所對應的貨幣。 | Offer |
| `countries` | Country list | 指出禮品卡可在哪些國家兌換。
*請注意，每張禮品卡的基礎價值將綁定於禮品卡上列示的貨幣。即使可在其他通常使用不同貨幣的國家使用，其價值仍以列示的貨幣計價。* | Offer |
| `gift_card_expiration_window` | Number | 禮品卡的有效期（月數）。係以自卡片發行起算的月份數為準。若為 null，表示該禮品卡不會到期。 | Offer |
| `merchant_terms` | Text | 商家針對其禮品卡計畫所提供的使用條款。 | Offer |