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
Billing
Contracts
Consumption tags used in the billing module
Consumption tags used in the billing module
6 min read

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:

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:

{"base64":"  ","img":{"width":4167,"height":2209,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":159769,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Billing/Contracts/consumption-tags-used-in-the-billing-module_1.png"}}

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 either IsCertifiedMarketplace 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 or IsExternalCertifiedMarketplace 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 either IsExternalSeller or IsCertifiedSeller, 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 the IsInternalCertifiedSeller tag.
    • IsInternalCertifiedSeller: This tag is used for system purposes only. Every IsInternalCertifiedSeller order will also receive the IsInternalCertifiedSellerAndIsChildAccount or IsSellerPortal 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.

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.
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