Como ligar o TOConline e emitir faturas certificadas

No fim, as faturas que emite na Medora saem na conta TOConline da clínica, com as séries e os dados fiscais da empresa, e seguem para o paciente por email.

  • 10 min
  • Para: Administrador da organização (para ligar a conta)
  • Atualizado em 11 de novembro de 2026

Antes de começar

Passo 1 — Peça os dados de API no TOConline

As faturas são emitidas na conta TOConline da própria clínica. A Medora liga-se a ela com quatro valores que o TOConline envia por email.

  1. Entre no TOConline com uma conta de Empresário.
  2. Vá a «Empresa» › «Configurações» › «Dados API».
  3. Indique o seu nome e email como integrador e confirme.
  4. Abra o link que recebe por email e copie os quatro valores: API_URL, OAUTH_URL, OAUTH_CLIENT_ID e OAUTH_CLIENT_SECRET.

O link do email só é válido durante 72 horas. Se expirar, peça os dados de novo no mesmo ecrã do TOConline.

Passo 2 — Ligue a conta à Medora

A ligação é feita uma vez para toda a organização. Só o administrador da organização vê este ecrã.

  1. Na barra lateral do local, clique em «Configurações».
  2. No grupo «Faturação e pagamentos», clique em «Faturação».
  3. No cartão «Ligar a sua conta TOConline», cole cada valor no campo com o mesmo nome: «Endereço da API (API_URL)», «Endereço de autenticação (OAUTH_URL)», «Identificador (OAUTH_CLIENT_ID)» e «Segredo (OAUTH_CLIENT_SECRET)».
  4. Clique em «Ligar ao TOConline».

A Medora testa a ligação de imediato, confirma que a empresa tem uma série de faturas e não guarda nada até o teste correr bem. Se algum valor estiver errado, aparece a mensagem do TOConline: corrija e tente outra vez.

Com a conta ligada, o cartão passa a «TOConline ligado», com os botões «Testar ligação» e «Desligar».

Se já tinha o InvoiceXpress ligado, os documentos novos passam a ser emitidos no TOConline. Os que já emitiu no InvoiceXpress ficam lá e continuam a abrir-se na Medora.

Passo 3 — Confirme as séries e os impostos

Cada documento vai para a série marcada «Por omissão» do seu tipo no TOConline: fatura, fatura-recibo, fatura simplificada e nota de crédito. Se um tipo não tiver série por omissão, o TOConline escolhe uma.

  1. No TOConline, abra «Empresa» › «Configurações» › «Séries de Documentos».
  2. Para cada tipo de documento que vai emitir, confirme que há uma série ativa, marcada «Por omissão» e comunicada à AT.

Os impostos são os da empresa no TOConline. Cada linha da fatura leva a taxa de IVA do ato, por isso confirme que a empresa tem no TOConline as taxas que os seus atos usam.

Se uma fatura for recusada porque a série ainda não foi comunicada, comunique-a no TOConline e, na página da fatura na Medora, clique em «Tentar novamente».

Passo 4 — Emita a primeira fatura

  1. Na barra lateral do local, clique em «Consultas» e abra uma consulta concluída, com atos por faturar.
  2. No topo da página, clique em «Emitir fatura» e escolha «Emitir no TOConline».
  3. Reveja o tipo de documento, o preço e o IVA de cada linha e, se houver linhas a 0%, o «Motivo de isenção de IVA». Clique em «Criar Fatura»: fica um rascunho.
  4. Na página da fatura, clique em «Finalizar». O documento é emitido no TOConline e, se a ficha do paciente tiver email, segue para esse email.

O resto da faturação funciona como com o InvoiceXpress: a Caixa emite o documento ao concluir a venda, a compra de um pacote gera a fatura, as rendas de gabinetes emitem-se em Rendas › Cobranças e os lotes das entidades preparam a fatura à entidade.

Passo 5 — Saiba o que muda em relação ao InvoiceXpress

  • O PDF só existe depois de o documento ser finalizado: num rascunho, «Ver PDF» não aparece.
  • Não há recibo avulso. O TOConline cria o recibo quando a fatura é dada como paga, e a fatura-recibo já sai paga.
  • O email com o documento leva o assunto, mas não um texto à medida.
  • O cartão de impostos das Configurações da Medora é só do InvoiceXpress: os impostos gerem-se no TOConline.

O resultado

Todos os documentos ficam em «Gestão» › «Faturação», com o estado «Rascunho», «Finalizada», «Paga» ou «Cancelada». A cada 15 minutos, a Medora vai buscar ao TOConline as alterações aos documentos recentes, por isso o estado acompanha o que fizer diretamente no TOConline.

Os pacientes com acesso ao portal do paciente encontram os documentos finalizados e pagos em «Faturas».

Perguntas frequentes

Tem custo na Medora?
Não. A ligação ao TOConline está incluída em todos os planos. A licença do TOConline contrata-se diretamente ao TOConline.
Já uso o InvoiceXpress. O que acontece às faturas antigas?
Ficam na conta InvoiceXpress e continuam a abrir-se na Medora. Só os documentos novos passam a ser emitidos no TOConline.
Porque é que a fatura foi recusada por causa da série?
Porque a série que o TOConline usou ainda não foi comunicada à AT, ou não há série por omissão para esse tipo de documento. Acerte-a em «Empresa» › «Configurações» › «Séries de Documentos» no TOConline e clique em «Tentar novamente» na fatura.
Se desligar o TOConline perco as faturas?
Não. As faturas já emitidas continuam na sua conta TOConline. Deixa apenas de ser possível emitir, atualizar ou abrir esses documentos na Medora até voltar a ligar a conta.

Saber mais