@repo/shared / FWSType
Interface: FWSType
FWS (U.S. Fish and Wildlife Service) PGA data for CBP entry summary filings.
Required for imports of wildlife and wildlife products subject to USFWS jurisdiction, including species protected under CITES, the Endangered Species Act, and the Wild Bird Conservation Act. Certifies applicable permits, exemptions, and species-level documentation.
Properties
| Property | Type | Description |
|---|---|---|
arrivalDate? | Date | Date of arrival into U.S. jurisdiction in MMDDCCYY format. Mandatory when processing code is EDS. Per Fish n Wildlife 07-20.pdf, PG30: positions 6-13. |
cartonsContainingWildlife? | number | Total quantity of cartons containing wildlife associated with the CBP entry. Must be the same per CBP entry. Mandatory when processing code is EDS. Per Fish n Wildlife 07-20.pdf, PG17: positions 66-70, up to 5 digits. |
commodityNetQuantity? | number | The net quantity associated with the FWS line. Two decimal places implied. Mandatory when processing code is EDS. Per Fish n Wildlife 07-20.pdf, PG29: positions 8-19, 12 numeric. |
commonNameGeneral? | string | The general portion of the common name of the animal (e.g., "Bear"). Mandatory when processing code is EDS. Per Fish n Wildlife 07-20.pdf, PG17: positions 35-64, up to 30 chars. |
commonNameSpecific? | string | The specific portion of the common name of the animal (e.g., "Grizzly"). Per Fish n Wildlife 07-20.pdf, PG17: positions 5-34, up to 30 chars. |
customsBrokerEntity? | EntityReference | Customs Broker (role code: CB). Required when a broker is associated with the entry. Requires a PG21 individual contact (name, phone, email). Per Fish n Wildlife 07-20.pdf, PG19/PG20/PG21 records. |
disclaimer? | "D" | "E" | "C" | Disclaimer code declaring that a full FWS PGA Message Set is not being provided. C = will file in eDecs after ACE filing (FW1, FW3). D = cleared via paper with FWS (FW1, FW3). E = product does not contain fish or wildlife per 50 CFR Part 14 (FW1 only). Not allowed for FW2 tariff codes. Per Fish n Wildlife 07-20.pdf, PG01: position 80, Conditional (C). |
electronicImageSubmittedFlag? | boolean | Whether an electronic document image for FWS has been submitted via DIS. Set to true ("Y") when filing EDS and documents were uploaded in DIS. Per Fish n Wildlife 07-20.pdf, PG01: position 17, Optional (O). |
foreignExporterEntity? | EntityReference | Foreign Exporter (role code: FWE). Mandatory for all FWS EDS filings. Requires a PG21 individual contact (name, phone, email). Per Fish n Wildlife 07-20.pdf, PG19/PG20/PG21 records. |
fwsDescriptionCode? | string | FWS Description Code identifying the wildlife commodity type. Codes assigned by FWS per Appendix PGA (e.g., LIV=live, BOD=dead animal, CAV=caviar). Mandatory when processing code is EDS. Per Fish n Wildlife 07-20.pdf, PG05: positions 74-80, up to 7 chars. |
fwsImporterEntity? | EntityReference | FWS Importer of Record (role code: FWI). Mandatory for all FWS EDS filings. Requires a PG21 individual contact (name, phone, email). Per Fish n Wildlife 07-20.pdf, PG19/PG20/PG21 records. |
fwsLPCO? | {lpcoNumber?: string;lpcoType?: "DPE" | "FWF" | "FWU" | "FWC" | "FWL" | "FWP";}[] | Array of LPCO (License, Permit, Certificate, Other) records. There may be more than one LPCO type required per FWS line, but only one LPCO number per LPCO type per FWS line. This record may be repeated. Per Fish n Wildlife 07-20.pdf, PG14 record. |
inspectionLocation? | string | Customs bonded inspection location for the wildlife. Mandatory when processing code is EDS. Per Fish n Wildlife 07-20.pdf, PG30: positions 22-71, up to 50 chars. |
intendedUseCode? | | "010.000" | "020.001" | "035.001" | "100.007" | "100.008" | "110.001" | "110.002" | "110.003" | "130.035" | "180.001" | "180.002" | "180.003" | "210.000" | "220.000" | "230.000" | "250.000" | "920.003" | "920.004" | "920.005" | "920.006" | "920.007" | "980.000" | Intended Use Code for the wildlife shipment. Must be the same per CBP entry. Only allowed when processing code is EDS. Maps to FWS Purpose Codes on Form 3-177. PG14 LPCO Type "FWL" and LPCO Number are mandatory for biomedical, commercial, and traveling exhibition purpose codes. Per Fish n Wildlife 07-20.pdf, PG01: positions 42-57, Conditional (C). |
liveVenomousWildlifeCode? | boolean | Whether the live wildlife specimen is venomous (Y/N). Mandatory when processing code is EDS and FWS Description Code is LIV, LIVA100, or LIVA103. Per Fish n Wildlife 07-20.pdf, PG17: position 65. |
markingLabelingInfo? | string | Package marking/labeling information relevant to the wildlife commodity. Free-form text that must be the same per CBP entry. Per Fish n Wildlife 07-20.pdf, PG24: positions 13-80, up to 68 chars. Optional. |
pgaLineValue? | number | The value associated with the FWS line, rounded to the nearest dollar. Mandatory when processing code is EDS. Per Fish n Wildlife 07-20.pdf, PG25: positions 57-68, 12 numeric. |
processingCode? | "EDS" | "LDS" | Government Agency Processing Code determining the scope of the FWS filing. EDS = Entire Data Set (full FWS Message Set in ACE). LDS = Limited Data Set (data already filed in eDecs; only PG01, PG02, PG14 required). Not entered when a Disclaimer is used. Per Fish n Wildlife 07-20.pdf, PG01: positions 14-16, Conditional (C). |
scientificGenusName? | string | Scientific Genus Name of the animal or animal part/product being entered. Mandatory when processing code is EDS. One per FWS line unless hybrid (then repeated). Per Fish n Wildlife 07-20.pdf, PG05: positions 5-26, up to 22 chars. |
scientificSpeciesName? | string | Scientific Species Name of the animal or animal part/product being entered. Mandatory when processing code is EDS. Per Fish n Wildlife 07-20.pdf, PG05: positions 27-48, up to 22 chars. |
scientificSubSpeciesName? | string | Scientific Sub Species Name of the animal or animal part/product being entered. Per Fish n Wildlife 07-20.pdf, PG05: positions 49-66, up to 18 chars. |
sourceCode? | "D" | "R" | "X" | "F" | "I" | "C" | "W" | "P-2" | "U-6" | Code indicating the FWS source of the animal. Mandatory when processing code is EDS. Per Fish n Wildlife 07-20.pdf, PG10: positions 16-19. |
speciesCountryOfOrigin? | string | Two-letter ISO country code where the specimen was taken from the wild or born. The FWS country of origin may differ from the CBP country of origin. Use "ZZ" for wildlife landed after harvest on the high seas. Mandatory when processing code is EDS. Per Fish n Wildlife 07-20.pdf, PG06: positions 8-9. |
unitOfMeasure? | | "M" | "L" | "G" | "CM" | "KG" | "MG" | "ML" | "NO" | "CM2" | "CM3" | "M2" | "M3" | The FWS unit of measure associated with the FWS line. Mandatory when processing code is EDS. Per Fish n Wildlife 07-20.pdf, PG29: positions 5-7. |