Before You Start: Important Warnings
Read these warnings carefully before importing any price file. Mistakes made during a manual import can cause data loss that Blackpurl Support cannot reverse, and corrections may be billable to your dealership.
Do not import a file without pricing data. If your file is missing Cost, Retail Price, or MSRP columns, those values will be set to zero on every matching part record in Blackpurl — and Blackpurl will be unable to restore the previous values.
Do not import a file just to load part numbers and descriptions. A file without pricing data will zero out all cost and price fields on existing part records.
Watch for leading zeros in part numbers. If you open a CSV file in Excel the wrong way, Excel may strip leading zeros from part numbers. For example, part number 0012563 becomes 12563. If you import a file with stripped part numbers, those parts will be created or updated under the wrong number.
One price file per vendor. Do not combine parts from multiple vendors into a single import file.
If you are unsure, contact Blackpurl Support before importing. If an import causes a data issue that requires a fix from Blackpurl Support, that fix may be a billable expense to your dealership.
Prerequisites
Complete all of the following before starting the import.
1. The vendor must already exist in Blackpurl. To create a new vendor, see Add and Edit Vendors in Blackpurl.
2. The price file must be in CSV format (.csv — comma-separated values).
3. The price file must include, at a minimum, these columns:
Part Number
Description
Cost
Retail Price
MSRP (this can be the same column as Retail Price)
4. The price file data must be clean before importing:
Remove any columns that are not required
Delete any random words or characters that are not part of the data
Remove dollar signs, currency indicators, and commas from all money columns (Cost, Retail, MSRP) — the import tool will return an error if these are present
How to Import a Vendor Price File
Step 1: Open the Price File Import Tool
In the Blackpurl header, click Tools, then select Price File Import.
This opens the Parts > Price Files section. Click Manual Import to begin.
Step 2: Select the Vendor
Click in the Search for a vendor field and start typing the vendor's name. When the vendor appears in the search results, click to select it.
Step 3: Add the Price File
Once the vendor is selected, the Add your Price File section opens. Drag and drop your CSV file into the upload area, or click Browse to locate and select the file.
Step 4: Review Import Settings
After the file is uploaded, review the Import Settings screen and confirm the following before continuing.
1. Confirm the correct vendor is listed. You can cancel at any time.
2. Confirm the correct price file is shown.
3. If the wrong file was uploaded, remove it and re-upload the correct one.
4. Check whether the field labels (column headers) appear at Record 1 in the preview section. Field labels are the column headers from your CSV file — for example, Part No., Description, Cost, Retail.
5. Review the data preview to confirm the file contents look correct.
Once you have reviewed the settings, click Next to continue to Field Mapping.
Step 5: Map the Fields
Field Mapping tells Blackpurl which column in your price file corresponds to each field in the system. Work through each field and select the matching column from your price file.
For example, if your price file has columns labelled Part No., Description, Cost, and Retail, the mapping would be:
Part Number field in Blackpurl = Part No. column (Column A) from the price file
Description field in Blackpurl = Description column (Column B) from the price file
Item Cost field in Blackpurl = Cost column (Column C) from the price file
Retail field in Blackpurl = Retail column (Column D) from the price file
MSRP field in Blackpurl = if your file has no separate MSRP column, you can map this to the same Retail column (Column D)
If there is no matching column for a particular field, select None for that field.
Packaged Quantity
If your price file includes a Packaged Qty column, map the Package Qty field to that column. Additional checkboxes will appear asking whether the cost and retail price shown in your file are per item (rather than per pack), and whether you want to override any existing packaged part settings already saved on part records in Blackpurl.
For example, if Part #XYZ has a Cost of $10 and a Retail Price of $15 and comes in a pack of 10, you need to confirm: are those prices for the full pack of 10, or per individual item? If Part #XYZ already exists in Blackpurl as a non-packaged part, do you want to override that setting? If you are unsure how to answer these questions, contact the vendor who supplied the price file.
Superseded Parts
If your price file includes a supersession column, the mapping depends on what that column contains:
If the column shows the new part number that is replacing the current part, map the Replaced by Part# field to that column.
If the column shows the old part number that the current part is replacing, map the Replaces Part# field to that column.
Step 6: Review the Field Mapping Preview and Submit
Once all fields are mapped, review the preview screen to confirm the mappings are correct. When you are satisfied, click Submit to proceed.
Step 7: Confirm the Import
Blackpurl will display a confirmation dialog asking you to confirm that you want to process the price file import. Review the details, then click Confirm Processing to begin the import.
Step 8: Wait for the Import to Complete
Blackpurl imports the price file according to the field mappings you provided and displays the progress of the import on screen.
Step 9: Review the Results
When the import finishes, Blackpurl displays a completion screen confirming that the price file import is complete and showing a summary of the results — including how many records were processed.
Additional Information
Tiered Markup for MSRP and Retail
If you want to calculate MSRP and/or Retail Price using tiered markup rather than importing a fixed price from the file, select Calculated Value instead of a column when mapping the MSRP or Retail field. A new section opens at the bottom of the Field Mapping screen where you can enter the markup tiers and any other required information.
Getting Help
Contact Blackpurl Support in any of the following situations:
You have trouble uploading the price file — email the file, the vendor details, and a description of the issue to Blackpurl Support.
Your price file requires different parts to be assigned to different categories. In this case, your data file should include a Category column that is filled in for each part. Contact Blackpurl Support with the file and vendor details.
You are unsure about any step in the import process before you begin — it is always better to ask first. Data corrections after a failed import may be a billable expense.
















