دليل التكامل مع Trendyol 2026: واجهة REST API، اتصال XML & إدارة متاجر مركزية

1. بنية Trendyol API 2026

واجهة Marketplace API الخاصة بـ Trendyol هي واجهة RESTful من نوع JSON-over-HTTPS منشورة على عنوان أساسي إنتاجي واحد — https://api.trendyol.com — مع بيئة stage منفصلة على https://stageapi.trendyol.com. تُصادَق كل استدعاءات الواجهة باستخدام HTTP Basic Auth: تحمل ترويسة Authorization زوج ApiKey:ApiSecret المُشفَّر بـ base64، ويُمرَّر Supplier ID كمعامل مسار في كل نقطة نهاية ضمن نطاق المورّد. لا توجد دورة access-token منفصلة للبائعين المباشرين — يُتحقَّق من Basic Auth في كل طلب — ما يبقي التكامل بسيطاً لكنه يعني أن بيانات الاعتماد المسرَّبة يجب تدويرها فوراً عبر لوحة Partner.

العنوان الأساسي والمصادقة والترويسات

POST https://api.trendyol.com/sapigw/suppliers/{supplierId}/v2/products
Authorization: Basic BASE64(ApiKey:ApiSecret)
User-Agent: {supplierId} - SelfIntegration
Content-Type: application/json
Accept: application/json

ترويسة User-Agent ليست تجميلية: يعتمد عليها تشكيل حركة المرور واحتساب حدود المعدّل لدى Trendyol. يُرسل المكاملون (مثل Zunapro) {supplierId} - Zunapro؛ ويُرسل البائعون المباشرون {supplierId} - SelfIntegration. يمكن أن تُسبّب ترويسات User-Agent الموسومة بشكل خاطئ استجابات 401/403 حتى مع بيانات اعتماد صحيحة.

حدود المعدّل والحصص

يفرض Trendyol حدود معدّل لكل نقطة نهاية ولكل مورّد. السقوف المنشورة لعام 2026 هي:

• نقاط نهاية المنتجات — عادةً 60 طلباً/دقيقة لكل Supplier ID، مع تحمّل دفقات حتى 90/دقيقة لمدة 30 ثانية
• نقاط نهاية الطلبات — عادةً 600 طلب/دقيقة (نقطة الطلبات مصمَّمة لحركة مرور عالية وزمن استجابة منخفض)
• نقاط نهاية تحديث السعر & المخزون — عادةً 100 طلب/دقيقة، بحيث يحمل كل طلب حتى 1,000 SKU في دفعة واحدة
• عمليات البحث عن الفئات & السمات — عادةً 30 طلباً/دقيقة (تتغيّر ببطء، لذا يُتوقّع تخزين مؤقت قوي)

تتضمّن كل استجابة ترويسات X-RateLimit-Limit وX-RateLimit-Remaining، وعند 429، Retry-After. يستخدم التكامل المبني جيداً طابور token-bucket لكل Supplier ID ويطبّق ضغطاً عكسياً عند 429 بتراجع أسّي؛ ينفّذ Zunapro ذلك افتراضياً بحيث لا تتجاوز الحدود أبداً حتى الدفعات المجمّعة لآلاف الـ SKU.

OAuth 2.0 للمكاملين المستقلين

بالنسبة لمكاملي الطبقة الوسيطة المستقلين (Zunapro ومنصات SaaS المشابهة التي تعمل نيابةً عن العديد من الموردين)، يوفّر Trendyol تدفّق OAuth 2.0 من نوع authorization-code بدلاً من Basic Auth المباشر. يسجّل المكامِل client_id / client_secret لدى فريق علاقات المطوّرين في Trendyol، ويصرّح المورّد للمكامِل من لوحة Partner، ويتلقّى المكامِل رمز وصول صالحاً لساعة واحدة إضافةً إلى refresh token لإعادة الإصدار. يتجنّب ذلك التعامل مطلقاً مع ApiKey / ApiSecret الخام للمورّد، وهو المسار الصديق للتدقيق لعملاء المؤسسات الذين يديرون العديد من متاجر Trendyol.

Webhooks

يدفع Trendyol أحداث دورة حياة الطلب إلى عنوان webhook المسجّل لديك: Created، Picking، Invoiced، Shipped، Delivered، Cancelled، Returned، UnDelivered. حمولة الـ webhook عبارة عن غلاف JSON يحمل معرّف الطلب والحالة الجديدة؛ ويجب أن تستجيب نقطة النهاية لديك بـ HTTP 200 خلال 3 ثوانٍ. عند الفشل يُعيد Trendyol المحاولة 5 مرات بتراجع أسّي ثم يوقف الحدث — ولهذا فإن عملية سحب مطابقة كل 5 دقائق مقابل /sapigw/suppliers/{id}/orders تُعدّ شبكة أمان غير اختيارية.

2. الاتصال عبر REST API — خطوةً بخطوة

المسار الرسمي السلس للاتصال بواجهة REST API الخاصة بـ Trendyol في عام 2026 قصير وموثّق جيداً — لكن ترتيب العمليات مهم لأن بعض المتطلبات القانونية تسبق الواجهة نفسها.

