Skip to main content

Import a Vendor Price File into Blackpurl

Manually import a vendor's CSV price file into Blackpurl, including field mapping, packaged quantity, and supersession handling.

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

Excel spreadsheet showing a price file with Part No., Description, Cost, and Retail columns. Contains sample data for mo
Excel spreadsheet showing a second row of price file data with part numbers 512673-512675 for items like Fibreglass Thin


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.

Top navigation bar showing main menu items: Sell, Your Home, Sales, Parts, Service, Ordering, Admin, Reporting, and Tool


This opens the Parts > Price Files section. Click Manual Import to begin.

Dropdown menu from Tools showing options including BRP Lookup, BRP PO Status, Cash Reconciliation, Customer Merge, Fusio


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.

Parts workspace header showing tabs for Summary, Sales, Quotes, Special Order (597), Inventory (1297), Kits, To Pull, Pa


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.

Import Settings screen with progress tabs showing Back, Import Settings (active), Field Mapping, and Results. Left secti


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.

Import Settings screen after vendor selection showing 'Select a vendor' section with 'Buy Parts from Here Now' selected,
Import Settings screen with vendor and file selected. Shows numbered annotations: 1. Buy Parts From Here (vendor), 2. pr


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.

Excel spreadsheet showing data rows with part numbers like JKJ0001BKPKJK and corresponding product details like LADIES S
Field Mapping screen with progress tabs (Import Settings, Field Mapping active, Results). Left side shows 'Field mapping


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.

Lower portion of Field Mapping screen showing additional mapping fields (ENVIRO FEE, ITEM COST, MFG PART #, SKU #, PACKA


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.

Field Mapping screen showing completed mappings. Left side shows fields mapped (ENVIRO FEE: None, ITEM COST: COST, MFG P


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.

Confirmation dialog titled 'Process the Price File Import' with warning text about confirming the decision and that the


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.

Processing screen showing 'Processing... please wait' and 'Results: 0 records were processed'.


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.

Completion screen showing 'All done! Your price file import is complete.' with results: '157 records were processed' and


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.

Field Mapping screen showing MSRP and RETAIL fields both mapped to 'Calculated Value' (highlighted in red box). Shows dr


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.

Did this answer your question?