USA Node – 03-01 Air Shipment JSON Specifications

ACE Air Submission #

JSON Fields Default Description M/C/O
tnx_id

			
Transaction Id Internal use only, leave it blank
C
sub_tnx_id

			
Sub Transaction Id Internal use only, leave it blank
C
submission_status

			
Submission Status Internal use only, leave it blank
C
acct_id

			
Account Id acctid provided by NA application
M
user_id

			
User Id userId provided by NA application
M
message_id

			
Message identifier unique message Id for each file
M
submission_type

			
Submission Type "ACEAIR" or "ACAS"
M
importer_no

			
The type of number being used to identify the importer of record. For Type 86 submission this data element may or may not be required depending on the PGA involve for the HTS code provided. Applicable to Cargo Release only Valid formats for the Importer of Record Number are:
- NN-NNNNNNNXX (IRS) Number 
- YYDDPP-NNNNN CBP Assigned Number 
- NNN-NN-NNNN Social Security Number
C
1.2 Manifest Header Details

			
Max 500 times.

			
message_type

			
Message identifier ACE AIR Data values:
FRI = Add
FRC= Modify/Change
FRX = Delete
ACAS Data Values: PRI, PRC, PRX
PRI = Add
PRC= Modify/Change
PRX = Delete
M
airport_of_arrival

			
Arriving port. US Airports represented in IATA directory list The IATA code of the first airport of arrival in the United States
M
cargo_terminal_operator

			
US Bonded warehouse FIRMS#
M
importing_carrier

			
The International Civil Aviation Organization (ICAO) approved 3-letter airline designator issued by the transport authority of the country of registry or 2 character International Air Transport Association (IATA) airline designator (providing it does not end with numeric value) are supported Air carrier code. Valid codes can be located in the IATA Coding Directory.
M
flight_number

			
Number assigned by the importing carrier. Format must be NNN, NNNA, NNNN or NNNNA.
M
amended_flight_number

			
Amended Flight Number Number assigned by the importing carrier. Format must be NNN, NNNA, NNNN or NNNNA. In case of amendment
C
scheduled_date_of_arrival

			
Scheduled Arrival Date Format: (dd/mm/yyyy)
M
amended_scheduled_date_of_arrival

			
Amended Scheduled Arrival Date For example December 10 is 10DEC, In case of amendment
C
part_arrival_reference

			
Part reference of the waybill in the current flight. a single air waybill arrives on more than one aircraft and actual boarded piece count is less than total waybill piece count
C
boarded_piece_count

			
no of pieces onboarded in current flight This value must be greater than zero and less than the total piece count of the air waybill.
C
amended_boarded_piece_count

			
no of pieces onboarded in current flight In case of amendment
C
boarded_weight

			
Weight of the boarded pieces. Weight of the boarded pieces.
C
boarded_weight_uom

			
Weight Code of boarded pieces K (Kilos) or L (Pounds)
C
amended_boarded_weight

			
Amended Weight of the boarded pieces. In case of amendment.
C
amended_boarded_weight_uom

			
Amended Weight Code of boarded pieces K (Kilos) or L (Pounds) . In case of amendment.
C
agent_ams_code

			
Air AMS Participant Code An air carrier code (2-3AN), FIRMS code (4AN) or entry filer’s ACE Air identifier (7AN). (FRI, FRC message only). For Air Carrier/Airline filing only
C
lift_off_date

			
Liftoff Date Actual departure date in NNAAA format at last foreign airport. For FDM only. For Air Carrier/Airline filing only
C
lift_off_time

			
Liftoff Time Actual departure time (GMT) in HHMM (hour, minute) format. For FDM only. For Air Carrier/Airline filing only
C
actual_importing_carrier

			
Actual Importing Carrier The carrier code of the actual airline that is carrying the freightFor FDM only. For Air Carrier/Airline filing only
C
actual_flight_number

			
Actual Flight Number For FDM only
C
status_action_code

			
Valid status codes are further detailed in Appendix A in the G.O. Status Codes section. Not in use. please remove
C
status_request_code

			
FSQ msg, status request code 01, 02, 03, 04, 05, 06
M
amendment_reason

			
Amendment Code RFA seg: required for FRC, FRX , FXC or FXX.Valid: 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21
C
amendment_explanation

			
Amendment Explanation RFA seg: required for FRC, FRX, FXC or FXX
C
1.3 waybill

			
Max occurance 1
 
