Customs Filing › LDS Screen → API 欄位對應
REVIEW WITH LDS

LDS Customs Entry 畫面欄位 → LDS API 對應表

把 24 張 LDS 截圖中的每個欄位,對應到 LDS SMS API 的確切 class.property 與提供它的 API(manager)。紅色列 = 找不到對應 / 多重或不確定,需與 LDS 確認。資料來源:LDS API doc 03/04/05/06/27。

已對應 Matched
需與 LDS 確認 (紅)
欄位總數
03/04/05/06/27來源 API docs
已對應:API 有確切 property 需確認(紅):找不到 / 多重 / 概念不符 計算/動作:唯讀彙總或 UI 動作,非儲存欄位 主要 API:ICustomsEntryManager(整棵樹 New/Save/Get);關係人 IContactManager
需與 LDS 確認的重點(紅色):Manifested quantity、Distribute charges/gross weight(UI 動作)、Liquidation(Date / Change Reason)、Invoice 層 Gross weight、Invoice 層 Commercial entities(Seller/Ship To)、Article 層 Buyer、Tariff「Sanctions」分頁(Record Type / Field Name / Field Value / Sanction disclaim)、部分 Additional 旗標(Trade Agreement reconciliation、Self-Certification、CBP Team number、Non-AMS bills、Broker/OGA information、Broker/Importer file number)、Additional Declaration 新增類別 SM/BC/CC/PO、Article「LDP value」、IR「Type of calculation」。詳見各列。

