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). The formNumber field is the top-level discriminator: it drives PG22 codes, which PG24 codes are valid, which entities are required, and most conditional logic.

Properties

Property	Type	Description
`additionalItemIdNumbers?`	{ `itemIdNumber?`: `string`; }[]	Identity numbers of additional identical units. The encoder packs four numbers per PG08 record. The qualifier comes from `itemIdNumberQualifier` (PG07) — there is no per-unit qualifier override on the wire. Per CATAIR EPA 04-25.pdf, Tables 12 and 38: positions 5-72, Mandatory/Conditional. Max 17 chars each.
`bondExemption?`	`"E1Y"` \| `"E1N"`	Bond Exemption Status. 3520-21 only; conditionally required for (importCode "1" AND industryCode "G") and for importCode "22". E1Y = Exempt from Bond, E1N = Not Exempt. Encoder emits PG24 with remarksTypeCode "EP1", remarksCode = bondExemption. Per CATAIR EPA 04-25.pdf, Table 35 + lines 1660-1662.
`bondPolicyNumber?`	`string`	EPA bond policy number. Drives PG14 with LPCO Type "EP7". Required for certain import codes — see CATAIR Tables 18 / 46. Per CATAIR EPA 04-25.pdf, Tables 16 and 44: max 33 chars.
`certifyingIndividualEntity?`	`EntityReference`	Certifying Individual (role code CI). Mandatory for both forms — this is the person signing the EPA declaration on PG22. Per CATAIR Note 1, the CI's PG19/20/21 group is emitted AFTER PG22 when CI has no additional roles. Emits PG19 + PG20 + PG21 (full address + contact). PG20 is mandatory for CI on 3520-21 (Tables 49/50) and optional but commonly included on 3520-1.
`componentIncluded?`	`boolean`	Whether the filing reports an additional Component record (PG02C) following the Product (PG02P). Typical case: an engine inside a vehicle that needs to be reported separately from the vehicle product. The encoder emits PG02P always; PG02C is emitted only when this flag is true. CATAIR permits at most one P + one C per PGA message set; multi-pair filings go through PG50/PG51 groupings (not yet supported). Per CATAIR EPA 04-25.pdf, Tables 5/6 (3520-1) and 31/32 (3520-21).
`correctionIndicator?`	`"A"` \| `"D"` \| `"R"`	Correction action code for re-filing amended PGA data. A=Add, D=Delete, R=Replace. Only set when transmitting a correction transaction; leave blank for original filings. Per CATAIR EPA 04-25.pdf, Tables 4 and 30: position 79, Conditional (C); Appendix PGA Data Corrections.
`dateOfSignature?`	`Date`	Date the certifying individual signed the declaration. Encoded MMDDYYYY (8 digits) on the wire. The only user-input PG22 field; documentIdentifier / declarationCode / entityRoleCode / declarationCertification are all encoder-determined. Per CATAIR EPA 04-25.pdf, Tables 26 and 54: positions 26-33, Mandatory (M).
`disclaimer?`	`"A"` \| `"D"` \| `"B"` \| `"C"`	Disclaimer code when this PGA line does not require a full V&E message set. When set, only OI + PG01 records are emitted; all other PGA records are suppressed. Disclaimed lines must be ordered after all non-disclaimed lines within the entry. Valid codes per Tables 4/30 Note 2: A (not regulated), B (not required per agency), C (filed other agency means), D (filed paper). Codes E/F/G are other-agency only. Per CATAIR EPA 04-25.pdf, Tables 4 and 30: position 80, Conditional (C).
`electronicImageSubmittedFlag?`	`boolean`	Whether an electronic image (label, letter, additional documentation) has been pre-filed via the Document Image System (DIS) for this filing. If true, at least one image must already exist in DIS at the time the entry/PGA message set is transmitted. Per CATAIR EPA 04-25.pdf, Tables 4 and 30: position 17, Optional (O).
`enginePowerUnit?`	`"KW"` \| `"HP"`	Unit for enginePowerValue: KW (kilowatts) or HP (horsepower). Drives the qualifier field of the PG10 V03 record. Encoder requires both enginePowerValue and enginePowerUnit to emit a V03 record; one without the other is a validation error. Per CATAIR EPA 04-25.pdf, Tables 15 and 43.
`enginePowerValue?`	`number`	Maximum engine power rating (numeric value only). Drives the description field of the PG10 record with Commodity Qualifier Code "V03". Paired with enginePowerUnit (KW or HP). Per CATAIR EPA 04-25.pdf, Tables 13/41: integer value, no implied decimals.
`exemptionNumber?`	`string`	Exemption number from the importer's EPA Letter of Approval (e.g., "2016-JUNE-LD-NORES-450"). Drives PG14 with LPCO Type "EP9". Required for certain import codes — see CATAIR Tables 18 / 46. Per CATAIR EPA 04-25.pdf, Tables 16 and 44: max 33 chars.
`formNumber?`	`"3520-1"` \| `"3520-21"`	Which EPA V&E form is being filed. Encoder uses this to populate PG22 documentIdentifier (942 vs 943) and declarationCode (EP2 vs EP1), and the option sets shown by the importCode / industryCode dropdowns. Mandatory (unless disclaimed). Per CATAIR EPA 04-25.pdf, "V&E Form 3520-1" (p. 23) and "V&E Form 3520-21" (p. 50).
`generalRemarks?`	`string`	Optional free-form remarks for EPA. Encoder emits PG24 with remarksTypeCode "GEN", remarksText = generalRemarks. Max 68 chars. Per CATAIR EPA 04-25.pdf, Tables 7/33.
`htsNumber?`	`string`	The HTS number from this line item's chapter1to97s that this PGA message set is reported under. Each PGA attaches to exactly one of the line's tariff classifications; the encoder emits the PGA grouping after that HTS's 50-Record. Autofilled when the line has exactly one HTS; with multiple classifications the filer picks which one this PGA applies to.
`importCode?`	\| `"A"` \| `"11"` \| `"12"` \| `"21"` \| `"22"` \| `"23"` \| `"10"` \| `"20"` \| `"1"` \| `"2"` \| `"3"` \| `"5"` \| `"6"` \| `"7"` \| `"8"` \| `"Y"` \| `"F"` \| `"I"` \| `"M"` \| `"H"` \| `"B"` \| `"U"` \| `"E"` \| `"14"` \| `"15"` \| `"16"` \| `"17"` \| `"18"` \| `"19"` \| `"C"` \| `"J"` \| `"K"` \| `"L"` \| `"N"` \| `"W"` \| `"Z"` \| `"G"` \| `"13"` \| `"25"` \| `"EE"` \| `"4"` \| `"FF"` \| `"O"` \| `"Q"` \| `"24A"` \| `"24B"` \| `"24C"`	EPA Import Code — the provision under which the commodity is being imported. Mandatory for both forms. Valid values depend on formNumber: - 3520-1: alpha codes from VAndEImportCode3520_1 (B, F, EE, FF, M, E, L, U, W, Y, G, I, K, N, O, A, C, J, Z, H, Q) - 3520-21: numeric codes from VAndEImportCode3520_21 (1–25 plus 24A/24B/24C) Encoder emits PG24 with remarksTypeCode "EP2", remarksCode = importCode. Per CATAIR EPA 04-25.pdf, Tables 9 (3520-1) and 35 (3520-21).
`importerEntity?`	`EntityReference`	Importer of Record (role code IM). Mandatory for both forms. Emits PG19 + PG20 (full address) + PG21 (contact: name + phone + email).
`industryCode?`	`"A"` \| `"D"` \| `"F"` \| `"I"` \| `"H"` \| `"B"` \| `"E"` \| `"C"` \| `"J"` \| `"G"`	EPA Industry Code — identifies the engine category. 3520-21 only; mandatory there. Codes A–J per Table 35. Encoder emits PG24 with remarksTypeCode "EP3", remarksCode = industryCode. Per CATAIR EPA 04-25.pdf, Table 35.
`itemIdNumber?`	`string`	Identity number of the FIRST unit in the filing (VIN, engine serial number, or generic serial number — the type is determined by itemIdNumberQualifier). Additional identical units go in `additionalItemIdNumbers`. Per CATAIR EPA 04-25.pdf, Tables 10 and 36: positions 64-80, Mandatory (M). Max 17 chars.
`itemIdNumberQualifier?`	`"SE"` \| `"AKG"` \| `"ENN"`	Code identifying the type of identity number being reported for the units in this filing. ENN = Engine Serial Number, SE = Serial Number, AKG = Vehicle Identification Number (VIN). This qualifier applies to the PG07 identity number AND every PG08 identity number — CATAIR does not allow per-unit qualifier overrides. Per CATAIR EPA 04-25.pdf, Tables 11 and 37: positions 61-63, Mandatory (M).
`manufactureDateSource?`	`"ENG"` \| `"VEH"` \| `"OTH"`	Source where the manufacture date is read from. Drives the PG10 record with Commodity Qualifier Code "V05". Mandatory for 3520-21 (every filing); conditional for 3520-1. Per CATAIR EPA 04-25.pdf, Tables 14/15 (3520-1) and 41/42/43 (3520-21).
`manufactureDateSourceDescription?`	`string`	Free-form explanation of where the manufacture date was obtained. Required only when manufactureDateSource is "OTH". Goes in the Commodity Characteristic Description field of the V05 PG10 record. Per CATAIR EPA 04-25.pdf, Tables 15 and 43 OTH row. Max 57 chars.
`manufactureMonthAndYear?`	`Date`	Manufacture month and year of the vehicle or engine. Wire format is MMYYYY (6 digits) — the day component of this Date is ignored at encoding time. Per CATAIR EPA 04-25.pdf, Tables 10 and 36: positions 55-60, Mandatory (M).
`manufacturerEntity?`	`EntityReference`	Manufacturer (role code MF). Mandatory for both forms. Emits PG19 only — no address, no 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: positions 40-54, Mandatory (M). Max 15 chars.
`modelYear?`	`number`	Four-digit model year of the vehicle or engine. Drives the description field of the PG10 record with Commodity Qualifier Code "V06". Per CATAIR EPA 04-25.pdf, Tables 13/41: format YYYY.
`naicBondIssuerEntity?`	`EntityReference`	NAIC Bond Issuer (role code NAI). Conditional, 3520-21 only. Required when (importCode "1" AND industryCode "G") OR importCode "22". Emits PG19 + PG20 (no contact). The trade party's identifier field carries the NAIC bond issuer number (PG19 Entity Number); the state of issue is the PG20 State/Province. Per CATAIR EPA 04-25.pdf, Tables 47/48 + Appendix A.
`ownerEntity?`	`EntityReference`	Owner / Designated for Permit holder (role code DFP). Mandatory for 3520-1 only; not in the 3520-21 minimum-required entity set. Emits PG19 + PG20 (full address) + PG21 (contact).
`regulationCited?`	`string`	Regulation citation for "Other exemption" filings. Required when 3520-21 + importCode "25". Free-form text up to 68 chars. Encoder emits PG24 with remarksTypeCode "EP4", remarksText = regulationCited. Per CATAIR EPA 04-25.pdf, Tables 7/33 + line 1664.
`storageLocationEntity?`	`EntityReference`	Storage Location (role code STL). Conditional — required on 3520-21 with Import Code 24a or 24b. Optional on 3520-1. Emits PG19 + PG20 (full address) + PG21 (contact).
`testGroupOrEngineFamilyName?`	`string`	Exhaust Engine Family Name from the Certificate of Conformity (NOT the Evaporative Engine Family name). Drives PG14 with LPCO Type "EP4". Required for certain import codes — see CATAIR Tables 18 / 46. Per CATAIR EPA 04-25.pdf, Tables 18 and 46: max 12 characters including periods.

