User guide for Marketplace Point of Sale (POS)
Table of Content
The Laravel eCommerce Marketplace Point of Sale extension connects two powerful Bagisto modules – the Marketplace (Multi-Vendor) module and the Point of Sale module.
With this Laravel eCommerce Marketplace Point of Sale extension, every seller of an online marketplace can also run their own physical store using a POS terminal of their own.
Sellers can manage outlets, POS agents, inventory, receipts, barcodes, orders, and sales reports from one dashboard.
The admin can control all the sellers’ Marketplace POS activities from a single admin panel, as the module automatically links every outlet, agent, order, and report to its seller.
Features Of Laravel eCommerce Marketplace Point of Sale
Seller POS Management
- Each marketplace seller gets a separate POS section inside their own seller dashboard.
- Sellers can create and manage multiple outlets (physical stores) from their dashboard.
- Sellers can add their own POS agents and assign them to their outlets.
- Sellers can create separate inventory sources for their stores.
- Sellers can generate and print barcodes for their products, one by one or in bulk.
- Sellers can create, edit, and preview their own custom receipts.
- Sellers can view all the orders placed through their outlets along with complete order details.
- Sellers get a detailed sales report for their own POS sales with filtering options.
- The module automatically tags every outlet, agent, receipt, order, and report a seller creates to that seller.
Sales, Stock, and Products at the Counter
- When an agent adds a product at the POS counter, the module automatically links it to the seller’s marketplace account.
- The module saves every sale at a seller’s counter as that seller’s marketplace order and calculates the marketplace commission on it.
- The POS counter shows the seller’s own products with the stock the seller holds in the outlet’s inventory source, and every sale deducts that stock.
- When a customer returns a product at the POS counter, the module puts the stock back into the seller’s inventory and records a marketplace refund.
- Products added by an agent at the counter get the seller’s stock and follow the marketplace product approval setting.
- Agents can add new products from the counter only while the admin allows sellers to create products.
Admin Control and Seller Data Safety
- The admin can see and manage all the sellers’ POS data from the single POS section of the admin panel.
- The admin can enable or disable the whole Marketplace POS module anytime from the configuration.
- If the admin disables the module, sellers’ agents cannot log in to the POS until the admin enables it again.
- Sellers can choose only their own inventory sources, receipts, and approved products for their outlets.
- The POS menu and actions follow the seller’s role permissions, so the seller’s staff see only the POS sections their role permits.
- Changing an agent’s password signs the agent out of the POS on every device.
- Sellers cannot delete an outlet while it still has agents, and deleting an outlet keeps its past POS orders.
- When the admin deletes a seller, the admin panel keeps that seller’s POS sales for the records.
- The admin selects the seller while creating an agent, outlet, or receipt, and every admin POS list shows the seller’s name.
- When the admin disables Marketplace, POS, or Marketplace POS, the seller dashboard hides the POS menu.
- Barcodes, agent images, and receipt logos work with cloud storage such as Amazon S3 and Cloudflare R2.
- Seller POS lists work on PostgreSQL databases as well as MySQL.
- Supports multiple languages for a worldwide audience.
Installing the Marketplace Point of Sale Extension
The customer will get a zip folder
Follow these steps to install the Bagisto Marketplace POS Extension:
1. Unzip and Merge Files
Unzip the extension zip file and merge the `packages` folders into your project root directory.
2. Update `composer.json`
Add the following line under the `psr-4` section in `composer.json`:
"Webkul\\MarketplacePos\\": "packages/Webkul/MarketplacePos/src"
3. Update `bootstrap/providers.php`
Add the following line under the `providers` section:
Webkul\MarketplacePos\Providers\MarketplacePosServiceProvider::class,
4. Run Commands
Execute the following commands from the root directory in the terminal:
composer dump-autoload
php artisan mp-pos:install
Once all the commands run successfully, the installation is complete.
Laravel eCommerce Marketplace Point of Sale Configuration
From the Admin dashboard, navigate to Configure > Marketplace POS in the left-hand menu and set the Status toggle to active.
Note: The admin should also enable the Marketplace module from Configure > Marketplace, otherwise the Marketplace POS settings and the seller menu will not appear.
Once the admin enables it, a new POS menu appears in the seller dashboard. This menu contains the following sections:
- Agents – the staff members who handle billing at the counter.
- Outlets – the physical stores of the seller.
- Inventory Sources – the stock locations of the seller.
- POS Order – the list of orders placed at the seller’s counters.
- Barcode Products – the products the seller can generate barcodes for.
- Receipts – the bill formats used while printing a receipt.
- Sales Report – the summary of all POS sales of the seller.
**Note:
The seller must complete the setup in a fixed order, because each item depends on the previous one:
- Create an Inventory Source first.
- Create a Receipt template.
- Create an Outlet by selecting the inventory source and receipt.
- Create an Agent and assign them to the outlet.
Manage Inventory Sources for the Marketplace POS
An inventory source is the seller’s stock location, from where the seller sells the products.
The seller can create an inventory source by navigating to POS > Inventory Sources > Create Inventory Source.
Here, the seller needs to enter details like Name, Contact Name, Email, Contact Number, Country, State, City, Street, Postcode and set the Status to active.
Manage Receipts in the Marketplace POS
A receipt is the printed bill the agent hands to the customer after the purchase.
The seller can create their own receipt format by navigating to POS > Receipts > Add Receipt.
The seller can customize the printed bill with details like store name, order ID, customer name, tax, discount, total, cashier, address, and logo.
A live preview lets the seller check the bill layout before saving.
Manage Outlet for the Marketplace Point of Sale
Under the Outlets section, the seller will find the list of all their physical stores.
The seller can add a new store by clicking on the “Create Outlet” button.
Here, the seller needs to enter some details –
Name
The seller needs to enter the name of the outlet in the field.
Email & Phone
The contact email and phone number of the outlet.
Address
In this section, the seller enters the store address along with the country, state, city, and postcode.
Receipt
The seller selects the receipt template they created earlier from the drop-down.
Inventory Source
The seller selects the inventory source they created earlier from the drop-down.
Low Stock Quantity
Here the seller can set the minimum quantity of a product. When the stock goes below this number, the POS marks the product as a low-stock product.
Status
The seller can make the outlet active or inactive from the toggle button.
Lastly, hit the Save Outlet button to save the outlet configuration successfully.
After creating the outlet, the seller can assign products to the outlet by clicking on the assign action shown in the outlet row.
Under the Assign Product tab, the seller selects their products, and the POS front end shows only the assigned products for that particular outlet.
Manage Agent for the Marketplace POS
An agent is the staff member who actually operates the POS counter and handles customer billing.
Under the Agents section, the seller will find the list of all the agents they have created.
The seller can add an agent by clicking on the “Create Agents” button.
Here, the seller needs to enter the below details:
Username
The seller needs to enter the username of the agent, which the agent will use to log in to the POS.
First name & Last Name
Here the seller needs to enter the first name and last name of the agent.
The seller needs to enter the email ID of the agent.
Password
The seller can set the login password for the agent.
Add Image
Add an image to represent the agent.
Outlet
Select the outlet from the drop-down to which the agent will belong. Only the products assigned to this outlet will be visible to the agent.
Status
The seller can make the agent active or inactive from the toggle button.
Lastly, hit the Save Agent button to save the agent configuration successfully.
Access and Use the Marketplace POS Front End
Once the seller has created an active agent, assigned the agent to an outlet, and assigned products to that outlet, the agent can start working from the POS front end.
- Open the POS front-end URL in a browser.
- Log in with the username and password created by the seller for the POS agent.
- Select the assigned outlet if the POS asks for it. That outlet decides which products and inventory the agent can use.
- Add products to the cart by searching for them or scanning their barcodes.
- Review the cart, apply any permitted discount, select the payment method, and place the order.
- After checkout, provide the generated receipt to the customer. The completed order will also be available in the seller’s POS Order section and sales reports.
Seller Orders, Commission, and Stock in the Marketplace POS
The POS counter of a seller’s outlet shows only the products assigned to that outlet, along with the stock the seller holds in the outlet’s inventory source.
When the agent places an order, the module saves it as the seller’s marketplace order and calculates the marketplace commission on it, just like an online order.
The module deducts the sold quantity from the seller’s own stock, so the admin’s stock and other sellers’ stock never change.
The seller can open the order and print its invoice from the seller dashboard.
If a customer returns a product at the counter, the returned quantity goes back into the seller’s stock, and the module records the refund on the seller’s marketplace order.
Add New Products from the Marketplace POS Counter
An agent can add a new product directly from the POS counter by clicking on Add New Product.
- The module saves the product as the seller’s own product in the marketplace.
- The module adds the opening quantity to the seller’s stock in the outlet’s inventory source.
- The product follows the marketplace product approval setting, so it waits for the admin’s approval when the admin requires approval.
- Agents can add products only while the admin allows sellers to create products from the marketplace configuration.
Barcode Products in the Marketplace POS
Here the seller can view all their products listed in one place.
Sellers can generate product barcodes, which POS agents can scan to quickly add products to the cart.
The seller can generate barcodes by selecting one or many products and choosing “Generate Barcode” from the mass action drop-down, then clicking the submit button.
Sellers can print barcode labels by selecting products and choosing “Print Barcode” from the mass action menu.
They can select the required quantity, and the module generates a printable barcode sheet.
POS Orders in the Marketplace Point of Sale
Under the POS Order section, the seller can view all the orders placed through their outlets in one list.
By clicking on any order, the seller can check the complete order information such as the items purchased, payment method, billing details, and totals.
Sales Report for the Marketplace POS
This section allows the seller to check the detailed sales report of their POS sales.
The seller can easily filter the sales report based on dates, outlets, and payment methods to know exactly how much business each counter did.
Admin Panel – Manage All Sellers’ Marketplace POS From One Place
The admin does not need to visit each seller’s dashboard separately.
All seller POS data—agents, outlets, receipts, barcodes, orders, and reports—appears in the admin panel with the seller’s name.
This way, the admin gets a complete overview of the POS activities of the whole marketplace from a single screen.
While creating an agent, outlet, or receipt from the admin panel, the admin selects the seller it belongs to.
Automatic Seller Tagging in the Marketplace POS
Whenever a customer purchases something at a seller’s counter, the module automatically tags the order to that seller.
If a POS agent creates a new product from the POS terminal, the module automatically links it to the seller’s marketplace account.
The product then appears in the seller’s product list without any extra work.
Seller Data Safety in the Marketplace POS
Each seller’s POS data stays separate from other sellers’ data:
- A seller can open and change only their own outlets, agents, receipts, and orders.
- While creating an outlet, the seller can choose only their own inventory sources and receipts, and assign only their own approved products.
- The POS menu and actions follow the seller’s role permissions, so the seller’s staff see only the POS sections their role permits.
- Changing an agent’s password signs the agent out of the POS on every device.
- Sellers cannot delete an outlet while it still has agents, and deleting an outlet keeps its past POS orders.
- When the admin deletes a seller, the admin panel keeps that seller’s POS sales for the records.
- When the admin disables Marketplace, POS, or Marketplace POS, the seller dashboard hides the POS menu, and sellers cannot open its pages.
That’s all for the Laravel eCommerce Marketplace Point of Sale extension — still, have any issues feel free to add a ticket.
Also, let us know your views on making the Marketplace Point of Sale module better https://bagisto.uvdesk.com/en/