Quickbuy

Introduction

Quickbuy helps your customers order many articles in one go: search for articles, choose quantities and add the whole list to the cart with a single click — without browsing through categories and product pages.

What you achieve with this plugin

• Your customers reach the Article Quickbuy page at any time via a dedicated icon in the header.
• Matching articles appear as suggestions while typing. One click adds the article to an order list.
• Articles with variants (for example colours or sizes) expand right inside the suggestions. Your customers pick the right variant without opening the product page.
• Add all to shopping cart puts all positions into the cart together.
• If the order already exists as a list, for example in Excel, your customers upload it as a CSV file. Quickbuy marks anything that cannot be ordered this way before it reaches the cart.
• Your customers download their cart and past orders as a CSV file, edit it and upload it again. They open a past order straight in Quickbuy with a single click.
• You decide whether the search looks for article names or only for complete product or manufacturer numbers — ideal for regular customers who know their numbers.
• You can switch Quickbuy on and off per sales channel and hide it for individual customer groups. You switch CSV upload and CSV export separately per sales channel.
• Two blocks for shopping experiences bring Quickbuy to any page and turn a category into an order list.

Who is this plugin for?

For shops whose customers regularly reorder several articles — typically in B2B: retailers, trade businesses, corporate buyers or regular customers with fixed order lists.

Installation

After your purchase, the plugin is already available in your Administration — there is nothing to download.

1. Log in to your Shopware Administration (YourShop.com/admin).
2. Open Extensions → My extensions.
3. Click Install next to Quickbuy.
4. Activate the plugin with the switch to the left of the entry — done.

Fig. 1: Quickbuy under Extensions → My extensions — the switch on the left is on; on the right, “Configure” takes you to the settings.

If Quickbuy does not appear in the list, your Shopware account is not yet connected to the shop. You can do this under Extensions → My extensions in the Shopware Account tab by logging in with your Shopware account.

Getting Started

Right after activation, Quickbuy is switched on in all sales channels. You don’t need to set anything else up for it to work.

1. Open the settings: Under Extensions → My extensions, click Configure next to Quickbuy.
2. Set the essentials: Under Search mode, decide whether your customers search by article name or only by complete numbers. Then click Save.
3. Check the result: Open your shop. The header now shows a new icon to the left of the customer account icon. When you hover over it, “Quickbuy” appears. Clicking it opens the Article Quickbuy page.

Settings

You open the settings under Extensions → My extensions with Configure next to Quickbuy. The page is divided into three sections: Channel configuration, Search settings and View settings. Apply your changes with Save at the top right.

Fig. 2: The complete Quickbuy configuration page.

Choosing the sales channel

At the very top, use Sales Channel to choose which shop your settings apply to. All Sales Channels sets the default for all shops. If you select a single sales channel, you can set individual settings differently there — anything you don’t change is taken over from the default.

Why this is useful: If you run one shop for business customers and one for consumers, for example, you offer Quickbuy only in the business shop or configure it differently there.

Fig. 3: Sales channel selection and the “Channel configuration” section.

to documentation

The to documentation button in the Channel configuration section opens this manual online — handy when you want to look something up while setting things up.

Enable plugin for this sales channel

The Enable plugin for this sales channel switch determines whether Quickbuy is active in the selected sales channel. It is switched on by default. If you switch it off, the header icon, the Quickbuy page and the Quickbuy blocks in your shopping experiences disappear in this channel. Anyone who calls up the page directly is shown the home page instead.

Why this is useful: You can pause Quickbuy in individual shops without uninstalling the plugin. Your settings are kept.

Remove header search on the quick order page

Remove header search on the quick order page removes the regular search field in the header while your customers are on the Quickbuy page. Only the Quickbuy search remains there. This setting is switched off by default.

Why this is useful: Two search fields on top of each other are confusing. With this setting, your customers always type into the right field and don’t accidentally end up on the regular search results page.

Fig. 4: The “Search settings” section with the three search modes.

Minimum characters before suggestions appear

Minimum characters before suggestions appear sets after how many typed characters the search starts and suggestions are shown. The default is 3 characters. This field must not be left empty.

Why this is useful: A lower number shows suggestions earlier but increases the load on your server. A higher number gives more accurate suggestions because more of the search term is already known. The default value suits most shops.

Search mode

