Desliguei uma forma de pagamento. O que acontece com o que já foi recebido nela?

Nada. A configuração filtra apenas a OFERTA: a forma some do balcão e a operação é recusada mesmo se for forçada, mas recibos, relatórios e o razão continuam mostrando os pagamentos antigos exatamente como foram feitos.

Como crio uma forma de pagamento que a clínica aceita e não está na lista?

Em Configurações → Formas de pagamento, bloco *Criar forma de pagamento*: dê o nome e escolha para onde o dinheiro vai. Essa segunda escolha é o que importa — ela define a conta do razão. "Dinheiro (espécie)" entra na gaveta, "recebimento em conta" vai para bancos, os dois de cartão geram recebível e entram na conciliação da maquininha, e "a prazo" fica como a receber do cliente até alguém dar baixa.

Posso excluir uma forma que criei?

Só enquanto ela nunca foi usada. Depois do primeiro recebimento o caminho é desativar: apagar deixaria o recibo antigo apontando para um código que não existe mais. As cinco formas do sistema nunca são excluídas — só desativadas.

Configurei 12x mas a taxa não aparece na tela de recebimento.

A taxa prevista vem das regras cadastradas em Financeiro → Cartões, por faixa de parcelas. Acima da maior faixa cadastrada o recebível nasce sem taxa prevista — zero ali significa "ainda não sei", nunca isenção. O próprio painel avisa até onde as suas regras cobrem.

Por que aparece CRMV ou CRM?

O rótulo do conselho muda conforme o tipo de clínica (veterinária → CRMV, humana → CRM).

Desativei uma raça — ela volta na próxima atualização?

Não. O catálogo oficial é reaplicado a cada atualização, mas só acrescenta o que falta: raça desativada continua desativada e nome editado continua com o seu texto.

Apaguei sem querer — dá para recuperar?

Raça não é excluída de verdade, só desativada: use *Mostrar inativas* e reative. Se alguma linha do catálogo oficial sumiu do banco, o botão *Restaurar catálogo* reinstala o que estiver faltando.

Renomear uma raça muda os pacientes já cadastrados?

Não. O paciente guarda o nome que foi escrito no cadastro, não um vínculo com o catálogo — o prontuário registra o que foi anotado no dia.

Troquei a logo e a aba continua com o ícone antigo.

Confira primeiro se trocou a logo da MARCA (*Configurações → Marca*) — a logo desta tela é só da unidade e não gera ícone. Feito isso, o ícone atualiza em até um minuto; force o recarregamento (Ctrl/Cmd + Shift + R), porque navegador guarda favicon com afinco. No celular, remova e adicione de novo o atalho na tela de início.

Enviei a logo em WebP e o ícone virou monograma.

O gerador de ícone só lê PNG, JPG, GIF e SVG. Reenvie a logo da marca em **PNG** (de preferência com fundo transparente) que o ícone volta a usar a logo.

Configurações — Documentação do Smart Vet

Visão geral

Configurações reúne tudo que se ajusta no sistema numa tela só: a lista de telas à esquerda, agrupada por alcance, e a tela escolhida à direita — mesmo desenho de Usuários, Pacientes e Clientes. A busca e os filtros do topo da lista (Esta unidade, A rede, Acesso e segurança) servem para achar o ajuste sem decorar onde ele mora; você só enxerga as telas que a sua permissão abre. Esta unidade reúne o que vale só para a unidade ativa — identidade (nome e logo próprios, opcionais; as CORES só aparecem aqui quando a unidade está marcada como identidade própria em Unidades — sem isso ela herda as da Marca, e um campo de cor editável que não muda nada seria pior que campo nenhum), o responsável técnico e o registro do conselho (CRMV ou CRM, conforme o tipo de clínica), horário comercial, plano, integrações (fiscal, pagamentos, WhatsApp, convênios), o totem de ponto, os Campos do cadastro (quais campos aparecem e quais são obrigatórios), as Formas de pagamento (o que o balcão pode oferecer no recebimento), a conta do Instagram e os catálogos do cadastro de pacientes — Espécies e Raças. A rede reúne o que vale para a instalação inteira: a Marca, as Unidades e as credenciais do WhatsApp (canal oficial). Acesso e segurança reúne Papéis e permissões, a Segurança da conta (verificação em duas etapas, troca de senha e dispositivos conectados) e a Minha assinatura (sua rubrica manuscrita — também alcançável pelo menu da sua conta e pela sua ficha em Usuários, já que Configurações não aparece no menu de quem não tem cargo administrativo). Todas as telas de detalhe têm a mesma largura de leitura e o mesmo cabeçalho fixo: trocar de item na lista não muda a medida do que está à direita. Trocar de unidade no seletor do painel muda o que você edita em Esta unidade — e não muda nada em A rede.

