Manage Integrated Message Codes

Estimated reading: 9 minutes

Last updated: July 15, 2026

Overview

Integrated Message Codes help Synctify OMS translate shipping-related codes between Synctify and your connected partners, such as sales channels, warehouses, 3PLs, and carriers.

Different partners may use different codes for the same carrier or service level. For example, one partner may send a combined code such as UPS_GR_RES , while another system expects separate carrier and service level values.

Integrated Message Codes let you manage how partner codes resolve to Synctify-recognized carrier codes and service levels. This helps orders and shipments use the correct shipping information when they move between systems.

Currently, Integrated Message Codes support:

Carrier codes
Service levels

Before you start

You can manage Integrated Message Codes from Integrations > Integrated Message Codes .

This page is available to authenticated admin users. Available actions may vary depending on the selected code type and context. Some system codes are read-only and cannot be edited or deleted directly.

View code mappings

Go to Integrations > Integrated Message Codes .
Select a partner, carrier, or context from the list on the left.
Review the code mapping table.

The table shows the following information:

Column	Description
Partner Code	The code sent by or used for the selected partner context.
Description	A short description of what the code represents.
Direction	Whether the code is used for inbound, outbound, or both directions.
Carrier	The carrier code this partner code resolves to.
Service Level	The service level this partner code resolves to.
Source	Whether the code was provided by Synctify (System) or created by your team (Custom).

You can use the search field to find a code by code value or description.

Understand direction options

When you add or edit a code, select the direction that matches how the partner code should be used.

Direction	Meaning
Inbound only	Use this option when Synctify receives this code from the partner.
Outbound only	Use this option when Synctify sends this code to the partner.
Both (IN and OUT)	Use this option when the same code can be used in both inbound and outbound directions.

Understand source values

The Source column in the code mapping table shows where a code comes from.

Source	Meaning
System	This code is provided by Synctify. It is read-only and cannot be edited or deleted directly. You can override it if the option is available.
Custom	This code was created by your team for this context. It can be edited or deleted.

Add a code

Go to Integrations > Integrated Message Codes .
Select the partner, carrier, or context where you want to add the code.
Click + Add Code .
In Partner Code , enter the code value used by the partner.
In Description , enter a short description.
Select the Direction :
Inbound only — Synctify receives this code from the partner.
Outbound only — Synctify sends this code to the partner.
Both (IN and OUT) — The code applies in both directions.
Keep Active selected if the code should be used during code resolution.
Under This code represents , select at least one option:
Carrier Codes
Service Levels
Search for and select the carrier code or service level that this partner code should resolve to.
If the partner code should be added as an unmapped code, leave the carrier or service level field empty.
Click Save Code .

Edit a code

Go to Integrations > Integrated Message Codes .
Select the partner, carrier, or context that contains the code.
Find the code in the mapping table.
Click the row of the code you want to update.
System-managed rows are read-only and cannot be edited directly.
Update the available fields.
The code value cannot be changed after creation.
Select or clear Active depending on whether the code should be used during code resolution.
Update the related Carrier Codes or Service Levels if needed.
Click Save Code .

To close the form without saving your updates, click Discard Changes .

Override an inherited code

Some inherited System codes may allow an override. Use an override when the selected context needs a different mapping from the inherited default.

Go to Integrations > Integrated Message Codes .
Select the partner, warehouse, or context that contains the inherited code.
Open the code detail drawer.
Click Override , if the option is available.
Review the pre-filled information.
The code value is locked and cannot be changed.
Update the description, direction, carrier code, or service level mapping as needed.
Click Create Override .
Review the inline confirmation panel.
The confirmation explains that a context-specific override will be created and the inherited default will no longer apply to this context.
Click Create Override again to confirm.
To go back to the form without saving, click Go Back .

After saving, the code becomes Customized for the selected context.

Delete or revert a code

Some user-created codes may be deleted when the Delete action is available. System codes cannot be deleted directly.

Go to Integrations > Integrated Message Codes .
Select the partner, carrier, or context that contains the code.
Open the code you want to delete.
Click Delete , if the option is available.
Review the confirmation message.
Confirm the deletion.

If you delete an override, the inherited System code will appear again for that context.

Note

Delete actions are only available for codes that can be safely removed. Some codes are protected because they are provided by Synctify or are still required by existing mappings.

Manage carrier and service level codes

The Carriers list shows Synctify-recognized carrier codes and service levels that partner codes can resolve to.

In this article, the standard catalog refers to the carrier and service level codes listed under Carriers . These codes are used as the standard values that partner codes resolve to.

You can add your own custom carrier or service level codes if a carrier or service level you work with is not already listed.

