# 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="/files/h8IWv9IVMcgSmmMIT2md" 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="/files/3e9sXccZhbBIhBJVV82W" 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="/files/JUPnsQkdwiA84k6Cjyan" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/3hYl9ovmUuzl878iuz7l" 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="/files/4OyvP5jYYgEuwaKxtydl" alt=""><figcaption></figcaption></figure>

To delete the mapping, go to Options > Delete.

<figure><img src="/files/nGnUK6QAHWH4zaOQmFNc" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.
