# Mappings - Transform JSON
Source: https://www.stedi.com/docs/edi-platform/mappings

***

title: Mappings - Transform JSON
sidebarTitle: "Mappings overview"
---------------------------------

<Note>
  This functionality is available in a Stedi module. [Contact us](https://www.stedi.com/contact) for details.
</Note>

Integrating Stedi with your internal systems requires transforming Stedi [Guide JSON](/edi-platform/operate/transform-json/guide-json) to and from a format that your system can understand.

The Stedi Mappings module is a powerful JSON-to-JSON transformation engine. You can build mappings using Stedi’s visual mapper and use mappings to transform data for both inbound and outbound transactions.

For example, the following mapping transforms data from a translated 850 Purchase Order (Guide JSON) to the JSON Schema required for a simple Orders API endpoint.

![Mapping example](/images/mappings/mappings-example-full.png)

## When to use Mappings

There are three ways you can transform Stedi transaction data (JSON) into a custom format: Stedi Mappings, writing custom code, and using an iPaaS platform. The approach you choose depends on your circumstances and preferences.

Mappings may be a good fit for your business when:

* Your system can natively produce and consume JSON payloads.
* You plan to do one-step transformations without multi-step processing.
* You want your business or operations team to manage mappings without engineering involvement.
* You want a solution that's integrated with the Stedi platform.

Visit our docs on [Transformation approaches](/edi-platform/operate/transform-json/transformation-approaches) for a detailed discussion of the pros and cons of each tranformation method.

### Read EDI

The most common Mappings use case is transforming processed transaction data from Stedi into a custom JSON Schema for your business system.

You can use [webhooks](/edi-platform/configure/webhooks) to automatically send transaction processed events to any API endpoint. Then, you can use the [Map Transaction Output](/edi-platform/api-reference/get-map-transaction-output) endpoint to return the mapped output of the processed inbound transaction.

### Write EDI

You can also use Mappings to transform JSON from your business systems into the [Guide JSON](/edi-platform/operate/transform-json/guide-json) format required to Stedi's API.

### Ingest Stedi events

You may want to transform [Stedi events](/edi-platform/operate/event-types) into a custom shape before sending them to your business system. For example, you may want to ingest `file.failed.v2` events into applications like Slack or Zapier to create internal alerts for your operations team.