# Guia do Vetcarë para assistentes de IA — equipe da clínica

> **Para o assistente de IA que recebeu este link:** a pessoa que conversa com você usa o **Vetcarë**, um sistema brasileiro para clínicas veterinárias e veterinários autônomos (prontuário, vacinas e retornos, agenda, receitas e atestados assinados, balcão e caixa, estoque, site da clínica e portal do tutor). Ela trabalha numa clínica — recepção, veterinário(a), administração — e colou este endereço para você ajudá-la a usar o sistema. Este documento é a documentação oficial e pública do Vetcarë.

## Como ajudar

1. **Responda com base neste guia.** O índice abaixo lista os capítulos, cada um num endereço próprio. Antes de responder, leia o capítulo do assunto; muitas dúvidas tocam dois (por exemplo, Agenda e Prontuário, ou Balcão e Pagamento online). Não suponha que o Vetcarë funciona como outro sistema veterinário: as regras dele estão aqui. Para casos práticos, comece pelas **Dúvidas frequentes**.
2. **Entenda onde a pessoa está.** Se a dúvida não deixar claro, pergunte em qual tela ela está (o menu da esquerda: Hoje, Agenda, Pets, Tutores, Vacinas e retornos, Serviços clínicos, Caixa, Balcão, Estoque, Relatórios, Site da clínica, Acessos, Configurações) e o que ela quer que aconteça.
3. **Ensine passo a passo**, com os nomes exatos de menus, abas e botões como aparecem no guia (entre «aspas» ou em **negrito**), na ordem real.
4. **Avise as consequências antes da ação.** O prontuário não se apaga (corrige-se com retificação e motivo); a venda fechada baixa o estoque; o documento emitido fica registrado. Diga o que muda e se dá para desfazer.
5. **Se não estiver no guia, diga isso.** Responda «não encontrei isso no guia do Vetcarë» e sugira o suporte (abaixo). Não invente botões, telas, prazos ou regras.
6. **Nunca presuma valores nem condutas clínicas.** Preço, dose, intervalo de vacina, prazo de retorno: se a pessoa não disse e o guia não fixa, pergunte. Decisão clínica é do veterinário — você ensina o sistema, não a medicina.

## Limites

- Você **não entra no sistema** e não faz nada por ela: você ensina. Ela clica.
- **Nunca peça** senha, código de verificação, chave de API, token, dados de cartão ou conta bancária. Se ela colar um desses, diga para apagar da conversa e trocar a chave/senha.
- Não peça nome, CPF, telefone ou dados de saúde de tutores e pets: para explicar, use exemplos inventados.

## Sobre o Vetcarë

**Indicado para** clínicas veterinárias de pequenos animais e veterinários(as) que atendem sozinhos (consultório, domicílio, hora marcada). O dinheiro **não passa pelo Vetcarë**: o Pix do balcão e o link de pagamento são emitidos na conta da própria clínica (Mercado Pago ou Asaas). Os e-mails saem do endereço da clínica (Gmail ou outro), e os arquivos podem ficar no armazenamento da clínica. Teste grátis de 3 meses.

**Não é** sistema de contabilidade nem emite nota fiscal.

## Quando encaminhar ao suporte do Vetcarë

Erro na tela, pagamento que não deu baixa, e-mail que não saiu, problema de acesso, e qualquer coisa que o guia não cubra. Caminho: no sistema, o botão **«?»** no alto de cada tela abre a ajuda; **Novidades → Sugerir melhoria** manda a mensagem à equipe do Vetcarë. Antes, ajude a pessoa a descrever: tela, o que fez, o que esperava, o que apareceu (sem dados pessoais).

## Outros guias

- Para **tutores** (o portal do tutor): https://app.vetcareapp.com.br/ajuda/portal-do-cliente.md
- Tudo num arquivo só (para anexar na conversa, se você não conseguir abrir os links): https://app.vetcareapp.com.br/ajuda/completo.md

# O que o sistema faz

*Em uma frase, e depois com calma.*

O Vetcarë é o sistema da clínica veterinária: o **prontuário** de cada pet, as **vacinas e retornos** com lembrete ao tutor, a **agenda**, as **receitas, atestados e termos** assinados em PDF, o **balcão e o caixa**, o **estoque** — e, do lado de fora, o **site da clínica** e o **portal do tutor**, que também vira app no celular.

Serve à clínica com equipe (plano **Clínica**) e ao veterinário ou veterinária que atende sozinho, em consultório, a domicílio ou com hora marcada (plano **Veterinário(a)**). Cada clínica enxerga apenas os próprios dados.

> **O princípio que governa o sistema** — O que é registro de saúde ou de dinheiro **não se apaga**: corrige-se, com motivo e com o nome de quem corrigiu. O prontuário só cresce (a correção é uma *retificação*), o documento emitido fica congelado (cancela-se com motivo), o livro do estoque só cresce (corrige-se com ajuste) e o anexo se retira, não some. Assim a clínica sempre consegue mostrar o que aconteceu.

O dinheiro **não passa pelo Vetcarë**: o Pix do balcão e o link de pagamento saem da conta da própria clínica (Mercado Pago ou Asaas). Os e-mails saem do endereço da clínica, e os arquivos podem ficar no armazenamento dela.


# Primeiros passos e o modo de ensaio

*Do cadastro ao primeiro atendimento.*

## Criar a conta

No site do Vetcarë, em **«Começar grátis»**, escolha o caso — **«Clínica — R$ 250/mês»** ou **«Veterinário(a) — R$ 125/mês»** —, preencha o nome da clínica, CNPJ ou CPF, estado, cidade, o seu nome e o seu e-mail, e clique em **«Criar minha conta»**. O link para definir a senha chega no e-mail e vale por 7 dias. São **3 meses grátis**, sem cartão.

## O cartão «Primeiros passos»

No topo da tela **Hoje** fica um roteiro de sete passos, que se marcam sozinhos conforme a clínica usa o sistema:

1. **«Conectar o e-mail da clínica»** — os lembretes e avisos saem do seu endereço.
2. **«Cadastrar o CRMV e a assinatura»** — sem eles nenhum documento é emitido.
3. **«Conferir a tabela de preços»** — o valor de cada atendimento.
4. **«Cadastrar o primeiro pet»** — o tutor se cadastra junto.
5. **«Marcar o primeiro horário»**.
6. **«Levar um tutor para o portal»** — o link de acesso vai por WhatsApp ou e-mail.
7. **«Pôr a cara da clínica no site»** — texto, fotos e logotipo.

Clicar num passo leva à tela certa. O cartão some quando tudo estiver pronto; **«Ocultar»** o esconde antes disso.

## O modo de ensaio (test-drive)

Para ver a clínica funcionando antes de cadastrar os seus pacientes, use **«Carregar exemplos»** no cartão de primeiros passos, ou **Configurações → 🧪 Ensaio → «Carregar os exemplos»**. O sistema cria dois tutores e três pets de exemplo — o Thor com a V10 atrasada, a Mia com a antirrábica para vencer, o Bob idoso com alerta de cardiopata —, com consultas, receita e peso no prontuário e três horários na agenda (dois hoje, um amanhã).

- Tudo aparece com **«(TESTE)»** no nome e **moldura vermelha**, e uma faixa vermelha avisa em todas as telas que o ensaio está ativo.
- Os tutores de exemplo **não têm e-mail**: nenhum lembrete ou aviso sai para alguém de verdade.
- A tutora Mariana tem portal: **«Ver o portal do tutor»** abre o portal já logado, para você ver o que o tutor vê.
- **«Encerrar o ensaio»** apaga os exemplos de uma vez, com o prontuário e os horários deles. Os seus dados de verdade não são tocados. Se um pet de exemplo já tiver venda no balcão ou documento emitido, o sistema avisa e não apaga esse uso.

## O tour

Um tour de um minuto mostra onde cada coisa vive. Ele reabre pelo botão **«?»** no alto da tela.


# Entrar, senhas e o que você vê

*Um login só, no site da clínica, para a equipe e para os tutores.*

No site da clínica, **«Entrar»** abre *«Acesse sua conta — Tutores e equipe — um login só»*. A equipe entra com o e-mail; o tutor, com o e-mail ou o CPF. O sistema leva cada um para o seu lugar: a equipe para o sistema da clínica, o tutor para o portal.

## Esqueci minha senha

