Skip to main content

TOConline Integration

ilink allows you to import documents issued in the TOConline software using its official API. This guide explains how to configure both systems to enable document communication.

Prerequisites​

Before starting the configuration, please ensure that:

  • You have an active TOConline account with the Business Owner profile and the Commercial Management module enabled.
  • You have an active ilink account with integration management permissions.
  • Both companies (in TOConline and in ilink) are registered with the same Tax Identification Number (TIN).

TOConline Configuration​

1. Access the company​

After logging in to TOConline, you will need to obtain the API access credentials. To do so, access the company using a Business Owner account by navigating to Personal Area > My Companies, and select the desired company.

Company selection in TOConline

2. Access API details​

From the Company menu, go to Settings > API Details:

API settings menu in TOConline

3. Request credentials​

On the next page, enter the email address where you would like to receive the API access credentials.

You will receive an email containing a link to access the credentials.

Warning: The link is valid for 72 hours. If it expires, you will need to repeat this step.

Email with link to API credentials

4. Configure the redirect URI​

In the form received by email, enter the following URL in the Redirect URI Address field, replacing the original value, and then click the Save button, as highlighted in the image below:

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

Redirect URI configuration form

Tip: Use the "copy" buttons available in the TOConline form to avoid transcription errors.

After saving the changes in TOConline, log in to ilink and navigate to Integrations > Reception in the side menu:

Integrations page in ilink

Locate the TOConline integration on the integrations page and fill in the following fields using the details obtained in the previous step:

  • Identifier
  • Secret
  • API Access Address
  • OAuth Authentication Address

Note: Both entities (in TOConline and in ilink) must have the same Tax Identification Number (TIN) for the integration to be created successfully.

Document Import​

Once the integration has been activated, the TOConline option will become available in the Integrations menu. To import documents into the platform:

  1. Go to Integrations > TOConline.
  2. Select the documents you wish to import.
  3. Click Import.

List of documents available for import

Tip: Use the search filters — Document No., Document Type, and Recipient TIN — to quickly locate the desired documents.

Imported documents will be available under Issued > Pending to Send, where you can confirm the details or edit values before sending them electronically to the recipient.

Imported documents in the Pending to Send area

Note: If errors occur during the import process, you can review the integration logs under Integrations > Integration Logs to diagnose any potential issues.