Communication settings in Jitterbit EDI

Introduction

Documents are exchanged with partners via the FTP or AS2 connection protocols. These connections are configured on the EDI Admin page, in the Communication settings tab:

There are no FTP or AS2 connections provided by default.

Connections are available to all partners and remain even when partners are deleted.

The Jitterbit VAN service is a managed connection. To use it, contact Jitterbit support or your Customer Success Manager (CSM) to have it set up. When configured, you can assign it to a partner.

Create an FTP connection

To create an FTP connection, follow these steps:

1. Click the Create button, then select FTP connection. The Create a new FTP connection panel appears:

   

2. In the top panel, set values for the following fields:

   

   • Name: A name for the connection.
   • Login: The username for the FTP server.
   • Password: (Optional.) The password for the FTP server. Leave blank if no password has been set.
   • Address: The IP address or host name of the FTP server.
   • Port: The port number as a positive integer. (Your firewall must allow traffic on the port.)
   • Protocol: FTP or SFTP.
   • Security: The security type, one of Explicit, Implicit, or None.
   • Mode: The FTP mode, Active or Passive.

3. (Optional) Click the button to expand the Additional Options panel, then set values for the following fields:

   

   • SSL settings: Additional SSL settings.
   • Retrieval mask: A filename mask.
   • Send private key: Enable to authenticate a client when it connects to an SFTP server.
   • Download active: Enable to use active FTP mode. Turn off to use passive FTP mode.
   • Delete file after download: Enable to delete the file from the FTP server after it has been downloaded.

4. Expand the Remote Details tab, then set values for the following fields:

   

   • Remote download folder: The folder on the remote server where files are downloaded from.
   • Remote upload folder: The folder on the remote server where files are uploaded to.
   • Remote upload file name: The filename for uploaded files. Use the filename format <Document Type>_<Document ID>.
   • Remote upload file extension: The filename extension for uploaded files, either .edi or .xml.
   • Remote download file name start index: The remote download filename start index. 001 is recommended.
   • Remote download file name end index: The remote download filename end index. 999 is recommended.

5. To test the connection, click the Test connection button. This button becomes active when all required fields are filled. (It does not apply to SFTP connections.)

6. To activate the connection, click the Active switch. This reveals the Automation tab, to set how often and when to run an FTP connection. To use it, set values for the following fields:

   

   • Frequency: How often to run the FTP service. Select one of 15 minutes, 1 Hour, 12 Hours, Daily, or Weekly.
   • Next run: When to next run the service. Select any of the date-time fields and enter a numeric value, or click the calendar icon to pick a date and time.

7. Click the Save button. The new connection is automatically assigned to the partner.

Create an AS2 connection

To create an AS2 connection, follow these steps:

1. Click the Create button, then select AS2 connection. The Create a new AS2 connection panel appears:

   

2. In the top tab, set values for the following fields:

   

   • Active: Enable the connection.
   • Name: The connection name.
   • Sending URL: The URL provided by the trading partner for sending documents through the AS2 connection. The Sending URL is used in conjunction with the Receiving URL that you provide your trading partner so they can send data to Jitterbit's AS2 connection. The receiving URL is different for each Harmony region:
     • North America: na.as2.jitterbitedi.com/receiver.aspx
     • EMEA: emea.as2.jitterbitedi.com/receiver.aspx
     • APAC: apac.as2.jitterbitedi.com/receiver.aspx
   • Connection Timeout: The initial connection timeout.
   • AS2 Company ID: The AS2 company identifier.
   • AS2 Partner ID: The AS2 partner identifier.
   • Test Mode: Enable to test the connection.

3. (Optional) Expand the Proxy settings tab, then set values for the following fields:

   

   • Proxy: Enable the proxy server.
   • Address: The proxy server address.
   • Domain: The proxy server domain.
   • Username: The proxy server username.
   • Password: The proxy server password.

4. (Optional) Expand the HTTP settings tab, then set values for the following fields:

   

   • Authentication: Enable HTTP authentication.
   • Authentication Type: The HTTP authentication type. Select one of the following:
     • Basic: Use non-encrypted base64-encoded credentials (RFC 2617).
     • Digest: Use encrypted base64-encoded credentials (RFC 2617).
   • Authentication user: The username for HTTP authentication.
   • Authentication password: The password for HTTP authentication.
   • Subject: The subject describing the purpose of the endpoint.

5. (Optional) Expand the Encryption settings tab, then set values for the following fields:

   

   • Signature algorithm: The signature algorithm.
   • Encryption algorithm: The encryption algorithm.
   • Sign: Enable to reject unsigned incoming messages.
   • Encrypt: Enable to reject unencrypted incoming messages.
   • Request MDN: Request an MDN (message disposition notification).
   • Request MDN signed: Request a signed MDN.
   • Compress: Enable to use ZLIB compression.

6. (Optional) Expand the Certificate tab:

   

   The tab has two regions:

   • My certificates: Certificates for your organization. These are private certificates, which must be in pfx format, and contain only private keys.
   • Partner certificates: Certificates for the trading partner. These are public certificates, which must be in .cer format, and contain only public keys.

   Uploaded or created certificates appear as a row, showing the name, expiry date, and the following icons:

   • Assign: Assign the certificate to the connection.
   • Download: Download the certificate as a .cer file.

   • Delete: Delete the certificate.

     Certificates are deleted without confirmation.

   To upload a certificate, follow these steps:

   1. Click the Upload icon for either party.

   2. In the panel that opens, enter values for Certificate name and Password:

      

   3. Click the Upload file button, then select the certificate file. (Accepted file types are .cer and .pfx.)

   4. Click the Save button.

   To create a certificate for your organization, follow these steps:

   1. Click the Create icon.

   2. In the panel that opens, enter values for Certificate name and Validity years

      

   3. Click the Save button.

Manage connections

Assign

To assign a connection, select a partner in the trading partners pane, then click Assign.

The word Assigned and a check mark appear in green on the connection to show it is now assigned to the currently selected partner.

Edit

To edit a connection, click a connection's Edit icon.

Edit the connection's details, then click Save.

Delete

To delete a connection, click the Delete icon. To confirm the action, enter the word DELETE in the dialog's text field, then click the Delete button.