2.1 افتح حساب بائع على Trendyol

زُر partner.trendyol.com وقدّم طلب "فتح حساب Trendyol". ستحتاج إلى:

• VKN (Vergi Kimlik Numarası) — الرقم الضريبي التركي (أو ما يعادله من تسجيل تجاري أجنبي لـ Trendyol International)
• Trade Registry Gazette (Ticaret Sicil Gazetesi) للشركات ذات المسؤولية المحدودة أو المساهمة
• نموذج التوقيع (imza sirküleri)
• ETBİS (Elektronik Ticaret Bilgi Sistemi) إيصال التسجيل — إلزامي لكل مشغّل تجارة إلكترونية تركي منذ 2018
• حساب مصرفي (IBAN TR) باسم الكيان القانوني لمدفوعات الـ marketplace

تستغرق الموافقة عادةً 2–5 أيام عمل. بمجرد الموافقة، يتلقّى البائع Supplier ID والوصول إلى لوحة Trendyol Partner.

2.2 أنشئ API Key و Secret

من لوحة Partner، افتح إعدادات الحساب ← معلومات التكامل وانقر على "Create API Key". يُنشئ Trendyol API Key من 40 حرفاً وAPI Secret من 40 حرفاً. تُعرض القيمتان مرةً واحدة — ولا يمكن استرجاعهما لاحقاً. احفظهما في مدير كلمات مرور أو، والأفضل، الصقهما مباشرةً في بطاقة التكامل لدى Zunapro التي تخزّنهما كأسرار مقنّعة ومشفّرة بـ AES-256.

2.3 أول طلب اختبار سريع

تأكّد من أن بيانات الاعتماد فعّالة عبر استدعاء نقطة نهاية معلومات المورّد:

curl -X GET "https://api.trendyol.com/sapigw/suppliers/{supplierId}/addresses" \
  -H "Authorization: Basic $(echo -n 'API_KEY:API_SECRET' | base64)" \
  -H "User-Agent: {supplierId} - SelfIntegration" \
  -H "Accept: application/json"

تُعيد الاستجابة الناجحة عناوين المستودع والإرجاع المسجّلة للمورّد بصيغة JSON. يعني الرمز 401 أن ترويسة Basic Auth خاطئة؛ ويعني 403 أن Supplier ID لا يطابق بيانات الاعتماد؛ ويعني 404 أن مسار نقطة النهاية غير صحيح البناء.

2.4 متغيّر OAuth (لمكاملي الموردين المتعددين)

بالنسبة للمكاملين المستقلين، يبدو تدفّق OAuth 2.0 على النحو التالي:

1. Integrator redirects supplier to:
   https://partner.trendyol.com/oauth/authorize
     ?client_id={integratorClientId}
     &response_type=code
     &redirect_uri={integratorRedirectUri}

2. Supplier approves access; Trendyol redirects back with ?code={authCode}

3. Integrator exchanges code for tokens:
   POST https://api.trendyol.com/oauth/token
     grant_type=authorization_code
     code={authCode}
     client_id={integratorClientId}
     client_secret={integratorClientSecret}

4. Response: { access_token, refresh_token, expires_in: 3600 }

رموز الوصول صالحة لمدة ساعة واحدة وقابلة للتجديد لمدة 30 يوماً. يتولّى Zunapro جميع الخطوات الأربع بشفافية، بحيث لا يرى المورّد سوى زر واحد "Connect to Trendyol".

2.5 انشر منتجك الأول

استخدم POST /sapigw/suppliers/{supplierId}/v2/products مع مصفوفة JSON من العناصر. يتطلّب كائن المنتج الأدنى barcode وtitle وproductMainId وbrandId وcategoryId وquantity وstockCode وdimensionalWeight وdescription وcurrencyType (عادةً TRY) وlistPrice وsalePrice وvatRate وcargoCompanyId، ومصفوفة images (1–8 عناوين URL)، ومصفوفة attributes من معرّفات السمات الخاصة بالفئة.

3. مزامنة المنتجات على نطاق واسع

الرفع المجمّع — 1,000 SKU لكل دفعة

تقبل نقطة نهاية POST /v2/products لدى Trendyol حتى 1,000 SKU لكل طلب JSON منفرد. بالنسبة للبائعين الذين لديهم كتالوجات تضم أكثر من 10,000 SKU، يمثّل هذا الفرق بين إعداد يستغرق ساعةً واحدة وآخر يستغرق أياماً عدّة. تُعيد الدفعة رمز batchRequestId لكل استدعاء؛ ويعالج Trendyol كل دفعة بشكل غير متزامن ويكشف النجاح / الفشل لكل SKU بمجرد اكتمال المعالجة (عادةً خلال 1–15 دقيقة حسب عمق طابور التحقق).

مطابقة الفئات — الخطوة الأصعب على الإطلاق

