واجهة برمجة التطبيقات لشركاء Pochtoy.com: أتمتة الشحن من الولايات المتحدة

تتيح واجهة برمجة التطبيقات API من Pochtoy.com إطلاق متجر أو بوت Telegram مع التوصيل من الولايات المتحدة بدون معالجة الطلبات يدويًا. White-label، واحتساب التعريفات في الوقت الفعلي، والتتبع التلقائي - يستغرق التكامل من 4 إلى 12 ساعة من التطوير.

02.05.2026

1182 views

متجر أو بوت تليجرام بدون مستودع في الولايات المتحدة

تتم تجارة التجزئة لمنتجات من أمريكا - أحذية Nike الرياضية، فيتامينات iHerb، ملابس Levi's، العطور، أجهزة Apple - دون وجود مستودعات خاصة في الولايات المتحدة. يتولى الوسيط دور المستودع: يستلم المشتريات، يعبئها ويرسلها إلى العملاء. يمكن أن تكون قناة المبيعات أي شيء - من متجر إلكتروني تقليدي إلى بوت تليجرام.

تتلخص المعالجة اليدوية للطلب الواحد في مجموعة متطابقة من الإجراءات: الدخول إلى حساب الوسيط، إدخال بيانات العميل، انتظار الرقم التتبعي، إعادة إرسال الرقم التتبعي للعميل. عند 20 طلباً يومياً تستغرق هذه الروتين 3-4 ساعات. يصبح البوت الذي يتلقى مئات الطلبات شهرياً بدون أتمتة غير عملي.

يزيل API Pochtoy.com هذا العبء. يركز الشريك على التسويق والخدمة للعملاء، بينما تغطي Pochtoy.com كل اللوجستيات. تجعل خيار white-label عمل المستودع غير مرئي للعملاء النهائيين.

المعالجة اليدوية مقابل API: ما الفرق

مرحلة العمل الوضع اليدوي الأتمتة عبر API
إنشاء الطلب ينسخ المشغل بيانات العميل إلى حساب الوسيط ترسل منصة الشريك الطلب برمجياً فوراً
الإقرار الجمركي يُجمع محتوى الطرد يدوياً لكل شحنة ينتقل محتوى الطلب إلى الإقرار تلقائياً
مراقبة المعالجة يفتح المدير الحساب دورياً ويتحقق من الحالات تتلقى نظام الشريك التحديثات في الخلفية دون تدخل بشري
نقل التتبع يُنسخ رقم التتبع إلى المراسلة مع العميل يعرض البوت أو الموقع الرقم التتبعي للعميل فور ظهوره
تكلفة الشحن يرى العميل السعر بعد إتمام الطلب يُحسب التعريفة عبر API وتظهر في السلة
نمو الحجم عدد الطلبات محدود بقدرات الموظفين يتعامل المستودع مع عشرات الآلاف من الطلبات شهرياً

مسار الطلب: من النقرة إلى الطرد

مع API المتصل يمر كل طلب بست خطوات دون مشاركة المشغل.

1

يُشكّل العميل سلته

يختار العميل المنتجات في متجر أو بوت الشريك، ويحدد عنوان التوصيل. يرى السعر النهائي شامل التوصيل قبل إتمام الطلب.

2

تنقل المنصة الطلب عبر API

بطلب واحد تُرسل معايير الطرد وجهات اتصال المستلم والبيانات الجمركية. بدون إدخال يدوي.

3

الاستلام والمعالجة في المستودع الأمريكي

عند الحاجة يشتري مشترو Pochtoy.com المنتجات من متاجر الولايات المتحدة. يُجهز الطرد للشحن.

4

تصل الحالات إلى نظام الشريك

مراحل المعالجة - تم الاستلام، تم التعبئة، تم التسليم للناقل - تصل إلى المنصة تلقائياً عبر API.

5

الشحن من ديلاوير مع رقم تتبع

