Skip to main content

Destinations

4 minute read

Where a flow sends its file: email, a web address, an SFTP or FTPS server, an S3 bucket, Google Drive, Google Sheets, or a download.

A destination is a place a file goes. You set one up once and any file in your workspace can use it. Only a workspace admin can create one. You create a destination while you set up a file: press Change beside Send to, then choose New destination…. See Send files to a destination.

The kinds

  • Download only. Nothing is sent. The file is kept for you to download from the document. It shows as Ready to download.
  • Email. The file goes as an attachment to the addresses you list. You can add a reply-to address. The email comes from ProcuLink's sender address. It uses the Subject and Message you enter. Left blank, ProcuLink uses a default subject (the flow name and the file name) and a short message. A test send puts [TEST] in front of the subject. The attachment is named after the document.
  • Google Drive. The file goes to a folder you choose.
  • Google Sheets. Each send adds the rows of a CSV file to the end of a sheet.

The kinds below are grouped under A server or another system:

  • SFTP. We upload the file to a folder on your server. You sign in with a password or a private key.
  • FTPS. The same, over FTP with explicit TLS.
  • S3 bucket. We put the file in a folder of your bucket, on Amazon S3 or a service that works like it.
  • Web address (API). We send the file to your URL with a POST or a PUT request. The file is the body of the request, with its own content type.

A destination needs a name, and the details for its kind. Passwords, keys and tokens are kept encrypted. See Destination sign-in, keys and signing.

The file name

Every file is named after the original document, then a dash and a short code, then the format's ending. The code makes each send a different file. For example, an invoice called march.pdf becomes something like march-3f9a1c2e.csv.

What "sent" means

A delivery counts as Delivered when the destination accepted it:

  • Web address. The server answered with a success status (2xx). We do not read the answer, so a server that says yes and then refuses the file in its own system looks delivered to us.
  • SFTP and FTPS. The upload finished. We write the file under a temporary name and rename it when it is whole, so your system never sees half a file.
  • Email. Our email service accepted the message. We cannot see whether anyone opened it.

A document is Sent when every one of its files is delivered or ready to download. See Documents and statuses.

If a send fails

We try again, up to three attempts in all. The second attempt comes about 30 minutes after the first, and the third about an hour after the second, each up to a fifth later. If the destination asks us to wait longer, we wait at least that long.

While we wait, the delivery shows Will retry and the reason it failed. After the third failure it shows Couldn't deliver and the document shows Couldn't send. Fix the problem, then press Send and open next on the document again. Files already delivered are not sent twice.

Some failures are not tried again: the destination was deleted, its saved password cannot be read, or an earlier attempt may already have arrived. Check with the recipient before you send again in that last case.

Test a destination

When you set up a new flow, Save and send a test saves the destination and sends a small file marked TEST_ that holds no document data. An email subject starts with [TEST], and a web request carries an X-ProcuLink-Test header. A Google Sheets test adds no rows: it checks that we can open the spreadsheet and the tab you chose.

A file built from documentation needs a passing test before it can be created. That test sends the file made from a real document in the flow, so it holds that document's values.

You can also test a destination at any time under Settings, then Destinations. Save and send a test saves your changes and tests them in one go. When documents stopped because the destination failed, a passing test offers Send it now to send them again. See Send files to a destination.

Rules we apply

  • A web address must start with https://. Plain http:// is accepted only for a server on your own computer.
  • We do not follow redirects. A redirect counts as a failure, and the message says so.
  • Addresses on a private network are refused.