شجرة فئات Trendyol عميقة وصارمة. اعتباراً من 2026 يوجد نحو 12,000 فئة طرفية، لكل منها مجموعة سماتها الإلزامية والاختيارية الخاصة. يتطلّب بنطال جينز مُدرَج تحت "رجالي ← بناطيل ← كاجوال" سمات gender وsize وcolor وmaterial وfit-type؛ ويتطلّب هاتف ذكي تحت "إلكترونيات ← جوال ← هواتف" brand وmodel وmemory وguaranteeType وwarrantyPeriod. يؤدّي نشر منتج في فئة طرفية خاطئة، أو في الفئة الصحيحة لكن مع غياب سمة إلزامية، إلى رفض صامت في نتيجة الدفعة.

النهج المدعوم هو:

1. اسحب شجرة الفئات الحيّة من GET /sapigw/product-categories (خزّنها مؤقتاً 24 ساعة)
2. لكل فئة طرفية، اسحب السمات الإلزامية + الاختيارية من GET /sapigw/product-categories/{categoryId}/attributes
3. طابِق SKU كتالوجك الرئيسي مع الفئات الطرفية في Trendyol — يستخدم Zunapro أداة مطابقة تعلّم آلي مدرَّبة على ملايين قوائم Trendyol التاريخية لاقتراح الفئات من العنوان + العلامة التجارية + تصنيفك بمعدّل مطابقة من المحاولة الأولى يفوق 92%
4. تحقّق من كل SKU مقابل السمات الإلزامية قبل استدعاء نقطة نهاية POST، لتجنّب إهدار حدود المعدّل على طلبات محكوم عليها بالفشل

القائمة البيضاء للعلامات التجارية و brandId

يجب أن يشير كل منتج إلى brandId موجود في سجل العلامات التجارية لدى Trendyol. لا يمكن إنشاء علامات تجارية جديدة على الفور — فهي تمر بعملية اعتماد علامة تجارية يدوية عبر لوحة Partner (عادةً 1–3 أيام عمل). استخدم GET /sapigw/brands?name={brandName} للبحث عن brandId قائم قبل إنشاء المنتجات.

قواعد رفع الصور

• 1–8 صور لكل منتج
• عناوين URL عامة بروتوكول HTTPS (يزحف Trendyol إلى الصور ويعيد استضافتها على شبكة توصيل المحتوى الخاصة به)
• الحد الأدنى 1200×1800 بكسل، وخلفية بيضاء لفئات الأزياء
• JPG أو PNG، بحد أقصى ~10 ميغابايت لكل صورة
• تصبح الصورة الأولى الصورة المصغّرة في نتائج البحث — استثمر فيها

استطلاع حالة الدفعة

GET https://api.trendyol.com/sapigw/suppliers/{supplierId}/products/batch-requests/{batchRequestId}

Response:
{
  "batchRequestId": "abc-def-...",
  "status": "COMPLETED",
  "itemCount": 1000,
  "items": [
    { "requestItem": {...}, "status": "SUCCESS" },
    { "requestItem": {...}, "status": "INVALID", "failureReasons": ["INVALID_BARCODE"] }
  ]
}

4. إدارة الطلبات — Webhooks وتدفّق الحالة

دورة حياة الطلب لعام 2026

يمرّ طلب Trendyol عبر تدفّق حالة ثابت:

Created → Picking → Invoiced → Shipped → Delivered

Branch flows:
  Cancelled (any time before Shipped)
  Returned (after Delivered, within 14-day window)
  UnDelivered (carrier exception)

يُطلق كل انتقال حدث webhook (دفع) وينعكس أيضاً في عملية سحب GET /orders التالية (استطلاع). البائع مسؤول عن الانتقال Picking → Invoiced → Shipped؛ ويتحكّم شركاء Trendyol اللوجستيون في Shipped → Delivered.

استلام Webhook وعدم التكرار (Idempotency)

يحمل كل webhook رمز shipmentPackageId فريداً. عالجه بطريقة idempotent — إذ يُعيد Trendyol فعلاً محاولة الأحداث عند استجابة غير 200، والمعالجة المزدوجة من جهتك (فوترة مزدوجة، انتقاء مزدوج) خطر حقيقي. النمط العملي هو:

POST /webhook/trendyol
{
  "supplierId": 123456,
  "shipmentPackageId": 987654321,
  "status": "Picking",
  "timestamp": 1717930000000
}

Handler:
1. Acquire lock on shipmentPackageId
2. Check stored status; if already >= "Picking", return 200 (no-op)
3. Persist new status, schedule downstream actions (e-invoice, picking task)
4. Return HTTP 200 within 3 seconds

تدفّق الإلغاء والاسترداد

تصل عمليات الإلغاء بمبادرة المشتري كـ webhooks من نوع Cancelled؛ وتُدفَع عمليات الإلغاء بمبادرة البائع عبر POST /sapigw/suppliers/{id}/orders/{orderId}/cancel مع رمز سبب إلغاء (OUT_OF_STOCK، OTHER إلخ). يتولّى Trendyol تلقائياً عمليات الاسترداد للأصناف المُسلَّمة + المُرجَعة؛ والالتزام الوحيد على البائع هو تأكيد استلام البضائع المُرجَعة خلال 48 ساعة من مسح الناقل.

ملصق شحن Trendyol Express