Search mode defines what the Quickbuy search looks for:

• Normal search — The search finds articles in the same way as your shop’s search suggestions, for example by article name. The search field shows the hint “Enter article…”. This is the default.
• Complete product numbers only — The search finds an article only if its complete product number is entered exactly. The search field shows “Enter article number…”.
• Complete product or manufacturer numbers only — As above; in addition, an article is also found by its complete manufacturer number. The search field shows “Enter article or manufacturer number…”.

Why this is useful: Customers who know their order numbers from a catalogue or their own ERP system get exactly the one right article with the number modes — without similar hits. Normal search is the right choice if your customers tend to search by name.

Fig. 5: The “View settings” section with quantity selection, the two CSV switches and customer group selection.

Quantity selection

Quantity selection determines how your customers set the quantity per article:

• Display as dropdown — A selection list with quantities from 1 to 99. This is the default.
• Display as number field — An input field where your customers type in the quantity directly.

Why this is useful: The dropdown is quick to use with the mouse. The number field is more practical if your customers often order larger quantities or prefer to enter everything via the keyboard.

Allow CSV upload on the quick order page

The Allow CSV upload on the quick order page switch determines whether your customers can upload an order list as a CSV file on the Quickbuy page and in the Quickbuy shopping experience block. It is switched on by default. If you switch it off, the Upload order list (CSV) section disappears. The search and the order list keep working as usual. Chapter 6 describes how the upload works for your customers.

Why this is useful: Customers with long order lists don’t type in every number one by one but take over the whole list at once. If you don’t need this in a sales channel, you hide the section there and keep the page lean.

Allow CSV export from cart and orders

The Allow CSV export from cart and orders switch determines whether your customers can download their cart and their orders as a CSV file. It is switched on by default. The cart and the order confirmation page then show the button Download cart as CSV, and in the customer account the menu of each order offers the entries Download as Quickbuy CSV and Open in Quickbuy. If you switch it off, all three disappear. Chapter 7 describes how your customers work with them.

Why this is useful: Your customers save an order as a file, change only the quantities and reorder in seconds next time. The two switches are independent of each other: for example, you can offer the export and hide the upload.

Deactivate for the following customer groups

Under Deactivate for the following customer groups, select the customer groups for which Quickbuy is hidden. Customers in these groups see neither the header icon nor the Quickbuy page nor the Quickbuy blocks in your shopping experiences. CSV upload and CSV export are not available to them either. By default, no customer group is selected, so Quickbuy is available to everyone.

Why this is useful: You offer Quickbuy specifically to your business customers and hide it for consumers.

How your customers order via the Quickbuy page

What this gives you: Your customers put together their order on a single page and add it to the cart in one click. Repeat orders become much faster.

Opening the Quickbuy page

In your shop’s header, the Quickbuy icon sits to the left of the customer account icon. When your customers hover over it, the hint “Quickbuy” appears.

Fig. 6: The Quickbuy icon in the header, to the left of the customer account.

Clicking it opens the Article Quickbuy page. The search field is at the top, below it the order list with the columns Article name, Price and Quantity. If the CSV upload is switched on, the Upload order list (CSV) section also appears below the search field (see chapter 6).

Fig. 7: The “Article Quickbuy” page before any article has been searched for — with the “Upload order list (CSV)” section.

Searching for articles

As soon as your customers have typed the configured minimum number of characters, matching articles appear right below the search field — with image, name and price. Below the suggestions, the number of results found is shown.

Fig. 8: Suggestions while typing.

Selecting variants

If an article has variants, the suggestions show “more” instead of the price. Clicking the article expands its variants, for example all colours. Your customers then click the variant they want.

Fig. 9: The variants of an article are expanded.

Per search, Quickbuy shows at most 50 variants of an article. If an article has more, the link “More variants (number) on the product page” appears below them. It leads to the product page, where all variants are available.

Building the order list

Clicking a suggestion adds the article to the order list. Your customers then simply search for the next article. For each position, they choose the quantity they need. The X at the end of a row removes a position from the list again.

Fig. 10: The order list with two articles.

Adding everything to the cart

Once the list is complete, your customers click Add all to shopping cart. The button appears above and below the list. All positions go into the cart together; the cart then opens at the side and confirms how many products were added. From there, checkout continues as usual.

Fig. 11: The cart opens with all added articles.

