The Role of Agreements in EDI Processing

An organization uses BizTalk Server to receive EDI messages from, and send EDI messages to, one or more trading partners. The trading partners, in turn define business profiles that are business entities within an organization. How business profiles exchange messages is defined as part of trading partner agreements between two business profiles. For more information, see Building Blocks of a Trading Partner Management Solution.

You create a trading partner agreement in the Trading Partner Management (TPM) user interface. The TPM screens are in the Parties node of the BizTalk Server Administration Console.

Configuring an Agreement for EDI Processing

All trading partners that will be exchanging EDI messages using BizTalk Server must agree upon communication parameters. After they have done this, the organization hosting BizTalk Server must create the trading partners in TPM (including a trading partner for itself), create the business profiles, and the trading partner agreement between the business profiles. As part of the trading partner agreement, you set the properties for how BizTalk Server receives an EDI message from, and send an EDI message to, the trading partner’s business profile. On their end, the other trading partners must do the same, and to exchange messages, the configurations must be compatible.

You must define the following sets of properties for EDI communications.

• Trading partner properties that define general aspects of the trading partner, such as name, send ports, and the signing certificate.

• Business profile properties that define the business identities.

• EDI properties, as part of the trading partner agreement, that defines how BizTalk Server will process an incoming message from a trading partner and how it will generate an outgoing message bound to the trading partner.

• AS2 properties, as part of the trading partner agreement, that defines how BizTalk Server will perform AS2 communications, both incoming and outgoing. These properties affect EDI communications only when an EDI message is sent over AS2.

  Note

  The AS2 agreement and the EDI messaging agreement between the same business profiles are specified separately. The two agreements together form a partnership.

  Trading partner agreement properties determine the following specific processing:

• EDI envelope processing and generation

• ACK processing and generation

• Validation of incoming and outgoing EDI messages

• Batch creation

• Status reporting

  For business identities, there can be specific values, such as D-U-N-S (Dun & Bradstreet). Specific names have specific qualifiers, such as "01" for Duns. When a business identity name is not specific, "ZZ" is used for X12-encoded messages and "ZZZ" is used for EDIFACT-encoded messages, indicating a name mutually defined by separate entities. The value and qualifier then identifies the business profile. The name of the business identity is for informational purposes only; it is not used by the BizTalk runtime for processing.

Determining an Agreement for EDI Processing

Any time BizTalk Server receives an EDI message, it attempts to determine the trading partner agreement that the message resolves to. It attempts to resolve the trading partner agreement by making a match between the message and the sender qualifier, sender identifier, receiver qualifier, and receiver identifier defined as part of the agreement. For more details on this process, see Agreement Resolution, Schema Discovery, and Authorization for Received EDI Messages.

Any time BizTalk Server generates an EDI message to send, it attempts to determine the agreement that associates with the business profile to which the message will be sent. It attempts to resolve the agreement by making a match between the message and the agreement using any of the following:

• Context property AgreementPartIdForSend

• Context properties AgreementNameForSend, SenderPartyNameForSend, and ReceiverPartyNameForSend

• Sender qualifiers and identifiers, and receiver qualifiers and identifiers

• Send port name

  For more details on this process, see Agreement Resolution and Schema Determination for Outgoing EDI Messages.

Using EDI Global Properties

If BizTalk Server cannot determine the agreement for either an incoming or outgoing message, it will use the fallback agreement to process the incoming interchange or generate the outgoing interchange. The fallback agreements are set by right-clicking the Parties node in the BizTalk Server Administration Console and clicking X12 Fallback Settings (for X12-encoded messages) or EDIFACT Fallback Settings (EDIFACT-encoded messages). For more information on global properties, see Configuring Global or Fallback Agreement Properties.

Fallback agreements will not be used if port settings require authentication. If the port settings for a receive port require authentication (if either Drop messages if authentication fails or Keep messages if authentication fails is selected on the General page of the Receive Port Properties dialog box), an agreement is required for any interchange received by the receive port. In this case, fallback agreements are not used. If no agreement is determined for an interchange, the interchange will be treated as though authentication had failed, and will be suspended.

See Also

Agreement Resolution, Schema Discovery, and Authorization for Received EDI Messages
Agreement Resolution and Schema Determination for Outgoing EDI Messages
Configuring EDI Properties
Configuring Global or Fallback Agreement Properties
Known Issues with EDI Parties