@repo/shared / FoodCombinedType
Interface: FoodCombinedType
FDA Food (combined entry + Prior Notice) PGA data for CBP entry summary filings.
Used when Prior Notice and the entry summary are filed together as a combined submission. Required for imports of food for human and animal consumption subject to FDA jurisdiction. Covers processing codes, source countries, entity roles, lot details, and affirmations of compliance.
Properties
| Property | Type | Description |
|---|---|---|
arrivalDate? | Date | Anticipated arrival date at the port of arrival/entry. Format: MMDDCCYY. Mandatory. Per Table 9-30: positions 6-13. |
arrivalLocation? | string | Port of arrival (Schedule D port code). Location code "2" is hardcoded in the encoder. Per Table 9-30: positions 22-71, up to 50 chars. |
arrivalTime? | string | Anticipated arrival time at the port of arrival/entry. Military time format: HHMM. For midnight use 2400 (0000 is invalid). Mandatory. Per Table 9-30: positions 14-17. |
brandName? | string | Trade or brand name of the product. Per CATAIR FDA 08-25.pdf, Table 9-9: Brand Name, positions 46-80, up to 35 chars. The brandNameQualifier is always "35X" and is hardcoded by the encoder. |
canDimension1? | number | First container dimension for Acidified Food (AF) and Low Acid Canned Food (LACF). Rectangular containers: width. Cylindrical containers: diameter. 4 numeric digits. First 2 digits = whole inches, last 2 = sixteenths of an inch. Example: 1404 = 14 and 4/16 inches. Required for AF/LACF unless container volume (VOL) AoC code is provided in PG23 instead. Per CATAIR FDA 08-25.pdf, Table 9-27: Container Dimensions #1, positions 5-8, Conditional (C). |
canDimension2? | number | Second container dimension for AF/LACF. Rectangular containers: height. Cylindrical containers: height. Same encoding as canDimension1. Required for AF/LACF unless container volume (VOL) AoC code is provided in PG23 instead. Per CATAIR FDA 08-25.pdf, Table 9-27: Container Dimensions #2, positions 9-12, Conditional (C). |
canDimension3? | number | Third container dimension for AF/LACF. Only applicable for rectangular containers: length. Same encoding as canDimension1. Per CATAIR FDA 08-25.pdf, Table 9-27: Container Dimensions #3, positions 13-16, Conditional (C). |
commodityCharacteristicDescription? | string | Common, usual, or market name description of the product. This is the product description at the line level (e.g., "Canned Tuna" or "Frozen Shrimp"). Per CATAIR FDA 08-25.pdf, Table 9-10: Commodity Characteristic Description, positions 24-80, up to 57 chars, Mandatory (M). |
correctionIndicator? | boolean | Correction indicator for corrected data. Reserved for future use. Per CATAIR FDA 08-25.pdf, Table 9-4: Correction Indicator, position 79, Optional (O). |
countriesOfRefusal? | {countryCode?: | "AL" | "AZ" | "AR" | "CA" | "CO" | "DE" | "GA" | "ID" | "IL" | "IN" | "KY" | "LA" | "ME" | "MD" | "MA" | "MN" | "MS" | "MO" | "MT" | "NE" | "NC" | "PA" | "PR" | "SC" | "SD" | "TN" | "VA" | "VI" | "CR" | "AU" | "BH" | "CL" | "JO" | "JP" | "KR" | "MX" | "NP" | "OM" | "PE" | "SG" | "CN" | "ST" | "SE" | "BY" | "SH" | "PK" | "CZ" | "CW" | "FM" | "GD" | "VN" | "BN" | "TO" | "KW" | "EE" | "EG" | "PN" | "CI" | "BB" | "GN" | "PL" | "TL" | "AD" | "AE" | "AF" | "AG" | "AI" | "AM" | "AO" | "AS" | "AT" | "AW" | "BA" | "BD" | "BE" | "BF" | "BG" | "BI" | "BJ" | "BM" | "BO" | "BR" | "BS" | "BT" | "BU" | "BV" | "BW" | "BZ" | "CC" | "CD" | "CF" | "CG" | "CH" | "CK" | "CM" | "CU" | "CV" | "CX" | "CY" | "DJ" | "DK" | "DM" | "DO" | "DZ" | "EC" | "EH" | "ER" | "ES" | "ET" | "FI" | "FJ" | "FK" | "FO" | "FR" | "GB" | "GE" | "GF" | "GH" | "GI" | "GL" | "GM" | "GP" | "GQ" | "GR" | "GT" | "GU" | "GW" | "GY" | "GZ" | "HK" | "HM" | "HN" | "HR" | "HT" | "HU" | "IE" | "IO" | "IQ" | "IR" | "IS" | "IT" | "JM" | "KE" | "KG" | "KH" | "KI" | "KM" | "KN" | "KP" | "KV" | "KZ" | "LB" | "LC" | "LI" | "LK" | "LR" | "LS" | "LT" | "LU" | "LV" | "LY" | "MC" | "MG" | "MH" | "MK" | "ML" | "MM" | "MP" | "MQ" | "MR" | "MU" | "MV" | "MW" | "MY" | "MZ" | "NA" | "NF" | "NG" | "NI" | "NL" | "NO" | "NR" | "NU" | "NZ" | "PF" | "PG" | "PH" | "PM" | "PT" | "PW" | "PY" | "QA" | "RE" | "RO" | "RS" | "RU" | "RW" | "SA" | "SB" | "SI" | "SJ" | "SK" | "SL" | "SM" | "SN" | "SO" | "SR" | "SS" | "SV" | "SX" | "SY" | "SZ" | "TC" | "TD" | "TF" | "TG" | "TH" | "TJ" | "TK" | "TM" | "TR" | "TT" | "TV" | "TW" | "TZ" | "UA" | "UG" | "UM" | "US" | "UY" | "UZ" | "VC" | "VE" | "VG" | "VU" | "WE" | "WF" | "WS" | "YE" | "YT" | "ZA" | "ZM" | "ZW";}[] | Countries that have previously refused entry of this article. Each entry is emitted as source type 294 (Country of Refusal). Conditional — only required if the article was refused by another country. Per Table 9-8: Conditional (C), repeatable. |
countryOfProduction? | | "AL" | "AZ" | "AR" | "CA" | "CO" | "DE" | "GA" | "ID" | "IL" | "IN" | "KY" | "LA" | "ME" | "MD" | "MA" | "MN" | "MS" | "MO" | "MT" | "NE" | "NC" | "PA" | "PR" | "SC" | "SD" | "TN" | "VA" | "VI" | "CR" | "AU" | "BH" | "CL" | "JO" | "JP" | "KR" | "MX" | "NP" | "OM" | "PE" | "SG" | "CN" | "ST" | "SE" | "BY" | "SH" | "PK" | "CZ" | "CW" | "FM" | "GD" | "VN" | "BN" | "TO" | "KW" | "EE" | "EG" | "PN" | "CI" | "BB" | "GN" | "PL" | "TL" | "AD" | "AE" | "AF" | "AG" | "AI" | "AM" | "AO" | "AS" | "AT" | "AW" | "BA" | "BD" | "BE" | "BF" | "BG" | "BI" | "BJ" | "BM" | "BO" | "BR" | "BS" | "BT" | "BU" | "BV" | "BW" | "BZ" | "CC" | "CD" | "CF" | "CG" | "CH" | "CK" | "CM" | "CU" | "CV" | "CX" | "CY" | "DJ" | "DK" | "DM" | "DO" | "DZ" | "EC" | "EH" | "ER" | "ES" | "ET" | "FI" | "FJ" | "FK" | "FO" | "FR" | "GB" | "GE" | "GF" | "GH" | "GI" | "GL" | "GM" | "GP" | "GQ" | "GR" | "GT" | "GU" | "GW" | "GY" | "GZ" | "HK" | "HM" | "HN" | "HR" | "HT" | "HU" | "IE" | "IO" | "IQ" | "IR" | "IS" | "IT" | "JM" | "KE" | "KG" | "KH" | "KI" | "KM" | "KN" | "KP" | "KV" | "KZ" | "LB" | "LC" | "LI" | "LK" | "LR" | "LS" | "LT" | "LU" | "LV" | "LY" | "MC" | "MG" | "MH" | "MK" | "ML" | "MM" | "MP" | "MQ" | "MR" | "MU" | "MV" | "MW" | "MY" | "MZ" | "NA" | "NF" | "NG" | "NI" | "NL" | "NO" | "NR" | "NU" | "NZ" | "PF" | "PG" | "PH" | "PM" | "PT" | "PW" | "PY" | "QA" | "RE" | "RO" | "RS" | "RU" | "RW" | "SA" | "SB" | "SI" | "SJ" | "SK" | "SL" | "SM" | "SN" | "SO" | "SR" | "SS" | "SV" | "SX" | "SY" | "SZ" | "TC" | "TD" | "TF" | "TG" | "TH" | "TJ" | "TK" | "TM" | "TR" | "TT" | "TV" | "TW" | "TZ" | "UA" | "UG" | "UM" | "US" | "UY" | "UZ" | "VC" | "VE" | "VG" | "VU" | "WE" | "WF" | "WS" | "YE" | "YT" | "ZA" | "ZM" | "ZW" | Country of production (PRO/FEE/ADD/DSU) or place of growth (NSF). The encoder infers the correct source type code: - govAgencyProcessingCode === "NSF" → source type 262 (Place of Growth) - all other processing codes → source type 39 (Country of Production) Per Table 9-8: Mandatory for all food combined submissions. |
countryOfShipment? | | "AL" | "AZ" | "AR" | "CA" | "CO" | "DE" | "GA" | "ID" | "IL" | "IN" | "KY" | "LA" | "ME" | "MD" | "MA" | "MN" | "MS" | "MO" | "MT" | "NE" | "NC" | "PA" | "PR" | "SC" | "SD" | "TN" | "VA" | "VI" | "CR" | "AU" | "BH" | "CL" | "JO" | "JP" | "KR" | "MX" | "NP" | "OM" | "PE" | "SG" | "CN" | "ST" | "SE" | "BY" | "SH" | "PK" | "CZ" | "CW" | "FM" | "GD" | "VN" | "BN" | "TO" | "KW" | "EE" | "EG" | "PN" | "CI" | "BB" | "GN" | "PL" | "TL" | "AD" | "AE" | "AF" | "AG" | "AI" | "AM" | "AO" | "AS" | "AT" | "AW" | "BA" | "BD" | "BE" | "BF" | "BG" | "BI" | "BJ" | "BM" | "BO" | "BR" | "BS" | "BT" | "BU" | "BV" | "BW" | "BZ" | "CC" | "CD" | "CF" | "CG" | "CH" | "CK" | "CM" | "CU" | "CV" | "CX" | "CY" | "DJ" | "DK" | "DM" | "DO" | "DZ" | "EC" | "EH" | "ER" | "ES" | "ET" | "FI" | "FJ" | "FK" | "FO" | "FR" | "GB" | "GE" | "GF" | "GH" | "GI" | "GL" | "GM" | "GP" | "GQ" | "GR" | "GT" | "GU" | "GW" | "GY" | "GZ" | "HK" | "HM" | "HN" | "HR" | "HT" | "HU" | "IE" | "IO" | "IQ" | "IR" | "IS" | "IT" | "JM" | "KE" | "KG" | "KH" | "KI" | "KM" | "KN" | "KP" | "KV" | "KZ" | "LB" | "LC" | "LI" | "LK" | "LR" | "LS" | "LT" | "LU" | "LV" | "LY" | "MC" | "MG" | "MH" | "MK" | "ML" | "MM" | "MP" | "MQ" | "MR" | "MU" | "MV" | "MW" | "MY" | "MZ" | "NA" | "NF" | "NG" | "NI" | "NL" | "NO" | "NR" | "NU" | "NZ" | "PF" | "PG" | "PH" | "PM" | "PT" | "PW" | "PY" | "QA" | "RE" | "RO" | "RS" | "RU" | "RW" | "SA" | "SB" | "SI" | "SJ" | "SK" | "SL" | "SM" | "SN" | "SO" | "SR" | "SS" | "SV" | "SX" | "SY" | "SZ" | "TC" | "TD" | "TF" | "TG" | "TH" | "TJ" | "TK" | "TM" | "TR" | "TT" | "TV" | "TW" | "TZ" | "UA" | "UG" | "UM" | "US" | "UY" | "UZ" | "VC" | "VE" | "VG" | "VU" | "WE" | "WF" | "WS" | "YE" | "YT" | "ZA" | "ZM" | "ZW" | Country of shipment — the country from which the food was shipped to the US. The encoder always submits this as source type CSH. Per Table 9-8: Mandatory for all food combined submissions. |
dfiEntity? | EntityReference | DFI — Domestic Food Importer / Crop Grower (natural state food, grower unknown). One of MF, FDC, or DFI is mandatory. Per Table 9-16. |
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 9-4: Disclaimer, position 80, Conditional (C). |
fdaFoodCombinedPG13PG14? | {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 9-12 and 9-13. |
fdaFoodCombinedPG23? | {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. Includes both mandatory and optional AoC codes depending on the product type. Per CATAIR FDA 08-25.pdf, Tables 9-20 through 9-22. |
fdaFoodCombinedPG25? | {lot?: string;}[] | Array of lot numbers for the product. Repeatable — one entry per lot. Mandatory for Infant Formula, Acidified Foods, and LACF products. Per Table 9-24: Lot Number, positions 16-40, up to 25 chars. |
fdaFoodCombinedPG26? | {quantity?: number;unitOfMeasure?: | "CA" | "CO" | "CT" | "FL" | "IN" | "MS" | "MT" | "NE" | "PA" | "SC" | "SD" | "TN" | "VA" | "VI" | "M" | "CR" | "EN" | "AU" | "BH" | "CL" | "L" | "MX" | "G" | "ST" | "LG" | "CS" | "SE" | "BY" | "SH" | "DR" | "PK" | "CE" | "CZ" | "CB" | "DP" | "RD" | "CAR" | "BN" | "TO" | "PCS" | "PN" | "PC" | "CI" | "BB" | "PL" | "AE" | "AM" | "AT" | "BA" | "BD" | "BE" | "BF" | "BG" | "BI" | "BJ" | "BO" | "BR" | "BS" | "BT" | "BU" | "BV" | "BZ" | "CC" | "CF" | "CG" | "CH" | "CK" | "CM" | "CU" | "CV" | "CX" | "CY" | "DJ" | "FI" | "FO" | "FR" | "GB" | "GI" | "GR" | "GZ" | "HR" | "KG" | "KM" | "LB" | "MC" | "MG" | "ML" | "NO" | "PG" | "PH" | "PT" | "PY" | "RO" | "SA" | "SK" | "SL" | "SM" | "SY" | "SZ" | "TC" | "TD" | "TK" | "TR" | "TZ" | "VG" | "AP" | "BBL" | "FP" | "FT" | "PI" | "GAL" | "CAP" | "CP" | "SW" | "CM3" | "M2" | "M3" | "AMU" | "BL" | "BQT" | "BX" | "PKG" | "PO" | "PTU" | "SAD" | "SLF" | "STM" | "TWR" | "T" | "BC" | "BK" | "BP" | "BQ" | "CAG" | "CJ" | "CON" | "CTR" | "FC" | "FD" | "HG" | "ING" | "IZ" | "JC" | "JG" | "JR" | "JT" | "JY" | "KEG" | "KIT" | "LZ" | "MB" | "NS" | "NT" | "PAL" | "PU" | "PZ" | "RG" | "RL" | "RT" | "RZ" | "SU" | "TB" | "TS" | "TU" | "TY" | "VL" | "VO" | "VP" | "VQ" | "VR" | "VY" | "WB" | "BAU" | "BOL" | "CFT" | "CYD" | "DOZ" | "DPC" | "DPR" | "FOZ" | "KM2" | "KM3" | "LNM" | "MCG" | "OZ" | "PNU" | "PRS" | "PTL" | "QTL" | "SFT" | "SQI" | "STN" | "SUP" | "SYD" | "TAB" | "TON" | "TOZ" | "YD";}[] | 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. The Packaging Qualifier (position 5) is auto-assigned by the encoder as the 1-based index of the element in this array (first element → 1, second → 2, etc.). Per CATAIR FDA 08-25.pdf, Table 9-25. |
fdaFoodCombinedPG27? | {containerNumber?: string;}[] | Array of shipping container number records. Conditional and repeatable. Container numbers are required for prior notice when food arrives as containerized cargo. Each PG27 record can hold up to 3 container numbers. Per CATAIR FDA 08-25.pdf, Table 9-26. |
fdaImporterEntity? | EntityReference | FD1 — FDA Importer of Record. Conditional. Requires a point of contact (PG21). Per Table 9-17. |
fdcEntity? | EntityReference | FDC — Food Distribution Center (consolidator). One of MF, FDC, or DFI is mandatory. Per Table 9-16. |
foreignSupplierEntity? | EntityReference | FSV — Foreign Supplier Verification Program Importer. Conditional per Table 9-19. |
govAgencyProcessingCode? | "ADD" | "PRO" | "DSU" | "FEE" | "NSF" | Government Agency Processing Code identifying the food sub-type. 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 9-4: Gov Agency Processing Code, positions 14-16, Conditional (C). Allowed values: NSF, PRO, FEE, ADD, DSU. |
intendedUseCode? | "015.000" | "210.000" | "260.000" | 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 9-4: Intended Use Code, positions 42-57, Conditional (C). Per Table 9-5: Valid codes are 260.000, 015.000, 210.000. |
mfEntity? | EntityReference | MF — Manufacturer (processed food). One of MF, FDC, or DFI is mandatory. Per Table 9-16. |
ownerEntity? | EntityReference | DFP — Owner (Domestic Food Processor). Conditional per Table 9-18. |
pnsEntity? | EntityReference | PNS — Prior Notice Submitter. Mandatory per Table 9-14. |
pntEntity? | EntityReference | PNT — Prior Notice Transmitter. Mandatory per Table 9-15. |
pointOfContactEntity? | EntityReference | PK — Point of Contact / Filer / Broker. Optional per Table 9-19. |
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 9-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 9-23: Remarks Text, positions 13-80, up to 68 chars. |
secureHoldingFacilityEntity? | EntityReference | LG — Secure Holding Facility. Conditional (required when food refused for inadequate PN). Per Table 9-18. |
shipperEntity? | EntityReference | DEQ — Shipper. Optional per Table 9-19. |
temperatureQualifier? | "A" | "D" | "R" | "P" | "F" | "H" | "U" | Temperature category for quality control or preservation purposes. Placed on the first PG25 record by the encoder. Per Table 9-24: position 5, Optional (O). |
trackingNumber? | string | Express courier tracking number (FedEx, UPS, DHL, etc.). Submitted in lieu of an airway bill or bill of lading when mode of transportation is mail or express courier. Per CATAIR FDA 08-25.pdf, Table 9-27: Package Tracking Number, positions 21-70, up to 50 chars, Conditional (C). |
trackingNumberCode? | string | Express Consignment Carrier SCAC or AWB prefix for the tracking number. For carriers without a SCAC or AWB prefix, leave blank and enter the carrier name via the CAN AoC code in PG23 instead. Submitted when mode of transportation is mail or express courier. Per CATAIR FDA 08-25.pdf, Table 9-27: Package Tracking Number Code, positions 17-20, Conditional (C). |
ultimateConsigneeEntity? | EntityReference | UC — Ultimate Consignee. Conditional per Table 9-18. |