API-інтеграція дозволяє програмам, якими ви користуєтеся, обмінюватися даними між собою. Якщо ваш сайт, інтернет-магазин, платіжна система, служба доставки, акаунти на маркетплейсах, провайдер e-Fatura та бухгалтерська програма зберігають ту саму інформацію окремо, ваша команда щодня вручну вводить одні й ті самі дані на кількох екранах. Ми з’єднуємо ці системи через їхні API, щоб дані надходили в потрібне місце, у потрібний час і з можливістю відстеження.
Типові приклади цієї послуги: створення відправлення для оплаченого замовлення й надсилання номера відстеження клієнту, виставлення рахунку як e-Fatura або e-Arşiv, оновлення товарів на Trendyol і Hepsiburada при зміні залишків, передача нової заявки з форми в CRM. Інтеграції, для яких готового плагіна недостатньо і які мають працювати за вашими бізнес-правилами, ми розробляємо індивідуально.
На цій сторінці ви знайдете системи, з якими ми можемо інтегруватися, згруповані за категоріями та з назвами компаній: API-інтеграція служб доставки, інтеграція віртуального POS-термінала, інтеграція маркетплейсів, інтеграція e-Fatura, підключення бухгалтерських та ERP-систем, SMS, WhatsApp, карти, штучний інтелект тощо. У кожній картці ми також пояснюємо, яку практичну користь дає інтеграція.
Кому підходить API-інтеграція?
- Інтернет-магазинам: тим, хто хоче керувати товарами, залишками, цінами й замовленнями з одного центру для свого сайту та маркетплейсів Trendyol, Hepsiburada, N11 і Amazon.
- Компаніям, що щодня готують відправлення: тим, хто більше не хоче вручну копіювати штрихкод, етикетку й номер відстеження з кабінету служби доставки.
- Фінансовим і бухгалтерським відділам: компаніям, яким потрібна автоматична передача продажів у Logo, Mikro, Paraşüt або до провайдера e-Fatura замість ручного введення кожного запису.
- Сервісним компаніям і бізнесу з підписками: тим, хто хоче об’єднати онлайн-оплату, регулярні списання, автоматичні рахунки та сповіщення клієнтів в один процес.
- Тим, хто хоче відкрити своє ПЗ назовні: компаніям, яким потрібен безпечний і задокументований API для мобільного застосунку, дилерів або партнерів.
- Організаціям із кількома системами: командам, у яких у CRM, ERP, на сайті та у внутрішніх інструментах зберігаються різні версії тих самих даних.
Що входить у нашу послугу API та інтеграцій?
Підключення до готових сервісів
Ми вивчаємо документацію API платіжних, логістичних, бухгалтерських і комунікаційних сервісів та маркетплейсів, з’ясовуємо умови доступу й ліміти використання та додаємо інтеграцію на ваш сайт, у панель керування або мобільний застосунок. Якщо ваше ПЗ розробляла інша компанія, спершу ми аналізуємо структуру коду й доступ до сервера.
Проєктування REST API та документація
Якщо ви хочете відкрити свою систему назовні, ми проєктуємо ендпоінти, структури даних, коди помилок, правила пагінації та авторизації. Для кожного ендпоінта готуємо документацію з прикладами запитів і відповідей, тож ваша мобільна команда чи партнери налаштовують підключення без здогадок.
Webhook і подієві процеси
Ми налаштовуємо так, щоб подія в одній системі миттєво запускала дію в іншій: наприклад, замовлення підтверджується після схвалення оплати, а клієнт отримує сповіщення, коли змінюється статус доставки. Ми перевіряємо підпис вхідних webhook і виконуємо операцію лише один раз, навіть якщо те саме сповіщення надійшло двічі.
Зіставлення даних і двостороння синхронізація
У письмовій таблиці зіставлення ми визначаємо, яке поле якому відповідає, яка система є основним джерелом і що має пріоритет у разі конфлікту. Розбіжності в категоріях, варіантах, ставках податку та одиницях виміру вирішуються на цьому етапі, ще до написання коду.
Заплановані завдання та пакетне перенесення
Для систем, які не надсилають миттєвих сповіщень, ми налаштовуємо завдання, що запускаються з певною періодичністю. Так регулярно імпортуються або експортуються XML-файли постачальників, пакетні прайс-листи, курси валют і файли залишків.
Екрани в панелі та моніторинг
Щоб ви бачили стан інтеграції у своїй панелі керування, ми можемо додати журнали операцій, списки помилок і екрани ручного повторного надсилання. Якщо замовлення не передалося, ваша команда сама бачить причину та спосіб надіслати запис повторно.
Інтеграції платежів і віртуальних POS-терміналів
Інтеграція платіжної системи
Ми додаємо оплату карткою на ваш сайт або в застосунок: перевірку 3D Secure, оплату частинами, повне й часткове повернення коштів, а якщо провайдер підтримує, то й збережені картки та регулярні платежі. Результат оплати ми не довіряємо лише переадресації браузера, а підтверджуємо сповіщенням, яке провайдер надсилає з сервера на сервер. Дані карток не зберігаються на вашому сервері, вони вводяться через захищену платіжну форму провайдера.
Інтеграція банківського віртуального POS-термінала
Якщо у вас є прямий договір інтернет-еквайрингу з банком, ми підключаємо оплату безпосередньо до інфраструктури банку без посередників. До обсягу робіт входять процес 3D Secure, таблиця розстрочок за картковими програмами, попередня авторизація з подальшим списанням, скасування та повернення. Якщо ви працюєте з кількома банками, можна налаштувати маршрутизацію на потрібний POS залежно від типу картки.
API-інтеграції служб доставки та логістики
API-інтеграція внутрішніх служб доставки
Коли замовлення підтверджено, відправлення автоматично створюється у службі доставки; штрихкод і етикетка друкуються з вашої панелі, а номер відстеження додається до замовлення та до листа або SMS для клієнта. Статуси відправлень оновлюються через 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 через вашого приватного інтегратора, PDF надсилається клієнту, а номер рахунку записується до замовлення. Для відвантажень також налаштовуються e-İrsaliye, імпорт вхідних рахунків і процеси анулювання відповідно до API інтегратора.
Інтеграція з бухгалтерією та ERP
Контрагенти, товарні картки, замовлення, рахунки та надходження автоматично передаються у вашу бухгалтерську або ERP-систему; за потреби залишки й ціни повертаються на сайт у зворотному напрямку. Записи зберігаються з ключами зіставлення, тому той самий рахунок не створюється двічі. Для компаній у Великій Британії також можна налаштувати підключення до Xero, QuickBooks, QuickFile і Sage.
Комунікації, карти, автентифікація та інші API
CRM і робочі інструменти
Вебформи, запити на комерційну пропозицію та реєстрації нових клієнтів потрапляють у вашу CRM як контакти й угоди; коли змінюється етап продажу, ваша команда отримує сповіщення в Slack або Teams. Звернення до підтримки можуть автоматично ставати картками в Jira чи Trello.
SMS, WhatsApp і месенджери
Підтвердження замовлення, номер відстеження посилки, нагадування про запис і одноразові коди підтвердження надсилаються через SMS або 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 для звітів. Про нові та оновлені сторінки можна повідомляти Bing і Yandex через IndexNow.
Інтеграція штучного інтелекту
Ми підключаємо великі мовні моделі до вашої системи для таких завдань, як чернетки описів товарів, класифікація звернень до підтримки, стисле викладення документів і семантичний пошук у вашому власному контенті. Моделі передаються лише необхідні дані; результати можна відправляти на схвалення людиною перед публікацією.
Відео, зустрічі та бронювання
Навчальні відео публікуються через YouTube, Vimeo або Bunny Stream; для онлайн-записів автоматично створюється посилання на Zoom чи Google Meet. У закладах розміщення дані про номери, ціни та бронювання синхронізуються з менеджером каналів.
Мобільні сповіщення та сервіси для застосунків
Ми підключаємо до вашого мобільного застосунку push-сповіщення, перевірку вбудованих покупок і підписок, звіти про збої та моніторинг помилок. Покупки перевіряються через серверну валідацію магазину застосунків.
Інші джерела даних і протоколи
Сюди також входять щоденне оновлення цін за курсами валют TCMB, пакетне перенесення товарів із XML-файлів постачальників, Excel або CSV, обмін файлами через FTP чи SFTP, SOAP-сервіси старих корпоративних систем і GraphQL API.
Щодо компаній у списках: це системи, з якими ми можемо інтегруватися через їхні API; це не означає партнерства, дилерства чи офіційного схвалення. Для інтеграції у вас має бути власний акаунт і доступ до API у відповідній компанії. Можна підключити й системи, яких немає у списку, якщо вони мають API.
REST, SOAP, webhook чи перенесення файлів: який спосіб коли використовувати?
| Спосіб | Як працює | Коли підходить | На що ми звертаємо увагу |
|---|---|---|---|
| REST API | Запити й відповіді через HTTPS, переважно у форматі JSON | Більшість платіжних, логістичних і CRM-сервісів та маркетплейсів | Ліміти використання, оновлення токенів, зміни версій |
| SOAP | Виклики сервісів на основі XML, описані через WSDL | Деякі банківські, логістичні, e-Fatura та державні сервіси, старі корпоративні системи | Валідація схеми, сертифікати, керування тайм-аутами |
| Webhook | Зовнішня система надсилає сповіщення на вашу адресу, коли відбувається подія | Миттєві події: підтвердження оплати, статус доставки, зміна замовлення | Перевірка підпису, повторні сповіщення, запит пропущених подій |
| Перенесення файлів (XML / CSV / FTP) | Файли з певною періодичністю формуються, завантажуються або отримуються | Товарні списки постачальників, пакетні ціни й залишки, системи без API | Перевірка формату, кодування символів, незавершені файли |
У більшості проєктів ці способи поєднуються: замовлення надсилається через REST, зміна статусу надходить через webhook, а пакетний файл залишків отримується раз на день. Вибір визначають можливості зовнішньої системи та те, наскільки актуальними мають бути дані.
Наш технічний підхід до інтеграцій
- Перевірка на боці сервера: кожні дані із зовнішньої системи перевіряються на формат, тип і обов’язкові поля; некоректний запис у систему не потрапляє.
- Стійкість до повторних запитів: навіть якщо те саме замовлення чи сповіщення надійде кілька разів, операція виконується лише один раз.
- Черга та повторні спроби: якщо зовнішня система тимчасово не відповідає, запити контрольовано повторюються, а про постійні помилки надходить сповіщення.
- Журнали операцій: можна відстежити, які дані, коли і в яку систему було надіслано; джерело проблеми легко знайти.
- Спершу тестове середовище: підключення платежів, доставки та e-Fatura спочатку перевіряються в тестових середовищах провайдерів, а вже потім запускаються в роботу.
- Захист секретних ключів: API-ключі зберігаються не в коді, а в конфігураційних файлах, недоступних із вебу; права надаються за принципом мінімальних привілеїв.
- Дбайливе ставлення до персональних даних: передаються лише ті дані, яких потребує завдання, з’єднання встановлюються через зашифровані канали, дотримуються принципи KVKK і GDPR.
- Дотримання лімітів використання: пакетні операції розбиваються відповідно до лімітів запитів провайдерів, а зайві запити скорочуються завдяки кешуванню.
Як проходить проєкт API-інтеграції?
- Дослідження: разом визначаємо, якими системами ви користуєтеся, які операції виконуються вручну та які дані куди мають надходити.
- Технічний аналіз: вивчаємо документацію API сервісів для підключення, умови доступу, тестові середовища та ліміти використання.
- Обсяг і пропозиція: надаємо письмову пропозицію з таблицею зіставлення даних, схемою процесів, термінами та ціною.
- Розробка й тестування: налаштовуємо інтеграцію в тестовому середовищі та перевіряємо її на реалістичних сценаріях і помилкових ситуаціях.
- Запуск: вводимо в роботу з реальними даними доступу й разом із вами стежимо за першими операціями.
- Моніторинг і підтримка: відстежуємо зміни версій на боці провайдера та плануємо необхідні оновлення.
Від чого залежить ціна інтеграції?
- Кількість систем: скільки сервісів потрібно підключити та яка структура API кожного з них.
- Напрям потоку даних: чи потрібне одностороннє перенесення, чи двостороння синхронізація.
- Вимоги до актуальності: чи передаються дані миттєво, чи з певною періодичністю.
- Складність зіставлення: скільки перетворень вимагають розбіжності в категоріях, варіантах, податках і одиницях виміру.
- Можливості провайдера: якість документації API, наявність тестового середовища та підтримки webhook.
- Панель і звітність: чи входять в обсяг екрани моніторингу, списку помилок і ручного повторного надсилання.
Терміни та ціна остаточно визначаються в письмовій пропозиції після дослідження й технічного аналізу.
Чому ADK Yazılım?
- Методи, які ми застосовуємо у власній інфраструктурі: у нашій системі замовлень пов’язано між собою оплату карткою, сповіщення про підтвердження оплати, автоматичні рахунки, листи й SMS.
- Чіткий обсяг, чіткі терміни, чітка ціна: у пропозиції прописано, які дані й у якому напрямку передаються та що не входить в обсяг робіт.
- Протестований, безпечний код: кожна інтеграція тестується разом зі сценаріями помилок, секретні дані захищені.
- Локальні та міжнародні системи: окрім віртуальних POS-терміналів, e-Fatura та внутрішніх служб доставки, ми підключаємо й міжнародні сервіси, як-от Stripe, Xero і Royal Mail.
- Підтримка після запуску: ми оновлюємо інтеграції, коли провайдери вносять зміни; запити на підтримку ви надсилаєте через клієнтську панель.

