@repo/shared / VAndEType
Interface: VAndEType
EPA Vehicles and Engines (V&E) PGA data for CBP entry summary filings.
Required for imports of motor vehicles and nonroad engines subject to EPA emission standards. Certifies compliance using EPA Form 3520-1 (highway vehicles/engines) or 3520-21 (nonroad equipment).
Properties
| Property | Type | Description |
|---|---|---|
certifyingIndividualEntity? | EntityReference | Certifying Individual (role code: CI). Mandatory for both 3520-1 and 3520-21 per Tables 19, 47. PG19 + PG21 only (no PG20 address). All PG21 data elements required (name, phone, email). |
correctionIndicator? | "A" | "D" | "R" | Correction indicator for re-filing amended data. Tells CBP/EPA which action to take on the corrected record: A=Add, D=Delete, R=Replace. Per CATAIR EPA 04-25.pdf, Tables 4 and 30: Conditional (C) — only for corrections. |
dateOfSignature? | Date | Date the certifying individual signed the declaration. Format MMDDYYYY (8 digits). Per CATAIR EPA 04-25.pdf, Tables 26 and 54: Mandatory within record (M). |
declarationCode? | "EP1" | "EP2" | Declaration code identifying the specific certification statement being attested to. EP1 = Certification Statement for EPA Form 3520-21. EP2 = Certification Statement for EPA Form 3520-1. Per CATAIR EPA 04-25.pdf, Tables 28 and 56: Mandatory within record (M). |
disclaimer? | "A" | "D" | "F" | "B" | "E" | "C" | "G" | Disclaimer code when this PGA line does not require a full V&E message set. Valid codes: A=Not regulated, B=Not required per agency, C=Filed other means, D=Filed paper. Disclaimed PGA lines must be ordered after all non-disclaimed PGA lines in the entry. Per CATAIR EPA 04-25.pdf, Tables 4 and 30: Conditional (C). |
documentIdentifier? | "942" | "943" | Document identifier — the EPA form number being filed. 942 = EPA Form 3520-1 (Motor Vehicles and Motor Vehicle Engines). 943 = EPA Form 3520-21 (Nonroad or Heavy-Duty Highway Engines / Nonroad Vehicles). Per CATAIR EPA 04-25.pdf, Tables 26/27 and 54/55: Mandatory within record (M). |
electronicImageSubmittedFlag? | boolean | Whether an electronic image (e.g., label, letter, additional documentation) has been submitted via the Document Image System (DIS) for this filing. Set to true if an image has been uploaded to DIS. At least one image must exist in DIS if this flag is set. Per CATAIR EPA 04-25.pdf, Tables 4 and 30: Optional (O). |
importerEntity? | EntityReference | Importer of Record (role code: IM). Mandatory for both 3520-1 and 3520-21 per Tables 19, 47. PG19 + PG20 address + PG21 full contact (name, phone, email). |
itemIdNumber? | string | The actual item identity number for the first vehicle/engine in the shipment (e.g., a VIN like "ZHWUU16M4CLAU5577" or engine serial number "MHO-874200"). Per CATAIR EPA 04-25.pdf, Tables 10 and 36: position 64-80, Mandatory (M). Max 17 chars. |
itemIdNumberQualifier? | "SE" | "AKG" | "ENN" | Code identifying the type of item identity number provided for the first vehicle/engine. ENN = Engine Serial Number, SE = Serial Number, AKG = Vehicle Identification Number (VIN). Per CATAIR EPA 04-25.pdf, Tables 11 and 37: Mandatory (M). |
manufactureMonthAndYear? | Date | Manufacture month and year of the vehicle or engine. Format is MMYYYY (6 digits). For example, "052016" for May 2016. The date the vehicle or engine was physically built. Per CATAIR EPA 04-25.pdf, Tables 10 and 36: Mandatory (M). |
manufacturerEntity? | EntityReference | Manufacturer (role code: MF). Mandatory for both 3520-1 and 3520-21 per Tables 19, 47. PG19 only — no PG20 address, no PG21 contact. |
model? | string | Commercial model number of the vehicle or engine (e.g., "LP700-4", "EM1002"). Per CATAIR EPA 04-25.pdf, Tables 10 and 36: Mandatory (M). Max 15 characters. |
ownerEntity? | EntityReference | Owner / Designated for Permit holder (role code: DFP). Mandatory for 3520-1 (motor vehicles); not required for 3520-21 per Tables 19, 47. PG19 + PG20 address + PG21 full contact (name, phone, email). |
storageLocationEntity? | EntityReference | Storage Location (role code: STL). Conditional — required for import codes 24a, 24b, 24c per Tables 19, 47. PG19 + PG20 address + PG21 full contact (name, phone, email). |
vandePG02? | {itemType?: "P" | "C";}[] | Product identifier records. Each entry indicates whether subsequent records relate to a Product (P) or a Component (C) of a product. When a vehicle contains an engine that needs separate reporting, the engine is declared as a Component under its own PG02. Repeatable for product/component grouping patterns. Per CATAIR EPA 04-25.pdf, Tables 5/6 and 31/32: Mandatory (M). |
vandePG08? | {itemIdNumber?: string;}[] | Additional item identity numbers for subsequent identical vehicles/engines in the same shipment. The first unit's number is in PG07; use PG08 for each additional unit. Per CATAIR EPA 04-25.pdf, Tables 12 and 38: Conditional. Max 17 chars each. |
vandePG10? | {commodityCharacteristicDescription?: string;commodityCharacteristicQualifier?: "KW" | "HP" | "ENG" | "VEH" | "OTH";commodityQualifierCode?: "V03" | "V05" | "V06";}[] | Characteristics of the product or component not reported elsewhere. Required for all 3520-21 filings (minimum one PG10 for manufacture date location via V05). Additional PG10 records conditionally required based on import code. Per CATAIR EPA 04-25.pdf, Tables 13/41: Mandatory for 3520-21, Conditional for 3520-1. |
vandePG14? | {lpcoNumberOrName?: string;lpcoType?: "EP4" | "EP7" | "EP9";}[] | Licenses, permits, certificates, or exemptions issued by EPA. Conditional record; required based on Import Code in PG24 (e.g., codes B/F require EP4 Test Group name; codes G/I/K require EP9 exemption number; certain codes require EP7 bond policy number). Per CATAIR EPA 04-25.pdf, Tables 16/44: Conditional. |
vandePG24? | {remarksCode?: | "A" | "D" | "11" | "12" | "21" | "22" | "23" | "10" | "20" | "1" | "2" | "3" | "5" | "6" | "7" | "8" | "Y" | "F" | "I" | "M" | "H" | "9" | "B" | "U" | "E" | "14" | "15" | "16" | "17" | "18" | "19" | "C" | "J" | "K" | "L" | "N" | "W" | "Z" | "G" | "13" | "25" | "E1Y" | "E1N" | "EE" | "FF" | "O" | "Q" | "4" | "24A" | "24B" | "24C";remarksText?: string;remarksTypeCode?: "GEN" | "EP1" | "EP2" | "EP3" | "EP4";}[] | Import & Industry Codes and Remarks. Mandatory for all V&E filings. For 3520-1: minimum one PG24 with EP2 (Import Code). For 3520-21: minimum two PG24s — one EP3 (Industry Code) and one EP2 (Import Code). Additional PG24s for EP1 (Bond Exemption), EP4 (Regulation Cited), or GEN (General Remarks). Per CATAIR EPA 04-25.pdf, Tables 7/8/9 and 33/34/35. |