Pular para o conteúdo principal

Integração TOConline

O ilink permite importar documentos emitidos no software TOConline, recorrendo à sua API oficial. Este guia demonstra como configurar ambos os programas para permitir a comunicação de documentos.

Pré-requisitos​

Antes de iniciar a configuração, certifique-se de que:

  • Possui uma conta ativa no TOConline com perfil de Empresário e o módulo de Gestão Comercial ativo.
  • Possui uma conta ativa no ilink com permissões de gestão de integrações.
  • Ambas as empresas (no TOConline e no ilink) estão registadas com o mesmo NIF.

Configuração do TOConline​

1. Aceder à empresa​

Após efetuar login no TOConline, é necessário obter as credenciais de acesso à API. Para tal, entre na empresa com uma conta de Empresário, acedendo a Área Pessoal > As minhas empresas, e selecione a empresa pretendida.

Seleção de empresa no TOConline

2. Aceder aos dados da API​

No menu Empresa, aceda a Configurações > Dados API:

Menu de configurações da API no TOConline

3. Solicitar credenciais​

Na página seguinte, introduza o endereço de email onde pretende receber as credenciais de acesso à API.

Deverá receber um email com um link para as credenciais.

Atenção: O link recebido tem uma validade de 72 horas. Caso expire, será necessário repetir este passo.

Email com link para credenciais da API

4. Configurar o URI de redirect​

No formulário recebido por email, insira o seguinte URL no campo Endereço URI de redirect, substituindo o valor original, e depois clique no botão Guardar, assinalado na imagem abaixo:

https://ilink.pt/ilink-api/public/toconline/callback

Formulário de configuração do URI de redirect

Dica: Utilize os botões de "copiar" disponíveis no formulário do TOConline para evitar erros na transcrição dos campos.

Após guardar as alterações no TOConline, entre no ilink e aceda a Integrações > Receção no menu lateral:

Página de integrações no ilink

Localize a integração TOConline na página de integrações e preencha os seguintes campos com os dados obtidos no passo anterior:

  • Identificador
  • Segredo
  • Endereço de acesso à API
  • Endereço de autenticação OAuth

Nota: Ambas as entidades (no TOConline e no ilink) têm de possuir o mesmo NIF para que a integração seja criada corretamente.

Importação de documentos​

Após ativar a integração, a opção TOConline ficará disponível no menu Integrações. Para importar documentos para a plataforma:

  1. Aceda a Integrações > TOConline.
  2. Selecione os documentos que pretende importar.
  3. Clique em Importar.

Lista de documentos disponíveis para importação

Dica: Utilize os filtros de pesquisa — N.º de documento, Tipo de documento e NIF do recetor — para localizar rapidamente os documentos pretendidos.

Os documentos importados ficam disponíveis em Emitidos > Por Enviar, onde é possível confirmar os dados ou editar valores antes do envio ao destinatário por via eletrónica.

Documentos importados na área Por Enviar

Nota: Caso ocorram erros durante a importação, é possível consultar os registos de integração em Integrações > Registos de Integração para diagnosticar eventuais problemas.