تكامل PttAvm: واجهة API وXML والتنفيذ اللوجستي وإدارة موحّدة للمتجر

نبذة عن PttAvm: التأسيس والملكية ومكانتها في السوق

التأسيس والتاريخ (1840 – اليوم)

PTT (Posta ve Telgraf Teşkilatı — هيئة البريد والبرق التركية) تأسست عام 1840 في العهد العثماني وهي من أقدم هيئات البريد في العالم. وبعد تحديثها في العهد الجمهوري، تحولت PTT إلى شركة مساهمة عام 2013. PttAvm أُطلقت عام 2017 ضمن مبادرة التحول الرقميلدى PTT؛ وكان هدفها تمكين المنشآت الصغيرة والمتوسطة والمنتجين المحليين ورائدات الأعمال وأصحاب منتجات المؤشرات الجغرافية من ممارسة التجارة الإلكترونية بعمولات منخفضة وتحت ضمان الدولة.

بعد طفرة التجارة الإلكترونية التي أعقبت جائحة ما بعد عام 2020، نما حجم PttAvm بسرعة. واليوم تطورت PttAvm إلى منظومة تجارة إلكترونية مدعومة من الدولة تضم السوق الإلكتروني (3P)، وشبكة التوصيل PTT Kargo ، وخدمة التنفيذ اللوجستي PTT Logistics ، و واجهة المنتج المحلي، وبرنامجي منتجات المؤشرات الجغرافية و رائدات الأعمال .

هيكل ملكية PttAvm (2025)

• PTT Anonim Şirketi (شركة PTT المساهمة) — المساهم الوحيد (100%، كيان مملوك للدولة)
• وزارة النقل والبنية التحتية في الجمهورية التركية — المساهم الوحيد في شركة PTT المساهمة (100%)
• صندوق الثروة التركي (Türkiye Wealth Fund) — تنسيق استراتيجي للأصول العامة
• كيان مملوك للدولة — شراكات بروتوكولية رسمية مع KOSGEB (هيئة المنشآت الصغيرة والمتوسطة في تركيا) وTarım Kredi (تعاونية الائتمان الزراعي) ومكتب البراءات والعلامات التجارية التركي

المكانة في التجارة الإلكترونية التركية

اعتبارًا من عام 2024 تُعد PttAvm السوق الإلكتروني المدعوم من الدولة الأكثر موثوقية في تركيا. وعلى خلاف أسواق القطاع الخاص مثل Trendyol وHepsiburada تتميز بالدعم الحكومي والعمولات المنخفضة والسياسات الحامية للمنشآت الصغيرة والمتوسطة. وتحتل مكانة لا نظير لها خصوصًا في منظومات المؤشرات الجغرافية والمنتجين المحليين ورائدات الأعمال وKOSGEB . وبفضل شبكة PTT التي تضم أكثر من 17,000 مكتب بريد، توفر تغطية توصيل في جميع ولايات تركيا الـ 81.

حجم مبيعات PttAvm ونطاقها (بيانات 2024–2025)

منذ إطلاقها عام 2017 — وبتسارع خاص بفعل التحول الرقمي في فترة الجائحة — نمت PttAvm بنسبة 50–80% سنويًا. الدعم الحكومي والعمولات المنخفضة رفعا عدد البائعين بسرعة.

السنة	GMV (بالليرة التركية)	الطلبات	العملاء النشطون	البائعون النشطون
2020	~500 مليون ₺	3 ملايين	1.5 مليون	5 آلاف
2022	~2 مليار ₺	12 مليونًا	3 ملايين	12 ألفًا
2024	~4.5 مليار ₺	28 مليونًا	أكثر من 4 ملايين	أكثر من 20 ألفًا
2025 (متوقع)	~6.5 مليار ₺	42 مليونًا	5.5 مليون	28 ألفًا

وقد كان هذا النمو مدفوعًا بشبكة PTT Kargo التي تغطي 81 ولاية، والعمولات المنخفضة المدعومة حكوميًا، وبرامج واجهة المنتج المحلي, ومنتجات المؤشرات الجغرافية و رائدات الأعمال المخصصة. أن تصبح بائعًا على PttAvm يمثل أقل مسار عمولة وأكثر مسارات التجارة الإلكترونية المدعومة من الدولة موثوقية — خصوصًا للمنشآت الصغيرة والمتوسطة والمنتجين المحليين.

فتح متجر على PttAvm (القواعد الحالية لعام 2026)

1. المتطلبات القانونية والمالية

