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
- Uma conta TOConline com licença de Gestão Comercial ativa e uma série de faturas
- Atos com preço e taxa de IVA
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.
- Entre no TOConline com uma conta de Empresário.
- Vá a «Empresa» › «Configurações» › «Dados API».
- Indique o seu nome e email como integrador e confirme.
- 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ã.
- Na barra lateral do local, clique em «Configurações».
- No grupo «Faturação e pagamentos», clique em «Faturação».
- 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)».
- 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.
- No TOConline, abra «Empresa» › «Configurações» › «Séries de Documentos».
- 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
- Na barra lateral do local, clique em «Consultas» e abra uma consulta concluída, com atos por faturar.
- No topo da página, clique em «Emitir fatura» e escolha «Emitir no TOConline».
- 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.
- 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.