How your settings affect the shop

Quantity as a number field: If you selected Display as number field under Quantity selection, your customers type in the quantity directly instead of choosing it from a list.

Fig. 12: Quantity selection as a number field.

Searching by number: With the Search mode Complete product numbers only, the search field shows the hint “Enter article number…”.

Fig. 13: The search field in product number mode.

The matching article only appears once the product number has been entered completely and exactly. Parts of a number do not produce a hit.

Fig. 14: Exactly one hit for the complete product number.

Without the header search: If Remove header search on the quick order page is switched on, the regular search field in the header is missing on the Quickbuy page. Your customers only use the Quickbuy search.

Fig. 15: The Quickbuy page without the header search.

On a smartphone

The Quickbuy page adapts to small screens. The Quickbuy icon is also shown in the mobile header; the search field and order list use the full width.

Fig. 16: The Quickbuy page on a smartphone.

Tip: The Quickbuy page is hidden from search engines. It does not show up in search results and does not compete with your product and category pages.

How your customers upload an order list as CSV

What this gives you: Many business customers plan their order in Excel or get it from their own ERP system. Instead of typing in every number one by one, they upload the whole list as a CSV file. Quickbuy checks every line and shows right away what can be ordered and what cannot — before anything reaches the cart.

The upload is available on the Article Quickbuy page and in the Quickbuy shopping experience block. It appears as long as Allow CSV upload on the quick order page is switched on (see chapter 4).

Opening the “Upload order list (CSV)” section

The upload sits below the search field in the Upload order list (CSV) section. On the right of its title line, it says “Take over an order list from a CSV file”. Clicking the title line expands or collapses the section.

• As long as the order list is empty, the section is expanded on a computer.
• On a smartphone, it starts collapsed so the search field and list have room. Your customers open it with a tap on the title line when they need it.
• As soon as articles are in the list — after an upload or after a search — the section collapses. If the list is emptied again, it expands again by itself on a computer.

Fig. 17: The expanded “Upload order list (CSV)” section.

Preparing the file

Below the drop zone, the format rules your customers need to know are listed:

• “Column 1 product or manufacturer number, column 2 quantity” — if Search mode is set to Complete product numbers only, the rule reads “Column 1 product number, column 2 quantity”. The upload then finds articles by their product number only.
• “Separator ; , or tab” — Quickbuy detects the separator by itself.
• “Header row optional” — a heading row such as “Product number;Quantity” is allowed but not required.
• “up to 500 lines / 1 MB” — your customers split larger lists into several files.

In addition:

• Numbers must be complete. The upload looks up every number exactly; parts of a number do not produce a hit. Upper and lower case do not matter.
• Empty quantity = 1 piece. If column 2 is empty, Quickbuy adds the article once. If it contains 0 or something that is not a number, it uses the smallest allowed quantity and marks the line.
• Duplicate numbers are merged. If the same number appears several times, a single line is created and the quantities are added up.
• Use Excel files directly. Quickbuy reads CSV files in UTF-8 and in Windows-1252 — exactly the way Excel saves them. Special characters such as umlauts are kept. It does not read an Excel workbook (.xlsx); it must be saved as CSV first (see chapter 10).

Sample file: At the bottom right of the section is the link Download sample file. It gives your customers a ready-made CSV file with the header row “Product number;Quantity” and two sample lines. They replace the sample numbers with their own and upload the file. The file name follows the shop language; in the English shop it is quickbuy-template.csv.

Uploading the file

Your customers have two options:

1. Drag the file in: They drag the file onto the “Drag a CSV file here” area. As soon as they drag a file over the browser window, the section expands by itself and the area shows “Release to upload”.
2. Choose the file: They click Choose file and pick the file on their computer. On a smartphone, this is the only way.

The upload starts immediately — no extra confirmation is needed. All lines of the file go into the order list below the section. There, your customers can change quantities and remove positions with the X before clicking Add all to shopping cart.

After the upload, the section collapses. Its title line now shows the file name and the number of lines added.

Fig. 18: After the upload: “2-schnellkauf-mit-hinweisen.csv · 8 lines added”.

Understanding the markings

Above the order list, a message summarises the result. If everything is fine, it reads for example “8 items applied.” If individual lines need attention, it reads something like “8 items applied, 3 with a note and 4 not orderable.”