بمجرد نقل طرد إلى حالة Picking، اطلب ملصق الشحن عبر GET /sapigw/suppliers/{id}/orders/{orderId}/labels — يُعيد Trendyol ملف PDF (واختيارياً ZPL للطابعات الحرارية) يحتوي على باركود Trendyol Express وعنوان المشتري ورقم تتبّع الشحنة. الباركود هو أداة توجيه الناقل الوحيدة — اطبعه، وألصقه، وامسحه ضوئياً في نظام إدارة المستودعات (WMS) لديك، وسلّمه إلى نقطة استلام Trendyol Express (أو جدوِل استلام مندوب للبائعين ذوي الحجم المرتفع).

5. تحديثات المخزون & السعر في الوقت الفعلي

نمط دفع المخزون-السعر

يكشف Trendyol نقطة نهاية مخصّصة لتحديثات المخزون والسعر: POST /sapigw/suppliers/{id}/products/price-and-inventory. يقبل كل استدعاء حتى 1,000 عنصر، مع barcode وquantity وsalePrice واختيارياً listPrice لكل عنصر. تُطبَّق التحديثات خلال ثوانٍ للمخزون، وخلال 2–5 دقائق للسعر (يخزّن Trendyol السعر مؤقتاً من أجل اتّساق تغذية التسوّق).

POST /sapigw/suppliers/{id}/products/price-and-inventory
{
  "items": [
    { "barcode": "8690123456789", "quantity": 42, "salePrice": 549.90, "listPrice": 699.90 },
    { "barcode": "8690987654321", "quantity": 0, "salePrice": 199.00 }
  ]
}

بنية المزامنة master → local → targets

بالنسبة للبائعين الذين يشغّلون قنوات بيع متعددة (Trendyol + Hepsiburada + Çiçeksepeti + متجرهم الخاص)، فإن البنية العقلانية الوحيدة هي مخزون رئيسي في Zunapro يدفع إلى كل سوق مستهدف. تشغّل حزمة إنتاج Zunapro لعام 2026 مهمة cron كل 15 دقيقة إضافةً إلى دفع قائم على الأحداث: يُطلق أي تغيير في مخزون المخزون الرئيسي دفعة price-and-inventory فورية إلى Trendyol، بينما تضمن مهمة الـ cron الاتّساق النهائي لأي دفعة تسرّبت. تُطابَق الـ SKU حسب الباركود (أساسي) أو stockCode (احتياطي) — وليس أبداً حسب معرّف المنتج الداخلي لـ Trendyol، الذي قد يتغيّر عند إعادة مطابقة الفئات.

قواعد ضريبة القيمة المضافة وعرض السعر

أسعار Trendyol شاملة لضريبة القيمة المضافة. نظام ضريبة القيمة المضافة (KDV) في تركيا لعام 2026 هو 20% قياسي، و10% مخفّض (الأغذية والكتب والأدوية والسلع الأساسية) و1% خاص (المواد الغذائية الأساسية وبعض المنتجات الزراعية). يحدّد البائع حقل vatRate لكل منتج وهو مسؤول عن اختيار المعدّل الصحيح؛ وتظهر الأخطاء لاحقاً كرفض للفاتورة الإلكترونية من قبل GİB، وهو أمر مكلف لمعالجته.

Trendyol Fast Sale ومزامنة الحملات

الحملات الرائدة لـ Trendyol — Trendyol Fast Sale (Hızlı Satış)، وTrendyol Week، وÇarşamba Pazarı (سوق الأربعاء) — هي حملات ذات أهلية إلزامية تعزّز ظهور القوائم لكنها تحمل عمولة حملة إضافية بنسبة 1–3%. يُدخل البائعون الـ SKU في الحملات عبر POST /sapigw/suppliers/{id}/products/campaigns مع تجاوزات لسعر الخصم؛ ويتحقّق Zunapro تلقائياً من الحدود الدنيا لأسعار الحملات مقابل قواعد هامش المخزون الرئيسي لديك لمنع الالتزامات بسعر أقل من التكلفة.

6. بديل XML / CSV — متى (ومتى لا) تستخدمه

نموذج سحب XML

يدعم Trendyol نموذج تغذية XML كبديل لتدفّق REST POST. يستضيف البائع ملف XML على عنوان URL عام بروتوكول HTTPS يصف الكتالوج؛ ويسحبه Trendyol بوتيرة قابلة للتهيئة (عادةً كل 1–4 ساعات). مخطط XML منشور في لوحة Partner ويعكس شكل كائن المنتج في نقطة نهاية REST — barcode و title و brandId و categoryId و attributes و images والسعر والمخزون.

يُدعَم النمط نفسه عبر CSV (صف واحد لكل SKU) للبائعين الذين يصدّر نظام ERP لديهم CSV بشكل أكثر طبيعية من XML.

مقارنة: REST API مقابل XML / CSV

متى يكون XML / CSV هو الخيار الصحيح فعلاً

• نظام ERP قديم بلا قدرة HTTP-client يصدّر أصلاً XML / CSV ليلياً
• كتالوجات بطيئة التغيّر (أقل من 500 SKU، تغييرات سعر أسبوعية، إضافات كتالوج شهرية)
• الترحيل الأولي من سوق آخر حيث يُسرّع تصدير CSV لمرة واحدة المزامنة الأولى