لكي تصبح بائعًا على PttAvm يجب أن يكون لديك تسجيل ضريبي نشط في تركيا. يقبل أي شكل: منشأة فردية أو شركة محدودة أو مساهمة؛ لكن يجب أن تكون مكلفًا بالفاتورة الإلكترونية وقادرًا على إصدار فواتير الأرشيف الإلكتروني. قنوات تقديم مخصصة للمنشآت المسجلة في برامج KOSGEB (هيئة المنشآت الصغيرة والمتوسطة في تركيا) وTarım Kredi (تعاونية الائتمان الزراعي) والمؤشرات الجغرافية.

• الشهادة الضريبية (للسنة الحالية)
• الرقم الضريبي ورقم الهوية التركية (للمنشآت الفردية)
• جريدة السجل التجاري (للشركات المحدودة والمساهمة)
• تعميم التوقيع
• حساب بنكي (IBAN) — تُحوَّل المستحقات إلى هذا الحساب
• مزوّد فاتورة إلكترونية / أرشيف إلكتروني معتمد من GİB أو بوابة GİB (هيئة الإيرادات التركية)
• شهادة العلامة التجارية (للفئات المحمية مثل مستحضرات التجميل والأغذية والألعاب)
• تسجيل المؤشر الجغرافي (من مكتب البراءات والعلامات التجارية التركي لمنتجات مثل Antep Fıstığı وسجاد Hereke وغيرها)

2. التقديم عبر لوحة بائع PttAvm

تقدّم طلبك عبر satici.pttavm.com. مدة الموافقة هي 5–7 أيام عمل بسبب إجراءات الجهات الحكومية (أطول قليلًا من أسواق القطاع الخاص؛ لكن مزايا ما بعد الموافقة أكبر بكثير). وبعد الموافقة تحصل على معرّف المتجرو مفتاح API (apiKey) و سر API (apiSecret) — وكلها ضرورية للتكامل.

📥 طلب البائع الرسمي في PttAvm satici.pttavm.com — تقديم مجاني، موافقة خلال 5–7 أيام عمل →

3. رفع المنتجات وقواعد المحتوى

تطبّق PttAvm قواعد محتوى متوافقة مع معايير التجارة الإلكترونية التركية على قوائم المنتجات:

• العنوان: من 50 إلى 150 حرفًا، العلامة التجارية + اسم المنتج + الميزة الرئيسية
• الصورة: خلفية بيضاء، 1000×1000 بكسل كحد أدنى، حتى 8 صور، بلا علامة مائية أو نص
• الوصف: يدعم HTML، 200 حرف كحد أدنى
• ربط الفئات: معرّف فئة PttAvm + الخصائص (اللون والمقاس والمادة وبلد المنشأ)
• الباركود (GTIN/EAN): حيثما أمكن — يزيد سرعة المطابقة كثيرًا
• وسوم المنتج المحلي / المؤشر الجغرافي: أهلية الحصول على الشارة للمنتجات المؤهلة، مع عمولات أقل

عمولات PttAvm (2026)

تتراوح عمولات PttAvm لعام 2026 من 3% إلى 18% بحسب الفئة — وهي أقل بكثير من Trendyol وHepsiburada بفضل الدعم الحكومي. ضريبة القيمة المضافة 20%ورسوم خدمة وتكلفة PTT Kargo تُضاف إلى العمولة. ويحصل المنتجون المسجلون في برامج KOSGEB وTarım Kredi والمؤشرات الجغرافية على خصومات إضافية على العمولة.

معادلة صافي الأرباح: سعر البيع − العمولة − ضريبة القيمة المضافة − رسوم الخدمة − رسوم PTT Kargo − تكلفة المنتج = صافي الربح. تحسب وحدة التسعير في Zunapro هذا تلقائيًا لكل منتج ولكل فئة؛ كما تأخذ في الحسبان خصومات حوافز KOSGEB والمؤشرات الجغرافية والمنتج المحلي.

تكامل PttAvm API — التفاصيل التقنية

تُعد واجهة PttAvm API واجهة RESTful تتيح للبائعين مزامنة بيانات المنتجات والمخزون والطلبات والأسعار والشحن والمرتجعات برمجيًا مع نظام PttAvm. عنوان API الأساسي: https://ws.pttavm.com/api/v1/

تفويض API

تستخدم واجهة PttAvm API مخطط توقيع قائمًا على مفتاح API + السر (HMAC SHA-256) . يتضمن كل طلب طابعًا زمنيًا + توقيع HMAC SHA-256 يُرسل في ترويسة Authorization . لا توجد مدة انتهاء للرمز؛ لكن يُنصح بتدوير بيانات الاعتماد كل 6–12 شهرًا لأسباب أمنية. الوثائق الرسمية: ws.pttavm.com/docs.