Na mesma tela, **«Esqueci minha senha»**: informe o e-mail e chega um link para criar uma senha nova. A resposta é sempre a mesma, exista a conta ou não — ninguém descobre quem é cliente da clínica por ali. Para a equipe, a pessoa com nível Administrador também pode, em [Acessos](https://app.vetcareapp.com.br/ajuda/acessos.md), usar **«Senha»** ou **«Destravar»**.

## Entrar com a digital ou o rosto

O tutor que ativou **«Entrar com a digital neste celular»** no portal vê, no site da clínica, o botão **«Entrar com a digital ou o rosto»**. A senha não sai do aparelho.

## Segurança

As senhas são guardadas de forma irreversível (ninguém da clínica nem do Vetcarë consegue lê-las). Tentativas erradas seguidas bloqueiam a conta por um tempo crescente. O CPF do tutor é guardado cifrado.

## O menu

À esquerda: **Hoje · Agenda · Pets · Tutores · Vacinas e retornos · Serviços clínicos · Caixa · Balcão (PDV) · Estoque · Relatórios · Site da clínica · Acessos · Configurações**. O Balcão e o Estoque são do plano Clínica. O número ao lado de **Tutores** são conversas não lidas; o de **Vacinas e retornos**, os atrasados. No alto de cada tela, o **«?»** abre a ajuda daquela tela, e o botão da IA ensina a perguntar ao ChatGPT, ao Claude ou ao Gemini com o guia do Vetcarë.


# Hoje — o dia da clínica

*É por aqui que o dia começa.*

A saudação, os botões **«+ Agendar»** e **«+ Novo pet»**, e cinco cartões:

- **«Agenda de hoje»** — quantos horários, quantos atendidos e quantos esperando.
- **«Atendimentos (30 dias)»**.
- **«Vacinas e retornos»** — os atrasados, para avisar o tutor.
- **«Vendido hoje»** no plano Clínica (com aviso quando um produto está no mínimo); no plano Veterinário(a), **«Voltam nesta semana»**.
- **«Pets»** — tutores e internados.

Abaixo: a **agenda de hoje** como linha do tempo, com a marca do «agora» e **«Abrir agenda»**; os **«Pedidos pelo site»** esperando confirmação; os **«Internados e em tratamento»**; o gráfico dos atendimentos dos últimos 30 dias; e as vacinas e retornos dos próximos 7 dias.

## Satisfação (NPS)

O cartão **«Satisfação (NPS)»** mostra a nota dos últimos 90 dias: a porcentagem de promotores (notas 9 e 10) menos a de detratores (0 a 6) — de −100 a +100 —, quantas respostas, a média e o último comentário. **«Ver tudo»** abre por profissional, os comentários e o período (30 dias, 90 dias, 12 meses). A pesquisa começa **desligada** (é e-mail ao tutor): ligue em **«Enviar a pesquisa no dia seguinte ao atendimento»**. Ligada, todo tutor com e-mail cujo horário ficou **«Atendido»** na agenda recebe no dia seguinte uma pergunta — de 0 a 10, quanto recomendaria a clínica — com os botões das notas e um comentário opcional; no máximo uma pesquisa a cada 30 dias por tutor, e ela fica aberta por 14 dias.

> **Aviso de pagamento sem aviso do provedor** — Se a conferência do dia achou um pagamento online pago cujo aviso do Mercado Pago ou do Asaas nunca chegou, a tela Hoje mostra um aviso amarelo. A baixa já foi feita, mas a ligação com o provedor pode estar com problema: confira em **Configurações → E-mail, pagamento e arquivos → Pagamento online → «Testar conexão»**. Ver [Pagamento online](https://app.vetcareapp.com.br/ajuda/pagamentos.md).


# Agenda

*Os horários da clínica, os pedidos do site e o que está previsto.*

Abas **«Dia» · «Semana» · «Mês» · «Previsões»**, a navegação **‹ «Hoje» ›**, o filtro **«Todos os profissionais»**, **«📅 Google»** e **«+ Agendar»**.

- **Dia**: das 07:00 às 19:30, de meia em meia hora. Clicar numa linha vazia agenda naquele horário. Embaixo, **«Previsto para este dia»** (vacinas e retornos que vencem) e, hoje, os **«Atrasados»**.
- **Semana** e **Mês**: marcados, pedidos do site, previstos e faltas de cada dia. Clicar num dia abre o dia.
- **Previsões**: vacinas, vermífugos e retornos dos próximos 60 dias, por semana, com **«WhatsApp»** e **«Agendar»** em cada um.

Os **feriados** aparecem no dia, na semana e no mês («🎉 Feriado: …»). Os nacionais são calculados sozinhos — inclusive Carnaval, Sexta-feira Santa, Corpus Christi e a Consciência Negra —; os da sua cidade e do seu estado você cadastra em **Configurações → «Feriados»** (com «repete todo ano» para o aniversário da cidade).

## Agendar

Em **«+ Agendar»**, escolha **«Quem vem»** buscando o pet ou o tutor — ou, para quem ainda não tem cadastro, escreva **«Nome (tutor e pet)»** e **«Telefone»**. Depois **«Data»**, **«Hora»**, **«Tipo»** (Consulta, Retorno, Vacina, Cirurgia, Exame, Banho e tosa, Outro), **«Duração»**, **«Profissional»** («Qualquer um»), **«Local»** e **«Observação»**.

## O horário

Clicar num horário abre a janela **«Horário»**. As situações são: Pedido pelo site, Marcado, Confirmado, Chegou, Atendido, Faltou e Cancelado.

- **«Atender»** abre a ficha do pet com o registro já ligado ao horário; ao registrar, o horário vira *Atendido* sozinho.
- **«Confirmado»**, **«Chegou»**, **«Faltou»**, **«Cancelar horário»** e **«Voltar para marcado»** mudam a situação.
- **«Remarcar»** muda data e hora. Num pedido do site, o botão é **«Definir horário»** (ou **«Confirmar como está»**).
- Horário de quem não tem cadastro: **«Cadastrar o pet»**.
- O telefone do tutor abre o WhatsApp com a mensagem de confirmação pronta — com o **link para o tutor confirmar ou cancelar** sozinho («🔗 Copiar o link de confirmar/cancelar» copia só o link).
- **«📅 Pôr no Google Agenda»** e **«⬇ Baixar .ics (Outlook, iPhone)»** põem aquele horário na sua agenda pessoal.

## O tutor confirma ou cancela pelo link

O link abre uma página simples, sem senha, com **«Confirmo»** e **«Preciso cancelar»** (com o motivo, se ele quiser). A agenda muda sozinha, o horário mostra **«✓ tutor confirmou»** ou **«✗ tutor cancelou»** (na janela, quando e o motivo) e quem ligou os avisos no celular é avisado. O mesmo link vai no **lembrete da véspera** — com os lembretes por e-mail ligados, todo tutor com horário no dia seguinte recebe um e-mail (e, com o portal instalado, um aviso no celular) — e nos próximos horários do portal. Depois do horário, ou com ele atendido ou cancelado, o link só informa.

## Os pedidos pelo site

O tutor pede horário no site da clínica (telefone, nome do pet, o que precisa, dia e período). O pedido entra na agenda como **«Pedido pelo site»**, em rosa, e aparece na tela Hoje. A recepção liga ou manda WhatsApp, combina e usa **«Definir horário»**.

## Horário de atendimento e os horários livres no site

Na Agenda, **«🕘 Atendimento»** abre o **«Horário de atendimento»**: para cada dia da semana, até três intervalos (deixe em branco o dia fechado); a duração de cada horário; quantos atendimentos cabem ao mesmo tempo (dois veterinários = 2); a antecedência mínima e até quantos dias à frente. Marcando **«Oferecer os horários livres no site»**, o pedido do site deixa de ser «dia e período»: o tutor escolhe o dia e a hora entre os livres — sem os já ocupados, os feriados (nacionais e os que a clínica cadastrou) e o que já passou. O horário escolhido entra na agenda naquela hora, como pedido pelo site, já reservado; a recepção confirma (ou, com **«Marcar direto»**, ele já entra marcado). O tutor recebe na hora o link para desistir, e quem ligou os avisos no celular é avisado do pedido.

## A agenda no Google Agenda, no celular ou no Outlook

**«📅 Google»** abre **«A agenda no Google Agenda»**: escolha **«Toda a clínica»** ou **«Só os meus horários»** e **«Copiar»** o link. No Google Agenda, **Outras agendas → «Do URL»**, cole e adicione; no iPhone, **Ajustes → Calendário → Contas → Adicionar conta → Outra → «Adicionar Calendário Assinado»**; no Outlook, **«Assinar da Web»**. A agenda se atualiza sozinha algumas vezes por dia.

> **O link é pessoal** — Quem tiver o link vê os horários: o tipo, o nome do pet e o primeiro nome do tutor — nada do prontuário, nenhum telefone. Para invalidar um link, troque a sua senha. Desativado o acesso da pessoa, o link dela para de funcionar.


# Pets e prontuário

*A ficha de cada paciente e a linha do tempo que nunca se apaga.*

## A lista

Os cartões do topo filtram: **«Pets»**, **«Internados e em tratamento»**, **«Vacina atrasada»**, **«Com alerta clínico»**. A busca acha por pet, tutor, telefone ou microchip; dá para filtrar por espécie e situação e ver em **«▦ Blocos»** ou **«☰ Tabela»**. Passar o mouse sobre um pet mostra um resumo: idade, peso, última visita, alertas, próxima vacina e próxima consulta.

## Novo pet

Em **«+ Novo pet»**: nome, espécie (Cão, Gato, Ave, Roedor, Coelho, Réptil, Peixe, Equino, Bovino, Outro), raça, sexo, nascimento (ou **«Data de nascimento estimada»**), castrado, pelagem, porte, microchip e observações. O tutor se cadastra junto — busque um que já existe ou preencha nome, telefone, e-mail e CPF (opcional, guardado cifrado). Clique em **«Cadastrar»**.

## A ficha do pet

No topo: a foto (**«📷 Pôr foto»**), os tutores (com WhatsApp; **«+ tutor»** vincula outro; o «×» encerra o vínculo e ele passa a constar como tutor anterior), e os botões **«Agendar»**, **«+ Alerta»**, **«Situação»** e **«Carteira de vacina»**. As abas: **«Linha do tempo»**, **«Peso»**, **«Vacinas»**, **«Documentos»**, **«Serviços e valores»** e **«Cadastro»**.

## Alertas

Alergia, condição crônica ou comportamento: o alerta fica fixado em vermelho na ficha (e o tutor vê a alergia no portal) até alguém clicar em **«Encerrar»**. Encerrado, continua no histórico.

## Registrar um atendimento

Na **Linha do tempo**, cada tipo tem o seu botão: **Consulta, Retorno, Vacina, Vermífugo, Peso, Exame, Receita, Cirurgia, Internação, Procedimento, Observação**.

- **Consulta e Retorno**: queixa principal, anamnese, exame físico, temperatura, FC, FR, diagnóstico, conduta, peso e **«Retorno previsto»**.
- **Vacina**: a vacina (V8, V10, Antirrábica, Gripe canina, Giárdia, Leishmaniose, V3/V4/V5 felina, FeLV…), fabricante, lote, validade, dose e **«Próxima dose»**, sugerida pelo **protocolo da clínica**: o sistema conta as doses anteriores do mesmo tipo no pet, olha a idade e mostra o porquê embaixo do campo («2ª de 3 doses — a próxima em 21 dias», «reforço anual»). Se você mudar a data, a sua fica — o protocolo só avisa o que sugeria. **Vermífugo**: produto, dose, lote e próxima dose (sugere 90 dias).
- **Peso**, com escore corporal; **Exame**, com resultado ou laudo; **Receita**, com os medicamentos e as orientações; **Cirurgia** (sugere retorno em 10 dias); **Internação**, que pode mudar a situação do pet para internado.
- Em todos: data e hora, observações e **«O tutor pode ver este registro no portal»** — já vem marcado em vacina, vermífugo, peso e receita.
- O bloco **«Cobrar por este atendimento»** sugere o serviço da tabela de preços: ao registrar, ele fica *a cobrar* do tutor, com o preço do dia. Ver [Serviços clínicos](https://app.vetcareapp.com.br/ajuda/servicos.md).

A próxima dose e o retorno previsto alimentam sozinhos as [Vacinas e retornos](https://app.vetcareapp.com.br/ajuda/vacinas.md) e as previsões da agenda.

## A foto do selo da vacina

No **«+ Vacina»**, o campo **«Foto do selo»** recebe a foto da etiqueta do frasco (marca, lote, validade) — no celular, abre a câmera ou a galeria. Esqueceu na hora? Na **Linha do tempo**, o botão **«📷 Foto do selo»** da dose (ou o 📷 da aba **Vacinas**) anexa depois. A foto aparece na aba Vacinas, na **carteira impressa** e no portal do tutor (quando o registro está visível para ele). Ela é um anexo do prontuário: foto errada não se apaga — retire-a na aba **Documentos**, com o motivo. Retificada a dose, a foto acompanha a versão nova.

## Reação adversa à vacina

Na **Linha do tempo**, a dose tem o botão **«⚠ Reação adversa»**. O formulário já vem ligado àquela dose (vacina, marca, lote e data aparecem no topo) e pede a **gravidade** (leve, moderada, grave) e os **sinais**; o início, a conduta, o desfecho e a notificação ao fabricante ou ao MAPA são opcionais. Marcado **«Criar alerta de alergia no pet»**, o alerta aparece em todo formulário do pet — antes da próxima dose. A reação é prontuário: não se apaga, retifica-se; não vai ao portal sem você marcar.

Em **Estoque → Vacinas**, a tabela por marca ganha a coluna **«Reações»** (pela data da dose), há a lista **«Reações adversas»** do período, e o **Rastreio de lote** marca os pets que reagiram àquele lote — se várias reações se concentram num lote, é hora de avisar o laboratório.

## Protocolos de vacina

Em **Vacinas e retornos → «Protocolos de vacina»** fica a tabela da clínica, por espécie e tipo de vacina: doses da série do filhote (até 1 ano), doses do adulto sem histórico, intervalo entre as doses, idade mínima da última dose do filhote e o reforço. A clínica começa com um modelo comum no Brasil (V8/V10 em 3 doses a cada 21 dias, a última com 16 semanas ou mais; reforço anual) — **confira com a bula de cada vacina e com o responsável técnico** e ajuste. Quem pode configurar a clínica edita, desliga e cria protocolos; os outros só consultam.

## Corrigir: a retificação

> **O prontuário só cresce** — Não existe botão de apagar. Para corrigir, use **«Retificar»** no registro e informe o **«Motivo da retificação»**. A versão nova aparece com «retificado: motivo», e a original fica guardada em **«versões anteriores»**, com quem e quando.

## Situação e óbito

**«Situação»** muda entre Ativo, Em tratamento, Internado e Óbito, com motivo — a mudança entra na linha do tempo. O óbito pede a data, não se desfaz pela tela, e depois dele a ficha só aceita observações e exames/laudos.

## Peso e vacinas

A aba **Peso** mostra o gráfico de evolução e a variação desde a pesagem anterior (**«+ Pesar»**). A aba **Vacinas** lista as doses e as próximas, com **«Imprimir carteira»**.

## A vacina do estoque

No plano Clínica, com vacinas cadastradas no Estoque, o formulário de **«+ Vacina»** mostra **«Vacina do estoque»**: escolha a vacina e o sistema preenche o tipo (V10, antirrábica…), a marca, o laboratório, o lote e a validade, e dá baixa de uma dose do lote que vence primeiro (ou do lote escolhido em **«Lote»**). Lote vencido não se aplica; sem saldo, o sistema pergunta antes (a vacina chegou e a nota não foi lançada). **«Outra (digitar)»** volta aos campos de sempre. O custo da dose fica no livro do estoque, ligado ao registro — o tutor não vê.

**A vacina e a aplicação se cobram separadas.** **«Cobrar a vacina»** põe a dose a cobrar na conta do tutor com o preço da vacina no estoque; a aplicação é o serviço da tabela, em **«Cobrar por este atendimento»**. Marque só a vacina, só a aplicação ou as duas. Ao receber no balcão, a dose entra na venda sem sair do estoque de novo (já saiu na aplicação).


# Internação

*O quadro dos internados: os horários de medicação de cada um, quem deu e quando, e a evolução de cada turno.*

A tela **Internação** (plano Clínica) mostra um cartão por pet internado: o leito, o dia da internação, o responsável, cada prescrição com os horários do dia e a última evolução.

- **Internar:** pelo botão **«🏥 Internar»** do quadro ou da ficha do pet. Diga o motivo e, se quiser, o leito e o responsável. A situação do pet passa a **Internado** — e isso fica na linha do tempo. (Mudar a situação pela ficha também abre e fecha a internação.) O termo de consentimento de internação está em Documentos, na ficha.
- **💊 Prescrição:** o medicamento (ou o cuidado: fluidoterapia, curativo…), a dose, a via, de quantas em quantas horas, a primeira dose e, se houver, por quantos dias. Os horários saem sozinhos — de 8 em 8 horas a partir das 8h dá 8h, 16h e 0h. **Suspender** (em Detalhes) tira os próximos horários.
- **Checar o horário:** toque no horário e marque **Feito** ou **Não feito** (com o porquê: recusou, vomitou, em jejum…). Fica registrado com o nome de quem marcou e a hora, e não se desfaz. Passou 30 minutos sem checagem, o horário fica **vermelho**: atrasado — aparece no selo do menu e na tela **Hoje**.
- **📝 Evolução:** os parâmetros do turno — temperatura, FC, FR, peso, mucosas, TPC, hidratação, consciência, alimentação, urina, fezes e dor (0 a 4) — e a anotação. Vai para o **prontuário**, com o seu nome, como qualquer registro (e se corrige por retificação). Mais de 8 horas sem evolução, o cartão avisa.
- **🏠 Alta:** diga como o pet sai (para casa, segue em tratamento, ou óbito) e escreva o resumo — ele vai para o prontuário. Se a tabela tiver um serviço do tipo «Internação», as **diárias** já vêm contadas e entram nos serviços a cobrar do tutor.

As setas no alto do quadro mostram os dias anteriores. Em **Detalhes** está a internação inteira, com **🖨 Imprimir** a ficha de internação (prescrições, checagens e evoluções).


# Documentos, exames e anexos

*Receitas, atestados e termos assinados em PDF, com QR de verificação.*

## Antes do primeiro documento

Em **Configurações → Documentos e assinatura → «A minha assinatura»**, cada veterinário cadastra o **CRMV** e a **UF**, o nome no papel, a imagem da assinatura e, se quiser, o carimbo (o fundo branco some sozinho). Em **«O papel da clínica»**: logotipo, cidade, cor e rodapé. **Sem CRMV e UF nada é emitido.**

## Emitir

Na ficha do pet, aba **Documentos**, **«+ Emitir documento»** e escolha o modelo:

- Receita simples
- Atestado de saúde (viagem e trânsito) · Atestado de vacinação
- Solicitação de exames · Orientações pós-operatórias
- Termo de consentimento — cirurgia e anestesia · — internação · — eutanásia
- Declaração de óbito · Documento livre

Preencha os campos (nas receitas, os medicamentos com quantidade e posologia, e **«+ medicamento»**), escolha **«mostrar no portal do tutor»** e **«avisar o tutor por e-mail»**, e clique em **«Emitir e abrir o PDF»**.

O PDF sai com a assinatura e o carimbo do veterinário, o logotipo da clínica e um **código com QR de verificação**: quem lê o QR confere, no site, que o documento é autêntico e está válido. Depois de emitido, o documento fica congelado.

- Pet vivo não emite declaração de óbito; pet em óbito não emite receita, atestado de saúde nem termo de cirurgia ou internação.
- Os **termos** pedem a concordância do tutor: ele lê no portal e clica em **«Li e concordo»**. A situação passa de «Aguardando o aceite do tutor» para «Aceito pelo tutor».
- **«Cancelar»** pede motivo: o QR passa a mostrar CANCELADO e o tutor deixa de ver o documento.
- **«Prontuário completo»** gera o PDF de todo o histórico do pet, para a clínica.

## Medicamento controlado

O Vetcarë **não emite receita de controle especial**: desde 2026 ela só vale no documento oficial de cada caso.

- **Produto de uso veterinário** (registrado no MAPA): a Notificação de Receita Veterinária, emitida e assinada no **SIPEAGRO** (Portaria MAPA 837/2025).
- **Medicamento de uso humano**: o receituário oficial da **Anvisa** (versão 2, sem adaptar), com a numeração da Vigilância Sanitária.
- **Manipulado**: a **Receita simples**, marcando **«Manipulado sujeito a controle especial»**. Ela sai com a numeração exigida — o seu cadastro no SIPEAGRO + o sequencial do ano + os dois últimos dígitos do ano (ex.: 1234560001 26) —, em duas vias (a 2ª fica retida na farmácia) e sem a imagem da assinatura: imprima e assine à mão (assinada eletronicamente, só valeria com certificado ICP-Brasil). O número vai junto para o prontuário. Cadastre o SIPEAGRO em **Configurações → Documentos e assinatura → «A minha assinatura»**.

Na receita (aqui ou na linha do tempo), cada medicamento tem o campo **«Nº notificação SIPEAGRO»**: anote o número da notificação emitida no SIPEAGRO e anexe o PDF dela em **Exames e anexos**. Na dúvida, confira com o CRMV do seu estado.

## Os modelos

Em **Configurações → Documentos e assinatura → «Modelos de documento»**, cada modelo pode ser editado (**«Editar»**), com marcadores entre {chaves} para os dados do pet e do tutor; dá para criar outros (**«+ Novo modelo»**), dizer se vão ao portal e se pedem a concordância do tutor, e voltar ao texto padrão.

## Exames e anexos

Na mesma aba, **«Exames e anexos»**: escolha o arquivo (PDF, JPG, PNG ou WebP, até 20 MB), diga o que é, se **«o tutor vê»**, e clique em **«Anexar»**. O arquivo fica no armazenamento da clínica, se conectado (Configurações → E-mail, pagamento e arquivos → Arquivos), ou no próprio sistema. **«Mostrar ao tutor»** e **«Ocultar do tutor»** mudam a visibilidade. Anexo não se apaga: **«Retirar»** pede motivo e o registro da retirada fica.


# Vacinas e retornos

*Quem precisa voltar — os atrasados primeiro.*

Abas **«Vacinas e vermífugos»** e **«Retornos»**; escolha até quantos dias à frente ver (7 a 90 — os atrasados sempre aparecem). Os grupos: **«Atrasados»**, **«Nos próximos 7 dias»** e os seguintes. Cada linha tem **«WhatsApp»** (a mensagem pronta para o tutor) e **«Agendar»**.

Ninguém dá baixa à mão: aplicada a dose (ou feito o retorno), o pet sai da lista sozinho.

## Lembretes por e-mail

No bloco **«Lembretes por e-mail»**, ligue o envio e escolha avisar no dia ou alguns dias antes. Todo dia o sistema manda os lembretes sozinho — um e-mail por tutor, com todos os pets dele — e, se a data passou sem a dose, mais uma vez depois. Ligado, vai também o lembrete da véspera de cada horário da agenda, com o link de confirmar ou cancelar. **«Enviar agora»** manda já os pendentes. Os e-mails saem do e-mail da clínica (**«De qual e-mail saem?»**); o tutor com o portal instalado e os avisos ligados recebe também no celular.

**«Imprimir lista»** imprime a lista para a recepção ligar.


# Tutores e conversas

*Quem cuida de cada pet, e a conversa com a clínica.*

A lista busca por tutor, telefone, e-mail ou nome do pet. **«+ Novo tutor»**: nome, telefones, e-mail (para o portal e os lembretes), CPF (cifrado) e endereço. Na ficha do tutor: **«+ Pet deste tutor»**, **«Editar»**, **«Acesso ao portal»** e **«Conversa»**.

## Levar o tutor para o portal

**«Acesso ao portal»** gera um link de uso único, válido por 7 dias, para o tutor criar a senha dele — a clínica nunca vê a senha. Envie com **«Enviar pelo WhatsApp»**, **«Enviar para [e-mail]»** ou **«Copiar link»**. A situação de cada tutor (com senha, link enviado, link vencido, sem acesso) fica em [Acessos → «Tutores no portal»](https://app.vetcareapp.com.br/ajuda/acessos.md).

## Conversas

O tutor escreve pelo portal; a equipe vê em **«Conversas»** (o número no menu são as não lidas) e responde com **«Enviar»**. O tutor recebe aviso no celular, e a equipe vê **«✓✓ lida»** quando ele leu.


# Interessados

*Quem quer saber de um serviço e ainda não é cliente — do primeiro contato ao agendamento.*

A tela **Interessados** guarda quem perguntou por banho e tosa, castração, vacina, check-up… e ainda não marcou. Só dados de contato: nome, celular (WhatsApp), e-mail, o melhor horário, o bairro, o pet e o que procura — CPF e endereço ficam para quando a pessoa vira tutor.

- **Do site:** na página de pedir horário, o bloco **«Ainda não quer marcar?»** (o «Me avise») deixa a pessoa mandar o contato e o que precisa, autorizando a clínica a falar com ela por 12 meses. Cai aqui sozinho, como **Novo**, e quem ligou os avisos no celular é avisado. Para tirar do site, desmarque **«“Me avise” no site da clínica»** no alto da tela.
- **À mão:** **«+ Interessado»** para quem ligou, mandou WhatsApp ou passou na clínica. O mesmo celular é a mesma pessoa: o pedido novo entra como outro atendimento dela.

As colunas são as etapas: **Novo → Em contato → Orçamento → Agendado**. Toque no cartão para abrir a ficha:

- **💬 WhatsApp** abre a conversa com a mensagem pronta — e fica no histórico (sai do «Novo»). Ligação e notas também se registram, com quem e quando.
- **Próximo passo**: a data, o que fazer e o responsável. Atrasado, fica em vermelho e aparece na tela **Hoje**, junto com quem espera o primeiro contato.
- **📅 Agendar** abre a agenda com o nome, o telefone e o serviço já escritos; marcado, o interessado passa a **Agendado**.
- **✓ Virou cliente** cadastra o pet e o tutor já preenchidos (ou só marca, para cadastrar na chegada). **✗ Perdido** pede o motivo (preço, distância, já resolveu…) — é o que mostra onde a clínica perde gente. Os fechados ficam visíveis por 60 dias e podem ser reabertos.

## Campanhas

Abriu horário de banho, começou a campanha de vacina? Em **📣 Campanhas** → **«+ Nova campanha»**, escolha o serviço (e, se quiser, a espécie) e ajuste a mensagem — `{nome}` vira o primeiro nome da pessoa, `{pet}` o nome do pet e `{clinica}` o nome da clínica. O sistema lista quem pediu aquele serviço e ainda está em aberto (marque **«Incluir quem não fechou»** para chamar os perdidos também).

- **💬 Enviar** abre o WhatsApp da clínica com a mensagem já escrita para aquela pessoa. Ela fica **avisada** (com a data e quem enviou) e não aparece de novo na mesma campanha, mesmo que tenha pedido o serviço duas vezes. O envio entra no histórico dela e a tira do «Novo».
- Quem foi avisado e depois virou cliente continua na lista, para a conta da campanha.
- **Encerrar campanha** tira da lista quem ainda não foi avisado.

> **LGPD** — A autorização dada no site vale 12 meses. Vencida, se a pessoa não virou cliente e ninguém conversou com ela nesse tempo, o sistema apaga os dados de contato sozinho (o atendimento fica, anônimo, para os números).


# Planos de saúde

*O plano da própria clínica: o tutor paga por mês e os serviços incluídos não se cobram na hora.*

## Montar o plano

No menu **Planos de saúde → «+ Plano»** (quem configura a clínica): o nome, a **mensalidade**, para quem (cães, gatos ou os dois), a **carência** (dias até o plano valer), o **desconto nos outros serviços** e **o que está incluído** — cada item é um serviço da tabela (ou uma vacina do estoque) com a quantidade *por mês* ou *por ano* (em branco: à vontade). O mês e o ano contam a partir da adesão de cada pet. Mudar o plano vale para quem aderir depois; quem já está nele segue com o valor do dia. «Fora de venda» tira o plano das opções sem mexer em quem já está nele.

## Colocar um pet no plano

Na ficha do pet, **«🩺 Plano de saúde»**: escolha o plano e o dia do vencimento. Quem paga é o tutor principal. A primeira mensalidade vence no dia; as próximas, no dia escolhido de cada mês. Com o plano, a ficha mostra o nome dele e a situação: **Em dia**, **Em carência** ou **Em atraso**.

## O uso

- Ao lançar um serviço incluído (pela ficha, pelo atendimento, pela vacina aplicada), ele entra como **«Plano»** — não se cobra — enquanto houver saldo; a linha mostra quanto já foi usado («1 de 2 por ano»).
- Acabou o saldo, ou é um serviço fora do plano: vale o **desconto** do plano, já no preço.
- Em **carência**, ou com uma mensalidade **vencida há mais de 10 dias**, o plano não cobre: cobra-se normal até acertar.

## As mensalidades

Com o pagamento online conectado (Configurações → Pagamento), a fatura de cada mês sai sozinha **5 dias antes do vencimento** — Pix, boleto ou cartão, como o provedor oferecer —, vai por e-mail e pelo celular e aparece no portal do tutor. Paga, a baixa é automática e ela entra no caixa como uma venda. O e-mail diz o plano, o pet, o mês e o vencimento. Na janela do pet no plano dá para abrir o link (🔗), mandar pelo WhatsApp (💬), gerar a fatura de novo (⟳) ou **«Receber»** no balcão (dinheiro, maquininha, Pix fora do sistema). Sem provedor, a recepção recebe sempre pelo balcão.

A tela mostra os pets no plano, quanto o plano traz por mês, o recebido no mês, quem está em atraso e o vencido em aberto. **«Cancelar o plano»** pede o motivo e cancela as mensalidades em aberto.


# O portal do tutor

*O que o tutor vê — e o app no celular.*

O tutor entra pelo site da clínica (**«Entrar»**, com e-mail ou CPF e a senha que ele criou pelo link). No portal, ele vê o **«Mural da clínica»** e, para cada pet:

- **«Histórico»** — só os registros que a clínica liberou para o tutor;
- **«Carteira de vacinação»**, com **«Imprimir carteira»**, as doses atrasadas em destaque e a foto do selo (📷) quando a clínica anexou;
- **«Peso»**;
- **«Extrato»** — o que está a pagar, o que foi pago e as cortesias; com o pagamento online da clínica conectado, **«Pagar agora»** e **«Copiar o Pix»**;
- **«Documentos»** — receitas, atestados e termos liberados (**«Abrir PDF»**; nos termos, **«Ler o termo»** e **«Li e concordo»**) e os exames e imagens liberados.

O tutor pode trocar a foto do pet e corrigir porte, castração, pelagem, nascimento e microchip (**«Editar dados»**); espécie, raça e o prontuário são da clínica. Os próximos horários e a faixa de alergia aparecem no topo de cada pet. **«Falar com a clínica»** abre a conversa; o WhatsApp da clínica também fica à mão.

## O app no celular

No cartão **«O portal no seu celular»**:

- **«Instalar o app»** — o portal vai para a tela inicial do celular (no iPhone, o portal mostra como fazer pelo Safari);
- **«Ligar os avisos»** — o celular avisa quando a clínica responde, quando chega documento ou termo novo, quando há link de pagamento e quando a vacina está para vencer. Tocar no aviso abre a tela certa. O aviso não leva dado de saúde;
- **«Entrar com a digital neste celular»** — da próxima vez, entra com a digital ou o rosto.

O portal funciona também sem conexão para o que já foi aberto, e se atualiza sozinho.


# Serviços clínicos e preços

*O que foi feito no pet, o que o tutor deve e a tabela de preços.*

## A tabela de preços

Em **Serviços clínicos → «Tabela de preços»**: **«+ Serviço»** com nome, preço e **«Acompanha o atendimento»** (o tipo de registro em que o prontuário sugere esse serviço — por exemplo, a consulta na Consulta). Tabela vazia? **«Usar a tabela sugerida»** traz 14 serviços comuns para você ajustar os valores.

## Do atendimento à cobrança

Ao registrar um atendimento com o bloco **«Cobrar por este atendimento»**, o serviço fica **a cobrar** do tutor, com o preço do dia congelado. Também dá para lançar na ficha do pet, aba **«Serviços e valores» → «+ Lançar serviço»**. Cada item fica A cobrar, Pago, Cortesia ou Cancelado; **«Dar como cortesia»** e **«Cancelar (lançado por engano)»** pedem motivo. Em «+ Lançar serviço», **«Quem fez»** diz o profissional (vem com quem está lançando) — é o que conta para a comissão. No atendimento registrado, quem fez é quem registrou; na alta da internação, as diárias são do responsável.

## Receber

Em **Serviços clínicos → «A cobrar»** há um cartão por tutor, com:

- **«Receber R$…»** — forma (Pix, Dinheiro, Débito, Crédito, Outro), desconto e **«Confirmar recebimento»**; gera recibo numerado;
- **«Link de pagamento»** — com o pagamento online conectado, o tutor paga por Pix, boleto ou cartão e a baixa é sozinha (ver [Pagamento online](https://app.vetcareapp.com.br/ajuda/pagamentos.md));
- **«Lembrar»** — WhatsApp com a lista do que está em aberto;
- **«Balcão»** — leva os serviços para o cupom do balcão, junto com produtos.

A aba **«Histórico»** mostra, por período, o recebido, o a cobrar e as cortesias, os serviços que mais renderam e o total por profissional.


# Balcão e caixa do dia

*Vender produtos, cobrar serviços e fechar a gaveta.*

## O caixa do dia

Em **Caixa**, **«Abrir o caixa»** com o troco inicial. Aberto, ele mostra o vendido, o dinheiro na gaveta, produtos e serviços clínicos, as últimas vendas e o total por forma de pagamento. **«+ Suprimento»** e **«− Sangria»** pedem valor e motivo.

**«Fechar o caixa»**: conte só o dinheiro da gaveta e informe em **«Dinheiro contado»** — Pix e cartão não entram na contagem. A tela diz se **confere** ou quanto **falta/sobra** (com diferença, a observação é obrigatória) e imprime a folha de fechamento, com as linhas de quem fechou e quem conferiu. Os caixas fechados ficam na lista, com a diferença de cada um.

## O balcão (plano Clínica)

Em **Balcão (PDV) → «Vender»**: busque o produto ou passe o leitor de código de barras (o Enter adiciona). Em **«Cliente»**, busque o tutor: aparecem o histórico, «Para qual pet?», o que ele costuma levar e os serviços a cobrar, com **«Pôr no cupom»**. As promoções entram sozinhas. Escolha o pagamento, o desconto e, em dinheiro, o valor recebido (a tela calcula o troco), e **«Finalizar venda»** (F9). Sem cliente, a venda fica como balcão.

- Com o caixa fechado, a tela avisa e leva a **«Abrir o caixa»**.
- Sem estoque suficiente, a tela pergunta se quer **«Vender mesmo assim»** — e o livro do estoque registra.
- Depois da venda: **«Imprimir recibo»** (documento sem valor fiscal) e **«Nova venda»**.
- Na aba **«Vendas»**, **«Cancelar venda»** estorna: os itens voltam ao estoque.

## Pix com QR no balcão

Com o pagamento online conectado, ao escolher Pix aparecem **«Mostrar o QR do Pix aqui»** e **«Já pagou (maquininha / chave da clínica)»**. Com o QR, o tutor paga no app do banco e **a venda fecha sozinha** quando o banco confirma — mesmo que a tela tenha sido fechada. O estoque só baixa nessa hora. **«Cancelar este Pix»** desiste; o Pix esquecido cai sozinho no dia seguinte.


# Estoque

*Plano Clínica, para quem tem permissão de estoque.*

Abas **«Produtos» · «Entradas (NF)» · «Promoções» · «Relatório»**.

## Produtos

**«+ Novo produto»**: categoria, código de barras, unidade, estoque inicial e mínimo, custo e **margem (markup %)** — o preço sai calculado, com a opção de arredondar para ,90 ou definir o preço à mão. **«Controla estoque»** (desmarque para serviço) e **«Vende no balcão»** (desmarque para o que só se usa dentro da clínica). **«Novo kit»** monta um produto com vários. A ficha do produto mostra quem comprou e o livro do estoque.

**Vacinas e lotes.** Na categoria **Vacina**, informe o **tipo de vacina** (V10, antirrábica… — junta as marcas equivalentes e é o nome que o tutor e o lembrete veem) e o **laboratório**. A vacina já vem com **«Controla lote e validade»** (também serve para medicamento): toda entrada pede o lote e a validade, lote vencido não entra, e as saídas tiram do lote que vence primeiro. A aba **«Lotes»** da ficha mostra o saldo, a validade (em vermelho o vencido, em âmbar o que vence em 30 dias) e o custo de cada lote; no **«Ajuste»** de perda, escolha de qual lote saiu.

> **O livro do estoque só cresce** — Corrige-se com **«Ajuste»**, dizendo o que aconteceu: **«Contei a prateleira (inventário)»**, **«Perda / venceu / quebrou»** ou **«Usado na clínica»**.

## Entradas por nota

**«+ Lançar nota»** ou **«Importar XML da NF-e»**: fornecedor, número, itens, e frete, seguro/IPI/ST e desconto da nota, que se distribuem no custo de cada item. A caixa com 12 vira unidades. **«Lançar nota e atualizar preços»** dá entrada e recalcula os preços pela margem.

O item que controla lote pede **lote e validade** logo abaixo da linha (**«+ outro lote»** quando vieram dois lotes no mesmo item, cada um com a sua quantidade). O XML da NF-e de medicamento e vacina já traz os lotes, e preenche sozinho.

## Vacinas

A aba **«💉 Vacinas»** junta o que as vacinas aplicadas pelo prontuário deixaram gravado (só contam as escolhidas do estoque). No período escolhido: as doses, o custo delas (o do lote), o cobrado pela vacina e pela aplicação — separados —, por **tipo** (as marcas equivalentes juntas) e por **marca**, com o preço médio e a **margem da vacina** (sobre as doses cobradas). O gráfico de cada marca mostra, nos últimos 12 meses, o custo de cada compra e o preço de cada dose cobrada: dá para ver na hora se o fornecedor subiu. Em **«Atenção»**: lote vencido com saldo, lote vencendo em 60 dias e vacina abaixo do mínimo.

**Rastreio de lote:** o laboratório recolheu um lote? Digite o número e veja quem recebeu cada dose, com o tutor, o telefone e o **«WhatsApp»** com a mensagem pronta — e as vendas daquele lote no balcão.

## Controlados

No cadastro do produto, **«Controle especial (lista)»** marca a lista da substância (A1 a C5, Portaria MAPA 837/2025); o produto passa a pedir lote. Com algum controlado cadastrado, aparece a aba **«🔐 Controlados»**: por produto, o saldo do início do período, cada entrada (nota, fornecedor, CNPJ, lote e validade) e cada saída (aplicação, venda, perda, uso na clínica — com o motivo), e o saldo do fim, com **«Imprimir»**. É para **conferência**: o MAPA ainda não publicou como reconhecer um sistema informatizado de escrituração; o livro oficial continua com os termos de abertura e encerramento assinados pelo responsável técnico, e o relatório de movimentação vai nos modelos da portaria — copie os números daqui. Use **«Ajuste» → «Usado na clínica»** para registrar o uso em procedimento, dizendo o pet no motivo.

## Promoções

**«+ Nova promoção»**: desconto, combo ou ativada por um serviço ou item, com início e fim. Ficam No ar, Agendada, Pausada ou Encerrada (**«Pausar»**, **«Reativar»**), e o balcão aplica sozinho.


# Pagamento online

*O Pix com QR no balcão e o link de pagamento para o tutor — na conta da clínica.*

É opcional. Em **Configurações → E-mail, pagamento e arquivos → «Pagamento online»**, conecte a conta da clínica no **Mercado Pago** ou no **Asaas** (o guia passo a passo, com as telas, abre pelo link no próprio cartão) e clique em **«Testar conexão»**. O dinheiro cai direto na conta da clínica; o Vetcarë só pede a cobrança e confere o pagamento.

- **Pix do balcão**: o QR aparece na tela e a venda fecha sozinha quando o banco confirma. Ver [Balcão](https://app.vetcareapp.com.br/ajuda/balcao.md).
- **Link de pagamento**: o que o tutor deve, numa fatura (Pix, boleto ou cartão). Envie por **«Enviar pelo WhatsApp»**, **«Enviar por e-mail»** ou **«Copiar link»**; o link aparece também no portal do tutor e o celular dele avisa. Pago, os serviços viram «pagos» sozinhos. Gerar outro link cancela o anterior.

> **Quem diz que pagou é o banco** — O sistema nunca dá baixa só porque recebeu um aviso: ele pergunta ao provedor e só fecha se o provedor confirma. Todo dia, ele também confere sozinho o que ficou pendente. Se a conferência achar um pagamento cujo aviso nunca chegou, a tela [Hoje](https://app.vetcareapp.com.br/ajuda/hoje.md) avisa — a ligação com o provedor pode estar com problema, e o **«Testar conexão»** mostra o que falta.


# Relatórios

*Em tela, em planilha e impressos.*

Escolha o relatório — **«Atendimentos»**, **«Vacinação»**, **«Financeiro»**, **«Produtos e estoque»**, **«Clientes»** ou **«Comissões»** — e o período (7 dias, 30 dias, este mês, mês passado, 90 dias, este ano, ou de/até). **«⬇ Planilha»** baixa para o Excel; **«🖨 Imprimir»** imprime. Financeiro, Produtos, Clientes e Comissões pedem permissão de estoque; Produtos e Comissões são do plano Clínica. Com o modo de ensaio ligado, os números incluem os exemplos, e a tela avisa.

## Comissões

Por profissional: quantos serviços fez no período, o valor lançado, o **recebido**, a **comissão** (sobre o recebido) e a **prevista** (sobre o que ainda está a cobrar). Abra o nome de cada um para ver serviço por serviço, com o percentual usado. Cortesia e cancelado não contam; o desconto dado ao receber a venda inteira não entra na conta.

Os percentuais ficam em **«⚙ Percentuais»** (quem configura a clínica): o **padrão** de cada profissional vale para todo serviço clínico e, se quiser, um percentual por tipo de atendimento vale no lugar dele (cirurgia 30%, consulta 10%…). A dose de vacina do estoque cobrada à parte só entra com o percentual de «Produtos», e o serviço coberto pelo plano de saúde, com o de **«Uso do plano de saúde»** — vale o valor do serviço na tabela, como já recebido (a clínica recebe pela mensalidade); ele aparece na coluna «Pelo plano». Os serviços lançados antes da comissão existir se ligam ao profissional pelo nome.


# O site da clínica

*Já no ar desde o cadastro, com o pedido de horário e a entrada do portal.*

Em **Site da clínica** fica o endereço do site — que é também a porta de entrada da equipe e dos tutores — e as abas:

- **«O site»** — frase da capa, sobre, desde quando, serviços, diferenciais, plantão / emergência (em vermelho), telefone, WhatsApp, Instagram e local; no plano Clínica, também horários, endereço e mapa. **«Salvar o site»**.
- **«Aparência»** — o modelo do site e a cor, com prévia no computador e no celular.
- **«Fotos»** (plano Clínica) — capa, a clínica e o consultório.
- **«Mural»** — avisos com título, texto, cor (informação, importante, urgente), quando entram e saem do ar. Aparecem no site e no portal do tutor.
- **«Galeria»** (adicional) — produtos, serviços e pets para adoção ou venda, com «Tenho interesse» no site; puxando do balcão, preço e esgotado acompanham o estoque.

No site, o tutor vê a clínica, os serviços, o mural e o contato, **«Pedir horário»** (o pedido cai na agenda) e **«Entrar»**. O logotipo do site é o mesmo do papel dos documentos.


# Acessos e níveis

*Quem da equipe entra, e o que cada um pode.*

**«+ Novo acesso»**: nome, e-mail (o login), senha inicial (mínimo 8) e o nível:

| Nível | O que pode |
| --- | --- |
| **Administrador** | Tudo, inclusive a equipe e as configurações. |
| **Gerente** | Atende, vende, cuida do estoque (com custo e lucro) e da equipe; não mexe nas configurações. |
| **Recepção / atendimento** | Agenda, tutores, pets, prontuário e balcão; não vê estoque, custo nem lucro. |
| **Financeiro** | Relatórios, custo e lucro; não atende nem vende. |
| **Somente consulta** | Vê tudo e não muda nada. |

Na aba **«Colaboradores»**: trocar o nível (a pessoa é desconectada), **«Destravar»**, **«Senha»**, e no «⋯» corrigir o nome, trocar o e-mail, ver os aparelhos conectados, bloquear o celular e **desativar** o acesso. Na aba **«Tutores no portal»**: quem já tem senha, quem tem link enviado ou vencido, com **«Enviar link»**, **«Reenviar link»** e **«Revogar»**.

No plano Veterinário(a) há um acesso; no plano Clínica, quantos a equipe precisar.

> **Registros de acesso (Marco Civil da Internet, art. 15)** — Cada entrada no sistema — da equipe e dos tutores no portal, por senha, digital ou no primeiro acesso — guarda a data, a hora e o endereço IP de origem, por 6 meses, sob sigilo. Não aparece em tela nenhuma: só é entregue por ordem judicial. Depois de 6 meses, o sistema apaga sozinho.


# Configurações

*O plano, os documentos, as contas da clínica e a cópia de segurança.*

- **«Plano»** — ver [Planos e assinatura](https://app.vetcareapp.com.br/ajuda/assinatura.md).
- **«Módulos»** — os recursos que nem toda clínica usa: **Internação** (plano Clínica), **Interessados** (com o «Me avise» do site e as campanhas), **Planos de saúde**, **Comissões**, **Pesquisa de satisfação** e **Horários livres no site**. Toque num módulo para **usar** (ligar/desligar), **ocultar do menu** e ajustar o que é dele (o «Me avise», os percentuais da comissão, o expediente…). Desligado, o item do menu fica apagado e a tela mostra o convite para ligar; **desligar não apaga nada** — os dados voltam ao religar. Os do dia a dia já vêm ligados; a pesquisa e os horários livres pedem configuração e vêm desligados. Só quem configura a clínica mexe aqui.
- **«Documentos e assinatura»** — a assinatura e o CRMV de cada veterinário, o papel da clínica (logotipo, cidade, cor, rodapé) e os modelos de documento. Ver [Documentos](https://app.vetcareapp.com.br/ajuda/documentos.md).
- **«E-mail, pagamento e arquivos»** — as contas da clínica:  **E-mail**: com o Gmail é um clique. Os lembretes, o acesso ao portal e os avisos ao tutor saem do endereço da clínica. Sem e-mail conectado, o Vetcarë envia um número limitado por mês em nome da clínica. **Pagamento online** (opcional): Mercado Pago ou Asaas. Ver [Pagamento online](https://app.vetcareapp.com.br/ajuda/pagamentos.md). **Arquivos** (opcional): Cloudinary, R2 ou S3, onde ficam os exames e as imagens anexados. No Cloudinary, a chave se cria em **Settings → API Keys → «Generate New API Key»**, com o papel **Master Admin** — o «Media Library User» parece o certo e não é: com ele o envio falha. Use uma chave **só para o Vetcarë**: como o Master Admin alcança a conta inteira, uma chave dedicada se pode revogar a qualquer momento sem afetar outros usos. O guia passo a passo, com as telas, abre pelo link no cartão.  Cada conta tem **«Testar conexão»**, que diz se está funcionando — use sempre que algo não chegar.
- **«Identidade & marca»** — nome da clínica, contato e endereço.
- **«Feriados»** — os nacionais (já entram sozinhos) e os da cidade e do estado, que você cadastra; todos aparecem na [Agenda](https://app.vetcareapp.com.br/ajuda/agenda.md).
- **«Importar do EasyVet»** — para usar o EasyVet e o Vetcarë juntos enquanto testa. Veja abaixo.
- **«Cópia de segurança»** — **«Baixar cópia»** guarda um arquivo com os dados da clínica; **«Repor uma cópia»** substitui tudo pelo conteúdo do arquivo.
- **«🧪 Ensaio»** — os exemplos para conhecer o sistema. Ver [Primeiros passos](https://app.vetcareapp.com.br/ajuda/comecar.md).

## Importar do EasyVet

Quem vem do EasyVet pode usar os dois sistemas em paralelo: o EasyVet continua sendo o oficial, e o que for lançado nele vem para o Vetcarë **quando você sincronizar** — nada roda sozinho e nada volta para o EasyVet.

1. Em **Configurações → «Importar do EasyVet»**, clique em **«📁 Escolher a pasta do backup»** e aponte a pasta onde o EasyVet salva o backup (o Dados.zip). O navegador lembra a pasta neste computador (use o **Chrome** ou o **Edge**; em outro navegador, use **«Escolher o arquivo…»** a cada vez).
2. Escolha **o que trazer**: o prontuário, a tabela de preços, o valor de cada atendimento e os produtos do estoque (só os novos, ou também acertando o saldo pelo do EasyVet). Tutores e pets vêm sempre. Se o backup tiver outro nome, ajuste o **«Nome do arquivo de backup»** (o * vale qualquer coisa).
3. Quando quiser atualizar, faça o backup no EasyVet e clique em **«🔄 Sincronizar agora»**: o Vetcarë acha o backup mais recente da pasta, mostra o que vai entrar e, confirmado, sincroniza.

- O que já veio **não duplica**: enviar o mesmo backup de novo não muda nada.
- O tutor que a clínica já tinha no Vetcarë, com o mesmo CPF, é **ligado** ao do EasyVet, não duplicado.
- Correção feita no EasyVet num atendimento antigo entra no prontuário como **retificação** («Corrigido no EasyVet»); o cadastro de tutores, pets e preços se atualiza.
- A primeira sincronização traz tudo e leva alguns minutos; dá para continuar usando o sistema. As seguintes levam segundos. Cada envio fica na lista **«Sincronizações»**, com quem enviou, de quando era o backup e o que entrou.
- Só as tabelas que interessam saem do computador (uns poucos MB do backup). Lido do backup, nada disso interfere no EasyVet aberto.

> **Sobre a confiabilidade do que existe** — O sistema tem **1080 testes automáticos** que rodam a cada alteração. Boa parte deles não verifica se algo funciona — verifica se o sistema *recusa* o que deve recusar: alcançar dados de outra clínica, apagar um registro do prontuário, emitir documento sem CRMV, dar baixa num pagamento que o banco não confirmou.


# Planos e assinatura

*Quanto custa, o que muda entre os planos, e o teste grátis.*

|  | Veterinário(a) | Clínica |
| --- | --- | --- |
| Preço | **R$ 125/mês** | **R$ 250/mês** |
| Acessos da equipe | 1 | sem limite |
| Prontuário, vacinas, agenda, documentos, portal do tutor | sim | sim |
| Balcão, estoque, notas e promoções | não | sim |
| Site com mural e pedido de horário | sim | sim |
| Endereço, mapa, horários e fotos no site | não | sim |
| Galeria de exposição | + R$ 50/mês | + R$ 50/mês |

**Teste grátis:** 3 meses, sem cartão. Em **Configurações → «Plano»** dá para mudar de plano (vale a partir da próxima mensalidade), ligar a Galeria e ver a mensalidade: quantos dias de teste restam, se está em dia, e pagar com Pix, boleto ou cartão (**«Pagar com cartão (renova sozinho)»**). Cada mês tem o recibo.


# Dúvidas frequentes

*As perguntas do dia a dia da clínica, com o caminho exato na tela.*

## Registrei errado no prontuário. Como apago?

Não se apaga: o prontuário só cresce. No registro, clique em **«Retificar»**, corrija e informe o **«Motivo da retificação»**. A versão nova fica valendo e a original fica guardada em «versões anteriores». Ver [Pets e prontuário](https://app.vetcareapp.com.br/ajuda/pets.md).

## O botão de emitir receita não deixa emitir. Por quê?

Falta o **CRMV e a UF** de quem está emitindo. Cadastre em **Configurações → Documentos e assinatura → «A minha assinatura»**, com a imagem da assinatura. Pet em óbito também não emite receita. Ver [Documentos](https://app.vetcareapp.com.br/ajuda/documentos.md).

## Como alguém confere que a receita ou o atestado é verdadeiro?

Todo documento sai com um **código e um QR de verificação**. Quem lê o QR (a farmácia, a companhia aérea) abre a página de verificação, que mostra se o documento é autêntico e se está válido ou foi cancelado.

## Emiti um documento errado. E agora?

Na aba **Documentos** da ficha, **«Cancelar»** e informe o motivo; depois emita o certo. O cancelado sai do portal do tutor e o QR dele passa a mostrar CANCELADO.

## O tutor recebe lembrete da vacina sozinho?

Sim, por e-mail, se os **«Lembretes por e-mail»** estiverem ligados em **Vacinas e retornos** e o tutor tiver e-mail no cadastro — e no celular, se ele instalou o portal e ligou os avisos. Os e-mails saem do e-mail da clínica conectado em Configurações. Para quem não tem e-mail, use o botão **«WhatsApp»** de cada linha. Ver [Vacinas e retornos](https://app.vetcareapp.com.br/ajuda/vacinas.md).

## Como tiro um pet da lista de vacinas atrasadas?

Registrando a dose na ficha (**+ Vacina**): ele sai da lista sozinho. Se a vacina foi aplicada em outro lugar, registre do mesmo jeito, com a data em que foi aplicada.

## Como o tutor entra no portal?

Na ficha do tutor, **«Acesso ao portal»** → **«Enviar pelo WhatsApp»** (ou e-mail). Ele cria a senha pelo link (vale 7 dias, uma vez) e depois entra pelo site da clínica, em **«Entrar»**, com e-mail ou CPF. Se esqueceu a senha, **«Esqueci minha senha»** na mesma tela. Ver [Portal do tutor](https://app.vetcareapp.com.br/ajuda/portal.md).

## O tutor diz que não vê a consulta no portal.

Ele só vê o que a clínica libera. No registro, marque **«O tutor pode ver este registro no portal»** (vacina, vermífugo, peso e receita já vêm marcados). Documentos aparecem quando emitidos com **«mostrar no portal do tutor»**; anexos, com **«Mostrar ao tutor»**.

## Chegou um pedido de horário pelo site. O que faço?

Ele aparece na tela Hoje e na Agenda como **«Pedido pelo site»**. Combine com o tutor (o telefone abre o WhatsApp), abra o pedido e use **«Definir horário»** — ou **«Confirmar como está»**, se o dia e o período servem.

## O tutor pagou o Pix do balcão, mas a tela fechou. A venda se perdeu?

Não. Quando o banco confirma, o servidor fecha a venda sozinho e baixa o estoque, com a tela aberta ou não. Confira em **Balcão → «Vendas»**. Ver [Balcão](https://app.vetcareapp.com.br/ajuda/balcao.md).

## O tutor vai pagar a consulta depois. Como fica registrado?

O serviço fica **a cobrar** na conta dele (Serviços clínicos → «A cobrar», e na ficha do pet → «Serviços e valores»). Quando ele pagar, **«Receber R$…»**; para cobrar à distância, **«Link de pagamento»** ou **«Lembrar»** pelo WhatsApp. Ver [Serviços clínicos](https://app.vetcareapp.com.br/ajuda/servicos.md).

## O caixa não bateu no fechamento.

No fechamento só se conta o **dinheiro da gaveta** — Pix e cartão ficam de fora. Confira as sangrias e suprimentos do dia e as vendas em dinheiro; se a diferença for real, escreva a observação (é obrigatória) e feche. A folha impressa leva a diferença.

## O estoque de um produto está errado.

Na ficha do produto, **«Ajuste»** → **«Contei a prateleira (inventário)»** e informe a quantidade real. Perda, validade vencida ou uso na própria clínica têm a opção própria. O livro do estoque guarda o motivo.

## Dá para ver a agenda no celular, no Google Agenda?

Sim. Na Agenda, **«📅 Google»** → escolha «Toda a clínica» ou «Só os meus horários» → **«Copiar»**, e cole em Google Agenda → Outras agendas → «Do URL». A agenda se atualiza sozinha. Ver [Agenda](https://app.vetcareapp.com.br/ajuda/agenda.md).

## Quero ver o sistema funcionando antes de cadastrar meus pacientes.

Use o modo de ensaio: **Configurações → 🧪 Ensaio → «Carregar os exemplos»**. Os exemplos aparecem com moldura vermelha e saem todos com **«Encerrar o ensaio»**. Ver [Primeiros passos](https://app.vetcareapp.com.br/ajuda/comecar.md).

## Uso o EasyVet. Dá para usar os dois juntos enquanto testo?

Dá. Em **Configurações → «Importar do EasyVet»**, escolha a pasta do backup do EasyVet e, quando quiser atualizar, clique em **«Sincronizar agora»**. O que é novo entra, nada duplica, e a correção feita no EasyVet vira retificação no prontuário. Ver [Configurações](https://app.vetcareapp.com.br/ajuda/config.md).

## Quanto custa? Tem teste grátis?

**R$ 250/mês** no plano Clínica e **R$ 125/mês** no plano Veterinário(a), com **3 meses grátis**, sem cartão. A Galeria é um adicional de R$ 50/mês. Ver [Planos e assinatura](https://app.vetcareapp.com.br/ajuda/assinatura.md).

## Alguém me indicou o Vetcarë e me passou um código. Onde eu uso?

No cadastro, no campo **«Código do representante (opcional)»**. Quem já tem conta e não informou o código pode pedir ao suporte (Novidades → Sugerir melhoria).


Passo a passo para o gestor

# Conectar sua conta Asaas ao Vetcarë

O Asaas é quem emite o boleto e o Pix e recebe o dinheiro — **na sua conta**. O Vetcarë só dá as ordens (gerar o Pix do balcão e o link de pagamento do tutor, cancelar) e mostra a baixa automática. Este guia liga uma coisa na outra, em poucos passos.

> **A conta é sua, o dinheiro é seu.** — Você abre a conta no Asaas com o seu CPF/CNPJ; o Vetcarë nunca fica com o dinheiro nem com a sua chave. O que você faz aqui é só entregar ao Vetcarë a **chave de API** (para ele cobrar em seu nome) e configurar o **webhook** (para o Asaas avisar o Vetcarë quando alguém paga).

Antes de começar: não confunda as 3 informações

| O quê | Onde NASCE | Onde você COLA |
| --- | --- | --- |
| Chave de API (secreta) | No **Asaas** Integrações → Chaves de API | No **Vetcarë** Pagamento online → campo «Chave de API» |
| URL do webhook | No **Vetcarë** tem botão «Copiar» | No **Asaas** campo «URL do Webhook» |
| Token do webhook (secreto) | O **Vetcarë gera** e guarda botão «Copiar» (e «Gerar novo») | No **Asaas** campo «Token de autenticação» |

A **Chave de API** e o **Token do webhook** são coisas **diferentes**: a chave deixa o Vetcarë *cobrar* pela sua conta; o token só *prova* que o aviso de pagamento veio mesmo do Asaas. Não troque um pelo outro.

## Passo 1 — Criar e ativar a conta no Asaas

*Em `asaas.com`, abra a conta com CPF ou CNPJ. O Asaas pede alguns dados e o **envio de documentos** para liberar a conta.*

1. Preencha os dados da conta e os **dados comerciais**.
2. Na etapa **Documentos**, aponte a câmera do celular para o QR Code (ou use «Copiar link») e envie os documentos de identificação.
3. Aguarde a **Análise de conta** — é o Asaas liberando você para cobrar de verdade.

> **Enquanto a conta está em análise**, use o **Sandbox** (passo 6) para testar sem mexer em dinheiro real.

## Passo 2 — Abrir as «Integrações»

*É onde ficam a chave de API e os webhooks.*

1. No canto superior direito, clique no **ícone da sua conta** (avatar).
2. No menu, clique em **Integrações**.

## Passo 3 — A tela de Integrações — onde está tudo

*No topo, as abas que importam: **Chaves de API** (passo 4) e **Webhooks** (passo 5).*

## Passo 4 — Gerar a Chave de API e colar no Vetcarë

*A chave de API é o que permite ao Vetcarë cobrar em seu nome, pela sua conta. Ela é **secreta** — trate como uma senha.*

**4.1 — Abrir a aba.** Em **Chaves de API**, clique em **Gerar chave de API**.

**4.2 — Nomear a chave.** Dê um nome (ex.: *Vetcare*). A expiração é opcional.

> **Permissão de saque: não precisa.** — A clínica só *recebe* pelo Vetcarë (o Pix do balcão e o link de pagamento do tutor) — deixe a caixa «Permitir que esta chave execute operações de saque via API» **desmarcada**.

**4.3 — Autorizar por SMS.** O Asaas pede um código por SMS para liberar a criação da chave. Clique em «Enviar código», digite o que chegar e confirme.

**4.4 — Copiar a chave AGORA.** A chave aparece **uma única vez**. Clique em **Copiar** e guarde num lugar seguro — o Asaas **não** mostra ela de novo.

> **Se você perder a chave**, não tem como recuperá-la — é só gerar uma nova (e trocar no Vetcarë). A antiga pode ser removida.

**4.5 — Conferir.** A chave passa a aparecer na lista, como **Habilitado**.

**4.6 — Colar no Vetcarë.** Vá em **Configurações → E-mail, pagamento e arquivos → Pagamento online**, escolha **Asaas**, cole a chave no campo **Chave de API** e escolha o **ambiente** (Sandbox para testar, Produção para valer). No fim, clique em **Salvar**.

> **A chave nunca reaparece depois de salva.** — No Vetcarë, o campo mostra «guardado — deixe em branco para manter»; você só digita de novo se for trocar.

> **Confirme na hora:** — depois de salvar, clique em **«Testar conexão»** (ao lado de Salvar). Se a chave estiver certa, aparece o selo **«Testado»** em verde. É o «deu certo?» da chave de API.

## Passo 5 — Ligar o webhook (a baixa automática)

*O webhook é o Asaas **avisando o Vetcarë** na hora em que alguém paga — é o que faz a venda do balcão fechar sozinha e os serviços do tutor virarem «pagos». Sem ele, o dinheiro entra no Asaas e o Vetcarë nunca fica sabendo.*

**5.1 — Um clique no Vetcarë.** Em **Configurações → E-mail, pagamento e arquivos → Pagamento online → Asaas**, depois de salvar a chave (passo 4.6), clique em **«Configurar o webhook no Asaas»**. O Vetcarë cria (ou corrige) o webhook na sua conta com tudo certo — URL com a chave, token, **ativo**, envio **sequencial** e os eventos de pagamento. Não precisa abrir o painel do Asaas.

**5.2 — Confira.** Clique em **«Testar conexão»**. Tem que aparecer em verde: *«Webhook ativo, sequencial e com todos os eventos; chave Pix ativa»*. Se o botão acusar algum erro, crie o webhook à mão pelo **Apêndice A**, no fim deste guia.

> **Como saber que funcionou:** — no Vetcarë, o Pix do balcão pago fecha a venda sozinho, com a tela aberta ou não. No Asaas, a aba **Logs de Webhooks** mostra cada aviso e a resposta.

> **Se as baixas não chegarem:** — no Vetcarë, clique em **«Testar conexão»** — ele confere o webhook (ativo, fila não interrompida, sequencial, eventos, token) e a chave Pix, e diz o que falta. No **Registro do sistema**, a linha «webhook recusado» indica que o Asaas está chamando com o token errado. No Asaas, a **«Fila de sincronização»** interrompida faz os eventos serem gerados mas **não enviados** — reative e veja os **Logs de Webhooks**. Na dúvida, **«Configurar o webhook no Asaas»** conserta tudo de uma vez.

## Passo 6 — Sandbox × Produção

*Duas contas separadas, para não misturar teste com dinheiro real.*

1. **Sandbox** (teste): crie a conta Sandbox pela tela de Integrações, use a **chave de sandbox** e escolha o ambiente **Sandbox** no Vetcarë. Boletos e Pix são de mentira — perfeito para ensaiar.
2. **Produção** (valer): com a conta aprovada, use a **chave de produção** e o ambiente **Produção** no Vetcarë. O webhook precisa ser configurado **em cada uma** (a URL do Vetcarë é a mesma; o token, de preferência, diferente).

## Está tudo funcionando?

*Um passa-olho final antes de considerar pronto:*

1. **Chave de API** colada no Vetcarë (passo 4).
2. **«Testar conexão»** em verde: *«Webhook ativo, sequencial e com todos os eventos; chave Pix ativa»* (use «Configurar o webhook no Asaas» se faltar algo).
3. **Ambiente** certo: *Sandbox* enquanto ensaia, *Produção* quando for valer.

## Apêndice — criar o webhook à mão

*Só se o botão «Configurar o webhook no Asaas» (passo 5.1) acusar erro. É o mesmo webhook, criado no painel do Asaas. Depois, confira com «Testar conexão» (passo 5.2).*

**A.1 — No Vetcarë, copie a URL.** Na tela de Pagamento online (passo 4.6), na caixa **«Baixa automática (webhook)»**, a **URL do webhook** já vem pronta, com a chave de autenticação embutida no fim (`?chave=…`). Clique em **Copiar** — você não inventa nem digita nada.

> **A URL é só desta clínica.** — Ela termina com o identificador da sua conta e a chave que o Vetcarë gerou — por isso se **copia do Vetcarë**, inteira.

**A.2 — No Asaas, abra o formulário.** Integrações → aba **Webhooks** → **+ Adicionar Webhook**.

**A.3 — Preencha:**

1. **Nome do Webhook:** qualquer nome (ex.: «Vetcarë»).
2. **URL do Webhook:** cole a **URL** que você copiou do Vetcarë (passo A.1).
3. **Token de autenticação:** deixe **em branco** — a chave já está na URL. **Não use «Gerar Token» do Asaas.**
4. **Versão da API: v3.** Deixe «Este Webhook ficará ativo?» e «Fila de sincronização ativada?» **ligados**.
5. **Tipo de envio: Sequencial** — escolha na lista (ela vem vazia). No envio sequencial os avisos chegam na ordem certa (confirmado antes de recebido).
6. **E-mail:** o seu — o Asaas avisa ali se o webhook começar a falhar.

**A.4 — Marque os eventos e salve.** Em «Adicionar Eventos → Cobranças», marque os eventos. **Pode marcar todos** — o Vetcarë usa os de pagamento (`PAYMENT_CONFIRMED`, `PAYMENT_RECEIVED`, `PAYMENT_OVERDUE`, `PAYMENT_REFUNDED`…). Depois clique em **Salvar**.

Vetcarë · Guia da integração Asaas · 19/08/2026, atualizado em 27/09/2026. As telas do Asaas podem mudar com o tempo; o passo a passo segue o mesmo.


Passo a passo para o gestor

# Conectar sua conta Cloudinary ao Vetcarë

O Cloudinary guarda os **exames e as imagens** que você anexa ao prontuário no Vetcarë — numa conta **sua**, com a sua cota. O Vetcarë só envia, lê e apaga os arquivos pela chave que você entrega aqui.

> **Os arquivos são seus e ficam privados.** — Tudo é guardado em modo privado: nenhum arquivo tem endereço público, e o download sempre passa pelo Vetcarë, que confere quem está pedindo. Há plano gratuito — confira o limite atual no site do Cloudinary.

> **Há um jeito mais curto: «Conectar Cloudinary».** — No cartão do Cloudinary, digite o **Cloud name** (passo 2 abaixo) e clique em **Conectar Cloudinary**. Autorize na tela do Cloudinary e pronto: sem gerar chave nem escolher papel. Os passos 3 e 4 deste guia são para quem prefere usar a chave de API.

Antes de começar: as 3 informações

| O quê | Onde NASCE | Onde você COLA |
| --- | --- | --- |
| Cloud name | No **Cloudinary** painel inicial (Dashboard) ou Settings | No **Vetcarë** Arquivos → «Cloud name» |
| API Key | No **Cloudinary** Settings → API Keys | No **Vetcarë** Arquivos → «API Key» |
| API Secret (secreta) | No **Cloudinary** junto da API Key | No **Vetcarë** Arquivos → «API Secret» |

## Passo 1 — Criar a conta no Cloudinary

*Em `cloudinary.com`, clique em **Sign up for free** e crie a conta com o e-mail da clínica. O plano gratuito atende a maioria das carteiras no começo.*

## Passo 2 — Achar o Cloud name

*Depois de entrar, clique na **engrenagem** (Settings), no canto inferior esquerdo. O **Cloud name** é o nome no alto do menu, à esquerda. É o nome da sua «nuvem» e não é segredo. Copie e guarde.*

## Passo 3 — Gerar uma chave com o papel certo

*A chave é o que deixa o Vetcarë guardar os arquivos na sua conta. **O papel dela decide se funciona.***

1. No menu das configurações, clique em **API Keys**.
2. Clique em **Generate New API Key**, no canto superior direito.
3. Dê um nome que você reconheça depois, como **Locare**.
4. Em **Role**, escolha **Master Admin**.

> **«Media Library User» não funciona.** — É o papel que aparece ao lado, e o nome parece o certo. Mas ele não permite enviar nem apagar arquivos: a chave é aceita e falha no primeiro anexo. A chave nova também nasce sem permissão nenhuma — o papel precisa ser escolhido na hora de gerar. Se o seu plano oferecer **Tech Admin** ou **Media Library Admin**, eles também servem e dão menos poder. Na dúvida, Master Admin.

## Passo 4 — Copiar a API Key e o API Secret

*A chave criada aparece na lista. A **API Key** é o número da coluna API Key, na linha dela. O **API Secret** fica oculto: passe o mouse sobre ele e use o **olho** para ver ou o ícone ao lado para **copiar**. Trate o Secret como uma senha.*

> **Use uma chave só para o Vetcarë.** — Master Admin alcança a conta inteira do Cloudinary. Com uma chave dedicada, se um dia precisar revogar, você revoga só esta, sem derrubar mais nada.

## Passo 5 — Colar no Vetcarë e testar

1. No Vetcarë, vá em **Configurações → E-mail, pagamento e arquivos → Arquivos (opcional)** e escolha **Cloudinary**.
2. Cole o **Cloud name**, a **API Key** e o **API Secret**, e clique em **Salvar**.
3. Clique em **Testar conexão**. Aparecendo o selo **«Testado»** em verde, está pronto.

> **O «Testar conexão» tira a dúvida de verdade.** — Ele não confere só a senha: grava um arquivo, lê de volta, compara e apaga. Se o papel da chave estiver curto, você descobre ali, e não no primeiro exame anexado.

## Está tudo funcionando?

1. **Cloud name**, **API Key** e **API Secret** colados em Arquivos.
2. Selo **«Testado»** em verde depois do «Testar conexão».
3. Uma foto enviada num imóvel aparece na ficha dele.

Vetcarë · Guia da integração Cloudinary · 24/09/2026, com o «Conectar Cloudinary». As telas do Cloudinary podem mudar com o tempo; o passo a passo segue o mesmo.

---
Central de Ajuda Vetcarë · revisão de 26/10/2026 · versão para pessoas: https://app.vetcareapp.com.br/manual