Menu
Feedback
Comece aqui
Tutoriais
Portal do desenvolvedor

Problemas conhecidos
Diretivas de suporte
Troubleshooting

Perguntas frequentes
Comunicados
Tutoriais
Tutoriais
Explore tutoriais detalhados para operar sua loja VTEX.
Tutoriais
Faturas
Contratos
Marcações de pedidos pelo módulo de cobranças
Marcações de pedidos pelo módulo de cobranças
6 min de leitura

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:

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:

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:

{"base64":"  ","img":{"width":4167,"height":2209,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":158756,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Billing/Contracts/marcacoes-de-pedidos-pelo-modulo-de-cobrancas_1.png"}}

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 ou IsExternalCertifiedMarketplace.
    • 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 é necessariamente IsExternalSeller ou IsCertifiedSeller, 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ém IsInternalCertifiedSeller.
    • IsInternalCertifiedSeller: esta marcação existe apenas para fins de sistema, sendo que todo pedido IsInternalCertifiedSeller necessariamente receberá a marcação IsInternalCertifiedSellerAndIsChildAccount ou IsSellerPortal.
      • 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.

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).
Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Isso foi útil?
Sim
Não
Sugerir edições (GitHub)
Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Nesta página
Ainda tem dúvidas?
Pergunte à comunidade
Encontre soluções e compartilhe ideias na comunidade VTEX.
Junte-se à nossa comunidade
Solicite suporte à VTEX
Para assistência personalizada, entre em contato com nossos especialistas.
Abra um ticket de suporte
GithubDeveloper portalComunidadeFeedback