VTEX considers the total amount of orders approved in the payment transaction flow as the store revenue and calculates the invoice accordingly. However, different rates may apply to orders of the same value because the billing module operates based on tags.
Consumption tags are categories that define the characteristics of an order and indicate the business rules applied to the sale. The order is analyzed based on specific criteria and is assigned tags that determine the take rate to be charged.
This article presents the existing tags in the billing module. By providing this content, we aim to increase transparency in your commercial relationship with VTEX.
The order tagging system does not charge your store's customers in any way. It serves only as a data source that the billing module uses to calculate the invoice.
First steps for assigning consumption tags
For an order to be tagged, it must meet the following conditions:
- Have all order details (incomplete orders do not receive tags).
- Have payment information, including the authorization date of the financial transaction.
Orders placed through Multilevel Omnichannel Inventory (MOI), known as chain orders, do not include payment information. Therefore, they cannot be tagged or charged.
Changing orders and tags
The order is only tagged once it is completed. However, if the order is changed, it is tagged again, as the change may impact the conditions affecting the take rate to be charged.
You can change an order multiple times, which may result in updates to the tags applied by the billing module. While the order is in the
Awaiting fulfillment
status, this process of changes and tag updates can continue.
Tagging groups
On VTEX, tags are categorized into three main groups:
- Tags by sales channel: Refers to the channel where the order is placed.
- Tags by order origin: Refers to the marketplace and seller context.
- Tags by customer type: Refers to the legal status of the customer, whether an individual or a company.
The following sections provide details about each of these groups.
Tags by sales channel
Below are the tags related to the channel through which the order is placed:
-
IsInStore: For orders placed through VTEX Sales App.
-
IsInfiniteShelf: For orders placed through VTEX Sales App endless aisle feature; used when the inventory item is not stored locally.
-
IsSalesAppDeliveredByMainAccount: For orders placed through VTEX Sales App; used when the item sold belongs to the main account and the sale is made within the main account environment.
-
IsSocialSelling: For orders placed through Social Selling.
The
IsSocialSelling
tag is only valid for Social Selling orders placed through VTEX Sales App. -
IsCallCenter: For orders placed through VTEX Sales App; used when the sale was promoted by a sales associate, attendant, or consultant, as in telesales.
-
IsOnHands: For orders placed through VTEX Sales App; used when the order was placed in the physical store and the inventory item was stored locally. This tag is applied in the marketplace environment.
-
IsOnHandsFulfillment: For orders placed through VTEX Sales App; used when the item sold belongs to the seller. This tag is applied in the seller environment.
When the store acts as both a marketplace and a seller, the order is tagged as
IsOnHandsFulfillment
.
Tags by order origin
The image below shows how the order is tagged based on its origin, both for the marketplace and the seller:

Due to commercial agreements, VTEX grants a type of certification to certain channels. When an order is generated in a channel that does not have this level of certification, there are no consumption tags by origin, and the order is tagged as
IsB2C
. In other words, only certified channels have consumption tags by origin.
The flow from IsMarketplace
tags orders in the seller environment, while the flow from IsSeller
tags orders in the marketplace environment. Each of these tags is described below.
Marketplace
See below the tags available for orders in the seller environment, depending on the marketplace where the order was placed:
- IsMarketplace: The order was created in a marketplace — this could be a certified marketplace, partner marketplace, VTEX marketplace (store acting as the marketplace), or an external marketplace. Every
IsMarketplace
order will be tagged as eitherIsCertifiedMarketplace
or will be an external marketplace. This initial tag is only for system purposes. - IsCertifiedMarketplace: The order was placed in a certified marketplace, partner marketplace, or VTEX marketplace (store acting as a marketplace). Once the order is assigned this tag, it receives either the
IsInternalCertifiedMarketplace
orIsExternalCertifiedMarketplace
tag.- IsExternalCertifiedMarketplace: The order was placed in a certified marketplace (Amazon, Mercado Libre, etc.) or a partner marketplace (Shopee, Facebook, etc.).
- IsInternalCertifiedMarketplace: The order was placed in a VTEX marketplace, so the store acted as a marketplace for a seller. This tag may include another tagging level.
- IsInternalCertifiedMarketplaceAndIsParentAccount: The order was placed in a VTEX marketplace where the marketplace is the main account, and the seller is a subaccount (i.e., an additional environment).
Seller
See below the consumption tags available in the marketplace environment, depending on the seller that sold the order:
- IsSeller: The order was placed in a marketplace where the item sold belongs to the seller. Every
IsSeller
order will necessarily be tagged as eitherIsExternalSeller
orIsCertifiedSeller
, and this initial tag is only for system purposes. - IsExternalSeller: The order was placed in a VTEX marketplace (store acting as a marketplace), and the seller of the item is an external seller.
- IsCertifiedSeller: The order was placed in a certified marketplace, partner marketplace, or VTEX marketplace (store acting as a marketplace) in which the seller who owns the item sold is a VTEX seller. Every
IsCertifiedSeller
order will also have theIsInternalCertifiedSeller
tag.- IsInternalCertifiedSeller: This tag is used for system purposes only. Every
IsInternalCertifiedSeller
order will also receive theIsInternalCertifiedSellerAndIsChildAccount
orIsSellerPortal
tag.- IsInternalCertifiedSellerAndIsChildAccount: The order was placed in a VTEX marketplace where the marketplace is the main account, and the seller of the sold item is its franchise account.
- IsSellerPortal: The order was placed in a VTEX marketplace where the marketplace is the main account, and the seller of the item is its Seller Portal account.
- IsInternalCertifiedSeller: This tag is used for system purposes only. Every
Tags by customer type
Below are the tags related to the order customer type:
- IsB2B: The customer is a legal entity, and the order was placed in the B2B (Business to Business) context.
- IsB2C: The customer is an individual, and the order was placed in the B2C (Business to Customer) context.