These lines are highlighted in colour in the list. Below the article, the note is shown, followed by the line number in the file, for example “Line 5”. This lets your customers find the spot in their file quickly.

• Lines marked red are not ordered. They have no quantity field and are left out when your customers click Add all to shopping cart.
• Lines marked yellow are ordered — with the quantity shown in the line. The note explains what changed compared to the file.
• Lines without a marking are ordered as stated in the file.

Fig. 19: The result of an upload with summary, yellow and red markings.

Note in the line	Meaning	Is it ordered?
”Product number not found.” (red)	There is no article with this number in this sales channel — for example a typo, an outdated number or an article that is inactive or deleted.	No
”Sold out, not orderable.” (red)	The article is a clearance article and has no stock left.	No
”Please choose a variant.” with the link Go to product page (red)	The number belongs to an article with variants, for example several colours. The file does not say which variant is meant. The link leads to the product page. Next time, your customers enter the number of the variant they want in the file.	No
”Cannot be ordered online.” (red)	The article cannot be ordered at the moment, for example because its price is only given on request (see chapter 9).	No
”Only 2 available, quantity was adjusted.” (yellow)	The article is a clearance article with less stock than requested. The quantity was reduced to the available stock.	Yes, the reduced quantity
”Only 1 available for immediate delivery.” (yellow)	Less is in stock than requested. However, the article is not a clearance article and can therefore still be ordered in full.	Yes, the full quantity
”Quantity adjusted to 100 (minimum, maximum or purchase steps).” (yellow)	The quantity from the file did not match the article’s minimum or maximum purchase or its purchase steps — or the file contained no valid quantity. Quickbuy used the next allowed quantity.	Yes, the adjusted quantity

The numbers in the notes depend on the article. A line can also carry several notes, for example an adjusted quantity and too little stock for immediate delivery.

Tip: Red lines do not get in the way of ordering — they are simply not ordered. To tidy up the list, remove them with the X at the end of the line.

Adding another file

Your customers can upload several files one after the other, or mix upload and search. Each new file adds its lines to the existing list. If an article is already in the list, the line from the new file replaces the existing one — with the quantity from the new file. This way, no duplicate positions are created.

If the file does not fit

If the file as a whole does not fit, the section shows a red message and nothing is applied — the order list stays unchanged. Your customers correct the file and upload it again.

Fig. 20: Error message for a file with more than 500 lines.

• “The file has more than 500 lines. Please split the list. Nothing was applied.” — Split the list into several files and upload them one after the other.
• “The file is larger than 1 MB. Nothing was applied.” — Remove unnecessary columns or split the list.
• “The file contains no product numbers. Nothing was applied.” — The file is empty, or column 1 contains nothing.
• “The file is not a readable CSV file (.csv or .txt). Nothing was applied.” — Usually an Excel workbook (.xlsx) or another file format was chosen. Save the file as CSV in Excel and upload it again.
• “The file could not be processed. Please try again.” — A temporary error, for example an interrupted connection. Simply upload it again.

How your customers use the cart and orders as CSV

What this gives you: Your customers save a cart or a past order as a file, change only the quantities in Excel and upload it again next time. They can even bring a past order back into Quickbuy with a single click. Regular reorders become especially fast.

These functions are available as long as Allow CSV export from cart and orders is switched on (see chapter 4).

Downloading the cart as CSV

On the cart page, the button Download cart as CSV sits in the right-hand column below Go to checkout. One click downloads all articles in the cart as a CSV file.

Fig. 21: The “Download cart as CSV” button in the cart.

Your customers find the same button on the order confirmation page below Submit order. It only downloads the file and does not submit the order.

Fig. 22: The button on the order confirmation page.

The file name follows the shop language and contains the date, in the English shop for example quickbuy-cart-2026-09-30.csv. If the cart contains no articles that can be downloaded, the cart shows the message “Your shopping cart contains no items that can be downloaded as CSV.”

Downloading an order from the customer account

In the customer account under Orders, your customers open the three-dot menu of an order. Next to the familiar entries Change payment method and Repeat order, there are two new ones:

• Download as Quickbuy CSV — downloads the articles of this order as a CSV file, in the English shop for example as quickbuy-order-10020.csv.
• Open in Quickbuy — loads the articles of the order straight into the Quickbuy page (see 7.3).

