Please enable JavaScript.

Coggle requires JavaScript to display documents.

ec magento - Coggle Diagram

- - - - 帳號認領(Claim)
- - - - 核准逾時提醒、入倉超時、退款超時
      - 自動催件 / 自動關單（逾期未寄回）
  - - - 提供收據 PDF（訂單金額、日期、品名）
      - 售後變動：重發收據 / 註記退款
    - - 作廢 / 折讓：
        
        Void：付款未請款 → 無發票
        
        退款（已請款）：開折讓單（部分/全額），連動退款單
      - 開立時機：paid.captured 或 shipped（依政策）
      - 載具 / 捐贈碼支援，中獎兌獎流程（若使用電子發票）
  - - - Void（取消授權）：已授權未請款（落在 paid.authorized）
      - Capture Refund（請款後退款）：全額 / 部分退款
      - 離線退款：ATM 匯款、現金（需留憑證）
    - - refund_requested → refund_processing → refunded（成功） / refund_failed（失敗）
      - 對應訂單 Life Cycle：最終落在 refunded（Status 細分 full/partial/chargeback）
    - - 退款單（Credit Memo / Refund Record）：與 payment_intent_id 關聯、金額快照、手續費
      - Idempotency key：避免重複退款
      - 部分退款：逐項目 / 自由金額，記錄退稅、退運費
    - - 回補庫存（可勾選：開封/未開封才回補）
      - 回收與重算：點數、滿額門檻、會員等級、優惠券名額
      - 通知：退款入帳時間說明（信用卡 3–14 天、電子錢包即時/隔日）
    - - Webhook 回寫：refunded / refund_failed
      - 日結對帳：金流退款紀錄 vs 系統退款單；差異自動建工單
  - - - 申請入口：訂單詳情頁（僅可針對 completed / 已收貨 N 天內）
      - 退貨原因（多選 + 自填）、上傳照片、可申請件數（逐 SKU / 批次）
      - 規則檢核：超過鑑賞期、不可退商品（耗材/客製）、贈品處理邏輯
      - 審核結果：核准 / 部分核准 / 駁回（給出說明）
    - - requested → approved → inbound（客戶寄回）→ inspected（品檢）→ completed（結案）
      - 例外終止：rejected（駁回） / abandoned（逾期未寄回）
    - - approved.waiting_shipping_label（待提供退貨標籤）
      - inbound.carrier_accepted / inbound.in_transit / inbound.delivered
      - inspected.qc_pass / inspected.qc_fail_damage / inspected.missing_items
    - - 退貨物流：自寄 / 到府取件 / 超取
      - 退貨標籤產生、追蹤碼回寫、到貨自動更新
      - 倉內流程：拍照留存、品檢結果記錄、可再販狀態（A良品/B整修/C報廢）
      - 入庫策略：良品回補可售庫存 or 次級庫位
    - - 退貨比例：項目級（line-item）/ 訂單級（整單）
      - 贈品/加購：是否需退回？未退回則扣回價值
      - 運費處理：瑕疵免運 / 後悔退需扣原運
- - - - 訂單 Paid 但金流無紀錄 → 轉人工覆核佇列
      - 金流成功但訂單未 Paid → 自動補寫 Paid + 記歷程
    - - 記錄手續費、淨撥款額（供報表毛利/淨利）
    - - 下載金流對帳檔（交易、費用、撥款）
      - 自動比對：金額/幣別/intent_id/授權碼
    - - Webhook 進件 → 標記 status=refunded.chargeback、生命週期落 refunded
      - 觸發風控：列入黑名單／限制 COD
  - - - Webhook 超時或失敗 → 進重試佇列（指數退避）
      - 最多 N 次；仍失敗 → 建「人工對帳工單」
    - - Batch 任務掃描：授權即將到期 → 自動請款 / 提醒客服
    - - 下單過程中金流失敗 → 回退庫存預留、回收優惠券名額、還原點數
    - - 補償動作：回補庫存（可選條件）、回收點數、重算會員等級/活動門檻
    - - 任何「會改動金額或狀態」的動作都必須帶 idempotency key
  - - - 以 payment_intent_id / gateway_event_id 去重
      - 重送（retry）不重複建單/不重複請款
    - - 驗證來源（簽章/白名單 IP/TLS）
    - - authorized、captured、failed、refunded、chargeback
      - 映射到你的 Life Cycle（只改 life_cycle，不強耦合 status）
    - - 前端回跳顯示「付款確認中」
      - 以 Webhook 結果為準最終落單
  - - - 授權/請款分離（Auth/Capture）
      - 立即請款（Sale）
      - 錢包/第三方：Apple Pay / Google Pay / LINE Pay 等
    - - 產生 payment_intent_id（冪等鍵）
      - 對應訂單（order_id）與金額快照、幣別、到期時間
    - - 3-D Secure（可能多一次跳轉）
      - 風險評分（高風險 → 僅授權不請款 / 手動覆核）
    - - PCI-DSS：不落卡號，僅存 token / 授權碼
      - 前端用金流 SDK/Hosted Fields，後端只收 token
  - - - 下單、intent 建立、3DS 跳轉、回調收/處理、對帳差異、重試次數
    - - Webhook 失敗率、回調延遲 P95、授權即將到期數、對帳不一致筆數
    - - 全部支付相關動作進 payment_events（誰、何時、結果、原始 payload 摘要）
  - - - 前後端統一小數位與 rounding（Banker’s rounding/ceil/floor）
    - - 下單前試算、下單時鎖定、退款時重算可退稅額
    - - 訂單上鎖 base_currency 與 display_currency、匯率時間點
  - - - 金鑰、端點、簽章密鑰管理（Secrets）
    - - 逐步放量新金流／新 3DS 規則
    - - 成功、逾時、拒絕、3DS 失敗、Webhook 重送、部分退款、重複回調
