@repo/shared / AACAPQAVSABSType
Interface: AACAPQAVSABSType
APHIS agricultural commodity PGA data for CBP entry summary filings.
Covers four APHIS programs: AAC (Animal Care), APQ (Plant Protection and Quarantine), AVS (Veterinary Services), and ABS (Biotechnology Regulatory Services). Required for imports of animals, plants, plant products, veterinary biologics, and genetically engineered organisms subject to APHIS permit and inspection requirements.
Properties
| Property | Type | Description |
|---|---|---|
arrivalDate? | Date | Anticipated arrival date or pre-clearance date in MMDDCCYY. |
arrivalLocation? | string | Port code or location identifier. When status=A: 4-char Schedule D CBP port code. When status=P: UN/LOCODE. Up to 50 chars (PG30 positions 22-71). |
arrivalStatus? | "A" | "P" | Inspection/laboratory testing status: A (Anticipated arrival) or P (Pre-cleared). Per APHIS 12-24.pdf p.172: only A and P are valid for APHIS. inspectionOrArrivalLocationCode is encoder-inferred from this (A→2, P→3). |
citation? | string | PG60 CIT — citation text. Free-form. Encoder emits as PG60 CIT against the relevant entity. |
commodityRouting? | {commodityPoliticalSubunitOfRoutingName?: string;commodityRoutingCountryCode?: | "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";commodityRoutingTypeCode?: "13" | "49" | "198";}[] | Routing path of the commodity to the U.S. At least one row with type=198 required per APH_GLOBAL_060. Additional rows for type=49 (transit) or 13 (transshipment). |
consolidatorEntity? | EntityReference | CR — Consolidator. Optional. |
containers? | {containerLength?: number;containerNumber?: string;containerType?: "1" | "2";}[] | Container information. Each entry produces one container slot in a PG27 record (3 per record). Per APHIS 12-24.pdf p.181: required when product is shipped via container. |
correctionIndicator? | "A" | "D" | "R" | Correction indicator for filing corrections to previously submitted APHIS PGA data. A = Add, D = Delete, R = Replace. Per APHIS 12-24.pdf, PG01: position 79, Conditional (C). Only set on correction filings. |
cropGrowerEntity? | EntityReference | DFI — Crop Grower. Required when categoryType = AP0800 (Cut Flowers). |
customsBrokerEntity? | EntityReference | CB — Customs Broker. At least one of CB or IM required. PG19+PG20+PG21. |
disclaimer? | "A" | "B" | Disclaimer code. APHIS allows A, B, D only — code "C" forbidden per APH_GLOBAL_003. When set, only OI and PG01 are submitted (per APHIS 12-24.pdf p.103). Per APHIS 12-24.pdf, PG01: position 80, Conditional (C). |
electronicImageSubmittedFlag? | boolean | Whether an electronic image has been submitted via DIS (Document Image System). Per APHIS 12-24.pdf, PG01: position 17, Conditional (C). |
govAgencyProcessingCode? | "A01" | "A02" | "A03" | "A04" | "A05" | Government Agency Processing Code indicating the specific APHIS processing site. A01 = CBP Agriculture, A02 = APHIS Plant Inspection Station, A03 = APHIS Pre-Clearance, A04 = APHIS VS Port Veterinarian, A05 = APHIS VS Animal Import Center. Per APHIS 12-24.pdf, PG01: positions 14-16, Optional (O). Allowed values are filtered by govAgencyProgramCode at the dropdown level. |
govAgencyProgramCode? | "AAC" | "APQ" | "AVS" | "ABS" | Government Agency Program Code identifying which APHIS program applies. AAC = Animal Care, APQ = Plant Protection and Quarantine, AVS = Veterinary Services, ABS = Biotechnology Regulatory Services. Per APHIS 12-24.pdf, PG01: positions 11-13, Mandatory (M). |
growerDistributorEntity? | EntityReference | GD — Producer/Grower Distributor. Optional; warning-level under APH_APQ_028. |
importerEntity? | EntityReference | IM — Importer. At least one of CB or IM required. PG19+PG20+PG21. |
intendedUseCode? | string | Intended Use Code from Appendix R / Appendix PGA. Free-text input; finite enumerated list lives in Appendix PGA Intended Use Codes. Per APHIS 12-24.pdf, PG01: positions 42-57, up to 16 chars, Mandatory (M) per APH_GLOBAL_002. Wire format: base+sub code without period (e.g. "010001" for 010.001). |
intendedUseDescription? | string | Free-form description expanding on the intended use code. Required when intendedUseCode is "For Other Use" (980.000). Per APHIS 12-24.pdf, PG01: positions 58-78, up to 21 chars, Conditional (C). |
items? | AphisCoreItem[] | - |
labTestReportAccessKey? | string | PG60 CP3 — Lab test report access key. Encoder emits as PG60 CP3 against PG19 LAP. |
labTestReportNumber? | string | PG60 CP1 — Lab test report number. Free-form. Encoder emits as PG60 CP1 against PG19 LAP. |
labTestReportUrl? | string | PG60 CP2 — Lab test report URL. Encoder emits as PG60 CP2 against PG19 LAP. |
lpcoAuthorizedPartyEntity? | EntityReference | LAP — LPCO Authorized Party. Required when ≥1 LPCO present per APH_APQ_013. |
lpcos? | {lpcoDate?: Date;lpcoIssuerCountry?: | "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";lpcoIssuerRegion?: string;lpcoNumberOrName?: string;lpcoQuantity?: number;lpcoType?: | "A10" | "A11" | "A12" | "A13" | "A14" | "A15" | "A16" | "A20" | "A21" | "A30" | "A31" | "A32" | "AE1" | "A01" | "A02" | "A03" | "A05" | "A6A" | "A6B" | "A07" | "A09" | "A17" | "A18" | "A19" | "A22" | "A23" | "A24" | "A25" | "A26" | "A27" | "A28" | "A29" | "A33" | "A34" | "A35" | "A36" | "A37";lpcoUnitOfMeasure?: "L" | "G" | "KG" | "ML" | "NO";}[] | License/Permit/Certificate/Other (LPCO) documents. Each entry produces a paired PG13 + PG14. Per APH_APQ_011 / APH_AVS_020 / APH_AAC_015 / ABS analog: at least one LPCO Type matching the chosen (program, categoryType) is mandatory — enforced by LPCO_PROGRAM_MANDATES. ENCODER-INFERRED FIELDS (not on this shape): - lpcoType drives PG14 lpcoDateQualifier per APHIS 12-24 p.142 (LPCO_TYPE_TO_DATE_QUALIFIER). - PG13 lpcoIssuerGovernmentGeographicCodeQualifier is hardcoded "ISO" (APHIS 12-24 p.271). - PG14 lpcoTransactionType is hardcoded "1" (Single Use) — APH_GLOBAL_014 mandates this for AAC and every example filing in the spec uses it. |
manufacturerEntity? | EntityReference | MF — Manufacturer. Optional; warning-level under APH_APQ_028 for some category combinations. |
offshoreGreenhouseEntity? | EntityReference | AG1 — Offshore Greenhouse. For OGCP-certified facilities (AP0400 + categoryCode 404). |
packaging? | {quantity?: number;unitOfMeasure?: | "CT" | "FL" | "M" | "BH" | "L" | "G" | "CS" | "DR" | "BG" | "CG" | "CX" | "KG" | "MG" | "ML" | "NO" | "M2" | "M3" | "AMU" | "BL" | "BQT" | "BX" | "PKG" | "PO" | "PTU" | "SAD" | "SLF" | "STM" | "TWR" | "T";}[] | Packaging quantities at each level. Up to 3 rows per APH_GLOBAL_068. Per APH_GLOBAL_072: at least one row must use grams (G) or kilograms (KG). Per APH_GLOBAL_073: no duplicate UOMs across rows. packagingQualifier (1..3) is encoder-inferred from row index — not user input. |
packerEntity? | EntityReference | PCK — Packer. Optional; warning-level under APH_APQ_028. |
permittedDestinationEntity? | EntityReference | APD — Permitted Destination. Required when categoryCode begins with "307" per APH_AVS_021. |
producerEntity? | EntityReference | PRO — Producer. Optional; warning-level under APH_APQ_028. |
remarks? | {embassyRelatedToImporter?: boolean;embassyRelatedToImporterText?: string;pestEstablishment?: "A53" | "A54";pestEstablishmentText?: string;} | Optional remarks. The encoder emits one PG24 record per populated slot (pestEstablishment, embassyRelatedToImporter), each with a hardcoded remarksTypeCode = "GEN" — the only APHIS-applicable type code per Appendix PGA p.294. Free-form text is optional for every code (A53/A54 are self-describing pest establishment assertions; NEM is a flag). |
remarks.embassyRelatedToImporter? | boolean | When true, encoder emits a PG24 with Remarks Code = NEM ("Embassy related to the Importer"). |
remarks.embassyRelatedToImporterText? | string | Free-form remarks text accompanying the NEM record. Up to 68 chars (PG24 pos 13-80). |
remarks.pestEstablishment? | "A53" | "A54" | A53 = Pests are established in the U.S.; A54 = Pests are not established. Mutually exclusive. |
remarks.pestEstablishmentText? | string | Free-form remarks text accompanying the pest establishment code. Up to 68 chars (PG24 pos 13-80). |
researcherEntity? | EntityReference | RCH — Researcher / Re-handler. Optional. |
shipperEntity? | EntityReference | DEQ — Shipper. Optional, allowed in any APHIS filing. |
slaughterEstablishmentEntity? | EntityReference | SLA — Slaughter Establishment. Optional; relevant for AP0200/AP0300 (animal products). |
ultimateConsigneeEntity? | EntityReference | UC — Ultimate Consignee. Mandatory always. PG19+PG20 only. |