Fig. 23: The two Quickbuy entries in the menu of an order.

Only registered customers who are logged in see these two entries — and only for their own orders that contain at least one article. Customers who ordered as a guest do not see the entries. Guests can still download the cart as CSV.

Opening an order in Quickbuy

Open in Quickbuy takes your customers to the Article Quickbuy page, with all articles of the order already in the order list. Quickbuy checks them exactly like a CSV upload: articles that no longer exist, are sold out or whose quantity no longer fits are marked (see 6.4). Above the list, the summary is shown, for example “3 items applied, 1 with a note and 0 not orderable.” If the CSV upload is switched on, the title line of the upload section also shows the order number, for example “Order 10020 · 3 lines added”.

Fig. 24: A past order, opened in Quickbuy.

Your customers adjust the quantities, search for more articles if needed and click Add all to shopping cart.

What the file contains

The downloaded file has exactly the format the CSV upload expects. In the English shop, the columns are:

1. Product number
2. Quantity
3. Product name
4. Unit price
5. Total price

The prices appear in the file as the shop shows them to your customer. In the English shop, they use a decimal point; in German and Dutch shops, a decimal comma — so Excel recognises them as numbers. The file contains articles only — shipping costs, discounts and vouchers are not included. When the file is uploaded again, Quickbuy only reads the first two columns; name and prices are there for your customers’ orientation.

The cycle: download, edit, upload again

This is how your customers reorder the same articles regularly:

1. Download the cart or a past order as CSV.
2. Open the file in Excel, change quantities, delete lines or add new product numbers.
3. Save it as CSV.
4. Upload it on the Article Quickbuy page in the Upload order list (CSV) section.
5. Check the markings and click Add all to shopping cart.

Tip: The saved file replaces a fixed order template in the shop. Your customers can keep as many of these files as they like, for example one per construction site or per branch.

How to add Quickbuy to shopping experiences

What this gives you: You offer Quickbuy not only on its own page but wherever it helps your customers — for example on a page for business customers. You can also display a category as an order list where your customers enter a quantity for several articles at once.

The plugin provides two blocks for this. You find them in the layout editor under Content → Shopping Experiences in the Block category Commerce:

• Quickbuy — the complete Quickbuy search with order list, just like on the Article Quickbuy page. You can place this block in any layout.
• Quickbuy Product Listing — shows the products of a category as an order list. Each article has its own quantity field, starting at 0. Your customers enter a quantity for all articles they want and click Add all to shopping cart. This block belongs in a layout of the type Listing page.

Fig. 25: The two Quickbuy blocks in the “Commerce” block category.

Step by step

1. Go to Content → Shopping Experiences.
2. Open an existing layout or click Create new layout. For the Quickbuy Product Listing block, choose the type Listing page.
3. Open the Blocks sidebar on the right and select Commerce under Block category.
4. Drag the Quickbuy or Quickbuy Product Listing block to the desired position in the layout.
5. Click Save.
6. Assign the layout to the page you want — for the Quickbuy Product Listing block under Catalogues → Categories in the relevant category, in the Layout area via Assign layout or Change layout. Save the category.

In the shop, the category then looks like this: the Quickbuy order list with all articles of the category is at the top, below it — if you kept it in the layout — the usual product listing.

Fig. 26: The “Quickbuy Product Listing” block on a category page in the shop.

Tip: In the layout editor, the Quickbuy Product Listing block only shows a schematic preview without real articles. That is expected: the articles only come from the category you assign the layout to once the page is shown in the shop. Check the result directly on the category page in your shop.

Important: The settings from chapter 4 also apply to the blocks. If Quickbuy is switched off in a sales channel or hidden for a customer group, the blocks show nothing there. The Quantity selection setting applies to the blocks as well.

Working with other plugins

Quickbuy works together with two other plugins by BuI Hinsche GmbH. You don’t need them — but if you use them, Quickbuy takes their rules into account automatically.

• Packaging units (German store name: „Verpackungseinheiten“): If you have defined packaging steps for a customer group, the quantity selection in Quickbuy only offers these steps. Your customers cannot order quantities you don’t deliver. If a quantity from an uploaded CSV file does not match the steps, Quickbuy sets it to the next matching step and marks the line yellow.
• Price on request (German store name: „Preis auf Anfrage“): Articles whose price is only given on request cannot be ordered via the Quickbuy search and are hidden in Quickbuy order lists. If they are in an uploaded CSV file, the line appears in red with the note “Cannot be ordered online.” This way, no article without a fixed price ends up in the cart.

