TotalApp Docs

Trendyol Integration

Connect your Trendyol seller account, browse your live catalog and orders, and ask the AI Assistant questions about stock, pricing, and shipments.

Overview

The Trendyol Integration screen (Ecommerce → Marketplace Hub → Trendyol) is the connection hub between TotalApp and your Trendyol seller account. It manages your API credentials, loads your live product catalog and shipment packages, lists the exact Trendyol REST endpoints in use, and provides an embedded AI Assistant with direct context of your marketplace data.

Server-Side API Calls Only

All requests to the Trendyol API gateway (https://apigw.trendyol.com) are made from the TotalApp server using HTTP Basic authentication, never directly from your browser. This keeps your API Key and Secret secure and avoids CORS restrictions.

Setting Up the Connection

Step 1 — Get Your Trendyol Integration Credentials

TotalApp connects using your Trendyol Seller ID and API credentials. To find them:

  1. Log in to Trendyol Partner (partner.trendyol.com).
  2. Go to Account → Integration Information.
  3. Copy your Seller ID (also called Supplier ID).
  4. Copy your API Key and API Secret.

Step 2 — Enter Credentials in TotalApp

Open Settings → Integrations → Ecommerce → Trendyol and enter:

FieldWhere to find itExample
Seller ID (Supplier ID)Trendyol Partner → Account → Seller Info123456
API KeyTrendyol Partner → Account → Integration Informationxxxxxxxxxxxxxxxx
API SecretTrendyol Partner → Account → Integration Informationxxxxxxxxxxxxxxxx

Back on the Trendyol Integration screen, open the Seller Connection panel and click Test Connection. TotalApp fetches a page of your products and reports the count if the credentials are valid.

Step 3 — Load Live Data

Use Load Products and Load Orders to pull the latest snapshot from Trendyol:

  • Product Catalog — barcode, title, brand, stock quantity, sale price, and approval status.
  • Shipment Packages — order number, customer, item count, total price, and package status.

On-Demand Sync

Data is loaded on demand, not synced automatically in the background. Click the load buttons whenever you want the tables and the AI Assistant to reflect the latest Trendyol state.

API Endpoints

The screen exposes an API Endpoints reference panel listing the exact Trendyol Product Integration and Order Integration endpoints TotalApp uses. Path parameters such as {sellerId}, {packageId}, and {batchId} are filled at call time.

Product Integration

MethodPathPurpose
GET/integration/product/sellers/{sellerId}/productsFilter products
POST/integration/product/sellers/{sellerId}/productsCreate products
PUT/integration/product/sellers/{sellerId}/productsUpdate products
POST/integration/inventory/sellers/{sellerId}/products/price-and-inventoryUpdate price & inventory
GET/integration/product/sellers/{sellerId}/products/batch-requests/{batchId}Check batch request status
GET/integration/product/brandsRetrieve brand list
GET/integration/product/product-categoriesRetrieve category tree & attributes

Order Integration

MethodPathPurpose
GET/integration/order/sellers/{sellerId}/ordersGet shipment packages / orders
PUT/integration/order/sellers/{sellerId}/shipment-packages/{packageId}/tracking-detailsUpdate tracking number
PUT/integration/order/sellers/{sellerId}/shipment-packages/{packageId}Update package status

Product API v1 Deprecation

Per Trendyol’s developer documentation, Product V1 services are being retired in 2026. When migrating, review the endpoint paths above against the current Trendyol Product V2 documentation.

AI Assistant

The AI Assistant panel on the right side of the screen gives you a conversational interface into your Trendyol data. When credentials are configured, TotalApp fetches your live catalog and orders server-side and provides them as context, so the AI can answer analytical questions instantly.

What You Can Ask

  • Stock questions: “Which products are low on stock?”
  • Order questions: “Summarise this week’s orders by status.”
  • Catalog questions: “List products awaiting approval.”
  • Pricing questions: “Which products have the highest sale price?”

Writer Engine Support

The assistant respects your Settings → Agentic → Writer Engine choice. In Local CLI or Hosted API mode, live Trendyol data is fetched server-side and included as context. In Ollama, Local LLM, or Web LLM mode the request runs entirely client-side and live marketplace data is not available — switch to Local CLI or Hosted API for data-driven reports.

Saving as a Report

After the AI responds, a Save as Report button appears under the reply. Clicking it saves the response as a named report in Ecommerce Reports, automatically titled with your question and the current month.

Frequently Asked Questions

Where are my Trendyol credentials stored?
Your Seller ID, API Key, and API Secret are stored via Settings → Integrations. All calls to Trendyol are made from the TotalApp server using HTTP Basic authentication — credentials are never exposed to the browser.
The connection test fails with an HTTP 401. What should I check?
A 401 means the API Key/Secret pair is wrong or the Seller ID does not match the credentials. Re-copy all three values from Trendyol Partner → Account → Integration Information and test again.
Does TotalApp modify my Trendyol data?
The integration screen is read-focused: it loads your catalog and orders and answers questions about them. Write operations (price/inventory updates, package status changes) are listed in the endpoints reference for transparency and are used only when you explicitly trigger them.