awb_prefix

			
Standard air carrier prefix. The International Air Transport Association (IATA) may issue air waybill prefixes
M
awb_number

			
8-digit number composed of a 7-digit serial number and the MOD-7 check-digit number.
M
consolidation_flag

			
“M” is used to identify a master air waybill. For Air Carrier/Airline filing only
C
hawb_number

			
a unique house air waybill number
C
package_tracking

			
Package Tracking Identifier An optional alphanumeric field to identify a house air waybill.
O
box_number

			
Box Number
O
airport_of_origin

			
Departing port represented in IATA directory list Airport codes are available from the IATA Airline Coding Directory.
M
permit_to_transfer_airport

			
Permit to Proceed Destination Airport The U.S. airport code of destination when an air waybill is transported by the air carrier under the provisions of a permit to proceed.
C
date_of_arrival_ptp

			
Date of Arrival at the Permit to Proceed Destination Airport For example December 10 would be 10DEC.
C
entry_type

			
Entry Type For ACE Air the entry Type is only optional
O
entry_number

			
Entry Number Seg CED: For FXI, FXC Only. required when the entry type is “11”, “86”, or “92” and must be omitted when cancelling previously transmitted CED data. For ACE Air the entry Type is only optional
O
origin_of_goods

			
Country of origin of goods The ISO country code corresponding to the country of origin of the merchandise.
M
declared_value

			
Monetary value of goods Cannot be 0 value
M
iso_currency_code

			
ISO Currency Code The value of the merchandise in U.S. dollars (USD) is required for in-bond and express consignment shipments. Defaulted in USD
M
harmonized_tariff

			
Harmonized Commodity Code The classification of the merchandise according to the Harmonized Tariff Schedule of the United States (HTSUS). Optional only for ACE Air Submission
O
fda_indicator

			
Must be used on all air waybills that are subject to FDA freight requirements Default value: "FDA".
M
1.3.1 Party Info (Shipper and Consignee)

			
multi occurance max 2 times

			
party_type

			
Shipper Party Type Must be "SHP"
M
party_name

			
Party Name Name of the shipper.
M
street_address

			
Street address Street address of the shipper.
M
city

			
City The city, county or township of the shipper.
M
postal_code

			
Postal Code The postal code of shipper.
O
state_code

			
State or Province The state or province code of the shipper.
O
country

			
Country Code Use a valid International Standards Organization (ISO) country code.
M
telephone_number

			
Telephone Number Hyphens may be used.
O
party_type

			
Consignee Party Type Must be "CNE".
M
party_name

			
Party Name Name of the consignee.
M
street_address

			
Street address Street address of the consignee.
M
city

			
City The city, county or township of the consignee.
M
postal_code

			
Postal Code The postal code of the consignee.
O
state_code

			
State or Province The state or province code of the consignee.
O
country

			
Country Code Use a valid ISO country code.
M
telephone_number

			
Telephone Number Hyphens may be used.
O
1.3.2 Cargo Info

			
Max occurancce 1

			
cargo_description

			
Cargo Description  No special character except space
M
piece_count

			
Total number of pieces If consolidation, report the cumulative house-level piece count.
M
weight

			
Total weight If included, a decimal must be followed by a number.
M
weight_uom

			
Weigh Code K (Kilos) or L (Pounds)
M
1.3.2.1 inbond_cargo_info_response

			
Max occurancce 1

			
destination_airport

			
Destination Airport The 3-character IATA U.S. airport code of destination or “000” (numeric zeroes) to cancel previously authorized transfer information.
C
domestic_international_identifier

			
Domestic/ International Identifier Enter “I” (International), “D” (Domestic), “R”(FROB)
C
bonded_carrier_id

			
Bonded Carrier ID Formats accepted:
NN-NNNNNNNAA or NN-NNNNNNNNN (importer/IRS#); 
NNN-NN-NNNN (SSN); 
NNNNNN-NNNNN (CBP assigned). 
Hyphens required.
C
onward_carrier

			
Onward Carrier The air carrier code of the bonded onward carrier.
C
bonded_premises_identifier

			
Bonded Premises Identifier When transferring freight to the terminal facility of another airline, the air carrier code may be used. When transferring freight to a bonded deconsolidator, a FIRMS code must be used.
C
inbond_control_number

			
In-bond Control Number The 9-digit in-bond control number
C
T86 #
JSON Fields Default Description M/C/O
tnx_id
Transaction Id Internal use only, leave it blank
C
sub_tnx_id
Sub Transaction Id Internal use only, leave it blank
C
submission_status
Submission Status Internal use only, leave it blank
C
acct_id
acctid provided by NA application acctid provided by NA application
M
user_id
userId provided by NA application userId provided by NA application
M
message_id
unique message Id for each file unique message Id for each file
M
submission_type
Submission Type Defaulted to T86 only
C
5.1 a GeTS Header
M
control_id
Control Id "A" Internal use only
M
sender_receiver_site_code
Sender Receiver Site Code "0901" Internal use only
M
sender_receiver_id_code
Sender Receiver Id Code "SY2" Internal use only
M
communication_password
Communication Password "SECFIL" Internal use only
M
transmission_date
Transmission Date Internal use only
O
application_id_code
Application Id Code "SE" Internal use only
M
sender_receiver_office_code
Sender Receiver Office Code Internal use only
O
transmitter_user_data_text
Transmitter User Data Text Internal use only
O
5.2 b Customer Header
M
control_id
Control Id "B" Internal use only
M
processing_district_port_code
A code agreed upon by the Filer and CBP representing a specific Filer ‘port office’  Internal use only, leave it blank
M
filer_code
A unique code assigned by CBP to all active entry document preparers. The Entry Filer Code occupies the first three positions of an entry number regardless of where the entry is filed. Internal use only, leave it blank
M
application_id_code
Application Id Code Internal use only, leave it blank
O
processing_filer_office_code
A code agreed upon by the Filer and CBP representing a specific Filer ‘office’ (or sub-location). Internal use only, leave it blank
C
remote_prepare_district_port_code
A code agreed upon by the Filer and CBP representing a specific Filer ‘port office’  Internal use only, leave it blank
M
remote_preparer_filer_code
A unique code assigned by CBP to all active entry document preparers. The Entry Filer Code occupies the first three positions of an entry number that indicates the registered remote filer code Internal use only, leave it blank
M
remote_preparer_office_code
Remote Filer’s (Preparer) identification code (as assigned by CBP).  Internal use only, leave it blank
C
remotely_filed_indicator
An indication that the block has been prepared and filed remotely in accordance with the Broker District permit rules as set forth in CBP regulation.  If Remote filer then inidcate: 1 = Remote Entry Submission
C
filer_preparer_user_data_text
Internal use only, leave it blank
O
5.3 cargo_release_header
Max occurance 1
M
control_id
Control Identifier "SE10"
M
update_action_code
Update Action Code
A -Add
D-Cancel
R-Replace
U-Update
M
entry_filer_code
A unique code assigned by CBP to all active entry document preparers
M
entry_number
Entry Number If empty field then system will auto generate
M
entry_type
Entry Type "86"
M
importer_record_type
Importer of Record Type The type of number being used to identify the importer of record.
EI-Employer Identification Number (IRS #)
ANI-CBP-assigned Number
34-Social Security Number
C
importer_record
Importer of Record Identification of the importer of record.
C
mot
A code representing the mode of transportation. AIR, NON-CONTAINER AIR, CONTAINERIZED
M
bond_type_code
Bond Type Code A code representing the bond type.
0-No bond required
8-Continuous bond
9-Single transaction bond
C
estimated_entry_value
Estimated Entry Value The total entered value of the entry in whole US dollars.Entry value cannot exceed $800 for type 86 entries
M
planned_entry_port
Planned Port of Entry Planned / scheduled port of entry in Schedule D code.
M
split_shipment_rel_code
Split Shipment Release Code A code representing an option for releasing split shipments.
O
unlading_port
Port of Unlading Planned / scheduled port of unlading in Schedule D code.
C
5.4 additional_header
Max occurance 1
O
control_id
"SE11"
M
entry_date_election_code
Entry Date Election Code A code representing the source of the Elected Entry Date.
C
elected_entry_date
Elected Entry Date Enter a numeric date in MMDDYY (month, day, year) format.
C
elected_entry_date
Elected Entry Date Enter a numeric date in MMDDYY (month, day, year) format.
C
goods_location
Location of Goods (FIRMS) FIRMS code of the location where the cargo is currently stored.
C
elected_exam_site
Elected Exam Site (FIRMS) Filer’s preferred Centralized Examination Station (CES) location.
O
conveyance_name_ftz_zone_id
Conveyance Name or FTZ ID* Name of the Conveyance.
C
voyage_flight_frip_manifest_num
Voyage/Flight/Trip Manifest Number The voyage/flight/trip number of the importing carrier.
C
general_order_num
General Order (G.O.) Number The G.O. Number if the cargo has been placed in General Order.
O
bonded_warehouse
CBP Bonded Warehouse (FIRMS) FIRMS code of the CBP Bonded Warehouse where cargo is to be entered. (Entry Types 21 and 22 only)
C
orig_warehouse_entry_filer_code
Originating Warehouse Entry Filer Code The Originating entry listed must be entry type 21 or 22 only.
C
orig_warehouse_entry_num
Originating Warehouse Entry Number Originating warehouse entry number that the merchandise is coming from. The Originating entry listed must be entry type 21 or 22 only.
C
immediate_delivery_ind
Immediate Delivery Indicator Leave it blanks
C
5.5 correction_cancellation_info
Max occurance 1
M
control_id
Control Identifier "SE13"
M
contact_name
Contact Name Contact Name for the entry filing
M
contact_phone
Contact Phone Phone Number for the entry filing
M
reason_code
Reason Code Reason code for Cancellation request.
C
multiple_cargo_dispositions
Multiple Cargo Dispositions Indicator Use 1 to indicate that multiple cargo dispositions exist in addition to the reason code provided for the entry in the cancellation request.
O
dis_ind
DIS indicator Use 1 to indicate a Document Image System (DIS) submission has been made in support of the correction or cancellation request
O
split_shipment_ind
Split Shipment indicator Use 1 to indicate that the SE is associated with a split shipment
O
5.6 bol_info_group
Max occurance 999
C
5.6.1 bol_info
Max occurance 3
M
control_id
Control Identifier "SE15"
M
bill_type_ind
Bill Type Indicator R = Regular / Simple Bill of Lading;
M = Master Bill of Lading;
H = House Bill of Lading;
T = Express Carrier Tracking Number(air only)
I = In-bond number
M
issuer_code
Issuer Code of Bill of Lading Number A code representing the issuer of the bill of lading for Ocean and Highway only
C
bol_number
Bill of Lading Number The bill of lading number as listed on the manifest;
M
quantity
Quantity Enter the quantity associated with the bill of lading number being reported for Master level only in Type 86 Entry.
C
non_ams_ind
Non-AMS indicator Default value is ‘N’.
M
5.6.2 conveyance_info
Max occurance 99
C
control_id
Control Identifier "SE16"
M
carrier_code
Carrier Code A code identifying the carrier.
M
voyage_flight_frip_manifest_num
Voyage/Flight/Trip Manifest Number The voyage/flight/trip number of the importing carrier.
M
arrival_date
Date of Arrival A numeric date in MMDDYY (month, day, year) format representing the date of arrival.
M
quantity
Quantity The entered quantity associated with the bill of lading number
M
uom
Unit of Measure The unit of measure corresponding to the bill of lading quantity.
C
conveyance_name
Conveyance Name Name of the conveyance.
O
5.6.3 equipment_info
Max occurance 99
O
control_id
Control Identifier "SE17"
C
equipment_num
Equipment Number Equipment unit's full number including: the SCAC prefix, the sequencing or serial part of an equipment unit's identifying number, and the check digit
C
5.7 reference_info_group
Max occurance 99
C
control_id
Control Identifier "SE20"
M
reference_id_qualifier
Reference Identifier Qualifier Code that defines the Reference Identifier. Valid code: CR, EN, IB, FTZ, DIS, V1, AMT, EXP, KII, RRN, PER
M
reference_id
Reference Identifier Reference data.
M
5.8 header_entity_group
Max occurance 8
C
5.8.1 entity_name_type
Max occurance 1
M
control_id
Control Identifier "SE30"
M
code
Entity Code Code identifying the type of commercial entity being reported. Valid code: MF, SE, BY, ST, LG, CS, CN, BKP
M
name
Entity Name The name of the entity identified by the Entity Code.
C
id_qualifier
Entity Identifier Qualifier This field must be used if the entity identifier is being supplied in lieu of name and address. Valid code: EI, AN1, 34
C
entity_id
Entity Identifier The code identified by the entity identifier qualifier.
C
5.8.2 entity_street_address_group
Max occurance 3
C
control_id
Control Identifier "SE35"
M
address_qualifier1
Address Component Qualifier Address Component Qualifier describing the information in the Address Information data element
M
address1
Address Information Address Information corresponding to the Address Component Qualifier data element
M
address_qualifier2
Address Component Qualifier Address Component Qualifier describing the information in the Address Information data element
O
address2
Address Information Address Information corresponding to the Address Component Qualifier
O
5.8.3 entity_city_country
Max occurance 3
C
control_id
Control Identifier "SE36"
M
city_name
City Name The city portion of the address where the entity is located.
M
sub_entity_code
Country Sub Entity Code ISO subdivision code. Space fill if not applicable.
C
postal_code
Postal Code Postal code (i.e. ZIP code in USA). Space fill if no postal code is available.
C
country_code
Country Code The International Standards Organization (ISO) country code representing the country portion of the address
M
5.9 invoice_info
5.9.1 invoice_header
invoice_number
Invoice Number
M
export_date
Export Date
M
5.9.2 line_group
Max occurance 999
C
5.9.2.1 line_item
Max occurance 1
M
control_id
Control Identifier "SE40"
M
line_item_id
Line Item Identifier The line item identifier begins with 001 and is incremented by one each time
M
origin_country
Country of Origin The International Organization for Standardization (ISO) country code representing the country of origin
M
commercial_inv_desc
Commercial Invoice Description A clear description of the commercial invoice line item in English. Broad, generalized language is unacceptable, as are tariff descriptions. Commercial description is not the same as the Harmonized Tariff description.
M
5.9.2.2 ftz_info
Max occurance 1
C
control_id
Control Identifier "SE41"
M
ftz_status
Zone Status Code indicating FTZ status. This field is required for entry type 06 (FTZ) entries
M
filing_date
Privileged FTZ Merchandise Filing Date Space fill if NOT Privileged Foreign.
C
line_item_qty
FTZ Line Item Quantity Enter the quantity in units of this HTS Line (SE40 record) to be removed from the FTZ and entered into the Commerce of the U.S.
M
5.9.2.3 line_entity_group
Max occurance 7: For Type 86, the Conisignee is the only required entity for the line item.
M
5.9.2.3.1 entity_name_type
Max occurance 1
M
control_id
Control Identifier "SE50"
M
code
Entity Code Code identifying the type of commercial entity being reported. Valid code: MF, SE, BY, ST, LG, CS, CN
M
name
Entity Name The name of the entity identified by the Entity Code.
C
id_qualifier
Entity Identifier Qualifier This field must be used if the entity identifier is being supplied in lieu of name and address. Valid code: EI, AN1, 34
O
entity_id
Entity Identifier The code identified by the entity identifier qualifier.
O
5.9.2.3.2 entity_street_address_grouping
M
5.9.2.3.2.1 entity_street_address
Max occurance 3
C
control_id
Control Identifier "SE55"
M
address_qualifier1
Address Component Qualifier Address Component Qualifier describing the information in the Address Information data element
M
address1
Address Information Address Information corresponding to the Address Component Qualifier data element
M
address_qualifier2
Address Component Qualifier Address Component Qualifier describing the information in the Address Information data element
O
address2
Address Information Address Information corresponding to the Address Component Qualifier
O
5.9.2.3.3 city_country
Max occurance 1
C
control_id
Control Identifier "SE56"
M
city_name
City Name The city portion of the address where the entity is located.
M
sub_entity_code
Country Sub Entity Code ISO subdivision code. Space fill if not applicable.
C
postal_code
Postal Code Postal code (i.e. ZIP code in USA). Space fill if no postal code is available.
C
country_code
Country Code The International Standards Organization (ISO) country code representing the country portion of the address
M
5.9.2.4 hts
5.9.2.4.1 hts_info
Max occurance 8
M
5.9.2.4.1.1 hts
Max occurance 1
M
control_id
Control Identifier "SE60"
M
hts_num
HTS Number The appropriate duty/statistical reporting number under which the article is classified in the Harmonized Tariff Schedule of the United States Annotated (HTS).
M
item_value
Line Item Value The line item value in whole US dollars.
C
quantity1
Cargo Piece Quantity for  the HTS
C
5.9.2.4.1.2 additional_ftz_info
Max occurance 1
C
control_id
Control Identifier "SE61"
M
current_hts_num
Current HTS Number for PF Status Merchandise A mandatory data element that is to be used to report the current Harmonized Tariff Schedule number that fully or partially describes/classifies the article. Report the full 10-digit classification number.
M
5.9.2.4.2 pga
Max occurance 999
C
auto_disclaim
Auto Disclaimer indicator If this field is put "Y", system will auto select disclaimer base on hts_num
O
5.9.2.4.2.1 pgaoi
Max 1 time.
M
control_id
Control Identifier "OI"
M
pga_commercial_desc
Commercial Description A clear description of the commercial line item in English.
M
5.9.2.4.2.2 disclaim
M
control_id
Control Identifier "PG"
M
correction_indicator
Correction Indicator Indicator allowing trade to identify the expected action to be taken on the corrected data.
C
disclaimer
Disclaimer A code indicating the reason data is not being provided. Valid codes are:
A = product is not regulated by this agency
B = data is not required per agency guidance
C = data filed through other agency means
D = data filed through paper
E = product does not contain fish or wildlife, including live, dead, parts or products thereof, except as specifically exempted from declaration requirements under 50 CFR Part 14.
C
gov_agency_code
gov_agency_processing_code
Government Agency Processing Code Code indicating an agency’s program for which the PGA data set is related.
M
gov_agency_program_code
Government Agency Program Code Code indicating the specific PGA processing requirements for which the data set is related.
M
intended_use_code
Intended Use Code The code indicating the intended use base code of the product followed by the intended use subcode
C
intended_use_desc
Intended Use Description If “For Other Use” (980.000) code is used, then a free text description of the intended can be provided.
C
pga_line_no
PGA Line Number Number required by PGAs beginning with 001 within a CBP line and sequentially incremented on subsequent PG01 records, if applicable.
M
record_type
Record Type "01"
M
electronic_image_submitted
Electronic Image Submitted If electronic image submitted, enter "Y"
C
confidential_information_indicator
Confidential Information Indicator A code of Y (Yes) indicating information should be treated as confidential, per the agency’s regulations. No other code is accepted.
C
5.9.2.4.2.3 fda_message
M
pga_program
PGA Program 
BIO=Biologics
COS=Cosmetics
DEV=Medical Devices
DRU=Drug
FOO=Food
RAD=Radiation Emitting Products
TOB=Tobacco
VME=Animal Drugs and Devices
M
5.9.2.4.2.3.1 pga_01
M
control_id
Control Identifier "PG"
M
correction_indicator
Correction Indicator Indicator allowing trade to identify the expected action to be taken on the corrected data.
C
disclaimer
Disclaimer A code indicating the reason data is not being provided. Valid codes are:
A = product is not regulated by this agency
B = data is not required per agency guidance
C = data filed through other agency means
D = data filed through paper
E = product does not contain fish or wildlife, including live, dead, parts or products thereof, except as specifically exempted from declaration requirements under 50 CFR Part 14.
C
gov_agency_code
gov_agency_processing_code
Government Agency Processing Code Code indicating an agency’s program for which the PGA data set is related.
M
gov_agency_program_code
Government Agency Program Code Code indicating the specific PGA processing requirements for which the data set is related.
M
intended_use_code
Intended Use Code The code indicating the intended use base code of the product followed by the intended use subcode
C
intended_use_desc
Intended Use Description If “For Other Use” (980.000) code is used, then a free text description of the intended can be provided.
C
pga_line_no
PGA Line Number Number required by PGAs beginning with 001 within a CBP line and sequentially incremented on subsequent PG01 records, if applicable.
M
record_type
Record Type "01"
M
electronic_image_submitted
Electronic Image Submitted If electronic image submitted, enter "Y"
C
confidential_information_indicator
Confidential Information Indicator A code of Y (Yes) indicating information should be treated as confidential, per the agency’s regulations. No other code is accepted.
C
5.9.2.4.2.3.2 pga_02
O
control_id
Control Identifier "PG"
M
item_type
Item Type Identifies whether the information provided is for a product or a component.
P = Product
C = Component
If ONLY reporting data at the product (‘P’) level (and not reporting any component level data), a PG02 with item type ‘P’ is required.
M
product_code_no
Product Code Number Number that characterizes the commercial product or component
C
product_code_qual
Product Code Qualifier A code indicating the type of product number used to characterize the product or component.
C
record_type
Record Type "02"
M
5.9.2.4.2.3.3 pga_04
O
control_id
Control Identifier "PG"
M
constituent_active_ingredient_qual
Constituent Active Ingredient Qualifier Active ingredient = “Y” if yes, blank if no.
O
name_of_the_constituent_element
Name of the Constituent Element The specific name of the ingredient or product/component of an ingredient.
O
percent_of_constituent_element
Percent of Constituent Element The percent of the ingredient in the product/component. Example:
1000000 = 100%
0990000 = 99%
0090000 = 9%
0009000 = .9%
0000900 = .09%
0000090 = .009%
0000009 = .0009%
O
qty_of_constituent_element
Quantity of Constituent Element The specific quantity of the identified element contained in the product/component
O
uom_constituent_element
Unit of Measure (Constituent Element)
CG = Centigrams
CM = Centimeter
CM2 = Square Centimeter
CM3 = Cubic Centimeter
CTL = Centiliter
G = Grams
KG = Kilogram
KL = Kiloliter
L = Liter
M = Meter
M2 = Square Meter
M3 = Cubic Meter
MCG = Micrograms
ML = Mililiter
MM = Millimeters
MM2 = Square Millimeters
MM3 = Cubic Millimeters
O
record_type
Record Type "04"
M
5.9.2.4.2.3.4 pga_05
O
control_id
Control Identifier "PG"
M
scientific_genus_name
Scientific Genus Name Scientific Genus Name of the merchandise being entered.
O
scientific_species_name
Scientific Species Name Scientific Species Name of the merchandise being entered.
O
scientific_sub_species_name
Scientific Sub Species Name Scientific Sub Species Name of the merchandise being entered.
O
record_type
Record Type "05"
M
5.9.2.4.2.3.5 pga_06
O
control_id
Control Identifier "PG"
M
country_code
Country Code Country Code
M
source_type_code
Source Type Code This code identifies what role the country had regarding a product, for example, harvested, grown, produced, processed, sold, or the source.
M
record_type
Record Type "06"
M
5.9.2.4.2.3.6 pga_07
O
control_id
Control Identifier "PG"
M
trade_name_brand_name
Trade Name/Brand Name The make of the product (or component) by manufacturer or distributor from the label or invoice.
O
record_type
Record Type "07"
M
model
Model Code or name of the product (or component).
O
manufacture_month_and_year
Manufacture Month and Year The month and year the product (or component) was manufactured. The format is MMCCYY (month, century, year)
O
item_identity_number_qualifier
Item Identity Number Qualifier The qualifier indicates the type of number that is used to identify the item, e.g., VIN number, serial number, or engine number.
O
item_identity_number
Item Identity Number The unique identity for the item.
O
5.9.2.4.2.3.7 pga_10
C
control_id
Control Identifier "PG"
M
commodity_characteristic_desc
Commodity Characteristic Description Free form description of the item, either to supplement the above data elements or in place of the above.
M
record_type
Record Type "10"
M
commodity_qualifier_code
Commodity Qualifier Code A code indicating the type of essential or distinctive attribute or quality of an item
O
commodity_characteristic_qualifier
Commodity Characteristic Qualifier This code specifies the type of characteristic for the item, for example, qualifier can be for color, gender, or age, etc.
O
5.9.2.4.2.3.8 pga_13
C
5.9.2.4.2.3.8.1 pga_13
C
control_id
Control Identifier "PG"
M
issuer_of_lpco
Issuer of LPCO Identifies the entity that issued the LPCO
O
location_of_issuer_of_the_lpco
Location (Country/State/Province) of Issuer of the LPCO Identifies the location of the issuer of the LPCO (ex: the US, Mexico or Canadian Province/State code or Foreign Country Code).
O
lpco_issuer_gov_geographic_code_qual
LPCO Issuer - Government Geographic Code Qualifier The code relating to the location of the issuer of the LPCO.
Canadian Province = PR
Country Code = ISO
European Union = EU
Mexican State = MS
US State = US
O
regional_desc_of_loc_of_agency_issuing_the_lpco
Regional description of location of Agency Issuing the LPCO Free form regional description of the location within a country, of the agency issuing the LPCO
O
record_type
Record Type "13"
M
5.9.2.4.2.3.8.2 pga_14
C
control_id
Control Identifier "PG"
M
code_type
Code Type For NonPN FOO only. Identifies Type Codes for PN Confirmation Number
O
lpco_no_or_name
LPCO Number (or Name) Identifies the number assigned to the LPCO
O
lpco_transaction_type
LPCO Transaction Type Identifies the transaction type.
1 = single use
2 = continuous
3 = general
O
lpco_type
LPCO Type Identifies the type of license, permit, certificate or other.
O
pnc_no
PNC Number For NonPN FOO only. Identifies the number that corresponds to the PN Confirmation number Prior Notice Confirmation Number is a 12-digit number (12N)
O
transaction_type
Transaction Type  For NonPN FOO only.Identifies the transaction type.
	1 = single use
O
record_type
Record Type "14"
M
5.9.2.4.2.3.9 pga_19
C
5.9.2.4.2.3.9.1 pga_19
C
control_id
Control Identifier "PG"
M
entity_identification_code
Entity Identification Code Identifies the code being used to describe the entity.See Appendix PGA (Entity Identification Code) of this publication for valid codes.Example : "16", "47"
M
entity_name
Entity Name Name of the Entity if no DUNS, FIRMS, or Facility identifications exist.
O
entity_address_1
Entity Address 1 Address Line 1 for the Entity.
O
entity_no
-If entity_identification_code="16", entry no length must is 9
	-If entity_identification_code="47", entry no length cannot more than 10
O
entity_role_code
Entity Role Code Identifies the role of the entity.
IMPORTER=IM
CARRIER=CAR
SHIPPER=DEQ
EPA_PRODUCER_EST_NUM=EPN
LOCATION_OF_GOODS=LG
CUSTOMS_BROKER=CB
CERTIFYING_INDIVIDUAL=CI
NOTIFYING_PARTY=NP
OWNER=DFP
MANUFACTURER=MF
STORAGE_LOCATION=STL
NAIC_BOND_ISSUER=NAI
M
record_type
Record Type "19"
M
5.9.2.4.2.3.9.2 pga_20
O
control_id
Control Identifier "PG"
M
entity_address_2
Entity Address 2 Address Line 2 for the Entity.
O
entity_apartment_no_suite_no
Entity Apartment Number/Suite Number Apartment/Suite number of the entity.
O
entity_city
Entity City City of the entity.
O
entity_country
Entity Country ISO Country Code
O
entity_state_province
Entity State/Province State/Province of the entity.
O
entity_zip_postal_code
Entity Zip/Postal Code Zip/Postal Code of the entity
O
record_type
Record Type "20"
M
5.9.2.4.2.3.9.3 pga_21
O
control_id
Control Identifier "PG"
M
email_address_for_the_individual
Email Address or Fax Number for the Individual Option to either submit the Fax number or Email Address of the individual.
O
individual_name
Individual Name Name of the Individual.
O
individual_qual
Individual Qualifier Identify the type of party or facility the Individual represents.
AAE = Destination Approved Establishment
AAR = All Applicable Roles
AG1 = USDA APHIS Grower - Offshore Greenhouse Certification Program
AP1 = USDA/AMS Applicant
APD = Permitted Destination
APP = Applicant
AQF = Aquaculture Facility
BY = Buyer
CAR = Carrier
CB = Customs broker
CE = Certifying Entity
CI = Certifying Individual l
CN = Consignee
CO = Certifying Official
CR = Consolidator
CW = Equipment owner
CZ = Consignor
DBO = Deboning Establishment
DDF = Primary electronic business contact
DDG = Alternate electronic business contact
DDH = Primary government business contact
DDI = Alternate government business contact
DDO = Location manager
DEI = Means of transport operator
DEQ = Shipper
DFI = Crop grower
DFP = Owner
DII = Device Initial Importer
DP = Delivery party
EMB = Embassy
EPN = EPA Producer Establishment Number
EX = Exporter
EXE = Exporting Establishment
FCI = FDA Clinical Investigator
FD1 = FDA Importer 1
FD2 = FDA Importer 2
FD3 = FDA Importer 3
FDC = FDA Consolidator
FG = Foreign Government
FM = Fabricating Manufacturer
FSV = Foreign Supplier Verification Program
FU = Hazardous material office
FWE = FWS Foreign Exporter
FWI = FWS Importer
GC = Goods custodian
GD = Producer
HAZ = Hazardous Material Contact
IH = I-House
IM = Importer
INC = Inspection Contact
ITL = Independent Third Party Laboratory
LA = Party designated to provide living animal care
LAB = Laboratory
LAP = LPCO Authorized Party
LBR = Labeler
LG = Location of Goods immediately after Entry Release
LIP = LPCO Issuing Agency
LNG = LNG Regasification Terminal
MF = Manufacturer of goods
NAI = NAIC Bond Issuer
NOL = No Lab Testing Required
NP = Notify Party
ORC = Organic Certifying Body of Products
ORG = Certified Organic Producer
ORI = Organic Certifying Body – Import Certificate Issuer
ORP = Certified Organic Packer
OV = Transport means owner
OVM = Original Vehicle Manufacturer
PCK = Packer
PE = Producing Establishment
PES = Packing Establishment
PK = Point of Contact
PNS = PN Submitter
PNT = PN Transmitter
PRE = Preparer
PRO = Processing Establishment
RCH = Ranch/farm
RD = Retailer/Distributor
RGO = Responsible Government Official
SE = Seller
SIG = Signer
SLA = Slaughter Establishment
SLI = Slicing Establishment
SOE = Source Establishment
SPO = Sponsor
STL = Storage location
TB = Submitter
UC = Ultimate consignee
USR = FSIS US Returned Reinspection Establishment Number
VN = Vendor
VW = Responsible party
O
tel_no_of_the_individual
Telephone number of the Individual Telephone number of the Individual
O
record_type
Record Type "21"
M
5.9.2.4.2.3.10 pga_23
C
control_id
Control Identifier "PG"
M
affirm_of_compliance_code
Affirmation of Compliance Code A code used to affirm compliance with FDA requirements.
"IND", "BLN", "STN", "DA", "REG", "HCT", "HRN", "IFE", "DLS", "DEV", "DFE", "LST, "DDM", "KIT", "CPT", "IDE", "RA1", "RA2", "RA3", "RA4", "RA5", "RA6", "RA7", "B1", "RB2", "ACC", "ANC", "RC1", "RC2", "RD1", "RD2", "RD3", "NDC", "VAN", "VNA", "VIN"
C
affirm_of_compliance_desc
Affirmation of Compliance Description Text describing the information required by the PGA.
C
affirm_of_compliance_qual
Not in use. To be verified before remove
C
record_type
Record Type "23"
M
5.9.2.4.2.3.11 pga_24
C
control_id
Control Identifier "PG"
M
remarks_text
remarks_type_code
Remarks Type Code A code indicating the type of remarks.
AM1 = Organic Standard Certified To
AM5 = Additional Requirements
AM7 = Certification
AP5 = Pests Established
EP1 = Vehicles and Engines Bond Exemption
EP2 = EPA Vehicles and Engines Import Code
EP3 = EPA Vehicles and Engines Industry Code
EP4 = EPA Vehicles and Engines Regulation Cited for Other Exemption
EP5 = EPA Notice of Arrival of Pesticides and Devices
GEN = General Remarks
NHE = Additional NHTSA Requirements
O
record_type
Record Type "24"
M
remarks_code
Remarks Code A code indicating the remark
A10 = USDA Organic
A11 = Equivalent Organic
A20 = "Officially Sampled" stamped on cases
A23 = Certificate of date of pack
A25 = Condition of container examination
A03 = Certification statement for use of imported fruit,vegetable, or specialty crops
A53 = Pests are established in the U.S.
A54 = Pests are not established in the U.S.
NEM = Embassy related to the Importer
O
5.9.2.4.2.3.12 pga_25
C
control_id
Control Identifier "PG"
M
actual_temp
Actual Temperature Reported temperature. Two decimals places are implied.
C
degree_type
Degree Type F = Fahrenheit, C = Celsius , K = Kelvin
C
loc_of_temp_recording
Location of Temperature Recording Identifies recorded temperature is for
A = product
B = container
C = conveyance
C
lot_no
Lot Number The lot number that the manufacturer/producer/grower assigned to the product.
C
lot_no_qual
Lot Number Qualifier Code of the entity that assigned the Lot number.
1 = Manufacturer
2 = Seller
3 = Grower
4 = Producer
C
negative_no
Negative Number If the actual temperature is in the negative numbers use an “X”.
C
pga_line_value
PGA Line Value The value associated with the PGA line number in whole dollars.
C
pga_unit_value
PGA Unit Value The value of the lowest unit of measure reported in PG26. Two decimal places are implied.
C
production_start_date_of_the_lot
Production Start date of the Lot The date when the production for the Lot started. A numeric date in MMDDCCYY (month, day, century, year) format.
C
production_end_date_of_the_lot
Production End Date of the Lot The date when the production for the Lot ended. A numeric date in MMDDCCYY (month, day, century, year) format.
C
temp_qual
Temperature Qualifier Temperature Category being reported.
A= Ambient, F=Frozen
R=Refrigerated/Chilled, D=Dry Ice
H=Fresh, U=Uncontrolled
P=Flashpoint
C
record_type
Record Type "25"
M
5.9.2.4.2.3.13 pga_26
C
control_id
Control Identifier "PG"
M
packaging_qual
Packaging Qualifier This code identifies the level of packaging for the product.Outermost (largest=1) packages to the innermost (smallest=6) packages.
M
qty
Quantity The total quantity for the packaging level. Two decimal places are implied.
C
uom_packaging_level
Unit of Measure (Packaging Level) The unit of measure for the packaging level. Valid Units of Measure can be found in Appendix PGA and ACE Appendix B.
C
record_type
Record Type "26"
M
5.9.2.4.2.3.14 pga_27
C
control_id
Control Identifier "PG"
M
container_no_equipment_id1
Container Number (Equipment ID) The number of the shipping container or equipment identification number.
M
container_no_equipment_id2
Container Number (Equipment ID) The number of the shipping container or equipment identification number.
C
container_no_equipment_id3
Container Number (Equipment ID) The number of the shipping container or equipment identification number.
C
record_type
Record Type "27"
M
5.9.2.4.2.3.15 pga_28
C
control_id
Control Identifier "PG"
M
can_dimensions_1
Can Dimensions #1 The first dimension of the can.
C
can_dimensions_2
Can Dimensions #2 The second dimension of the container.
C
can_dimensions_3
Can Dimensions #3 The third dimension.
C
package_tracking_no
Package Tracking Number Code Code indicating the company associated with the tracking number used
C
package_tracking_no_code
Package Tracking Number Tracking numbers used by FedEx, UPS, DHL, etc.
C
record_type
Record Type "28"
M
5.9.2.4.2.3.16 pga_29
C
control_id
Control Identifier "PG"
M
commodity_gross_qty_individual_unit_gross
Commodity Gross Quantity (Individual Unit - gross) Pertaining to the Individual unit, including any packaging, but excluding weight of the carrier's equipment.
C
uom_individual_unit_gross
Unit of Measure (Individual Unit - gross) Valid Units of Measure can be found in Appendix PGA and ACE Appendix B.
C
commodity_gross_qty_pga_line_gross
Commodity Gross Quantity (PGA line - gross) Pertaining to the overall PGA Line Number, including any packaging, but excluding weight of the carrier's equipment. Two decimals are implied.
C
uom_pga_line_gross
Unit of Measure (PGA line - gross) Valid Units of Measure can be found in Appendix PGA and ACE Appendix B.
C
commodity_net_qty_individual_unit_net
Commodity Net Quantity (Individual Unit - net) Pertaining to the Individual unit, excluding all packing and packaging.
C
uom_individual_unit_net
Unit of Measure (Individual Unit - net) Valid Units of Measure can be found in Appendix PGA and ACE Appendix B.
C
commodity_net_qty_pga_line_net
Commodity Net Quantity (PGA line - net) Pertaining to the overall PGA Line Number, excluding all packing and packaging.
C
uom_pga_line_net
Unit of Measure (PGA line - net) Valid Units of Measure can be found in Appendix PGA and ACE Appendix B.
C
record_type
Record Type "29"
M
5.9.2.4.2.3.17 pga_30
C
control_id
Control Identifier "PG"
M
ant_arrival_info
Inspection/Laboratory Testing Status
R = Request for inspection
S = Inspection previously scheduled
P = Inspection previously performed
L = Lab testing previously performed
A = Anticipated arrival information (For FDA Prior Notice or other agency needs)
I = Product location for regulatory authority inspection
F = Indicates product coming from Foreign Trade Zone (For FDA Type 21)
M
ant_arriv_entry_date
Requested or Scheduled Date of Inspection; Date of Previous Inspection/ Laboratory Testing; Arrival date A numeric date in MMDDCCYY (month, day, century, year) format.
C
ant_arriv_entry_time
Requested or Scheduled Time of Inspection; Time of Previous Inspection/Laboratory Testing; Arrival time Military time HHMM in (hour, minute) format. (Example: 1015, this represents 10:15 a.m. 0001 through 2400 are valid.)
C
firms_code
Port of Arrival / Entry specific for PGA only
C
ftz_location
Port of Arrival / Entry specific for PGA only
C
record_type
Record Type "30"
M
5.9.2.4.2.3.18 pga_55
C
control_id
Control Identifier "PG"
M
entity_role_code1
Entity Role Code Additional role of the entity.
C
entity_role_code2
Entity Role Code Additional role of the entity.
C
entity_role_code3
Entity Role Code Additional role of the entity.
C
entity_role_code4
Entity Role Code Additional role of the entity.
C
entity_role_code5
Entity Role Code Additional role of the entity.
C
entity_role_code6
Entity Role Code Additional role of the entity.
C
entity_role_code7
Entity Role Code Additional role of the entity.
C
entity_role_code8
Entity Role Code Additional role of the entity.
C
entity_role_code9
Entity Role Code Additional role of the entity.
C
entity_role_code10
Entity Role Code Additional role of the entity.
C
record_type
Record Type "55"
M
5.9.2.4.2.3.19 pga_60
C
control_id
Control Identifier "PG"
M
additional_info
Additional Information Text of the additional information related to the additional reference qualifier code
M
additional_info_qual_code
Additional information qualifier code Code indicating the type of additional information being provided
M
record_type
Record Type "60"
M
5.9.2.4.2.3.20 pga_00
control_id
Control Identifier "PG"
M
substitution_indicator
Substitution Indicator
S=Start of the substitution group
E=End of the substitution group
M
substitution_no
Substitution Number Sequential number assigned to, or referring to, a specific substitution group of data provided at the header level.
M
record_type
Record Type "00"
M
5.10 y
control_id
"Y" Internal use only, leave it blank
M
processing_district_port_code
Port of Entry Port of Entry Internal use only, leave it blank
M
filler_code
"SY2" Internal use only, leave it blank
M
application_id_code
"SE" Internal use only, leave it blank
M
filler_esar_or_communication_password_eman
Internal use only, leave it blank
O
processing_filer_office_code
Internal use only, leave it blank
O
5.11 z
control_id
"Z" Internal use only, leave it blank
M
sender_receiver_site_code
"0901" Internal use only, leave it blank
M
sender_receiver_id_code
"SY2" Internal use only, leave it blank
M
filler_esar_or_communication_password_eman
Internal use only, leave it blank
O
transmission_date
Internal use only, leave it blank
O
sender_receiver_office_code
Internal use only, leave it blank
O
ACE Air Response #
JSON Fields Default Description M/C/O
Response Date
M
Response Time
M
Master Level
MAWB Number for AIR/ACAS (No response message; response message is indicated on the HBL level) only to identify MAWB number
M
Housebill level
HAWB Number for AIR
HAWB Number for ACAS AIR
Entry Number Identifier - T86 for Air
M
Message Function (Add, Modify, replace (T86 only), Cancel)
M
Message Type
M
Response Code (including STATUS NOTIFICATIONS)
M
Response Description (including STATUS NOTIFICATIONS)
M
Remarks
O
PGA Response Code (including STATUS NOTIFICATIONS)
These 3 items are included if T86 is submitted with PGAs for (T86 Air)
Entry Number – identifier
HTS Code – identifier
PGA - identifier
M
PGA Response Description (including STATUS NOTIFICATIONS)
These 3 items are included if T86 is submitted with PGAs for (T86 Air)
Entry Number – identifier
HTS Code – identifier
PGA - identifier
M
PGA Remarks
These 3 items are included if T86 is submitted with PGAs for (T86 Air)
Entry Number – identifier
HTS Code – identifier
PGA - identifier
O

Houston, we have a problem!

We are currently fixing this spaceship, so you might experience a bumpy flight.