Menu
Feedback
Comece aqui


Tutoriais
Explore tutoriais detalhados para operar sua loja VTEX.
Tutoriais
Faturas
Contratos
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)
Contas a pagar - Internacional
« Previous
Dados cadastrais
Next »
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