مستندات فنی و راهنمای پیاده‌سازی وب سرویس فلوکس

مدیریت هوشمند ارسال مرسولات دغدغه اصلی فروشگاه‌های آنلاین است. سامانه فلوکس (Phelox) راهکاری جامع برای این نیاز ارائه می‌دهد. با استفاده از وب سرویس فلوکس، تمام فرآیندها خودکار می‌شوند. این مقاله راهنمای کامل مستندات وب سرویس فلوکس است.توسعه‌دهندگان با این مستندات می‌توانند سیستم خود را متصل کنند. این اتصال باعث افزایش سرعت پردازش سفارش‌ها می‌شود. ما در این مطلب تمامی متدها را بررسی می‌کنیم. همچنین نحوه دریافت خروجی‌های JSON و HTML را می‌آموزید.

۱. کاربردهای وب سرویس فلوکس در لجستیک مدرن

استفاده از API در مدیریت زنجیره تأمین بسیار ضروری است. وب سرویس فلوکس امکانات متعددی را در اختیار شما قرار می‌دهد. مهم‌ترین کاربردهای این سرویس در ادامه لیست شده است:

🌐 یکپارچه‌سازی فروشگاه: اتصال مستقیم وب‌سایت‌های وردپرسی یا اختصاصی به سامانه پستی.
📦 مدیریت انبوه سفارش‌ها: ثبت و پردازش صدها مرسوله به صورت همزمان و خودکار.
🔍 رهگیری هوشمند: ارائه کد رهگیری لحظه‌ای به مشتریان جهت افزایش اعتماد آن‌ها.
💰 محاسبه دقیق هزینه‌ها: نمایش نرخ واقعی کرایه حمل به خریدار پیش از پرداخت.
📊 گزارش‌گیری فنی: دریافت لیست دقیق شرکت‌های حمل‌کننده و سرویس‌های فعال آن‌ها.

۲. مزایای استفاده از مستندات وب سرویس فلوکس

چرا باید از وب سرویس فلوکس برای کسب‌وکار خود استفاده کنید؟ این سیستم مزایای رقابتی زیادی برای شما ایجاد می‌کند:

⚡ صرفه‌جویی در زمان: حذف فرآیند ورود دستی اطلاعات آدرس و مشخصات مشتریان.
🛠️ پایداری بالا: آپ‌تایم بالای سرورها جهت فراخوانی متدها در تمام ساعات شبانه‌روز.
🛡️ امنیت داده‌ها: انتقال اطلاعات در بستری امن و مطابق با استانداردهای وب.
📈 مقیاس‌پذیری: توانایی پاسخگویی به حجم بالای درخواست‌ها در جشنواره‌های فروش.
🔗 سازگاری کامل: ارائه پاسخ‌ها در دو فرمت محبوب JSON و String HTML.

۳. راهنمای سریع ثبت‌نام و شروع کار

برای استفاده از این خدمات باید ابتدا عضو شوید. فرآیند فعال‌سازی حساب کاربری بسیار ساده و سریع طراحی شده است. برای شروع، مراحل زیر را دنبال کنید:

👤 ابتدا به سامانه ثبت‌نام در آدرس p.api.ir مراجعه نمایید.
📝 اطلاعات پنل فروشگاهی خود را با دقت وارد کنید.
🔑 کلید اختصاصی (API Key) خود را از بخش تنظیمات دریافت کنید.
💻 از متدهای معرفی شده در زیر برای اتصال سیستم استفاده کنید.

۴. مستندات فنی دریافت اطلاعات پایه

پیش از ثبت سفارش، شما به کدهای دسته‌بندی نیاز دارید. این کدها برای شناسایی دقیق نوع کالا در سیستم فلوکس ضروری هستند.

دریافت کد گروه‌های کالا

این متد لیست گروه‌های اصلی کالا را به شما برمی‌گرداند. شما برای ثبت کالا به Groupid نیاز دارید.

آدرس: https://phelox.ir/webservice/getgroups.aspx
متد: GET / POST