الفئات الرئيسية لنقاط النهاية

• Products API — إنشاء المنتجات وتحديثها وربط الفئات والاستعلام عن شارات المنتج المحلي / المؤشر الجغرافي
• Stock API — مزامنة المخزون والأسعار (نقطة نهاية مجمّعة، بحد أقصى 100 منتج لكل طلب)
• Orders API — عرض الطلبات وتحديث حالاتها وإنشاء الطرود
• Categories API — شجرة فئات PttAvm وقوالب الخصائص وفئات الحوافز
• Cargo API — إنشاء ملصقات PTT Kargo ومزامنة أرقام التتبع
• Claims API — الاستعلام عن طلبات الإرجاع وقبولها أو رفضها
• Webhooks — استدعاءات فورية عند تغيّر الطلبات والمخزون

حد معدل الطلبات ومعالجة الأخطاء

حد معدل الطلبات في PttAvm API هو 40 طلبًا في الدقيقة لكل بائع. وعند تجاوزه تُعيد الواجهة 429 Too Many Requests. أكثر رموز الأخطاء شيوعًا: 400 (بيانات منتج غير صالحة)، 401 (خطأ في توقيع HMAC)، 404 (لم يتم العثور على الفئة/الباركود)، 500 (خطأ في نظام PttAvm — أعد المحاولة). ويدير موصّل Zunapro هذه الأخطاء تلقائيًا عبر إعادة المحاولة بتراجع أسّي وقائمة الرسائل الميتة (dead-letter queue).

تكامل PttAvm XML — نقل المنتجات بالجملة

تكامل PttAvm XML هو نظام يقرأ تلقائيًا كتالوج المنتجات بصيغة XML من مورّدك أو من موقعك التجاري وينقله إلى لوحة بائع PttAvm. ويتوافق مخطط XML في PttAvm مع معايير التجارة الإلكترونية التركية. وكبديل عن إدخال المنتجات يدويًا يتيح لك رفع آلاف المنتجات خلال دقائق.

بنية مخطط XML (المتوافق مع PttAvm)

الحقول الأساسية في XML المرفوع إلى PttAvm:

• productMainId — رمز المنتج الرئيسي (يجمع المتغيرات)
• brand, title, productCode, stockCode, barcode
• categoryId (فئة PttAvm)، attributes (اللون والمقاس والمادة وبلد المنشأ)
• quantity (المخزون)، listPrice, salePrice, vatRate
• cargoCompanyId (PTT Kargo افتراضيًا)، shipmentAddressId
• geographicalIndication (رمز المؤشر الجغرافي — إن وُجد)
• domesticProducer (علامة المنتج المحلي)، womanEntrepreneur (علامة رائدة الأعمال)
• images (من 1 إلى 8 روابط)، description (HTML)

النقل من XML المورّد إلى PttAvm

يشارك معظم تجار الجملة والمورّدين والمنتجين المحليين في تركيا (خصوصًا المنشآت الصغيرة والمتوسطة في ولايات الأناضول ومنتجو منتجات المؤشرات الجغرافية) كتالوجات منتجاتهم بصيغة XML. وتقوم وحدة XML من Zunapro بما يلي:

1. قراءة رابط XML الخاص بالمورّد (مهمة cron كل ساعة/يوميًا)
2. تعلّم ربط الفئات (أول ربط يدوي ثم تلقائي)
3. توحيد الخصائص مثل العلامة التجارية والمادة وبلد المنشأ والمقاس
4. إسناد شارات المنتج المحلي / المؤشر الجغرافي تلقائيًا
5. إضافة هامش الربح + العمولة إلى السعر (بما في ذلك خصومات الحوافز الحكومية)
6. متابعة المخزون — تعطيل المنتجات التي لم تعد متوفرة لدى المورّد تلقائيًا
7. الرفع إلى PttAvm عبر API

التنفيذ اللوجستي في PttAvm (PTT Logistics) — حل لوجستي مدعوم من الدولة

التنفيذ اللوجستي من PTT Logistics هو خدمة مبنية على البنية التحتية البريدية والشحن العريقة لدى PTT. فبعد أن تسلّم منتجاتك إلى شبكة PTT التي تضم أكثر من 17,000 مكتب بريدتتولى PTT بالكامل التخزين والتغليف والتوصيل الأخير عبر PTT Kargo وإدارة المرتجعات. وقد توسعت هذه الخدمة عام 2024، وتقدم لبائعي PttAvm باقة مخفضة للتخزين + الشحن.

مزايا التنفيذ اللوجستي من PTT Logistics