Troubleshooting

The Quickbuy icon does not appear in the header

Cause: The plugin is not yet activated, switched off in the sales channel or hidden for the customer’s customer group — or the cache still shows an old state.

How to fix it:

1. Open Extensions → My extensions and check that the switch next to Quickbuy is on.
2. Click Configure, select the affected Sales Channel at the top and check that Enable plugin for this sales channel is switched on.
3. Under Deactivate for the following customer groups, check whether the customer’s group is selected there.
4. Clear the cache: Settings → System → Caches & indexes → Clear cache.

Calling up the Quickbuy page shows the home page

Cause: Quickbuy is switched off in this sales channel or hidden for the customer’s group. In this case, the shop deliberately shows the home page.

How to fix it: Check steps 2 and 3 from the previous section.

No suggestions appear

Cause: Fewer characters were typed than set under Minimum characters before suggestions appear — or a number search mode is active and the number is not yet complete.

How to fix it:

1. Check the value under Minimum characters before suggestions appear.
2. If Search mode is set to Complete product numbers only or Complete product or manufacturer numbers only, the number must be entered completely and exactly. Customers who want to search by name need Normal search.

The regular search field in the header is missing

Cause: The setting Remove header search on the quick order page is switched on. The search field is only missing on the Quickbuy page; it is present on all other pages.

How to fix it: Switch the setting off if you want to show the search field on the Quickbuy page too.

The “Quickbuy Product Listing” block is empty in the layout editor

Cause: This is not an error. The block only receives its articles in the shop, from the assigned category.

How to fix it: Assign the layout to a category and check the result on the category page in your shop.

After a CSV upload, many lines are “not found” although the numbers are correct

Cause: Excel likes to change numbers when opening or saving a file. Leading zeros disappear (00123 becomes 123), and long numbers end up in scientific notation (4006381333931 becomes 4.00638E+12). Quickbuy looks up every number exactly and cannot find the changed number.

How to fix it:

1. In Excel, format the column with the product numbers as text before you enter or paste the numbers.
2. Check the numbers after saving, for example by opening the CSV file in a plain text editor.
3. Upload the file again. The line number in the note (“Line 7”) shows you which line to check.

The Excel file is not accepted

Cause: Quickbuy reads CSV files, not Excel workbooks (.xlsx). The message “The file is not a readable CSV file (.csv or .txt). Nothing was applied.” appears.

How to fix it: Open the file in Excel, choose “Save As” and select CSV as the file type. Upload the saved CSV file.

The “Upload order list (CSV)” section is missing

Cause: The CSV upload is switched off in the sales channel — or Quickbuy as a whole is switched off there or hidden for the customer group.

How to fix it: Open the configuration, select the affected Sales Channel at the top and switch on Allow CSV upload on the quick order page. Also check Enable plugin for this sales channel and Deactivate for the following customer groups.

The “Download cart as CSV” button or the entries in the order menu are missing

Cause: The CSV export is switched off in the sales channel, Quickbuy is switched off there or hidden for the customer’s group. The entries Download as Quickbuy CSV and Open in Quickbuy are also missing if the customer ordered as a guest or the order contains no articles.

How to fix it:

1. Select the affected Sales Channel at the top of the configuration and check that Allow CSV export from cart and orders is switched on.
2. Check Enable plugin for this sales channel and Deactivate for the following customer groups.
3. Clear the cache: Settings → System → Caches & indexes → Clear cache.

FAQ

Q: Can I offer Quickbuy to business customers only?

A: Yes. Under Deactivate for the following customer groups, select all customer groups that should not see Quickbuy. Keep visitors who are not logged in in mind: they belong to the customer group set as the default in your sales channel.

Q: Can I offer Quickbuy in one sales channel but not in another?

A: Yes. Select the sales channel at the top of the configuration page and switch off Enable plugin for this sales channel there. The other channels are not affected.

Q: How many pieces can a customer choose per article?

A: With Display as dropdown, quantities from 1 to 99 are available. If your customers need other quantities, switch to Display as number field.

