VTEX cuenta como ingresos de la tienda el valor total de los pedidos aprobados en el flujo de transacciones de pago y lo utiliza para calcular la factura. Sin embargo, puede que se apliquen diferentes cargos a pedidos con el mismo valor, ya que el módulo de facturación se basa en tags.
Las tags son categorías que definen las características del pedido e indican las reglas de negocio aplicadas a la venta. El pedido se analiza en función de determinados criterios y se le asignan tags que definen el take rate que se cobrará.
Este artículo describe las tags del módulo de facturación. El objetivo de este contenido es aumentar la transparencia en tu relación comercial con VTEX.
El sistema de tags de pedidos no realiza ningún tipo de cobro a los clientes de la tienda. Solo es una fuente de datos consultada por el módulo de facturación para calcular la factura.
Pasos iniciales para la asignación de tags a pedidos
Para que se le puedan asignar tags, un pedido debe cumplir las siguientes condiciones:
- Tener toda la información que compone un pedido (no se les asignan tags a pedidos incompletos).
- Tener la información de pago con los datos de autorización de la transacción financiera.
Los pedidos generados por Multinivel Omnichannel Inventory (MOI), también conocidos como pedidos chain, no incluyen la información de pago y, por lo tanto, no se les asignan tags ni pueden ser cobrados.
Modificación de pedidos y tags
Las tags solo se asignan a un pedido una vez que ha sido finalizado. Sin embargo, cuando un pedido se modifica, las tags se vuelven a procesar, ya que el cambio puede afectar las condiciones del take rate que se cobrará.
El pedido puede modificarse varias veces, lo que a su vez puede resultar en cambios en las tags asignadas por el módulo de facturación. Mientras el pedido tiene el status
esperando fulfillment
, se pueden realizar modificaciones y actualizar las tags.
Grupos de tags
En VTEX, las tags se clasifican en tres grupos principales:
- Tags de canal de venta: indica el canal por el que se genera el pedido.
- Tags de origen del pedido: indica el contexto de marketplace y seller.
- Tags de tipo de cliente: indica la naturaleza jurídica del cliente, si es persona física o jurídica.
Las próximas secciones describen cada uno de estos grupos.
Tags de canal de venta
A continuación se listan las tags de los canales de venta que generan el pedido:
-
IsInStore: solución VTEX Sales App.
-
IsInfiniteShelf: funcionalidad Pasillo infinito de VTEX Sales App. Esta tag se aplica cuando el ítem del stock que fue vendido no estaba almacenado localmente.
-
IsSalesAppDeliveredByMainAccount: solución VTEX Sales App. Esta tag se aplica cuando el ítem vendido pertenecía a la cuenta principal y la venta se realizó en el entorno de la cuenta principal.
-
IsSocialSelling: aplicación Carrito compartido (Social Selling).
La tag
IsSocialSelling
solo es válida para los pedidos de Carrito compartido (Social Selling) iniciados por VTEX Sales App. -
IsCallCenter: solución VTEX Sales App. Esta tag se aplica cuando la venta fue promovida por un vendedor, agente o consultor, como es el caso de televentas.
-
IsOnHands: solución de VTEX Sales App. Esta tag se aplica cuando el pedido se realizó en una tienda física y el ítem del stock estaba almacenado localmente. Esta tag se asigna en el entorno del marketplace.
-
IsOnHandsFulfillment: solución VTEX Sales App. Esta tag se aplica cuando el ítem vendido pertenecía al seller. Esta tag se asigna en el entorno del seller.
Cuando la tienda opera como marketplace y seller, se le asigna la tag
IsOnHandsFulfillment
al pedido.
Tags de origen del pedido
La siguiente imagen muestra como se asignan las tags de origen de pedido en el caso de marketplaces y sellers:

A través de acuerdos comerciales, VTEX otorga un tipo de certificación a determinados canales de venta. Cuando el pedido se generó en un canal de venta que no tiene este nivel de certificación, no hay tag de pedido por origen y el pedido se marca como
IsB2C
. Es decir, sólo los canales de venta certificados están marcados por origen.
El flujo de IsMarketplace
marca pedidos en el entorno del seller y el flujo IsSeller
marca pedidos en el entorno del marketplace. Todas las tags de los flujos se describen a continuación.
Marketplace
A continuación se listan las tags para pedidos en el entorno del seller asociadas al marketplace en el que se creó el pedido:
- IsMarketplace: pedido generado en un marketplace, ya sea marketplace certificado, marketplace partner, marketplace VTEX (tienda actuando como marketplace) o marketplace externo. Todo pedido
IsMarketplace
esIsCertifiedMarketplace
o un marketplace externo. Esta primera tag es para el sistema. - IsCertifiedMarketplace: pedido generado en un marketplace certificado, marketplace partner o marketplace VTEX (tienda actuando como marketplace). Después de que se le asigna esta tag al pedido, el próximo paso obligatorio es asignarle
IsInternalCertifiedMarketplace
oIsExternalCertifiedMarketplace
.- IsExternalCertifiedMarketplace: pedido generado en un marketplace certificado (Amazon, Mercado Libre, entre otros) o marketplace partner (Shopee, Facebook, entre otros).
- IsInternalCertifiedMarketplace: pedido generado en un marketplace VTEX, es decir, en una tienda actuando como marketplace para un seller. Esta tag puede incluir otro nivel opcional de tags.
- IsInternalCertifiedMarketplaceAndIsParentAccount: pedido generado en un marketplace VTEX donde el marketplace es la cuenta principal y el seller es una subcuenta, es decir, es un entorno adicional.
Seller
A continuación se listan las tags de pedidos en el entorno del marketplace asociadas al seller propietario del ítem vendido:
- IsSeller: pedido generado en un marketplace cuando el ítem vendido pertenece al seller. Todo pedido
IsSeller
es por obligaciónIsExternalSeller
oIsCertifiedSeller
. Esta primera tag es para el sistema. - IsExternalSeller: pedido generado en un marketplace VTEX (tienda actuando como marketplace) donde el seller propietario del ítem vendido es un seller externo.
- IsCertifiedSeller: pedido generado en marketplace certificado, marketplace partner o marketplace VTEX (tienda actuando como marketplace) donde el seller propietario del ítem vendido es un seller VTEX. Todo pedido
IsCertifiedSeller
es por obligaciónIsInternalCertifiedSeller
.- IsInternalCertifiedSeller: esta tag es para el sistema, ya que a todo pedido
IsInternalCertifiedSeller
debe obligatoriamente asignársele la tagIsInternalCertifiedSellerAndIsChildAccount
oIsSellerPortal
.- IsInternalCertifiedSellerAndIsChildAccount: pedido generado en un marketplace VTEX donde el marketplace es una cuenta principal y el seller propietario del ítem vendido es una cuenta franquicia.
- IsSellerPortal: pedido generado en un marketplace VTEX donde el marketplace es una cuenta principal y el seller propietario del ítem vendido es una cuenta Seller Portal.
- IsInternalCertifiedSeller: esta tag es para el sistema, ya que a todo pedido
Tags de tipo de cliente
A continuación se listan las tags de tipo de cliente del pedido:
- IsB2B: el cliente es una persona jurídica y el pedido se generó en un escenario B2B (Business to Business).
- IsB2C: el cliente es una persona física y el pedido se generó en un escenario B2C (Business to Customer).