- - - - created（已建立） → ready_to_ship（待交寄） → in_transit（運送中） → delivered（已送達）
      - 例外：failed（寄件失敗）、returned（退回）
  - - - Webhook：物流商主動回推狀態（攬收/配送中/異常/簽收）。
      - Polling：排程拉取狀態（避免漏訊）。
    - - 顧客：已出貨 / 運送中 / 配達中 / 已送達 / 配送異常。
      - 後台：更細（攬收、物流中心、配送中、延誤）。
    - - 一筆訂單可能同時有宅配 + 超取，系統要支援多 tracking number。
    - - 出貨通知（含 Tracking Link）
      - 狀態變更通知（例如：到店待取、最後領取期限提醒）
  - - - 黑貓/郵局/宅配通等，支援貨到付款（COD）。
      - 物流 API：建立託運單、列印面單、查詢狀態。
      - 限制：偏遠地區、超材商品。
    - - 7-11、全家、萊爾富、OK。
      - 特殊流程：
        
        建立「店號」與收件資訊 → API 回傳寄貨代碼/託運單號。
        
        貨到店 → 通知顧客取貨。
        
        逾期未取 → 自動退回（系統需回寫退貨流程）。
      - 跨境物流
        
        空運/海運集運 → 需要 HS Code、商品材積、出口報關。
        
        時效長，狀態節點多。
  - - - 出貨單 → 出貨單明細 → 揀貨單（Pick List）
      - 條碼掃描 → 確認 SKU 與數量
      - 打包 → 列印標籤 / 託運單面單
    - - 扣庫存：由 Order Item → Shipment Item → Inventory
      - 出庫事件：同步到庫存系統（避免 oversell）
    - - 支援訂單部分品項先出，剩餘品項待補貨。
      - Order 保持 open 狀態，直到所有出貨單 closed 才轉 completed。
  - - - 訂單計算運費（下單鎖定）
      - 出貨單可記錄實際物流費用（供報表比對）
    - - 物流收款 → 回款給商家 → 系統需有「待對帳」狀態
    - - 訂單運費 vs 物流商對帳單
      - COD 金額 vs 物流商代收金額
- - - - 版本化（可回滾）、稽核（誰改了什麼）、生效範圍（整站/單商店）
      - 驗證規則（型別/範圍/依賴）、草稿與發佈（避免一鍵上線出錯）
  - - - 粒度：資源（Orders/Products/Customers/Settings）× 動作（R/W/D/Export/Approve）
  - - - 節流（Rate Limit）、死信佇列（DLQ）、超時/退避重試
  - - - CDN/Edge：靜態資產、商品頁快照、API GET（短 TTL + 失效）
      - 應用程式快取：Config / 字典資料 / 類目或標籤樹 / 推薦清單
      - 資料庫層：查詢結果快取、索引優化、讀寫分離
- - - - 商品名稱 / 品牌 / 標籤 / SKU 編碼
    - - 輸入時即時顯示商品、品牌、熱門關鍵字
    - - 依相關度 / 銷量 / 上架時間 / 價格
    - - Roja ↔ 羅賈、EDP ↔ Eau de Parfum
  - - - 現代：預設篩選器入口
      - 傳統：Category 導覽
    - - 熱銷商品
      - 新品上市
      - 編輯精選（人工策展）
      - AI/規則推薦（買了這個的人也買了…）
    - - 節慶專區
      - 功能專區
  - - - 熱門專區入口（男香、女香、小眾香）
    - - 多張廣告圖（可排程上下架）
    - - 大型行銷活動 / 新品主打
    - - 「本月熱銷 Top 10」
      - 「限量專區」
      - 「最新到貨」