• توصيل كامل إلى 81 ولاية — PTT Kargo + شبكة تضم أكثر من 17,000 مكتب بريد
• ضمان البنية التحتية الحكومية — ضمان هيئة البريد والبرق التركية
• خدمة العملاء تتولاها PTT — المرتجعات والاستبدال والشكاوى
• علامة "تم التسليم بضمان PTT" — ترفع معدل التحويل، خصوصًا في أسواق الولايات والمناطق الريفية
• عبء تشغيلي معدوم — لا تتولى التغليف ولا الشحن
• باقة مخفضة — تسعير مدعوم حكوميًا حصري لبائعي PttAvm

تكاليف التنفيذ اللوجستي من PTT Logistics (2025، تقريبية)

• التخزين: ₺60–120 لكل م³ شهريًا (مدعومة حكوميًا، أقل من القطاع الخاص)
• معالجة الطلبات: ₺4–10 لكل قطعة
• معالجة المرتجعات: ₺6–12 لكل مرتجع
• العمولة: عمولة PttAvm القياسية + رسوم تنفيذ لوجستي 0.5–1.5%

التنفيذ اللوجستي من PTT Logistics مجدٍ من حيث التكلفة للبائعين الذين يعالجون أكثر من 300 طلب شهريًا. وقد يفضل البائعون ذوو الحجم المنخفض الشحن مباشرة من مستودعهم عبر PTT Kargo.

تقييم أداء متجر PttAvm ومعدلات الإلغاء

تمنح PttAvm كل بائع تقييم متجر على مقياس من 1 إلى 10؛ ويؤثر هذا التقييم مباشرة على ظهور المتجر في الواجهة. كما تعزز مكانة المتجر شارات "المنتج المحلي", "رائدات الأعمال" و "المؤشر الجغرافي" . وأهم العوامل التي تخفض التقييم:

• معدل الإلغاء — الإلغاء بسبب نفاد المخزون هو أكبر عقوبة؛ وتجاوز 3% يطلق تحذيرًا، وتجاوز 6% يعرّض المتجر لخطر الإغلاق
• التأخر في الشحن — الطلبات التي لم تُسلَّم إلى PTT Kargo خلال مهلة التجهيز
• معدل المرتجعات — مرتجعات فوق الحدود المتوقعة
• تقييمات العملاء — يجب أن تبقى فوق 4.0 نجوم
• زمن الاستجابة — يجب الرد على الرسائل خلال 24 ساعة (معيار السوق الحكومي)

مع المزامنة التلقائية للمخزون من Zunaproتخفض خطر الإلغاء بنسبة 90%؛ فالمنتجات المباعة على موقعك أو في مستودعك أو في سوق إلكتروني آخر تُعطَّل على PttAvm فورًا.

الإعلانات والحوافز الحكومية والتسعير الذكي في PttAvm

منصات الإعلان في PttAvm

• منتجات PttAvm الإعلانية (Sponsored Products) — مواضع متقدمة في نتائج البحث (بنظام CPC، ليرة تركية لكل نقرة)
• واجهة المنتج المحلي — مساحة إعلانية مخصصة للمنتجات الحاملة لشارة المنتج المحلي
• واجهة المؤشرات الجغرافية — رعاية مخصصة لمنتجات المؤشرات الجغرافية
• واجهة متاجر رائدات الأعمال — لافتة مخصصة للبائعين الحاصلين على شهادة رائدة أعمال

الحوافز والبرامج الحكومية

• KOSGEB — برامج دعم المنشآت الصغيرة والمتوسطة عبر PttAvm مع خصومات خاصة على العمولة
• تعاونيات Tarım Kredi — عمولات مخفضة للمزارعين والمنتجين الزراعيين
• مكتب البراءات التركي — المؤشر الجغرافي — فئة مخصصة وعمولات أقل لمنتجات المؤشرات الجغرافية المسجلة رسميًا مثل Antep Fıstığı (فستق عنتاب) وErzurum Cağ Kebabı (كباب جاغ من أرضروم) وÇorum Leblebisi (حمص Çorum المحمص)
• شهادة رائدة الأعمال — برنامج مخصص لرائدات الأعمال الحاصلات على شهادة من KAGİDER أو KOSGEB
• شهادة المنتج المحلي — خصومات على العمولة للمنتجات الحاملة لشارة المنتج المحلي المعتمدة من TOBB

التسعير الذكي (Repricer)

توجد منافسة سعرية على PttAvm، لكنها ليست بحدة Trendyol لأن مجموعة البائعين أكثر انتقائية. تضبط وحدة Zunapro لإعادة التسعير الأسعار تلقائيًا مقابل منافسيك خلال ثوانٍ — ولا تنزل أبدًا عن الحد الأدنى لربحك، وتأخذ في الحسبان خصومات الحوافز الحكومية.

