GF Customs Filing 線上清關系統 — 專案文件總覽

GoFreight × LDS SMS API × CBP ABI/ACE。下方依「程式文件 / P0 TP 同步 / 逐型覆蓋矩陣 / 互動 Portal」分類,所有文件可直接點開。

① 程式層級文件 Program docs

00
MASTER PLAN

總體產品開發計劃

架構、CBP×LDS 報文對應、14 型優先序、頁面/功能矩陣、路線圖、P0 標注。

02
COVERAGE GATE

LDS API 覆蓋與支援矩陣

每型 CBP 報文需求 × LDS API 支援核對;China 加權優先序;Type 47 待確認。

◆ 階段路線圖與工時 依 filing type · ACE-7419

每個 phase = 該階段「可發送的 customs filing type」(highest-priority 跨型功能含 PGA 皆歸 P1)。下表連結各 phase Story。注意:此 P0–P4 軸與 ACE-7511 的 LDS-parity portal 建置階段(P1–P6)是不同軸,勿混淆。
PhaseStoryfiling type / 送件PMBEFEQASDETDevOpsAll-in
P0 地基(MDM)ACE-7691GF↔LDS 資料同步 + 主檔(不送 filing)273220.516.5
P1ACE-7692
+ 7938…7945
01 / 03 / 11 → AE+SE + highest-priority(含 PGA型別主流程 ~20 + highest-priority 103(8 列,含 PGA)123
P2ACE-769361 → InBond QP/WP;86 → SE only~20
P3ACE-769407 → AE+SE;21 → AE+SE;31 → AE;62/63 → InBond~25
P4ACE-7695變體 02/12/23/52 + 22/32/34/3821
合計 P0–P4ACE-74195 phase;PGA 併回 P1≈205.5
2026-06:PGA 併回 P1。PGA workflow(ACE-7945)併回 P1 highest-priority 功能群 = 19 MD,與 Tariff templates + PGA 資料庫(ACE-7939)同在 P1。維持 5 phase(P0–P4):P1(01/03/11 + 全部 8 項 highest-priority 含 PGA)、P2(61/86)、P3(07/21·31/62·63)、P4(變體)。合計 ≈205.5 MD 不變。
2026-06 LDS meeting 重新排序:11 Informal 由 P2 提前到 P1(formal/informal 同構、forwarder 高量);61 In-Bond IT 下移(in-bond 屬不同交易);07 Quota+AD/CVD 下移(量低、後期)。06 FTZ + e-21447 Drawback 同列 Deferred,不在 P1–P4。

◆ Highest-priority 跨型功能 2026-06 LDS meeting · Phase 1

皆歸 P1、最高優先;不綁單一 entry type,構成 P1 可用性主體。本週 Thursday demo 涵蓋 statement / tariff templates / entry 01
Ticket功能All-in 人天
ACE-7938Statement processing(periodic / daily + preliminary statement date + 付款)16
ACE-7939Tariff templates + PGA 資料庫(registration# / device-ID / product-code)20
ACE-7940Print CBP response message(AX / SO / UC + 7501 / 3461)9
ACE-7941Customs warning / alert 通知(census warning / reject / hold)10
ACE-7942建 entry 前 shipment 存在檢查 → update(修 ISF 重複 HBL)9
ACE-7943Chapter-99 / §301 autofill 改用 LDS API7
ACE-7944ISF 資料整合(帶入 entry)13
ACE-7945PGA workflow(CPSC + FDA 先;隨各 filing 夾帶 PG/PGA records;與 LDS 聯合 review)19
小計103
2026-06:PGA workflow(ACE-7945)併回 P1 = 19 MD;與 Tariff templates + PGA 資料庫(ACE-7939)同在 P1。本表 8 列小計 103(84 + 19)。
✅ 已交付(對應 2026-06 LDS meeting):Engineer Debug Log(ACE-7709=「為 LDS 工程師加 API 請求/回應 logging」action item,已上兩個 sandbox;UAT + DEV sandbox(tunnel gf-customs-portal-brad / -dev .hardcoretech.link)為給 LDS 取用的穩定連結;Document sharing(GoFreight → LDS)另線已完成。

② P0 — GF↔LDS 資料同步 + 主檔管理(MDM) ACE-7691 · 平台地基

P0 是所有 filing type 的前置,不送任何 filing。範圍為 GF↔LDS 資料同步與主檔管理(MDM):① Trade Partner 同步(由 GF 發動:LDS 查無 TP → 以 GF 資料建檔 importer 5106 → 帶入 Entry,全程 log,下方四件套);② Contact / Port / Carrier(SCAC) / HTS / 參考表 同步(LDS Extract Reference File Query)。TP sync 只是其中一片。
P0
SPEC ‧ FLOW ‧ MAPPING

TP Master Mapping

對應策略(IRS/ID)、流程圖、欄位 mapping、缺漏候補欄位、logging 規格、設計。

🗒
INTERACTIVE 稽核頁

LDS TP Auto-Create Audit Log

獨立頁:GF 在 LDS 新建哪些 TP;篩選/匯出/明細抽屜/缺漏欄位。

📖
USER MANUAL

TP LDS Sync 操作手冊

圖文:狀態判讀、Find/Create、5106、缺欄位 Pending、帶入 Entry、Activity Log。

04
E2E TEST PLAN

P0 端到端測試計劃

14 測試案例 + 安全 NFR:查找/建檔/5106/缺欄位/帶入 Entry/送件/log/稽核頁;含追溯與出場準則。

③ Type 01 — 旗艦完整套 Spec / Portal / Manual 皆獨立檔

01
SPEC ‧ FLOW ‧ AC ‧ MAPPING

Type 01 產品規格

User story、流程圖、AC、三層欄位對應(UI→LDS→CBP)、LDS API 生命週期。

INTERACTIVE FE

Type 01 互動 Portal

多 shipment、計稅、驗證、送件、CBP 回覆、產生文件、TP LDS Sync。

📖
USER MANUAL

Type 01 客戶手冊

12 步圖文 end-to-end + 常見退件排除。

LDS-PARITY 單一 ENTRY 頁

Customs Entry(LDS 100% 欄位)

Document Map 樹 + 各層分頁,涵蓋 LDS 全部欄位並標 LDS API property(可切換顯示);紅色=待 LDS 確認。對應 05 欄位對應表。

🗺
SITE MAP

Portal 網站地圖

依 LDS 結構的 GF Portal 網站地圖(互動樹+路由/分頁/對應)。

05
FIELD → API

LDS 畫面→API 欄位對應

每欄位對應確切 API property;21 紅旗待 LDS 確認。

④ 逐型覆蓋矩陣 每格可點

圖例:◆ 獨立檔(直接連結) ‧ ● 併入該型 Pack 章節(同一檔的 §A/§C/§E/§G) ‧ ▶ 互動 Portal(可點擊) ‧ 尚無(僅 Pack 內靜態設計圖 §F)
Entry TypeSpecFlow ChartField Mapping / APIInteractive FEUser Manual整合 Pack
01 FormalP1
正式消費進口
—(分檔)
11 InformalP1
非正式進口
Pack
03 AD/CVDP1
反傾銷/平衡稅 · China
Pack
61 In-Bond ITP2
港到港保稅
Pack
86 Section 321P2
小額免稅
Pack
07 Quota+AD/CVDP3
配額+反傾銷 · China
Pack
21 / 31 WarehouseP3
保稅倉進/提
Pack
62 / 63 In-BondP3
T&E / IE 出口
Pack
02 / 12 / 23 / 52P4
配額/TIB/政府等變體
Pack A
22 / 32 / 34 / 38P4
轉倉/提領變體
Pack B
06 FTZ + e-214Deferred
自貿區
Deferred — 複雜、deferred duty,2026-06 LDS meeting 初期排除(文件已備)。
47 DrawbackDeferred
退稅
Deferred — 屬獨立 ACE Drawback CATAIR,且 LDS 提供之 API 無對應 class,待 LDS 補件。
✓ 全部到齊:Spec / Flow Chart / Field Mapping·API / User Manual / Interactive FE 每一型別皆具備(◆ 獨立檔、● 併入該型 Pack、▶ 可點擊 Portal)。Deferred(2026-06 LDS meeting 列為保留,不在 P1–P4):06 FTZ + e-214(文件已備,複雜/deferred duty 初期排除)與 47 Drawback(待 LDS Drawback API)。

⑤ 可點擊互動 Portal 全 11 型/組

▶01
FORMAL

Type 01 Portal

多 shipment → 計稅 → 驗證 → 送件 → CBP 回覆 → 文件 → TP Sync。

▶03
AD/CVD

Type 03 Portal

AD/CVD case、AD/CVD Query、含 AD/CVD 稅額、放行/退件情境。

▶07
QUOTA+AD/CVD

Type 07 Portal

行項 AD/CVD + Visa/Quota;quota 狀態 70-73。

▶11
INFORMAL

Type 11 Portal

informal 資格檢查、名稱地址代 ID、免 bond、MPF 311。

▶86
SECTION 321

Type 86 Portal

Eligibility→Parcels 批量→只送 SE→SO 結果(無 Entry Summary)。

▶06
FTZ

Type 06 Portal

FTZ status PF/NPF/D/Z、PF→SE61;e-214 註記。

▶21/31
WAREHOUSE

Type 21/31 Portal

入倉建 balance / 提貨餘量檢查(AE only)、庫存看板。

▶61
IN-BOND

Type 61 Portal

QP→Movement(MA)→Arrival(WP→AD)→Closed、CBPF-7512。

▶62/63
IN-BOND EXPORT

Type 62/63 Portal

T&E / IE、export port、WP export→ED、export proof。

▶P4A
02/12/23/52

P4A Variants Portal

選子型:配額/informal/TIB(9813+再出口)/政府。

▶P4B
22/32/34/38

P4B Variants Portal

選子型:轉倉 / 提領 Quota·AD-CVD;餘量+模組。