ACE Shipment CSV Upload Feature (ACE Manifest): Difference between revisions

No edit summary
No edit summary
 
(24 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{note|This article is part of the [[ACE_Manifest_Software_User_Guide_(CBP)|BorderConnect ACE Manifest Guide]]|info}}
{{note|This article is part of the [[ACE_Manifest_Software_User_Guide_(CBP)|BorderConnect ACE Manifest Guide]] and the [[BorderConnect_Software_User_Guide|BorderConnect Software User Guide]]|info}}


{{#ev:youtube|bWwYYqaVZ0k|960|center|How to import shipments into an ACE eManifest.}}
{{#ev:youtube|bWwYYqaVZ0k|960|center|How to import shipments into an ACE eManifest.}}


This guide provides '''instructions on how to upload a large volume of shipments into an ACE Manifest''', using BorderConnect's CSV upload feature in an [https://www.borderconnect.com/ace-e-manifest/index.htm ACE Manifest]. The CSV upload feature is designed for users who have a significant amount of shipments on a single trip and would like to avoid entering data separately for each shipment. A common use case in ACE is used for Section 321 shipments.
[[File:Company-pref.jpg|thumb|360px|right|Selecting Company Settings from the Account menu]]This guide provides '''instructions on how to upload a large volume of shipments into an ACE Manifest''', using BorderConnect's CSV upload feature in an [https://www.borderconnect.com/ace-e-manifest/index.htm ACE Manifest]. The CSV upload feature is designed for users who have a significant amount of shipments on a single trip and would like to avoid entering data separately for each shipment.
 
== Enabling Import Buttons ==
== Enabling Import Buttons ==


The first step is to enable the ability to upload shipments. By default, companies will have this option disabled. To enable this option, once logged into BorderConnect, navigate to the top right corner and hover over the menu option '''Account''', and select '''Company Settings'''.  
The first step is to enable the ability to upload shipments. By default, companies will have this option disabled. To enable this option, once logged into BorderConnect, navigate to the top right corner and hover over the menu option '''Account''', and select '''Company Settings'''.  
[[File:Company-pref.jpg]]


Within the '''Company Settings''' page navigate down to '''Display ACE Import Buttons''' under the section '''eManifest Preferences'''. Once the option is selected to 'Yes', click 'Save' on the top left and your company has now enabled the ability to upload shipments.
Within the '''Company Settings''' page navigate down to '''Display ACE Import Buttons''' under the section '''eManifest Preferences'''. Once the option is selected to 'Yes', click 'Save' on the top left and your company has now enabled the ability to upload shipments.
[[File:Display-ace-import.png|800px]]


== CSV File Format ==
== CSV File Format ==


Before uploading your .csv file, you will need to download the .csv template file that [https://www.borderconnect.com/dist/ace-shipment-csv-template.csv BorderConnect provides here]. The headers in this file must remain intact and un-modified as they are required for the upload to be successful.
[[File:Display-ace-import.png|360px|thumb|right|Enabling ACE import buttons from Company Settings]]Before uploading your .csv file, you will need to download the .csv template file that [https://www.borderconnect.com/dist/ace-shipment-csv-template.csv BorderConnect provides here]. The headers in this file must remain intact and un-modified as they are required for the upload to be successful.


When saving your file, you will need to make sure that it is saved in CSV format, even if you are using a spreadsheet program to edit the file. Only CSV file format can be used for this feature.
When saving your file, you will need to make sure that it is saved in CSV format, even if you are using a spreadsheet program to edit the file. Only CSV file format can be used for this feature.
Line 38: Line 33:
*Only the coded values listed in the table below can be used in this field.
*Only the coded values listed in the table below can be used in this field.


Below are the valid Shipment Type values. E.g. for a Section 321 shipment, the value SECTION_321 must be entered.<br>
Below are the valid Shipment Type values.<br>
(Please note that the shipment type values are '''case sensitive''', and the upload will fail if it is not entered ''exactly'' as specified below.)
(Please note that the shipment type values are '''case sensitive''', and the upload will fail if it is not entered ''exactly'' as specified below.)


Line 48: Line 43:
| PAPS
| PAPS
| PAPS
| PAPS
|-
| Section 321
| SECTION_321
|-
| Section 321 with FDA Considerations
| SECTION_321_FDA
|-
|-
| QP In-Bond
| QP In-Bond
Line 144: Line 133:
*The value of the commodity, in U.S. Dollars.
*The value of the commodity, in U.S. Dollars.
*'''Numeric only''', with one decimal allowed. Must not include dollar sign, commas, etc.
*'''Numeric only''', with one decimal allowed. Must not include dollar sign, commas, etc.
*Only required when Shipment Type is Section 321 or Section 321 with FDA Considerations
*For Section 321 or Section 321 with FDA Considerations, the maximum value is 800.
*System will round to nearest whole number, or up to 1 if less than 1 before transmitting to customs.
*System will round to nearest whole number, or up to 1 if less than 1 before transmitting to customs.


Line 299: Line 286:
<u>Country of Origin</u>:
<u>Country of Origin</u>:
*The country in which the commodity was manufactured, grown or otherwise produced.
*The country in which the commodity was manufactured, grown or otherwise produced.
*Only required when Shipment Type is Section 321 or Section 321 with FDA Considerations.
*Must use the 2 letter country code for the country, in upper case letters.
*Must use the 2 letter country code for the country, in upper case letters.
*The full list of acceptable country codes can be [https://www.borderconnect.com/data/countries.json downloaded here].
*The full list of acceptable country codes can be [https://www.borderconnect.com/data/countries.json downloaded here].
Line 305: Line 291:
== Importing Shipments ==
== Importing Shipments ==


Once you have the CSV file populated with data in the correct format and your company has enabled the ACE shipment import buttons, you can then import the shipments.<br><br>
Once you have the CSV file populated with data in the correct format and your company has enabled the ACE shipment import buttons, you can then import the shipments.
 
To import the CSV file you must first start a new ACE Manifest or edit an existing ACE Manifest. Then, click the button "Choose File" to navigate locally and select the .csv file you would like to upload. Once the file is selected, click 'Save' on the top left. You will be brought to the ACE Manifest details page where a notice will let you know if the upload was successful, and/or if any errors in the import were found.


To import the CSV file you must first start a new ACE Manifest or edit an existing ACE Manifest. Then, click the button "Choose File" to navigate locally and select the .csv file you would like to upload. Once the file is selected, click 'Save' on the top left. You will be brought to the ACE Manifest details page where a notice will let you know if the upload was successful, and/or if any errors in the import were found.<br><br>
Next to the import button you will see that this button is for JSON files, but CSV files will also be accepted.
Next to the import button you will see that this button is for JSON files, but CSV files will also be accepted.


[[File:Ace-upload-shipments.png|800px]]


[[File:Ace-upload-shipments.png|800px]]
== Importing 10,000 Or More Shipments To a Single ACE Manifest ==
 
{{#ev:youtube|LfbA8W-R9S0|360|right|Importing 10,000 or more shipments into an ACE Manifest}}By default users can only upload 9999 shipments into a single ACE Manifest, which is enough for most users who wish to import shipments into an ACE for example. However, in some cases more shipments will need to be added to a single ACE Manifest.
 
Importing 10,000 or more shipments into a single ACE Manifest involves creating multiple ACE Manifests and importing no more than 9999 shipments into each separate ACE Manifest, then moving the imported shipments from the second (or third) ACE manifest, back to the original manifest using the Link Shipments to Trip feature.
 
'''How to Import More than 10,000 Shipments to a Single ACE'''
 
*1. Create your first ACE eManifest, so in the drop down menu select ACE eManifests and select Start New ACE Manifest, and after you enter all your trip details, at the bottom you have the option to upload shipments directly into your ACE Manifest in either a JSON or CSV file format. Now click and locate or drag the file into the manifest. Then on the top left, hover over Save and then select Save and View Trip Details. If you’re adding a significant amount of shipments it may take some time to process the shipment upload so it’s important to be patient during this process. Once this process is complete, you’ll be brought to the ACE Manifest Details page where you can see that your shipments have been successfully imported into the ACE Manifest.
 
*2. Create a new ACE Manifest, so at the top under ACE eManifest select Start New ACE Manifest. For this second trip number you can use the same trip number as previously, only this time adding a B to the end. Next on the top right, ''Show All Fields'' will need to be enabled, which will reveal the field '''Link Shipments to Trip'''. So click into Link Shipments to Trip and assign the original trip that you created initially. This will link all of this trips shipments to that manifest.
 
[[File:Link-shipments-to-trip-field.png|800px]]
 
*3. Next enter the remainder of the trip details, and then at the bottom click and locate or drag the second JSON or CSV file that contains the additional shipments into this manifest. Then go to the top left and hover over Save and select Save and View Trip Details. And just like the first large batch of imports, you will need to be patient as these shipments are imported into BorderConnect. Once the import is complete you will be brought to the ACE Manifest Details page.
 
If you had even more shipments to add to the original manifest, just repeat the process for the second manifest that we created, and create your third ACE manifest while adding “C” to the end of the trip number and import the additional shipments on that manifest.
 
*4. Next Send the first ACE Manifest to CBP, so under ACE Manifests click Search ACE Manifests and then click into or view the original ACE that was created from the ACE Manifest listing page. Once in the ACE Manifest Details page, hover over Send to CBP at the top and click Send Complete Manifest which will move the status to two yellow bars, transmitted. And because this manifest contains a significant amount of shipments, it will take much longer than usual to get processed by CBP and accepted, in some cases up to 20 minutes. But once it does get accepted, it will turn to three blue bars.
 
*5. After the first ACE is on file with CBP you will have to send the second manifest that was created, so again, under ACE eManifests click Search ACE Manifests and View the second ACE Manifest that was created. Once in it, hover over Send to CBP and click ''Link Shipments to Trip'' which will transmit your manifest to CBP linking these shipments to the original manifest at the same time. And after some time it will get accepted and move to three blue bars. Now all the shipments have been successfully accepted and linked to the original first manifest that we created.
 
[[File:Send-link-shipments-to-trip.jpg|300px]]


== Common Import Errors ==
== Common Import Errors ==


Listed below are some of the common errors users receive when trying to upload their .csv file into BorderConnect.<br><br>
Listed below are some of the common errors users receive when trying to upload their .csv file into BorderConnect.


'''Shipment Control Number Errors'''
'''Shipment Control Number Errors'''
Line 459: Line 469:


[[Category:ACE Manifest Guide]]
[[Category:ACE Manifest Guide]]
[[Category:BorderConnect Software User Guide]]