Import shipments with CSV File via FTP/FTPS/URL

How to import shipments with CSV File via FTP/FTPS/URL

This procedure allows you to import your shipments into Qapla’ using a CSV file by configuring an FTP/FTPS/URL.

Create a CSV file

Create a Qapla’ following the instructions in the following guide: Shipment Import via CSV File.

FTP/FTPS Configuration

To configure automatic import go to:
Settings > [Channel Name] Configure > Import > Shipments > CSV Connector > Set the Connector
The configuration requires some mandatory fields (marked in red) and some optional ones.

  • URL
    Enter the URL using the following format:
    ftp://username:password@host:port/path/FileName[YYYYMMDD].csv
    Example: ftp://User123:Pass321@ftpExample.com:21/Qapla/FileQapla_[YYYYMMDD].csv
    URL components:

    • ftp:// or ftps://
    • username
    • password
    • host or IP address (can also include the port, e.g. ftpExample.com:21)
    • path and file name
    • date format: [YYYYMMDD] date of the import day
  • Transfer file at the end of the Task (FTP/FTPS only)
    Tick this option to move the file to another folder on your FTP server after Qapla’ has completed the import. The FTP server must allow read and write permissions.

    • Destination URL: specify the path of the folder where the file should be moved.
  • Schedule
    Set the time when the automatic CSV file import should be executed. You can configure up to twice a day.
    To add more schedules, contact customer care: support@qapla.it

Use of wildcard character * in the file name
You can use the asterisk * to import multiple files with the same prefix. Example:
ftp://username:password@ftpExample.com:21/Qapla/FileQapla[YYYYMMDD]*.csv

This imports all files starting with “FileQapla[YYYYMMDD]”, such as:
FileQapla20250717_1.csv
FileQapla20250717_2.csv
FileQapla20250717_3.csv

Direct URL configuration

You can also specify a direct URL to the CSV file if it is available on a publicly accessible server.

 

Once the configuration is completed, Qapla’ will automatically import the shipments at the scheduled time.

 

Need help?If you need assistance, contact Qapla’s Customer Care at support@qapla.it