زیرسیستم API پیشتازاناطلاعات پیشتازان، در جریان سایت و اپلیکیشن شما
کالا، قیمت، موجودی و سفارش را به سامانههای دیگر متصل کنید؛ با یک مسیر مشخص برای تبادل اطلاعات با نرمافزار جامع پیشتازان.
API پیشتازان، رابط ارتباطی فروشگاه اینترنتی، اپلیکیشن و سامانه اختصاصی شما با سرویس پیشتازان است. به جای ورود دوباره اطلاعات در چند محیط، گردش داده را بر اساس نیاز کسبوکار و عملیات پشتیبانیشده طراحی کنید. پلاگین وردپرسی پیشتازان نیز برای بهروزرسانی کالاها و مشخصات آنها در ووکامرس و ارسال فاکتور به سرور حسابداری پیشتازان ارائه میشود.
یک رابط، چند مسیر ارتباطی
اطلاعات از پیشتازان به سامانه شما؛ سفارش از سامانه شما به پیشتازان
اتصال دیجیتال، در کنار نرمافزار جامع پیشتازان
این زیرسیستم برای ارتباط برنامههای دیگر با پیشتازان طراحی شده است؛ نه جایگزین نرمافزار اصلی و نه یک فروشگاه اینترنتی مستقل. مسیرهای دریافت و ثبت اطلاعات، مبنای توسعه اتصال متناسب با مجموعه شما هستند.
امکانات API نرمافزار پیشتازان
قابلیتهای زیر در ساختار API تعریف شدهاند. استفاده از هر عملیات به پشتیبانی فرمان متناظر در سرویس، مجوز و تنظیمات نصب مجموعه وابسته است.
کالا، بارکد و گروهبندی
دریافت کد، نام، بارکد، توضیحات و گروه کالا؛ همراه با امکان فیلتر بر اساس کد و مسیر گروه، انتخاب کالاهای دارای موجودی مثبت و برداشت مرحلهای فهرست کالاها.
قیمت، تخفیف و موجودی
دریافت نرخ فروش، قیمت اصلی، درصد تخفیف و موجودی کالا. ساختار خروجی، موجودی کل انبارها را نیز در صورت ارائه این داده توسط سرویس پشتیبانی میکند.
سایز، رنگ و تنوع کالا
مسیرهای دریافت سایزها، رنگها و ترکیب کالا/سایز/رنگ، با بارکد ترکیبی، قیمت و موجودی؛ برای اتصال سامانههایی که محصولات متنوع عرضه میکنند.
تصاویر و کالاهای تغییرکرده
مسیر دریافت تصاویر کالا با شناسه محتوای تصویر و آمار پیشرفت برداشت، و مسیر دریافت کالاهای تغییرکرده؛ برای طراحی بهروزرسانی مرحلهای در سامانه متصل.
دریافت و ثبت اطلاعات مشتری
دریافت فهرست مشتریان یا اطلاعات مشتری با شناسه، معرفی مشتری جدید و ویرایش نام، شناسه، نشانی، تلفن و موبایل، در حدود مجوزهای سرویس.
مانده حساب و اطلاعات فروش
دریافت اطلاعات تفصیلی با مانده و وضعیت بدهکار، بستانکار یا تسویه؛ همراه مسیرهای دریافت سربرگ فروش مشتریان شامل شماره سند، تاریخ و جمع مبالغ.
ارسال سفارش یا فروش قطعی
ارسال اقلام، تعداد، قیمت، بارکد، تخفیف، سایز و رنگ همراه اطلاعات مشتری، هزینه ارسال و وضعیت پرداخت ثبتشده؛ با تعیین سفارش یا فروش قطعی و دریافت نتیجه عملیات و شماره سند.
پلاگین وردپرس و اتصال ووکامرس
پلاگین وردپرسی پیشتازان برای دریافت و بهروزرسانی کالاها و مشخصاتشان در فروشگاه ووکامرس و ارسال فاکتور به سرور حسابداری پیشتازان ارائه میشود. ساختار API نیز خروجی کالا و تنوعهای سایز و رنگ را برای این ارتباط فراهم میکند.
بهروزرسانی انتخابی کالا
مسیر دریافت تغییرات نام، نرخ فروش، قیمت اصلی، تخفیف و تصویر کالای موجود از ووکامرس. فیلدهای قابل تغییر در درخواست انتخاب میشوند؛ این مسیر به معنی ایجاد کالا یا تغییر موجودی از سایت نیست.
نمایش PDF فاکتور با لینک
ساختار نمایش فاکتور بهصورت PDF از طریق شناسه لینک در API پیشبینی شده است. استفاده عملی به داده فاکتور، قالب گزارش، سرویس و سیاست اشتراکگذاری مجموعه نیاز دارد.
احراز هویت و تنظیم اتصال
دریافت توکن JWT برای عملیات محافظتشده و استفاده از شناسه اتصال برای انتخاب پیکربندی مجموعه. اطلاعات دسترسی و مجوزهای سرویس باید در راهاندازی تعیین شوند.
مستندات و پاسخ قابل پیگیری
رابط HTTP و JSON با مستندات Swagger و پاسخ شامل وضعیت موفقیت و پیام عملیات. سامانه متصل میتواند نتیجه دریافت یا ثبت اطلاعات را بررسی و در گردش کار خود پیگیری کند.
پیش از بهرهبرداری: نسخه API و سرویس اصلی، نگاشت فرمانها، مجوز API، دوره مالی، انبار و شیوه تطبیق کالا و مشتری بررسی میشوند. وجود یک مسیر در مستندات، بهتنهایی به معنی فعالبودن آن در تمام نصبها نیست؛ آزمون اتصال و ثبت آزمایشی کنترلشده بخشی از راهاندازی است.
بهروزرسانی کالاها و ارسال فاکتور به حسابداری پیشتازان
پیشتازان پلاگین وردپرسی دارد تا فروشگاه ووکامرس به سرور حسابداری پیشتازان متصل شود. این پلاگین، کالاها و مشخصاتشان را از پیشتازان دریافت و در سایت بهروزرسانی میکند؛ اطلاعات فاکتور فروش نیز همراه اقلام و مشخصات مشتری، از طریق API به سرور حسابداری پیشتازان ارسال میشود.
- دریافت و بهروزرسانی کالاها، نام، توضیحات و گروهبندی آنها در فروشگاه وردپرسی.
- تبادل قیمت، تخفیف، موجودی، تصاویر و تنوعهای سایز و رنگ، مطابق امکانات و تنظیمات اتصال.
- تطبیق کد و بارکد کالا و تنوعهای سایز و رنگ.
- ارسال فاکتور فروش، اقلام و اطلاعات مشتری به سرور حسابداری پیشتازان، متناسب با روند اجرایی مجموعه.
- نگهداری شماره سند و پیگیری پاسخهای ناموفق در سامانه مقصد.
پلاگین وردپرسی و API؛ دو بخش از یک اتصال
نقش API پیشتازان: فراهمکردن مسیرهای دریافت و ارسال اطلاعات و ارتباط با سرویس اصلی.
نقش پلاگین وردپرسی پیشتازان: برقراری ارتباط فروشگاه ووکامرس با API، بهروزرسانی کالاها و ارسال اطلاعات فاکتور به سرور حسابداری.
پلاگین وردپرسی پیشتازان برای این اتصال ارائه میشود. در راهاندازی، نسخه پلاگین و سرویس، دسترسیها، شناسه تطبیق کالا و مشتری، مرجع قیمت و موجودی و تنظیمات تبادل بررسی میشوند؛ پیش از بهرهبرداری، دریافت کالا و ارسال یک فاکتور کنترلشده باید آزموده شود.
مسیر راهاندازی اتصال API پیشتازان
تعریف سناریو
مشخص کنید چه اطلاعاتی، در کدام جهت و در چه مرحلهای از کار بین سامانهها تبادل شود.
بررسی سازگاری
نسخه سرویس، فرمانهای موردنیاز، مجوز و تنظیمات اتصال و دسترسی مجموعه بررسی میشوند.
توسعه و آزمون رابط
مدل داده سایت یا اپلیکیشن به قرارداد API نگاشت و دریافت و ثبت اطلاعات روی داده کنترلشده آزموده میشود.
بهرهبرداری و پیگیری
زمان تبادل، کنترل نتیجه ثبت، جلوگیری از ارسال تکراری و روش پیگیری خطا در رابط مقصد مشخص میشوند.
پرسشهای متداول زیرسیستم API پیشتازان
آیا این زیرسیستم همان API پیشگامان است؟
خیر؛ این صفحه مربوط به API نرمافزار جامع پیشتازان است. قرارداد سرویس، نسخه و تنظیمات پیشتازان باید بررسی شوند و نباید سازگاری دو محصول را بدون تطبیق فرض کرد.
آیا پیشتازان پلاگین وردپرسی هم دارد؟
بله؛ پلاگین وردپرسی پیشتازان برای اتصال فروشگاه ووکامرس، بهروزرسانی کالاها و مشخصات آنها و ارسال فاکتور به سرور حسابداری پیشتازان ارائه میشود. استفاده از آن نیازمند نصب و تنظیم پلاگین و سازگاری با نسخه سرویس مجموعه است.
آیا اتصال فقط به ووکامرس محدود است؟
خیر؛ سایت، اپلیکیشن و سامانه اختصاصی نیز با توسعه رابط مناسب میتوانند از مسیرهای HTTP و مدلهای JSON پشتیبانیشده استفاده کنند.
آیا تبادل اطلاعات خودکار و لحظهای است؟
API مسیر درخواست و پاسخ را فراهم میکند. زمانبندی دریافت و ارسال و رسیدگی به خطا در برنامه یا افزونه متصل تعیین میشود؛ همگامسازی آنی و دائمی بهصورت عمومی تضمین نمیشود.
آیا همه اطلاعات پیشتازان از سایت قابل تغییر است؟
خیر؛ عملیات به مسیرهای تعریفشده، مجوز و پشتیبانی سرویس محدود است. برای نمونه، مسیر بهروزرسانی کالا فقط فیلدهای منتخب کالای موجود را میپذیرد.
آیا پرداخت بانکی در API انجام میشود؟
ارسال وضعیت پرداخت فاکتور به معنی انجام تراکنش بانکی نیست. درگاه و تأیید پرداخت در سامانه مقصد مدیریت میشوند.
برای استفاده چه پیشنیازهایی لازم است؟
نرمافزار و سرویس سازگار پیشتازان، دسترسی ارتباطی، مجوز و نگاشت فرمانهای لازم و رابط سمت سایت یا اپلیکیشن. فعالبودن هر قابلیت و نتیجه عملیات باید پیش از بهرهبرداری با سرویس مجموعه آزموده شود.
پیشتازان را به سامانههای کسبوکارتان متصل کنید
برای بررسی اتصال سایت، فروشگاه اینترنتی یا اپلیکیشن به نرمافزار جامع پیشتازان با ما در ارتباط باشید.