- - - - 滿 NT$3,000 → 可用優惠價加購旅行瓶
    - - 購物車有 EDP → 顯示 EDT + 特價組合
    - - 加購商品（如：購買香水 → 推薦小樣、蠟燭）
    - - 根據瀏覽或購買紀錄，推薦補充購買
  - - - 避免多人同時搶購超賣
    - - 有庫存 / 即將售罄 / 售罄不可加購
    - - 加入購物車時檢查庫存
    - - 結帳時若某商品售罄 → 整單失敗 / 只刪除該商品（策略可選）
  - - - 不登入即可加商品進購物車
      - 透過 Session / Cookie 維護
      - 可選擇後續結帳時轉換成「已登入會員購物車」
    - - 與帳號綁定，可跨裝置同步
      - 支援「持久化購物車」：登入後會合併匿名購物車與會員購物車
  - - - 支援輸入折扣碼、顯示已套用優惠
    - - 輸入郵遞區號或地區 → 顯示運費估算
    - - 數量增減 → 金額自動更新
    - - 收藏購物車內容，日後回購
- - - - 建立訂單 → Email 確認信
      - 付款成功 → 通知信
      - 出貨 → 出貨單號通知
      - 完成 → 感謝信 / 評價邀請
    - - 新訂單通知（客服 / 倉庫）
      - 庫存不足提醒
    - - Email（基本）
      - SMS / LINE Notify（進階）
      - App 推播（如果有 App）
  - - - 與購物車綁定（Cart → Order）
      - 與金流交易號綁定（方便核對付款狀態）
    - - 唯一值（通常 = 日期 + 隨機碼）
    - - 前台結帳完成 → 建立訂單
      - 後台人工新增（客服幫顧客下單）
  - - - pending（待付款）
      - paid（已付款 / 已授權）
      - processing（待出貨 / 配貨中）
      - shipped（已出貨）
      - completed（已完成 / 已送達）
      - canceled（已取消）
      - failed（付款失敗 / 建單失敗）
      - refunded（已退款；含全退或結案）
    - - A. Life Cycle: pending
        
        pending.awaiting_payment（等待付款）
        
        pending.atm_unpaid（ATM 未轉帳）
        
        pending.offline_checking（線下匯款覆核中）
        
        pending.payment_review（金流審查中 3DS/風控）
      - B. Life Cycle: paid
        
        paid.authorized（信用卡已授權待請款）
        
        paid.captured（已請款入帳）
        
        paid.cod_confirmed（貨到付款已確認）
        
        paid.wallet_hold（錢包預扣）
      - C. Life Cycle: processing
        
        processing.picking（揀貨中）
        
        processing.packed（已打包）
        
        processing.awaiting_stock（等待到貨/調撥）
        
        processing.hold_customer（買家要求暫緩出貨）
      - D. Life Cycle: shipped
        
        shipped.carrier_accepted（物流已攬收）
        
        shipped.in_transit（運送中）
        
        shipped.out_for_delivery（配送中/今日配達）
        
        shipped.delay_exception（物流異常/延誤）
      - E. Life Cycle: completed
        
        completed.delivered（已送達）
        
        completed.auto_after_7d（滿 7 天自動完成）
        
        completed.signed_by_guard（由管理員代收）
      - F. Life Cycle: canceled
        
        canceled.by_customer（買家取消）
        
        canceled.payment_timeout（付款逾時）
        
        canceled.duplicated（重複訂單）
        
        canceled.anti_fraud（風控取消）
      - G. Life Cycle: failed
        
        failed.payment_declined（付款被拒）
        
        failed.gateway_error（金流錯誤）
        
        failed.order_build_error（建單失敗）
      - H. Life Cycle: refunded
        
        refunded.full（全額退款）
        
        refunded.partial（部分退款）
        
        refunded.chargeback（信用卡拒付結案）
        
        refunded.rma_completed（退貨入庫結案）
- - - - 固定金額（滿千折百）
      - 百分比（滿額打折，含上限）
      - 免運券
      - 首購限定、新客券
    - - 使用期限、適用商品/類別、會員群組
      - 單人限用次數、是否可疊加
    - - 批次生成、匯出、單碼 / 通用碼
      - 使用紀錄（誰用了幾次，哪張訂單）