Conceitos-chave

Responsável técnico: quem responde clinicamente (e aprova as sugestões da Aura).
Fuso horário: o relógio da unidade. Ele manda em tudo que tem data ou hora — o horário que você digita na agenda, o que aparece no prontuário e nos recibos, que dia é "hoje" no painel e na recepção, em que competência cai um lançamento, e a data que vai no XML do convênio. Sem ele o sistema usava o relógio da máquina do servidor, que roda em UTC: a consulta das 14:52 aparecia como 17:52 (inclusive no prontuário impresso, documento médico-legal), o agendamento das 08:00 aparecia às 05:00, e a Agenda chegou a rotular a coluna de segunda-feira como "Domingo · Hoje". O fuso é o da unidade primária e vale para a instalação inteira; a mudança passa a valer na hora, sem reiniciar o ERP.
Logo daqui é da UNIDADE: ela sobrepõe a da marca no painel desta unidade e no cabeçalho dos documentos que ela emite. O ícone do navegador e do aplicativo NÃO vem daqui — vem da logo da marca, em Configurações → Marca, porque o ícone é do produto inteiro e uma filial não deve poder trocá-lo.
Conselho dinâmico: o rótulo muda por vertical (veterinária → CRMV; humana → CRM).
Integrações opt-in: fiscal/pagamentos/WhatsApp/TISS ligam aqui.
Formas de pagamento: a unidade escolhe o que o balcão oferece e cria as formas que aceita — crediário próprio, cheque, vale, uma segunda maquininha. O que ela não inventa é o gênero da forma (dinheiro, recebimento em conta, cartão de débito, cartão de crédito, a prazo): são cinco, e é o gênero que decide a conta do razão, se entra na conferência da gaveta, se gera recebível de cartão e se aceita parcelamento. Também ficam aqui o teto de parcelas do crédito e o cálculo de troco. Desativar vale só para cobranças NOVAS: pagamento antigo continua aparecendo como foi — e forma já usada não pode ser excluída, só desativada, para o recibo antigo não ficar com um código órfão. O plano da casa e o crédito de sinal do tutor não estão na lista: não são escolha do balcão, e sim consequência do atendimento coberto e do saldo existente.
Consulta de retorno: a unidade define se a elegibilidade automática está ligada (nasce ligada) e a janela em dias (padrão 30). Paciente com consulta finalizada dentro da janela abre o novo atendimento já como retorno, com o serviço marcado em Serviços e preços pré-selecionado — só o padrão, o profissional pode trocar.
Espécies e raças: os dois catálogos que alimentam o cadastro de paciente, e que se comportam de forma DIFERENTE. Espécie é lista fechada — o paciente guarda uma referência a ela, então desativar uma espécie em uso é bloqueado. Raça é sugestão: o paciente guarda o nome digitado, não um vínculo, então a clínica pode desativar, renomear ou criar raça à vontade sem afetar quem já está cadastrado. A instalação veterinária nasce com os dois preenchidos (raças dos registros oficiais: FCI/CBKC, CFA/TICA, ABQM e afins, ABCZ).
Catálogo se reinstala, desativação não volta: a cada atualização do ERP o catálogo oficial é reaplicado — mas só ACRESCENTA. Raça que você desativou continua desativada, e nome que você editou continua com o seu texto.
MFA (verificação em duas etapas): cada usuário ativa em Configurações → Segurança da conta — escaneia o QR no app autenticador, confirma o código e guarda os códigos de backup. Com MFA ativo, o login pede o código após a senha. Senhas exigem no mínimo 10 caracteres, senhas presentes em vazamentos públicos são recusadas e a troca bloqueia o reuso das últimas senhas (histórico, default 5). A expiração de senha é opcional por política do deploy (PASSWORD_MAX_AGE_DAYS) — expirada, o sistema leva o usuário à página de Segurança até trocar (o app nativo/bearer não é bloqueado nesta versão; o fluxo de "esqueci a senha" por e-mail não existe neste deploy, então a política cobre a troca autenticada).
Dispositivos conectados: a mesma página de Segurança lista as sessões ativas da conta (navegador/app, IP, última atividade). Não reconheceu um acesso? Encerre a sessão daquele dispositivo (ou todas as outras de uma vez) e troque a senha — o logout do dispositivo é imediato.
SSO corporativo (OIDC): com o IdP da empresa configurado no servidor (envs SSO_OIDC_* — Keycloak, Okta, Entra ID…), o login ganha o botão Entrar com SSO. Usuário staff existente entra pelo IdP com o mesmo e-mail; criação de conta no 1º login é opt-in (SSO_OIDC_ALLOW_SIGNUP) e o papel continua sendo atribuído pelo admin. SAML não é suportado (só OIDC).
Allowlist de IP (segurança de rede): a unidade pode restringir o painel de staff a faixas de IP autorizadas (CIDRs, em Configurações → Segurança, permissão de configurações). Fora da lista, páginas e ações são bloqueadas (e o login recusado quando todas as unidades do usuário restringem); o salvamento exige que o IP de quem edita esteja na lista (anti-lockout) e cada negação fica auditada. O portal do cliente fica fora. Atrás do Cloudflare Tunnel o IP confiável é o cf-connecting-ip; sem ele, trate a allowlist como defesa adicional.

