A VTEX considera como receita da loja o valor total dos pedidos aprovados no fluxo da transação de pagamentos e a partir disso realiza o cálculo da fatura. No entanto, é possível que taxas diferentes incidam sobre pedidos de mesmo valor, pois o módulo de cobranças atua com base em marcações.
Marcações são categorias que definem as características do pedido e sinalizam as regras de negócio aplicadas na venda. O pedido é analisado segundo determinados critérios e recebe as marcações que definem qual o take rate a ser cobrado.
Este artigo apresenta quais são as marcações existentes no módulo de cobranças. Ao disponibilizarmos este conteúdo, o nosso objetivo é aumentar a transparência da sua relação comercial com a VTEX.
O sistema de marcações de pedidos não realiza qualquer tipo de cobrança aos clientes da loja. Ele é somente uma fonte de dados que o módulo de cobranças consulta para realizar o cálculo da fatura.
Etapa inicial para marcação de pedidos
Para que um pedido seja passível de marcação, ele deve atender às seguintes condições:
- Ter todas as informações que constituem o pedido (pedidos incompletos não recebem marcações).
- Possuir informação de pagamento com data de autorização da transação financeira.
Pedidos gerados pelo Multilevel Omnichannel Inventory (MOI), chamados de pedidos chain, não possuem informação de pagamento. Portanto, eles não recebem marcações e não são passíveis de cobrança.
Alteração de pedidos e marcações
O pedido é marcado somente após finalizado. No entanto, quando um pedido é alterado, ele é submetido a uma nova marcação, pois a alteração pode ter impactado as condições do take rate a ser cobrado.
O pedido pode ser alterado diversas vezes e isso resultar em mudanças nas marcações feitas pelo módulo de cobranças. Enquanto estiver no status
preparando entrega
, o pedido pode continuar este processo de ser alterado e ter as marcações atualizadas.
Grupos de marcações
Na VTEX, as marcações são categorizadas em três grupos principais:
- Marcações por canal de venda: relativo ao canal no qual o pedido é gerado.
- Marcações por origem do pedido: referente ao contexto de marketplace e seller.
- Marcações por tipo de cliente: diz respeito à natureza jurídica do cliente, se pessoa física ou jurídica.
As próximas seções apresentam detalhes sobre cada um desses grupos.
Marcações por canal de venda
Veja a seguir quais marcações existem relacionadas ao canal no qual o pedido é gerado:
-
IsInStore: solução VTEX Sales App.
-
IsInfiniteShelf: funcionalidade Prateleira Infinita do VTEX Sales App quando o item do inventário não estava armazenado localmente.
-
IsSalesAppDeliveredByMainAccount: solução VTEX Sales App quando o item vendido pertencia à conta principal e a venda foi realizada no ambiente da conta principal.
-
IsSocialSelling: funcionalidade Carrinho Compartilhável (Social Selling).
A marcação
IsSocialSelling
é válida somente para os pedidos de Carrinho Compartilhável (Social Selling) que foram iniciados pelo VTEX Sales App. -
IsCallCenter: solução VTEX Sales App quando a venda foi promovida por um vendedor, atendente ou consultor, como ocorre com televendas.
-
IsOnHands: solução VTEX Sales App quando o pedido foi realizado na loja física e o item do inventário estava armazenado localmente. Esta marcação é feita no ambiente do marketplace.
-
IsOnHandsFulfillment: solução VTEX Sales App quando o item vendido pertencia ao seller. Esta marcação é feita no ambiente do seller.
Quando a loja atua tanto como marketplace quanto seller, o pedido recebe a marcação
IsOnHandsFulfillment
.
Marcações por origem do pedido
A imagem abaixo apresenta como é feita a marcação do pedido com relação à origem do pedido para o marketplace e para o seller:

Mediante acordos comerciais, a VTEX concede um tipo de certificação a determinados canais de venda. Quando o pedido foi gerado em um canal de venda que não possui esse nível de certificação, não há uma marcação por origem e o pedido é marcado como
IsB2C
. Ou seja, somente canais de venda certificados possuem marcação por origem.
O fluxo a partir de IsMarketplace
existe para marcar os pedidos no ambiente do seller e o fluxo de IsSeller
para marcar os pedidos no ambiente do marketplace. Cada uma das marcações está descrita adiante.
Marketplace
Veja a seguir quais marcações existem para os pedidos no ambiente do seller com relação ao marketplace no qual o pedido foi criado:
- IsMarketplace: pedido gerado em um marketplace, seja ele marketplace certificado, marketplace parceiro, marketplace VTEX (loja atuou como marketplace) ou marketplace externo. Todo pedido
IsMarketplace
éIsCertifiedMarketplace
ou um marketplace externo, e esta primeira marcação existe apenas para fins de sistema. - IsCertifiedMarketplace: pedido gerado em marketplace certificado, marketplace parceiro ou marketplace VTEX (loja atuou como marketplace). Após receber esta marcação, o pedido necessariamente receberá a marcação
IsInternalCertifiedMarketplace
ouIsExternalCertifiedMarketplace
.- IsExternalCertifiedMarketplace: pedido gerado em marketplace certificado (Amazon, Mercado Livre, entre outros), ou marketplace parceiro (Shopee, Facebook, entre outros).
- IsInternalCertifiedMarketplace: pedido gerado em marketplace VTEX, ou seja, a loja atuou como marketplace para um seller. Esta marcação pode ou não incluir um outro nível de marcação.
- IsInternalCertifiedMarketplaceAndIsParentAccount: pedido gerado em marketplace VTEX quando o marketplace é conta principal e o seller sua subconta, ou seja, seu ambiente adicional.
Seller
Veja a seguir quais marcações existem para os pedidos no ambiente do marketplace com relação ao seller que possui o item vendido:
- IsSeller: pedido gerado em marketplace quanto o item vendido pertence ao seller. Todo pedido
IsSeller
é necessariamenteIsExternalSeller
ouIsCertifiedSeller
, e esta primeira marcação existe apenas para fins de sistema. - IsExternalSeller: pedido gerado em um marketplace VTEX (loja atuou como marketplace) no qual o seller que possui o item vendido é um seller externo.
- IsCertifiedSeller: pedido gerado em marketplace certificado, marketplace parceiro ou marketplace VTEX (loja atuou como marketplace) no qual o seller que possui o item vendido é seller VTEX. Todo pedido
IsCertifiedSeller
é necessariamente tambémIsInternalCertifiedSeller
.- IsInternalCertifiedSeller: esta marcação existe apenas para fins de sistema, sendo que todo pedido
IsInternalCertifiedSeller
necessariamente receberá a marcaçãoIsInternalCertifiedSellerAndIsChildAccount
ouIsSellerPortal
.- IsInternalCertifiedSellerAndIsChildAccount: pedido gerado em marketplace VTEX no qual o marketplace é uma conta principal e o seller que possui o item vendido é sua conta franquia.
- IsSellerPortal: pedido gerado em marketplace VTEX no qual o marketplace é uma conta principal e o seller que possui o item vendido é sua conta Seller Portal.
- IsInternalCertifiedSeller: esta marcação existe apenas para fins de sistema, sendo que todo pedido
Marcações por tipo de cliente
Veja a seguir quais marcações existem relacionadas ao tipo de cliente do pedido:
- IsB2B: o cliente é pessoa jurídica e o pedido foi gerado no contexto B2B (Business to Business).
- IsB2C: o cliente é pessoa física e o pedido foi gerado no contexto B2C (Business to Customer).