Motel Mais

Finanças Web v20 - Orçamento na Grade Anual, Tabelas Novas, Histórico de Alterações e Dashboard por Mês

2026-10-15T12:39:33Z

A versão 20.0.0 do Finanças Web gira em torno do orçamento. Agora dá para definir o orçamento de um grupo direto da Grade Anual, do Fechamento Mensal e da Grade Mensal, no grupo principal ou em cada subgrupo. A Grade Anual mostra, em cada mês, quanto do orçamento já foi usado, ganhou um resumo mensal do orçamento e a impressão em PDF. O Fechamento Mensal e a Grade Mensal ganharam tabelas novas. A página inicial passou a reunir o Dashboard e as Opções, e o Dashboard agora mostra também os meses anteriores. Despesas e receitas ganharam um histórico de alterações, e há mudanças em algumas permissões.

🏠 Página inicial: Dashboard e Opções na mesma tela

A página inicial tem agora um seletor no topo com duas visões:

Dashboard: os gráficos e cartões do mês, com os destaques do dia e as últimas atividades ao lado;
Opções: os atalhos de sempre para receitas, despesas, relatórios e cadastros.

O Finanças lembra a última visão escolhida por cada usuário e abre nela da próxima vez. O Dashboard aparece para quem tem a permissão Dashboard com Informações (Finanças → Dashboard). Sem ela, o usuário vê só as Opções, como antes.

A página inicial também avisa quando alguma forma de pagamento está sem mapeamento no envio automático de receitas. Nesse caso, o fechamento de caixa da Recepção não chega inteiro ao Finanças. Uma faixa amarela lista as formas (ou bandeiras) pendentes, e quem tem acesso às configurações pode clicar em Configurar mapeamentos para ir direto ao lugar certo.

📅 Dashboard: veja os meses anteriores

Uma barra flutuante, no pé do Dashboard, mostra o mês exibido. Use as setas para voltar ou avançar um mês. Fora do mês atual, a barra fica destacada e ganha o botão Mês atual, que traz tudo de volta para hoje. Não é possível avançar além do mês atual.

Ao trocar o mês, todos os cartões acompanham: os gráficos de evolução mostram os 12 meses até o mês escolhido, e as pizzas, o Resultado Operacional, o Resumo Finanças, os Maiores Pagamentos por Fornecedor, o Resumo Contas, os Alertas de Orçamento e a Curva ABC passam a ser daquele mês. O subtítulo de cada cartão mostra o período, como "Setembro de 2026" ou "12 meses até set/2026". Os destaques do dia e as últimas atividades, na coluna da esquerda, continuam mostrando o dia de hoje.

💰 Defina o orçamento de onde você estiver

Até agora, o orçamento (previsão) dos grupos só era definido na Grade Mensal. Agora ele pode ser ajustado em três lugares:

Grade Anual: em qualquer mês de um grupo. Passe o mouse na célula e clique no botão …, ou clique no selo de orçamento do mês (veja abaixo);
Fechamento Mensal: na coluna Previsão, pelo botão …;
Grade Mensal: também na coluna Previsão.

A janela Orçamento tem dois modos:

Só o mês: muda apenas o orçamento do mês escolhido. A janela mostra o valor atual como referência;
Ano todo: você digita o total do ano e a janela mostra quanto fica por mês, dividindo o valor nos 12 meses. Quando a divisão não fecha nos centavos, a diferença vai para dezembro. Como esse modo substitui o orçamento dos 12 meses do grupo, o Finanças pede uma confirmação antes de aplicar.

Depois de salvar, a tela se atualiza sozinha com o novo orçamento.

No grupo principal ou nos subgrupos

Você escolhe onde definir o orçamento: direto no grupo principal ou em cada um dos subgrupos. Por exemplo:

Encargos Gerais, com orçamento só nos subgrupos: Encargos Trabalhistas com 1.000 e Salários com 2.000. O orçamento de Encargos Gerais passa a ser 3.000, a soma dos dois;
Outros Gastos, com 4.000 definidos no próprio grupo e nada nos subgrupos Plano de Saúde e Vale-Transporte. O orçamento do grupo é 4.000.

Se o orçamento for definido nos dois lugares, vale o maior: o do grupo principal ou a soma dos subgrupos. A janela Orçamento mostra o valor definido no grupo e quanto os subgrupos somam no mês.

A regra vale em todo o Finanças Web: na Grade Anual, no Fechamento Mensal, na Grade Mensal (inclusive no Crédito acumulado) e nos Alertas de Orçamento do Dashboard. Passe o mouse no orçamento de um grupo para ver de onde ele vem, se do próprio grupo ou da soma dos subgrupos. O gasto do grupo principal sempre inclui o que foi gasto nos subgrupos.

📊 Grade Anual: tabela nova e o orçamento em cada mês

A tabela da Grade Anual foi redesenhada no mesmo estilo do Fechamento Mensal:

Receitas, Despesas e Despesas Não Operacionais têm cada uma a sua cor. Os grupos principais aparecem em destaque e os subgrupos ficam recuados logo abaixo;
ao rolar a página, o cabeçalho dos meses fica preso no topo. Ao rolar para o lado, a coluna dos grupos fica presa à esquerda;
a coluna do mês atual fica destacada no cabeçalho;
Prev. anual, Realizado anual e Saldo anual formam um bloco separado. O saldo aparece numa etiqueta verde (sobra) ou vermelha (estouro);
o rodapé traz o Subtotal (receitas menos despesas operacionais) e o Resultado do ano.

O orçamento na borda de cada célula

Quando o grupo tem orçamento no mês, a célula ganha um selo na borda de cima, logo acima do valor, como "Orç. 10.000". O fundo do selo vai sendo pintado conforme o orçamento é usado. A cor mostra a situação:

Despesas: verde quando o gasto está dentro do orçamento e vermelho quando passou dele;
Receitas: verde quando a receita atingiu o orçamento. Abaixo dele, o selo fica vermelho só nos meses já encerrados;
Cinza: mês em andamento, ou ainda sem lançamentos.

Passe o mouse no selo para ver o orçamento, o realizado com o percentual usado e quanto sobrou ou estourou. Clique no selo para alterar o orçamento daquele mês.

Na linha Total de cada seção, o orçamento só aparece quando todos os grupos principais da seção têm orçamento: no mês, para o selo, e no ano, para a Prev. anual e o Saldo anual. Assim o total nunca compara o orçamento de alguns grupos com o gasto de todos.

Resumo mensal do orçamento

Logo abaixo dos cartões do ano, a Grade Anual mostra um resumo do orçamento das despesas e despesas não operacionais, com um cartão para cada mês. Entram só os grupos principais que têm orçamento naquele mês, com o gasto dos subgrupos somado. Os grupos sem orçamento ficam de fora, para não misturar o que foi planejado com o que não foi.

Cada mês mostra quanto foi gasto, de quanto estava orçado, o percentual usado e uma barra:

verde: dentro do orçamento;
amarela: já usou 90% ou mais do orçamento;
vermelha: passou do orçamento.

Embaixo aparece quanto sobrou nos meses encerrados, quanto ainda resta no mês atual e nos próximos, ou o estouro. O mês atual fica destacado. No topo do resumo ficam o orçado, o realizado e o saldo do ano. Passe o mouse num mês para ver, grupo a grupo, o que entrou na conta.

Nos cartões do topo da Grade Anual, o Real x Prev segue a mesma ideia: compara só os grupos que têm orçamento, mês a mês. No cartão do Resultado, ele soma os três cartões de cima.

Para ver a grade mais enxuta, desligue Exibir → Orçamento na barra do topo. Os selos somem e as linhas voltam à altura compacta. A escolha fica salva para o seu usuário. Na visão Agrupado por Marcadores não há orçamento, já que ele é definido por grupo. Por isso, nessa visão as colunas Prev. anual e Saldo anual ficam vazias, os cartões do topo mostram só o realizado e o resumo mensal do orçamento não aparece.

Impressão em PDF

O botão de exportar da Grade Anual ganhou a opção Impressão PDF. O arquivo sai em A4 deitado, com os mesmos filtros da tela: ano, situação, grupo ou marcador, receitas ou faturamento bruto. Ele traz os cartões do ano e a grade com todos os subgrupos abertos. Com Exibir → Orçamento ligado, o PDF também mostra os selos de orçamento, com uma legenda das cores no final.

🧾 Fechamento Mensal com tabela nova

A tabela do Fechamento Mensal também foi redesenhada:

cada seção tem a sua cor: Receitas (ou Faturamento) em verde, Despesas em vermelho e Despesas Não Operacionais em roxo, cada uma com a linha de total;
os grupos principais aparecem em destaque e os subgrupos ficam recuados;
a coluna % ganhou uma barrinha com o peso do grupo na seção;
na coluna Previsão, uma barrinha mostra quanto do orçamento já foi usado;
o Real x Prev. aparece numa etiqueta verde quando sobra orçamento e vermelha, com um sinal de alerta, quando estoura;
o cabeçalho fica preso no topo ao rolar a página;
para ver os lançamentos de um grupo, dê um duplo clique na linha ou use o botão Ver lançamentos, que aparece ao passar o mouse.

📋 Grade Mensal: mesma tabela, grupos zerados e PDF

A Grade Mensal passou a usar a mesma tabela do Fechamento Mensal, com uma coluna a mais: o Crédito acum., que mostra a sobra (ou o estouro) do orçamento somando os meses do ano até o mês escolhido. As receitas agora vêm antes das despesas, na tabela, nos cartões e no rodapé.

Exibir → Grupos zerados: mostra também os grupos sem valor nem previsão no período, para conferir o plano de contas inteiro. A opção fica salva e vale para o Excel, a página de impressão e o PDF;
Impressão PDF: nova opção no botão de exportar, com receitas, despesas e despesas não operacionais. No modo mensal, inclui a previsão, o real x previsão e o crédito acumulado.

🕓 Histórico de alterações de despesas e receitas

Ao abrir uma despesa ou receita para editar, o topo da janela mostra quem fez a última alteração, quando e por qual módulo. Ao lado fica o botão HISTÓRICO.

A janela de histórico lista as versões do lançamento, da mais nova para a mais antiga. Cada versão mostra se foi o cadastro ou uma alteração, há quanto tempo, quem fez e o que mudou, campo por campo, no formato "valor antigo → valor novo". Entram descrição, fornecedor (ou cliente), grupo, marcador, valor, vencimento, emissão, situação, forma de pagamento, parcela, nota fiscal, observação, anexo e conciliação OFX. Clique numa versão para ver todos os campos dela. A versão atual é marcada como ATUAL.

É o jeito mais rápido de responder perguntas como "quem mudou o vencimento desta conta?" ou "qual era o valor antes da correção?".

🔐 Permissões

Curva ABC de Despesas ganhou uma permissão própria, em Finanças → Relatórios. Antes, ela seguia a permissão Gerenciar de Despesas. Para usuários que não são administradores, marque a nova permissão no cadastro do usuário, no +Gerencial, para quem deve continuar vendo o relatório;
Retroatividade: as opções Edita Registros Últimos 15 Dias, Últimos 30 Dias e de Todos os Dias passaram a limitar só os lançamentos quitados. Lançamentos em aberto ou quitados parcialmente podem ser editados a qualquer momento. A regra vale para qualquer alteração: editar, quitar, estornar ou excluir;
Grupos sigilosos: para quem não tem permissão de ver grupos sigilosos, eles também deixam de aparecer na Curva ABC, nos Maiores Pagamentos por Fornecedor e na análise por IA do Fechamento Mensal. Um grupo sigiloso que só tem previsão, sem lançamentos, também fica oculto na Grade Mensal e no Fechamento Mensal.

✨ Outras correções

Grade Anual: os totais e o sinal da diferença nos cartões de despesa foram corrigidos;
Grade Anual: ao recolher um grupo, os subgrupos de terceiro nível também são escondidos. Antes eles continuavam aparecendo;
Grade Anual por marcadores: as colunas Prev. anual e Saldo anual podiam mostrar a previsão de um grupo que não tinha relação com o marcador. Agora elas ficam vazias nessa visão;
Grade Anual: em grupos com subgrupos dentro de subgrupos, o Realizado anual e o Saldo anual podiam contar duas vezes os lançamentos do nível mais baixo;
Grade Mensal: o Crédito acumulado dos grupos com subgrupos agora desconta o que foi gasto nos subgrupos. Antes, ele mostrava só a soma do orçamento dos meses;
Fechamento Mensal e Grade Mensal: quando um grupo operacional aparece entre as Despesas Não Operacionais por causa do marcador, o orçamento do grupo não vai mais junto para essa seção. Isso também acaba com alertas de orçamento indevidos no Dashboard.

A versão 20.0.0 já está disponível na sua conta do Finanças Web. Se precisar de ajuda para montar o orçamento do ano ou revisar as permissões da equipe, fale com o nosso suporte.

Estoque Web v12 - Emissão de NF-e, Vencimento de Produtos e Importação com Conferência

2026-10-01T17:40:34Z

A versão 12.0.0 do Estoque Web reúne tudo o que chegou desde a 11.2. A principal novidade é a emissão de NF-e pelo próprio Estoque Web, inclusive a NF-e de transferência entre unidades da rede. A versão também traz o controle de vencimento dos produtos, o prazo de entrega do fornecedor no cálculo da Lista de Compras, a conferência das importações de produtos por planilha e novos filtros por subgrupo.

🧾 Emissão de NF-e pelo Estoque Web

Agora dá para emitir a NF-e (modelo 55) sem sair do Estoque Web. A emissão de NF-e é um módulo contratado separadamente. Ela usa o mesmo emitente e as mesmas chaves do Invoicy que o Motel+ já usa para a NFC-e (configurados em Administrativo → NFC-e). Enquanto o módulo não estiver contratado e habilitado, a tela de NF-e mostra um aviso, e você pode montar rascunhos, mas não transmitir.

Listagem das notas

A tela fica em Movimentar → Emissão de NF-e, e também abre pelo card Emissão de NF-e da página inicial. Ela lista as notas do período e pode ser filtrada por situação (rascunhos, rejeitadas, erro no envio, autorizadas e canceladas), por origem (transferência entre unidades, nota de saída ou manual) e por texto (número, destinatário ou CNPJ). O botão Nova NF-e abre uma nota em branco.

Montando a nota

A NF-e começa como rascunho e pode ser salva e retomada depois. A tela é dividida em blocos:

Dados da nota: natureza da operação, tipo, finalidade, série e número. Com o número em 0, ele é preenchido automaticamente na transmissão, seguindo a numeração da série;
Destinatário: pode ser outra unidade da rede, um cliente do cadastro (botão Cliente do cadastro) ou dados digitados. O município pode ser pesquisado pelo nome, e o código IBGE é preenchido sozinho;
Itens: busque o produto pelo código ou pelo nome. Os dados fiscais (NCM, CFOP, CST e cClassTrib) vêm do cadastro do produto e podem ser ajustados item a item. Também dá para lançar um item manual, que não está no cadastro;
Transporte e pagamento e Informações adicionais.

Na parte de baixo ficam as ações. Validar lista o que falta preencher antes do envio, e Transmitir envia a nota à SEFAZ. Depois de autorizada, a nota pode ser consultada, o DANFE e o XML podem ser baixados e o cancelamento pode ser pedido pela própria tela.

NF-e de transferência entre unidades

Na tela Transferência entre Empresas da Rede, a opção Emitir NF-e de transferência ao transferir faz a transferência e já abre a NF-e pré-preenchida. O destinatário é a unidade de destino, os itens são os da transferência e os dados fiscais seguem os padrões de transferência da configuração. É só conferir e transmitir.

Nas notas de saída manuais, os detalhes da nota ganharam o botão EMITIR NF-E, que cria a NF-e a partir daquela saída. Depois da emissão, o botão vira VER NF-E e a situação da nota aparece nos detalhes.

Configuração

Depois de contratar o módulo NF-e, habilite a emissão em Sistema → Configuração, na seção Emissão de NF-e. Nela são definidos:

a série, o número da primeira NF-e e o ambiente. O ambiente de Homologação serve para fazer testes sem valor fiscal;
se a opção Emitir NF-e já vem marcada na tela de transferência;
os padrões gerais: natureza da operação, CFOP dentro e fora do estado e forma de pagamento. Eles só são usados quando o produto não tem o dado no cadastro;
os padrões da NF-e de transferência: natureza da operação, CFOP, CST de ICMS, PIS, COFINS e IBS/CBS e o cClassTrib;
o frete, a placa do veículo, as informações complementares e os e-mails que recebem os arquivos.

A tela já vem com padrões sugeridos para a transferência entre unidades. Mesmo assim, confirme os dados fiscais com o seu contador antes de emitir em produção.

A emissão de NF-e usa a permissão Nova Nota de Saída, do grupo Movimentar do Estoque.

📅 Vencimento de produtos

A nota de entrada ganhou um campo opcional de data de vencimento em cada item. Clique no ícone de calendário ao lado do total do item e escolha a data. Depois de preenchido, o ícone fica colorido, e a data aparece ao passar o mouse sobre ele.

Os vencimentos ficam na nova tela Principal → Vencimento de Produtos. Escolha o mês para ver os itens que vencem nele, com a quantidade, a data de vencimento, a data de entrada, o fornecedor e o usuário que lançou a nota. Os itens já vencidos aparecem destacados, e no celular a lista aparece em cartões.

A página inicial também avisa. Na seção Análise, um alerta mostra quantos itens vencem no mês atual, e um clique nele abre a tela de vencimentos.

A tela de vencimentos usa a permissão Cadastrar Nova Nota de Entrada.

🚚 Prazo de entrega do fornecedor na Lista de Compras

O cadastro de fornecedores (Cadastros → Fornecedores) ganhou o campo Prazo de Entrega (dias).

A Lista de Compras passou a usar esse prazo. A quantidade sugerida considera o consumo do produto nos dias até a data Final e também nos dias que o fornecedor da última compra leva para entregar. Por exemplo: com previsão para 7 dias e um fornecedor que entrega em 3, a lista calcula a compra para 10 dias, e o produto não acaba antes de a mercadoria chegar. Fornecedor sem prazo cadastrado continua como antes.

📥 Importação de produtos com conferência

As importações de produtos por planilha, no menu de importar e exportar da tela de Produtos, ganharam uma etapa de conferência. Antes de gravar qualquer coisa, o Estoque Web lê a planilha e mostra o que vai mudar:

os produtos novos, com os dados que serão gravados;
os produtos que serão alterados, campo a campo, com o valor atual riscado e o valor novo ao lado;
os grupos e subgrupos novos, que ainda não existem no cadastro e serão criados;
os produtos sem alteração, em que nada será feito.

Desmarque os produtos que você não quer criar ou alterar. Eles ficam exatamente como estão, e um grupo novo só é criado se algum produto marcado usar esse grupo. O botão IMPORTAR mostra quantos produtos serão importados.

Na Importação de Produtos Fiscais, a conferência mostra os campos fiscais que vão mudar. Essa importação não cria produtos: os códigos que não existem no cadastro aparecem numa lista e são ignorados. Quando a planilha tem alíquotas entre 0 e 1 (como 0,1, que pode ser 10% ou 0,1%), o sistema continua perguntando primeiro o que fazer com elas e depois abre a conferência já com os valores finais.

A Exportação de Produtos Fiscais também ficou mais flexível: ela pergunta se a planilha deve ter apenas os produtos com preço de venda ou todos os produtos ativos.

🔎 Filtros por grupo e subgrupo

A Auditoria de Estoque ganhou o filtro Filtrar por Subgrupo, ao lado do filtro por grupo. Depois de escolher um grupo, a lista de subgrupos mostra só os subgrupos que têm produtos naquele grupo. Assim fica mais fácil dividir a contagem em partes menores;
a Reposição de Subestoque ganhou os filtros Grupos e Subgrupos, ambos de múltipla escolha.

📣 Janela de Novidades

O antigo aviso "O aplicativo foi atualizado" deu lugar à janela Novidades, a mesma do Gerencial Web. Ela abre sozinha quando o Estoque Web é atualizado e mostra as últimas publicações da Área do Cliente, como esta. Para abrir a janela a qualquer momento, use o botão Novidades no canto direito da barra superior ou o item Novidades do menu lateral.

🛠️ Outras melhorias e correções

Na lista de produtos, os cartões trocaram as bolinhas coloridas por ícones: estoque controlado, produto composto, ingrediente, emite NFC-e, cardápio digital, horário de vendas e preço dinâmico. Passe o mouse sobre o ícone para ver o que ele indica;
nas Informações Adicionais do produto, cada preço dinâmico agora tem um botão de excluir. Ao salvar, o cartão do produto é atualizado na hora;
no cadastro de produtos, o campo Aliq. ICMS (%) agora mostra o valor salvo. Antes, ele aparecia vazio, embora o valor fosse gravado;
a contagem dos indicadores da página inicial, como produtos com saldo negativo e auditorias abertas, foi corrigida;
quem alternava entre o Gerencial Web e o Estoque Web via o aviso de atualização reabrir a cada troca de aplicativo. Isso foi corrigido.

Com essas novidades, o Estoque Web 12.0.0 leva para o Estoque a emissão de NF-e e dá mais controle sobre validade, compras e cadastros.

Finanças Web v19 - Grade Anual com Orçamento, Multiempresa, Curva ABC e Análise por IA

2026-09-30T22:10:22Z

A versão 19.0.0 do Finanças Web reúne tudo o que chegou desde a 18.1. A Grade Anual virou um painel do orçamento do ano. O novo menu Multiempresa compara as despesas e o DRE das unidades da rede, a Curva ABC de Despesas mostra onde o dinheiro se concentra e o Fechamento Mensal ganhou uma análise por IA. Há também opções novas para o envio do caixa da Recepção e uma mudança nas permissões dos usuários. Vale ler essa parte com atenção, porque ela pode mudar o que alguns usuários enxergam.

📊 Grade Anual: o orçamento do ano num só painel

A Grade Anual (menu Relatórios, agora com o selo Atualizado) deixou de ser só uma tabela de meses. O topo da tela mostra os indicadores do ano e, logo abaixo, o orçamento mês a mês.

Cartões do ano

São quatro cartões: Receitas (ou Faturamento Bruto), Despesas Operacionais, Despesas Não Operacionais e Resultado;
cada um mostra o Realizado anual, a Previsão anual e o comparativo Real x Prev. O comparativo fica verde quando o número está bom e vermelho quando não está;
um mini-gráfico mostra a evolução mês a mês. Passe o mouse para ver o valor de cada mês.

Resumo mensal do orçamento

São doze blocos, um por mês, com o previsto, o realizado e a diferença das despesas operacionais e não operacionais somadas. Diferença positiva, em verde, é sobra de orçamento. Diferença negativa, em vermelho, é estouro.

Receitas ou Faturamento Bruto

O novo seletor Receita/Faturamento escolhe a base das receitas. Receitas (Contas a Receber) usa as receitas lançadas. Faturamento Bruto (Data Caixa) usa o faturamento da operação. Com o faturamento escolhido, aparece o seletor Cálculo Faturamento Bruto, com os mesmos modos que o DRE ganhou na versão 18.1:

Comandas Fechadas Apenas
Receitas Emitidas no Mês
Comandas Fechadas com Adiantamentos e Pré-Reservas
Comandas Fechadas com Pré-Reservas

Nos modos baseados em comandas, a tabela mostra a composição do faturamento: Hospedagem, Consumo, Vendas Diretas, Duplicatas e Pagamento Pré-Reservas (este último não aparece em Comandas Fechadas Apenas). As escolhas ficam salvas para o seu usuário. Na primeira vez, o modo segue o padrão definido em Sistema → Configurações. A exportação para Excel e a impressão respeitam as opções escolhidas.

Saldo anual com uma regra só

A coluna Saldo anual passou a seguir a mesma lógica em toda a grade. Verde sempre quer dizer que o número está bom:

Receitas: o saldo é o realizado menos o previsto. Verde é receita acima da meta; vermelho é o que ainda falta entrar;
Despesas: o saldo é o previsto menos o realizado. Verde é sobra de orçamento; vermelho é estouro. Uma despesa sem previsão cadastrada que teve gasto aparece em vermelho, porque foi um gasto fora do orçamento.

Outras mudanças na grade:

as linhas de total de Receitas, Despesas e Despesas Não Operacionais mostram o previsto, o realizado e o saldo do ano. Antes, essas colunas ficavam zeradas;
o Realizado anual das despesas aparece com sinal negativo, como nas colunas dos meses. Num grupo com subgrupos, ele soma os subgrupos;
grupos com previsão cadastrada aparecem na grade mesmo antes do primeiro lançamento;
um grupo de receita não pega mais por engano a previsão de um grupo de despesa com o mesmo código;
na Grade Mensal, a opção Previsão anual (total do ano), dentro de Definir Previsão, passou a gravar corretamente para grupos de receita.

Os cartões e o saldo dependem das previsões dos grupos, cadastradas na Grade Mensal em Definir Previsão. Sem previsão, a previsão anual fica zerada.

No celular, os cartões ficam empilhados, o resumo mensal se reorganiza e a tabela rola para o lado.

Relatório Anual Legado

Desde abril, a Grade Anual coloca cada despesa quitada no mês do pagamento (a data do recibo), e não mais no mês do vencimento. O formato anterior continua disponível em Sistema → Relatório Anual Legado (Antigo), com Excel e impressão próprios, para quem precisa comparar com relatórios antigos. É uma tela de consulta. Para acompanhar o ano, use a Grade Anual.

🏢 Novo menu Multiempresa (prévia)

Para quem administra mais de uma unidade, a barra superior ganhou o menu Multiempresa, entre Relatórios e Cadastros. No celular, ele fica no menu lateral. O menu aparece quando você acessa duas ou mais empresas pelo seletor de empresas, e os relatórios reúnem todas as unidades desse seletor. As duas telas estão marcadas como Preview.

Comparativo de Despesas

Esta tela mostra as despesas de todas as unidades lado a lado, separadas em Despesas Operacionais e Despesas Não Operacionais, com subtotal em cada seção. Grupos com o mesmo nome nas unidades são juntados automaticamente, sem diferenciar acentos, maiúsculas ou espaços. Assim, a comparação funciona mesmo quando os cadastros não são idênticos.

Cada unidade tem três colunas: Valor, % Unidade e % Grupo. A % Unidade é o peso daquela linha no total de despesas da unidade. A % Grupo é a parte da unidade no total daquela linha somando a rede;
a célula da unidade onde o grupo pesa mais fica destacada em amarelo. É o jeito rápido de achar a unidade que gasta proporcionalmente mais com energia, lavanderia ou manutenção;
os filtros são o mês ou o período, a situação (em aberto e quitado) e o Comparar por, que pode ser Grupo / Subgrupo ou Somente Grupo;
cartões mostram o total, as operacionais e as não operacionais de cada unidade. O rodapé traz o consolidado da rede;
o relatório pode ser exportado em PDF.

DRE Multiempresa

Esta tela reúne o DRE de todas as unidades numa tabela só. Primeiro vem o Consolidado da rede e depois cada unidade, com Realizado, Previsto e Variação em cada linha. Os cartões do topo trazem a Receita Líquida, o Lucro Bruto, o Resultado Operacional e o Resultado Líquido consolidados, com o valor de cada unidade logo abaixo. O relatório funciona nos regimes de Competência e Caixa/Realizado, nos modos mensal, anual e por período, e pode ser exportado em PDF.

As linhas são juntadas pelo nome. Por isso, o DRE precisa estar configurado em todas as unidades, de preferência com a mesma estrutura de linhas.

Permissões

O Comparativo usa a permissão Gerenciar de Despesas. O DRE Multiempresa usa a Visualizar DRE. Em cada unidade, o usuário também precisa da permissão Mensal (Relatórios). A unidade em que ele não tem essa permissão fica de fora do relatório.

🔤 Curva ABC de Despesas (prévia)

A tela fica em Relatórios → Curva ABC de Despesas, e também abre pelo card Curva ABC da página inicial. Ela ordena os grupos de despesa do maior para o menor valor pago no período e mostra onde o dinheiro se concentra:

a Classe A reúne os grupos que somam até 80% do total pago. Normalmente são poucos, e é neles que uma negociação faz mais diferença. A Classe B vai até 95%, e a Classe C fica com o restante;
os cortes podem ser ajustados no campo Cortes A/B/C (%), e a tela reclassifica os grupos na hora;
o gráfico de Pareto mostra as barras coloridas por classe e a linha do percentual acumulado;
cartões mostram a quantidade de grupos, o valor e a participação de cada classe. A tabela traz o total, o percentual individual, o acumulado e a classe de cada grupo;
no celular, a tela aparece em cartões. O relatório pode ser exportado em PDF.

A base são os pagamentos feitos entre a data inicial e a final do filtro, de despesas operacionais e não operacionais. A permissão necessária é Gerenciar de Despesas.

📈 Dashboard renovado (prévia)

O Dashboard do Finanças abre pelo card Dashboard da página inicial ou por Relatórios → New Dashboard. Ele ganhou um layout novo, com os destaques e as últimas atividades numa barra lateral e os cartões ao lado. Os cartões novos são:

Evolução do Resultado: receitas menos despesas operacionais e não operacionais nos últimos 12 meses;
Maiores Pagamentos por Fornecedor: os 10 fornecedores que mais receberam no mês corrente;
Curva ABC do mês corrente, com as classes A, B e C coloridas.

Os demais cartões continuam: a evolução das despesas e das receitas, as pizzas de despesas e de faturamento, o Resultado Operacional, o Resumo Finanças, o Resumo Contas e os Alertas de Orçamento. As tabelas de últimas despesas e últimas receitas saíram do Dashboard. Os lançamentos recentes continuam em Últimos Cadastros, nas telas de nova despesa e nova receita.

Cada cartão respeita a permissão da área correspondente. Quem não tem acesso às despesas, por exemplo, não vê os gráficos de despesa.

🤖 Fechamento Mensal com análise por IA

O Fechamento Mensal (menu Relatórios) ganhou o botão Análise por IA, com um ícone de brilho, na barra de ações ao lado de Atualizar e Imprimir. Com o relatório carregado, clique no botão para abrir a janela Análise Mensal do Financeiro por IA. Ela mostra o progresso enquanto a IA cruza os números do mês.

A análise foca nas despesas. A IA compara o mês com os três anteriores e aponta:

os grupos que mais cresceram;
os grupos que passaram da previsão;
o peso de cada grupo e a concentração por fornecedor;
quanto do faturamento está comprometido com as despesas.

O resultado vem em cartões, divididos em Resumo Executivo, Insights e Recomendações. Os cartões ficam na própria página, na seção Análise por IA. Se você voltar ao mesmo mês com os mesmos filtros, a análise já gerada aparece de novo, sem espera. Quanto mais previsões cadastradas, mais útil fica a comparação com o orçamento.

⚙️ Envio do caixa: bandeiras, troco e taxas

Três opções novas em Sistema → Configurações mudam a forma como o fechamento de caixa da Recepção chega ao Finanças. As três exigem duas coisas: a opção Novo Sistema de Envio - Separa Bandeiras/Dias Úteis e Múltiplos Modos ligada e a Recepção atualizada no computador que fecha o caixa.

Mapeamento por bandeira

Na seção Mapeamentos, as formas de pagamento que têm bandeiras ganharam o campo Bandeira. Com ele, dá para mandar o crédito Visa e o crédito Mastercard para contas diferentes, por exemplo. Cada bandeira pode ter o seu grupo, cliente, marcador, dias de vencimento e tipo de envio. Quando não há regra para uma bandeira, vale a regra Todas daquela forma de pagamento, então os mapeamentos que você já tem continuam funcionando. A única exceção é o Quitar Automaticamente, que continua valendo pela forma de pagamento.

Troco como despesa

O dinheiro de um agrupamento fica negativo quando sai mais troco do que entra em dinheiro. Até agora, esse valor era descartado no envio. A seção Troco (Dinheiro Negativo) tem a nova opção Enviar dinheiro negativo (troco) como despesa. Com ela ligada, o valor vira uma despesa quitada, com "(TROCO)" na descrição, baixada da conta escolhida. Quando o dinheiro do dia fica positivo, o troco continua apenas abatendo a receita.

Taxas como despesa

A seção Taxas das Formas de Pagamento tem a nova opção Lançar taxas como despesa (não descontar da receita). Com ela ligada, a receita entra pelo valor bruto e cada taxa vira uma despesa quitada, com "(TAXA)" na descrição e o percentual na observação. No Fechamento Mensal, a linha Taxas de Meios de Pagamentos deixa de aparecer, porque a taxa passa a ficar no grupo de despesa escolhido. Assim, ela não é contada duas vezes.

Atenção ao ligar o troco ou as taxas:

preencha os quatro campos que aparecem: Conta, Grupo, Fornecedor e Marcador. Sem eles, o envio do caixa não é concluído;
prefira ligar no início de um mês. A mudança não altera os caixas já enviados, a não ser que eles sejam reenviados;
as taxas de todas as formas de pagamento vão para uma única conta.

Se a Recepção do motel estiver desatualizada, fale com o nosso suporte antes de ligar essas opções.

🔐 Permissões: o que muda para os usuários

O Finanças Web passou a respeitar permissões que já existiam no cadastro do usuário, mas que ainda não tinham efeito na versão web. Elas ficam no +Gerencial, em cadastro do usuário → Permissões → Finanças:

Visualizar DRE libera o DRE e o DRE Multiempresa. Antes, eles seguiam a permissão Mensal;
Configurar Linhas do DRE libera a Configuração e o Mapeamento do DRE;
Visualizar Últimos Cadastros, em Despesas e em Receitas, mostra a lista de últimos cadastros nas telas de nova despesa e nova receita. Se o usuário tiver apenas Visualizar Últimos Cadastros (15 Dias), a lista mostra só o que foi cadastrado nos últimos 15 dias;
Edita Registros Últimos 15 Dias, Últimos 30 Dias ou de Todos os Dias ficam no grupo Retroatividade. Elas limitam editar, quitar, estornar e excluir aos registros cadastrados dentro do prazo. O que conta é a data em que o lançamento foi criado, não o vencimento. Se nenhuma das três estiver marcada, não há limite;
Editar/Quitar/Estornar e Excluir, em Despesas e em Receitas, passam a valer em todas as telas, inclusive nos detalhes dos relatórios e nos últimos cadastros. Sem a permissão, os botões não aparecem.

Importante: para usuários que não são administradores, uma permissão que nunca foi marcada conta como desligada. Por isso, depois da atualização, alguém da equipe pode deixar de ver o DRE, a lista de últimos cadastros ou os botões de quitar e estornar. Se isso acontecer, abra as permissões do usuário no +Gerencial e marque o que ele deve acessar. Revise também quem tinha as opções de 15 ou 30 dias marcadas, porque elas agora têm efeito.

📣 Janela de Novidades

O aviso "O aplicativo foi atualizado" deu lugar à janela Novidades. Ela abre sozinha depois de cada atualização e mostra as últimas publicações da Área do Cliente, com o selo Novo no que saiu desde a sua última visita. O link Ler na Área do Cliente abre o artigo já com o seu login. Para abrir a janela a qualquer momento, use o botão Novidades (ícone de megafone) na barra superior, ao lado do seletor de empresa, ou o item Novidades do menu lateral.

✨ Outras melhorias e correções

Importar Arquivo (menu Sistema): a nova opção Importar despesas quitadas vem marcada, e com ela tudo funciona como antes. Se você desmarcar, as despesas do extrato (Excel ou OFX) entram em aberto, como contas a pagar, sem mexer no saldo da conta. As receitas continuam entrando quitadas;
Receitas: uma receita quitada parcialmente mostra o valor já pago num selo na coluna Valor, como já acontecia em Despesas;
Extrato: a ordenação por Data e Sequência passou a funcionar, e o saldo linha a linha não sai mais trocado;
Quitação e estorno de vários itens: a lista se atualiza sozinha ao terminar, sem precisar recarregar a página. A seleção Todos/Nenhum também marca os itens nos cartões do celular, e o ícone de anexo se atualiza depois que você gerencia os documentos.

A versão 19.0.0 já está disponível na sua conta do Finanças Web. As telas marcadas como Preview (Multiempresa, Curva ABC de Despesas e Dashboard) continuam recebendo ajustes, e as sugestões de vocês ajudam a definir os próximos passos. Se precisar de ajuda para configurar as previsões, o envio do caixa ou as permissões, fale com o nosso suporte.

Como conectar o Claude ou o ChatGPT ao Motel+ com o MCP

2026-09-26T14:03:22Z

O Motel+ conversa com assistentes de inteligência artificial. Conectando o Claude ou o ChatGPT ao seu motel pelo MCP (Model Context Protocol), você pergunta em português — "como está a ocupação agora?", "quais contas vencem esta semana?", "compare o faturamento deste mês com o do mês passado" — e a IA responde com os números reais do sistema. Também dá para lançar despesas, receitas e notas de entrada direto na conversa. Tudo limitado às permissões que você define, aplicativo por aplicativo.

O vídeo abaixo mostra o processo completo; o passo a passo por escrito vem em seguida.

[youtube:VFcaG5KGT1I]

O que você precisa

Acesso de administrador ao Gerencial Web do motel — o menu da API de Integração só aparece para administradores, na versão para computador.
Uma conta no Claude (claude.ai) ou no ChatGPT. Conectores personalizados fazem parte dos planos pagos dos dois.
O endereço do servidor MCP do Motel+: https://api.motelmais.com.br/mcp

Tem mais de um motel? O Claude e o ChatGPT não aceitam dois conectores com a mesma URL. Use um endereço por unidade, acrescentando o PlugPlay Id dela: https://api.motelmais.com.br/mcp?e=187, https://api.motelmais.com.br/mcp?e=188 e assim por diante. O parâmetro serve só para diferenciar os conectores — e a tela de autorização já abre com o Id daquela unidade preenchido. Dê a cada conector o nome do motel para não confundir nas conversas.

Se você é desenvolvedor e quer usar a API diretamente, sem assistente de IA, o caminho é o guia completo da API de Integração.

Passo 1: crie o aplicativo no Gerencial Web

A IA entra no motel como um aplicativo de integração, com credenciais próprias e permissões escolhidas por você. Em Cadastros → Avançado → API de Integração:

Clique no + da lista Aplicativos, dê um código e um nome (por exemplo, Claude ou ChatGPT) e salve.
Marque as permissões: cada área (ocupações, preços, finanças, estoque, relatórios, cadastros...) pode ser liberada ou não. As áreas sensíveis — faturamento completo, finanças, DRE, histórico de ocupações — têm um aviso e só devem ser liberadas com o consentimento do proprietário. Salve.
Confira que o aplicativo está ativo e clique em Copiar Credenciais: isso copia o PlugPlay Id (o número do seu motel) e o PlugPlay Token (a chave do aplicativo) de uma vez.

Na mesma tela há dois painéis com instruções prontas: Acessar a API pelo seu sistema e Conectar a uma IA — este com os passos para Claude, ChatGPT e Claude Code, o endereço do servidor e o link deste vídeo.

Passo 2: conecte no Claude

No claude.ai (ou no aplicativo do Claude), abra Configurações → Conectores e clique em Adicionar conector personalizado.
Nome: Motel+. URL do servidor MCP remoto: https://api.motelmais.com.br/mcp. Clique em Adicionar.
Clique em Conectar. Vai abrir a tela de autorização do Motel+ (Passo 3).
Depois de autorizado, numa conversa nova, deixe o conector Motel+ ligado no menu de ferramentas e pergunte à vontade.

Ou conecte no ChatGPT

No ChatGPT há dois caminhos, e qual funciona depende do seu plano:

a) Modo desenvolvedor no site (chatgpt.com). A OpenAI condiciona os conectores MCP personalizados ao plano: pela central de ajuda, o Modo desenvolvedor é oferecido aos planos Business, Enterprise e Edu — e, nesses, o administrador do workspace precisa liberá-lo. Se a opção aparecer para você:

Em Configurações → Aplicativos e conectores → Configurações avançadas, ative o Modo desenvolvedor.
De volta em Conectores, clique em Criar: nome Motel+, URL do servidor MCP https://api.motelmais.com.br/mcp, autenticação OAuth. Confirme.
Faça a autorização na tela do Motel+ (Passo 3).
Numa conversa, clique em + e selecione o conector Motel+ antes de perguntar.

b) Aplicativo do ChatGPT para computador, com o Codex (funciona nos outros planos). O aplicativo para Windows e Mac traz o Codex, que aceita servidores MCP sem depender do Modo desenvolvedor do site:

Instale o aplicativo do ChatGPT para computador e entre com a sua conta.
Abra Configurações → MCP servers e clique em Add server.
Nome Motel+, tipo Streamable HTTP, URL https://api.motelmais.com.br/mcp. Salve.
Na lista de servidores, clique em Authenticate: abre a tela de autorização do Motel+ (Passo 3).
Use o Motel+ nas conversas do Codex dentro do aplicativo — os servidores configurados ali não aparecem no chat comum do site.

Os nomes dos menus podem mudar de uma versão para outra do Claude e do ChatGPT, mas o caminho é sempre o mesmo: adicionar um servidor MCP com o endereço do Motel+ e autorizar.

Passo 3: autorize o acesso

A tela de autorização do Motel+ pede as duas credenciais do aplicativo. Cole o que você copiou no Passo 1 em qualquer um dos campos: o Id e o Token se preenchem sozinhos. Clique em Autorizar acesso e pronto — o assistente volta para a conversa já conectado.

Se aparecer "não conferem", confira no Gerencial se o aplicativo está ativo e se a chave não foi revogada depois de você copiá-la.

O que perguntar

"Como está a ocupação do motel agora? Quantas suítes estão livres, ocupadas e em limpeza?"
"Quais contas vencem nos próximos 7 dias e qual o total?"
"Compare o faturamento deste mês com o do mês passado, por categoria de suíte."
"Quais produtos devo comprar este mês, com base no consumo recente?"
"Qual foi o desempenho das camareiras na última semana?"
"Lance uma despesa de energia elétrica de R$ 1.250,00 com vencimento no dia 10."

A IA escolhe sozinha as ferramentas certas (são 50, cobrindo ocupações, suítes, preços, reservas, finanças, estoque, relatórios, metas e satisfação) e, antes de lançar algo, confirma os valores com você.

O que a IA pode e o que não pode fazer

Consultas: status das suítes e ocupações, dashboards do dia e do mês, faturamento por categoria e por forma de pagamento, metas, reservas, preços e tabela de preços, relatórios de governança e de produtos (curva ABC, vendas, consumo), pesquisa de satisfação e NPS, KPIs financeiros, DRE, contas a pagar, saldos e movimentos de estoque.
Lançamentos: criar despesas, receitas e notas de entrada; cadastrar fornecedores, clientes, grupos, marcadores, operadores e funcionários. As ferramentas só criam — nunca excluem, quitam ou alteram o que já existe — e cada lançamento fica registrado no sistema com o aplicativo que o originou.
Nada além das permissões: sem permissão para uma área, a IA não a acessa e avisa que o proprietário precisa liberá-la.

Claude Code (terminal)

Quem usa o Claude Code conecta com um comando, colocando o Id e o Token do aplicativo:

claude mcp add --transport http --scope user motelmais https://api.motelmais.com.br/mcp --header "PLUG-PLAY-ID: SEU_ID" --header "PLUG-PLAY-TOKEN: SEU_TOKEN"

Ou rode o mesmo comando sem os dois --header e digite /mcp dentro do Claude Code para entrar pela tela de autorização.

Segurança

O token é a senha do aplicativo: quem o tem acessa tudo o que as permissões liberam. Repasse só a quem deve usar e nunca o publique.
Os dados que a IA recebe passam a ser tratados também pelo provedor do assistente (OpenAI ou Anthropic), na sua conta lá. Vale revisar as configurações de privacidade e de uso para treinamento do provedor.
Para cortar o acesso, use Desativar ou Revogar Chave na tela do aplicativo: o token para de valer na hora e as sessões já conectadas caem em até 1 hora.
Os detalhes do tratamento de dados estão na Política de Privacidade.

Dúvidas na conexão? Fale com o suporte — a gente conecta junto com você.

API de Integração Plug & Play: guia completo e referência das rotas

2026-09-26T14:03:24Z

O Motel+ pode ser controlado por fora. A API de Integração Plug & Play é a porta de entrada para conectar qualquer sistema ao seu motel: guias de motéis, sites de reserva, ERPs, planilhas automatizadas, painéis próprios e até agentes de inteligência artificial. Por ela dá para consultar ocupações e relatórios, criar reservas, lançar receitas e despesas no financeiro, movimentar o estoque, acompanhar metas e muito mais — tudo com permissões controladas por você, aplicativo por aplicativo.

Este guia junta o tutorial e a referência num lugar só: começa do zero (o que é a API e como criar a sua chave no Gerencial Web), passa pelos exemplos de cada área e termina com o dicionário de campos das rotas mais usadas. Foi escrito tanto para o dono ou gerente que quer entender o que é possível quanto para o desenvolvedor que vai colocar a integração de pé.

O que é a API Plug & Play

É uma API HTTPS + JSON hospedada na nuvem do Motel+. O sistema tem uma arquitetura híbrida: a Recepção (PDV) é instalada no motel e não depende de internet, mas sincroniza os dados com a nuvem num ambiente isolado e seguro — e é dessa cópia na nuvem que a API lê e nela que ela escreve. Cadastros como produtos, reservas, funcionários e operadores são bidirecionais: o que a integração altera na nuvem chega à recepção, e o que a recepção altera chega à integração.

Cada motel gera uma ou mais chaves de aplicativo no Gerencial Web; cada chave tem um conjunto próprio de permissões, escolhidas por você. O aplicativo integrado só enxerga o que a chave dele permite — e tudo o que ele faz fica registrado no log de atividades do sistema, com um usuário próprio identificando o aplicativo.

Endereço base: https://api.motelmais.com.br — as rotas ficam em https://api.motelmais.com.br/api/[recurso]
Documentação interativa (todas as rotas, parâmetros e modelos, com teste direto no navegador): https://api.motelmais.com.br/scalar/v1
Especificação OpenAPI (para gerar clientes ou importar no Postman/Insomnia): https://api.motelmais.com.br/openapi/v1.json
Limite de uso: 100 requisições por minuto por aplicativo (acima disso a API responde 429 com o cabeçalho Retry-After)

O endereço antigo, https://oxpi.com.br/api/PlugPlay, continua funcionando para as integrações já feitas — é a mesma API. Para integrações novas, use o endereço acima.

Criando a chave no Gerencial Web

A configuração fica no Gerencial Web, no menu Cadastros → Avançado → API de Integração:

Na tela de configuração, clique no + para criar um novo aplicativo. Cada integração deve ter o seu próprio aplicativo — assim você controla as permissões e pode revogar uma chave sem afetar as outras.

O que cada campo da tela significa:

Campo	O que é
AppId	Número sequencial do aplicativo dentro do seu motel. Aparece nos logs de atividade para identificar qual integração fez cada operação.
Nome do App	Nome livre para você reconhecer a integração (ex.: "Site de reservas", "ERP Contábil").
PlugPlay Id	O código da sua empresa no Motel+. É o valor do cabeçalho `PLUG-PLAY-ID` em toda requisição.
PlugPlay Token	A chave secreta de 64 caracteres do aplicativo. É o valor do cabeçalho `PLUG-PLAY-TOKEN`. Trate como senha: quem tem o token acessa tudo o que as permissões do aplicativo liberam.
Copiar Credenciais	Copia Id e Token juntos, prontos para repassar ao integrador.
Revogar Chave	Invalida o token atual imediatamente e gera um novo. Use se a chave vazou ou ao trocar de fornecedor.
Desativar	Suspende o aplicativo sem apagar a configuração: ele para de autenticar na hora e pode ser reativado depois.

Na mesma tela há dois painéis com instruções prontas — Acessar a API pelo seu sistema, com um exemplo de chamada já preenchido com as credenciais do aplicativo, e Conectar a uma IA, com o passo a passo para Claude, ChatGPT e Claude Code.

Permissões: você decide o que o aplicativo enxerga

Abaixo das credenciais fica a lista de permissões da API, organizada por área: ocupações e status, reservas, preços, caixa, estoque, produtos, pedidos, relatórios, dashboard, metas, finanças, funcionários e pesquisa de satisfação. Tudo começa desligado — habilite somente o que a integração realmente precisa. Cada permissão tem um botão que lista as rotas que ela libera.

Preste atenção nas tarjas de aviso: algumas permissões dão acesso a dados sensíveis, como o histórico completo de faturamento, os relatórios de placas de veículos (dados pessoais, LGPD) e os lançamentos de Finanças — que incluem, sem filtro, os grupos marcados como sigilosos no Finanças Web. Habilitar a permissão é o seu consentimento para esse acesso. As permissões passam a valer imediatamente após salvar, inclusive para as ferramentas de IA (MCP).

Autenticação: a primeira requisição

Toda chamada leva dois cabeçalhos — o Id da empresa e o token do aplicativo. Não existe login nem sessão: os cabeçalhos bastam.

curl "https://api.motelmais.com.br/api/v2/SuitesStatus" \
  -H "PLUG-PLAY-ID: 1234" \
  -H "PLUG-PLAY-TOKEN: SEU-TOKEN-DE-64-CARACTERES"

Essa rota devolve o status atual de todas as suítes (livre, ocupada, em limpeza, interditada...) e é um ótimo teste de que as credenciais funcionam. Sem os cabeçalhos — ou com um token revogado, um aplicativo desativado ou uma rota sem a permissão correspondente — a resposta é 401 Não autorizado.

Convenções que valem para a API inteira

Antes dos exemplos, cinco regras que se repetem em todas as rotas:

Datas vão no formato ISO: 2026-09-01 em parâmetros de consulta, 2026-09-01T14:30:00 em campos de data e hora.
Consultas por período seguem dois padrões de nome: PorMesAno?mes=9&ano=2026 ou PorPeriodo?inicial=2026-09-01&final=2026-09-30. Nos relatórios, o período de uma consulta é limitado a cerca de 3 meses (92 dias); nas buscas de Finanças, a 366 dias.
Paginação, quando existe, usa pagina (a partir de 1) e itensPorPagina (padrão 100, máximo 300).
Escritas aceitam uma chave de integração (integracaoId) que impede lançamento duplicado em caso de retentativa — detalhes na seção de idempotência.
Erros respondem em português, num JSON padronizado. Guarde o traceId: ele permite ao suporte localizar a requisição exata no log do servidor.

Exemplos reais de erro. Parâmetro digitado errado (fim em vez de final):

{
  "erro": "Parâmetro(s) de query desconhecido(s): fim.",
  "parametrosAceitos": ["final", "incluirConsumos", "incluirObservacoes",
                        "incluirPagamentos", "inicial", "porDataSaida",
                        "sobrescreveDatasComoDataCaixa"],
  "traceId": "0HNOBB2O3ID4M:00000001"
}

Campo inválido no corpo de um POST:

{
  "erro": "Requisição inválida: verifique os campos informados em 'detalhes'.",
  "detalhes": { "valor": ["O valor deve estar entre 0,01 e 9.999.999,99."] },
  "traceId": "0HNOBB2O3ID5V:00000001"
}

Os códigos HTTP que você vai encontrar:

Código	Significado
`200`	Deu certo; o corpo traz o resultado.
`204`	Deu certo, sem conteúdo para devolver.
`400`	Requisição inválida — o campo `erro` explica o quê.
`401`	Credenciais ausentes/erradas, ou o aplicativo não tem a permissão necessária.
`404`	Registro não encontrado.
`409`	Conflito — em geral, chave de integração já usada (veja idempotência).
`429`	Limite de requisições excedido; aguarde o tempo do cabeçalho `Retry-After`.
`500`	Erro interno; informe o `traceId` ao suporte.

Status das suítes e disponibilidade em tempo real

Três rotas de consulta que sustentam painéis, sites de reserva e guias de motéis:

GET /api/v2/SuitesStatus                ← todas as suítes, com status e ocupação corrente
GET /api/CategoriaDisponibilidade       ← suítes livres e total, por categoria
GET /api/ReservaDisponibilidade/PorSuiteId?entrada=2026-11-06T17:00&saida=2026-11-08T19:00&suiteId=23

SuitesStatus devolve uma linha por suíte: referência (ref, refF), status (statusId, status — Livre, Ocupada, Limpeza, Revisão...), categoria (classeId, classe), cores usadas no mapa da recepção, sinais de automação (garagem, portaServico, portaCliente, energizado) e, quando ocupada, os dados da ocupação em andamento: ocupacaoId, modo, entrada, tempo permanecido (perm, permMinutos), totalConsumo, valorPrevisto, emPernoite, emCheckout e horaUltimoStatus. Um trecho:

[
  {
    "id": 2, "ref": 2, "refF": "02",
    "statusId": 1, "status": "Livre",
    "classeId": 1, "classe": "SIMPLES",
    "corBackground": "#00CC00", "corTexto": "#FFFFFF",
    "garagem": false, "portaServico": false, "portaCliente": false, "energizado": false,
    "ocupacaoId": null, "isOcupado": false,
    "totalConsumo": 0, "valorPrevisto": 0.00,
    "emPernoite": false, "emCheckout": false,
    "horaUltimoStatus": "2026-09-25T08:16:31"
  }
]

CategoriaDisponibilidade é o resumo para quem vende por categoria:

[
  { "categoriaId": 3, "categoria": "Express", "disponiveis": 3,  "total": 4 },
  { "categoriaId": 1, "categoria": "Luxo",    "disponiveis": 15, "total": 23 },
  { "categoriaId": 2, "categoria": "Piscina", "disponiveis": 2,  "total": 4 }
]

ReservaDisponibilidade/PorSuiteId responde se uma suíte específica está livre entre uma entrada e uma saída (parâmetros entrada, saida e suiteId):

{
  "mensagem": "A UH '23' já está reservada de 06/11/26 08:00 até 07/11/26 12:00 para 'Cliente Exemplo'.",
  "disponivel": false
}

Webhook de status das suítes

Em vez de consultar o status de tempos em tempos, o aplicativo pode receber as mudanças: na tela do aplicativo, com a permissão de status liberada, informe uma URL pública em Webhook de Status das Suítes. A cada mudança o servidor faz um POST com JSON nessa URL, levando os cabeçalhos PLUG-PLAY-ID, PLUG-PLAY-APP-ID e PLUG-PLAY-SIGNATURE (SHA-256 do token do aplicativo + corpo, para você validar a autenticidade). A própria tela mostra um exemplo da requisição enviada; mudanças na URL passam a valer em até 40 minutos.

Consultando ocupações

No Motel+ cada hospedagem é uma ocupação: é nela que estão a suíte, a entrada e a saída, os valores de hospedagem, os produtos consumidos e as formas de pagamento. Há duas maneiras de consultar — por período e por demanda.

Por período

A rota mais usada pelas integrações:

GET /api/Ocupacao/PorPeriodo?inicial=2026-09-01&final=2026-09-30&incluirPagamentos=true

Parâmetro	Obrigatório	O que faz
`inicial` / `final`	sim	Período consultado. Se vierem invertidos, a API corrige a ordem.
`incluirObservacoes`	não	Anexa as observações lançadas em cada ocupação.
`incluirPagamentos`	não	Anexa a lista de pagamentos (forma, valor, data) de cada ocupação.
`incluirConsumos`	não	Anexa os produtos consumidos em cada ocupação.
`porDataSaida`	não	`true` filtra pela data de saída; o padrão filtra pela data do caixa.
`sobrescreveDatasComoDataCaixa`	não	Padrão `true`: as datas exibidas seguem a data base do caixa, batendo com os relatórios do Gerencial.

Há também uma versão v2 paginada, com um modelo mais enxuto, em /api/v2/Ocupacao/PorPeriodo, e a consulta individual /api/v2/Ocupacao/{id} — os parâmetros estão na documentação interativa.

Por demanda (fila de ocupações fechadas)

Para integrações que processam cada hospedagem uma única vez — um ERP, uma conciliação —, a consulta por demanda funciona como uma fila. GET /api/Ocupacao devolve as 10 primeiras ocupações concluídas ainda não recebidas pelo aplicativo (com os mesmos parâmetros incluirObservacoes, incluirPagamentos e incluirConsumos). Depois de gravá-las, o aplicativo confirma o recebimento com um PUT levando os ids no corpo, e a próxima leitura traz as 10 seguintes:

GET /api/Ocupacao?incluirPagamentos=true

PUT /api/Ocupacao
[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]

Dicionário dos campos da ocupação

Cada ocupação vem com os campos abaixo (e, quando solicitado, as listas pagamentos, observacoes e consumos). O valor da hospedagem é a soma de normal, excesso, os pernoites e seus excessos, acrescimo, pessoaExtra e totalConsumo, menos desconto.

Campo	Tipo	Descrição
`ocupacaoId`	number	Código único da hospedagem, criado a cada nova entrada — tende a seguir a ordem de entrada no sistema.
`codigo`	number	Código gerado na saída, para controle interno. Em alguns motéis é zerado a cada fechamento de caixa ou ao chegar a um número definido.
`suiteId`	number	Código interno da suíte.
`entrada` / `saida`	date	Data e hora da entrada e da saída.
`dataBaseCaixa`	date	Data do caixa a que a hospedagem pertence. Num turno que começa às 19h do dia 1 e termina às 7h do dia 2, uma saída na madrugada do dia 2 ainda conta no caixa do dia 1.
`modo`	number	Modalidade: 0 = hospedagem normal (períodos curtos), 1 = pernoite, 2 = pernoite 2 (executivo), 3 = pernoite 3, 4 = pernoite 4.
`totalRecebido`	number	O que foi cobrado do cliente e recebido: a soma de todas as formas de pagamento, exceto as que não somam no caixa (cortesia).
`normal` / `excesso`	number	Valor do período normal (tabela de períodos curtos) e do adicional por tempo excedido.
`pernoite` / `excessoPernoite`	number	Valor do pernoite (tabela de pernoite) e do adicional por tempo excedido.
`pernoiteExecutivo` / `excessoPernoiteExecutivo`	number	Idem, para a tabela de pernoite 2.
`pernoite3`, `excessoPernoite3`, `pernoite4`, `excessoPernoite4`	number	Idem, para as tabelas de pernoite 3 e 4.
`acrescimo`	number	Valor adicional, em geral por um serviço não cadastrado como consumo.
`pessoaExtra` / `quantidadePessoaExtra`	number	Valor total e quantidade de pessoas extras.
`desconto`	number	Valor do desconto concedido.
`totalConsumo`	number	Soma de todo o consumo de produtos.
`totalCortesia`	number	Soma das formas de pagamento que não somam no caixa.
`tevePagamentoAntecipado`	boolean	Se houve pagamento antecipado (reserva).
`marcador`	number	Marcadores aplicados à ocupação (na v2, o campo `marcadores` traz os nomes).
`reservaId`	UID	Reserva que originou a ocupação, quando houve.
`pagamentos[]`	lista	`formaPagamentoId`, `formaPagamentoDescricao`, `valor` e `dataPagamento` de cada pagamento.
`consumos[]`	lista	`produtoId`, `quantidade`, `preco` e `precoCusto` de cada item consumido.
`observacoes[]`	lista	Observações lançadas na ocupação, com data e hora e tipo.

Dashboard e relatórios prontos

Os mesmos indicadores do Dashboard do Gerencial Web estão disponíveis em versão simplificada — uma chamada, um JSON consolidado:

GET /api/Dashboard/Mes?mes=9&ano=2026        ← KPIs do mês (faturamento, ocupações,
                                                ticket médio, RevPAR, comparativos)
GET /api/Dashboard/Comparativo?mes=9&ano=2026&mesComparativo=8&anoComparativo=2026

E praticamente todos os relatórios do Gerencial têm uma rota própria em /api/Relatorios/..., sempre nos pares PorMesAno / PorPeriodo. Alguns exemplos:

FaturamentoPorMesAno, FaturamentoDiario, FaturamentoAnual
MapaCalorPorMesAno — ocupação por dia da semana e faixa de horário
LimpezasPorMesAno, FaxinasPorMesAno, DesempenhoCamareirosPorMesAno
ConsumoProdutoPorMesAno, VendaProdutosPorMesAno, CurvaAbc
FormaPagamentoPorMesAno, ListagemPagamentosPorMesAno, DescontosPorMesAno
PedidosPorMesAno, OcupacoesPorHoraPorMesAno, MediaTempoOcupacaoPorMesAno

A lista completa, com o modelo de resposta de cada um, está na documentação interativa.

Reservas: criando pela API

A versão 2 da API de reservas trabalha com um modelo de negócio limpo e é a recomendada para integrações novas. Para criar:

POST /api/v2/Reserva
{
  "integracaoId": "res-4581",
  "suiteCategoriaIntegracaoId": 3,
  "dataInicio": "2026-09-12T20:00:00",
  "nome": "Cliente Exemplo",
  "telefone": "(51) 99999-0000",
  "valorPago": 150.00,
  "observacoes": "Chegada prevista para as 20h"
}

Campos do corpo — os principais:

Campo	O que faz
`integracaoId`	Código da reserva no seu sistema. Evita duplicidade (a mesma chave não cria duas reservas) e permite localizar/cancelar a reserva depois pelo seu próprio código.
`suiteId`	Suíte específica. Deixe vazio e informe `suiteCategoriaIntegracaoId` para o sistema escolher automaticamente uma suíte livre da categoria.
`dataInicio`	Data e hora de início da reserva.
`dataFim` + `valorNegociado`	Para reservas com saída e valor fechados (um exige o outro). Alternativa: `periodoMinutos`.
`nome`, `telefone`, `email`, `cpf`	Dados do hóspede (nome até 255, telefone até 50, CPF até 14 caracteres).
`qtdAdultos`, `qtdCriancas`	Quantidade de pessoas.
`valorPago`, `desconto`, `acrescimo`, `formaPagamentoId`	Valores já acertados com o cliente no seu canal.
`marcadorId`	Marcador (tag) aplicado à reserva no Motel+.
`produtos`	Até 5 produtos pré-vendidos junto com a reserva (`produtoId` e `quantidade`).

Depois de criada: GET /api/v2/Reserva lista com paginação e filtros, GET /api/v2/Reserva/{id} consulta uma, PUT atualiza (localizando pelo id ou pelo seu integracaoId) e DELETE /api/v2/Reserva/{id}?motivo=... cancela. O campo status da resposta diz se a reserva está Pendente, Concluída (virou ocupação — o campo ocupacaoId aponta qual) ou Cancelada. Toda reserva criada por um aplicativo integrado fica indisponível para edição pelo recepcionista — quem manda nela é a integração.

Reserva v1 (integrações existentes)

A primeira versão continua no ar em /api/Reserva, para as integrações que já a usam. As operações são as mesmas — GET /api/Reserva?exibicao=0&pagina=1 lista (exibicao: 0 = pendentes, 1 = concluídas, 2 = canceladas), POST cria, PUT edita pelo id ou pelo integracaoId, DELETE /api/Reserva?id=...&motivo=... (ou ?integracaoId=...) cancela — ou envie um PUT com cancelada: true. O id é um identificador único (UID); se preferir usar o código do seu sistema, preencha só o integracaoId e o Motel+ gera o UID. Campos do modelo v1:

Campo	Tipo	Descrição
`id`	UID / parcialmente obrigatório	Gerado pela integração, ou omitido quando `integracaoId` é informado.
`integracaoId`	string / parcialmente obrigatório	Código da reserva no sistema integrador; com ele, o Motel+ gera o UID e a reserva fica endereçável pelo seu código.
`suiteId`	number / parcialmente obrigatório	Suíte do Motel+. Obrigatório ele ou `suiteCategoriaIntegracaoId`.
`suiteCategoriaIntegracaoId`	number / parcialmente obrigatório	Categoria do integrador: o Motel+ usa o mapeamento categorias × suítes configurado no motel e reserva uma suíte disponível no dia. Dispensa o `suiteId`.
`dataInicio`	date / obrigatório	Início da reserva.
`dataInicioObrigatorio`	boolean	A hospedagem começa na data de início mesmo que o cliente se atrase — o atraso desconta do tempo dele.
`nome`	string / obrigatório	Nome do cliente final.
`cpf`, `email`, `telefone`	string	Dados do cliente final.
`observacoes`	string	Observações sobre a reserva.
`modo`	number	Modalidade que define a tabela de preço: 0 = normal, 1 = pernoite, 2 = pernoite 2, 3 = pernoite 3. Pode vir da configuração do aplicativo no Motel+.
`horasAlerta` / `horasInterdicao`	number	Quantas horas antes o sistema alerta o recepcionista e quantas horas antes bloqueia a suíte. Podem vir da configuração do aplicativo.
`valorPago`	number	Valor já pago pelo cliente final.
`formaPagamentoId`	number	Forma de pagamento do Motel+ para o valor pago. Pode vir da configuração do aplicativo.
`periodo`	number	Quantidade de horas que o cliente vai ficar.
`identificador`	string	Texto livre que ajude a identificar a reserva (final do cartão, código do canal...).
`valorNegociado`	number	Valor negociado, que se sobrepõe à tabela de preço do motel.
`saidaNegociado`	date	Data e hora de saída da negociação.
`valorNegociadoTabela`	number	Tabela de preço do Motel+ usada na negociação. Pode vir da configuração do aplicativo.
`dataHoraTarifa`	date	Aplica a tabela de preço desta data e hora, em vez da do momento da entrada.
`cancelada`, `canceladaDataHora`, `canceladaMotivo`	boolean, date, string	Cancelamento: `cancelada: true` cancela; data e motivo podem ser preenchidos pelo sistema.

Finanças: receitas, despesas e quitações

Atenção: as rotas de Finanças exigem as permissões próprias da área e devolvem os lançamentos incluindo os grupos marcados como sigilosos no Finanças Web — habilite com consentimento do proprietário.

Para lançar uma despesa (contas a pagar) ou receita (contas a receber), o corpo é o mesmo:

POST /api/Financas/Despesa
{
  "descricao": "Energia elétrica",
  "valor": 2350.00,
  "vencimento": "2026-10-10",
  "grupoId": 12,
  "pessoaId": 7,
  "parcelas": 1,
  "integracaoId": "erp-nf-8812"
}

Campo	Obrigatório	O que faz
`descricao`	sim	Descrição do lançamento (até 255 caracteres).
`valor`	sim	Valor de cada parcela (não é dividido), maior que zero.
`vencimento`	sim	Vencimento da primeira parcela; as demais vencem mês a mês.
`grupoId`	sim	Grupo de despesa/receita do plano de contas (liste-os em `/api/Financas/GrupoReceita` e nas rotas de grupos de despesa).
`pessoaId`	sim	Fornecedor (despesa) ou cliente (receita).
`parcelas`	não	De 1 a 120. Padrão 1.
`marcadorId`	não	Marcador; omitido, assume o primeiro cadastrado.
`contaId`	não	Se informado, as parcelas já nascem quitadas com recibo nessa conta.
`obs`	não	Observações livres (até 255).
`integracaoId` / `integracaoIds`	não	Chave(s) de integração — veja a seção de idempotência.

A resposta é a lista de ids das parcelas criadas, na ordem. Com elas você pode:

POST /api/Financas/Despesa/Quitar
{ "duplicataId": 10791, "data": "2026-10-10", "valor": 2350.00,
  "contaId": 1, "integracaoId": "erp-pgto-8812" }

A situação resultante é decidida pela API: se a soma dos recibos atingir o valor da parcela ela fica Quitada; senão, Parcial. Para desfazer, POST /api/Financas/Despesa/Estornar/{id} estorna todos os recibos e devolve a parcela para Em Aberto. Há ainda a busca paginada (POST /api/Financas/Despesa/Busca com período, situação, grupo e texto livre), a listagem de recibos de cada parcela, os ajustes de conta (depósito, saque e transferência em /api/Financas/Conta/Ajuste) e o DRE pronto em GET /api/Financas/Dre. Troque Despesa por Receita nas rotas e tudo vale igual para o contas a receber.

Estoque: consultas e movimentações

Para consultar saldos, a forma mais simples é a listagem paginada:

GET /api/Estoque/ListagemSaldo                 ← saldo consolidado de todos os setores
GET /api/Estoque/ListagemSaldo?setorId=1       ← saldo de um setor específico
GET /api/Estoque/Saldo?produtoId=15&setorId=1  ← um número só: o saldo de um produto
GET /api/Estoque/Kardex?produtoId=15&setorId=1&mes=9&ano=2026

O Kardex devolve o extrato do produto no mês: saldo inicial, entradas, saídas, ajustes, trocas e saldo final. Há também MovimentosPorPeriodo (todas as movimentações do estoque, paginadas e com filtro por tipo), ComprasProduto, SugestaoCompra e Valorizacao (valor do estoque a preço de custo).

Nas movimentações, a nota de saída é o exemplo mais completo:

POST /api/Estoque/NotaSaida
{
  "setorEstoqueId": 1,
  "clienteId": 1,
  "tipo": 0,
  "obs": "Baixa por integração",
  "integracaoId": "wms-ns-3301",
  "itens": [
    { "produtoId": 15, "quantidade": 2, "valor": 8.50 },
    { "produtoId": 22, "quantidade": 1, "valor": 12.00 }
  ]
}

Campo	O que faz
`data`	Data do lançamento; omitida, usa a data e hora atuais.
`setorEstoqueId`	Setor de onde os produtos saem.
`clienteId`	Cliente vinculado à saída. Obrigatório — para saída sem cliente específico, use o cliente genérico do cadastro (ex.: DIVERSOS).
`tipo`	`0` = Manual, `2` = Consumo interno. (O tipo `1`, Ocupação, é reservado ao sistema.)
`numeroDocumento`, `desconto`, `acrescimo`, `obs`	Dados complementares; a observação aceita até 45 caracteres.
`itens`	Ao menos um item, com `produtoId`, `quantidade` (maior que zero) e `valor` unitário.

A resposta é o id da nota; o saldo dos produtos é baixado na hora. DELETE /api/Estoque/NotaSaida/{id} exclui a nota e estorna o saldo. No mesmo padrão existem a nota de entrada (POST /api/v2/NotaEntrada, com a opção atualizaPrecoCusto para atualizar o custo dos produtos), a troca de setor (POST /api/Estoque/TrocaSetor, transfere produtos entre setores) e a montagem de kit (POST /api/Estoque/MontagemKit, dá entrada no produto montado baixando os insumos). As auditorias de contagem são somente consulta pela API (Auditoria/Aberta e Auditoria/{id}/ItensPendentes) — abrir, contar e concluir é feito no Estoque Web.

Cadastros básicos: fornecedores, clientes, grupos e equipe

Integração de verdade precisa criar cadastros, não só consultá-los. A API cobre os cadastros simples com o mesmo padrão em todos: GET lista, POST cria, PUT edita.

Cadastro	Rota base	Permissão
Fornecedores	`/api/Entidades/Fornecedor`	Fornecedores
Clientes	`/api/Financas/Cliente`	Finanças: cadastros
Grupos de despesa	`/api/Entidades/DespesaGrupo`	Grupos de despesa
Grupos de receita	`/api/Financas/GrupoReceita`	Finanças: cadastros
Marcadores	`/api/Entidades/Marcador`	Marcadores
Funcionários	`/api/Entidades/Funcionario`	Funcionários: cadastrar e editar
Operadores (recepcionistas)	`/api/Entidades/Operador`	Funcionários: cadastrar e editar

Dois detalhes dos cadastros de equipe: o cargo é obrigatório no funcionário (liste os cargos em GET /api/Entidades/FuncionarioCargo), e a API nunca expõe nem define login e senha — um operador ou funcionário criado pela integração nasce sem credenciais, que só podem ser definidas dentro do sistema. Exemplo:

POST /api/Entidades/Operador
{ "nome": "Maria Souza", "pronuncia": "Maria" }

POST /api/Entidades/Funcionario
{ "nome": "Joana Lima", "cargoId": 2 }

Idempotência: o seguro contra lançamento duplicado

Rede oscila, timeout acontece. O que fazer quando você enviou um POST e não recebeu resposta — o lançamento entrou ou não? Sem proteção, reenviar poderia duplicar. A resposta da API Plug & Play é a chave de integração:

Em toda escrita, envie um integracaoId — um código único gerado pelo seu sistema (o número da NF, o id do pedido, um UUID).
Se a mesma chave chegar de novo, a API não duplica: devolve o id do registro já gravado, com 200.
Dá para consultar pelo seu próprio código: GET .../PorIntegracao?chave=... existe para notas de saída e entrada, trocas de setor, kits, receitas, despesas e ajustes de conta.

Nos lançamentos parcelados de Finanças, use a lista integracaoIds com exatamente uma chave por parcela, na ordem — cada parcela fica endereçável pelo seu código (útil para quitar e conciliar parcela a parcela). Se parte das chaves já estiver registrada e parte não, a API responde 409 explicando quais, em vez de arriscar um lançamento pela metade.

POST /api/Financas/Receita
{ "descricao": "Locação de espaço", "valor": 500.00, "vencimento": "2026-10-01",
  "grupoId": 3, "pessoaId": 9, "parcelas": 3,
  "integracaoIds": ["ctr-77-p1", "ctr-77-p2", "ctr-77-p3"] }

Metas, NPS e a nota do Google

Três rotas rápidas que rendem bons painéis:

GET  /api/Meta?mes=9&ano=2026            ← meta do mês (valor e ocupações)
POST /api/Meta                            ← define a meta: { "mes": 9, "ano": 2026,
                                            "valor": 150000, "ocupacoes": 500 }
GET  /api/PesquisaSatisfacao/NPS          ← NPS consolidado da pesquisa ativa
GET  /api/PesquisaSatisfacao/Google       ← a nota do seu motel no Google

A rota do Google devolve o mesmo resumo exibido no relatório de pesquisa de satisfação do Gerencial:

{
  "nome": "Motel Exemplo",
  "nota": 4.4,
  "totalAvaliacoes": 366,
  "url": "https://maps.google.com/?cid=...",
  "ultimaAtualizacao": "2026-09-04T21:35:14"
}

E GET /api/PesquisaSatisfacao/Google/Avaliacoes?top=10 traz as últimas avaliações individuais (autor, nota de 1 a 5, texto e data). Os dados vêm da leitura periódica do Google Places — o campo ultimaAtualizacao indica quando foi a última.

Agentes de IA: o servidor MCP

A mesma API expõe um servidor MCP (Model Context Protocol) — o padrão usado por assistentes como o Claude e o ChatGPT para conversar com sistemas. Você conecta o assistente ao endereço https://api.motelmais.com.br/mcp, autoriza com as credenciais do seu aplicativo, e passa a pedir em linguagem natural: "como está a ocupação agora?", "qual foi a curva ABC do mês passado?", "lance a despesa de energia deste mês".

São 50 ferramentas, respeitando exatamente as permissões configuradas no aplicativo:

Consultas: status das suítes, ocupações, preços e tabela de preços, dashboards, relatórios gerenciais, finanças (KPIs, DRE, extrato, contas a pagar), estoque, reservas, metas e satisfação (NPS + nota do Google);
Lançamentos: criar despesas, receitas e notas de entrada no estoque — com chave de integração, então uma retentativa do assistente não duplica nada, e tudo registrado no log de atividades. As ferramentas só criam: nunca excluem, quitam ou alteram o que já existe;
Cadastros: uma ferramenta de listagem por entidade (motel_cadastros_listar_fornecedores, ..._clientes, ..._grupos_despesa, ..._contas, ..._produtos, ..._funcionarios...) deixa o assistente descobrir com segurança os ids antes de lançar, e as de criação (motel_cadastros_criar_fornecedor, ..._cliente, ..._grupo_despesa, ..._marcador, ..._operador, ..._funcionario) criam os cadastros simples — sempre sem tocar em credenciais.

Quando falta uma informação — o grupo da despesa, o cargo do funcionário —, o servidor pode perguntar direto a você, mostrando a lista de opções do seu cadastro para escolher, em vez de errar ou inventar; em clientes que ainda não suportam esse recurso, o assistente consulta as ferramentas de listagem e segue o fluxo normalmente.

O passo a passo da conexão — no Claude, no ChatGPT (site ou aplicativo para computador com o Codex) e no Claude Code — está no tutorial Como conectar o Claude ou o ChatGPT ao Motel+ com o MCP, com vídeo.

Boas práticas para fechar

Um aplicativo por integração, com o mínimo de permissões — revogar uma chave não derruba as outras.
Sempre envie integracaoId nas escritas e reenvie a mesma chave nas retentativas.
Leia o campo erro: as mensagens vêm em português e dizem o que corrigir; em caso de erro interno, anote o traceId para o suporte.
Respeite o limite de 100 requisições/minuto: para volumes grandes, prefira as rotas paginadas, as consultas por período e o webhook de status em vez de chamadas item a item.
Guarde o token no servidor do seu sistema, nunca em páginas ou aplicativos distribuídos aos clientes; se vazar, Revogar Chave.
Explore a documentação interativa em api.motelmais.com.br/scalar/v1 — todas as rotas, com os modelos de requisição e resposta, direto do servidor.

Dúvidas na configuração ou precisa de uma permissão que ainda não existe? Fale com o nosso suporte — a API evolui junto com as integrações dos clientes.

ToHospedado Reservas: reservas online com PIX, integradas à Recepção

2026-09-26T14:03:27Z

O ToHospedado Reservas é o novo motor de reservas online do Motel+. Cada motel ganha uma página própria em reservas.tohospedado.com.br, onde o cliente escolhe a suíte, paga o sinal por PIX e recebe a confirmação em segundos. Do lado de dentro, a reserva entra sozinha na Recepção, com o valor pago já lançado como pagamento antecipado, e toda a configuração é feita pelo Gerencial Web. Nada de planilha, WhatsApp de madrugada ou reserva anotada no caderno.

Este post mostra o caminho completo: o que o cliente vê, o que acontece na Recepção, como configurar e quanto custa.

O que o cliente vê

A porta de entrada é o diretório do Tô Hospedado: uma vitrine com os motéis cadastrados, a disponibilidade em tempo real (quantas suítes livres neste momento), o preço "a partir de" e as comodidades de cada casa. O cliente pode filtrar por hidromassagem, piscina, pernoite ou reserva para depois. Quem chega pelo link direto do motel (no Instagram, no Google ou no WhatsApp) cai direto na página dele.

A página do motel usa a identidade da casa: logo, foto de capa, cores, slogan e galeria. O botão de WhatsApp fica fixo na tela para tirar dúvidas, e a seção de localização mostra o mapa e os contatos. Tudo vem do cadastro no Gerencial.

Passo 1: escolher a suíte

As categorias aparecem com foto, descrição, itens em destaque e as ofertas que o motel decidiu vender online: períodos de 2h, 3h, 6h, pernoite. A etiqueta verde mostra quantas suítes daquela categoria estão livres agora, informação que a Recepção envia a cada poucos segundos. Os preços são calculados pela mesma tabela de preços do Gerencial, respeitando dia da semana, feriados e datas especiais, para a data e hora escolhidas.

Há dois modos de reservar. Ir agora garante a suíte para quem já está a caminho: a entrada é contada em até 30 minutos e há uma tolerância de chegada configurável. Ir depois permite escolher data e hora dentro dos limites que o motel definiu (antecedência mínima, quantos dias à frente, horários e intervalo entre horários).

Passo 2: personalizar e identificar-se

O resumo mostra a categoria, o período, entrada e saída previstas, o valor da hospedagem e, em destaque, quanto será pago agora (sinal + taxa de reserva) e quanto fica para a entrada. Abaixo, o cliente pode incluir combos e produtos que o motel oferece no site (decoração romântica, espumante, café da manhã) e aplicar um cupom de desconto, os mesmos cupons promocionais do cadastro do Gerencial.

O cadastro pede CPF, nome, nascimento, celular e e-mail, e o cliente precisa aceitar os termos da reserva (o texto dos termos é montado com os valores e prazos do motel). Não existe senha: quando um CPF já cadastrado volta a reservar, o site envia um código de 6 dígitos por e-mail e o cliente só confirma o código. O mesmo mecanismo dá acesso à área "Minhas reservas".

Passo 3: confirmação da recepção e pagamento

Ao confirmar, o site pede à Recepção do motel que reserve uma suíte. A Recepção escolhe a suíte livre, cria a reserva local e responde em poucos segundos. Se não houver suíte naquele momento (alguém acabou de entrar), o cliente é avisado na hora, sem pagar nada.

Com a suíte reservada, aparece o PIX com QR Code, o código copia-e-cola e um relógio: o cliente tem alguns minutos (configurável) para pagar, senão a reserva expira e a suíte é liberada. O pagamento cai na conta do próprio motel, pela mesma integração PIX já usada na Recepção (Sicredi ou Mercado Pago), e a confirmação é automática assim que o banco avisa.

Pronto: o cliente vê o localizador, a suíte, o horário de entrada e o que resta pagar no motel, e recebe os detalhes por e-mail. Cada mudança de situação também gera um e-mail: reserva aprovada, paga, expirada, cancelada. Enquanto não pagou, o cliente pode desistir pelo próprio site; depois do pagamento, o cancelamento é feito com o motel.

Em Minhas reservas, o cliente acompanha o histórico com a situação de cada uma (confirmada, cancelada, não confirmada) e abre os detalhes. Tudo isso funciona bem no celular, que é de onde a maioria das reservas vai chegar.

O que acontece na Recepção

A integração roda dentro da Recepção que o motel já usa, no terminal principal, sem instalar nada. A cada poucos segundos ela:

envia ao site a disponibilidade de cada categoria (quantas suítes livres) e confirma que os preços do site estão iguais aos da tabela local;
recebe as pré-reservas novas, escolhe a suíte e cria a reserva no sistema como uma reserva normal, com o cliente cadastrado, os produtos escolhidos e o cupom aplicado. O motel pode escolher se suítes em limpeza ou sujas contam como disponíveis para "ir agora" e quais suítes nunca entram no site;
quando o pagamento é confirmado, lança o valor como pagamento antecipado na reserva, na forma de pagamento que o motel escolheu (a taxa de reserva pode ir separada, em outra forma de pagamento), e marca a reserva com o marcador configurado, um para "ir agora" e outro para "ir depois";
avisa o site quando a reserva vira ocupação (check-in), quando o cliente sai (check-out), quando é cancelada na recepção ou quando o cliente não aparece (no-show). O cliente vê a situação atualizada na área dele.

Na prática, para quem está na recepção, a reserva do site é igual a qualquer outra reserva do Motel+: aparece na lista, tem o cliente, tem o antecipado, e a entrada acontece do jeito de sempre. A diferença é que ninguém precisou digitar nada.

Configuração no Gerencial Web

Tudo fica em Cadastros → Avançado → Reservas Online (site). O painel de situação no topo diz se a Recepção está conectada, quando os preços foram atualizados, quantas categorias estão ativas, se o pagamento está configurado, quantas reservas entraram hoje e quantas ainda estão pendentes na recepção. Os botões reenviam o cadastro inteiro para o site, atualizam a situação e ativam ou desativam a página.

A aba Página monta a identidade: nome exibido, slogan, endereço da página (o "slug" que vira o link), tema claro ou escuro, cores, texto da capa e o texto "sobre o motel". Logo, capa e galeria (até 30 fotos) são enviadas ali mesmo, e o contato e a localização podem ser preenchidos a partir do cadastro da empresa.

Em Valores e prazos o motel define o que o cliente paga no site: a taxa de reserva (mínimo R$ 10,00, receita do motel) e o antecipado, que pode ser um valor fixo ou um percentual da hospedagem, com ou sem os combos no cálculo. Também ficam ali os prazos: quantos segundos a recepção tem para confirmar, quantos minutos o cliente tem para pagar, tolerâncias de chegada e de início do período, e o limite de reservas pendentes por cliente.

A aba Recepção diz como a reserva entra no sistema: forma de pagamento do antecipado, forma de pagamento da taxa (opcional, separada), intervalo de verificação, marcadores para "ir agora" e "ir depois", suítes que nunca entram no site e as opções de somar a taxa ao valor da hospedagem, gravar o valor cobrado no site como valor negociado e oferecer suítes em limpeza ou sujas como disponíveis.

Combos e cupons escolhe quais produtos do cadastro aparecem no site, com nome, descrição, preço e foto próprios (o preço no site pode ser diferente do balcão), opcionalmente restritos a algumas categorias. Os cupons promocionais que tiverem um código de cliente cadastrado podem ser aceitos no site. Na aba Pagamento, o PIX usa a integração já configurada na Recepção (Sicredi ou Mercado Pago) e há uma proteção contra robôs opcional. O pagamento com cartão de crédito pelo Mercado Pago já aparece na tela e será liberado na próxima etapa do beta.

Categorias no site

Em Cadastros → Categorias no Site, cada categoria de suíte ganha a versão para o público: se aparece ou não, a ordem, a descrição, os itens da suíte com ícone (hidromassagem, piscina, ar-condicionado, TV, garagem...) e quais vão em destaque no cartão, as ofertas que o cliente pode reservar (períodos normais em minutos e pernoite, cada uma valendo para "ir agora", "ir depois" ou ambos) e até 12 fotos, com a escolha da capa. Os preços não são digitados: vêm da tabela de preços na hora da reserva.

Reservas do site

Em Cadastros → Reservas do Site ficam todas as reservas feitas online, com filtro por período e situação. O detalhe mostra o cliente, os valores (hospedagem, produtos, desconto, antecipado, pago no site, restante no motel, taxa), a suíte e a reserva local correspondente, o pagamento com a referência do banco e a linha do tempo (criada, aprovada, paga). Dali o gestor também pode cancelar uma reserva.

O dinheiro é do motel

O ToHospedado Reservas não intermedia pagamento. O PIX é gerado na conta do motel, pela integração que a Recepção já usa, e o valor cai direto lá. A taxa de reserva cobrada do cliente é receita do motel. O restante da hospedagem e os produtos são pagos na entrada, como sempre. Não há repasse, retenção nem comissão por reserva.

Como ativar

Atualize a Recepção do terminal principal e o Gerencial Web para as versões mais recentes (o suporte confirma isso na ativação);
Confira a integração PIX na Recepção (Sicredi ou Mercado Pago), que será usada pelo site;
No Gerencial, preencha a aba Página (nome, slug, fotos, cores), as Categorias no Site e a aba Pagamento;
Clique em Ativar. A página fica no ar em reservas.tohospedado.com.br/seu-motel e o link pode ir para o Instagram, o perfil do Google e o WhatsApp do motel.

Quer entrar no piloto? Fale com o nosso suporte para entrar na fila de espera e realizarmos a ativação com você.

Preços

O ToHospedado Reservas está em fase beta, e durante essa fase é gratuito por 6 meses para os clientes do Motel+ que ativarem. Depois desse período, o serviço custa R$ 169,00 por mês, um valor fixo: sem taxa por reserva, sem percentual sobre o pagamento, sem limite de reservas. A taxa de reserva paga pelo cliente continua sendo do motel.

É um pré-requisito ter a assinatura do Plano Prime que possui integração de meios de pagamentos como TEF, PIX Sicredi e Mercado Pago que são necessários para o funcionamento do serviço.

Gerencial Web 58: Habilidades de IA, análise dos áudios da saída e API Plug & Play ampliada

2026-09-26T14:03:29Z

[youtube:y4N7_WbEKJs]

Esta atualização do Gerencial Web inaugura as Habilidades de IA: a primeira delas ouve as gravações do atendimento na saída, transcreve a conversa e avisa o gestor quando algo merece atenção. Junto com ela chegam o relatório de Auditoria reorganizado, com os áudios da saída como nova dimensão, o relatório da Pesquisa de Satisfação renovado e uma ampliação grande da API de Integração Plug & Play.

Habilidades de IA: a conversa da saída, analisada

Quem já grava o áudio do momento em que a conta é mostrada e o carro chega na saída. Até agora, ouvir essas gravações era um trabalho manual, comanda por comanda. A nova habilidade Verificar áudio do atendimento na saída faz isso pelo gestor, todos os dias:

Detecção de áudio mudo: o agente do MotelMais mede o som de cada gravação e aponta as que não têm voz nenhuma, sinal de microfone desligado ou com defeito. Essa verificação roda sempre, com ou sem IA;
Transcrição e análise: com a habilidade ligada, cada atendimento é transcrito e analisado. Para cada áudio a IA gera um resumo da conversa, o sentimento (positivo, neutro ou negativo), uma nota de 1 a 5 para o atendimento, as categorias do assunto (pagamento, consumo, reclamação, problema na saída, segurança e outras) e os pontos de atenção que valem uma conferência;
Alerta para o gestor: conflito, reclamação, cobrança contestada ou linguagem inadequada marcam o áudio com a tag Atenção, que sobe direto para o relatório de Auditoria;
Inconclusivo: gravações curtas ou fragmentadas, sem informação suficiente para avaliar o atendimento, recebem uma tag cinza em vez de virar alerta, para não poluir o relatório.

O resultado aparece nos detalhes da comanda, logo abaixo de cada áudio: as tags, o resumo, as categorias, os pontos de atenção e um link para ver a transcrição completa. O player continua ali, para ouvir o trecho quando a análise chamar a atenção.

Como ativar

A configuração fica no menu Avançado → Habilidades de IA (permissão de Definições Gerais). A análise usa a API da OpenAI com a chave do próprio motel: o consumo é cobrado pela OpenAI diretamente de você, sem intermediação do MotelMais. A chave é gravada criptografada no servidor e não é exibida novamente depois de salva, apenas os últimos caracteres para conferência.

Quer testar antes de criar a sua chave? Nos detalhes de qualquer comanda com áudio, o botão Transcrever com IA faz uma amostra por dia por conta do MotelMais. Com a chave própria configurada, o mesmo botão transcreve na hora, sem limite, e a verificação automática diária passa a cobrir todas as saídas.

Auditoria: os áudios da saída entram no relatório

O relatório de Auditoria ganhou uma nova dimensão, Áudios da saída, e foi reorganizado para ficar mais fácil de ler:

Resumo em quatro grupos: Comandas, Equipamentos, Ocupações e Áudios da saída. Clicar em um indicador abre e rola até a seção correspondente;
Seções recolhíveis: cada bloco virou um painel com título, quantidade e botão de expandir. A escolha de quais ficam abertos é lembrada no navegador, e a barra de ações tem botões para expandir ou recolher todas;
Áudios da Saída: quantas saídas tiveram áudio gravado, quantos áudios foram analisados, quantos estão mudos, quantos foram transcritos pela IA (com a divisão entre positivos, neutros, negativos e inconclusivos) e quantos geraram alerta. Quando todos os áudios do mês estão sem som, o relatório destaca em vermelho: o microfone da recepção pode estar desligado;
Áudios com Alerta da IA: um card por gravação com a suíte, a data, o sentimento, o resumo e as categorias. O clique abre a comanda com o player e a análise completa.

Na tela principal, o card Resumo Auditoria e a auditoria do Dashboard Multiempresa também passaram a mostrar os áudios gravados e os mudos no mês, com a taxa entre parênteses. É a forma mais rápida de saber se a captação está funcionando em cada unidade.

Pesquisa de Satisfação: relatório com indicadores

O relatório da Pesquisa de Satisfação foi redesenhado no mesmo padrão da auditoria:

Indicadores no topo: o NPS com a zona colorida e a barra de promotores, neutros e detratores; a nota do Google com as estrelas e o total de avaliações; a quantidade de respostas e o período da pesquisa;
Resultados por pergunta com barras de distribuição das respostas;
Avaliações do Google em cards, com o avatar do autor, a nota e o comentário expansível;
Respostas com o card redesenhado: selo do NPS colorido por faixa, suíte, entrada e saída, o contato do cliente em chips (só os campos preenchidos), o comentário em destaque e as respostas em grade por pergunta.

Os painéis também são recolhíveis, com o estado lembrado no navegador.

API de Integração Plug & Play: mais dados, com consentimento explícito

Para quem conecta outros sistemas ou assistentes de IA ao Motel+, a API deu um salto. A tela de Permissões da API no cadastro do aplicativo foi refeita: as permissões ficam agrupadas por área, com contador, checkbox para marcar o grupo inteiro, botões de marcar e desmarcar todas e um filtro por texto. O botão de informação ao lado de cada permissão mostra exatamente quais rotas ela libera.

São 14 permissões novas, e as que expõem dados sensíveis vêm com uma tarja de aviso: relatórios de faturamento completo, estatística de recorrência por placa (LGPD) e os grupos sigilosos do Finanças só devem ser habilitados com o consentimento do proprietário. As permissões passam a valer imediatamente após salvar, inclusive para as ferramentas de IA.

Do lado da API, as novidades principais:

Dashboard e Metas: os indicadores do mês, do dia e os comparativos, além da leitura e definição da meta mensal;
Estoque: saldo, kardex, movimentações, sugestão de compra, valorização, notas de saída, transferências entre setores e montagem de kit. A auditoria de estoque fica disponível só para consulta: abrir, contar e concluir continuam exclusivos do Estoque Web;
Finanças: clientes, contas, grupos de receita e despesa, receitas e despesas (com quitação e estorno), DRE e relatórios;
Cadastros: suítes, categorias, modalidades, grupos de produto, bandeiras, e agora também funcionários e operadores, sempre sem login e senha, que continuam sendo definidos apenas dentro do sistema;
Pesquisa de Satisfação: a nota do Google e as avaliações mais recentes, na mesma fonte do relatório do Gerencial;
Rotas v2 com respostas mais limpas para reservas, ocupações (paginadas), status das suítes, produtos, notas de entrada e a cobrança atual de uma suíte;
Chave de integração: todo lançamento pode levar um identificador do sistema de origem. Se a mesma requisição for reenviada, a API devolve o registro original em vez de duplicar a receita, a despesa ou a nota;
Erros em português: parâmetro desconhecido ou obrigatório ausente responde com a lista do que é aceito, e as mensagens de validação vêm em português, com um identificador para o suporte rastrear.

Assistentes de IA (MCP)

O conector para assistentes como o Claude e o ChatGPT também cresceu. Além das consultas (dashboard, ocupações, relatórios, estoque, finanças, reservas, satisfação e metas), o assistente agora pode lançar despesas, receitas e notas de entrada e criar cadastros simples: fornecedores, clientes, grupos de despesa e receita, marcadores, operadores e funcionários. Cada tipo de cadastro tem a sua própria ferramenta de listagem, então o assistente encontra o fornecedor ou o grupo certo pelo nome antes de gravar. Quando falta uma informação, como o grupo de uma despesa, ele pergunta ao usuário em vez de adivinhar, e as regras de negócio (cargo obrigatório, CPF repetido, nome duplicado) voltam como mensagens claras, em português, para o assistente se corrigir.

Tudo isso respeita as permissões marcadas na tela acima: um aplicativo só consulta ou grava o que o proprietário liberou.

As novidades já estão disponíveis na sua conta do Gerencial Web. A habilidade de IA depende da gravação de áudio na saída e da chave da OpenAI do motel; se quiser ajuda para configurar, fale com o nosso suporte.

Gerencial Web 57.0 — Dashboard Multiempresa, ícones no cadastro de produtos e conciliação com a Rede

2026-09-26T14:03:32Z

Esta atualização do Gerencial Web chega com uma novidade grande para quem administra mais de uma unidade — o novo Dashboard Multiempresa — e uma série de melhorias no dia a dia: cadastro de produtos mais transparente, conciliação de cartões com a adquirente Rede, fotos dos pratos nos pedidos e novas opções de exportação e impressão.

Dashboard Multiempresa: a rede inteira em uma tela

Quem opera várias unidades ganhou um painel consolidado, disponível no menu Multiempresa → Dashboard. Ele reúne, em uma única tela, a fotografia da rede agora e o desempenho do período:

Status em tempo real: uma barra com a composição de todas as suítes da rede por status (livre, ocupada, limpeza, interditada e demais status) e um card por unidade com a mesma leitura;
Indicadores consolidados: Ocupações e Valores com projeção do mês, Ticket Médio, Taxa de Ocupação, RevPAR, Consumo, Percentual de Consumo e Média de Valor por Dia — sempre comparando com o mês anterior e com o mesmo período do ano anterior;
Metas da rede: defina a meta mensal de valor e de ocupações direto no painel e acompanhe o percentual de atingimento;
Gráficos: evolução do faturamento total, participação de cada unidade, mini-gráficos por motel e formas de pagamento agregadas;
Auditoria consolidada: edições de comandas, negociações, cancelamentos, descontos, ocupações com porta aberta e outros eventos de atenção, somados por toda a rede;
Análises de ocupação: por modalidade (normal e pernoites), por marcadores e, com base na placa do veículo, a proporção entre novos clientes e recorrentes.

O painel funciona nos modos Mensal, Anual e por Período, e usa os logins ativos da tela de entrada — cada usuário enxerga apenas as unidades às quais tem acesso.

Cadastro de Produtos: características visíveis no card

Na listagem de produtos, aqueles pequenos quadrados coloridos deram lugar a ícones explícitos, cada um com uma dica ao passar o mouse: estoque controlado, produto composto, ingrediente de outro produto, emissão de NFC-e e disponibilidade no cardápio digital.

E o card passa a indicar também duas configurações que antes ficavam escondidas nas Informações Adicionais:

Horário de vendas — o relógio mostra que o produto tem dias e horários definidos para aparecer no cardápio digital;
Preço dinâmico — o produto tem preços diferentes por dia da semana ou data especial.

Assim dá para conferir de relance quais produtos têm essas regras ativas, sem abrir um a um. Ao salvar as Informações Adicionais, o card reflete a mudança na hora — e agora também é possível excluir uma regra de preço dinâmico que não faz mais sentido.

Conciliação de cartões com a adquirente Rede

A conciliação automática de pagamentos, que já funcionava com a Stone, agora também se integra com a Rede. A configuração ficou centralizada: a tela de Configuração da Adquirente ganhou abas separadas para cada integração, no mesmo lugar.

No fechamento de caixa (modo Pagamentos), o card Conciliação Adquirente também ficou mais informativo: exibe os logos das adquirentes e o período exato que foi conciliado, além dos totais de conciliados e divergências.

Fotos dos pratos no relatório de Pedidos

Para os motéis que usam o Painel da Cozinha com câmera, o relatório de Pedidos passou a exibir a foto tirada no momento em que o pedido é finalizado — incluindo as fotos individuais de cada item — com um visualizador ampliado ao clicar. O relatório também recebeu um visual renovado, mais limpo para conferência.

Camareiras no Mês agora soma os Pedidos

O card Camareiras no Mês, na tela Flow, ganhou a métrica de Pedidos por camareira, alinhada ao relatório de desempenho geral — mais uma dimensão para acompanhar a produtividade da equipe.

Importação de produtos com conferência completa

A importação de produtos via Excel — tanto a de campos gerais quanto a fiscal — agora mostra uma tela de conferência antes de aplicar qualquer alteração: o que será criado, o que muda em cada produto, campo a campo, e a opção de desmarcar itens que não devem entrar. Nada é gravado sem a sua confirmação.

Na exportação fiscal, uma nova opção permite gerar a planilha apenas com os produtos que têm preço de venda, deixando o arquivo mais enxuto para revisão contábil.

Novas exportações e impressões

Registros da Suíte: o relatório agora pode ser salvo em Excel e aberto em página de impressão;
Caixas Agrupado Mensal: ganhou exportação em página de impressão, pronta para arquivar ou imprimir.

API de Integração (Plug & Play)

Para quem conecta outros sistemas ao Motel+, a configuração da API ganhou o webhook de status das suítes — o aplicativo integrado é avisado em tempo real quando uma suíte muda de status — e novas permissões para notas de entrada e fornecedores.

As novidades já estão disponíveis na sua conta do Gerencial Web — basta acessar normalmente pelo navegador. Em caso de dúvida sobre qualquer um dos recursos, fale com o nosso suporte.

Extração de Mídia: backup local das imagens e áudios do sistema

2026-09-26T14:03:34Z

A Extração de Mídia é uma ferramenta para Windows que copia para um computador do motel, automaticamente, as mídias que o sistema gera e guarda na nuvem do Motel Mais: as imagens registradas nas ocupações, os áudios do atendimento, as imagens da galeria e as capturas de tela da recepção. Ela fica na bandeja do sistema, ao lado do relógio, e vai baixando o que ainda não foi copiado, sem ninguém precisar operar.

Com ela o motel mantém uma cópia própria desse acervo, no seu computador ou numa unidade de rede, organizada por tipo, ano e mês, com cada arquivo nomeado de um jeito que permite saber de qual ocupação ele é, quando foi gerado e em que momento do atendimento.

Como funciona

A ferramenta se identifica no servidor pela empresa e pela placa de rede do computador. Só o computador registrado pelo suporte consegue baixar as mídias da empresa.
A cada 5 minutos ela consulta a nuvem. Havendo mídia ainda não copiada, baixa uma a uma, do registro mais recente para o mais antigo, com uma pausa de 2 segundos entre os arquivos.
Cada arquivo gravado é confirmado ao servidor. Por isso nada é baixado duas vezes, e a cópia continua de onde parou se o computador for desligado.
Os arquivos vão para a pasta de backup escolhida, separados por tipo de mídia, ano e mês.

Ativação: precisa do suporte

Este é o detalhe mais importante. A ferramenta só começa a baixar depois que o suporte do Motel Mais registrar o computador para a sua empresa. O registro é feito pela placa de rede, que aparece na tela, no cartão Conexão.

Abra a ferramenta, informe o ID da empresa no cartão Conexão, escolha a pasta de backup e clique em Salvar.
Em alguns segundos ela tenta se conectar. Enquanto o computador não estiver registrado, o status no alto da janela mostra Computador não registrado e a lista de atividade explica o que fazer.
Clique em Copiar, ao lado da placa de rede, e envie ao suporte a placa junto com o ID da empresa.
Feito o registro, não é preciso fazer mais nada: na checagem seguinte a ferramenta reconhece o computador e começa a baixar. Se preferir não esperar, clique em Sincronizar agora.

A cada tentativa a ferramenta envia um ping com a placa ao servidor, o que ajuda o suporte a localizar o computador na hora de registrar. Só um computador por empresa fica registrado. Se o motel trocar o computador, ou a placa de rede dele, é preciso pedir um novo registro.

Configurando

Empresa e conexão

Empresa (ID): o número da sua empresa no Motel Mais, o mesmo usado para entrar nos aplicativos. Vem em branco (0) na primeira abertura, e a ferramenta não sincroniza enquanto ele não for informado.
Placa de rede deste computador: detectada sozinha, não se edita. É o que o suporte registra. O botão Copiar coloca o valor na área de transferência para colar na mensagem ao suporte.
Servidor de mídia: já vem preenchido. Não altere, a não ser por orientação do suporte; o botão Padrão restaura o endereço original.

Pasta de backup

É o destino dos arquivos. Pode ser uma pasta do próprio computador ou uma unidade de rede, desde que esteja acessível quando a ferramenta rodar. Procurar… abre o seletor de pastas e Abrir mostra a pasta no Explorador de Arquivos. Reserve espaço: as capturas de tela da recepção, em especial, são geradas com frequência.

O que arquivar

Tipo	O que é	Arquivo
Screenshots da recepção	Capturas de tela do computador da recepção feitas pelo sistema	.jpg
Áudios de atendimento	Gravações do atendimento de cada ocupação	.mp3
Imagens da ocupação	Fotos registradas nos eventos de cada ocupação (entrada, conta, saída, cancelamento…)	.jpg
Imagens da galeria	Registros da galeria de imagens do sistema	.jpg

Ligue só o que interessa guardar. Os tipos são baixados na ordem em que aparecem no cartão.

Ritmo e sincronização automática

Sincronização automática: ligada, a ferramenta trabalha sozinha em segundo plano. Desligada, ela só baixa quando você clicar em Sincronizar agora.
Checar pendências a cada (minutos): intervalo entre as consultas à nuvem quando não há nada pendente. O mínimo é 5 minutos.
Pausa entre downloads (segundos): descanso entre um arquivo e o próximo quando há fila. O mínimo é 2 segundos.
Iniciar minimizado na bandeja: ao abrir, a ferramenta fica só no ícone ao lado do relógio, sem mostrar a janela.

Os dois tempos podem ser aumentados, mas não reduzidos: valores abaixo do mínimo são corrigidos ao salvar. Isso mantém a extração leve para o servidor da nuvem, que atende todos os motéis ao mesmo tempo.

Depois de qualquer mudança, clique em Salvar, no canto inferior direito.

Acompanhando o trabalho

O lado direito da janela mostra o que está acontecendo.

Pendências na nuvem é a quantidade de mídias de cada tipo que ainda não foram copiadas, atualizada a cada checagem. Abaixo, quantos arquivos foram gravados desde que a ferramenta foi aberta e quantas falhas houve.

Atividade registra cada arquivo baixado, com hora e tamanho, além de avisos e erros. O histórico completo fica gravado em arquivo, na pasta C:\Oxpi\MotelPlus\Log\MediaBackup, um por dia.

O status no alto da janela resume a situação:

Baixando: há fila e a ferramenta está copiando o tipo indicado.
Em dia: tudo o que existe na nuvem já está na pasta de backup. A próxima checagem aparece ao lado.
Computador não registrado: falta o registro pelo suporte (veja acima).
Pausado, Concluído com avisos ou Falha na última sincronização: veja a lista de atividade, que diz o motivo.

Na barra inferior: Sincronizar agora faz uma checagem imediata (respeitando um intervalo de 30 segundos entre cliques), Pausar interrompe o que estiver em andamento e segura as próximas checagens até Retomar, e Abrir pasta de backup mostra os arquivos no Explorador.

Fechar a janela não encerra a ferramenta: ela continua na bandeja, ao lado do relógio. Um clique no ícone reabre a janela; o botão direito mostra o menu com Abrir, Sincronizar agora, Pausar e Sair, que é a única forma de encerrar de fato.

Como os arquivos ficam gravados

Dentro da pasta de backup, cada tipo de mídia tem a sua subpasta, e dentro dela os arquivos ficam separados por ano e por mês (o mês por extenso, em maiúsculas):

Pasta de backup\
  Imagem Ocupacao\
    2026\
      AGOSTO\
      SETEMBRO\
        0000012345__2026_09_02_14_30_00__Ocupando.jpg
  Audio Ocupacao\
    2026\
      SETEMBRO\
        0000012345__2026_09_02_14_31_10__Ocupando.mp3
  Imagem Galeria\
    2026\
      SETEMBRO\
        0000035154__2026_09_02_11_39_43__Documento.jpg
  Imagem Recepcao\
    2026\
      SETEMBRO\
        0000619949__2026_09_02_15_26_31__foco_nao__exec_sim.jpg

O nome de cada arquivo é montado com os dados do próprio registro, separados por dois sublinhados. É isso que torna cada arquivo identificável mesmo fora do sistema:

Tipo	Formato do nome	Significado de cada parte
Imagem da ocupação	`NNNNNNNNNN__AAAA_MM_DD_HH_MM_SS__Evento.jpg`	número da ocupação, data e hora do registro, evento em que a imagem foi feita
Áudio de atendimento	`NNNNNNNNNN__AAAA_MM_DD_HH_MM_SS__Evento.mp3`	número da ocupação, data e hora da gravação, evento
Imagem da galeria	`NNNNNNNNNN__AAAA_MM_DD_HH_MM_SS__Evento.jpg`	número da imagem na galeria, data e hora, evento
Screenshot da recepção	`NNNNNNNNNN__AAAA_MM_DD_HH_MM_SS__foco_sim__exec_sim.jpg`	número da captura, data e hora, se o sistema estava com a janela em foco (`foco_sim`/`foco_nao`) e se estava em execução (`exec_sim`/`exec_nao`) no momento da captura

O número da ocupação é o mesmo que aparece no sistema e nos relatórios do Gerencial Web. Com ele você localiza a ocupação, o cliente e a suíte. Ele vem com dez dígitos, completado com zeros à esquerda, para que os arquivos fiquem em ordem quando listados por nome.
A data e hora vêm no formato ano, mês, dia, hora, minuto e segundo, que também ordena corretamente.
O evento diz em que momento do atendimento a mídia foi gerada: Ocupando (ocupação automática), OcupandoManual (ocupação manual), OcupandoPortaCliente (ocupação pela porta do cliente), EntradaTemCarro (carro chegou na entrada), MostrandoConta (conta sendo mostrada), SaidaTemCarro (carro chegou na saída), Cancelando (cancelamento), Documento (documento registrado) e Nenhum (sem evento associado).

Assim, um arquivo chamado 0000012345__2026_09_02_14_30_00__MostrandoConta.jpg, na pasta Imagem Ocupacao\2026\SETEMBRO, é a imagem registrada na ocupação 12345, em 2 de setembro de 2026 às 14h30, no momento em que a conta estava sendo mostrada.

Perguntas frequentes

Aparece "Computador não registrado". Falta o registro pelo suporte. Copie a placa de rede e envie junto com o ID da empresa.
Aparece "Servidor inacessível". O computador está sem internet, ou o endereço do servidor foi alterado. Confira a conexão e, se o endereço tiver sido mexido, clique em Padrão e em Salvar.
Aparece "arquivo indisponível no servidor" na atividade. O registro existe na nuvem, mas o arquivo em si não está mais lá. A ferramenta anota o aviso e segue para o próximo; nada precisa ser feito.
Posso deixar mais rápido? Não. Os tempos mínimos existem para a extração não pesar no servidor da nuvem. A ferramenta trabalha o dia inteiro e coloca em dia mesmo um acervo grande, sem intervenção.
Desliguei o computador no meio. Perdi algo? Não. Só os arquivos gravados e confirmados saem da fila; ao religar, a cópia continua de onde parou.
Posso usar em dois computadores? Não. O registro vale para um computador por empresa. Para trocar, peça ao suporte um novo registro.
A ferramenta sumiu. Ela provavelmente está na bandeja, ao lado do relógio (às vezes escondida na seta de ícones ocultos). Um clique no ícone reabre a janela.

Em caso de dúvida, fale com o suporte do Motel Mais informando o ID da empresa e, se possível, a mensagem que aparece na lista de atividade.

Estoque Web 11.2.0

2026-09-26T14:03:36Z

A versão 11.1.0 traz melhorias na experiência de uso do Estoque Web, com uma tela inicial mais informativa e maior flexibilidade no processo de auditoria de estoque.

📊 Tela inicial com novos cards informativos

A página inicial do Estoque Web foi aprimorada com novos cards informativos, oferecendo uma visão mais rápida dos principais indicadores e facilitando o acompanhamento das operações logo ao acessar o sistema.

📦 Edição de itens durante a Auditoria de Estoque

O processo de auditoria ficou mais flexível.

Agora é possível editar os itens de uma auditoria enquanto ela estiver em andamento, permitindo corrigir informações ou realizar ajustes antes da conclusão da conferência.

Essa melhoria torna o processo de contagem mais prático, reduz a necessidade de recriar auditorias e facilita a correção de eventuais inconsistências durante o inventário.

Com essas melhorias, o Estoque Web 11.2.0 oferece uma experiência mais ágil para o controle e acompanhamento do estoque.