Product Maintenance

17 | Product Import -> Standard Specification

This article covers the Import Specs for Standard Product Import including Field Name descriptions notes, rules, and scenarios.

This article covers the Import Specs for Standard Product Import including Field Name descriptions & notes, rules, and scenarios. Field Definitions & Notes
 

Field Definitions & Notes

 

 

  FieldName Format Description & Notes  Accepted Inputs
A PROD_NAME Alphanumeric Product Name must be unique within a given Product Group
The same name if the 2 products reside in different groups is accepted
limited to 30 characters A-Z; 1-9
B GROUP_NAME Alphanumeric    
C PROD_LONGNAME Alphanumeric   limited to 60 characters A-Z; 1-9
D PRODUCT_ID Numeric Only if file was exported from same database. Do NOT use on import
E PROD_NUMBER Alphanumeric   Numeric Value
F GROUP_ID Numeric    
G GROUP_PLUNUMBER AlphaNumeric    
H GROUPS_PARENTNAME AlphaNumeric    
I EXPORTCODE1 AlphaNumeric    
J ISGROUP Boolean    
K MATCHON_PRODUCTID Boolean Default to Y if ProductID Field not empty Default = True
1=Yes; 2=No
Yes/No
Y/N
True/False
T/F
1/0
L MATCHON_PRODNUM Boolean Default to Y if PRODNUMBER Field not empty Default = True
1=Yes; 2=No
Yes/No
Y/N
True/False
T/F
1/0
M MATCHON_EXPORTCODE1 Boolean Default to Y if ExportCode1 Field not empty Default = True
1=Yes; 2=No
Yes/No
Y/N
True/False
T/F
1/0
N MATCHON_NAME_GROUP Boolean Default to Y if Group Field not empty Default = True
1=Yes; 2=No
Yes/No
Y/N
True/False
T/F
1/0
O MATCHON_SUPP_PLU Boolean Default to Y if Supplier PLU Field not empty Default = True
1=Yes; 2=No
Yes/No
Y/N
True/False
T/F
1/0
P MATCHON_BARCODE Boolean Default to Y if Barcode Fields not empty Default = True
1=Yes; 2=No
Yes/No
Y/N
True/False
T/F
1/0
Q DONOTMATCH_INACTIVE Boolean   Default = True
1=Yes; 2=No
Yes/No
Y/N
True/False
T/F
1/0
R DONOT_ADD_PRODUCTS Boolean Only update existing products Default = True
1=Yes; 2=No
Yes/No
Y/N
True/False
T/F
1/0
S DONOT_UPDATE_PRODUCTS Boolean Only Add new Products Default = True
1=Yes; 2=No
Yes/No
Y/N
True/False
T/F
1/0
T DONOT_UPDATE_NAME Boolean Update all info except name and long name Default = True
1=Yes; 2=No
Yes/No
Y/N
True/False
T/F
1/0
U DELETE_PROD Boolean Mark as Inactive  
V VOL_QTY Numeric e.g. 750  
W VOL_UNITS Alphanumeric Mills, Litres, ml,l, Grams, Kilograms "FLOZ", "FLOZS", "USFLOZ", "FLUID OUNCE", "FLUID OUNCES" "OUNCES"  
X VOL_TEXT Alphanumeric Combined Volume. E.g. "750 Mills"  
Y UNIT_NAME Alphanumeric    
Z CASE_NAME Alphanumeric    
AA CASE_QTY Numeric    
AB SIZE1_NAME Alphanumeric    
AC SIZE1_QTY Numeric    
AD SIZE1_UNITS Alphanumeric Defaults to Items.  
AE SIZE2_NAME Alphanumeric    
AF SIZE2_QTY Numeric    
AG SIZE2_UNITS Alphanumeric    
AH SIZE3_NAME Alphanumeric    
AI SIZE3_QTY Numeric    
AJ SIZE3_UNITS Alphanumeric    
AK SIZE4_NAME Alphanumeric    
AL SIZE4_QTY Numeric    
AM SIZE4_UNITS Alphanumeric    
AN NO_STOCK Boolean    
AO COST_TYPE Numeric "GST", "1", "YES", "TAXED", "GSTFREE", "0", "NO", "NONTAXED"  
AP TYPE_NUMBER Numeric 0-29  
AQ TYPE_NAME Alphanumeric Set type by matching on Type Name  
AR SORT_NUMBER Numeric 0-29  
AS SORT_NAME Alphanumeric Set sort by matching on Sort Name  
AT MAX_SALEQTY Numeric    
AU STORE_ID Numeric Store ID is required for cost price to be added or updated  
AV STORE_NAME Alphanumeric Will be created if not found. No name will put all prices into ALL Stores.  
AW DELETE_STORE Boolean Only if Store has no stock or sales  
AX COST_EX Numeric Price. Format is 99999.99
Updating Cost price
When using the standard product import file the field AU (Store ID) is required for cost price to be added or updated on import.
If there is no store id the cost price will not update.
 
