Skip to Content

Add a trading partner in Jitterbit EDI

Introduction

Before you can interact with a trading partner in EDI, you must set up their details on the Admin page. To open it, use the Harmony portal menu to select EDI > Admin:

Admin page

Important

Access to the EDI Admin page is restricted to users whose roles include the Admin permission. Other EDI pages are accessible to all users.

The page has two panes, the trading partners pane (left), and the partner administration pane (center-right).

The trading partners pane contains the following controls:

  • View mode: How to view added partners. Select Grid View to view partners as icons on a grid, or List View to view them as icons in a list:

    View mode

  • Search: Enter a search string to view matching partners.

  • Add Trading Partner: Add a trading partner.

    Search add

The lower part of the pane lists added partners. Select one to edit or view the administration settings in the main pane. (A selected partner icon has a solid border.)

When you select a partner in the trading partners pane, the partner administration pane contains the settings for a partner's workflows, EDI settings, and communication settings. Otherwise, this pane contains the Add Trading Partner button, which has the same function as the Add Trading Partner button.

Add trading partners

To add trading partners, follow these steps:

  1. Select a Harmony environment from the Environments menu:

    Environments menu

  2. Click in the trading partners pane, or Add Trading Partner in the partner administration pane. The Add a Trading Partner pane opens:

    Add trading partner

  3. Use the search bar to find partners by name, or the page navigation buttons to browse available partners. To select one, double-click its icon. If you can't find the partner you want to add, you must create one.

    Note

    The first time you add a partner to an environment, the ISA ID Generation dialog opens, where you must create your first ISA ID.

  4. The partner icon appears in the Trading Partners pane. You can add more than one partner.

  5. To close the Add a Trading Partner pane, click the Close button.

  6. Select a trading partner in the Trading Partners pane to open the partner's administration tabs. Use them to set up the partner's workflows, EDI settings, and communication settings:

    Added trading partner

Create a new trading partner

If you want to add a partner that doesn't exist in the list, you must create it. To do this, follow the steps below.

Note

Access to this feature is available upon request. To gain access to this feature, contact your Customer Success Manager (CSM).

  1. Click Create New Trading Partner, or the Create button adjacent to Add your own Trading partner. The Create New Trading Partner dialog opens:

    Create a new trading partner

  2. Set values for the following fields:

    • Trading Partner Name: The partner's name.

    • EDI Standard: The EDI communications standard to use with this partner. Choose from EDIFACT, TRADACOMS, or X12.

    • Qualifier: Open the menu and select a qualifier code. (Not available when the EDI standard is TRADACOMS.)

    • ISA ID: The partner's unique ISA ID.

  3. (Optional) To add an image to represent the partner in the trading partners list, click Upload Image, then select a JPG, PNG, or SVG image file.

  4. Check your values carefully, as they can not changed once saved. When you are sure, click Save.

  5. The system creates the new partner within the currently selected environment, and adds it to your list of partners.

Tip

The partner can be used only in the environment it was created in. If you need it in a different environment, you must change environment and create it again.

Edit a trading partner's settings

To edit a trading partner's settings, follow these steps:

  1. Select the partner's icon in the Trading Partners pane. If there are many partners, use the search bar to find the one you want.

  2. Edit the partner's workflows, EDI settings, or communication settings.

  3. Click Save.

Delete a trading partner

To delete a trading partner, follow these steps:

  1. Hover on a partner icon.

  2. Click Delete. A dialog opens asking you to confirm the action:

    Partner delete

  3. Enter the word DELETE where indicated, then click the Delete button.

    Caution

    This action permanently deletes the partner, its settings, and workflows. (Saved connections are preserved.)