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
- Acesse o PMS SaaS, menu Gestão de Receita - Gestão Tarifária - Acordo Comercial.
- 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.
- Em Dados Gerais, no campo Tipo do Acordo, selecione
Venda empresarial - B2BouGDS/WS. Os quadros de clientes e de comissões só aparecem nesses dois tipos. O tipoVenda direta - B2Cnão tem comissão.
- 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.
-
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, comoA FATURARe 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.
-
Nome do serviço: o serviço sobre o qual a comissão incide, por exemplo
- Clique em Confirmar, no final da tela Editar Acordo Comercial, para gravar o acordo.
Parte 2 - Integração com o Backoffice
-
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.
- No TOTVS Backoffice, acesse o módulo Global CM, menu Plugin - Thex - Integração - Integrador. Abre o Plugin Integrador (tela Interface BT).
- 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.
- 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 paraVenda empresarial - B2BouGDS/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
0 Comentários