> For the complete documentation index, see [llms.txt](https://docs.xorosoft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xorosoft.com/xoroerp-1/admin/third-party-field-mapping/creating-third-party-field-mapping.md).

# Creating Third Party Field Mapping

Creating a third party mapping module involves providing the details of the entity for mapping and the values to be mapped. For example, when an order drops from Shopify with the Shopify ship service called 'FEDEX', while in Xoro the same service is named 'Fedex Ground', establishing a third-party field mapping for the ship service will translate 'FEDEX' to 'Fedex Ground' on the sales orders within Xoro.

{% hint style="info" %}
To create a third party field mapping, go to **Menu > Admin > Third Party Field Mapping**
{% endhint %}

To create the third party field mapping,  you'll begin by entering the essential details, such as mapping name, third party details, mapping entity, and value.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2Fu5bNI5eseeoxa2oadsjx%2Fimage.png?alt=media&amp;token=43bf2451-1071-4fbb-9df4-b61d547387be" alt=""><figcaption></figcaption></figure>

**Third Party Field Mapping Header Fields**

<table><thead><tr><th width="199">Field</th><th>Description</th></tr></thead><tbody><tr><td>Mapping Name</td><td>This field allows you to provide a name for the mapping to be created.</td></tr><tr><td>Third Party Source</td><td>Enter the third party sources separated by comma.</td></tr><tr><td>Third Party Account</td><td>Enter the third party accounts separated by comma.</td></tr><tr><td>Entity</td><td>This field allows you to choose the entity for mapping: select "Sales Order Detail" to update sales order fields, or choose "All" to update a field from any module.</td></tr><tr><td>Value</td><td>This field allows you to enter the value to be mapped; select value(s) for the Sales Order Entity, or define a value if mapping for all the modules.</td></tr></tbody></table>

Once the basic info is set, define the field values for the Xoro and external system. You can add multiple fields for mapping.

**Third Party Field Mapping Lines Fields**

<table><thead><tr><th width="158">Field</th><th>Description</th></tr></thead><tbody><tr><td>Xoro Value</td><td>This field allows you to enter the Xoro value. For example, Fedex Ground in the example mentioned above.</td></tr><tr><td>External Value</td><td>This field allows you to enter the value from the external system. For example, FEDEX in the example mentioned above.</td></tr></tbody></table>

Once the values are set, click "Add" to add the mapping.&#x20;

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FluURnzeGi6JIPJV7KzEV%2Fimage.png?alt=media&amp;token=68d07fea-f433-47b9-8ba3-a0915ed988be" alt=""><figcaption></figcaption></figure>

After entering the mapping details, click on "Save" to create the mapping. This will ensure that data is accurately translated and mapped between the external system and Xoro, streamlining your order management processes.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FhGhYPsJQUE12nBzX5F2A%2Fimage.png?alt=media&amp;token=96ac0378-6514-4730-9509-c77e4bc0f630" alt=""><figcaption></figcaption></figure>

You can view all the mappings created in the Third-Party Field Mapping Centre.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2F1VTFneBt42nowTdYrPGP%2Fimage.png?alt=media&amp;token=8dbb3a22-f489-4656-af20-98e1d461bd3c" alt=""><figcaption></figcaption></figure>

### Deleting the Mapping

You can delete both the mapping line and the entire mapping.&#x20;

To delete the mapping line, click the "Bin" icon under the "Action" column.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FVAmPQVspMDPxGdC6Elsy%2Fimage.png?alt=media&amp;token=2d81d4fe-fca0-44fe-993b-5ac19d3b438d" alt=""><figcaption></figcaption></figure>

To delete the mapping, go to Options > Delete.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2Fudf36MXzvKsAmQQubcjQ%2Fimage.png?alt=media&amp;token=7963cff8-da1e-4d2c-a9cf-0277ec400445" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.xorosoft.com/xoroerp-1/admin/third-party-field-mapping/creating-third-party-field-mapping.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.