User Tools

Site Tools


do_it_best_setup

Do It Best Integration

Preliminary System Five Setup

Extract the DoItBest.zip file to a DoItBest folder in the System5\Bin folder.

ThisDoItBest folder will contain all the stylesheets needed for the integration to function correctly.

At this point you will need to create the Do It Best supplier account before doing anything else.

Make a note of the unique number of the supplier account as it will need to be entered into the “orderconfirmation.xsl” file.

The six digit DIBMember number is specified from Do-It-Best. You can find this inside the first row of the “ORDCNFM_010” file.

To find this number, refer to the first line of the ORDCNFM_010 file from DoItBest. Count in 11 digits. This is the first digit of the 6 digit DIBMember number. Make a note of digits 11 through 16. In the example this is 06777D. You will also notice that the DIBMember number exists within the first number of each line of the ORDCNFM_01 file .

When you edit the xsl file; the <DIBMember> is the Do It Best Member number or account number from Do It Best. The <SupplierID> is the supplier unique number from System Five.

example

 <config:settings>
    <DIBMember>06777D</DIBMember>
    <SupplierID>2556</SupplierID>
 </config:settings>

Next you will need to set up the following categories as per Do-It Best's category structure.

Categories as of December 2014 are:

Main Cat# Description

  • 000 Not Currently Assigned
  • 010 Best Rewards Coupon Items
  • 100 LUMBER/BUILDING MATERIAL
  • 160 MILLWORK
  • 200 BUILDERS HARDWARE
  • 260 BUILDING SPECIALTIES
  • 300 TOOLS
  • 400 PLUMBING AND HEATING
  • 500 ELECTRICAL SUPPLIES
  • 570 AUTOMOTIVE
  • 600 HOUSEWARES
  • 650 GIFTS/PORTABLE APPLIANCE
  • 700 FARM/LAWN/GARDEN
  • 770 PAINT AND SUNDRIES
  • 800 OUTDOOR LIVING
  • 900 TOYS AND WHEEL GOODS
  • 970 STATIONARY/ARTS/CRAFTS
  • 990 STORE SUPPLIES

* You must create these categories, and if you have already assigned these inventory categories to something else, you will need to change those categories so that they use numbers that are not being used by the Do It Best Integration. *

Next you will need to download your import files from Do It Best.

  • You will need their assistance to access their Secure FTP.
  • They will set up an account for you for their FTP, and assist you with what software you will need to access the secure FTP.
  • Windward Software can only assist you with the integration with Do It Best. We are not able to assist you with their software, or their FTP.
  • The files you will need from Do It Best are: FILEMNT_010, ORDCNFM_010, POSLOAD_010, and PRCCHGS_010.
  • Do It Best will supply you with the documents outlining what each of these files are.
  • They will also supply you with an FTP Communication Guide for details on setting up your FTP client software.

Doing Initial Inventory Data Load

open System Five and from the navigator:

Access Inventory and Purchases > Data Load > Part Load The current inventory update file is always in FILEMNT_010. POSLOAD_010 contains all inventory items and is intended only for system initialization and startup.

The instructions in the System Five help file are incomplete. So ignore them and follow the instructions below:

To load all inventory you need to use the POSLOAD_010 file from Do-It-Best

To load it you will use the dataload in System Five.

  • First you need to select the predefined settings from the DoItBest folder you already extracted to the System5\bin folder.
  • For the full part load it will be POSLOAD_010.XML
  • Then click on the FROM FILE button and select the POSLOAD_010 file
  • Click Next
  • This will take a few moments to load. When the dataload screen finishes loading, click next