Q: Why can’t my customers find an article by part of its product number?

A: In the search modes Complete product numbers only and Complete product or manufacturer numbers only, the search finds an article only by its complete, exact number. This way your customers get exactly the one right article. To search by parts or names, switch to Normal search.

Q: An article has a very large number of variants. Are all of them shown?

A: Per search, Quickbuy shows at most 50 variants of an article. If there are more, the link “More variants (number) on the product page” leads to all variants.

Q: Is the Quickbuy page found by Google?

A: No. The page is hidden from search engines. It is a tool for your customers and is not meant to appear in search results.

Q: Why does the layout editor show no articles in the “Quickbuy Product Listing” block?

A: The block only gets its articles in the shop, from the category you assign the layout to. On the category page in your shop, they appear in full.

Q: Which files can my customers upload?

A: CSV files (.csv or .txt) with the product number in column 1 and the quantity in column 2, up to 500 lines and 1 MB. The separator can be a semicolon, a comma or a tab; a header row is optional. Your customers save Excel workbooks (.xlsx) as CSV first.

Q: Is an article that is marked red in the list ordered?

A: No. Lines marked red have no quantity field and are left out when your customers click Add all to shopping cart. Lines marked yellow are ordered, with the quantity shown in the line.

Q: Can guests download their order as CSV?

A: No. The entries Download as Quickbuy CSV and Open in Quickbuy are only available to registered customers, and only for their own orders. Guests can still save the cart with Download cart as CSV.

Q: Are uploaded files stored in the shop?

A: No. Quickbuy only reads the file to fill the order list and does not store it anywhere.

Q: Can a customer download another customer’s orders?

A: No. Each customer can only download or open their own orders in Quickbuy.

For Administrators / Technical Details

This section is intended for technical administrators. You don’t need it for everyday use.

System requirements

• Shopware: 6.7 (tested with 6.7.14.2)
• PHP: 8.2 or newer

Installation via the command line

php bin/console plugin:refresh
php bin/console plugin:install SwpQuickBuySix --activate
php bin/console cache:clear

Address of the Quickbuy page

The Quickbuy page is available at /quickbuy in your sales channel, for example YourShop.com/quickbuy. You can therefore also link it in your main navigation, in the footer or in emails to your customers.

Addresses for CSV upload and CSV export

• POST /quickbuy/csv-upload — receives the uploaded file and returns the checked result to the Quickbuy page.
• GET /quickbuy/csv-template — the sample file.
• GET /quickbuy/csv-export/cart — the cart as CSV.
• GET /quickbuy/csv-export/order/{id} — an order as CSV; only for logged-in, registered customers and only for their own orders. The shop answers a foreign or unknown order with “not found”.
• GET /quickbuy/order/{id} — the Quickbuy page with the positions of an order; same access rules as the order export.

If the respective switch is off, Quickbuy is switched off in the sales channel or the customer group is excluded, these addresses deliver no content.

Store API for custom frontends

POST /store-api/swp-quick-buy/resolve-lines resolves a list of product numbers and quantities with the same checks as the CSV upload in the Storefront — including the markings from chapter 6.4. This lets you rebuild the upload in a headless frontend (for example Composable Frontends). The route works as long as Quickbuy is active in the sales channel and allowed for the customer group; at most 500 positions are allowed per request.

Limits and security

• File size and scope: at most 1 MB and 500 lines with a product number per file. Numbers are cut off after 64 characters; the quantity per line is limited to 1,000,000.
• Character encoding: UTF-8 (with or without BOM) and Windows-1252. Binary files such as Excel workbooks or images are rejected.
• Formula protection: On export, cells starting with =, +, - or @ get a leading apostrophe. Spreadsheet programs therefore do not execute them as formulas. When the file is uploaded again, Quickbuy removes the apostrophe, so the product number stays unchanged.
• No storage: Uploaded files are only read in memory and not stored. Resolving the lines writes nothing to the database.
• Export format: semicolon as separator, UTF-8 with BOM, decimal comma in German- and Dutch-language sales channels, decimal point otherwise.

Working with other plugins

The plugins mentioned in chapter 9 are technically named SwpPackingUnitsSix (packaging units) and SwpPriceOnRequestSix (price on request). Quickbuy detects them automatically when they are installed and active.

---

This manual was written for Quickbuy version 6.7.3.