يُعاد رقم التتبع عبر API، ثم يُخطر البوت أو الموقع العميل تلقائياً.

6

يستلم العميل الطرد خلال 5-10 أيام

التوصيل إلى روسيا وبيلاروسيا وكازاخستان. White-label: لا توجد أي كلمة عن Pochtoy.com داخل الطرد.

ما يُنقل بين الشريك وPochtoy.com

نقل البيانات ثنائي الاتجاه. REST API متوافق مع أي تقنية - Python، Node.js، PHP، Ruby.

يرسل الشريك إلى Pochtoy.com
أسماء المنتجات، الكمية، الأسعار
بيانات الاتصال بالمستلم: الاسم، العنوان، الهاتف
وصف محتوى الطرد للإقرار الجمركي
معايير طلب التعريفة: الوزن ودولة الوجهة
تعيد Pochtoy.com إلى الشريك
تأكيد الاستلام ورقم الطلب الداخلي
الحالة الحالية للمعالجة في كل مرحلة
رقم التتبع بعد الشحن من المستودع
التكلفة الدقيقة للتوصيل في الوقت الفعلي

تفتح الوثائق في الحساب الشخصي بعد الموافقة على الطلب. يُمنح الوصول خلال يوم عمل واحد بعد تقديم الطلب على lp.pochtoy.com/api.

مزايا الاتصال بـ API

🏷

كاملاً تحت علامة الشريك التجارية

لا يوجد داخل الطرد أي ذكر لـ Pochtoy.com. من أول لمسة حتى الاستلام يرى العميل فقط علامة المتجر.

🛒

يشتري المشترون بدون American Express

إذا طلب متجر أمريكي بطاقة أمريكية أو PayPal - يشتري موظفو Pochtoy.com المنتج للشريك، عمولة تبدأ من 4%.

📦

مستودع في ديلاوير: ضريبة مبيعات 0%

ولاية بدون ضريبة مبيعات. تخزين مجاني حتى 14 يوماً. دمج عدة طرود في شحنة واحدة بدون رسوم إضافية.

💰

مكافأة على الحجم

من 30 طرداً شهرياً يحصل الشريك على $2 عن كل طرد حتى 3 كجم و$3 عن الأثقل. البرنامج بدون تاريخ انتهاء.

🔒

الامتثال لـ ФЗ-152

خوادم البيانات الشخصية للعملاء موجودة في روسيا، مما يتوافق مع متطلبات التشريع الروسي بشأن البيانات الشخصية.

💳

خيارات دفع مرنة

تُدعم البطاقات البنكية الروسية والأجنبية، وعند الطلب - العملات المشفرة. يمكن الدفع التلقائي للطلبات عبر API.

شبكة التعريفات للشركاء

ثلاث خيارات تعريفية تختلف في السرعة والسعر. جميعها متاحة عبر API - تعرض منصة الشريك التكلفة الفعلية للعميل قبل إتمام الطلب.

نوع التوصيل المدة السعر ما يُرسل عادة
قياسي 8-14 يوماً من $5.99 منسوجات، أحذية، إكسسوارات
سريع 5-8 أيام من $9.99 أجهزة، أحذية رياضية، ملابس جينز
iHerb 7-10 أيام $12.99 لكل كجم مكملات غذائية وفيتامينات من iHerb
بدون رسوم مخفية: دمج عدة طرود في شحنة واحدة لا يُدفع عنه بشكل منفصل. تخزين الطرد المستلم في المستودع لمدة 14 يوماً - مجاناً.

الفئات الواعدة لإعادة البيع عبر Pochtoy.com

فئات المنتجات التي يكثر الطلب على شحنها من الولايات المتحدة. يختار الشركاء هذه المجالات أكثر من غيرها: وزن الطرود الصغير، فرق الأسعار الملحوظ مع التجزئة الروسية، والطلب المستمر.

