環境與測試¶
環境資訊¶
| 環境 | Base URL |
|---|---|
| 正式 | https://func-posingest-dev.azurewebsites.net/pos/v1 |
目前只有一個環境，推送的資料都會進入正式資料。
帳號資訊¶
總部會提供下列資訊：
| 項目 | 說明 |
|---|---|
| API 金鑰 | 呼叫時放在 x-functions-key header（請妥善保管，不得寫入程式碼或版本控制），見驗證與授權 |
| 門市清單 | 總部登記給合作夥伴的 store_id，請完全照提供的代碼使用 |
| 測試門市 | 專供測試用的門市代碼（例 NCMD-TEST） |
申請方式：請聯絡總部串接窗口。
串接測試¶
因為沒有獨立的測試環境，開發與測試期間請使用測試門市代碼。總部報表會排除測試門市的資料。
- 用測試門市推送一個完整營業日：商品、交易，最後送日結。
- 查詢對帳結果，應為
MATCHED。 - 通知總部測試完成；總部確認後，再用實際門市代碼推送正式資料。
注意
不要用實際門市代碼送測試或假資料，否則會被計入銷售報表。
測試資料：Fried Chicken Master 菜單¶
測試時可使用下列菜單作為門市商品資料，本文件的範例也以此菜單為準。
商品¶
| product_id | 名稱 | product_type | 價格 (USD) | 選項群組 | 套餐內含 |
|---|---|---|---|---|---|
| COMBO-01 | Master Tender Sandwich Combo | COMBO | 13.49 | COMBO_DRINK | SGL-TENDER-SANDWICH + SIDE-FRIES + DRK-FOUNTAIN |
| COMBO-02 | Master Jimbo Combo | COMBO | 14.49 | FLAVOR_JIMBO, COMBO_DRINK | SGL-JIMBO + SIDE-FRIES + DRK-FOUNTAIN |
| COMBO-03 | Master Jimbowl Combo | COMBO | 14.49 | FLAVOR_JIMBO, COMBO_DRINK | SGL-JIMBOWL + SIDE-FRIES + DRK-FOUNTAIN |
| COMBO-04 | Master Chicken (Katsu) Combo | COMBO | 14.49 | COMBO_DRINK | SGL-KATSU + SIDE-FRIES + DRK-FOUNTAIN |
| COMBO-05 | Master Tenders 3PC Combo | COMBO | 14.49 | COMBO_DRINK | SGL-TENDERS-3PC + SIDE-FRIES + DRK-FOUNTAIN |
| COMBO-06 | Master Wings 6PC Combo | COMBO | 15.49 | COMBO_DRINK | SGL-WINGS-6PC + SIDE-FRIES + DRK-FOUNTAIN |
| SGL-JIMBO | Master Jimbo | SINGLE | 9.49 | FLAVOR_JIMBO | — |
| SGL-TENDER-SANDWICH | Master Tender Sandwich | SINGLE | 8.49 | — | — |
| SGL-TW-CRISPY | Taiwanese Crispy Chicken | SINGLE | 9.49 | — | — |
| SGL-KATSU | Master Chicken (Katsu) | SINGLE | 9.49 | — | — |
| SGL-TENDERS-3PC | Master Tenders 3PC | SINGLE | 9.49 | — | — |
| SGL-WINGS-6PC | Master Wings 6PC | SINGLE | 10.49 | — | — |
| SGL-JIMBOWL | Master Jimbowl | SINGLE | 11.49 | FLAVOR_JIMBO | — |
| SIDE-RICE | Seasoned Rice | SIDE | 3.49 | — | — |
| SIDE-FRIES | Fries | SIDE | 4.49 | FRIES_EXTRA_FLAVOR | — |
| SIDE-COLESLAW | Coleslaw | SIDE | 4.49 | — | — |
| SIDE-CHEESE-CORN | Cheese Corn | SIDE | 5.49 | — | — |
| SIDE-BEEF-GYOZA | Beef Gyoza | SIDE | 6.49 | — | — |
| DRK-FOUNTAIN | Fountain Drinks | DRINK | 2.99 | — | — |
| DRK-TW-LEMONADE | Taiwan Signature Lemonade | DRINK | 5.49 | — | — |
| DRK-KUMQUAT-LEMONADE | Kumquat Lemonade | DRINK | 5.49 | — | — |
| DRK-BOBA | Taiwan Boba Tea | DRINK | 6.49 | — | — |
選項群組¶
| group_id | 選項 | 加價 | 必選 |
|---|---|---|---|
| FLAVOR_JIMBO | Taiwanese Salt & Pepper / Thai Sweet Chili / Mala Hot Sauce | 0.00 | 必選 1 個 |
| FRIES_EXTRA_FLAVOR | Seaweed / Cheese Powder | +0.75 | 選填 0～2 個 |
| COMBO_DRINK | Fountain（預設）/ Taiwan Signature Lemonade / Kumquat Lemonade / Taiwan Boba Tea | 0.00 / +2.50 / +2.50 / +3.50 | 必選 1 個 |
Note
product_id 為測試用代碼，正式上線請使用合作夥伴 POS 的實際代碼。