لكل ما عدا ذلك — webhooks الطلبات، والمخزون في الوقت الفعلي، وإدخالات الحملات، ومزامنة القنوات المتعددة — يُعدّ REST المسار الوحيد الممكن في 2026. يدعم Zunapro كلا الوضعين لكنه يعتمد REST افتراضياً ويستخدم XML / CSV حصراً كمصدر ingestion من نوع ETL من أنظمة ERP القديمة.

7. Trendyol Express & FBA Trendyol

Trendyol Express — الطبقة اللوجستية

Trendyol Express هو الذراع اللوجستي المملوك بالكامل لـ Trendyol — أُطلق عام 2018 ويشغّل الآن أكثف شبكة طرود أصلية للتجارة الإلكترونية في تركيا. بحلول 2026 يغطّي أكثر من 50,000 خزانة خدمة ذاتية ونقطة استلام إلى جانب أسطول مندوبيه الخاص، واصلاً إلى 81 محافظة مع التوصيل في نفس اليوم في إسطنبول وأنقرة وإزمير وبورصة وأنطاليا، والتوصيل في اليوم التالي إلى بقية البر الرئيسي التركي. يرى المشترون شارات "Hızlı Teslimat" (توصيل سريع) على القوائم المؤهّلة، ويرجّح ترتيب بحث Trendyol هذه القوائم بقوة.

FBA Trendyol — مستودع Trendyol اللوجستي

FBA Trendyol (يُسمّى أحياناً "Trendyol Lojistik Deposu" أو "Trendyol Mağaza Plus") هو مكافئ Amazon-FBA: يشحن البائعون المخزون إلى مراكز تنفيذ Trendyol في Çorlu (المنشأة الرائدة، 250,000 متر مربع قرب إسطنبول)، وSancaktepe، وأنقرة، ويتولّى Trendyol التخزين والانتقاء والتعبئة والتوصيل الأخير عبر Trendyol Express والإرجاعات. تحمل قوائم FBA شارة مميزة "Trendyol'dan Gönderim" وتحصل على ترجيح أولوية في الظهور بالبحث.

رسوم FBA Trendyol والأهلية

• الإعداد — قدّم طلباً عبر لوحة Partner؛ يراجع الفريق التجاري لـ Trendyol الحجم الشهري وأبعاد الـ SKU وملاءمة الفئة
• رسوم التخزين — تُحتسب شهرياً لكل متر مكعب من مساحة المستودع المشغولة؛ وتتفاوت حسب الموسم (تخزين الربع الرابع أغلى)
• رسوم الانتقاء والتعبئة — سعر ثابت لكل طلب، يتفاوت حسب نطاق وزن الطرد (أقل من 500 غ، 500 غ–2 كغ، 2–5 كغ، 5–10 كغ، 10 كغ+)
• معالجة الإرجاعات — مشمولة في رسوم الانتقاء والتعبئة للإرجاعات القياسية؛ وتُفوتَر الحالات المعلَّمة على حدة

متى يكون FBA Trendyol منطقياً

نقطة التعادل لـ FBA Trendyol مقابل التنفيذ الذاتي هي نحو 800–1,200 وحدة شهرياً لكل SKU مستودع بالنسبة للمستهلكات سريعة الحركة أو الإلكترونيات أو الأزياء بسلاسل المقاسات. تحت ذلك، يكون التنفيذ الذاتي عبر تسليم Trendyol Express إضافةً إلى عقدك الخاص مع Aras / Yurtiçi / DHL أرخص عادةً. فوق ذلك، فإن زيادة التحويل من شارة "Trendyol'dan Gönderim" إضافةً إلى وعد التوصيل في نفس اليوم تفوق دائماً تقريباً تكلفة التنفيذ لكل وحدة.

8. تكامل الفاتورة الإلكترونية GİB (e-Fatura / e-Arşiv)

تكليف GİB

جعلت Gelir İdaresi Başkanlığı (GİB — إدارة الإيرادات) في تركيا الفاتورة e-Fatura إلزاميةً لأي عمل تجاري يتجاوز حجم أعماله السنوي العتبة التي تنشرها GİB (تُراجَع سنوياً؛ ~3 ملايين ليرة تركية اعتباراً من 2026)، وجعلت e-Arşiv Fatura إلزاميةً لجميع فواتير B2C التي تتجاوز ~30,000 ليرة تركية (تُراجَع سنوياً). بالنسبة لبائعي Trendyol النشطين في 2026، فإن تغطية e-Fatura / e-Arşiv شاملة فعلياً — فيجب أن يُنتج كل طلب marketplace تقريباً فاتورة إلكترونية مختومة من GİB ضمن نافذة حالة الطلب وإلا فرضت غرامات.

المكاملون الخمسة المعتمدون من GİB

يمكن للبائعين إما استخدام بوابة GİB مباشرةً (غير عملي عند أحجام الـ marketplace) أو التعاقد مع Özel Entegratör (مكامِل خاص) معتمد من GİB. اللاعبون الخمسة المهيمنون في 2026 هم:

