یکپارچهسازی API به نرمافزارهایی که استفاده میکنید امکان میدهد به یکدیگر داده بفرستند و از یکدیگر داده بگیرند. اگر وبسایت، فروشگاه اینترنتی، زیرساخت پرداخت، شرکت حمل، حسابهای مارکتپلیس، ارائهدهنده e-Fatura و نرمافزار حسابداری شما هر کدام همان اطلاعات را جداگانه نگه میدارند، یعنی تیم شما هر روز یک داده را دستی در چند صفحه وارد میکند. ما این سیستمها را از طریق APIهایشان به هم متصل میکنیم تا داده در جای درست، در زمان درست و به شکلی قابل ردیابی جریان پیدا کند.
ایجاد خودکار مرسوله برای سفارشی که پرداختش تأیید شده و ارسال کد رهگیری برای مشتری، صدور فاکتور به صورت e-Fatura یا e-Arşiv، بهروزرسانی محصولات در Trendyol و Hepsiburada هنگام تغییر موجودی و ثبت شدن فرم جدید در CRM نمونههای رایج این خدمت هستند. اتصالهایی را که یک افزونه آماده جوابگویشان نیست و باید طبق قواعد کسبوکار شما کار کنند، به صورت اختصاصی توسعه میدهیم.
در این صفحه سیستمهایی را که میتوانیم با آنها یکپارچهسازی انجام دهیم، دسته به دسته و با نام شرکتها میبینید: یکپارچهسازی API ارسال کالا، اتصال درگاه پرداخت بانکی، یکپارچهسازی مارکتپلیس، یکپارچهسازی e-Fatura، اتصال به حسابداری و ERP، پیامک، WhatsApp، نقشه، هوش مصنوعی و موارد دیگر. در هر بخش توضیح میدهیم که این یکپارچهسازی در عمل چه کاری انجام میدهد.
یکپارچهسازی API برای چه کسانی مناسب است؟
- کسبوکارهای فروشگاه اینترنتی: فروشگاههایی که میخواهند محصول، موجودی، قیمت و سفارش را بین سایت خود و مارکتپلیسهایی مانند Trendyol، Hepsiburada، N11 و Amazon از یک مرکز مدیریت کنند.
- شرکتهایی که هر روز مرسوله آماده میکنند: کسبوکارهایی که میخواهند از کپی دستی بارکد، برچسب و کد رهگیری از پنل شرکت حمل خلاص شوند.
- تیمهای مالی و حسابداری: شرکتهایی که به جای ورود تکتک فروشها در Logo، Mikro، Paraşüt یا سامانه ارائهدهنده e-Fatura، انتقال خودکار میخواهند.
- شرکتهای خدماتی و اشتراکی: کسانی که میخواهند پرداخت آنلاین، دریافت دورهای، فاکتور خودکار و اطلاعرسانی به مشتری را در یک جریان واحد به هم وصل کنند.
- کسانی که میخواهند نرمافزارشان را به بیرون باز کنند: شرکتهایی که قصد دارند یک API امن و مستند در اختیار اپلیکیشن موبایل، نمایندگان فروش یا شرکای تجاری خود بگذارند.
- سازمانهایی که از چند سیستم استفاده میکنند: تیمهایی که در CRM، ERP، وبسایت و ابزارهای داخلیشان نسخههای متفاوتی از یک داده وجود دارد.
خدمات API و یکپارچهسازی ما چه مواردی را در بر میگیرد؟
اتصال به سرویسهای آماده
مستندات API سرویسهای پرداخت، حمل، مارکتپلیس، حسابداری و ارتباطی را بررسی میکنیم، شرایط دسترسی و محدودیتهای استفاده را مشخص میکنیم و اتصال را به سایت، پنل مدیریت یا اپلیکیشن موبایل شما اضافه میکنیم. اگر نرمافزار شما را شرکت دیگری توسعه داده باشد، ابتدا ساختار کد و دسترسی سرور را بررسی میکنیم.
طراحی REST API و مستندسازی
اگر میخواهید سیستم خودتان را به بیرون باز کنید، endpointها، ساختار دادهها، کدهای خطا، قواعد صفحهبندی و احراز مجوز را طراحی میکنیم. برای هر endpoint مستنداتی شامل نمونه درخواست و پاسخ آماده میکنیم تا تیم موبایل یا شرکای تجاری شما بدون حدس و گمان اتصال را برقرار کنند.
Webhook و جریانهای رویدادمحور
کاری میکنیم که رویدادی در یک سیستم، سیستم دیگر را بلافاصله به کار بیندازد: مثلاً قطعی شدن سفارش پس از تأیید پرداخت یا ارسال اعلان به مشتری هنگام تغییر وضعیت مرسوله. امضای webhookهای دریافتی را اعتبارسنجی میکنیم و حتی اگر یک اعلان دو بار برسد، عملیات را فقط یک بار اجرا میکنیم.
نگاشت داده و همگامسازی دوطرفه
اینکه هر فیلد با کدام فیلد متناظر است، کدام سیستم منبع اصلی است و در صورت تعارض چه چیزی معتبر است را در یک جدول نگاشت مکتوب مشخص میکنیم. تفاوتهایی مانند دستهبندی، تنوع محصول، نرخ مالیات و واحد، پیش از نوشتن کد و در همین مرحله حل میشوند.
وظایف زمانبندیشده و انتقال انبوه
برای سیستمهایی که اعلان لحظهای ارائه نمیدهند، وظایفی تعریف میکنیم که در فواصل مشخص اجرا میشوند. فایلهای XML تأمینکنندگان، فهرستهای قیمت انبوه، نرخ ارز و فایلهای موجودی با این وظایف به طور منظم وارد یا خارج میشوند.
صفحات پنل و پایش
برای اینکه وضعیت یکپارچهسازی را از پنل مدیریت خود ببینید، میتوانیم گزارش عملیات، فهرست خطاها و صفحات ارسال مجدد دستی اضافه کنیم. وقتی سفارشی منتقل نشود، تیم شما خودش دلیل آن و راه ارسال دوباره رکورد را میبیند.
یکپارچهسازی پرداخت و درگاه بانکی
یکپارچهسازی زیرساخت پرداخت
پرداخت با کارت را به سایت یا اپلیکیشن شما اضافه میکنیم: احراز هویت 3D Secure، گزینههای پرداخت اقساطی، بازگشت وجه کامل و جزئی و در صورت پشتیبانی ارائهدهنده، ذخیره کارت و پرداخت دورهای. نتیجه پرداخت را فقط به بازگشت مرورگر واگذار نمیکنیم و آن را با اعلان سرور به سرور ارائهدهنده تأیید میکنیم. اطلاعات کارت روی سرور شما نگهداری نمیشود و از طریق فرم پرداخت امن ارائهدهنده دریافت میشود.
یکپارچهسازی درگاه پرداخت بانکی (Virtual POS)
اگر مستقیماً با بانک خود قرارداد درگاه پرداخت دارید، پرداخت را بدون واسطه به زیرساخت بانک وصل میکنیم. جریان 3D Secure، جدول اقساط بر اساس برنامههای کارت، پیشمجوز و تسویه بعدی، ابطال و بازگشت وجه در محدوده کار است. اگر با چند بانک کار میکنید، میتوان هدایت تراکنش به درگاه مناسب را بر اساس نوع کارت طراحی کرد.
یکپارچهسازی API حمل و لجستیک
یکپارچهسازی API ارسال داخلی
با تأیید سفارش، رکورد مرسوله به طور خودکار در شرکت حمل ایجاد میشود؛ بارکد و برچسب از پنل شما چاپ میشود و کد رهگیری به سفارش و به ایمیل یا پیامکی که برای مشتری ارسال میشود اضافه میگردد. وضعیت مرسولهها با webhook یا استعلام دورهای بهروز میشود. محاسبه وزن حجمی (desi) و هزینه، تولید کد مرجوعی و اطلاعات پرداخت در محل نیز تا جایی که API شرکت حمل اجازه دهد پیاده میشود. یکپارچهسازی با Yurtiçi Kargo، Aras Kargo و MNG Kargo پرتقاضاترین نمونهها هستند.
یکپارچهسازی ارسال بینالمللی
اگر به خارج از کشور ارسال دارید، مراحل استعلام قیمت، ایجاد مرسوله، آمادهسازی برچسب و اسناد گمرکی، درخواست پیک و رهگیری بینالمللی را به سیستم شما متصل میکنیم. در یکپارچهسازی API شرکت DHL Express، وزن، ابعاد و اطلاعات محصول لازم برای گمرک به طور خودکار از سفارش برداشته میشود؛ همین رویکرد برای UPS، FedEx، Aramex و Royal Mail هم به کار میرود.
یکپارچهسازی مارکتپلیس، e-Fatura و حسابداری
یکپارچهسازی مارکتپلیس
محصولات شما را از یک جا مدیریت و به مارکتپلیسها منتقل میکنیم: تطبیق دستهبندی و ویژگیها، بهروزرسانی موجودی و قیمت، دریافت سفارشها در پنل شما، بازگرداندن اطلاعات ارسال به مارکتپلیس و فرایندهای لغو و مرجوعی. یکپارچهسازی API ترندیول (Trendyol)، اتصال به Hepsiburada و اتصال Amazon SP-API پرتقاضاترین نمونهها هستند. قواعد قیمت یا موجودی ویژه هر مارکتپلیس نیز قابل تعریف است.
یکپارچهسازی پلتفرم فروشگاه اینترنتی
اگر فروشگاه شما روی Shopify، WooCommerce یا پلتفرم دیگری است، سفارشها را به نرمافزار حسابداری و موجودی را به انبار یا سیستم ERP شما وصل میکنیم. هنگام مهاجرت از یک پلتفرم به پلتفرم دیگر نیز برای انتقال دادههای محصول، مشتری و سفارش از همین اتصالها استفاده میکنیم.
یکپارچهسازی e-Fatura، e-Arşiv و e-İrsaliye
با تکمیل فروش، بررسی میشود که آیا خریدار مشمول e-Fatura است یا نه؛ بر اساس نتیجه، فاکتور e-Fatura یا e-Arşiv از طریق ارائهدهنده مجاز (özel entegratör) شما صادر میشود، فایل PDF آن برای مشتری ارسال و شماره فاکتور در سفارش ثبت میشود. e-İrsaliye برای محمولهها، دریافت فاکتورهای ورودی و فرایندهای ابطال نیز بر اساس API ارائهدهنده پیاده میشود.
یکپارچهسازی حسابداری و ERP
حسابهای اشخاص، کارتهای کالا، سفارشها، فاکتورها و دریافتیها به طور خودکار به سیستم حسابداری یا ERP شما منتقل میشوند و در صورت نیاز موجودی و قیمت در جهت عکس به سایت بازمیگردد. چون رکوردها با کلیدهای تطبیق نگهداری میشوند، یک فاکتور دو بار ایجاد نمیشود. برای کسبوکارهای مستقر در بریتانیا اتصال به Xero، QuickBooks، QuickFile و Sage نیز امکانپذیر است.
APIهای ارتباطی، نقشه، احراز هویت و سایر سرویسها
CRM و ابزارهای کاری
فرمهای وب، درخواستهای پیشنهاد قیمت و ثبتنام مشتریان جدید به صورت مخاطب و فرصت فروش در CRM شما ثبت میشوند؛ وقتی مرحله فروش تغییر کند، از طریق Slack یا Teams به تیم شما اعلان میرود. درخواستهای پشتیبانی هم میتوانند به کارت Jira یا Trello تبدیل شوند.
پیامک، WhatsApp و پیامرسانها
تأیید سفارش، کد رهگیری مرسوله، یادآوری نوبت و کدهای تأیید یکبارمصرف از طریق پیامک یا WhatsApp ارسال میشوند. پیامهای قالبدار تأییدشده از طریق WhatsApp Business Platform (Cloud API) طراحی میشوند و در پیامهای تجاری رضایت گیرنده رعایت میشود.
ارسال ایمیل
ایمیلهای تراکنشی مانند سفارش، فاکتور و بازنشانی رمز عبور را به یک سرویس ارسال ایمیل وصل میکنیم و با تنظیم رکوردهای SPF، DKIM و DMARC خطر رفتن ایمیلها به پوشه اسپم را کاهش میدهیم. فهرستهای خبرنامه را میتوان با Mailchimp یا Brevo همگام کرد.
نقشه و سرویسهای موقعیت مکانی
قابلیتهایی مانند یابنده شعبه و نمایندگی، تکمیل خودکار نشانی، یافتن مختصات از روی نشانی، هزینه ارسال بر اساس مسافت و کنترل محدوده تحویل با سرویسهای نقشه پیاده میشوند.
احراز هویت و ورود
مشتریان شما میتوانند بدون ساختن رمز عبور، با حساب Google، Apple، Microsoft یا Facebook وارد شوند؛ در اپلیکیشنهای سازمانی، ورود متمرکز با OAuth 2.0 و OpenID Connect برقرار میشود. در صورت نیاز، اعتبارسنجی شماره ملی ترکیه (T.C. kimlik) نیز اضافه میشود.
ابزارهای Google و موتورهای جستجو
رویدادهای Google Analytics 4 و Tag Manager را برای ردیابی تبدیل، فید Merchant Center را برای فهرست محصولات، Calendar را برای نوبتدهی و Sheets را برای گزارشها متصل میکنیم. صفحات جدید و بهروزشده را میتوان با IndexNow به Bing و Yandex اعلام کرد.
یکپارچهسازی هوش مصنوعی
برای کارهایی مانند تهیه پیشنویس توضیحات محصول، دستهبندی درخواستهای پشتیبانی، خلاصهسازی اسناد و جستجوی معنایی در محتوای خودتان، مدلهای زبانی بزرگ را به سیستم شما وصل میکنیم. فقط دادههای لازم به مدل ارسال میشود و خروجیها را میتوان پیش از انتشار برای تأیید انسانی قرار داد.
ویدیو، جلسه و رزرو
ویدیوهای آموزشی از طریق YouTube، Vimeo یا Bunny Stream منتشر میشوند و برای نوبتهای آنلاین لینک Zoom یا Google Meet به طور خودکار ساخته میشود. در کسبوکارهای اقامتی، اطلاعات اتاق، قیمت و رزرو با نرمافزار مدیریت کانال (Channel Manager) همگام میشود.
اعلان موبایل و سرویسهای اپلیکیشن
اعلان فوری (Push)، تأیید خرید درونبرنامهای و اشتراک، گزارش کرش و سرویسهای پایش خطا را به اپلیکیشن موبایل شما وصل میکنیم. خریدها با اعتبارسنجی سمت سرور فروشگاه اپلیکیشن کنترل میشوند.
سایر منابع داده و پروتکلها
بهروزرسانی روزانه قیمت با نرخ ارز بانک مرکزی ترکیه (TCMB)، انتقال انبوه محصول با فایلهای XML تأمینکنندگان و فایلهای Excel یا CSV، تبادل فایل از طریق FTP یا SFTP، سرویسهای SOAP در سیستمهای سازمانی قدیمی و APIهای GraphQL نیز در این محدوده قرار دارند.
درباره شرکتهای این فهرستها: اینها سیستمهایی هستند که میتوانیم از طریق API آنها یکپارچهسازی انجام دهیم و این به معنای همکاری تجاری، نمایندگی یا تأیید رسمی نیست. برای یکپارچهسازی، باید در شرکت مربوطه حساب و دسترسی API متعلق به خودتان را داشته باشید. سیستمهایی که در فهرست نیستند اما API دارند نیز قابل اتصال هستند.
REST، SOAP، webhook یا انتقال فایل: کدام روش و چه زمانی؟
| روش | نحوه کار | موارد مناسب | نکاتی که رعایت میکنیم |
|---|---|---|---|
| REST API | درخواست و پاسخ از طریق HTTPS، بیشتر در قالب JSON | بیشتر سرویسهای پرداخت، مارکتپلیس، حمل و CRM | محدودیتهای استفاده، تمدید توکن، تغییر نسخهها |
| SOAP | فراخوانی سرویس مبتنی بر XML که با WSDL تعریف شده است | برخی سرویسهای بانکی، حمل، e-Fatura و دولتی و سیستمهای سازمانی قدیمی | اعتبارسنجی schema، گواهیها، مدیریت timeout |
| Webhook | سیستم مقابل هنگام وقوع یک رویداد به نشانی شما اعلان میفرستد | رویدادهای لحظهای مانند تأیید پرداخت، وضعیت مرسوله و تغییر سفارش | اعتبارسنجی امضا، اعلانهای تکراری، استعلام رویدادهای ازدسترفته |
| انتقال فایل (XML / CSV / FTP) | فایلها در فواصل مشخص آماده، بارگذاری یا دریافت میشوند | فهرست محصولات تأمینکنندگان، قیمت و موجودی انبوه، سیستمهای بدون API | کنترل قالب، رمزگذاری نویسهها (encoding)، فایلهای ناقص |
در بیشتر پروژهها این روشها با هم به کار میروند: سفارش با REST ارسال میشود، تغییر وضعیت با webhook میرسد و فایل موجودی انبوه روزی یک بار دریافت میشود. انتخاب روش را امکانات سیستم مقابل و میزان بهروز بودن موردنیاز داده تعیین میکند.
رویکرد فنی ما در یکپارچهسازیها
- اعتبارسنجی در سمت سرور: هر دادهای که از سیستم بیرونی میرسد از نظر قالب، نوع و فیلدهای الزامی بررسی میشود و رکورد نادرست وارد سیستم نمیشود.
- مقاومت در برابر درخواستهای تکراری: حتی اگر یک سفارش یا اعلان چند بار برسد، عملیات فقط یک بار اجرا میشود.
- صف و تلاش مجدد: وقتی سیستم مقابل موقتاً پاسخ ندهد، درخواستها به شکل کنترلشده دوباره ارسال میشوند و خطاهای دائمی گزارش میشوند.
- گزارش عملیات: اینکه کدام داده، چه زمانی و به کدام سیستم ارسال شده قابل ردیابی است و منشأ مشکل بهراحتی پیدا میشود.
- اول محیط تست: اتصالهای پرداخت، حمل و e-Fatura ابتدا در محیط تست ارائهدهندگان آزموده میشوند و سپس به محیط واقعی منتقل میشوند.
- حفاظت از کلیدهای محرمانه: کلیدهای API نه در کد، بلکه در فایلهای پیکربندی غیرقابل دسترس از وب نگهداری میشوند و مجوزها بر اساس اصل حداقل دسترسی داده میشوند.
- دقت در دادههای شخصی: داده منتقلشده به میزان نیاز کار محدود میماند، اتصالها از کانالهای رمزنگاریشده برقرار میشوند و اصول KVKK و GDPR رعایت میشود.
- رعایت محدودیتهای استفاده: عملیات انبوه بر اساس محدودیت درخواست ارائهدهندگان تقسیم میشود و استعلامهای غیرضروری با کش کاهش مییابد.
پروژه یکپارچهسازی API چگونه پیش میرود؟
- شناخت: سیستمهایی که استفاده میکنید، کارهایی که دستی انجام میشود و اینکه کدام داده باید به کجا برود را با هم مشخص میکنیم.
- بررسی فنی: مستندات API، شرایط دسترسی، محیطهای تست و محدودیتهای استفاده سرویسهای موردنظر را بررسی میکنیم.
- محدوده و پیشنهاد قیمت: پیشنهادی مکتوب شامل جدول نگاشت داده، نمودار جریان، زمان و هزینه ارائه میدهیم.
- توسعه و تست: یکپارچهسازی را در محیط تست پیاده میکنیم و با سناریوهای واقعی و حالتهای خطا میآزماییم.
- انتقال به محیط واقعی: با اطلاعات دسترسی واقعی راهاندازی میکنیم و نخستین تراکنشها را همراه شما پایش میکنیم.
- پایش و پشتیبانی: تغییرات نسخه در سمت ارائهدهنده را دنبال میکنیم و بهروزرسانیهای لازم را برنامهریزی میکنیم.
هزینه یکپارچهسازی بر چه اساسی تعیین میشود؟
- تعداد سیستمها: تعداد سرویسهایی که باید متصل شوند و ساختار API هر کدام.
- جهت جریان داده: اینکه انتقال یکطرفه لازم است یا همگامسازی دوطرفه.
- نیاز به بهروز بودن: اینکه داده به صورت لحظهای منتقل شود یا در فواصل مشخص.
- پیچیدگی نگاشت: اینکه تفاوتهای دستهبندی، تنوع محصول، مالیات و واحد چه میزان تبدیل لازم دارند.
- امکانات ارائهدهنده: کیفیت مستندات API و وجود یا نبود محیط تست و پشتیبانی از webhook.
- پنل و گزارشگیری: اینکه صفحات پایش، فهرست خطا و ارسال مجدد دستی جزو محدوده کار باشند یا نه.
زمان و هزینه پس از مرحله شناخت و بررسی فنی، در پیشنهاد مکتوب قطعی میشود.
چرا ADK Yazılım؟
- روشهایی که در زیرساخت خودمان به کار میبریم: در سیستم سفارش ما، پرداخت کارتی، اعلانهای تأیید پرداخت، فاکتور خودکار، اعلانهای ایمیلی و پیامکی به هم متصل کار میکنند.
- محدوده روشن، زمان روشن، قیمت روشن: اینکه کدام داده در چه جهتی منتقل میشود و چه مواردی خارج از محدوده است، در پیشنهاد قیمت نوشته میشود.
- کد آزموده و امن: هر یکپارچهسازی همراه با سناریوهای خطا تست میشود و اطلاعات محرمانه محافظت میشوند.
- سیستمهای محلی و بینالمللی: علاوه بر درگاه بانکی، e-Fatura و حمل داخلی ترکیه، سرویسهای بینالمللی مانند Stripe، Xero و Royal Mail را هم متصل میکنیم.
- پشتیبانی پس از راهاندازی: با تغییرات ارائهدهنده، بهروزرسانی انجام میدهیم و درخواستهای پشتیبانی خود را از پنل مشتری ارسال میکنید.