الفيتامينات والمكملات الغذائية من iHerb

منذ 2022 أصبحت الشحنة المباشرة من iHerb إلى روسيا غير متاحة، فانتقل الطلب إلى الوسطاء. تعريفة 12.99 دولار للكيلوغرام تحسن اقتصاديات إعادة البيع. أعلى معدل نمو بين الشركاء.

iherb.com, vitacost.com, swansonvitamins.com

الأحذية الرياضية والأحذية من الولايات المتحدة

على مواقع Nike وAdidas وNew Balance وASICS وVans تكون الأسعار أقل من التجزئة الروسية بنسبة 50-100%. ينفذ منظمو الشراء الجماعي مئات الطلبات شهريًا.

nike.com, adidas.com, newbalance.com, zappos.com, 6pm.com

ملابس الماركات الأمريكية

Ralph Lauren وTommy Hilfiger وCalvin Klein وLevi's أغلقت مكاتبها التمثيلية في روسيا. طلب المنتجات الأصلية عبر وسيط يحقق أعلى هامش ربح بين الفئات.

macys.com, ralphlauren.com, tommy.com, levi.com

الإلكترونيات والأجهزة

إكسسوارات Apple وأنظمة الصوت وملحقات اللاعبين — الأسعار الأمريكية أقل من الروسية حتى بعد احتساب الشحن والجمارك. متوسط قيمة الطلب مرتفع.

amazon.com, bestbuy.com, apple.com, bhphotovideo.com

التغذية الرياضية

البروتينات الأمريكية وBCAA والمكملات قبل التمرين أرخص من البدائل الروسية بمرتين إلى ثلاث مرات. نسبة عالية من عمليات الشراء المتكررة.

iherb.com, bodybuilding.com, underarmour.com, amazon.com

مستحضرات التجميل والعناية

Sephora وUlta وPaula's Choice — علامات غير متوفرة في روسيا أو أغلى بكثير. طرود خفيفة وتكلفة شحن منخفضة.

sephora.com, ulta.com, paulaschoice.com, iherb.com
الجمارك: الحد المعفي من الرسوم — 200 يورو لكل طرد. عند التجاوز: رسوم جمركية 15% من المبلغ الزائد ورسوم تخليص حوالي 500 روبل. التفاصيل: pochtoy.com/us/faq/tolls

أربع خطوات حتى أول طلب

1

إنشاء حساب وتقديم الطلب

يُنشأ حساب شريك على pochtoy.com. في صفحة lp.pochtoy.com/api تُقدم طلب يحتوي وصف المنصة — موقع إلكتروني أو بوت تليغرام أو قناة أخرى — والعدد المتوقع للطلبات شهريًا.

2

فتح توثيق API

بعد الموافقة يظهر في الحساب قسم يحتوي مواد التكامل: التوثيق الفني ومفاتيح الوصول وبيئة الاختبار. موصوفة الطرق لإرسال الطلبات والاستعلام عن الحالات والحصول على أرقام التتبع وحساب التعريفات.

3

دمج API في المنصة

REST API متوافق مع Python وNode.js وPHP وRuby. يتصل البوت المكتوب بلغة Python باستخدام aiogram أو telebot خلال ساعات قليلة. حجم العمل القياسي يتراوح بين 4 و12 ساعة تطوير. طلب التعريفة وإرسال الطلب والاستعلام عن الحالات — ثلاث كتل برمجية على جانب الشريك.

4

الاختبار والإطلاق

قبل الإطلاق يُجرى 2-3 طلبات اختبارية في بيئة الاختبار. يُتحقق من: صحة الحالات وعرض التتبع وعمل white-label وإرسال الإشعارات للعميل باسم العلامة التجارية للشريك. بعد اجتياز الاختبارات يُحول إلى المفتاح الإنتاجي.

كيف تبدو العملية من الداخل: رحلة المشتري

