BizCoRaBizCoRaDocumentation center

Import data: products, customers and stock (CSV)

Admin

Import or update your product catalog, your customer file AND your stock from a file, without re-keying or duplicates.

Presentation

Import lets you add or update lots of data at once from a CSV file (a spreadsheet you can export from Excel, Google Sheets or LibreOffice). The screen has three tabs: Products, Customers and Stock (the latter with two sub-tabs: Inventory levels and Movements). Ideal for onboarding or bulk fixing. The server validates each row: valid rows are imported, rows in error are listed with a clear explanation - nothing is ever silently lost.

Access

Administrator dashboard, Stock section, "Import data" card, then choose the Products or Customers tab. (Administrators only.)

Interface description

  • "Products", "Customers" and "Stock" tabs: At the top, three tabs. Products imports your catalog; Customers imports your customer file; Stock updates the quantities of EXISTING products, with two sub-tabs: "Inventory levels" (you give the new total stock after a count) and "Movements" (you record entries/exits). Each tab works the same way (download the template, fill it, import it) and keeps its report when you switch tabs.
  • Stock columns (Stock tab): The product is identified by its 'Reference' (or 'Name'): it must ALREADY exist (stock import never creates a product; use the Products tab to create). Levels sub-tab: 'Quantity' = the new total stock (a traced inventory movement is created for the difference). Movements sub-tab: 'Type' = In or Out, 'Quantity' = the movement quantity; an Out larger than available stock is refused (never negative stock). 'Reason' is optional.
  • Customer columns (Customers tab): On the Customers tab: 'First name', 'Last name' and 'Phone' are required (star). Phone must be in international format (e.g. +33612345678); it is also used to recognize an existing customer and update it (no duplicate). 'Email' and 'Address' are optional. The loyalty points balance is never imported (it is managed automatically by sales).
  • "Download the template" button: Downloads a ready-made CSV file, with the right columns (in your language) and two examples. This is the recommended starting point: just replace the examples with your products.
  • Expected columns: The list of file columns. Only 'Product name' and 'Selling price' are required (star). 'Reference (SKU)' is used to recognize an existing product and update it. Other columns (purchase price, quantity, thresholds) are optional.
  • Report (Created / Updated / Skipped): Three counters summarize the import. Below, each row in error is listed with its number and reason. Fix those rows and re-run: no duplicate is created.

Step-by-step procedure

  1. Action: At the top, pick the tab for what you import: "Products" for the catalog, "Customers" for the customer file. Result: The chosen tab shows its expected columns and buttons.
  2. Action: Tap "Download the template": a ready-made CSV file (with the right columns in your language + 2 examples) is downloaded to your device. Result: You get a template file, already in the right format.
  3. Action: Open the template in Excel (or Google Sheets), replace the 2 example rows with your products, then save the file. Result: Your file is ready to import. Check: Keep the first row (the column titles) intact; fill in at least Name and Selling price.
  4. Action: Open "Import products", tap "Choose a CSV file", then select your file. Result: The import runs and the report appears. Check: Check the Created / Updated / Skipped counters.
  5. Action: If some rows were skipped, fix them in the file (the reason is shown), then re-run the import. Result: Already-imported products are updated, not duplicated; the fixed rows are added.

Examples

[Simple] First catalog import: A file of 150 products (Reference, Name, Selling price, Quantity). Result: 150 created, 0 skipped. Initial stock is taken into account.

Edge cases

Re-importing the SAME file creates no duplicate: recognized products (by reference, otherwise by name) are updated. You can fix and re-run as many times as needed.

A decimal comma is accepted (12,50 as well as 12.50). The file must be at most 2 MB and 2000 rows; beyond that, split it.

Error messages

Product name is required.
Cause: The Name column is empty on this row. Solution: Fill in a name then re-run.
Invalid number.
Cause: The price or quantity contains non-numeric characters. Solution: Use a number (e.g. 12.50) without a currency symbol.
Required columns missing.
Cause: The header does not contain 'Name' and/or 'Selling price'. Solution: Start again from the export of your products as a template.

Tips

  • Fill in the Reference (SKU) column: it reliably finds and updates an existing product on re-import.