GF→LDS Trade Partner Sync

報關需要在 LDS 後端有對應的 Trade Partner（Contact）。當你在 GoFreight 指定的 TP 在 LDS 還不存在時，系統會由 GF 發動、用 GF 資料在 LDS 自動建檔（進口商還會送 CBP 5106），再帶回你的 Customs Entry。

i

對應規則進口商（Importer）用 IRS No. 比對；其他 TP（Consignee / Shipper / Customer）用 GF ref（ID） 比對。所有動作都會寫入稽核紀錄。

準備	說明
TP 基本資料	名稱、（進口商）IRS No. 或 SSN/CBP No.
地址	mailing 地址（街/市/州/郵/國）與 address type — 建 importer（5106）必要
角色	該 TP 是 importer / consignee / shipper 哪一種

!

提醒GF 目前的 TP 資料若只有 ref/name，缺 IRS 或地址，系統會把建檔標為 Pending 並列出待補欄位（見步驟 6）。

在 New Customs Entry 精靈，點到第 2 步「Parties / Trade Partners」。系統已自動在 LDS 查找每個 TP 並顯示狀態。

New Customs Entry — Trade Partners (LDS Sync)

IOR

PACIFIC TRADING LLC ✕Not found in LDS

Importer of Record · match by IRS No. = ••-•••4567 00 · importer → 5106

🔍 Find ＋ Create

CN

PACIFIC TRADING LLC ✓Linked · PACTRAD01

Consignee · match by GF ref = TP-1

View

MFR

SHANGHAI APPAREL MFG CO ✕Not found

Manufacturer / Shipper · match by GF ref = TP-204

缺: mailing_address · address_type

🔍 Find ＋ Create

圖 1 — Trade Partners 步驟：每個 TP 顯示 LDS 連結狀態。

狀態	意義	你要做的事
✓Linked	LDS 已有此 TP（顯示 LDS code）	無需動作，可 View
✕Not found	LDS 查無	按 Create in LDS 建檔
⚠Missing fields	查無且 GF 資料缺必要欄位	補欄位或標 Pending
⚠5106 pending	已建 Contact，importer 5106 處理中	等 CBP 回覆

對狀態為「Not found」的 TP 按 🔍 Find。
系統依角色查找：importer 用 IRS No.（GetByNumber）、其他用 GF ref（ExternalId）。
查到會自動轉為 ✓Linked；查無則維持，請按 Create。

Searching LDS…

IOR

PACIFIC TRADING LLC ⏳Searching LDS…

GetByNumber(••-•••4567)

圖 2 — 查找中（每次查找都會寫一筆 log）

按 ＋ Create 開啟建檔視窗，確認 GF→LDS 對應步驟後按 Create in LDS。

Create Trade Partner in LDS

NamePACIFIC TRADING LLC

RoleImporter of Record

Match keyIRS No. = ••-•••4567 00

LDS status✕Not found

建檔步驟（GF → LDS）

✓

Lookup — GetByNumber → not found

2

Map GF → LDS Contact — Name, ExternalId=TP-1, IRSNumber, address, roles

3

Submit CBP 5106 — ActionQUE.ImporterConsigneeCreate（非同步）

→

Link to Customs Entry — CustomsEntry.Importer_Id

Cancel Create in LDS + 5106

圖 3 — 建檔視窗（importer 含 5106 步驟）

i

建檔成功後GF ref 會寫入 LDS Contact.ExternalId，狀態變 ✓Linked 並顯示 LDS code。

進口商（IOR）建檔時，系統會自動送 CBP 5106（ImporterConsigneeCreate）把進口商登記到海關。這是非同步的：

Contact 先在 LDS 建好（同步）。
5106 入列傳送（顯示 ⚠5106 pending），收到 CBP 回覆後轉為完成。
若 5106 被退（如 address type 無效），狀態顯示失敗，請更正後重送。

i

5106 必要欄位5106 需要 IRS（或 SSN/CBP No.）、mailing 地址、address type、importer type。缺任一項會擋下自動 5106（見步驟 6）。

若 GF 的 TP 資料缺 LDS 建檔必要欄位，建檔視窗會出現黃色警告，按鈕變成「建檔（標記 Pending）」。

Create — Missing fields

✓

Lookup — GetByExternalId(TP-204) → not found

!

Map GF → LDS — 缺必要欄位

⚠ GF TP API 缺必要欄位，無法自動完成：

mailing_address (city/state/zip)
address_type

請人工補欄或由 GF TP 詳細 endpoint 提供。

Cancel 建檔（標記 Pending）

圖 4 — 缺欄位處理：列出待補欄位，標 Pending。

!

處理方式① 在 GF 補齊該 TP 的地址等欄位後重試；② 或先標 Pending，待 GF TP 詳細 endpoint 提供欄位後由系統補送。Pending 紀錄會出現在稽核頁。

TP 變為 ✓Linked 後，系統自動把它帶入 Customs Entry 的對應欄位：

角色	帶入
Importer of Record	`CustomsEntry.Importer_Id`
Consignee	`Shipment.Consignee_Id`
Shipper / Manufacturer	`Shipment.Seller_Id`

完成後即可繼續 Bond → Shipments → Lines → 計稅 → 送件。

Parties 步驟下方有 Activity Log 即時顯示你做過的 TP 動作（查找 / 建檔 / 5106 / 帶入），送件也會記錄。

Activity Log

📋 Activity Log（GF→LDS TP / filing）

10:21 TP_CREATE_LDS — Importer · PACIFIC TRADING LLC (PACTRAD01) — SUCCESS

10:21 IMPORTER_5106 — ImporterConsigneeCreate · ABITx#5500 — SUCCESS

10:25 TP_CREATE_LDS — Manufacturer · SHANGHAI APPAREL — PENDING · 缺欄位

10:30 CUSTOMS_FILE_QUE — Entry ABI-20260619 — SUCCESS

圖 5 — Activity Log（點「開啟完整稽核頁」可看全部）

i

完整稽核頁完整紀錄在獨立的 「LDS TP Auto-Create Audit Log」頁面：可依時間 / 使用者 / TP 類型 / 動作 / 狀態篩選、看明細（含 timeline 與缺漏欄位）、匯出 CSV。

問題	處理
查找一直找不到	確認 importer 的 IRS No.、其他 TP 的 GF ref 是否正確；可改用名稱模糊查找（候選比對）
建檔被擋（Pending）	依列出的缺漏欄位（多為地址 / address type）補齊後重建
5106 失敗	看錯誤（如 address type 無效），更正後重送
疑似重複的 TP	系統建檔前會做候選比對；若提示疑似重複，請人工確認再建
找不到稽核紀錄	到「LDS TP Auto-Create Audit Log」頁，用篩選或搜尋 TP 名稱 / GF ref

✓

不可竄改的稽核所有 TP 建檔與報關送件都會留下不可竄改的稽核紀錄，含時間、操作者、TP 名稱 / code / type 與狀態。

Trade Partner LDS Sync — 操作手冊

什麼是 TP LDS Sync

開始之前

1進入 Trade Partners 步驟

2讀懂 LDS 狀態

3Find in LDS（查找）

4Create in LDS（建檔）

5Importer 的 CBP 5106

6缺欄位（Pending）

7帶入 Customs Entry

8Activity Log 與稽核頁

📋 Activity Log（GF→LDS TP / filing）

常見問題