• Logo Yazılım — أكبر مزوّد ERP تركي؛ e-Logo لإصدار الفواتير
• Mikro Yazılım — مزوّد ERP وفاتورة إلكترونية للسوق المتوسطة، قوي في قطاع الشركات الصغيرة والمتوسطة
• Uyumsoft — مكامِل مستقل بواجهة REST API متينة وأكبر قاعدة بائعي marketplace
• Foriba — مزوّد من فئة المؤسسات (استحوذت عليه Sovos عام 2019)، قوي في الصناعات المنظَّمة
• Veriban — بديل سريع النمو بأسعار تنافسية وواجهة API صديقة للمطوّرين

تدفّق الفاتورة الإلكترونية في الـ marketplace

1. Trendyol webhook: order status -> "Picking"
2. Zunapro pulls order detail (buyer name, VKN/TCKN, address, items)
3. Zunapro POSTs invoice draft to integrator (Logo/Mikro/Uyumsoft/Foriba/Veriban)
4. Integrator signs with e-Signature certificate, submits to GİB
5. GİB returns ETTN (Electronic Document Unique Number)
6. Zunapro stores ETTN, attaches PDF to Trendyol order
7. Zunapro transitions Trendyol order Picking -> Invoiced via API

الخيار العملي لعام 2026

بالنسبة للبائعين الجدد، يُعدّ Uyumsoft و Veriban الأسهل في الإعداد (تسجيل عبر الويب، واجهة REST API، بلا اعتماد on-prem). ينبغي للبائعين الذين يشغّلون أصلاً Logo أو Mikro ERP البقاء على منتج الفاتورة الإلكترونية من المورّد نفسه من أجل التسوية المحاسبية. Foriba هو الخيار للمؤسسات الكبيرة ذات تدفّقات العمل الضريبية المعقّدة. يأتي Zunapro مع جميع التكاملات الخمسة خلف شاشة تهيئة واحدة — اختر المكامِل، والصق بيانات اعتماد الواجهة، وتُفوتَر كل طلبات Trendyol تلقائياً.

9. الأخطاء الشائعة وكيفية التصميم لتفاديها

عدم تطابق الفئة

العَرَض: تُظهر نتيجة الدفعة INVALID_CATEGORY أو CATEGORY_NOT_LEAF. السبب: النشر في فئة غير طرفية، أو في فئة طرفية لا يطابق الـ SKU مجموعة سماتها. الإصلاح: انشر دائماً في الفئات الطرفية فقط (ترفض الواجهة غير الطرفية)، وتحقّق مسبقاً من السمات مقابل مجموعة required: true للفئة قبل الـ POST.

السمات الإلزامية المفقودة

العَرَض: MANDATORY_ATTRIBUTE_MISSING على SKU صالحة بخلاف ذلك. السبب: يعلّم Trendyol نحو 30% من السمات كإلزامية على أساس كل فئة (الجنس للأزياء، الضمان للإلكترونيات، إلخ). الإصلاح: خزّن مؤقتاً خريطة متطلبات السمات لكل فئة، وامنع الـ POST بناءً على الاكتمال؛ يملأ Zunapro تلقائياً من تصنيفك الرئيسي حيثما أمكن.

تأخّر مزامنة المخزون

العَرَض: يظل SKU نافد المخزون ظاهراً كمتوفّر على Trendyol لعدة دقائق، ما يسبّب البيع الزائد. السبب: دفعات price-and-inventory متّسقة نهائياً بزمن وسيط نحو 5–8 ثوانٍ، وخلال ذُرى حركة المرور (Black Friday، Trendyol Week) قد يمتد الطابور إلى 30–60 ثانية. الإصلاح: نفّذ مخزناً احتياطياً محلياً للأمان (احتفظ بآخر 1–2 وحدة كمخزن احتياطي نافد المخزون لكل SKU عالي السرعة)، وادفع تغييرات المخزون بشكل متزامن عند حدث تأكيد الطلب، وليس فقط عند الـ cron.

الـ Webhooks المفقودة

العَرَض: لا يصل webhook طلب أبداً أو يصل متأخراً بساعات. السبب: عادةً تغيير في جدار الحماية من جهة البائع، أو تجديد شهادة TLS كسر عنوان webhook، أو انقطاع قصير تجاوز ميزانية 5 محاولات إعادة لدى Trendyol. الإصلاح: شغّل دائماً عملية سحب مطابقة موازية كل 5 دقائق مقابل /sapigw/suppliers/{id}/orders?status=Created&startDate=...؛ يفعل Zunapro ذلك افتراضياً ويدمج بطريقة idempotent أي طلب مسحوب سلّمه الـ webhook أيضاً.

قوائم متعددة، باركود واحد (Mükerrer Listing)

العَرَض: يظهر SKU واحد كقوائم Trendyol متعددة، ويُنقَص المخزون بشكل مختلف في كل منها. السبب: عمليات دمج تاريخية، أو إدخالات باركود مكرّرة، أو fan-out لمتاجر متعددة للمنتج نفسه. الإصلاح: تطوي سياسة إزالة التكرار MIN-المخزون لدى Zunapro (المُدخَلة في تحديث الإنتاج بتاريخ 2026-06-06) جميع القوائم المكرّرة تحت باركود واحد وتتتبّع قيمة المخزون الدنيا عبرها، ما يمنع الكارثة الكلاسيكية "بيع مرتين على قائمتين، ووعد بتسليم واحد".