عندما يكمل المشتري الدفع تنقل المنصة البيانات إلى Pochtoy.com دون تدخل المشغل. يرى العميل سير تنفيذ الطلب دون الحاجة للتواصل مع المتجر.

المرحلة ما يراه المشتري ما يحدث في النظام
في السلة سعر الشحن ظاهر قبل إتمام الطلب طلبت المنصة التعريفة عبر API وحصلت على الرد
التأكيد رسالة باستلام الطلب أرسلت المنصة الطلب إلى API الخاص بـ Pochtoy.com
المستودع إشعار بالمعالجة يعيد API مراحل حركة الطلب داخل المستودع
الشحن من الولايات المتحدة رسالة تحتوي رقم التتبع ورابط التتبع نقل API رقم التتبع وأبلغ البوت المشتري تلقائيًا
تم الاستلام الإشعار النهائي بالاستلام نقل API آخر حالة وأُرسلت الرسائل دون تدخل الشريك

الأسئلة الشائعة حول API Pochtoy.com

ما المهام التي يغطيها API وما يبقى على عاتق المستودع؟
يتولى API نقل الطلبات وإرسال بيانات الجمارك والاستعلام عن الحالات والحصول على أرقام التتبع. شراء البضائع من المتاجر الأمريكية خدمة منفصلة يقدمها مشترو Pochtoy.com وتُفعّل بعد وصول الطلب إلى المستودع.
هل يمكن الاستغناء عن المطور؟
لا. يتطلب الربط استخدام REST API مما يعني العمل مع الخلفية. يدمج المطور ذو الخبرة في Python أو Node.js أو PHP الـ API خلال 4-12 ساعة. إذا كان المتجر أو البوت قيد التشغيل بالفعل فإضافة استدعاءات API لا تختلف عن ربط خدمات طرف ثالث أخرى.
هل سيعرف المشترون بوجود Pochtoy.com؟
في وضع white-label لا تظهر Pochtoy.com لا داخل الطرد ولا في التواصل مع المشتري ولا في التتبع. كل التفاعل يتم باسم الشريك. الرابط بين Pochtoy.com والشريك يظهر فقط في عمليات الدفع بين الشركة والخدمة — وهذا لا يراه المشتري.
هل يمكن عرض تكلفة الشحن قبل إتمام الطلب؟
نعم. إحدى طرق API تعيد التعريفة الحالية في الوقت الفعلي. حسب وزن الطرد وبلد الوجهة يعطي النظام المبلغ الدقيق الذي يمكن عرضه للمشتري في السلة أو عند التأكيد.
ما هو الحد المعفي من الرسوم الجمركية عند الاستيراد إلى روسيا؟
الاستيراد المعفي محدود بـ 200 يورو لكل شحنة. عند التجاوز: رسوم جمركية 15% من المبلغ الزائد ورسوم تخليص حوالي 500 روبل. تقسيم الطلب الكبير إلى عدة طرود يقلل إجمالي التكاليف الجمركية للعميل. التكلفة الأساسية للشحن تبدأ من 5.99 دولار.
متى يحصل المشتري على رقم التتبع؟
يُعاد رقم التتبع عبر API لحظة شحن الطرد من المستودع في ديلاوير. تحصل منصة الشريك عليه وتُبلغ العميل تلقائيًا. مدة التوصيل إلى روسيا — من 5 أيام.
إلى أي الدول تعمل الشحنة عبر API؟
الاتجاهات الرئيسية هي روسيا وبيلاروسيا وكازاخستان. يخدم API واحد جميع الدول: تُحدد دولة المستلم بمعامل في بيانات الطلب ولا يلزم تكامل إضافي لكل دولة.

أحِل شحنات الولايات المتحدة إلى Pochtoy.com

قدم الطلب — سيُفتح الوصول إلى توثيق API خلال يوم عمل. التكامل يستغرق 4-12 ساعة تطوير.

الحصول على وصول إلى API