---
schema_version: "1"
id: 26e3baada0311f9a292cc95d27d0ae338a2274fde2067a9262292f72ea2ac3e2
title: Configuring Receive Settings for Inbound X12 Messages
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/partner-manager/latest/x12-receive-read-settings.md
canonical_url: https://docs.mulesoft.com/partner-manager/latest/x12-receive-read-settings
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 854aa95eabea632b9b223a219501ea462fa09e9fe8d430f202ee13821131c42d
description: MuleSoft Documentation Site
release: 2.x
latest: true
---
---
product: Partner Manager
version: 2.x
is-latest-version: true
---

# Configuring Receive Settings for Inbound X12 Messages

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Partner Manager enables you to configure the X12 acknowledegments, validation rules, character
encoding, and control numbers to apply when receiving inbound X12 messages from the selected
partner.

To configure X12 receive settings:

1.  In the sidebar, select **Partners**.

2.  Select the partner to associate with the settings.

3.  In the **Validation and acknowledgement settings** section’s **Receive from <partner-name>**
    column, click **X12**.

4.  Select a link to configure:

    - [Acknowledgment settings](#ack-settings)

    - [Validation settings](#validation-settings)

    - [Control numbers](#control-numbers)

    - [Character set and separators](#character-set)

5.  Click **Save**.

> [!NOTE] It can take up to about five minutes for your configuration changes to sync with Mule.

## Acknowledgment Settings

Use the following settings to configure the acknowledgments to send in response to inbound X12
messages:

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Setting</th><th>Description</th><th>Default</th></tr></thead><tbody><tr><td><p>Report non-fatal errors in acknowledgements</p></td><td><p>When checked, the AK3 segment of the generated 997 functional acknowledgment reports non-fatal errors.</p><p>When unchecked, the AK3 segment of the generated 997 functional acknowledgment doesn’t report non-fatal errors.</p></td><td><p>Enabled</p></td></tr><tr><td><p>Report segment details</p></td><td><p>If selected, the details of segment errors are included in the functional acknowledgements generated (997).</p></td><td><p>Enabled</p></td></tr><tr><td><p>Send TA1 for each transmission from &lt;recipient&gt;.</p></td><td><div><div><p>Provides a Technical Acknowledgment (TA1) to the Interchange sender that reports the status of the processing of an interchange header and trailer by the address receiver:</p></div><div><ul><li><p>If the ISA and IEA of a received X12 message are valid, the host sends a positive TA1 ACK, regardless of the status of the other content.</p></li><li><p>If the ISA and IEA of a received X12 message are not valid, the host sends a TA1 ACK with an error code.</p></li></ul></div><div><p>The TA1 ACK is sent inside an ISA or IEA envelope. The ISA and IEA are no different from any other interchange.</p></div></div></td><td><p>Disabled</p></td></tr><tr><td><p>Send 997 functional acknowledgment when messages fail to route to a message flow</p></td><td><div><div><p>Sends a functional acknowledgment (the receipt and syntactical acceptability of a message) when there is a failure to route the message to one of the message flows.</p></div></div></td><td><p>Disabled</p></td></tr></tbody></table>

### X12 997 Functional Acknowledgment

The X12 997 functional acknowledgment reports the status of a received interchange. It reports all
of the errors encountered while processing the received document. As with all X12 transaction sets,
the 997 functional acknowledgment is sent inside a GS or GE envelope.

The 997 functional acknowledgment does the following:

- Acknowledges the receipt of an interchange or functional group

- Accepts or rejects one or more functional groups or transactions

- Verifies and reports compliance with the standard

If an interchange contains multiple groups, a 997 acknowledgment is returned for each group.

If a group contains multiple transaction sets, then the acknowledgment for that group contains one
loop for each transaction set. This applies only if AK2 loops are generated for accepted transaction
sets.

## Validation Settings

Use these settings to ensure that all X12 messages received from a partner meet validation rules.
Partner Manager logs all validation errors and reports them in the CONTRL acknowledgements.

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Setting</th><th>Description</th><th>Default</th></tr></thead><tbody><tr><td><p>Fail when value length outside allowed range</p></td><td><div><div><ul><li><p>If selected, Partner Manager rejects transactions with data element values that are too long or too short against the definition in the EDI schema used.</p></li><li><p>If not selected, Partner Manager uses the values.</p></li></ul></div></div></td><td><p>Enabled</p></td></tr><tr><td><p>Truncate values exceeding the length limits</p></td><td><p>If selected and <strong>Fail when value length outside allowed range</strong> isn’t selected, Partner Manager truncates the data elements that exceed the maximum length limit in the generated output.</p></td><td><p>Disabled</p></td></tr><tr><td><p>Fail when invalid character in value</p></td><td><div><div><ul><li><p>If selected, Partner Manager rejects transactions with invalid characters.</p></li><li><p>If not selected, the characters are either passed through or substituted.</p></li></ul></div></div></td><td><p>Enabled</p></td></tr><tr><td><p>Fail if value is repeated too many times</p></td><td><div><div><ul><li><p>If selected, Partner Manager rejects transactions with values that are repeated too many or too few times.</p></li><li><p>If not selected, Partner Manager accepts the values.</p></li></ul></div></div></td><td><p>Enabled</p></td></tr><tr><td><p>Fail if unknown segments are used</p></td><td><div><div><ul><li><p>If selected, the Partner Manager rejects transactions that contain unknown segments.</p></li><li><p>If not selected, Partner Manager ignores unused segments.</p></li></ul></div></div></td><td><p>Disabled</p></td></tr><tr><td><p>Fail when segments are out of order</p></td><td><div><div><ul><li><p>If selected, Partner Manager rejects transactions that have out-of-order segments.</p></li><li><p>If not selected, the segments are reordered.</p></li></ul></div></div></td><td><p>Enabled</p></td></tr><tr><td><p>Fail when too many repeats of segment</p></td><td><p>If selected, Partner Manager rejects transactions with segments repeated too many times.</p></td><td><p>Enabled</p></td></tr><tr><td><p>Fail when unused segments are included</p></td><td><div><div><ul><li><p>If selected, Partner Manager rejects transactions containing segments marked as unused in the schema.</p></li><li><p>If not selected, Partner Manager ignores unused segments.</p></li></ul></div></div></td><td><p>Disabled</p></td></tr><tr><td><p>Enforce conditional relationship validations</p></td><td><div><div><ul><li><p>If selected, any missing conditional data elements cause the generation of the X12 transaction to fail.</p></li><li><p>If not selected, Partner Manager does not enforce relationship validations.</p></li></ul></div></div></td><td><p>Disabled</p></td></tr><tr><td><p>Enforce code set validations</p></td><td><div><div><ul><li><p>If selected, Partner Manager enforces X12 code set validations, as defined in the X12 schemas.</p></li></ul></div></div></td><td><p>Disabled</p></td></tr><tr><td><p>Acknowledge every transaction</p></td><td><p>If selected, Partner Manager includes a separate AK2/AK5 segment for every received transaction set, even when all transactions are accepted in the 997 functional acknowledgment.</p></td><td><p>Disabled</p></td></tr><tr><td><p>Include trailer segment details</p></td><td><p>If selected, Partner Manager includes elements from the Interchange Trailer (IEA) and Group Trailer (GE) segments of the X12 data payload.</p></td><td><p>Disabled</p></td></tr><tr><td><p>Ignore included segments</p></td><td><p>If selected, the X12 read operation output includes segments with usage type 'Ignore', and you can use the segment s in message flow maps.</p></td><td><p>Disabled</p></td></tr></tbody></table>

### Control Numbers

Use these settings to apply validations related to the use of control numbers within inbound X12
messages:

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Setting</th><th>Description</th><th>Default</th></tr></thead><tbody><tr><td><p>Requires unique interchange control number (ISA13)</p></td><td><div><div><p>If selected, the host records the interchange numbers previously processed and rejects duplicate interchange numbers from the same partner (as determined by the interchange sender and receiver identification).</p></div></div></td><td><p>Enabled</p></td></tr><tr><td><p>Requires unique group control number (GS06)</p></td><td><div><div><p>If selected, the host enforces globally unique Group Control Numbers (GS06) for received functional groups.</p></div><div><p>This configuration requires group numbers to be unique across all interchanges received from the same partner and application, as determined by the interchange sender and receiver identification, combined with the functional group sender and receiver application codes.</p></div></div></td><td><p>Disabled</p></td></tr><tr><td><p>Require unique transaction set control number (ST02)</p></td><td><div><div><p>If selected, the host enforces globally unique Transaction Set Control Numbers (ST02) for received transaction sets.</p></div><div><p>This configuration requires transaction set numbers to be unique across all functional groups received from the same partner and application, as determined by the interchange sender and receiver identification, combined with the functional group sender and receiver application codes.</p></div></div></td><td><p>Disabled</p></td></tr></tbody></table>

### Character Set and Encoding

Use these settings to apply character set and encoding options for received X12 message:

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Setting</th><th>Description</th><th>Default</th></tr></thead><tbody><tr><td><p>Character set</p></td><td><div><div><p>Defines the characters allowed in string data. When set, invalid characters are replaced by the substitution character. If no substitution character is enabled for receive messages in the parser options, Partner Manager rejects the messages. Either way, the invalid characters are logged and are reported in the 997 functional acknowledgements for the receive messages.</p></div></div></td><td><p><code>EXTENDED</code></p></td></tr><tr><td><p>Character encoding</p></td><td><div><div><p>Indicates the character encoding for messages.</p></div></div></td><td><p><code>ISO8859_1</code></p></td></tr></tbody></table>

## See Also

- [Creating Inbound Message Flows](https://docs.mulesoft.com/partner-manager/latest/create-inbound-message-flow)

- [Creating Partners](https://docs.mulesoft.com/partner-manager/latest/create-partner)

- [Modifying Partner Settings](https://docs.mulesoft.com/partner-manager/latest/modify-partner-settings)