Trendyol TR Marketplace Integration

This native integration with Trendyol TR enables order, catalog and inventory synchronization seamless.

Version: v1.0
Date: December 29, 2025
Owner: Sales Channel Product Team

1. Overview

What this integration does

The Trendyol TR integration connects your Trendyol TR Marketplace store with Omniful so that:

Orders created through Trendyol TR automatically sync to Omniful for processing.
Inventory availability maintained in Omniful can be synced to Trendyol TR.
You can configure hub mapping, order status mapping, directly from Omniful.

2. Prerequisites

2.1 Sales Channel prerequisites

You will be required to obtain the following details from Trendyol TR Store:

API Key
API Secret key
External Merchant ID

To obtain the above, go to Trendyol Seller Dashboard > Account Details > Integration Details

3. Integration Methods and Setup

3.1 Connect Trendyol TR store in Omniful

Once you have the required details:

In Omniful, go to: Settings → Apps & Integration → Sales Channel Apps
Select Seller and choose Trendyol TR from the marketplace section.
Click Add Store
Enter all required information in the corresponding input fields. Click Integrate to complete the setup process.

4. Omniful Configuration

Once the store is connected, configure how data flows between Trendyol TR and Omniful.

4.1 Store-level settings

Depending on your requirements, you can enable:

Order Sync – Automatically fetch orders from Trendyol TR to Omniful.
Catalog Sync – Fetch catalog ((Active and Live SKUs) from Trendyol TR into Omniful.
Inventory Sync – Push available inventory from Omniful hubs to Trendyol TR.

4.2 Hub Mapping

Configure how Trendyol TR orders are routed to Omniful hubs:

Map Omniful Hubs that can fulfill/ship Trendyol Orders.

4.3 Order status mapping

Order Status Mapping defines how Trendyol TR statuses and Omniful statuses stay in sync:

Sales Channel Mapping –
Map incoming Trendyol TR order statuses (e.g., Created, Invoiced) to internal Omniful order lifecycle stages (e.g., New Order, Cancelled).

Note: Ensure Trendyol TR order statuses (such as Created and Invoiced) are configured correctly—otherwise new orders may not sync to Omniful. Likewise, if the cancelled status is not mapped, cancelled orders will not sync back to Trendyol TR.

Workspace Order Mapping –
Define which outgoing Omniful shipment/order statuses should be pushed back to Trendyol TR (for example, when the order is Rejected or Cancelled).

4.4 Configuration log

Use the Configuration Log to track changes to configurations.

5. Data & Sync Behaviour

5.1 Orders

Which orders sync
All orders with the mapped order statuses will be visible in Omniful.

5.2 Catalog

Seller’s Trendyol TR store Catalog (Active SKUs) with valid Stock Code is fetched automatically to Omniful when Catalog Sync is enabled.

Omniful periodically fetches SKUs so you can see and use them for order & fulfillment processes in Omniful.

5.3 Inventory

Omniful automatically pushes and maintains inventory level on Trendyol TR store when Inventory Sync is enabled and the hubs are mapped.

5.4 Cancellations

When Automated Order Cancellation On Sales Channel is enabled, canceling an order in Omniful triggers an automatic cancellation on Trendyol TR, keeping both systems aligned.

6. FAQs

Q: My Trendyol TR orders are not appearing in Omniful. What should I check?
A: If orders are not syncing, verify the following:

Order Sync is enabled in Store-Level Settings.
The order’s Trendyol TR status is mapped under Sales Channel Mapping (e.g., Trendyol TR (Created) → Omniful (New Order)).

Q: Why are cancellations from Omniful not reflecting on Trendyol TR?
A: For Omniful → Trendyol TR cancellations to sync back:

“Automated Order Cancellation on Sales Channel” must be enabled.
Omniful’s Cancelled order status is mapped to Trendyol’s Cancelled order status.

Q: Who is the inventory master?
A: Omniful is the inventory master. Enabling Inventory Sync pushes available stock from Omniful to Trendyol TR.

Q: Who creates shipment of orders from Trendyol TR store?
A: Currently, Trendyol TR supports shipments through Aras Kargo or Trendyol Express. When either of these partners is used, the shipment is generated by Trendyol. For all other shipping partners, the shipment is created within the Omniful system.