← Back to ABI Type Reference

@repo/shared

@repo/shared / VAndEType

Interface: VAndEType

EPA Vehicles and Engines (V&E) PGA data for CBP entry summary filings.

Properties

Property	Type	Description
`additionalItemIdNumbers?`	{ `itemIdNumber?`: `string`; }[]	Identity numbers of additional identical units. The encoder packs four numbers per PG08 record. The qualifier comes from `itemIdNumberQualifier` (PG07) — there is no per-unit qualifier override on the wire. Per CATAIR EPA 04-25.pdf, Tables 12 and 38: positions 5-72, Mandatory/Conditional. Max 17 chars each.
`bondExemption?`	`"E1Y"` \| `"E1N"`	Bond Exemption Status. 3520-21 only; conditionally required for (importCode "1" AND industryCode "G") and for importCode "22". E1Y = Exempt from Bond, E1N = Not Exempt. Encoder emits PG24 with remarksTypeCode "EP1", remarksCode = bondExemption. Per CATAIR EPA 04-25.pdf, Table 35 + lines 1660-1662.
`bondPolicyNumber?`	`string`	EPA bond policy number. Drives PG14 with LPCO Type "EP7". Required for certain import codes — see CATAIR Tables 18 / 46. Per CATAIR EPA 04-25.pdf, Tables 16 and 44: max 33 chars.
`certifyingIndividualEntity?`	`EntityReference`	Certifying Individual (role code CI). Mandatory for both forms — this is the person signing the EPA declaration on PG22. Per CATAIR Note 1, the CI's PG19/20/21 group is emitted AFTER PG22 when CI has no additional roles. Emits PG19 + PG20 + PG21 (full address + contact). PG20 is mandatory for CI on 3520-21 (Tables 49/50) and optional but commonly included on 3520-1.
`componentIncluded?`	`boolean`	Whether the filing reports an additional Component record (PG02C) following the Product (PG02P). Typical case: an engine inside a vehicle that needs to be reported separately from the vehicle product. The encoder emits PG02P always; PG02C is emitted only when this flag is true. CATAIR permits at most one P + one C per PGA message set; multi-pair filings go through PG50/PG51 groupings (not yet supported). Per CATAIR EPA 04-25.pdf, Tables 5/6 (3520-1) and 31/32 (3520-21).
`correctionIndicator?`	`"A"` \| `"D"` \| `"R"`	Correction action code for re-filing amended PGA data. A=Add, D=Delete, R=Replace. Only set when transmitting a correction transaction; leave blank for original filings. Per CATAIR EPA 04-25.pdf, Tables 4 and 30: position 79, Conditional (C); Appendix PGA Data Corrections.
`dateOfSignature?`	`Date`	Date the certifying individual signed the declaration. Encoded MMDDYYYY (8 digits) on the wire. The only user-input PG22 field; documentIdentifier / declarationCode / entityRoleCode / declarationCertification are all encoder-determined. Per CATAIR EPA 04-25.pdf, Tables 26 and 54: positions 26-33, Mandatory (M).
`disclaimer?`	`"A"` \| `"D"` \| `"B"` \| `"C"`	Disclaimer code when this PGA line does not require a full V&E message set. When set, only OI + PG01 records are emitted; all other PGA records are suppressed. Disclaimed lines must be ordered after all non-disclaimed lines within the entry. Valid codes per Tables 4/30 Note 2: A (not regulated), B (not required per agency), C (filed other agency means), D (filed paper). Codes E/F/G are other-agency only. Per CATAIR EPA 04-25.pdf, Tables 4 and 30: position 80, Conditional (C).
`electronicImageSubmittedFlag?`	`boolean`	Whether an electronic image (label, letter, additional documentation) has been pre-filed via the Document Image System (DIS) for this filing. If true, at least one image must already exist in DIS at the time the entry/PGA message set is transmitted. Per CATAIR EPA 04-25.pdf, Tables 4 and 30: position 17, Optional (O).
`enginePowerUnit?`	`"KW"` \| `"HP"`	Unit for enginePowerValue: KW (kilowatts) or HP (horsepower). Drives the qualifier field of the PG10 V03 record. Encoder requires both enginePowerValue and enginePowerUnit to emit a V03 record; one without the other is a validation error. Per CATAIR EPA 04-25.pdf, Tables 15 and 43.
`enginePowerValue?`	`number`	Maximum engine power rating (numeric value only). Drives the description field of the PG10 record with Commodity Qualifier Code "V03". Paired with enginePowerUnit (KW or HP). Per CATAIR EPA 04-25.pdf, Tables 13/41: integer value, no implied decimals.
`exemptionNumber?`	`string`	Exemption number from the importer's EPA Letter of Approval (e.g., "2016-JUNE-LD-NORES-450"). Drives PG14 with LPCO Type "EP9". Required for certain import codes — see CATAIR Tables 18 / 46. Per CATAIR EPA 04-25.pdf, Tables 16 and 44: max 33 chars.
`formNumber?`	`"3520-1"` \| `"3520-21"`	Which EPA V&E form is being filed. Encoder uses this to populate PG22 documentIdentifier (942 vs 943) and declarationCode (EP2 vs EP1), and the option sets shown by the importCode / industryCode dropdowns. Mandatory (unless disclaimed). Per CATAIR EPA 04-25.pdf, "V&E Form 3520-1" (p. 23) and "V&E Form 3520-21" (p. 50).
`generalRemarks?`	`string`	Optional free-form remarks for EPA. Encoder emits PG24 with remarksTypeCode "GEN", remarksText = generalRemarks. Max 68 chars. Per CATAIR EPA 04-25.pdf, Tables 7/33.
`htsNumber?`	`string`	The HTS number from this line item's chapter1to97s that this PGA message set is reported under. Each PGA attaches to exactly one of the line's tariff classifications; the encoder emits the PGA grouping after that HTS's 50-Record. Autofilled when the line has exactly one HTS; with multiple classifications the filer picks which one this PGA applies to.
`importCode?`	\| `"A"` \| `"11"` \| `"12"` \| `"21"` \| `"22"` \| `"23"` \| `"10"` \| `"20"` \| `"1"` \| `"2"` \| `"3"` \| `"5"` \| `"6"` \| `"7"` \| `"8"` \| `"Y"` \| `"F"` \| `"I"` \| `"M"` \| `"H"` \| `"B"` \| `"U"` \| `"E"` \| `"14"` \| `"15"` \| `"16"` \| `"17"` \| `"18"` \| `"19"` \| `"C"` \| `"J"` \| `"K"` \| `"L"` \| `"N"` \| `"W"` \| `"Z"` \| `"G"` \| `"13"` \| `"25"` \| `"EE"` \| `"4"` \| `"FF"` \| `"O"` \| `"Q"` \| `"24A"` \| `"24B"` \| `"24C"`	EPA Import Code — the provision under which the commodity is being imported. Mandatory for both forms. Valid values depend on formNumber: - 3520-1: alpha codes from VAndEImportCode3520_1 (B, F, EE, FF, M, E, L, U, W, Y, G, I, K, N, O, A, C, J, Z, H, Q) - 3520-21: numeric codes from VAndEImportCode3520_21 (1–25 plus 24A/24B/24C) Encoder emits PG24 with remarksTypeCode "EP2", remarksCode = importCode. Per CATAIR EPA 04-25.pdf, Tables 9 (3520-1) and 35 (3520-21).
`importerEntity?`	`EntityReference`	Importer of Record (role code IM). Mandatory for both forms. Emits PG19 + PG20 (full address) + PG21 (contact: name + phone + email).
`industryCode?`	`"A"` \| `"D"` \| `"F"` \| `"I"` \| `"H"` \| `"B"` \| `"E"` \| `"C"` \| `"J"` \| `"G"`	EPA Industry Code — identifies the engine category. 3520-21 only; mandatory there. Codes A–J per Table 35. Encoder emits PG24 with remarksTypeCode "EP3", remarksCode = industryCode. Per CATAIR EPA 04-25.pdf, Table 35.
`itemIdNumber?`	`string`	Identity number of the FIRST unit in the filing (VIN, engine serial number, or generic serial number — the type is determined by itemIdNumberQualifier). Additional identical units go in `additionalItemIdNumbers`. Per CATAIR EPA 04-25.pdf, Tables 10 and 36: positions 64-80, Mandatory (M). Max 17 chars.
`itemIdNumberQualifier?`	`"SE"` \| `"AKG"` \| `"ENN"`	Code identifying the type of identity number being reported for the units in this filing. ENN = Engine Serial Number, SE = Serial Number, AKG = Vehicle Identification Number (VIN). This qualifier applies to the PG07 identity number AND every PG08 identity number — CATAIR does not allow per-unit qualifier overrides. Per CATAIR EPA 04-25.pdf, Tables 11 and 37: positions 61-63, Mandatory (M).
`manufactureDateSource?`	`"ENG"` \| `"VEH"` \| `"OTH"`	Source where the manufacture date is read from. Drives the PG10 record with Commodity Qualifier Code "V05". Mandatory for 3520-21 (every filing); conditional for 3520-1. Per CATAIR EPA 04-25.pdf, Tables 14/15 (3520-1) and 41/42/43 (3520-21).
`manufactureDateSourceDescription?`	`string`	Free-form explanation of where the manufacture date was obtained. Required only when manufactureDateSource is "OTH". Goes in the Commodity Characteristic Description field of the V05 PG10 record. Per CATAIR EPA 04-25.pdf, Tables 15 and 43 OTH row. Max 57 chars.
`manufactureMonthAndYear?`	`Date`	Manufacture month and year of the vehicle or engine. Wire format is MMYYYY (6 digits) — the day component of this Date is ignored at encoding time. Per CATAIR EPA 04-25.pdf, Tables 10 and 36: positions 55-60, Mandatory (M).
`manufacturerEntity?`	`EntityReference`	Manufacturer (role code MF). Mandatory for both forms. Emits PG19 only — no address, no 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: positions 40-54, Mandatory (M). Max 15 chars.
`modelYear?`	`number`	Four-digit model year of the vehicle or engine. Drives the description field of the PG10 record with Commodity Qualifier Code "V06". Per CATAIR EPA 04-25.pdf, Tables 13/41: format YYYY.
`naicBondIssuerEntity?`	`EntityReference`	NAIC Bond Issuer (role code NAI). Conditional, 3520-21 only. Required when (importCode "1" AND industryCode "G") OR importCode "22". Emits PG19 + PG20 (no contact). The trade party's identifier field carries the NAIC bond issuer number (PG19 Entity Number); the state of issue is the PG20 State/Province. Per CATAIR EPA 04-25.pdf, Tables 47/48 + Appendix A.
`ownerEntity?`	`EntityReference`	Owner / Designated for Permit holder (role code DFP). Mandatory for 3520-1 only; not in the 3520-21 minimum-required entity set. Emits PG19 + PG20 (full address) + PG21 (contact).
`regulationCited?`	`string`	Regulation citation for "Other exemption" filings. Required when 3520-21 + importCode "25". Free-form text up to 68 chars. Encoder emits PG24 with remarksTypeCode "EP4", remarksText = regulationCited. Per CATAIR EPA 04-25.pdf, Tables 7/33 + line 1664.
`storageLocationEntity?`	`EntityReference`	Storage Location (role code STL). Conditional — required on 3520-21 with Import Code 24a or 24b. Optional on 3520-1. Emits PG19 + PG20 (full address) + PG21 (contact).
`testGroupOrEngineFamilyName?`	`string`	Exhaust Engine Family Name from the Certificate of Conformity (NOT the Evaporative Engine Family name). Drives PG14 with LPCO Type "EP4". Required for certain import codes — see CATAIR Tables 18 / 46. Per CATAIR EPA 04-25.pdf, Tables 18 and 46: max 12 characters including periods.

← Back to ABI Type Reference