The options screen should load with the following options:

  • Load into regular parts
  • Skip header row
  • and Update duplicate part numbers by (Supplier + Part Number)
  • Select [Next] to view/set column options, and then set or verify the Barcode Transformation path. The setbarcode.xsl style sheet is required to convert barcode numbers to the correct length.
  • Set or verify that the Category Transformation path is correct, The depttocat.xsl style sheet is required to format the category to three characters.
  • Set or verify the Cost Price Transformation path. The setcost.xsl style sheet is required for Cost Price.
  • Set or verify the List Price Transformation path. The setprice.xsl style sheet is required for List Price.
  • Set or verify that the Marked For Deletion Transformation path is correct. The markdeleted.xsl style sheet is required for marking deleted items.
  • Click next

The time required to process will depend on the number of items being updated.

  • Click the Load Button
  • Click Yes to continue the dataload

The time required to process will depend on the number of items being updated.

The data load will load all the parts into categories defined by the dataload, but it will not give the categories any names.

So the integration assumes that the end user has already setup the main and sub categories, and has created them in compliance with Do-It Best's category structure mentioned at the beginning of this document.

Doing Inventory Update Data Load

Access Inventory and Purchases > Data Load > Part Load

The current inventory update file is always in FILEMNT_010.

To update the existing inventory you need to use the FILEMNT_010 file from Do-It-Best

Again… The instructions in the help file are incomplete. So ignore them and follow the instructions below:

To load it you will use the dataload in System Five.

  • First you need to select the predefined settings from the DoItBest folder you already extracted to the System5\bin folder.
  • For the Inventory Update part load it will be FILEMNT_010.XML
  • Then click on the FROM FILE button and select the FILEMNT_010 file you downloaded from Do It Best's FTP
  • Click Next
  • This will take a few moments to load. When the dataload screen finishes loading, click next

The options screen should load with the following options:

  • Load into regular parts
  • Skip header row
  • and Update duplicate part numbers by (Supplier + Part Number)

Select [Next] to view/set column options.

  • Set or verify the Barcode Transformation path. The setbarcode.xsl style sheet is required to convert barcode numbers to the correct length.
  • Set or verify that the Category Transformation path is correct, The depttocat.xsl style sheet is required to format the category to three characters.
  • Set or verify the Cost Price Transformation path. The setcost.xsl style sheet is required for Cost Price.
  • Set or verify the List Price Transformation path. The setprice.xsl style sheet is required for List Price.
  • Set or verify that the Marked For Deletion Transformation path is correct. The markdeleted.xsl style sheet is required for marking deleted items.
  • Click next

The time required to process will depend on the number of items being updated.

  • Click the Load Button
  • Click Yes to continue the dataload

The time required to process will depend on the number of items being updated.

Setting Up The Purchase Order Confirmation

The first thing you need to do to set up the Purchase Order Confirmation will be to open System Five and determine the unique number of the Do It Best supplier account.

Go To setup Tools - Utilities - XML Central

Do-It-Best Order Confirmation Import

If You have not already done so, you need to extract the DoItBest.zip file to a DoItBest folder in the System5\Bin folder.

To setup System Five for importing Do-It-Best order confirmation files, select Import From XML in the XML Central window.

From the Import XML window, click on the [New] button.

In the Message window, enter a name for the settings entry, as shown.

In the Import XML window, set the Import File Type, to the prime character, “`”, located on the same key as the Tilde, “~” character, as shown below. Set Import From to Import From File. In the options to the right, check Import PO Lines. In the XSL Filter set the path to the orderconfirmation.xsl file, and also check the Prompt for filename option before selecting [Exit].

To add the new setting to the Quick List, right click on Quick List in the menu, select Customize Lists click the [Add Import/Export] button, select the entry created as shown, click the [OK] button and then the [Save Changes] button. The setup is now complete.

To import a file, click on the New Import option, then navigate to the file and double click. The file will always be ORDCNFM_010 unless it has been renamed after it was downloaded.

The newly imported purchases orders can viewed by selecting recent in the List Purchase Orders window.


Created by Steve Wind Dec 22 2014 updated April 8 2015

do_it_best_setup.txt · Last modified: 2021/05/11 21:42 (3 years ago) by plagrada