@repo/shared / PriorNoticeType
Interface: PriorNoticeType
FDA Prior Notice (stand-alone) PGA data for CBP entry summary filings.
Required for imports of food for human and animal consumption subject to FDA Prior Notice requirements under the Bioterrorism Act (21 CFR Part 1, Subpart I). Used when Prior Notice is filed as a stand-alone submission separate from the entry summary.
Properties
| Property | Type | Description |
|---|---|---|
commodityCharacteristicDescription? | string | Common, usual, or market name description of the product. For PN, at least one common, market or usual name in PG10 must be provided. Per CATAIR FDA 08-25.pdf, Table 8-9: Commodity Characteristic Description, positions 24-80, up to 57 chars, Mandatory (M). |
dfiEntity? | EntityReference | Direct Food Importer (role code: DFI). Mandatory (as alternative to MF/FDC) per Table 8-15. Use for natural state food products when DFI is the applicable manufacturer role. |
disclaimer? | "A" | "F" | Disclaimer code indicating that a full PGA Message Set is not being provided. "A" = product is not regulated by this agency. "F" = product manufactured in US and sourced directly to warehouse (Entry Type 21 only). Per CATAIR FDA 08-25.pdf, Table 8-4: Disclaimer, position 80, Conditional (C). |
fdaImporterEntity? | EntityReference | FDA Importer of Record (role code: FD1). Conditional per Table 8-16 — required in some PN scenarios. Also requires a PG21 individual contact (name, phone, email). |
fdcEntity? | EntityReference | Food Distributor/Consignee (role code: FDC). Mandatory (as alternative to MF/DFI) per Table 8-15. Use when the grower is unknown and FDC is the applicable manufacturer role. |
foreignSupplierEntity? | EntityReference | Foreign Supplier (role code: FSV). Conditional per Table 8-17. |
govAgencyProcessingCode? | "ADD" | "PRO" | "DSU" | "FEE" | "NSF" | Government Agency Processing Code identifying the food sub-type for this PN filing. Determines business rules for subsequent records (e.g., NSF requires Place of Growth in PG06, PRO requires Country of Production). Per CATAIR FDA 08-25.pdf, Table 8-4: Gov Agency Processing Code, positions 14-16, Mandatory (M). Allowed values: NSF, PRO, FEE, ADD, DSU. |
intendedUseCode? | string | Intended Use Code for the commodity after importation. Not required for Food. If provided, only specific codes are valid. Per CATAIR FDA 08-25.pdf, Table 8-4: Intended Use Code, positions 42-57, Optional (O). Per Table 8-5: Valid codes are 260.000, 015.000, 210.000. |
mfEntity? | EntityReference | Manufacturer (role code: MF). Mandatory when one of MF/FDC/DFI is required per Table 8-15. Use for processed food products when manufacturer is known. |
ownerEntity? | EntityReference | Owner (role code: DFP). Conditional per Table 8-16. |
pnsEntity? | EntityReference | Prior Notice Submitter (role code: PNS). Mandatory for all Prior Notice submissions per Table 8-13. The entity that is submitting the Prior Notice. |
pntEntity? | EntityReference | Prior Notice Transmitter (role code: PNT). Mandatory for all Prior Notice submissions per Table 8-14. The entity electronically transmitting the Prior Notice. |
pointOfContactEntity? | EntityReference | Point of Contact / Filer/Broker (role code: PK). Optional for Prior Notice submissions per Table 8-18. Submitted as a PG21-only record (no PG19/PG20). User picks a specific individual contact. |
priorNoticePG06? | {countryCode?: string;sourceTypeCode?: "39" | "CSH" | "294" | "262";}[] | Array of product origin records providing country/source information. Mandatory and repeatable. Required source types depend on processing code: - NSF: 262 (Place of Growth) + CSH (Country of Shipment) - PRO/FEE/ADD/DSU: 39 (Country of Production) + CSH (Country of Shipment) - If article was refused by another country: add 294 (Country of Refusal) Per CATAIR FDA 08-25.pdf, Table 8-8. |
priorNoticePG13PG14? | {locationOfLPCOIssuer?: string;lpcoIssuerGovGeographicCodeQualifier?: "MS" | "PR" | "US" | "ISO";lpcoNumberOrName?: string;regionalDescriptionLocationOfLPCOIssuerAgency?: string;}[] | License plate information for privately-owned vehicle (POV) carriers. Only required when the carrier is a POV and does not have a SCAC or IATA. If PG13 is used, PG14 and PG23 (Carrier Name - CAN) are mandatory. Per CATAIR FDA 08-25.pdf, Tables 8-10 and 8-11. |
priorNoticePG23? | {affirmationOfComplianceCode?: | "FTZ" | "SE" | "EXE" | "PKC" | "IRC" | "FCC" | "COS" | "DEV" | "ACC" | "NDC" | "PMT" | "HCT" | "KIT" | "STN" | "DA" | "REG" | "DLS" | "IND" | "FSR" | "PRN" | "ERR" | "PLR" | "IFE" | "LST" | "PM#" | "IDE" | "AIN" | "ANC" | "BLN" | "CAN" | "CCC" | "CCM" | "CFR" | "CIN" | "CMT" | "CPT" | "DDM" | "DFE" | "DI" | "FAP" | "FCE" | "FME" | "FSX" | "GFR" | "HPC" | "HRN" | "IBP" | "IFR" | "ILS" | "JIF" | "LFR" | "LWC" | "MDL" | "ORN" | "PFR" | "RA1" | "RA2" | "RA3" | "RA4" | "RA5" | "RA6" | "RA7" | "RB1" | "RB2" | "RC1" | "RC2" | "RD1" | "RD2" | "RD3" | "RNE" | "RNO" | "SFR" | "SID" | "SIF" | "SRN" | "TFR" | "TST" | "UFR" | "VAN" | "VES" | "VFD" | "VFL" | "VFT" | "VIN" | "VNA" | "VOL" | "VQI";affirmationOfComplianceQualifier?: string;}[] | Array of Affirmation of Compliance records. Conditional and repeatable; each AoC code can only be transmitted once per PGA line (except RNO which may be repeated for multiple rail car numbers). Mandatory AoC codes for PN: VFT (Voyage/Flight/Trip), CAN (Carrier Name). Conditional: PFR (Manufacturer Food Facility Registration), FME (exemption), RNO (Rail Car). Optional: SFR, UFR, IFR, TFR, ORN, SRN, CFR, GFR, LFR. Per CATAIR FDA 08-25.pdf, Tables 8-19 through 8-23. |
priorNoticePG25? | {lot?: string;lotQualifier?: "1" | "3";temperatureQualifier?: "A" | "D" | "R" | "P" | "F" | "H" | "U";}[] | Array of product condition records for lot number information. Conditional and repeatable for lot numbers. Lot Number is required for Infant Formula, Acidified Foods, and LACF products. Per CATAIR FDA 08-25.pdf, Table 8-24. |
priorNoticePG26? | {packagingQualifier?: "1" | "2" | "3" | "5" | "6" | "4";quantity?: number;unitOfMeasure?: string;}[] | Array of packaging records describing the packaging hierarchy. Mandatory and repeatable up to 6 times (one for each packaging level). Outermost (largest=1) to innermost (smallest=6). The final record must describe the actual amount of product in the smallest container using a base unit code. Per CATAIR FDA 08-25.pdf, Table 8-25. |
priorNoticePG27? | {containerNumber1?: string;containerNumber2?: string;containerNumber3?: string;}[] | Array of shipping container number records. Conditional and repeatable. Container numbers are required for prior notice when food arrives as containerized cargo by water, air, rail, or land. Each PG27 record can hold up to 3 container numbers. Per CATAIR FDA 08-25.pdf, Table 8-27. |
priorNoticePG28? | {trackingNumber?: string;trackingNumberCode?: string;}[] | Express courier tracking number information for Prior Notice submissions when the mode of transportation is mail or express courier. The tracking number is submitted in lieu of airway bill / bill of lading. Per CATAIR FDA 08-25.pdf, Table 8-28. |
priorNoticePG30? | {arrivalDate?: Date;arrivalTime?: string;inspectionLabTestingStatus?: "A" | "R" | "P" | "F" | "I" | "S" | "L";inspectionOrArrivalLocation?: string;inspectionOrArrivalLocationCode?: string;}[] | Anticipated arrival information including date, time, and location/port. Mandatory for all FDA products. A PG30 with status "A" is always required. For stand-alone Prior Notice, PG30 also collects the anticipated arrival port. Per CATAIR FDA 08-25.pdf, Table 8-29. |
productCodeNumber? | string | FDA Product Code identifying the food product. Must be exactly 7 characters. Only one product code per PGA line. Per CATAIR FDA 08-25.pdf, Table 8-6: Product Code Number, positions 10-28, Mandatory (M). |
remarksText? | string | Free-form remarks text relevant to the shipment or commodity. PG24 cannot be repeated; only one PG24 is allowed per FDA line. The Remarks Type Code is always "GEN" and is hardcoded by the encoder. Per CATAIR FDA 08-25.pdf, Table 8-23: Remarks Text, positions 13-80, up to 68 chars. |
secureHoldingFacilityEntity? | EntityReference | Secure Holding Facility / Location of Goods (role code: LGR). Conditional — required if food was refused for inadequate Prior Notice per Table 8-17. |
shipperEntity? | EntityReference | Shipper (role code: DEQ). Optional per Table 8-18. |
ultimateConsigneeEntity? | EntityReference | Ultimate Consignee (role code: UC). Conditional per Table 8-16. |