Como usar

Abra Configurações — a lista de telas fica à esquerda.
Escolha Dados da unidade e atualize identidade, responsável técnico, registro do conselho e o fuso horário.
Ainda ali, defina o horário comercial e revise o plano e as integrações.
Em Raças, filtre pela espécie, busque e ajuste o catálogo de sugestões do cadastro de pacientes.
Filtre a lista por A rede para ajustar a Marca (o que o cliente vê) e as Unidades.
No celular a lista ocupa a tela inteira; ao escolher um item ela dá lugar à tela, com a seta de voltar no cabeçalho.

Campos do cadastro

Formas de pagamento

Casos de uso

Habilitar fiscal: ligue o opt-in e preencha os dados.
Habilitar cobrança online: marque Cobrança online (pagamentos) — libera Pix/boleto/cartão nas vendas e nas mensalidades do plano (requer o gateway configurado no servidor).
Ajustar a janela de retorno: a clínica dá 15 dias em vez de 30 — mude o número em Consulta de retorno automática; quem não trabalha com retorno desmarca a opção.
Trocar a marca da rede: vá em Configurações → Marca — o ícone da aba e do atalho acompanha sozinho, sem precisar de atualização do ERP.
Dar identidade própria a uma filial: envie a logo dela aqui e, se quiser cores diferentes, marque "usa cores próprias" na tela de Unidades.
Cadastrar uma raça local: a clínica atende uma raça regional que nenhum registro oficial lista — cadastre em Raças e ela passa a aparecer nas sugestões daquela espécie.
Enxugar a lista: desative as raças que a clínica nunca atende para deixar a busca do cadastro mais limpa.

