Tediware
Sign In

Connections

Connections define how Tediware communicates with your trading partners. Each connection specifies a protocol (SFTP, AS2, or API) and the credentials or configuration needed to exchange files. A single connection can serve one partner directly, or be shared across multiple partners using VAN routing.

Connection Types

SFTP

SFTP connections use SSH-based file transfer. You provide a host, port, username, and either a password or SSH key. Tediware connects to the remote server to upload or download files as part of your flow processing.

If your trading partner firewalls their SFTP server, they will need to whitelist Tediware’s outgoing IP addresses: 16.54.110.1 and 99.79.30.151.

AS2

AS2 (Applicability Statement 2) is a secure, HTTP-based protocol designed for EDI document exchange. AS2 connections use digital certificates for encryption and signing, providing non-repudiation via MDN (Message Disposition Notification) receipts.

API

API connections allow Tediware to send processed data to HTTP endpoints via webhooks or REST calls.

VAN Routing

A Value Added Network (VAN) is a third-party service that acts as a central hub for EDI file exchange. Instead of maintaining a separate connection to each trading partner, you connect to the VAN, and the VAN routes files between you and your partners.

When you enable VAN Routing on a connection, Tediware automatically routes each inbound file to the correct partner by inspecting the ISA header in the EDI document. Specifically, it matches the sender and receiver identifiers (and their qualifiers) against the envelopes configured on your partners. This means multiple partners can share the same connection – Tediware determines which partner each file belongs to based on the EDI content itself.

To use VAN routing:

  1. Create a single connection pointing to your VAN
  2. Enable the VAN Routing checkbox on the connection
  3. Assign that connection to each partner that communicates through the VAN
  4. Ensure each partner has its Internal Envelope and External Envelope configured with the correct ISA identifiers and qualifiers

When a file arrives, Tediware reads the ISA header and matches it against partner envelopes. If a match is found, the file is processed through that partner’s inbound flow. If no match is found – for example, because the sender ID does not correspond to any configured partner – the file is logged as a routing error and skipped.

VAN routing is available on SFTP, AS2, and Sandbox connections.

Creating a Connection

  1. Navigate to Partners and select a partner, or go to Connections directly
  2. Click New Connection
  3. Select the connection type (SFTP, AS2, or API)
  4. Fill in the required fields for your chosen type
  5. Optionally enable VAN Routing if this connection is shared across multiple partners
  6. Save the connection

AS2 Connections

AS2 connections require additional setup beyond basic connection details.

Certificates

AS2 uses four certificates organized into two pairs:

  • Local signing certificate – used by Tediware to sign outbound messages
  • Local encryption certificate – used by trading partners to encrypt messages they send to you
  • Partner signing certificate – used to verify signatures on messages received from the partner
  • Partner encryption certificate – used by Tediware to encrypt outbound messages to the partner

All four certificate slots must be assigned before you can activate an AS2 connection. Upload certificates from the connection detail page using the Certificates tab.

AS2 Identifiers

Each party in an AS2 exchange has a unique AS2 ID. You will set:

  • Your AS2 ID – identifies Tediware in the exchange (often your company name or a code agreed with the partner)
  • Partner AS2 ID – identifies the trading partner

These identifiers must match exactly what each party expects.

Activation

Once certificates and identifiers are configured:

  1. Click Activate on the connection detail page
  2. Tediware provisions the necessary infrastructure (this takes a few seconds)
  3. The status changes from Inactive to Active

While active, certain fields are locked and cannot be modified (AS2 IDs, partner URL, encryption/signing algorithms). To change these, duplicate the connection, configure the copy, then activate it as a replacement.

Replacing an Active Connection

If you need to update locked fields on an active AS2 connection:

  1. Duplicate the existing connection
  2. Modify the settings on the new copy
  3. Activate the new connection – you will be prompted to replace the old one
  4. Tediware automatically migrates flow references from the old connection to the new one

Deactivation

Click Deactivate to tear down the AS2 infrastructure for a connection. This returns it to an inactive state where all fields can be edited again.

Troubleshooting AS2

  • Activation fails – Ensure all four certificate slots are filled and your organization has the AS2 add-on enabled
  • Messages not arriving – Verify that the partner is sending to the correct AS2 URL and using the correct AS2 IDs
  • Signature or encryption errors – Confirm that the partner’s certificates match what you have uploaded, and vice versa

Using Connections in Flows

Connections are referenced by Input and Output nodes in your flows:

  • Input nodes monitor a connection for incoming files and feed them into the flow
  • Output nodes send processed results to a connection

A single connection can be used by multiple flows simultaneously. When VAN routing is enabled, a single inbound fetch can dispatch files to different partner flows based on their ISA identifiers.

Testing a Connection

From the connection detail page, click Test to verify connectivity. For SFTP, this attempts to connect and list the remote directory. For AS2, this sends a test message and waits for an MDN receipt.

Troubleshooting VAN Routing

  • Files are skipped with a routing error – The ISA sender or receiver identifiers in the file do not match any partner’s envelope configuration on this connection. Verify that the partner’s external envelope has the correct interchange ID and qualifier.
  • Files route to the wrong partner – Two partners may have overlapping envelope identifiers. Each partner on a VAN connection must have a unique combination of sender ID, sender qualifier, receiver ID, and receiver qualifier.
  • Non-EDI files are skipped – VAN routing requires valid EDI files with an ISA header. Files that do not begin with “ISA” are logged as warnings and skipped.