Base de conhecimento
Encontre respostas para suas dúvidas em quatro fontes de conhecimento diferentes ao mesmo tempo, simplificando o processo de pesquisa.

Hotelaria - PMS SaaS - Como funciona a comissão de agências e operadoras no PMS SaaS: onde ela é cadastrada, quando é gerada, como o valor é calculado e onde é consultada?

time.png Tempo aproximado para leitura: 00:08:00 min

 

Dúvida
Como funciona a comissão de agências e operadoras no PMS SaaS: onde ela é cadastrada, quando é gerada, como o valor é calculado e onde é consultada?

 

Ambiente
TOTVS Hospitalidade - PMS SaaS - versão 12.1.2611.1
Integração com o TOTVS Backoffice (Linha CMNET): Global CM 12.01.2609.01, Plugin Integrador (Interface BT Integrador 6.26.10.03), Fatura Hotel e Contas a Pagar

 

Solução
Para solucionar essa dúvida, realize os seguintes passos:

 

A comissão de uma agência ou operadora de turismo é cadastrada no Acordo Comercial do PMS SaaS, como um percentual sobre um serviço (por exemplo, a diária).
O PMS SaaS calcula o valor da comissão das contas pagas diretamente no hotel e envia esse valor ao Fatura Hotel pela integração Comissão Balcão. No Fatura Hotel, a comissão é controlada e enviada ao Contas a Pagar.

 

Parte 1 - Cadastro da comissão no acordo comercial

  1. Acesse o PMS SaaS, menu Gestão de Receita - Gestão Tarifária - Acordo Comercial.

 

 

  1. Na tela Consulta por Acordo Comercial, digite o nome do acordo da agência no campo de pesquisa e abra o acordo para edição. Se o acordo ainda não existir, clique em Incluir Acordo.

 

 

  1. Em Dados Gerais, no campo Tipo do Acordo, selecione Venda empresarial - B2B ou GDS/WS. Os quadros de clientes e de comissões só aparecem nesses dois tipos. O tipo Venda direta - B2C não tem comissão.

 

 

  1. No quadro Clientes / Postos associados, clique em Associar cliente / posto e associe a agência ou operadora que vai usar o acordo. A agência precisa estar cadastrada antes em Cadastros - Cliente.
  2. No quadro Comissões, clique em Associar Comissão e preencha os dois campos, ambos obrigatórios:

    • Nome do serviço: o serviço sobre o qual a comissão incide, por exemplo Diária. É o mesmo serviço lançado na conta. A lista também mostra formas de pagamento, como A FATURAR e as bandeiras de cartão: não as selecione.
    • Percentual da comissão: o percentual do contrato com a agência. Precisa ser maior que 0, e o máximo aceito é 99; um valor acima disso é ajustado para 99 pela tela.

    Clique em Confirmar. A comissão aparece na lista do quadro, com o Serviço e o Percentual da comissão. Cada serviço aceita uma única comissão por acordo. Para comissionar outros serviços, como alimentos e bebidas, repita este passo para cada um.

 

 

 

  1. Clique em Confirmar, no final da tela Editar Acordo Comercial, para gravar o acordo.

 

Parte 2 - Integração com o Backoffice

  1. Acesse o menu Integração - Correlacionamento e clique em Acordo comercial.

    • No parceiro de distribuição (por exemplo, DISTRIBUIÇÃO GERAL), clique nos três pontos - Editar card e depois em Adicionar código.
    • Vincule o Acordo Comercial ao Rate Plan usando o mesmo código cadastrado no Fatura Hotel, em Cadastro - Contrato - Contrato Padrão, guia Rateplan.
    • Clique em Salvar.

    Sem esse vínculo, a comissão do acordo não é enviada ao Backoffice.

 

 

  1. No TOTVS Backoffice, acesse o módulo Global CM, menu Plugin - Thex - Integração - Integrador. Abre o Plugin Integrador (tela Interface BT).

 

 

  1. Faça a configuração no Plugin Integrador:
    • No menu lateral, abra Configurações - Parâmetros.
    • Em Parâmetros Interface BT, selecione a aba Thex PMS e a guia Parâmetros de Integração.
    • No grupo Financeiro de Habilitar a integração de Dados, marque a opção Comissão Balcão.
    • Clique em Confirmar.

 

 

  1. Para conferir as comissões recebidas do PMS SaaS, acesse o módulo Fatura Hotel, menu Controle de Comissão - Lançamento de Comissão. A tela Lançamentos de Comissão vindos do Front mostra a agência e o hóspede. Para gerar o documento no Contas a Pagar, use o menu Controle de Comissão - Controle das NF's Recebidas.

 