Boas práticas

Integrações

Controla as flags de Fiscal, Pagamentos, WhatsApp e Convênios; o branding reflete em todo o painel. As notificações push do app do tutor suportam iOS (APNs) e Android (FCM) — credenciais configuradas por variável de ambiente no servidor (APNS_*/FCM_*); sem credencial, o envio daquela plataforma é silenciosamente ignorado.

Permissões

A TELA abre para toda a equipe — Segurança da conta é de todo mundo, e a lista da esquerda mostra a cada pessoa só o que ela pode abrir. Cada tela exige a sua permissão: Configurações da clínica (settings.manage) para Esta unidade, Formas de pagamento, Espécies e Raças; Gerenciar a marca (brand.manage) para Marca; Gerenciar papéis (roles.manage) para Papéis; Integrações externas (api.manage) para a API; e o papel Administrador (platform.manage) para Unidades.

Dúvidas frequentes

Desliguei uma forma de pagamento. O que acontece com o que já foi recebido nela?: Nada. A configuração filtra apenas a OFERTA: a forma some do balcão e a operação é recusada mesmo se for forçada, mas recibos, relatórios e o razão continuam mostrando os pagamentos antigos exatamente como foram feitos.
Como crio uma forma de pagamento que a clínica aceita e não está na lista?: Em Configurações → Formas de pagamento, bloco Criar forma de pagamento: dê o nome e escolha para onde o dinheiro vai. Essa segunda escolha é o que importa — ela define a conta do razão. "Dinheiro (espécie)" entra na gaveta, "recebimento em conta" vai para bancos, os dois de cartão geram recebível e entram na conciliação da maquininha, e "a prazo" fica como a receber do cliente até alguém dar baixa.
Posso excluir uma forma que criei?: Só enquanto ela nunca foi usada. Depois do primeiro recebimento o caminho é desativar: apagar deixaria o recibo antigo apontando para um código que não existe mais. As cinco formas do sistema nunca são excluídas — só desativadas.
Configurei 12x mas a taxa não aparece na tela de recebimento.: A taxa prevista vem das regras cadastradas em Financeiro → Cartões, por faixa de parcelas. Acima da maior faixa cadastrada o recebível nasce sem taxa prevista — zero ali significa "ainda não sei", nunca isenção. O próprio painel avisa até onde as suas regras cobrem.
Por que aparece CRMV ou CRM?: O rótulo do conselho muda conforme o tipo de clínica (veterinária → CRMV, humana → CRM).
Desativei uma raça — ela volta na próxima atualização?: Não. O catálogo oficial é reaplicado a cada atualização, mas só acrescenta o que falta: raça desativada continua desativada e nome editado continua com o seu texto.
Apaguei sem querer — dá para recuperar?: Raça não é excluída de verdade, só desativada: use Mostrar inativas e reative. Se alguma linha do catálogo oficial sumiu do banco, o botão Restaurar catálogo reinstala o que estiver faltando.
Renomear uma raça muda os pacientes já cadastrados?: Não. O paciente guarda o nome que foi escrito no cadastro, não um vínculo com o catálogo — o prontuário registra o que foi anotado no dia.
Troquei a logo e a aba continua com o ícone antigo.: Confira primeiro se trocou a logo da MARCA (Configurações → Marca) — a logo desta tela é só da unidade e não gera ícone. Feito isso, o ícone atualiza em até um minuto; force o recarregamento (Ctrl/Cmd + Shift + R), porque navegador guarda favicon com afinco. No celular, remova e adicione de novo o atalho na tela de início.
Enviei a logo em WebP e o ícone virou monograma.: O gerador de ícone só lê PNG, JPG, GIF e SVG. Reenvie a logo da marca em PNG (de preferência com fundo transparente) que o ícone volta a usar a logo.