Create and manage trading partner agreements by using Azure Logic Apps and Enterprise Integration Pack

A trading partner agreement helps organizations and businesses communicate seamlessly with each other by defining the specific industry-standard protocol to use when exchanging business-to-business (B2B) messages. Agreements provide common benefits, for example:

  • Enable organizations to exchange information by using a well-known format.
  • Improve efficiency when conducting B2B transactions.
  • Are easy to create, manage, and use for building enterprise integration solutions.

This article shows how to create an AS2, EDIFACT, or X12 agreement that you can use when building enterprise integration solutions for B2B scenarios by using the Enterprise Integration Pack and Azure Logic Apps. After you create an agreement, you can then use the AS2, EDIFACT, or X12 connectors for exchanging B2B messages.

Prerequisites

  • An Azure subscription. If you don't have an Azure subscription yet, sign up for a free Azure account.

  • An integration account for storing your agreement and other B2B artifacts. This integration account must be associated with your Azure subscription.

  • At least two trading partners that you've already created in your integration account. An agreement requires both a host partner and a guest partner. Both partners must use the same "business identity" qualifier as the agreement you want to create, such as AS2, X12, or EDIFACT.

  • Optional: The logic app where you want to use your agreement and a trigger that starts your logic app's workflow. To just create your integration account and B2B artifacts, you don't need a logic app. However, before your logic app can use the B2B artifacts in your integration account, you must link your integration account to your logic app. If you're new to logic apps, review What is Azure Logic Apps and Quickstart: Create your first logic app.

Create agreements

  1. Sign in to the Azure portal. On the main Azure menu, select All services. In the search box, enter "integration" as your filter. From the results, select this resource: Integration accounts

    Find your integration account

  2. Under Integration accounts, select the integration account where you want to create the agreement.

    Select the integration account where to create the agreement

  3. In the right-hand pane, under Components, choose the Agreements tile.

    Choose "Agreements"

  4. Under Agreements, choose Add. In the Add pane, provide information about your agreement, for example:

    Choose "Add"

    Property Required Value Description
    Name Yes <agreement-name> The name for your agreement
    Agreement type Yes AS2, X12, or EDIFACT The protocol type for your agreement. When you create your agreement file, the content in that file must match the agreement type.
    Host Partner Yes <host-partner-name> The host partner represents the organization that specifies the agreement
    Host Identity Yes <host-partner-identifier> The host partner's identifier
    Guest Partner Yes <guest-partner-name> The guest partner represents the organization that's doing business with the host partner
    Guest Identity Yes <guest-partner-identifier> The guest partner's identifier
    Receive Settings Varies Varies These properties specify how to handle all incoming messages received by the agreement. For more information, see the respective agreement type:

    - AS2 message settings
    - EDIFACT message settings
    - X12 message settings

    Send Settings Varies Varies These properties specify how to handle all outgoing messages sent by the agreement. For more information, see the respective agreement type:

    - AS2 message settings
    - EDIFACT message settings
    - X12 message settings

  5. When you're done creating your agreement, on the Add page, choose OK, and return to your integration account.

    The Agreements list now shows your new agreement.

Edit agreements

  1. In the Azure portal, on the main Azure menu, select All services.

  2. In the search box, enter "integration" as your filter. From the results, select this resource: Integration accounts

  3. Under Integration accounts, select the integration account that has the agreement you want to edit.

  4. In the right-hand pane, under Components, choose the Agreements tile.

  5. Under Agreements, select your agreement, and choose Edit.

  6. Make and then save your changes.

Delete agreements

  1. In the Azure portal, on the main Azure menu, select All services.

  2. In the search box, enter "integration" as your filter. From the results, select this resource: Integration accounts

  3. Under Integration accounts, select the integration account that has the agreement you want to delete.

  4. In the right-hand pane, under Components, choose the Agreements tile.

  5. Under Agreements, select your agreement, and choose Delete.

  6. Confirm that you want to delete the selected agreement.

Next steps