① Customs Entry — 表頭 Header(CustomsEntry via ICustomsEntryManager

畫面欄位LDS API property提供 API / 物件狀態備註
Entry DateCustomsEntry.DateEntityDocument 基底建檔日期
NumberCustomsEntry.NumberEntityDocument系統流水號
Filer codeCustomsEntry.EntryFilerCodeICustomsEntryManager3碼
Entry numberCustomsEntry.EntryNumberICustomsEntryManager8碼
Responsible personCustomsEntry.ResponsiblePersonEntityDocument(User)
IdCustomsEntry.IdEntityBase [Key]主鍵
Entry typeCustomsEntry.EntryTypeICustomsEntryManagerHas Possible Values
Client refCustomsEntry.ClientRefICustomsEntryManager
ImporterCustomsEntry.Importer / Importer_Id→ Contact / IContactManagerIOR
Transportation modeCustomsEntry.TransportationModeICustomsEntryManagerHPV
Import dateCustomsEntry.DateOfImportICustomsEntryManager
Arrival dateCustomsEntry.DateOfArrivalICustomsEntryManager
Estimated entry dateCustomsEntry.EstimatedEntryDateICustomsEntryManager
Release dateCustomsEntry.DateOfReleaseICustomsEntryManager
Conveyance/Vessel nameCustomsEntry.ConveyanceNameICustomsEntryManager
CarrierCustomsEntry.Carrier / Carrier_Id→ Carrier directorySCAC
LocationCustomsEntry.Location / Location_Id→ FIRMFIRMS
Port of entryCustomsEntry.PortOfEntry→ CustomsPort
Port of unladingCustomsEntry.PortOfUnlading→ CustomsPort
US state of destinationCustomsEntry.UsStateOfDestinationICustomsEntryManagerHPV
Trip (Flight/Voyage)CustomsEntry.TripIdentifierICustomsEntryManager
Liquidation ▸ Date— 無對應✗ 確認doc 05 僅敘述 liquidation 流程,CustomsEntry 無 Liquidation* 欄位
Liquidation Change Reason or Suspension— 無對應✗ 確認同上;可能由其他狀態/UC 通知提供,需 LDS 確認

② Bond info(CustomsEntry

畫面欄位LDS API property提供 API / 物件狀態備註
Bond waiver reasonCustomsEntry.BondWaiverReasonCodeICustomsEntryManagerHPV
Basic ▸ Bond typeCustomsEntry.BondTypeICustomsEntryManager8/9,HPV
Basic ▸ Surety codeCustomsEntry.SuretyCodeICustomsEntryManager
Basic ▸ AmountCustomsEntry.BondAmountICustomsEntryManagerSTB amount
Basic ▸ Bond #CustomsEntry.BondNumberICustomsEntryManager
Additional ▸ Bond type / Surety / Amount / Bond #AdditionalSTBSuretyCode / AdditionalSTBBondAmount / AdditionalSTBBondNumberICustomsEntryManager⚠ 部分Additional 區的 Bond type 本身未見獨立 property(僅 STB surety/amount/number);確認 type 來源

③ Payment info(CustomsEntry;費用多為 [NotMapped] server 計算)

畫面欄位LDS API property提供 API / 物件狀態備註
Payment typeCustomsEntry.PaymentTypeICustomsEntryManager1–8,HPV
Preliminary statement print dateCustomsEntry.PreliminaryStatementPrintDateICustomsEntryManager
Preliminary statement monthCustomsEntry.PreliminaryStatementMonthDate(+ PreliminaryStatementMonthICustomsEntryManager
Deferred tax paymentCustomsEntry.DeferredTaxPaymentICustomsEntryManagerHPV
Duty dateCustomsEntry.DutyDate[NotMapped]⚠ 唯讀server 計算
Duty amountCustomsEntry.DutyAmount[NotMapped]⚠ 唯讀
Merchandise processing fee (MPF)CustomsEntry.MerchandiseProcessingFee[NotMapped]⚠ 唯讀class 499
Harbor maintenance fee (HMF)CustomsEntry.HarborMaintenanceFee[NotMapped]⚠ 唯讀class 501
Internal revenue tax (IR)CustomsEntry.InternalRevenueTaxAmount[NotMapped]⚠ 唯讀
User feeCustomsEntry.UserFeeAmount / TotalUserFee[NotMapped]⚠ 唯讀
Informal merchandise processing feeCustomsEntry.InformalMerchandiseProcessingFee[NotMapped]⚠ 唯讀class 311
Dutiable mail feeCustomsEntry.DutiableMailFee[NotMapped]⚠ 唯讀
Manual entry surchargeCustomsEntry.ManualEntrySurcharge[NotMapped]⚠ 唯讀
Anti Dumping (AD) dutyCustomsEntry.AntiDumpingDutyAmount[NotMapped]⚠ 唯讀+Bonded/CashDeposit 分項
Countervailing (CVD) dutyCustomsEntry.CountervailingDutyAmount[NotMapped]⚠ 唯讀+Bonded/CashDeposit
Total amount dueCustomsEntry.TotalAmountDue[NotMapped]⚠ 唯讀

④ Additional(CustomsEntry

畫面欄位LDS API property提供 API / 物件狀態備註
Broker ref. #CustomsEntry.BrokerReferenceNumberICustomsEntryManager
Broker/Importer file number— 未見對應✗ 確認dump 無此 property;可能為 UserData 或未列,需 LDS 確認
Trade Agreement reconciliation— 未見對應(≠ Reconciliation issue)✗ 確認CATAIR 有 Trade Agreement Reconciliation Indicator,但 dump 未列獨立 property
Shipment usage typeCustomsEntry.ShipmentUsageTypeCodeICustomsEntryManagerHPV
Split shipment release electionCustomsEntry.SplitShipmentReleaseElectionICustomsEntryManagerHPV
General order (G.O.) numberCustomsEntry.GeneralOrderNumberICustomsEntryManager
Non-AMS bills(checkbox)— 未見對應✗ 確認dump 無此布林;確認是否由 bill 層或其他欄位推導
Missing document 1 / 2MissingDocumentCode1 / MissingDocumentCode2ICustomsEntryManagerHPV
Foreign Trade ZoneCustomsEntry.ForeignTradeZoneICustomsEntryManager
Broker or other government agency information(textarea)— 未見對應✗ 確認dump 無此自由文字欄位
Designated notify Party 4811CustomsEntry.DesignatedNotifyParty4811→ Contact
CBP Team number— 未見對應✗ 確認dump 無;可能 server 端決定
Reconciliation issueCustomsEntry.ReconciliationIssueCodeICustomsEntryManagerHPV
PGA data includedCustomsEntry.PGADataIncludedICustomsEntryManager
Elected exam site (FIRMS)CustomsEntry.ElectedExamSite→ FIRM
Live entry indicatorCustomsEntry.LiveEntryIndicatorICustomsEntryManagerHPV
Self-Certification— 未見對應✗ 確認dump 無此欄位
Warehouse ▸ Bonded warehouseCustomsEntry.BondedWarehouse→ FIRM
Re-Warehouse ▸ Filer code / Entry numberOriginatingWarehouseEntryFilerCode / OriginatingWarehouseEntryNumberICustomsEntryManager引用前倉單
Re-Warehouse ▸ Final Withdrawal Indicator— 未見對應✗ 確認dump 無此布林

⑤ Shipment(Shipment;存於 CustomsEntry.Shipments)

畫面欄位LDS API property提供 API / 物件狀態備註
Number / Date / IdShipment.Number / .Date / .IdEntityDocument
Transportation modeShipment.TransportationModeShipmentHPV
Shipment Client refShipment.ClientRefShipment
ImporterShipment.Importer→ Contact
CarrierShipment.Carrier→ Carrier
Booking #Shipment.BookingNumberShipment
DescriptionShipment.DescriptionShipment
Export date / Import date / Arrival dateShipment.DateOfExport / (entry) DateOfImport / Shipment.DateOfArrivalShipment⚠ 部分Import date 於 entry 層;shipment 層確認是否另存
Manifested quantity— 無 ManifestedQuantity最接近 Shipment.Quantity/QuantityUnit✗ 確認API 無「manifested」欄位;確認對應 Quantity 或 Load.Pieces
UnitShipment.QuantityUnitShipment同上,確認語意
In Bond ▸ IT number / IT dateShipment.InBondNumber / InBondDateShipment
Master Bill Issuer / Master BB #Shipment.MasterBillIssuer / MasterBillNumberShipment(Issuer→Carrier)
House Bill Issuer / House BB # / Sub House BB #HouseBillIssuer / HouseBillNumber / SubHouseBillNumberShipment
Regular bill— 未見獨立對應✗ 確認可能為 UI 切換(Regular vs Master/House),確認對應
Values ▸ Value/MMV/Non-dutiable/Other/TOTAL $Shipment.ValueUSD/MMVUSD/NonDutiableUSD/OtherUSD/TotalUSD[NotMapped] 彙總⚠ 唯讀shipment 層為下層彙總;可編輯值在 invoice/tariff 層
Charges $ / Distribute charges amount by articlesShipment.ChargeUSD(NotMapped)—(無分配欄位)✗ 確認「Distribute…」為 UI 動作;charges 實存於 invoice/article/tariff 層
Commercial entities ▸ Consignee / Buyer / Seller / Ship ToShipment.Consignee / Buyer / Seller / ShipTo→ Contact / IContactManager

⑥ Invoice(ShipmentInvoice

畫面欄位LDS API property提供 API / 物件狀態備註
Invoice numberShipmentInvoice.InvoiceNumberShipmentInvoice
IdShipmentInvoice.IdEntityBase
Gross weight, kg— ShipmentInvoice 無 gross weight最接近 ShipmentArticle.GrossWeight / ShipmentLoad.WeightKg✗ 確認UI 在 invoice 層顯示,但 API 在 article/load 層;確認來源
Distribute gross weight by articles(按鈕)— UI 動作✗ 確認分配動作,非儲存欄位
Values ▸ Invoice / MMV / Non-dutiable / Other × {Value, Currency, Rate}InvoiceValue/MMV/NonDutiable/Other + …Currency + …CurrencyRateShipmentInvoice幣別 HPV;USD 為 NotMapped
Bill ▸ Master / House(顯示)引用自 Shipment.Master/HouseBill*Shipment顯示用
Commercial entities ▸ Seller / Ship To— ShipmentInvoice 無 party 連結—(party 在 Shipment/Article 層)✗ 確認invoice 層 commercial entities 在 API 無對應;確認是顯示自 shipment 或另有欄位

⑦ Article(ShipmentArticle)— 含 9 分頁

畫面欄位(分頁)LDS API property提供 API / 物件狀態備註
Line / Line item IdShipmentArticle.Line / LineItemIdentifierShipmentArticle
DescriptionShipmentArticle.DescriptionShipmentArticle
ManufacturerShipmentArticle.Manufacturer→ Contact(Manufacturer/Supplier)
Country of origin / exportCountryOfOrigin / CountryOfExportShipmentArticleHPV
Article Set indicatorShipmentArticle.ArticleSetIndicatorShipmentArticleHPV
Gross weightShipmentArticle.GrossWeightShipmentArticlekg
Special program code (SPI)ShipmentArticle.SpecialProgramClaimCodeShipmentArticleHPV
Product claim codeShipmentArticle.ProductClaimCodeShipmentArticleHPV(非「cube」)
Foreign port of ladingShipmentArticle.ForeignPortOfLading→ ForeignPortSchedule K
Article 標頭 Quantity(如 1000 Kg)— article 層無 quantity;數量在 tariff Quantity1ShipmentArticleTariff.Quantity1/UOM1✗ 確認確認此標頭數量是顯示自 tariff 還是另有欄位
Values ▸ Value/MMV/Non-dutiable/OtherArticleValue/MMV/NonDutiable/Other(NotMapped 彙總)[NotMapped]⚠ 唯讀下層 tariff 彙總
Payment ▸ Duty amountShipmentArticle.DutyAmount[NotMapped]⚠ 唯讀
Payment ▸ MPF exempt / MPFMerchandiseProcessingFeeExempt / MerchandiseProcessingFeeShipmentArticle
Payment ▸ HMF / User fee amountHarborMaintenanceFee / UserFeeAmountShipmentArticleUserFee 為 NotMapped
Payment ▸ Other revenue accounting class / amountOtherRevenueAccountingClassCode / OtherRevenueTaxAmountShipmentArticle
Payment ▸ Internal revenue ▸ Type of calculation (auto)最接近 InternalRevenueTaxTypeShipmentArticle✗ 確認「Type of calculation/auto」語意需與 LDS 對齊
Payment ▸ IR accounting class / amountInternalRevenueAccountingClassCode / InternalRevenueTaxAmountShipmentArticle
Commercial entities ▸ Foreign exporter / ConsigneeShipmentArticle.ForeignExporter / Consignee→ Contact
Commercial entities ▸ Buyer(article 層)— article 層無 Buyer最接近 Shipment.Buyer✗ 確認API article 層僅 Consignee/Manufacturer/ForeignExporter
FTZ ▸ Merchandise status / filing date / item quantityFTZMerchandiseStatusCode / FTZPrivilegedMerchandiseFilingDate / FTZLineItemQuantityShipmentArticle
AD/CVD ▸ AD:Case number/Bond·Cash/Rate type/Deposit rate/Value/Quantity/DutyADCaseNumber/ADBondCashClaimCode/ADCaseRateTypeCode/ADCaseDepositRate/ADValueOfGoodsAmount/ADQuantity/ADDutyAmountShipmentArticle
AD/CVD ▸ CVD:同上 CVD 版CVDCaseNumberCVDDutyAmountShipmentArticle
AD/CVD ▸ Non-Reimbursement #ADCaseNonReimbursementStatement / ADCVDNonReimbursementDeclarationIdentifierShipmentArticle
Additional ▸ Ruling type/numberRulingTypeCode / RulingNumberShipmentArticle
Additional ▸ Fee exemption codeFeeExemptionCodeShipmentArticleHPV
Additional ▸ License/Cert/Permit type / numberLicenseCertificatePermitTypeCode / LicenseCertificatePermitNumberShipmentArticle
Additional ▸ Related party indicatorRelatedPartyIndicatorShipmentArticleHPV
Additional ▸ Standard Visa #StandardVisaNumberShipmentArticle
Additional ▸ NAFTA net cost indicatorNAFTANetCostIndicatorShipmentArticleHPV
Additional ▸ Internal/Other revenue taxInternalRevenueTax / OtherRevenueTaxShipmentArticlebool
Additional ▸ LDP value— 未見對應✗ 確認dump 無 LDP value property
PSC ▸ Line reason code 1–5PSCLineReasonCode1..5ShipmentArticleHPV
Census warning ▸ Tariff# / Condition / OverrideShipmentArticleCensusWarning.Tariff / Condition / OverrideCodeShipmentArticle.CensusWarnings
Additional declarations ▸ Type Code / Information ElementsShipmentArticleAdditionalDeclaration.TypeCode / Information(+InformationElements)ShipmentArticle.AdditionalDeclarations
 └ LB/LS/LA/KR/CB/CT 子物件Information01/02/03/04/05/07InformationXX 衍生Softwood/Steel/Aluminum/KR/CBMA/Cast
 └ SM / BC / CC / PO 子物件— 未見對應 Information 子類✗ 確認Steel Melt&Pour / 201 Bifacial / Ship-to-Shore Crane / Auto Parts Offset 未見子物件

⑧ Tariff(ShipmentArticleTariff)— 含 4 分頁 + PGA

畫面欄位(分頁)LDS API property提供 API / 物件狀態備註
Line / IdShipmentArticleTariff.Line / .IdEntityChild
Tariff / Harmonized tariffHarmonizedTariff(+Tariff CustomerTariff)→ HarmonizedTariff directory10碼
Values ▸ Tariff/MMV/Non-dutiable/Other × {Value, Currency, Rate, $}TariffValue/TariffMMV/TariffNonDutiable/TariffOther(+USD NotMapped)ShipmentArticleTariff
Values ▸ Fill values / Balance對應 Invoice…Balance(NotMapped)ShipmentInvoice(balance)「Fill values」為 UI 填入動作;Balance 來自 invoice 層差額
Quantities ▸ Q1 / Q2 / Q3 + UOMQuantity1/2/3 + UnitOfMeasure1/2/3ShipmentArticleTariffUOM HPV
Payment ▸ Manual input Duty / Duty amountManualInputDuty / DutyAmountShipmentArticleTariff
Payment ▸ User fee accounting class / amountUserFeeAccountingClassCode / UserFeeAmountShipmentArticleTariff
FTZ ▸ Privileged foreign status Harmonized tariffPrivilegedForeignStatusHarmonizedTariff→ HarmonizedTariffSE61
P.G.A. ▸ Set / Check match / DescriptionPGA(doc 27, PGABranch 樹)/ CheckMatchPGAValuesShipmentArticleTariff.PGAPGOI/PG01-55
Sanctions ▸ Record Type / Field Name / Field Value / Sanction disclaim— 無專屬 property(99-series 走 HarmonizedTariff)✗ 確認此「Sanctions」grid(Record Type/Field Name/Field Value/disclaim)在 dump 無對應結構;需 LDS 確認是哪隻 API / 物件

⑨ 其他頂層節點

節點 / 欄位LDS API property提供 API / 物件狀態備註
Post Summary Correction(header)PostSummaryCorrection / …HeaderReasonCode1-5 / …FilingExplanationText / …EntryFilerCode / …EntryNumberCustomsEntryline reason 在 Article
Consolidated Release (N)CustomsEntry.ConsolidatedReleaseEntriesCustomsEntrydump 無欄位說明;確認格式(string 內含多筆?)
CancelationCancellationRequestReasonCode(+ ActionQUE.CancelCargoRelease / Void)ICustomsEntryManager
API 提供方式總述:整棵 Customs Entry 樹(Header / Bond / Payment / Additional / Shipment / Invoice / Article / Tariff / PGA / PSC)皆為 CustomsEntry 文件物件之屬性或子集合,ICustomsEntryManagerNew / Save / Get(include) / CalculateDutyAndFee / PutToQUE 提供與持久化;關係人(Importer/Consignee/Seller/Buyer/ShipTo/Manufacturer/ForeignExporter/Notify 4811)為 Contact 物件,經 IContactManager;參考資料(Port/Carrier/FIRMS/HTS/ForeignPort)經各 directory manager / Extract Reference File 查詢。費用類欄位多為 [NotMapped](server 計算、唯讀)。