چه کسب و کارهایی می‌توانند از خدمات وب سرویس (ای‌پی‌آی) الوپیک استفاده کنند؟
همه کسب و کارهای آنلاین مانند فروشگاه‌های اینترنتی که به هر نحو برای ارسال مرسولات خود نیاز به خدمات حمل و نقل دارند، می‌توانند از طریق وبسایت یا اپلیکیشن خود از وب‌سرویس الوپیک بهره‌مند شوند.
چطور می‌توان از خدمات ای‌پی‌آی الوپیک استفاده کرد؟
ابتدا از طریق آدرس https://alopeyk.com/api درخواست خود را ثبت کنید. برای شما ایمیلی ارسال خواهد شد و طی آن از شما دعوت می‌شود تا فرمی را به صورت آنلاین تکمیل کنید. سپس راهنمایی‌های لازم به همراه توکن مورد نیاز بنا بر اطلاعات وارد شده به پست الکترونیکی شما ارسال خواهد شد.
آیا نمونه کد آماده‌ای برای نحوه استفاده از ای‌پی‌آی الوپیک وجود دارد؟
بله. در حال حاضر نمونه کدهای متنوعی پیاده‌سازی شده است که شما می‌توانید از این نشانی به آنها دسترسی پیدا کنید:
با فعال‌سازی افزونه ووکامرس با خطای 500 - Internal Server Error مواجه می‌شوم. مشکل از کجاست؟
این خطا معمولاً به علت قدیمی بودن نسخه PHP نصب شده بر روی سرور یا هاستینگ شما رخ میدهد. از سرویس‌دهنده خود تقاضا کنید تا آن را حداقل به نسخه 5.6 ارتقاء دهد. اگر پس از ارتقاء کماکان با این خطا مواجه شدید، ابتدا متغیرهای WP_DEBUG و WP_DEBUG_LOG را در فایل wp-config.php برابر TRUE قرار دهید، سپس افزونه را فعال کنید و یک نسخه از فایل debug.log را از پوشه wp-content به همراه توضیحات کلی به dev@alopeyk.com ارسال نمایید.
اگر فروشگاه بر پایه فروشگاه‌ساز ووکامرس (وردپرس) نباشد یا دارای زیرساختی اختصاصی باشد که در حال پیاده‌سازی آن هستیم، آیا کماکان امکان استفاده از خدمات ای‌پی‌آی الوپیک وجود دارد؟
بله. نحوه استفاده از ای‌پی‌آی الوپیک در این آدرس توضیح داده شده است.
همچنین نمونه کدهای متنوعی نیز در این آدرس در دسترس هستند.
چه تفاوتی بین درخواست‌هایی که از طریق ای‌پی‌آی، و درخواست‌هایی که از طریق اپلیکیشن و وبسایت الوپیک ثبت می‌شود وجود دارد؟
درخواست‌هایی که از طریق ای‌پی‌آی الوپیک ارسال می‌گردد، از مدت زمان بیشتر جستجو و سرعت بالاتر پذیرش توسط سفیران الوپیک برخوردار هستند.
تفاوت توکن سندباکس (آزمایشی) و توکن پروداکشن (اصلی) چیست؟
توکن سندباکس برای استفاده آزمایشی از API الوپیک است و معمولاً در فرآیند پیاده‌سازی ارتباط وبسایت یا اپلیکیشن مورد استفاده قرار می‌گیرد که پس از پایان پیاده سازی و دریافت توکن پروداکشن از واحد فروش، با توکن پروداکشن جایگزین می‌شود.
چرا در هنگام جستجوی آدرس، با انتخاب نام یک خیابان، نقشه به موقعیت مکان نادرستی تنظیم می‌شود؟
به علت تشابه نام مکان‌ها که در شهر تهران و نیز سایر شهرستان‌ها وجود دارد این اتفاق رخ میدهد. توصیه می‌شود به جای جستجوی آدرس دقیق، پس از جستجوی منطقه حدودی، آدرس دقیق به صورت دستی بر روی نقشه تنظیم شود.
چرا قیمت استعلامی با توکن آزمایشی با قیمت واقعی درج شده در اپلیکیشن و وبسایت الوپیک متفاوت است؟
این امر کاملاً طبیعی است، زیرا در فضای سندباکس قیمت‌ها ثابت و بدون تغییر هستند، در حالی که در فضای واقعی قیمت‌ها بر اساس بسیاری از فاکتورها به صورت لحظه‌ای در حال تغییرند.
در صورتی که فروشگاه چند انبار داشته باشد چگونه می‌توانیم از خدمات الوپیک استفاده کنم؟
کافی است نشانی انبارها را در پایگاه داده ذخیره کنید. در هنگام محاسبه هزینه ارسال، به ازای قرار دادن آدرس هر یک از انبارها (که محصولات سبد خرید در آنها موجود هستند) به عنوان آدرس مبدأ و آدرس مشتری به عنوان آدرس مقصد، یک بار هزینه درخواست را محاسبه کنید و کمترین هزینه نشان‌دهنده مناسب‌ترین انبار برای تعیین به عنوان مبدأ خواهد بود. در حال حاضر این امکان برای افزونه ووکامرس وجود ندارد.
هزینه درخواست به چه صورتی پرداخت می‌شود؟
در حالت کلی هزینه درخواست بنا به پارامترهای ارسالی به ای‌پی‌آی، به صورت نقدی در مبدأ یا مقصد و یا پرداخت اعتباری توسط مبدأ (توسط دارنده حساب الوپیک) پرداخت می‌شود. اما در هنگام استفاده از افزونه ووکامرس پرداخت‌ها تنها به صورت اعتباری و توسط مبداً (دارنده حساب الوپیک) صورت می‌گیرد.
در صورتی که فروشگاه یا مشتری فروشگاه در شهرستان باشند، آیا امکان استفاده از خدمات الوپیک وجود دارد؟
بله. امکان استفاده از ای‌پی‌آی و افزونه‌های الوپیک برای تمامی آدرس‌های تحت پوشش (چه تهران و چه شهرستان) به عنوان مبدأ و یا مقصد وجود دارد. برای حصول اطمینان از این موضوع کافی است که پس از ست کردن آدرس مبدأ و مقصد بر روی شهر دلخواه، یک درخواست آزمایشی برای محاسبه هزینه ارسال کنید. تحت پوشش بودن آدرس‌های انتخاب شده در پاسخ ای‌پی‌آی و افزونه‌ها گویا خواهد بود.
آیا امکان ارسال سفارش با چند آدرس مقصد وجود دارد؟
بله. در هنگام استفاده از ای‌پی‌آی کافی‌است بر طبق اسناد آموزشی، به جای یک مقصد آرایه‌ای از مقاصد را در هنگام ثبت سفارش ارسال کنید.در هنگام استفاده از افزونه ووکامرس نیز در صفحه لیست سفارشات ووکامرس می‌توانید گزینه‌ی کنار چند سفارش را فعال کنید و از منوی کارهای دسته‌جمعی موجود در نوار بالایی صفحه، گزینه ارسال با الوپیک را انتخاب نمایید.
در ووکامرس چگونه سفارشات خود را از طریق الوپیک ارسال کنم؟
شما می‌توانید در صفحه لیست سفارشات ووکامرس گزینه کنار یک یا چند سفارش را فعال کنید و از منوی کارهای دسته‌جمعی موجود در نوار بالایی صفحه، گزینه ارسال با الوپیک را انتخاب کنید. همچنین می‌توانید وارد صفحه‌ی جزئیات سفارش ووکامرس شده و از ستون سمت چپ، از بخش ارسال با الوپیک، دکمه ارسال را کلیک کنید.
در هنگام استفاده از افزونه ووکامرس، در زمان ثبت سفارش با پیغام «یک یا چند آدرس تحت پوشش روش ارسال الوپیک نیستند» مواجه می‌شوم. مشکل از کجاست؟
این پیام زمانی نمایش داده می‌شود که آدرس مبدأ (فروشگاه) و یا مقصد حداقل یکی از سفارش‌های انتخابی برای ارسال با الوپیک، در محدوده یا شهر مورد پشتیبانی الوپیک نباشد.آیا برای فروشگاه‌سازهای دیگر مانند مجنتو(Magento)، پرستاشاپ(Prestashop)، اُپن کارت(OpenCart) و... هم پلاگینی پیاده‌سازی شده است؟تا به امروز، خیر. لطفاً در صورت تمایل به پیاده‌سازی افزونه برای سامانه مدیریت محتوای مورد نظر خود با واحد فروش الوپیک مکاتبه کنید. مسلماً در صورت افزایش درخواست افزونه برای فروشگاه‌سازهای مرسوم دیگر، برای پیاده‌سازی آنها برنامه‌ریزی خواهد شد.
در هنگام استفاده از افزونه ووکامرس، آیا امکان تغییر هزینه‌ای که مشتری فرشگاه می‌بایست پرداخت کند وجود دارد؟
بله. در بخش تنظیمات هزینه از صفحه تنظیمات افزونه، می‌توانید نوع هزینه ارسال را که به مشتری نشان داده می‌شود، تعیین کنید. هزینه ثابت می‌تواند عددی ثابت بر حسب ریال یا درصدی از مجموع مبلغ سبد خرید مشتری باشد. این عدد (یا درصد) برای تمامی سفارشات فروشگاه ثابت خواهد بود. هزینه پویا نیز به معنای هزینه واقعی است که ای‌پی‌آی الوپیک بر اساس آدرس مشتری و پارامترهای دیگر، در لحظه محاسبه می‌کند.در صورتی که به دنبال نمایش هزینه ارسال دلخواه بر اساس محاسبات سفارشی بر پایه مبلغ سفارش، مبلغ واقعی سفارش الوپیک، و غیره هستید می‌بایست با کمک یک برنامه‌نویس قطعه‌ای کد در پوسته یا افزونه خود اضافه کنید.دقت کنید که این هزینه، مبلغی است که به عنوان هزینه ارسال از مشتری فروشگاه دریافت می‌شود ولی در واقعیت مبلغی معادل هزینه پویا از حساب کاربری شما در الوپیک برداشت می‌شود.برای مثال با اضافه کردن کد زیر در سند functions.php پوسته وردپرس، هزینه‌ارسال با الوپیک برای مشتری هیچ‌گاه بیش از ۸۰۰۰ تومان نخواهد شد:
```add_filter ( 'alopeyk_woocommerce_shipping_method/shipping_info', 'apply_price_limit', 99, 2 );
function apply_price_limit ( $shipping_info, $package ) {
if ( $shipping_info[ 'cost' ] > 80000 /* IRR */ ) {
$shipping_info[ 'cost' ] = 80000;
$shipping_info[ 'cost_details' ] = array (
'price' => 80000,
'price_with_return' => 80000
);
}
return $shipping_info;
}```
در حالتی که از ای‌پی‌آی الوپیک برای زیرساخت یک فروشگاه استفاده شود، فاکتور سفارش برای فروشگاه ارسال می‌شود یا مشتری فروشگاه؟
در تمامی سامانه‌های الوپیک، فاکتور تنها برای سفارش‌دهنده (دارنده حساب الوپیک) که در این حالت صاحب فروشگاه است، ارسال می‌شود.
آیا امکان تصحیح آدرس وارد شده توسط مشتری در هنگام سفارش در فروشگاه ووکامرس وجود دارد؟
بله. با وارد شدن به صفحه جزئیات سفارش در پنل مدیریت وردپرس و کلیک تصویر مداد (ممکن است در نسخه‌های بعدی ووکامرس این تصویر تغییر کنید) در کنار عنوان حمل و نقل می‌توانید آدرس سفارش را از روی نقشه اصلاح کنید.
چگونه می‌توانم مشخصات سفیر و سایر جزئیات سفارش را از ای‌پی‌آی دریافت کنم؟
در هنگام درخواست به ای‌پی‌آی برای دریافت جزئیات سفارش، بدین گونه عمل کنید تا جزئیات کامل سفارش شامل مشخصات سفیر بازگردانده شود:
https://sandbox-api.alopeyk.com/api/v2/orders/{OrderID}?columns=*,addresses,screenshot,progress,courier_info,next_address_any,customer,last_position_minimal,eta_minimal
برنامه نویسی سایت را خودمون انجام دادیم و از توکن اصلی استفاده می‌کردیم که قطع شد و پیغام Error 403 token forbiden میدهد.
به دلایلی متعدد ممکن است در لیست سیاه سرورهای الوپیک و یا کش سرور قرار گرفته باشید. لطفا با بخش پشتیبانی API تماس بگیرید.
طول و عرض جغرافیایی از گوگل مپ گرفته شده اما زمانی که وارد فیلدهای افزونه می‌شوند، حذف شده و پیام "منطقه تحت پوشش نیست" نمایش داده می‌شود.
تعداد رقم‌های بعد از اعشار نباید بیش از 6 عدد باشد یا ممکن است طول و عرض جغرافیایی جابه‌جا وارد شده‌اند.
مطابق دستور العمل وقتی با توکن تست درخواست ارسال می‌شود، پاسخ درستی دریافت می‌کنم اما وقتی از توکن پروداکشن استفاده می‌کنم از سرورهای الوپیک پیام خطا دریافت می‌شود
جهت استفاده از توکن پروداکشن باید کلمه sandbox را از آدرس‌های سرور الوپیک حذف کنید.
برای کار با افزونه نیاز به کلید گوگل مپ و یا سیدارمپ هست؟
در نسخه 1.3 و ماقبل نیاز به کلید گوگل مپ است و در نسخه‌های بعد از 1.4 بهتر است برای وبسایت خود یک کلید سیدارمپ تهیه کنید تا با افت سرعت بارگذاری نقشه مواجه نشوید.
در لوکال بخش ارسال درخواست به الوپیک در افزونه ووکامرس و همچنین ویرایش درخواست‌ها نمایش داده نمی‌شود
در لوکال هاست بر پایه ویندوز به دلیل ساختار دسترسی به فایل‌ها، بخش‌های فوق الذکر نمایش داده نخواهند شد. جهت تست این بخش‌های افزونه می‌توانید از هاست برپایه لینوکس استفاده کنید.
در افزونه وردپرس در مدیریت طول و عرض جغرافیایی و آدرس رو به صورت دستی وارد کردم اما چرا دکمه ذخیره تغییرات فعال نمی‌شود؟
با تغییر موقعیت مکانی نقشه، یکسری محاسبات و فرآیندهای خاص در پشت صحنه وردپرس اتفاق می‌افتد و صرفا با وارد کردن دستی طول و عرض جغرافیایی نمی‌شود این بخش را دور زد