---
schema_version: "1"
id: 9cac98d919fe8468253ad0fddc6c1c94c90b88196bcda99a30a793c7d6317395
title: X12 EDI Connector 3.0 - Understanding the EDI Schema Language
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/x12-edi-connector/latest/x12-edi-connector-understand-edi-schema.md
canonical_url: https://docs.mulesoft.com/x12-edi-connector/latest/x12-edi-connector-understand-edi-schema
source_site: docs.mulesoft.com
content_type: documentation
content_hash: a221f2fb468a3403ed4d8e789e7ab8f26fdfee497d61ab61bd2a1594d8b94bbf
description: MuleSoft Documentation Site
release: "3.0"
latest: true
---
---
product: X12 EDI Connector
version: 3.0
is-latest-version: true
---

# X12 EDI Connector 3.0 - Understanding the EDI Schema Language

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

X12 EDI Connector uses a YAML format called EDI Schema Language (ESL) to represent EDI schemas.
Basic ESLs define the structure of Electronic Data Interchange (EDI) messages in terms of:

- structures, known as _transaction sets_ in X12 terminology

- groups, known as loops, in X12

- segments, composites, and elements

ESLs for the all [supported X12 versions](https://docs.mulesoft.com/x12-edi-connector/latest/x12-edi-versions-x12) are included. If you are using
HIPAA, then a set of [HIPAA variations](https://docs.mulesoft.com/x12-edi-connector/latest/x12-edi-versions-hipaa) of base X12 transaction sets are
included.

Customize X12 schema definitions to suit your data by defining an overlay schema. An overlay schema
is a type of ESL that enables you to modify a base schema, such as an X12 4010 850 schema, with your
specific conventions. You don’t need an overlay schema if you’re using the structure defined by the
standard, but most EDI exchanges modify the base definitions in an implementation convention.

Define your own custom schemas, or copy and edit a base X12 schema definition to suit your data as
shown in the [EDI Schema Language Reference](https://docs.mulesoft.com/x12-edi-connector/latest/x12-edi-schema-language-reference).

## Finding Schema Locations

To use the connector, you need to know the locations of the schemas in your project. If you’re using
out-of-the-box X12 schemas and not customizing anything, the schema location follows the
`/x12/{version}/{transaction set}.esl` convention.

For example, using the `005010` version and the 850 transaction set, the schema location is
`/x12/005010/850.esl`.

If you’re using one or more custom schemas, refer to
[Schema and Trading Partner Configuration](https://docs.mulesoft.com/x12-edi-connector/latest/x12-edi-connector-config-topics) for complete information
about setting your schema locations.

## See Also

- [Introduction to Anypoint Connectors](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)

- [Use Exchange to Discover Connectors, Templates, and Examples](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange)

- [Salesforce Help](https://help.salesforce.com)