Quando o PMS SaaS gera a comissão
Cadastrar a comissão no acordo não basta para gerá-la. A integração Comissão Balcão consulta o PMS SaaS pela data do sistema e só traz a conta que atende todas as condições abaixo:

Condição O que conferir na reserva ou na conta
Acordo da reserva A reserva usa um acordo do tipo Venda empresarial - B2B ou GDS/WS, com comissão cadastrada (passos 3 a 6) e correlacionado ao parceiro (passo 7).
Cliente na conta A conta está vinculada a um cliente (agência ou empresa). A conta individual do hóspede (tipo Hóspede) não entra.
Conta fechada A conta está com status Fechada.
Nota fiscal emitida A conta tem nota fiscal de serviço (NFS-e) ou nota fiscal eletrônica (NF-e) emitida.
Pagamento direto Na data consultada, a conta recebeu um pagamento por uma forma diferente de A Faturar, ou seja, foi paga no balcão.

 

Cálculo: a base é a soma dos lançamentos do serviço comissionado na nota fiscal, sem os lançamentos estornados. O valor da comissão é a base multiplicada pelo Percentual da comissão do acordo.
Exemplo: uma nota com R$ 1.000,00 de diárias e comissão de 10% sobre o serviço Diária gera R$ 100,00 de comissão.
Uma nota cancelada sem lançamentos válidos também é enviada, para que o Backoffice trate o cancelamento. Contas pagas somente com A Faturar seguem o faturamento no Fatura Hotel e não fazem parte da Comissão Balcão.

 

Problemas comuns

  • O quadro Comissões não aparece no acordo: o Tipo do Acordo está como Venda direta - B2C. Altere para Venda empresarial - B2B ou GDS/WS.
  • A comissão não chegou ao Fatura Hotel: confira as condições da tabela "Quando o PMS SaaS gera a comissão". As causas mais comuns são:
    • conta ainda aberta;
    • nota fiscal não emitida;
    • conta paga com A Faturar;
    • conta só do hóspede, sem cliente;
    • acordo sem correlacionamento (passo 7);
    • opção Comissão Balcão desmarcada no Plugin Integrador (passo 9).
  • A comissão de um serviço veio com valor zero ou não veio: a comissão incide só sobre o serviço associado no quadro Comissões. Lançamentos de outros serviços não entram na base.

 

Saiba mais
TDN Integrações PMS - Comissão Balcão, atualizada em 28/07/2025: Integrações PMS - Comissão Balcão
Central de Atendimento, atualizado em 29/09/2025: Conferir o Rateplan para Integração de faturas para o Módulo Fatura Hotel

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

0 Comentários

Por favor, entre para comentar.
X Fechar

Olá ,

Há pendência referente a um de seus produtos contratados para a empresa ().

Entre em contato com o Centro de Serviços TOTVS para tratativa.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cobrança – Verificação de pendências financeiras . clique aqui.

TOTVS

X Fechar

Olá ,

Seu contato não está cadastrado no Portal do Cliente como um perfil autorizado a solicitar consultoria telefônica.

Por gentileza, acione o administrador do Portal de sua empresa para: (1)configurar o seu acesso ou (2)buscar um perfil autorizado para registro desse atendimento.

Em caso de dúvidas sobre a identificação do contato administrador do Portal, ligue (11) 4003-0015, opção 7 e, em seguida, opção 4 para buscar o suporte com o time de Assessoria ao Portal do Cliente. . clique aqui.

TOTVS

X Fechar

Olá ,

Para o atendimento de "Consultoria Telefônica" você deverá estar de acordo com o Faturamento.

TOTVS

X Fechar

Olá,

Algo inesperado ocorreu, e o usuario nao foi reconhecido ou você nao se encontra logado

Por favor realize um novo login

Em caso de dúvidas, entre em contato com o administrador do Portal de Clientes de sua empresa para verificação do seu usuário, ou Centro de Serviços TOTVS.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cadastros . clique aqui.

TOTVS

Chat _

Preencha os campos abaixo para iniciar o atendimento:

Chat _