Add trading partners to integration accounts for workflows in Azure Logic Apps

To represent your organization and others in business-to-business (B2B) enterprise integration workflows, create a trading partner in your integration account to represent each participant in a business relationship. Partners are business entities that participate in B2B transactions and exchange messages with each other.

Important

Before your define these partners, have a conversation with your partners about how to identify and validate the messages that you send each other. To participate in an agreement and exchange messages with each other, partners in your integration account have to use the same or compatible business qualifiers. After you agree on these details, you're ready to create partners in your integration account.

This article shows how to create and manage partners, which you can later use to create agreements that define the specific industry-standard protocol for exchanging messages between partners.

If you're new to logic apps, review What is Azure Logic Apps? For more information about B2B enterprise integration, review B2B enterprise integration workflows with Azure Logic Apps.

Prerequisites

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

  • An integration account resource where you define and store artifacts, such as trading partners, agreements, certificates, and so on, for use in your enterprise integration and B2B workflows. This resource has to meet the following requirements:

    • Is associated with the same Azure subscription as your logic app resource.

    • Exists in the same location or Azure region as your logic app resource.

    • If you're using the Logic App (Consumption) resource type, your integration account requires a link to your logic app resource before you can use artifacts in your workflow.

    • If you're using the Logic App (Standard) resource type, your integration account doesn't need a link to your logic app resource but is still required to store other artifacts, such as partners, agreements, and certificates, along with using the AS2, X12, and EDIFACT operations. Your integration account still has to meet other requirements, such as using the same Azure subscription and existing in the same location as your logic app resource.

    Note

    Currently, only the Logic App (Consumption) resource type supports RosettaNet operations. The Logic App (Standard) resource type doesn't include RosettaNet operations.

Add a partner

  1. In the Azure portal search box, enter integration accounts, and select Integration accounts.

  2. Under Integration accounts, select the integration account where you want to add your partners.

  3. On the integration account menu, under Settings, select Partners.

  4. On the Partners pane, select Add.

  5. On the Add Partner pane, provide the following information about the partner:

    Property Required Description
    Name Yes The partner's name
    Qualifier Yes The authenticating body that provides unique business identities to organizations, for example, D-U-N-S (Dun & Bradstreet).

    Partners can opt for a mutually defined business identity. For these scenarios, select Mutually Defined for EDIFACT or Mutually Defined (X12) for X12.

    For RosettaNet, select only DUNS, which is the standard.

    Important: For partners in your integration account to participate in an agreement and exchange messages with each other, they have to use the same or compatible qualifier.

    Value Yes A value that identifies the documents that your logic apps receive.

    For partners that use RosettaNet, this value must be a nine-digit number that corresponds to the DUNS number. You can provide more information for RosettaNet partners, such as their classification and contact information, by creating the partners first and then editing their definitions afterwards.

  6. When you're done, select OK.

    Your partner now appears on the Partners list.

Edit a partner

  1. In the Azure portal, open your integration account.

  2. On the integration account menu, under Settings, select Partners.

  3. On the Partners pane, select the partner, select Edit, and make your changes.

    For partners that use RosettaNet, under RosettaNet Partner Properties, you can provide more information as described in the following table:

    Property Required Description
    Partner Classification No The partner's organization type
    Supply chain code No The partner's supply chain code, for example, "Information Technology" or "Electronic Components"
    Contact Name No The partner's contact name
    Email No The partner's email address
    Fax No The partner's fax number
    Telephone No The partner's phone number
  4. When you're done, select OK.

Delete a partner

  1. In the Azure portal, open your integration account.

  2. On the integration account menu, under Settings, select Partners.

  3. On the Partners pane, select the partner to delete, and then select Delete.

  4. To confirm that you want to delete the partner, select Yes.

Next steps