ACE Shipment CSV Upload Feature (ACE Manifest): Difference between revisions
Tag: Undo |
No edit summary Β |
||
| (4 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]] and the [[BorderConnect_Software_User_Guide|BorderConnect Software User 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}} | ||
<div class="bc-wrap"> | |||
<div class="bc-article-hero"> | |||
<h1>ACE Shipment CSV Upload Feature</h1> | |||
<p>A comprehensive guide to bulk importing shipments into ACE eManifests using CSV files.</p> | |||
<div class="bc-article-meta"> | |||
<span class="bc-article-pill"><i class="fas fa-file-csv"></i> Type: Data Import Tool</span> | |||
<span class="bc-article-pill"><i class="fas fa-cubes"></i> Feature: Bulk Shipment Creation</span> | |||
</div> | |||
</div> | |||
<div class="bc-card"> | |||
<div class="bc-float-video" style="margin-top: 0;"> | |||
Β <div class="bc-video-trigger" data-video-id="bWwYYqaVZ0k"> | |||
Β Β <div class="bc-play-icon"><i class="fas fa-play-circle"></i></div> | |||
Β </div> | |||
</div> | |||
<h2 style="margin-top: 0;">Overview</h2> | |||
<p>The <strong>ACE Shipment CSV Upload Feature</strong> allows carriers to import large volumes of shipments directly into a specific ACE eManifest using a standardized CSV template. This is ideal for trips with hundreds of shipments, such as courier loads or consolidated freight.</p> | |||
<p>BorderConnect also offers the <strong>[[Import_Wizard_(ACE_and_ACI_eManifest)|File Import Wizard]]</strong>, a broader tool for importing permanent company data (drivers, trucks, profiles).</p> | |||
<div class="bc-did-you-know" style="margin-top: 15px;"> | |||
<strong>Which Tool Should I Use?</strong><br> | |||
* <strong>CSV Upload (This Guide):</strong> Best for quick, trip-specific bulk shipment uploads directly into one manifest.<br> | |||
* <strong>Import Wizard:</strong> Best for importing standing data like driver profiles, truck lists, or maintaining customer databases. | |||
</div> | |||
<div style="clear: both;"></div> | |||
</div> | |||
# | <h2 style="margin-top: 40px; border-bottom: 2px solid #eee; padding-bottom: 10px;">Step 1: Enable Import Buttons</h2> | ||
<div class="bc-card"> | |||
<p>By default, the import controls may be hidden. To enable them:</p> | |||
<div class="bc-cleanlist"> | |||
1. Go to <strong>Account</strong> > <strong>Company Settings</strong>. | |||
2. Scroll to the <strong>eManifest Preferences</strong> section. | |||
3. Set <strong>Display ACE Import Buttons</strong> to <strong>Yes</strong>. | |||
4. Click <strong>Save</strong>. | |||
</div> | |||
[[File:Company-pref.jpg|thumb|center|Enabling Import Buttons in Company Settings]] | |||
</div> | |||
= | <h2 style="margin-top: 40px; border-bottom: 2px solid #eee; padding-bottom: 10px;">Step 2: Download the Template</h2> | ||
<div class="bc-card"> | |||
<p>You must use the official template to ensure your data maps correctly.</p> | |||
<div class="bc-cleanlist"> | |||
* <strong>Download:</strong> [https://www.borderconnect.com/dist/ace-shipment-csv-template.csv ACE Shipment CSV Template] | |||
* <strong>Format Rule:</strong> Do not rename, remove, or reorder the column headers. Always save as <strong>.csv</strong> (Comma Separated Values). | |||
</div> | |||
</div> | |||
<h2 style="margin-top: 40px; border-bottom: 2px solid #eee; padding-bottom: 10px;">Step 3: Prepare Your Data</h2> | |||
<div class="bc-card"> | |||
<h3>Shipment Control Number (SCN)</h3> | |||
<div class="bc-cleanlist"> | |||
* <strong>Format:</strong> Must be 8-16 alphanumeric characters. No spaces or special characters. | |||
* <strong>Autofill:</strong> To let BorderConnect generate numbers, use your SCAC followed immediately by "AUTOFILL" (e.g., <code>ABCDAUTOFILL</code>). | |||
* <strong>Rule:</strong> Do not mix manual SCNs and AUTOFILL in the same file. | |||
</div> | |||
<h3>Shipment Type</h3> | |||
<p>Values must match exactly (case-sensitive):</p> | |||
<table class="wikitable" style="width: 100%;"> | |||
<tr><th>Type</th><th>Value</th></tr> | |||
<tr><td>PAPS</td><td><code>PAPS</code></td></tr> | |||
<tr><td>Section 321</td><td><code>SECTION 321</code></td></tr> | |||
<tr><td>Intangibles</td><td><code>INTANGIBLES</code></td></tr> | |||
<tr><td>Free of Duty</td><td><code>ATTACHED_CF7523</code></td></tr> | |||
</table> | |||
= | <h3>Commodity Data</h3> | ||
<div class="bc-cleanlist"> | |||
* <strong>Description:</strong> Plain language description of goods (max 45 chars). | |||
* <strong>Value:</strong> Numeric only. No dollar signs (e.g., <code>1500.50</code>). | |||
* <strong>Weight:</strong> Whole numbers only (round up). | |||
</div> | |||
</div> | |||
<h2 style="margin-top: 40px; border-bottom: 2px solid #eee; padding-bottom: 10px;">Step 4: Importing into BorderConnect</h2> | |||
<div class="bc-card"> | |||
<p>Once your file is ready, follow these specific steps to upload it into the system.</p> | |||
= | <h3>1. Create or Open the Manifest</h3> | ||
<div class="bc-cleanlist"> | |||
* Navigate to <strong>ACE eManifest</strong> > <strong>Start New ACE eManifest</strong>. | |||
* Enter the required Trip details (Trip Number, Port of Entry, Estimated Arrival). | |||
* Click <strong>Save</strong>. You must save the trip header before you can add shipments. | |||
</div> | |||
<h3>2. Locate the Import Tool</h3> | |||
<div class="bc-cleanlist"> | |||
* On the <strong>ACE eManifest Details</strong> page, scroll down to the <strong>Shipments</strong> section. | |||
* Look for the button labeled <strong>Import Shipments via CSV</strong> (sometimes labeled <strong>Upload Shipments</strong>). | |||
* <em>Note: If you do not see this button, ensure you completed Step 1 to enable import buttons in Company Settings.</em> | |||
</div> | |||
[[File:Ace-upload-shipments.png|thumb|center|800px|The Import Shipments interface in BorderConnect]] | |||
= | <h3>3. Upload and Process</h3> | ||
<div class="bc-cleanlist"> | |||
* Click <strong>Choose File</strong> and select your prepared <code>.csv</code> file from your computer. | |||
* Click <strong>Save</strong> or <strong>Import</strong>. | |||
* The system will process the file immediately. | |||
</div> | |||
<h3>4. Verify Results</h3> | |||
<div class="bc-cleanlist"> | |||
* <strong>Success:</strong> You will see a green confirmation message, and your shipments will appear in the list below. | |||
* <strong>Failure:</strong> A red error box will appear at the top of the page. It will list the specific row numbers and the exact error (e.g., "Row 4: Invalid SCAC"). Correct these errors in your CSV file and try uploading again. | |||
</div> | |||
</div> | |||
<h2 style="margin-top: 40px; border-bottom: 2px solid #eee; padding-bottom: 10px;">Reference Codes</h2> | |||
==== | <div class="bc-card"> | ||
<h3><i class="fas fa-balance-scale"></i> Weight Unit Codes</h3> | |||
<p>Only the following codes are accepted for the <strong>Weight Unit</strong> column:</p> | |||
<table class="wikitable" style="width: 100%;"> | |||
<tr> | |||
<th style="width: 30%;">Unit</th> | |||
<th>Accepted Codes</th> | |||
</tr> | |||
<tr> | |||
<td><strong>Kilograms</strong></td> | |||
<td><code>K</code>, <code>KG</code>, <code>KGM</code></td> | |||
</tr> | |||
<tr> | |||
<td><strong>Pounds</strong></td> | |||
<td><code>L</code>, <code>LB</code>, <code>LBS</code>, <code>LBR</code></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="bc-card" style="margin-top: 20px;"> | |||
<h3><i class="fas fa-box"></i> Package Type Codes</h3> | |||
<p>The <strong>Quantity Unit</strong> column must use one of the specific 3-letter codes below. (Case-sensitive).</p> | |||
<div class="bc-2col"> | |||
<div style="flex: 1; min-width: 250px;"> | |||
<table class="wikitable" style="font-size: 0.9em; width: 100%; margin-top: 0;"> | |||
<tr><th>Description</th><th>Code</th></tr> | |||
<tr><td>Bag</td><td>BAG</td></tr> | |||
<tr><td>Bale</td><td>BLE</td></tr> | |||
<tr><td>Barrel</td><td>BBL</td></tr> | |||
<tr><td>Basket</td><td>BSK</td></tr> | |||
<tr><td>Bin</td><td>BIN</td></tr> | |||
<tr><td>Box</td><td>BOX</td></tr> | |||
<tr><td>Bucket</td><td>BKT</td></tr> | |||
<tr><td>Bundle</td><td>BDL</td></tr> | |||
<tr><td>Can</td><td>CAN</td></tr> | |||
<tr><td>Carboy</td><td>CBY</td></tr> | |||
<tr><td>Carton</td><td>CTN</td></tr> | |||
<tr><td>Case</td><td>CAS</td></tr> | |||
<tr><td>Chest</td><td>CHS</td></tr> | |||
<tr><td>Coil</td><td>COL</td></tr> | |||
<tr><td>Crate</td><td>CRT</td></tr> | |||
<tr><td>Cylinder</td><td>CYL</td></tr> | |||
<tr><td>Drum</td><td>DRM</td></tr> | |||
</table> | |||
</div> | |||
<div style="flex: 1; min-width: 250px;"> | |||
<table class="wikitable" style="font-size: 0.9em; width: 100%; margin-top: 0;"> | |||
<tr><th>Description</th><th>Code</th></tr> | |||
<tr><td>Envelope</td><td>ENV</td></tr> | |||
<tr><td>Keg</td><td>KEG</td></tr> | |||
<tr><td>Lift Van</td><td>LVN</td></tr> | |||
<tr><td>Liquid Bulk</td><td>LBK</td></tr> | |||
<tr><td>Logs</td><td>LOG</td></tr> | |||
<tr><td>Package</td><td>PKG</td></tr> | |||
<tr><td>Pail</td><td>PAL</td></tr> | |||
<tr><td>Pallet</td><td>PLT</td></tr> | |||
<tr><td>Pieces</td><td>PCS</td></tr> | |||
<tr><td>Reel</td><td>REL</td></tr> | |||
<tr><td>Roll</td><td>ROL</td></tr> | |||
<tr><td>Sack</td><td>SAK</td></tr> | |||
<tr><td>Sheet</td><td>SHT</td></tr> | |||
<tr><td>Skid</td><td>SKD</td></tr> | |||
<tr><td>Tank</td><td>TNK</td></tr> | |||
<tr><td>Tote Bin</td><td>TBN</td></tr> | |||
<tr><td>Tube</td><td>TBE</td></tr> | |||
</table> | |||
</div> | |||
</div> | |||
</div> | |||
<div class="bc-card" style="margin-top: 20px;"> | |||
<h3><i class="fas fa-globe"></i> Common Country of Origin Codes</h3> | |||
<p>Use the 2-letter ISO code for the <strong>Country of Origin</strong> column. Common codes include:</p> | |||
<table class="wikitable" style="width: 100%;"> | |||
<tr><th>Country</th><th>Code</th><th>Country</th><th>Code</th></tr> | |||
<tr><td>Canada</td><td><code>CA</code></td><td>United States</td><td><code>US</code></td></tr> | |||
<tr><td>Mexico</td><td><code>MX</code></td><td>China</td><td><code>CN</code></td></tr> | |||
<tr><td>Germany</td><td><code>DE</code></td><td>Japan</td><td><code>JP</code></td></tr> | |||
<tr><td>United Kingdom</td><td><code>GB</code></td><td>France</td><td><code>FR</code></td></tr> | |||
<tr><td>India</td><td><code>IN</code></td><td>Italy</td><td><code>IT</code></td></tr> | |||
<tr><td>South Korea</td><td><code>KR</code></td><td>Taiwan</td><td><code>TW</code></td></tr> | |||
</table> | |||
<p style="font-size: 0.9em;"><em>Note: For a complete list of all world country codes, refer to the <a href="https://www.borderconnect.com/data/countries.json" target="_blank">BorderConnect Data JSON</a>.</em></p> | |||
</div> | |||
<h2 style="margin-top: 40px; border-bottom: 2px solid #eee; padding-bottom: 10px;">Importing 10,000+ Shipments</h2> | |||
<div class="bc-card"> | |||
<p>For manifests exceeding 9,999 shipments, use the <strong>Link Shipments to Trip</strong> feature.</p> | |||
=== | <div class="bc-2col"> | ||
<div> | |||
<h3>Workflow</h3> | |||
<div class="bc-cleanlist"> | |||
1. <strong>Master Manifest:</strong> Create the first manifest and import the first ~5,000 shipments. | |||
2. <strong>Linked Manifests:</strong> Create additional manifests (e.g., Trip 123B, 123C). | |||
3. <strong>Link Field:</strong> In the new manifests, set <strong>Link Shipments to Trip</strong> to the original Trip Number (123). | |||
4. <strong>Transmit:</strong> Send the master manifest first. Then, send the linked manifests using "Link Shipments to Trip" transmission. | |||
</div> | |||
</div> | |||
<div style="text-align: center;"> | |||
[[File:Link-shipments-to-trip-field.png|thumb|center|800px|Linking Shipments to a Master Trip]] | |||
</div> | |||
</div> | |||
</div> | |||
<h2 style="margin-top: 40px; border-bottom: 2px solid #eee; padding-bottom: 10px;">Common Import Errors</h2> | |||
<div class="bc-card"> | |||
<h3>Troubleshooting Guide</h3> | |||
<table class="wikitable" style="width: 100%;"> | |||
<tr> | |||
<th style="width: 30%;">Error Message</th> | |||
<th>Solution</th> | |||
</tr> | |||
<tr> | |||
<td><code>SCAC Code [AAA] is invalid.</code></td> | |||
<td>SCAC must be exactly 4 characters.</td> | |||
</tr> | |||
<tr> | |||
<td><code>Shipment Type [SECTION321] is invalid</code></td> | |||
<td>Check spacing. It must be <code>SECTION 321</code> with a space.</td> | |||
</tr> | |||
<tr> | |||
<td><code>Unknown packaging unit [box]</code></td> | |||
<td>Package codes are case-sensitive. Use uppercase <code>BOX</code>.</td> | |||
</tr> | |||
<tr> | |||
<td><code>Consignee State [California] is invalid</code></td> | |||
<td>Use 2-letter codes (e.g., <code>CA</code>) for states and provinces.</td> | |||
</tr> | |||
</table> | |||
</div> | |||
{{AppPromo}} | |||
== References == | |||
<references /> | |||
</div> | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
</ | |||
Β | |||
[[Category:ACE Manifest Guide]] | [[Category:ACE Manifest Guide]] | ||
[[Category:BorderConnect Software User Guide]] | [[Category:BorderConnect Software User Guide]] | ||