@repo/shared / TobaccoType
Interface: TobaccoType
FDA Tobacco Products PGA data for CBP entry summary filings.
Required for imports of cigarettes, cigars, smokeless tobacco, e-cigarettes, and other tobacco products regulated by FDA's Center for Tobacco Products (CTP). Covers processing codes, product codes, source countries, entity roles, and affirmations of compliance.
Properties
| Property | Type | Description |
|---|---|---|
aocEntries? | {aocCode?: "SE" | "EXE" | "PMT" | "ERR" | "CMT" | "HPC" | "TST";aocQualifier?: string;}[] | Affirmation of Compliance entries for this tobacco filing. ALL AoC codes are optional for Tobacco per CTP feedback. Each code can only be transmitted once per FDA line. Valid codes: CMT, SE, PMT, EXE, TST, ERR, HPC. Per CATAIR FDA 08-25.pdf, Table 12-18. |
arrivalInfo? | {arrivalDate?: Date;arrivalTime?: string;inspectionLocation?: string;inspectionLocationCode?: string;statusCode?: "A" | "F";}[] | Anticipated arrival information. At least one PG30 with status "A" is mandatory. For entry type 21 from FTZ, an additional PG30 with status "F" and FIRMS code is required. Per CATAIR FDA 08-25.pdf, Chapter 12 PG30 record. |
commodityDescription? | string | Common, market, or usual name description of the tobacco product. Transmit information such as length, color, pack count, flavor, and nicotine strength as applicable. Per CATAIR FDA 08-25.pdf, Table 12-9: positions 24-80, Mandatory (M). |
correctionIndicator? | boolean | Correction indicator — for future use per CATAIR. Per CATAIR FDA 08-25.pdf, Table 12-3: position 79, Optional (O). |
countryCode? | string | Country code corresponding to the source type (ISO 2-letter). Per CATAIR FDA 08-25.pdf, Table 12-7: positions 8-9, Mandatory (M). |
deliveredToEntity? | EntityReference | Delivered-To Party (role code: DP). Mandatory for all Tobacco submissions per Table 12-13. PG19 Entity Name + Address 1 mandatory; PG20 City + Country mandatory. |
disclaimer? | "A" | "F" | Disclaimer code when not providing a full tobacco PGA message set. A = Product is not regulated by this agency. F = Product manufactured in the US/DC/PR, never left US (Entry Type 21 only). If disclaiming, govAgencyProcessingCode and govAgencyProgramCode should both be populated with "FDA". Per CATAIR FDA 08-25.pdf, Table 12-3: position 80, Conditional (C). |
fdaImporterEntity? | EntityReference | FDA Importer of Record (role code: FD1). Mandatory for all Tobacco submissions per Table 12-12. PG19 Entity Name + Address 1 mandatory; PG20 City + Country mandatory. PG21 individual contact (name, phone, email) also required. |
govAgencyProcessingCode? | "INV" | "CSU" | "FFM" | FDA processing code for this tobacco product. CSU = Consumer Use, FFM = For Further Manufacturing, INV = Investigational. Mandatory when not disclaiming. Per CATAIR FDA 08-25.pdf, Table 12-3: positions 14-16, Conditional (C). |
intendedUseCode? | | "085.000" | "090.000" | "100.000" | "110.000" | "120.000" | "130.000" | "130.037" | "140.000" | "150.000" | "180.000" | "920.000" | "970.000" | "980.000" | Intended use code for the tobacco product after importation. Conditional: Required when processing code is INV (one of the 180 base codes must be supplied). Optional for CSU and FFM. Per CATAIR FDA 08-25.pdf, Table 12-3 and Table 12-4: positions 42-57, Conditional (C). |
investigationalLabEntity? | EntityReference | Independent Third Party Lab (role code: ITL). Conditional — required when processing code is INV (Investigational) per Table 12-14. |
labelEntity? | EntityReference | Laboratory (role code: LAB). Conditional — required when processing code is INV (Investigational) per Table 12-14. |
lotNumber? | string | Lot number assigned by the manufacturer to the product. Per CATAIR FDA 08-25.pdf, Table 12-17: positions 16-40, Optional (O). |
manufacturerEntity? | EntityReference | Manufacturer of goods (role code: MF). Mandatory for all Tobacco submissions per Table 12-10. PG19 Entity Name + Address 1 mandatory; PG20 City + Country mandatory. |
packaging? | {packagingQualifier?: number;quantity?: number;unitOfMeasure?: string;}[] | Product packaging details. Up to 6 packaging levels (outermost=1 to innermost=6). Conditional for Tobacco: if one field is entered, all three (qualifier, quantity, UoM) are required. Per CATAIR FDA 08-25.pdf, Chapter 12 PG26 record. |
pgaLineValue? | number | PGA Line Value — the declared value for this PGA line in US dollars. Per CATAIR FDA 08-25.pdf, Table 12-17: positions 41-52, Optional (O). |
pointOfContactEntity? | EntityReference | Point of Contact / Filer/Broker (role code: PK). Optional for Tobacco per Tables 12-10 through 12-16. Submitted as a PG21-only record (no PG19/PG20). User picks a specific individual contact. |
productCodeNumber? | string | FDA Product Code Number identifying the tobacco product. Must be exactly 7 characters. Per CATAIR FDA 08-25.pdf, Table 12-5: positions 10-28, Mandatory (M). |
remarksText? | string | General remarks text to accompany this tobacco filing. Only one PG24 allowed per FDA line; remarks type code is always "GEN". Per CATAIR FDA 08-25.pdf, Table 12-19: positions 8-80, Optional. |
retailerDistributorEntity? | EntityReference | Retailer/Distributor (role code: RD). Optional per Table 12-15. |
shipperEntity? | EntityReference | Shipper (role code: DEQ). Mandatory for all Tobacco submissions per Table 12-11. PG19 Entity Name + Address 1 mandatory; PG20 City + Country mandatory. |
sourceTypeCode? | "30" | "39" | Source type code identifying the role the country had in producing the tobacco product. 39 (Country of Production) is required for all tobacco entries. 30 (Country of Source) may also be entered if available. Per CATAIR FDA 08-25.pdf, Table 12-7: positions 5-7, Mandatory (M). |
submitterEntity? | EntityReference | Submitter (role code: TB). Optional per Table 12-16. |
temperatureQualifier? | "A" | "D" | "R" | "P" | "F" | "H" | "U" | Temperature qualifier for the product condition. Per CATAIR FDA 08-25.pdf, Table 12-17: position 5, Optional (O). |
tradeName? | string | Trade or brand name of the tobacco product. Mandatory when processing code is CSU (Consumer Use). Optional for FFM and INV. Per CATAIR FDA 08-25.pdf, Table 12-8: positions 5-39, Conditional (C). |