AY PRICE1_SIZE1_EACH Numeric Price. Format is 99999.99  
AZ PRICE1_SIZE2_EACH Numeric    
BA PRICE1_SIZE3_EACH Numeric    
BB PRICE1_SIZE4_EACH Numeric    
BC PRICE2_SIZE1_EACH Numeric    
BD PRICE2_SIZE2_EACH Numeric    
BE PRICE2_SIZE3_EACH Numeric    
BF PRICE2_SIZE4_EACH Numeric    
BG RETAIL_TAXTYPE Alphanumeric "GST", "1", "YES", "TAXED", "GSTFREE", "0", "NO", "NONTAXED"  
BH MIN_STOCKQTY Numeric    
BI MAX_STOCKQTY Numeric    
BJ RESTOCKQTY Numeric    
BK BARCODE1 Alphanumeric    
BL BARCODE1_SIZENUMBER Numeric Size 1-10  
BM BARCODE1_QTY Numeric This will match the lowest size with this qty  
BN BARCODE2 Alphanumeric    
BO BARCODE2_SIZENUMBER Numeric    
BP BARCODE2_QTY Numeric    
BQ BARCODE3 Alphanumeric    
BR BARCODE3_SIZENUMBER Numeric    
BS BARCODE3_QTY Numeric    
BT SUPPLIER_NAME Alphanumeric Will be created if not found  
BU SUPPLIER_PLU Alphanumeric    
BV SUPP_REORDERQTY Numeric    

 


Product Import Rules
  • Product Name must be limited to 30 characters
  • Product Name must be unique within a given Product Group, but we can have the same name if the 2 products reside in different groups
  • Product Full Name limited to 60 characters (price check screens only show this field)
  • Bad characters are: quotes, commas,
  • Good characters: dashes, underscores, asterisk
  • All Match On fields are On/True by default
  • Match on Supplier Code cannot be turned off, even if you specify “N”
  • If Export Code 1 is NOT unique, set the Match on Export Code 1 to be N (false)
  • Match On function goes from left to right based on the template format
    • Attempt to match in priority: Product number, Export Code, Group Name, Supplier PLU, Barcode
  • Best practice is the specifically assign Y or N for all Match On fields
  • If no store name is supplied, but you include a price or cost, that will be updated the product globally for all stores
  • Supplier PLU must be unique, can use a barcode
Ways to Make Product Groups
  • During Import, can apply the name on the sheet, reorganize groups into sub group organization after import
  • Do NOT use Product ID, this is a system created
  • Every item should have a unique Product Number assigned by either the customer or Bepoz before the first import
  • Group PLU number is the Product Number in the Product Group
    • This is necessary to assign  if attempting to import products into 2 sub groups with the same name
  • Confirm no commas in the price
  • If products have leading zeros, do not open and save in Excel, or these leading zeros will be lost
    • On the master template, it has been configured to text formatting, and the leading zeros will be maintained
  • Do NOT open a CSV file in Excel
  • Always use a fresh copy of the database for testing imports when you are troubleshooting and do not know how to solve the problem you are experiencing
  • Import USoz, use “ounce” 
  • Import USFloz, use “??? not sure”
  • Boolean = 1=Yes; 2=No
  • Cost import will be active when inventory is received

Scenarios for Updating Products & GroupsEdit Group
  1. New Group – Use formatted group import file
  2. Edit Group Parent – Use the normally formatted group file, just change the group name to the new parent group name
  3. Edit Group Number/Group Name – Group Name or Group Number can be edited in a single file
    1. If you attempt to edit both the group name and the group number in a single file it will create a new group
  4. Disable group  – This cannot be done if there are active products in the group. Delete product 1 inactivates if the group has inactive products in it and deletes the group if no products in it, 0 reactivates the group
  5. Edit product - Required (default) fields for all edits are the product name, product number, group name, group plu number
    1. The following can all be edited using the default information above plus the specific fields that need to be changed
    2. Add barcode
    3. Change sorts and types
    4. Change product name – Cannot change the product number with the same line or it will create a 2nd product
    5. Change product number– Cannot change the product number with the same line or it will create a 2nd product
    6. Add/Change Supplier name
    7. Add/Change Supplier code
    8. Add/Change Reordering info (Case, Unit etc)
 

The following requires the default information plus the name of the store in order to change/add:

  1. Add/Change size name/units/qty
  2. Add/Change Price
  3. Add/Change Min/Max
  4. Add/Change Restock Quantity
 

The following will require the default information in addition to other fields to update or may have exceptional rules:

  1. Disable product – Delete product 1 inactivates if the product hasn’t been sold or doesn’t have inventory, and deletes the product if no inventory or sales, 0 reactivates the product
  2. Change parent group – Need to include new group name and new group plu number in place of the old one
  3. Add the store to an existing product, or add store specific pricing to an existing product – must include all information as if you are adding the product from scratch. But must use the new store name
  4. Change price – must include the store you are editing the price for
  5. Remove Barcode – Normally barcodes are never removed, therefore, this is not currently possible. However, if a mistake is made, barcodes will need to be removed using Bepoz
  6. Remove store – Must include the store name, and 1 in “Delete Store”
  7. Change Cost – Costs can never be changed by import after the initial import
    1. The only way to change costs is either by receiving product in Bepoz or reinitializing the product in Bepoz