by
Faturação automática no TOConline.
Cada pagamento recebido no Shopify, no Stripe, no Lodgify, na Easypay ou na EuPago passa a dar uma fatura no seu TOConline, e cada reembolso uma nota de crédito. Este guia mostra, passo a passo, como ligar o TOConline ao Rioko.
→
Acesso ao TOConline da sua empresa (Empresa > Configurações), com o módulo de Gestão Comercial ativo, e à sua plataforma de pagamento.
Cerca de 10 minutos, do início ao primeiro documento.
7,50 € + IVA por mês ou 75 € + IVA por ano, por integração.
O que precisa de ter
Confirme estes pontos antes de abrir o assistente do Rioko.
- Módulo de Gestão ComercialA API do TOConline só está disponível com o módulo de Gestão Comercial da empresa ativo.
- Ligação à ATO TOConline tem de estar ligado à Autoridade Tributária com um subutilizador. Veja Ligar o TOConline à AT.
- Série comunicadaO Rioko só lista séries comunicadas à AT. Veja Comunicar séries no TOConline.
- Dados APIPedem-se em Empresa, Configurações, no passo 2 deste guia.
Como funciona
A sua plataforma de pagamento avisa o Rioko de cada pagamento. O Rioko cria o documento no seu TOConline pela API oficial do TOConline, com o IVA, o tipo de documento e a finalização que definir. O acesso dá-se uma vez, nos Dados API do TOConline, e o Rioko mantém-no ativo sozinho.
O seu cliente paga na sua loja, reserva ou canal de pagamento.
by
Rioko
Aplica as suas regras: tipo de documento, IVA, isenção e finalização.
Documento
Uma fatura por pagamento. Um reembolso dá uma nota de crédito.
Se os mesmos pagamentos já são faturados noutro programa, pelo Rioko ou por outro sistema, desligue essa faturação antes de ativar esta: o mesmo pagamento ficaria com duas faturas. No Rioko, uma conta Stripe só fatura numa integração de cada vez.
As imagens deste guia são de uma empresa de demonstração do TOConline e de uma conta de testes do Rioko, com os valores trocados por exemplos. Na sua conta vai ver os seus dados. Clique numa imagem para a ver em tamanho real.
- 1Abra Integrações.
- 2Em Plataforma de Pagamento / E-commerce, escolha a sua plataforma. Em Plataforma de Faturação, escolha TOConline.
- 3Carregue em Configurar Agora.
- 4O passo 1 liga a plataforma de pagamento. O botão Ver como se faz de cada passo e a Ajuda do Rioko mostram onde está cada dado.
Pedir os Dados API no TOConline
O TOConline dá o acesso à API empresa a empresa. Faz-se uma vez só.
- 1No TOConline, abra o menu Empresa e, na coluna Configurações, carregue em Dados API.
- 2Indique-se como integrador, com o seu nome e o seu email, e confirme. O TOConline pede o código da autenticação de dois fatores.
- 3O TOConline envia-lhe um email com um link válido durante 72 horas. Abra-o: a página Dados de acesso à API do TOConline mostra o Identificador, o Segredo, o Endereço de autenticação por OAuth e o Endereço de acesso à API.
Trate o Segredo como uma password: não o partilhe por email, chat ou capturas de ecrã.
Se o link expirar antes de o usar, peça-o outra vez em Reenviar detalhes de acesso à API.
Não carregue em Revogar acesso à API do TOConline: as integrações que usam estes dados, o Rioko incluída, deixam de funcionar.
Colar o endereço de redirect
Na página «Dados de acesso à API do TOConline», a que o link do email abriu. A API só está disponível com o módulo de Gestão Comercial da empresa ativo.
- 1No campo Endereço URI de redirect, substitua o que lá está por este endereço, igual carácter a carácter. É o mesmo para todas as contas, e o passo 2 do Rioko também o mostra, com um botão de copiar:https://rioko.online/api/integrations/toconline-oauth/callback
- 2Grave no ícone da disquete.
Geram um Segredo novo, e o anterior deixa de funcionar. Se isso acontecer, cole o Segredo novo no passo 2 do Rioko e carregue em Autorizar outra vez.
Autorizar o TOConline
De volta ao Rioko, no passo 2 do assistente.
- 1Copie os quatro valores da página do TOConline, com o botão de copiar de cada campo, para os campos com o mesmo nome no Rioko: Identificador, Segredo, Endereço de autenticação por OAuth e Endereço de acesso à API.
- 2Carregue em Autorizar o TOConline.
- 3O TOConline pede-lhe que confirme o acesso. Confirme: volta ao Rioko, com TOConline autorizado.
Depois de guardados, os valores não voltam a ser mostrados. Se o TOConline deixar de aceitar a ligação (por exemplo, depois de um Segredo novo), a integração fica a pedir atenção: abra o passo 2 e carregue em Autorizar outra vez.
Definições de fatura
Passo 3 do assistente.
- Tipo de documento
- Fatura-recibo por omissão no Stripe, na Easypay e na EuPago, porque o pagamento chega já recebido; Fatura por omissão no Shopify e no Lodgify. Na Easypay e na EuPago pode escolher Fatura + recibo automático: a fatura sai no pagamento e o recibo logo a seguir.
- IVA incluído
- Ligado, o valor pago já inclui o IVA.
- Auto Finalizar
- Desligado por omissão: o documento fica em rascunho no TOConline, para o confirmar e finalizar lá. Ligado, o documento é finalizado logo.
- Enviar a fatura ao comprador
- Ligado, o documento finalizado segue por email para o comprador. Um rascunho nunca é enviado.
- Razão de isenção
- Usada nas linhas com IVA a 0%. Sem ela, uma venda isenta não é faturada.
Deixe o "Auto Finalizar" desligado nos primeiros pagamentos, para confirmar no TOConline que está tudo certo, e ligue-o depois.
Ativar e testar
Confirme o primeiro documento antes de deixar a faturação seguir sozinha.
- 1Na mesma página, ative a subscrição da integração (mensal ou anual).
- 2No passo 4, carregue em Marcar como Ativo.
- 3Faça um pagamento de valor baixo na sua plataforma.
- 4No Dashboard, em Últimos documentos, aparece o pagamento e o estado do documento. Abra o documento no TOConline e confirme totais, IVA e cliente.
Um pagamento de teste da sua plataforma (por exemplo, no modo de testes do Stripe ou na sandbox da Easypay ou da EuPago) fica sempre em rascunho no TOConline. Apague-o lá depois de o ver.
Se deixou o "Auto Finalizar" desligado, ligue-o no passo 3. A partir daí, cada pagamento é faturado automaticamente.
Perguntas frequentes
Que licença do TOConline é precisa para ligar ao Rioko?
A API só está disponível com o módulo de Gestão Comercial da empresa ativo.
Onde peço os Dados API do TOConline?
Em Empresa, Configurações, Dados API. O TOConline envia-lhe um email com um link válido durante 72 horas.
O TOConline tem modo de testes?
Não. Um pagamento de teste da sua plataforma fica sempre em rascunho no TOConline. Apague-o lá depois de o ver.
O que acontece se gerar um Segredo novo?
O anterior deixa de funcionar. Cole o novo no passo 2 do Rioko e carregue em Autorizar outra vez.
Porque é que o Rioko não mostra a minha série?
O Rioko só lista séries comunicadas à AT. Veja Comunicar séries no TOConline.
Guias relacionados
Ligar o TOConline à AT
Criar o subutilizador e indicar as credenciais.
Ver o guia →Comunicar séries no TOConline
Criar e comunicar a série.
Ver o guia →InvoiceXpress
Requisitos e passos para ligar o InvoiceXpress ao Rioko.
Ver o guia →Moloni
Requisitos e passos para ligar o Moloni ao Rioko.
Ver o guia →Vendus
Requisitos e passos para ligar o Vendus ao Rioko.
Ver o guia →Precisa de ajuda?
Se preferir fazer a configuração connosco, marque uma chamada. Configuramos tudo consigo, em direto.
Marcar uma chamada ↗ calendly.com/pedro-kapta/rioko-support
by