Jump to content
  • EN

TachoSync Integrations

From Teltonika Telematics Wiki
Revision as of 07:43, 25 November 2025 by Justas.Radveikis (talk | contribs) (upload frequency, retry logic, maximum retry duration, naming conventions for uploaded files, was added)

Main Page > Software & Applications > TachoSync > TachoSync Integrations

TachoSync provides integration mechanisms for automated data transfer to external systems. These integrations support both file-based delivery (e.g., SFTP) and event-based delivery (e.g., webhooks), enabling flexible and secure connectivity with fleet management platforms, IT systems, and other third-party services.

This page describes the available TachoSync integrations:

  • REST API - see this link for TachoSync API documentation portal
  • SFTP

Additional integration methods, such as webhooks, are in development.

Integrations Menu

TachoSync Integrations menu
TachoSync Integrations menu

In the TachoSync UI, the Integrations menu shows the configured integrations.

To add an integration, click “Add integration” in the top right corner of the window, enter the required details, and click “Save”.

The following data is presented in the table:

  • Name – name (label) given to the integration.
  • Method – integration method.
  • Company - company within TachoSync associated with this integration.
  • Status:
    • Active - integration is enabled, latest checks have been successful, data is transferred
    • Disabled - integration is disabled by the user
    • Interrupted - integration works but some recent operations have failed or have been delayed
    • Failed - repeated errors or integration unreachable
  • Enable – toggles the integration on/off.
  • Last event – timestamp of last changes in the integration.

SFTP

SFTP (Secure/SSH File Transfer Protocol) is a network protocol that provides secure file access, transfer, and management over a reliable data stream.

SFTP integration allows receiving files from TachoSync directly to your SFTP server. This option is ideal for organizations that want to automate the intake of data from TachoSync into an existing backend system.

Main features:

  • You can create as many SFTP connections as needed.
  • File transfer to your SFTP server starts as soon as the file is received from device to TachoSync.

NOTE! TachoSync does not create or configure the SFTP server. The customer is responsible for ensuring that the server is reachable from the internet and properly secured.

Prerequisites (prepare this before configuring the SFTP integration):

  • Set up your SFTP server and know:
    • SFTP server host (domain or IP address)
    • SFTP server port number
    • Username and password for SFTP authentication
  • Make sure that your SFTP server firewall rules allow inbound SFTP connections from TachoSync (IP address 3.126.35.133).
  • Optional: a dedicated folder path to place the downloaded files

SFTP Server Settings

TachoSync Integrations settings
TachoSync SFTP integration settings

This section allows configuring the connection to your SFTP server. Settings marked by an asterisk (*) are mandatory.

  • Host*: The hostname or IP address of the SFTP server.
  • Port*: The port number on the SFTP server (typically 22).
  • Remote directory path (optional): The specific folder on the SFTP server where files will be uploaded. If left blank, files will be placed in the root directory of the configured server user.
  • Username*: The username for authenticating with the SFTP server.
  • Password*: The password for the specified username.

General Settings

This section defines how the files and folders are structured and named when sent to the SFTP server. Settings marked by an asterisk (*) are mandatory.

  • Company*: The company within TachoSync, associated with this integration.
  • SFTP name*: A label for this specific SFTP configuration (e.g., "Primary Server" or "Backup Archive").
  • File format*: The desired format for tachograph files.
    • .DDD
    • .TGD
    • .V1B, .C1B
  • Vehicles folder naming*: The naming convention for the folders that contain vehicle data.
    • IMEI (E.g., 999999999999999)
    • Vehicle number (E.g., LLL 999)
  • Drivers folder naming*: This field is set to "Driver ID", meaning folders for driver data will be named using the driver's unique identification number.
  • Include files from all sub-companies: When enabled, in addition to the main company data, data from sub-companies will be gathered and uploaded as well.
  • Include historical files: When enabled, TachoSync will attempt to upload files captured before the integration was created.

Example SFTP Server Folder Structure

Below is an example of how files may be organized on your SFTP server:

  • /root-folder/
    • /vehicles/
      • /ABC123/ ← vehicle folder (set the naming convention in „General Settings“)
        • 2025-01-12.DDD
        • 2025-01-13.DDD
    • /drivers/
      • /1234567890/ ← driver folder (set the naming convention in „General Settings“)
        • 2025-01-12_.DDD

SFTP Integration Troubleshooting

If the SFTP integration does not work as expected, verify the following:

  • The server is reachable from the Internet.
  • Firewall rules allow inbound SFTP connections from TachoSync.
  • The user has write permissions for the configured directory.
  • The provided path exists on the server.

If issues persist, collect the “Last Event” details from the Integrations page and contact Support.

Upload Frequency

TachoSync sends files to your SFTP server as soon as they become available.

  • When a new tachograph file is downloaded from the vehicle or driver card, it is immediately added to the SFTP sync queue.
  • Sync happens continuously, not on a fixed schedule.
  • If you enable “Include historical files,” TachoSync also adds your previously downloaded files to the queue and syncs them in batches based on current system load.

What this means for you:

There is no need to manually trigger a daily or hourly sync. Files are pushed automatically as soon as they are downloaded or discovered.

Retry Logic

If TachoSync cannot deliver a file to your SFTP server, it will attempt to retry depending on the type of error.

We do NOT retry when the issue is permanent:

  • Incorrect username or password
  • Insufficient permissions on the SFTP destination (cannot create directories or upload files)
  • Invalid upload path

These issues require you to fix the configuration and then retry manually (using the “Retry failed files” feature (soon to be added).

We DO retry when the issue may be temporary:

Examples of temporary problems:

  • The SFTP server is unreachable
  • Connection timeouts
  • Network interruptions

Retry pattern

TachoSync uses an exponential backoff strategy for temporary errors, with up to 5 retry attempts:

  1. After 3 seconds
  1. After 9 seconds
  1. After 27 seconds
  1. After 1 minute 21 seconds
  1. Final attempt (~4 minutes after the initial failure)

If all retry attempts fail, the file is marked as failed, and no further automatic attempts are made.

Maximum Retry Duration

The entire retry cycle lasts approximately 4–5 minutes from the first failed attempt.

After that:

  • The file is not retried automatically
  • It will remain marked as failed until you fix the underlying issue and manually trigger the sync again

This prevents infinite retry loops and reduces unnecessary load on both systems.

Naming Conventions for Uploaded Files

TachoSync does not rename your files.

The filename that appears in your SFTP server is exactly the same as the file stored in TachoSync.

The only exception is the file extension, which depends on the format you selected when configuring the integration:

  • .DDD
  • .TGD
  • .V1B or .C1B

Folder structure is based on your integration settings (company hierarchy, vehicle folder naming, driver folder naming).

Example path:

/North Division/North Logistics/356710123456789/2024-09-10_123456.DDD

Retrieved from "https://wiki.teltonika-gps.com/index.php?title=TachoSync_Integrations&oldid=109198"