Webkul
Services
Technologies Bagisto QloApps
iOS Android SAP BigCommerce Wix
Trusted by
Samsung Intel Toyota Walmart Disney Nokia Nestlé Decathlon
See all customers
Back to Top
DOC

User guide for Marketplace Point of Sale (POS)

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.

Laravel eCommerce Marketplace Point of Sale configuration status

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.
Marketplace Point of Sale seller section

**Note:

The seller must complete the setup in a fixed order, because each item depends on the previous one:

  1. Create an Inventory Source first.
  2. Create a Receipt template.
  3. Create an Outlet by selecting the inventory source and receipt.
  4. 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.

Marketplace Point of Sale inventory sources seller

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.

Marketplace Point of Sale seller receipt

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.

Marketplace Point of Sale manage outlets

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.

Marketplace Point of Sale barcode products assign

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.

Email 

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.

Marketplace Point of Sale manage 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.

  1. Open the POS front-end URL in a browser.
  2. Log in with the username and password created by the seller for the POS agent.
  3. Select the assigned outlet if the POS asks for it. That outlet decides which products and inventory the agent can use.
  4. Add products to the cart by searching for them or scanning their barcodes.
  5. Review the cart, apply any permitted discount, select the payment method, and place the order.
  6. 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.

Marketplace Point of Sale barcode products list

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.

Marketplace Point of Sale generate barcode

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.

Marketplace Point of Sale barcode label list

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.

Marketplace Point of Sale order lists

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.

Marketplace Point of Sale sales report

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.

Marketplace Point of Sale manage all sellers

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/

Current Product Version - v2.5.0

Supported Framework Version - v2.5.0

Blog Version - v2.5.0
  • Version v2.5.0
  • Version v2.4.x
. . .

Leave a Comment

Your email address will not be published. Required fields are marked*


Be the first to comment.

Back to Top

Message Sent!

If you have more details or questions, you can reply to the received confirmation email.

Back to Home
IN THIS ARTICLE

Table of Content

Back to top