نمونه پاسخ JSON:

json

{
"Result": "100",
"Output": [{
"Groupid": "10",
"Groupname": "کالای دیجیتال"
}]
}

دریافت کد زیر گروه‌های کالا

پس از انتخاب گروه اصلی، باید زیرگروه کالا را مشخص کنید. از این متد برای دریافت Subgroupid استفاده نمایید.

آدرس: https://phelox.ir/webservice/getsubgroups.aspx
متد: GET / POST

۵. مدیریت مراکز فروش و محصولات

در وب سرویس فلوکس، مدیریت انبارها و کالاها کاملاً سیستمی است. شما می‌توانید از راه دور اطلاعات را ویرایش کنید.

ثبت و ویرایش مرکز فروش

برای فعال‌سازی فروشگاه جدید در لیست خود از متد sadd.aspx استفاده کنید. همچنین برای تغییر آدرس یا مشخصات از sedit.aspx استفاده می‌شود.

خروجی موفق: مقدار “100” در قالب JSON یا متن ساده.

معرفی محصول جدید به سامانه

قبل از هر سفارشی، کالا باید در فلوکس تعریف شود. متد padd.aspx برای ثبت مشخصات اولیه کالا طراحی شده است.

نکته مهم: برای تغییر قیمت یا مشخصات فنی از متد pedit.aspx استفاده کنید. این کار باعث بروزرسانی آنی قیمت در سبد خرید مشتری می‌شود.

۶. انتخاب شرکت حمل و استعلام قیمت

یکی از ویژگی‌های جذاب مستندات وب سرویس فلوکس، تنوع سرویس‌دهندگان است. شما می‌توانید بهترین گزینه را برای مشتری انتخاب کنید.

لیست شرکت‌های حمل‌کننده

این متد نام، کد و ساعت توزیع شرکت‌های فعال را نمایش می‌دهد. فراخوانی این متد در بازه‌های زمانی مختلف توصیه می‌شود.

آدرس: https://phelox.ir/webservice/getproviders.aspx
پارامتر Tls: اگر مقدار آن ۱ باشد، یعنی امکان توزیع در زمان مشخص وجود دارد. 🕒

استعلام نرخ کرایه حمل

پیش از ثبت نهایی، هزینه ارسال را محاسبه کنید. این متد نرخ کرایه را بر اساس وزن و مقصد برمی‌گرداند.

آدرس: https://phelox.ir/webservice/getprice.aspx
خروجی: شامل هزینه ارسال، مالیات بر ارزش افزوده و حق بیمه کالا است.

راهنمای جامع مستندات وب سرویس فلوکس + آموزش پیاده‌سازی سریع

۷. ثبت نهایی سفارش و دریافت رهگیری

مهم‌ترین بخش وب سرویس فلوکس، ثبت سفارش نهایی است. این مرحله باعث صدور بارنامه و دریافت کد رهگیری می‌شود.

متد نهایی: https://phelox.ir/webservice/neworder.aspx
ثبت انبوه: در هر بار فراخوانی تا ۱۰۰ مرسوله قابل ثبت است.
فرمت Det: برای ثبت چند مرسوله، استرینگ‌ها را با کاراکتر ; از هم جدا کنید. 🖇️

۸. جمع‌بندی و گام بعدی شما

وب سرویس فلوکس ابزاری قدرتمند برای اتوماسیون فروش است. این سیستم خطای انسانی را به حداقل می‌رساند. با رعایت این مستندات، فروشگاهی حرفه‌ای و هوشمند خواهید داشت. سرعت در ارسال، کلید موفقیت در بازار آنلاین است. فلوکس این سرعت را برای شما تضمین می‌کند. 🚀

آیا در پیاده‌سازی این متدها سوالی دارید؟ در بخش نظرات سوالات فنی خود را بپرسید. کارشناسان ما آماده پاسخگویی به شما هستند. برای شروع کار و دریافت دسترسی API، همین حالا در سایت p.api.ir عضو شوید.