Note

Custom carrier and service level codes exist only in your tenant’s catalog. They may not be recognized by external integrations. A warning is shown when creating or editing custom catalog codes.

Add a custom carrier or service level code

Select Carriers from the left panel.
Select the carrier you want to manage.
Click + Add Custom Code .
Enter the Code value.
Select the Code Type :
Carrier Code
Service Level
Optionally add a Description and set the Direction .
Click Add to Catalog .

Edit a custom carrier or service level code

Only custom codes can be edited. System-provided codes are read-only.

Find the code from the Carriers list.
Click the code row to open the detail panel.
Click Edit Partner Code .
Update the Description or Direction .
The code value and type cannot be changed after creation.
Click Save Changes .

Delete a custom carrier or service level code

A custom carrier or service level code can only be deleted if it is not currently mapped by any partner code. If it is in use, remove the partner code mappings first.

Find the code from the Carriers list.
Open the code detail panel.
Click Delete .
Confirm the deletion.

Preview and test mappings

Use Preview & Test to check how codes resolve before relying on them in order or shipment processing.

Preview & Test supports different ways to review mappings:

Option	When to use it
By code	Use this option to test a single code mapping. This is helpful when you want to check how one partner code resolves in the selected context.
By warehouse	Use this option to test how codes resolve against a specific warehouse or 3PL data source. This option appears only when a WMS-type integration is selected.
By order number	Use this option to review a real order’s complete business flow and actual results. This is helpful when you need to troubleshoot how carrier codes or service levels were resolved for a specific order.

Test by code

Go to Integrations > Integrated Message Codes .
Select the partner, carrier, or context you want to test.
Click Preview & Test .
Select By code .
Choose the translation direction using the toggle:
From [partner name] — Enter the code the partner sends Synctify to see what it resolves to.
To [partner name] — Enter a Synctify standard code, such as a carrier code or service level, to see what code Synctify sends back to the partner.
This toggle is not shown when the selected context is a carrier, because carrier codes are themselves the standard codes.
Enter the code value.
Review the preview result.

The preview shows matching codes, their type, direction, and what each code resolves to.

Test by warehouse

The By warehouse option appears only when a WMS-type integration is selected. Use it to check how codes resolve against a specific warehouse or 3PL data source without switching the main context.

Go to Integrations > Integrated Message Codes .
Select the WMS-type integration or context you want to test.
Click Preview & Test .
Select By warehouse .
Select a warehouse or 3PL from the dropdown.
Use the direction toggle and code lookup the same way as By code .

If no warehouse or 3PL data sources are integrated, the dropdown will indicate that none are available.

Test by order number

Go to Integrations > Integrated Message Codes .
Select the partner, carrier, or context you want to test.
Click Preview & Test .
Select By order number .
Enter the order number.
Review the order's code translation path.

By order number shows how codes were resolved for a real order, including the flow from the channel code to the Synctify standard code, then to the outbound warehouse or 3PL code and the channel ASN code.

This can help you identify where a carrier code or service level became unmapped, resolved to an unexpected value, or differed from the value that was actually used during fulfillment.

Note

Preview reflects the mappings currently saved for the selected context. When reviewing by order number, the result may also help compare the currently predicted mapping with the actual value used during fulfillment.

FAQ

Manage Integrated Message Codes

Can a partner code represent both a carrier and a service level?

Yes. A partner code can represent a carrier code, a service level, or both. For combined codes, select both Carrier Codes and Service Levels .

Can I change the partner code value after creating it?

No. The code value cannot be changed after creation. If the value is incorrect, create a new code with the correct value.

What does an unmapped code mean?

An unmapped code is a partner code that has been added but does not yet resolve to a carrier code or service level. You can edit the code later to complete the mapping.

What does the Source column show?

The Source column shows where a code comes from. System codes are provided by Synctify and are read-only, while Custom codes were created by your team. This is separate from the code’s status, such as whether it has been overridden or is unmapped.

What happens if a code is inactive?

Inactive codes are kept in the system, but they are ignored during code resolution.

What happens when I delete an override?

Deleting an override reverts the selected context back to the inherited System code.

What is the standard catalog?

The standard catalog is the list of Synctify-recognized carrier codes and service levels listed under Carriers . Partner codes resolve to entries in this catalog. You can also add custom carrier or service level codes if the value you need is not already listed.

Why can’t I edit or delete some codes?

Some codes are provided by Synctify and are read-only in the selected context.

When a code is read-only, the row shows a System source badge. Hovering over a locked row may also show a tooltip explaining that system codes cannot be edited here. You can override a System code instead of editing it directly if the Override option is available.