تكامل الفاتورة الإلكترونية والأرشيف الإلكتروني في PttAvm (الامتثال لـ GİB)

يجب على جميع البائعين على PttAvm إصدار فواتير الأرشيف الإلكتروني لعملاء B2C و فواتير إلكترونية لعملاء B2B (بحسب لوائح GİB (هيئة الإيرادات التركية)). وإصدار الفواتير يدويًا غير عملي عند تجاوز 50 طلبًا يوميًا.

وحدة الفاتورة الإلكترونية من Zunapro:

• تصدر فاتورة الأرشيف الإلكتروني / الفاتورة الإلكترونية تلقائيًا لحظة وصول بيانات طلب PttAvm
• تتكامل مع المزوّدين الخارجيين المعتمدين من GİB (Logo وMikro وUyumsoft وForiba وVeriban وغيرها)
• فواتير مرتجعات تلقائية عند الإرجاع
• تقارير شهرية لـ KDV1 وKDV2 (ضريبة القيمة المضافة)
• إرسال نسخة PDF من فاتورة الأرشيف الإلكتروني تلقائيًا إلى العملاء عبر البريد الإلكتروني والرسائل القصيرة

تكامل الشحن في PttAvm — PTT Kargo + بدائل

تُشحن طلبات PttAvm افتراضيًا عبر PTT Kargo (شركة الشحن التابعة لـ PTT، وهي أوسع شبكة شحن في تركيا بتغطية 81 ولاية + أكثر من 17,000 مكتب بريد). ويمكن أيضًا ربط شركات شحن بديلة: Yurtiçi Kargo, Aras Kargo, DHL Kargo, Sürat Kargo.

تختار وحدة تعدد شركات الشحن من Zunapro تلقائيًا شركة الشحن الأنسب بحسب وزن الطلب ومدينة الوجهة وتفضيل العميل؛ وتطبع الملصقات وتعيد أرقام التتبع إلى PttAvm تلقائيًا. التغطية التي توفرها PTT Kargo في الولايات والمناطق الريفية لا نظير لها، خصوصًا للتوصيل إلى القرى والبلدات خارج مراكز الولايات الـ 81.

إدارة المرتجعات وخدمة العملاء في PttAvm

في التجارة الإلكترونية التركية تبلغ معدلات المرتجعات 25–35% في الأزياء، 4–8% في الإلكترونيات، 8–12% في المنزل والمعيشة و 2–4% في الأغذية (خصوصًا في منتجات المؤشرات الجغرافية). وإذا لم تُدَر عملية الإرجاع بشكل صحيح ينخفض تقييم المتجر.

عملية الإرجاع القياسية في PttAvm:

1. يفتح العميل طلب إرجاع من لوحة PttAvm (خلال 14 يومًا من التسليم)
2. تستلم PTT Kargo المنتج مجانًا (خلال 1–3 أيام عمل؛ ويمكن أيضًا تسليمه في مكتب بريد)
3. يفحص مستودع PTT المرتجع ويحوّله إلى البائع أو يقبل الإرجاع
4. يوافق البائع على الإرجاع أو يرفضه خلال 1–3 أيام عمل
5. في حال الموافقة يُردّ مبلغ العميل إلى محفظة PttAvm

تتابع وحدة المرتجعات من Zunapro كل هذه الخطوات تلقائيًا؛ وترسل إشعارات إلى لوحة البائع وتصدر فاتورة مرتجع تلقائيًا لإرجاعات العملاء.

تكامل PttAvm مع Zunapro — إعداد في 4 خطوات (10 دقائق)

1. أدخل بيانات متجرك على PttAvm — في لوحة Zunapro انتقل إلى الأسواق الإلكترونية ← PttAvm وأدخل معرّف المتجر ومفتاح API وسر API.
2. اربط موقعك الحالي — موصّلات جاهزة لـ Shopify وWooCommerce وOpenCart وİkas وTicimax وPrestaShop وMagento. أدخل رابط API + مفتاح الوصول.
3. معالج ربط الفئات — اربط فئات موقعك بفئات PttAvm بالسحب والإفلات. وتُسند شارات المنتج المحلي / المؤشر الجغرافي تلقائيًا.
4. المزامنة الأولية — المنتجات والمخزون والأسعار والطلبات وPTT Kargo — كلها تُزامَن تلقائيًا. وخلال 10 دقائق يمكن إدارة متجرك على PttAvm من لوحة Zunapro.

الأسئلة الشائعة حول تكامل PttAvm (FAQ)