10. عمولة Trendyol ورسوم البائع 2026

جدول عمولات Trendyol لعام 2026 متدرّج حسب الفئة، بثلاثة نطاقات عريضة وبلا رسم ثابت لكل صنف. تضيف المشاركة في الحملات (Trendyol Fast Sale، Trendyol Week، Çarşamba Pazarı) نسبة إضافية 1–3% فوق معدّل الفئة.

رسوم البائع / الاشتراك

لا يفرض Trendyol اشتراكاً شهرياً. لا توجد فئة "Professional Seller" على غرار Amazon. يدفع البائعون:

• عمولة الفئة على كل عملية بيع (8–22%)
• عمولة الحملة عند المشاركة في Trendyol Fast Sale / Week (‏+1–3%)
• Trendyol Express رسم لكل شحنة (يدفعه المشتري، لكنه يمرّ عبر حساب الأرباح والخسائر للبائع)
• FBA Trendyol تخزين + انتقاء وتعبئة (فقط إذا كان مسجّلاً)
• Trendyol Ads بنظام CPC (اختياري، يتحكّم به البائع)

دورة الدفع

يُدفَع للبائعين القياسيين على دورة T+14 (14 يوماً بعد تسليم الطلب)، وتُخفَّض إلى T+7 للبائعين ذوي درجة البائع من الفئة العليا. تُحتجز الطلبات المتنازع عليها، والإرجاعات ضمن نافذة الـ 14 يوماً، وعمليات رد المبالغ (chargebacks) مقابل الدفعة. تصل المدفوعات إلى TR IBAN المسجّل.

الإطار القانوني التركي 2026 — ما يجب أن يعرفه بائعو الـ marketplace

KDV (ضريبة القيمة المضافة) ونطاقات معدّل KDV

ضريبة القيمة المضافة في تركيا — KDV (Katma Değer Vergisi) — تعمل بثلاثة معدّلات في 2026: 20% قياسي، و10% مخفّض (الأغذية والكتب والأدوية والضيافة)، و1% خاص (المواد الغذائية الأساسية والزراعية). يسجّل بائعو الـ marketplace المقيمون في تركيا لـ KDV عبر مكتب الضرائب المحلي لديهم؛ ويستخدم البائعون العابرون للحدود فوق عتبة الخدمات الرقمية نظام KDV لغير المقيمين. يجب أن يطابق حقل vatRate في كل POST منتج على Trendyol المعدّل الصحيح قانونياً — إذ تنتشر الأخطاء إلى الفواتير الإلكترونية وقد تتطلّب إقرارات تصحيح.

e-Fatura / e-Arşiv (إلزامي من GİB)

سبق تغطيته بالتفصيل في القسم 8. الخلاصة لعام 2026: يُنتج كل طلب marketplace فاتورة إلكترونية مختومة من GİB (e-Fatura لـ B2B / مستلمي e-Fatura المسجّلين، e-Arşiv لـ B2C). البائع مسؤول عن الإصدار ضمن نافذة حالة الطلب. الإصدار اليدوي غير عملي عند أحجام الـ marketplace — اختر أحد المكاملين الخمسة لدى GİB وأتمِت العملية.

KVKK — النظام التركي المماثل لـ GDPR

KVKK (Kişisel Verilerin Korunması Kanunu — القانون رقم 6698) هو نظام حماية البيانات في تركيا، المشابه هيكلياً لـ GDPR والذي تنفّذه KVKK Kurumu. تتولّى أسواق الـ marketplace الموافقة والمعالجة من جهة المشتري، لكن البائعين يبقون مسؤولين مشتركين عن أي تواصل خدمة عملاء مباشر أو تسويق أو تواصل بعد الشراء. تتراوح غرامات عدم الامتثال من 60 ألف ليرة تركية إلى أكثر من 3 ملايين ليرة تركية حسب فئة المخالفة.

ETBİS — سجل التجارة الإلكترونية الإلزامي

ETBİS (Elektronik Ticaret Bilgi Sistemi) هو السجل الإلزامي لوزارة التجارة لأي مشغّل تجارة إلكترونية في تركيا، وهو ساري المفعول منذ 2018. يجب على البائعين التسجيل قبل الإدراج على Trendyol والإبلاغ عن أحجام المعاملات السنوية. تغذّي بيانات ETBİS إنفاذ حماية المستهلك، وفحص مكافحة الاحتيال، وتحليلات المنافسة.

حماية المستهلك — حق الانسحاب خلال 14 يوماً، ضمان لمدة سنتين

• حق الانسحاب خلال 14 يوماً — يجوز للمستهلكين الأتراك إرجاع أي منتج مشترى عن بُعد خلال 14 يوماً، بلا إبداء سبب (Tüketicinin Korunması Hakkında Kanun، القانون رقم 6502)
• ضمان قانوني لمدة سنتين — إلزامي في مبيعات B2C، ومستقل عن أي ضمان من الشركة المصنّعة
• معلومات المنتج الإلزامية باللغة التركية — العنوان والوصف والضمان وسياسة الإرجاع جميعها بالتركية

