Importing products

<< Click to Display Table of Contents >>

Importing products

» Available only in Dotypos FULL and higher. «

Dotypos Cloud lets you import or export products and their categories. If you have already created products or categories, you can export them to the file and use it for backups or adjustments. If you import this file back via Dotypos Cloud, the products and categories will be automatically updated or newly created. You may import just one .csv file. Before importing the .xls file, you have to save it in .csv format first.

 

poznamka_icon

To find out how to import/export, see the parent chapter. If you want to change the VAT for individual products on a mass scale, use the Multiple select function.

 

Each product or category has its own ID number. If you modify an item in the .csv file, the item with the same ID number will be adjusted in Dotypos Cloud after the import and also in the touch cash register after synchronization. The items in the file for import correspond to the product properties.

You will find the import and export buttons in the page heading at Item management » Products.

If you have not created any products or categories yet and you want to batch import them, download this file and replace the sample data with yours. Then import the file. The procedure is described in this chapter. The template file can be also downloaded from Dotypos Cloud.

top

Description of import file columns

Product import file

externalId

Unique number product (choose any series of numbers, e.g. 101, 102 and so forth). This product number must be unique. Do not reuse a number that had earlier been assigned for a now-deleted product.

productId

Do not fill this column out, but leave it with empty values. It is used to identify record updates internally.

categoryId

The unique number of category. A product will be assigned to the corresponding category according to this number. If you leave the category ID blank, the product will be automatically assigned to the common category Import. If you want to assign the product to a new category, enter categoryId as a random unique number for each new category.

categoryName

Name of categoryto which the product will belong

name

Name product

ean

EAN code product

hexColor

Color code in HEX format (e.g. #EED5D2). Codes for individual colors can be found here.

subtitle

Brief description product

description

Complete note product

units

Product quantity unit. The default setting is Piece (overview of suitable units).

unitsmeasurement

Measuring unit to be used at price tags. If not entered, the default unit “number of pieces” will be used when generating price tags. It relates to packagingmeasurement, see below.

priceWithoutVAT

Product sales price excluding VAT (e.g. 24,00 or 24.00)

You can omit this column if you are filling out the price including VAT priceWithVAT.

vat

VAT rate entered in decimal format with a decimal point or comma (e.g. 1.21 for 21%, 1,15 for 15% or 1 for VAT non-payers)

priceWithVAT

Product sale price including VAT (e.g. 24,00 or 24.00)

You can omit this column if you are filling out the price without VAT priceWithoutVAT.

display

The number determining whether the product is displayed in the product overview on the main screen or not (1 or 0 - displayed/hidden).

deleted

Number identifying a deleted product (1 or 0 - deleted/non-deleted). Once a product has been deleted, it no longer appears on the cash register. The default value is 0.

stockDeduct

Indicates whether the product is deducted from the warehouse or not. For example, in the case of ingredients , the sales products are not deducted (1 or 0 - deducted/not deducted).

tagsList

List of tags separated by commas without spaces (e.g. tag1,tag2,tag3). For product assignment use the tag with the prefix
-ac- (e.g. -ac-P0001).

notesList

List of fast notes a.k.a. product variants separated by commas without spaces (e.g. rare,medium,well done)

sortOrder

Integer indicating the product sequence in Dotypos. You may use a time series of any kind (not supported yet)

onSale

Defines whether the product is being sold at a discount or not (1 or 0 - reduction/no reduction).

discountPercent

Discount in percentages is applied to a product when onSale is set to 1 (sale value or 0)

points

Number of customer pointsto be added to the customer during the sale (negative value deducts points)

plu

PLU code of product (you may enter several PLU codes for one product by typing the codes into one cell. Each code in one cell has to be on a separate line, using the key combination Ctrl + Enter.)

packaging

Number of items in the packaging (default value is 1)

packagingmeasurement

Measuring the packaging to be used at price tags. If not entered, the default unit “package of 1 piece” will be used when generating price tags.

currency

Currency used to price the product. For Czech crowns use the abbreviation CZK.

marginmin

Minimal margin (not used yet, will be implemented in future versions)

dnids

Delivery note number (not used yet, will be implemented in future versions)

eetsubjectID

Subject number for sale by proxy. The numbers of the created subjects can be found in Dotypos Cloud in the item Item management » EET subjects after clicking on subject’s detail.

margin

The minimal product margin either in percents "10%" or directly "10" in EUR

discountPermitted

The number defining whether the product allows bulk discounts (1 or 0 - discounts allowed/not allowed).

requiresPriceEntry

Require price entering (1 or 0 -require/not require)

requiresQuantityEntry

Require quantity entering (1 or 0 -require/not require)

timeable

Calculate time based value (1 or 0 - calculate/do not calculate)

fiscalizationdisabled

Specifies whether the product in the category will be recorded (fiscalized) or not (1 or 0 - do not fiscalize/fiscalize).

takeawayitem

Enables (1) or disables (0) the option for takeaway sales for the appropriate product.

stockoverdraft

Defines the sale overrunning quantity in stock for the appropriate product. The possible values are: ALLOW (allow), WARN (notify) and DISABLE (disable). The default value is ALLOW. Valid starting with Dotypos Cloud version 1.57.

jointsale

Indicates a joint sale. If the joint sale for the item is active (value 1), Dotypos also adds the ingredient items during the sale to the order. The joint sale is used e.g. for returnable containers.

special

Indicates Special products. The default value is 0. Only for previously created special products will it be 1.

The required items are marked in bold, other items (data) are optional. The obligatory columns must always contain some values!

 

poznamka_icon

Are supported .csv files with delimiter ; (semicolon) and , (comma). If semicolon is used, it is possible to separate decimal places by commas and periods. If you use a comma as a data separator, you must use a period to separate the decimal places.

top


Supported units

The unit is specified in the column units, unitsmeasurement and packaging. Enter in the file to be imported the English format shown below:

top