Como ligar o TOConline ao EazyAL para faturação de Alojamento Local
Se a sua empresa de Alojamento Local já utiliza o TOConline, pode ligar essa empresa ao EazyAL e emitir os documentos de estadia lá. As suas faturas permanecem na empresa do TOConline onde os seus registos já são guardados. O EazyAL utiliza os detalhes do hóspede e da estadia de um Registo de Estadia revisto, para que não tenha de os introduzir novamente.
Você escolhe e confirma cada documento. O EazyAL não emite faturas de forma automática ou programada. Não existe qualquer taxa adicional do EazyAL por ligar o TOConline, e o EazyAL guarda o PDF certificado juntamente com a estadia.
Este guia explica como obter os valores da API do TOConline, ligar a sua empresa, escolher as séries de documentos e emitir um documento a partir de uma estadia.
Porquê ligar o TOConline ao EazyAL?
Mantém a sua empresa atual do TOConline e as suas séries de faturação. Os dados do hóspede e as linhas de alojamento e limpeza vêm do Registo de Estadia revisto no EazyAL. Após a emissão de um documento, pode encontrar o seu PDF ao lado da estadia no EazyAL.
O seletor de estadias também identifica as estadias que já foram faturadas no TOConline. Verifique esse estado antes de criar um documento, para não faturar a mesma estadia duas vezes.
O EazyAL ajuda a preparar e a emitir o documento de estadia. A sua configuração existente do TOConline continua a ser responsável pela comunicação dos documentos à Autoridade Tributária (AT).
Antes de começar
Certifique-se de que tem:
Acesso à conta de Empresário da empresa no TOConline. Precisa desta conta para solicitar os valores da API.
Pelo menos uma série comunicada à AT para faturas (FT) ou faturas-recibo (FR). As séries para notas de crédito (NC) e recibos (RC) são opcionais.
Os dados de emitente da empresa: NIF, nome oficial, email oficial e domicílio fiscal.
Uma função no EazyAL com permissões de configurações e finanças. Se não as tiver, o EazyAL solicitará que peça ao proprietário do espaço de trabalho para ligar o TOConline.
Passo 1: Obter os valores da sua API no TOConline
Inicie sessão no TOConline utilizando a conta de Empresário da empresa. Abra Empresa › Configurações › Dados API.
Introduza os seus próprios dados como integrador. O TOConline enviar-lhe-á um email com uma hiperligação para obter os valores da API. A ligação é válida por 72 horas, pelo que deve abri-la antes que expire.
Copie os quatro valores apresentados na página:
ID do Cliente (Client ID)
Segredo (Secret)
URL de OAuth
URL da API
Os endereços de OAuth e da API incluem um número de aplicação, como app10 ou api10. Esse número pode diferir entre empresas. Copie ambos os URLs exatamente como o TOConline os apresenta; não utilize os exemplos deste guia como os valores da sua empresa.
Deixe o endereço de redirecionamento como está.
Passo 2: Escolher o TOConline no EazyAL e ligar
No EazyAL, abra Compliance Hub › Invoices (Faturas) e escolha “Já uso o TOConline”.
Cole o ID do Cliente, o Segredo, o URL de OAuth e o URL da API que copiou. Em seguida, introduza o NIF, nome oficial, email e domicílio fiscal da empresa.
O EazyAL testa a ligação e lê as séries disponíveis antes de guardar a configuração. As suas credenciais são armazenadas de forma encriptada. Não existe uma página de início de sessão dentro do EazyAL: solicita os valores no TOConline e introdu-los no EazyAL.
Passo 3: Escolher as suas séries e definições de pagamento
Escolha a série que pretende que o EazyAL utilize para cada tipo de documento:
FT: fatura
FR: fatura-recibo
NC: nota de crédito
RC: recibo
Precisa de uma série FT ou FR comunicada para emitir documentos de estadia. As séries NC e RC são opcionais. Se não utilizar um desses tipos de documento, marque-o como “Não usar”.
Escolha o seu método de pagamento habitual para faturas-recibo e recibos. Pode alterá-lo ao registar um pagamento. As opções disponíveis são dinheiro, referência de Multibanco, transferência bancária, cartão de débito, cartão de crédito e débito direto.
Por fim, escolha a região de IVA: Portugal Continental, Açores (PT-AC) ou Madeira (PT-MA). Verifique as seleções e, em seguida, clique em “Guardar e começar”.
[Captura de ecrã 5: O ecrã de séries e definições de pagamento, incluindo a opção “Não usar”.]
Passo 4: Emitir um documento a partir de uma estadia
Escolha uma estadia revista no EazyAL. As linhas de alojamento e limpeza estão pré-preenchidas com a taxa reduzida de IVA, e pode editar as linhas antes de emitir o documento.
Escolha o tipo de documento:
Selecione Fatura (FT) para uma fatura.
Selecione Paga já (FR) quando o hóspede já tiver pago e pretender uma fatura-recibo.
Pode introduzir o NIF do cliente. Se o deixar em branco, o documento é emitido a um consumidor final.
Os valores apresentados no EazyAL incluem IVA. Reveja as linhas e o total: o EazyAL envia os valores para o TOConline exatamente como os reviu. Quando tudo estiver correto, confirme e selecione “Emitir no TOConline”. O TOConline cria e finaliza o documento de imediato.
Antes de confirmar, verifique o estado da estadia no seletor. Se o EazyAL sinalizar que a estadia já foi faturada no TOConline, não crie outro documento para a mesma.
A taxa turística necessita da sua própria fatura
O TOConline não permite linhas isentas de IVA e linhas tributadas na mesma fatura. Por esse motivo, o EazyAL deixa a taxa turística fora da fatura de estadia e explica isso no ecrã.
Se necessitar de faturar a taxa turística, crie um documento separado no TOConline utilizando um motivo de isenção do seu catálogo do TOConline. Cada fatura só pode utilizar um motivo de isenção. Verifique os detalhes antes de emitir o documento separado.
Passo 5: Recibos, notas de crédito e PDFs
Após emitir um documento, utilize as ações disponíveis no seu registo:
Registar pagamento emite um recibo (RC) para uma fatura FT.
Creditar esta fatura na totalidade emite uma nota de crédito (NC). O motivo que introduzir aparece na nota de crédito.
Descarregar PDF guarda uma cópia do documento.
Enviar PDF por email envia-o para o hóspede.
As notas de crédito no EazyAL cobrem atualmente a totalidade da fatura. Se já tiver sido registado um recibo para uma fatura, faça a correção no TOConline.
Como estas faturas chegam às Finanças
O TOConline comunica os documentos à AT, quer através da sua própria comunicação quer através do processo mensal de SAF-T. Utilize o método de comunicação que já configurou para a sua empresa no TOConline. O EazyAL não envia faturas para a AT.
Para verificar um documento, vá a e-Fatura › Faturação › Emitente › Consultar Documentos. O documento é emitido no TOConline, pelo que não necessita de emitir uma segunda fatura para a mesma estadia.
Problemas comuns
“O TOConline já não aceita as credenciais guardadas.”
Solicite novos valores através de Empresa › Configurações › Dados API e substitua os valores guardados no EazyAL. As suas séries e faturas existentes permanecem no TOConline.
“Ainda não existem séries FT no TOConline.”
Crie uma série de faturação no TOConline e comunique-a à AT. Em seguida, volte ao EazyAL e verifique as séries disponíveis novamente.
O estado do documento diz “Por confirmar”.
O TOConline não devolveu uma resposta clara. Selecione “Verificar de novo”. O EazyAL procura o documento no TOConline e não o enviará uma segunda vez.
“O TOConline não respondeu.”
A sua ligação está guardada. Tente novamente mais tarde.
“Ocorreu um erro. Nada foi emitido.”
Esta mensagem significa que nenhum documento foi emitido, pelo que é seguro tentar novamente.
Perguntas frequentes
O EazyAL cobra pela ligação ao TOConline?
Não. Não existe qualquer taxa adicional do EazyAL para esta ligação.
O EazyAL vai criar a minha empresa no TOConline?
Não. Precisa de uma empresa existente no TOConline e de acesso à respetiva conta de Empresário para obter os valores da API.
Posso continuar a utilizar o TOConline para tudo o resto?
Sim. O EazyAL emite os documentos de estadia na empresa ligada; pode continuar a utilizar o TOConline para o seu restante trabalho.
Posso mudar do Vendus, InvoiceXpress ou EazyAL?
Sim. Escolha “Mudar de fornecedor de faturação” no EazyAL.
Porque é que a taxa turística não está na fatura de estadia?
O TOConline não permite linhas isentas de IVA e linhas tributadas na mesma fatura. O EazyAL deixa a taxa turística fora dessa fatura; crie um documento separado no TOConline se necessitar de a faturar.
Ligar a sua empresa do TOConline
Abra o Compliance Hub › Invoices no EazyAL e ligue a empresa do TOConline que já utiliza. Uma vez ligada, poderá rever uma estadia e emitir o respetivo documento na empresa correta sem ter de introduzir novamente os dados da estadia.
