Black Belt Flat Rate Import Notes

When you import your Black Belt Contracting Flat Rate Book, three files are needed. The files need to be identical in format to the files that were exported.

Note that the name of each file needs to be identical to the three files listed below.

  1. Books.txt: Contains basic book info such as title, markups, labels, sales tax, etc.
  2. Tasks.txt: Includes all information about your flat rate tasks.
  3. Items.txt: Includes a list of items used and not used by the tasks with all fields.
These variable length export files include fields that are delimited using a pipe |. The Pipe is what separates the fields. The first row of each file contains a header. These files contain enough information that a technical person should be able to import their flat rate books into another software program. Before these files can be imported, they will likely need to be opened in MS Excel and manipulated or prepared in some way. For example, you may need to add chart of account ID fields or other information that is required by the software program you are importing into.

Important Note About Technical Support Limitations

Our technical support department can help you export these files and make certain that the formatting of these files meets the specifications that we intended. We cannot help you modify these files and we cannot help you import these files into another software program. Once your files are imported, we cannot help you troubleshoot errors, incorrect data, or missing information. Again, we will make certain that the export files were properly created and meet the specifications outlined in this document.

Important Note About Licensing

Importing the data is a Premium Level feature. Once you are no longer a Premium Level member, you are not authorized to use the CSV import. In other words, when you give up Premium Membership, you give up your right to use data that was exported when you were a Premium Member.

File Header Info Needed for Import

The following is a list of headers that need to be in each file. All Items with an * are not editable through the Import Process.

 

File Name: Books.txt

FieldIdRequired?Length and TypeDescription
BookId *YesNumberA number internally assigned to the book by the Application.
BookNameYesAlphanumeric (50)The name you give the book.
DescriptionNoAlphanumeric (250)The description you give the book. This value is optional.
LaborTaxRateNoDecimal(11,8)The sales tax rate for labor.
InvTaxRateNoDecimal(11,8)The sales tax rate for parts. This value is optional.
SavingsLabelNoAlphanumeric (Max)The description you give for the service agreement discount savings. This value is optional.
PrimaryMultiplierYesNumberThe multiplier which determines the "regular" price for the task. Only one is required.
SecondaryMultiplierNoNumberThe multiplier which determines the "second" price for the task. This could be overtime. This value is optional.
Other Multipliers *NoNumberMultipliers are repeated. Multipliers are used to create price levels (like a price column). This value is optional.

File Name: Tasks.txt

FieldIdRequired?Length and TypeDescription
BookId *YesNumberA number internally assigned to the book by the Application.
TaskId *YesNumberThe internal number the system assigns to the task.
NumberNoAlphanumeric (55)The number you assigned to the task.
DescriptionNoAlphanumeric (100)The description you gave the task. This value is optional.
InternalMemoNoAlphanumeric (Max)This is the Internal Memo section of the task. Used to inform technician about something.
PriceLockedNoTrue or FalseYou can lock a price against bulk updates. It will be True or False.
IsTaxExemptNoTrue or FalseYou can exempt a task from sales tax. It will be True or False.
PriceNoDecimal (19,5)The price you have established for the task. This will repeat for each price level.
Category *NoAlphanumeric (50)The category the task has been assigned to. This value is optional.

File Name: Items.txt

FieldIdRequired?Length and TypeDescription
TaskId *NoNumberThe task the item has been assigned to. It does not have to be assigned to any book.
ItemId *YesNumberThe ID number of the item assigned by the system.
NumberYesAlphanumeric (55)The item number given to the part. It is a part number.
NameNoAlphanumeric (100)This is the main description of the item.
DescriptionNoAlphanumeric (1500)The description you gave the part. This value is optional.
UniversalProductCodeNoAlphanumeric (Max)The UPC number. This value is optional.
IsTaxExemptNoTrue or FalseYou can exempt an item from sales tax. It will be True or False.
DirectCostNoDecimal (19,5)The price you pay for the item.
PriceNoDecimal (19,5)The retail price of the item (each).
QuantityNoNumberThe number of items used by the task.
TotalPriceNoDecimal (19,5)The total retail price of the items.
Manufacturer *NoAlphanumeric (50)The manufacturer assigned to this item. This value is optional.
Category *NoAlphanumeric (50)The category the item has been assigned to. This value is optional.
Vendor *NoAlphanumeric (50)The vendor the item has been assigned to. This value is optional.
ItemType *NoAlphanumeric (50)The system assigns this value. It is either "Labor" or "Inventory"

Notes and Tips

  1. The best way to understand what each field is used for is to compare it to your flat rate book. The file field names are the same as the names of the fields used in the software. It will also make sense when you open the files and look at the information.
  2. Images are not exported.