Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Tutorials
Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Unified Commerce
VTEX Sales App
Enabling Local stock sale in VTEX Sales App
Enabling Local stock sale in VTEX Sales App
5 min read

Local stock sale allows the sales associate in a physical store to complete sales through Sales App using a smartphone or a tablet without having to check out the customer at the register. To enable Local stock sale in your store, you need to:

  1. Create a franchise account
  2. Create a seller
  3. Set up a pickup point
  4. Create a warehouse
  5. Update the inventory
  6. Link the franchise account to the physical store
  7. Integrate the point of sale

Local stock sale can only be set up for stores that use Sales App. Learn how to request and configure Sales App in our Sales App - Getting started and setting up documentation.

Creating a franchise account

The first step is to request the creation of a franchise account for your physical store. The franchise account will be linked to the main account of your store and will inherit its catalog. If you already have a franchise account, go to the next step.

Creating a seller

After creating a franchise account, you need to create a seller to represent the physical store in the main account linked to the franchise account. To check whether your store uses store pickup or sellers to represent physical stores, go to the Seller Management page of your Admin and search for the physical store's name.

Setting up a pickup point

After creating the franchise account, you need to add the address of the physical store as an available pickup point. To do this, follow the instructions in How to set up pickup points.

The created pickup point will be assigned an ID that you will need when Creating a warehouse. If you lose the ID, you can view it in the Pickup Points screen of the VTEX Admin, under the ID column.

Creating a warehouse

After you have the pickup point, you need to indicate which warehouse is available for your physical store in each seller. You can share an available warehouse between the ecommerce website and the physical operation, or you can create a separate warehouse for physical store sales. To enable a warehouse for Sales App, follow the steps below:

  1. In the VTEX Admin, go to Shipping > Shipping Strategy > Warehouses, or type Shipping Strategy in the search bar at the top of the page.
  2. Click + Create Warehouse.
  3. Complete the form fields and select the pickup point configured in the previous step.
  4. Toggle the switch to Active to link the warehouse of the physical store to Sales App.
  5. Click Save.

Updating the inventory

It is a good practice to check the items available in the inventory and update it after activating the warehouse and pickup point. You can check the store inventory in two ways:

If all your products are listed without quantity, you will need to add the quantities of this store manually or via API.

You need to enabling selling an out-of-stock item if you want to ensure the item on hand will always be available for customers in the store.

If you created two different warehouses, one for the ecommerce website and one for Sales App, it is important to manage stock quantity correctly for each.

Linking the franchise account to the physical store

To ensure that the sales associates of your physical store have the right access to the store warehouse at their location, it's important to link the franchise account to their profile. To do this, add the physical store to Sales App.

You will need to select a sales associate from the store where you want to test On Hands and follow the steps below.

  1. With a sales associate selected, open Sales App and log in.
  2. Search for an item that exists in the franchise account warehouse. The item should display the available quantity that corresponds to the seller inventory.

{"base64":"  ","img":{"width":683,"height":1281,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":232573,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Unified%20Commerce/VTEX%20Sales%20App/enabling-local-stock-sale-in-vtex-sales-app_1.png"}}

If you enabled Unlimited inventory, the item quantity will display as a number greater than one million, which can't be changed when a sale is completed.

Enabling selling an out-of-stock item (optional)

You can also enable On Hands to ignore stock quantity and force item availability without having to enable unlimited inventory. To do this, follow the instructions below:

  1. Go to the Sales App technical settings using the URL below. Substitute main_account with the name of the main account of your store in the VTEX Admin: https://{main_account}.myvtex.com/admin/portal/#/sites
  2. Click the gear button to edit.
  3. Select the Code tab.
  4. In the side tab, select the checkout-instore-custom-js file.
    {"base64":"  ","img":{"width":1345,"height":800,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":462741,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Unified%20Commerce/VTEX%20Sales%20App/enabling-local-stock-sale-in-vtex-sales-app_2.png"}}
  5. In the window.INSTORE_CONFIG key, add the sellWithoutStockInHands: true flag.
    {"base64":"  ","img":{"width":1368,"height":559,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":276619,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Unified%20Commerce/VTEX%20Sales%20App/enabling-local-stock-sale-in-vtex-sales-app_3.png"}}
  6. Click Save.

Enabling mixed cart sales (optional)

A mixed cart sale is a sale that contains items that the customer is going to pick up at the store when shopping and items that will be delivered to their home. This functionality is configured by default in VTEX stores. To learn more about this feature, read Order split and delivery split.

Integrating the point of sale

Lastly, to complete the sale of an on-hand item, a tax receipt must be issued. The sales associate might want to update the local inventory of the point of sale with the information from this sale. To solve this, you need to integrate your point of sales. You can learn more in our Integrating Local stock sale article.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback