Configurações

A tela Configurações concentra as definições da empresa e do funcionamento do sistema, organizadas em cinco abas: Empresa, OS, E-mail, IA / Chat e Identidade.

Quem acessa

Perfil	Acesso
Super Administrador	Acessa as configurações de qualquer prestadora (e da base global)
Prestadora	Acessa apenas as configurações da própria empresa

Aba: Empresa

Dados cadastrais da empresa — visível apenas para o Super Administrador. Essas informações aparecem nos documentos gerados pelo sistema (termos e relatórios).

Campo	Tipo	Obrig.	Descrição
Tipo de Pessoa	Seleção (Pessoa Jurídica / Pessoa Física)	Sim	Define se o cadastro usa CNPJ ou CPF. Ao trocar, o documento é limpo
Razão Social (PJ) / Nome Completo (PF)	Texto	Sim	Nome oficial da empresa/pessoa
Nome Fantasia (apenas PJ)	Texto	Não	Nome comercial
CNPJ / CPF	Texto com máscara automática	Sim	Documento conforme o tipo de pessoa
CEP	Texto com máscara	Não	Com busca automática ao sair do campo (preenche logradouro, estado, cidade e bairro)
Logradouro	Texto	Não	Endereço da empresa
Número	Texto	Não	Número do imóvel
Complemento	Texto	Não	Sala, bloco, apto...
Estado (UF)	Seleção (27 UFs)	Sim	Ao trocar, cidade e bairro são limpos
Cidade	Seleção com busca	Sim	Só habilita depois do estado
Bairro	Seleção com busca	Não	Só habilita depois da cidade

Botão "Salvar dados" grava tudo.

Aba: OS

Regras e modelos das Ordens de Serviço (disponível para Super Administrador e Prestadora):

Campo	Tipo	Obrig.	Descrição
Modelo do termo de aceite	Upload de arquivo .docx	Não	O documento base usado para gerar o "Termo de Ciência e Conclusão". A aba mostra o status do modelo: configurado, disponível no sistema e/ou no disco, com o nome do arquivo
Variáveis de texto	Lista de tags	—	O modelo aceita campos automáticos preenchidos na hora da geração (veja a tabela abaixo)

Variáveis disponíveis

O modelo do termo aceita as variáveis abaixo (agrupadas por tema no formulário):

Variável	Significado
${OS_PROTOCOLO}	Número de protocolo da OS
${OS_TITULO}	Título da OS
${OS_DESCRICAO}	Descrição do serviço
${OS_STATUS}	Status atual
${OS_PRIORIDADE}	Prioridade
${OS_DATA_CRIACAO}	Data de criação
${OS_DATA_AGENDAMENTO}	Data agendada
${OS_DATA_EXECUCAO}	Data de início da execução
${OS_DATA_CONCLUSAO}	Data de conclusão
${OS_RESUMO_SOLUCAO}	Resumo da solução
${OS_MOTIVO_CANCELAMENTO}	Motivo do cancelamento
${OS_FEEDBACK_TECNICO}	Feedback do técnico
${OS_OBSERVACOES_INTERNAS}	Observações internas
${OS_PRAZO_RESPOSTA}	Prazo de resposta (SLA)
${OS_PRAZO_RESOLUCAO}	Prazo de resolução (SLA)

Cliente — ${CLIENTE_NOME}, ${CLIENTE_DOCUMENTO}, ${CLIENTE_TELEFONE}, ${CLIENTE_CELULAR}, ${CLIENTE_EMAIL}, ${CLIENTE_ENDERECO}, ${CLIENTE_NUMERO}, ${CLIENTE_COMPLEMENTO}, ${CLIENTE_CEP}, ${CLIENTE_REFERENCIA}, ${CLIENTE_OBSERVACOES} (observações do cadastro do cliente — preenchido automaticamente a partir do campo Observações da tela de Cliente; bloco CLIENTE_OBS — a linha só aparece se houver observações).

Localização — ${CIDADE_NOME}, ${CIDADE_UF}, ${BAIRRO_NOME}. Categoria — ${CATEGORIA_NOME}, ${CATEGORIA_DESCRICAO}, ${SUBCATEGORIA_NOME}.

Técnico (Prestador) — ${TECNICO_NOME}, ${TECNICO_EMAIL}, ${TECNICO_TELEFONE}, ${TECNICO_CELULAR}, ${TECNICO_ESPECIALIDADE}. Técnico Interno — ${TECNICO_INTERNO_NOME}, ${TECNICO_INTERNO_CPF}, ${TECNICO_INTERNO_EMAIL}, ${TECNICO_INTERNO_TELEFONE}.

Prestadora — ${PRESTADORA_NOME}, ${PRESTADORA_NOME_FANTASIA}, ${PRESTADORA_DOCUMENTO}, ${PRESTADORA_EMAIL}, ${PRESTADORA_TELEFONE}, ${PRESTADORA_ENDERECO}, ${PRESTADORA_NUMERO}, ${PRESTADORA_COMPLEMENTO}, ${PRESTADORA_CEP}, ${PRESTADORA_CIDADE}, ${PRESTADORA_UF}.

Empresa Global — ${EMPRESA_NOME}, ${EMPRESA_NOME_FANTASIA}, ${EMPRESA_DOCUMENTO}, ${EMPRESA_EMAIL}, ${EMPRESA_TELEFONE}, ${EMPRESA_ENDERECO}, ${EMPRESA_NUMERO}, ${EMPRESA_COMPLEMENTO}, ${EMPRESA_CEP}, ${EMPRESA_CIDADE}, ${EMPRESA_UF} — bloco SECAO_EMPRESA: só aparece quando a identidade real da executora vem do fallback global (templates antigos com ${EMPRESA} continuam funcionando).

Comodato (cliente) — ${COMODATO_QTD}, ${COMODATO_PRODUTO}, ${COMODATO_SERIAL}, ${COMODATO_DATA} — blocos COMODATO/COMODATO_ITEM: relacionam os equipamentos em comodato com o cliente da OS.

Materiais da OS — ${MATERIAIS_QTD}, ${MATERIAIS_PRODUTO}, ${MATERIAIS_SERIAL}, ${MATERIAIS_QTD_ITEM} — blocos MATERIAIS/MATERIAIS_ITEM: relacionam os materiais consumidos na OS.

Evidências — ${EVIDENCIAS_QTD} — bloco EVIDENCIAS: total de fotos/anexos da conclusão.

Assinatura — ${DATA_ASSINATURA}, ${HORA_ASSINATURA}, ${IP_ASSINATURA}, ${ASSINATURA_IMAGEM}.

Identidade / Logo — ${LOGO_IMAGEM}, ${FOOTER_TEXT}.

Aliases (templates antigos) — ${OS_DATA_ABERTURA} (→ criação), ${OS_DESCRICAO_INICIAL} (→ descrição), ${OS_RESOLUCAO_TEXTO} (→ resumo da solução), ${CLIENTE_CIDADE} (→ cidade), ${CLIENTE_ESTADO} (→ UF).

Termo dinâmico

O termo é totalmente dinâmico: seções (SECAO_*) e linhas (LINHA_*) envolvidas por ${NOME} ... ${/NOME} só aparecem no PDF quando há informação real — sem técnico atribuído, a seção de técnico some; sem equipamentos, a seção de comodato some. As seções visíveis são renumeradas automaticamente (1., 2., 3. ...) sem lacunas. Veja todas as variáveis e blocos em Termo de Conclusão.

Aba: E-mail

Configuração do envio de mensagens (termos, notificações e e-mails automáticos). O SMTP é o "servidor de envio" — a forma como o sistema entrega os e-mails. Geralmente estes dados são informados pelo responsável de TI da empresa.

Bloco: Servidor SMTP

Campo	Tipo	Obrig.	Descrição
Host SMTP	Texto	Sim	Servidor de envio (ex.: smtp.example.com)
Porta SMTP	Número	Não	Porta do servidor (ex.: 587)
Criptografia	Seleção (TLS / SSL / Nenhuma)	Não	Método seguro de conexão
Usuário SMTP	Texto	Não	Usuário de autenticação (ex.: user@example.com)
Senha SMTP	Senha	Não	Senha de autenticação. Se já existe configuração, deixe em branco para manter a atual
Configuração ativa	Caixa de seleção	Não	Habilita/desabilita o envio pela configuração

Bloco: Remetente

Campo	Tipo	Obrig.	Descrição
Nome do Remetente	Texto	Não	Nome exibido no envio (ex.: "LuariX OS")
E-mail Remetente	Texto (e-mail)	Não	Endereço de envio (ex.: nao-responda@empresa.com.br)
Reply-To	Texto (e-mail)	Não	E-mail que recebe as respostas (opcional)

Bloco: Testar Envio

Campo	Tipo	Obrig.	Descrição
E-mail de Teste	Texto (e-mail)	Sim (para testar)	Envia um e-mail de teste e mostra o diagnóstico (código, mensagem e categoria) do resultado

A aba ainda mostra o status/saúde da configuração (saudável, não configurada, inativa ou com falha), a origem (configuração própria ou configuração padrão do servidor), último teste/envio e o histórico de auditoria das alterações.

O que é SMTP?

SMTP é o nome técnico do "servidor de envio de e-mails" — a infraestrutura que entrega as mensagens do sistema. Na prática, basta copiar os dados fornecidos pelo seu provedor de e-mail (host, porta, usuário e senha).

Importante

Alterações nas credenciais de e-mail afetam o envio de todos os e-mails automáticos. Use a opção de teste para validar antes de salvar alterações críticas.

Aba: IA / Chat

Configuração do assistente de Inteligência Artificial usado no chat integrado das OS. A IA pode resumir conversas e sugerir respostas rápidas para o técnico.

Bloco: Provedor de IA

Campo	Tipo	Obrig.	Descrição
Provedor	Seleção (Ollama / OpenAI / Google Gemini)	Sim	Qual serviço de IA será usado para resumos e sugestões

Opções por provedor

Provedor	Campos	Custo	Observação
Ollama (Local)	URL do servidor + Nome do modelo	Grátis	Roda no seu servidor. Total privacidade, sem custo por mensagem. Padrão: llama3.2
OpenAI	API Key + Nome do modelo	~$0.01/mensagem	API da OpenAI (GPT). Rápido e preciso. Padrão: gpt-4o-mini
Google Gemini	API Key + Nome do modelo	15k mensagens/dia grátis	API do Google. Bom custo-benefício. Padrão: gemini-1.5-flash

Recomendação

Para quem tem um servidor com capacidade, o Ollama é a melhor opção: roda local, sem custo e com total privacidade. Para quem não tem infraestrutura, o Gemini oferece 15 mil mensagens grátis por dia.

Como funciona na prática

O gestor abre o chat de uma OS e clica em "Resumo" — a IA resume a conversa em poucas linhas. O técnico pode clicar em "Sugerir resposta" — a IA propõe uma resposta profissional que o técnico pode editar e enviar.

Aba: Identidade

Personalização da marca nos documentos. Para o Super Administrador, há também a lista de prestadoras para configurar a identidade de cada uma (com indicadores de logo, template e fallback).

Campo	Tipo	Obrig.	Descrição
Logotipo	Upload de imagem (PNG/JPG)	Não	Logo exibida nos documentos. O super-admin configura uma logo por prestadora, com fallback para a logo global quando a prestadora não tem a própria
Endereço de identidade	CEP + endereço + cidade/bairro	Não	O endereço exibido nos documentos, com CEP automático e seleção de cidade/bairro
Modelo do termo (por prestadora)	Upload de .docx	Não	Template exclusivo da prestadora, com preview/download; sem ele, usa o modelo global
Texto do rodapé	Texto	Não	Texto usado na variável ${FOOTER_TEXT} dos documentos

Aba Empresa: dados cadastrais e endereço.

Aba OS: modelo do termo de aceite com variáveis de preenchimento automático.

Aba E-mail: servidor SMTP, remetente e e-mail de teste.

Bloco Servidor SMTP: host, porta, criptografia e credenciais de envio.

Aba Identidade: logotipo e endereço usados nos documentos.

O super-admin configura a identidade (dados, logo e modelo do termo) de cada prestadora.