الخدمات اللوجستية & الشحن في تركيا — Trendyol Express أولاً

Trendyol Express — الطبقة المهيمنة

Trendyol Express هو الناقل الافتراضي في نحو أكثر من 70% من طلبات Trendyol في 2026. يرى المشتري شحناً مجانياً أو منخفض التكلفة مع توصيل في نفس اليوم أو في اليوم التالي في المدن الكبرى، إضافةً إلى أكثر من 50,000 خزانة خدمة ذاتية (Trendyol Hızlı Teslimat Noktaları) حيث يستلم المتسوّقون الطرود على مدار الساعة طوال الأسبوع. يسلّم البائعون الطرود إما إلى نقطة تجميع Trendyol Express أو يجدولون استلام مندوب؛ ويحمل قسيمة التوجيه باركود Trendyol Express المُحصّل من واجهة ملصق الطلب.

النواقل المتكاملة الأخرى

• Yurtiçi Kargo — ناقل تركي عريق، بشبكة B2C و B2B قوية، متكامل لطلبات Trendyol
• Aras Kargo — منافس بتغطية أناضولية قوية، يُستخدم كثيراً للطلبات ذاتية التنفيذ على Trendyol
• DHL Kargo — ثالث أكبر ناقل تركي، حل احتياطي شائع للبائعين ذوي الحجم المرتفع
• PTT Kargo — المشغّل البريدي الحكومي، الأوسع وصولاً ريفياً، باتفاقيات مستوى خدمة أبطأ
• Sürat Kargo — لاعب إقليمي، تنافسي في منطقتي مرمرة وبحر إيجه

حزمة الشحن العملية لعام 2026

الحزمة العملية لعام 2026 لبائع Trendyol: Trendyol Express كخيار افتراضي (هو ما يتوقّعه المشترون)، وYurtiçi أو Aras كحل احتياطي من جهة البائع للطلبات ذاتية التنفيذ التي تفوّت نافذة استلام Trendyol Express، وPTT Kargo للرموز البريدية الريفية حصراً حيث لا يكون أي ناقل آخر اقتصادياً، وFBA Trendyol للـ SKU سريعة الحركة بمجرد أن يبرّر الحجم التزام التخزين.

كيف تبدأ البيع على Trendyol — إعداد من 5 خطوات

1. حساب بائع Trendyol

قدّم طلباً على partner.trendyol.com. زوّد بـ VKN و Trade Registry Gazette ونموذج التوقيع وإيصال تسجيل ETBİS و TR IBAN. الموافقة خلال 2–5 أيام عمل.

2. ETBİS + التسجيل الضريبي

سجّل الكيان القانوني في ETBİS عبر بوابة وزارة التجارة (etbis.gtb.gov.tr) وأكّد تسجيل KDV لدى مكتب الضرائب المحلي. أما البائعون الأجانب الذين يعملون عبر Trendyol International فإما يعيّنون ممثّلاً تركياً أو يستخدمون برنامج Trendyol للاستيراد كمستورد مسجّل.

3. أنشئ API Key + Secret

من لوحة Partner ← إعدادات الحساب ← معلومات التكامل، انقر على "Create API Key". انسخ API Key (40 حرفاً) و API Secret (40 حرفاً) فوراً — فهما يُعرضان مرةً واحدة فقط. الصقهما في بطاقة Trendyol لدى Zunapro حيث يُخزَّنان مشفَّرَين بـ AES-256 ومقنَّعَين.

4. الاتصال عبر لوحة Zunapro

1. سجّل الدخول إلى Zunapro وافتح وحدة تركيا
2. الصق Supplier ID + API Key + API Secret في بطاقة تكامل Trendyol
3. شغّل فحص السلامة التلقائي (بيانات الاعتماد، نقطة نهاية addresses، معلومات المورّد)
4. أكّد مطابقات الفئات المقترحة بالتعلّم الآلي لأفضل 100 SKU لديك
5. اختر مكامِل الفاتورة الإلكترونية (Logo أو Mikro أو Uyumsoft أو Foriba أو Veriban) والصق بيانات اعتماده
6. فعّل "Trendyol Express" + "FBA Trendyol" (إن كنت مسجّلاً)

5. شغّل طلب اختبار

ضع 3–5 طلبات stage مقابل stageapi.trendyol.com لتمرين تدفّقات الانتقاء والتعبئة، وطباعة الملصق، وانتقال الحالة، والاسترداد من طرف إلى طرف. بمجرد أن يصبح كل شيء أخضر، حوّل التكامل إلى الإنتاج بضغطة زر واحدة. تكتمل أول مزامنة إنتاج لكتالوج يضم 5,000 SKU في نحو 30–60 دقيقة نظراً لحدود معدّل Trendyol.

مسارات التكامل الثلاثة مع Trendyol — مقارنةً

قبل الالتزام ببنية تكامل، يساعد مقارنة المسارات المشروعة الثلاثة جنباً إلى جنب.

الأسئلة الشائعة حول التكامل مع Trendyol 2026