API inteqrasiyası istifadə etdiyiniz proqramların bir-birinə məlumat göndərməsini və bir-birindən məlumat almasını təmin edir. Veb saytınız, onlayn mağazanız, ödəniş infrastrukturunuz, kargo şirkətiniz, marketpleys hesablarınız, e-Fatura inteqratorunuz və mühasibat proqramınız eyni məlumatı ayrı-ayrılıqda saxlayırsa, deməli komandanız hər gün eyni məlumatı bir neçə ekrana əl ilə daxil edir. Biz bu sistemləri API-ləri vasitəsilə bir-birinə bağlayır, məlumatı düzgün yerə, düzgün vaxtda və izlənilə bilən şəkildə ötürürük.
Ödənişi təsdiqlənən sifariş üçün kargo göndərişinin yaradılması və izləmə nömrəsinin müştəriyə çatması, fakturanın e-Fatura və ya e-Arşiv kimi tərtib edilməsi, stok dəyişəndə Trendyol və Hepsiburada-dakı məhsulların yenilənməsi, yeni form müraciətinin CRM-ə düşməsi bu xidmətin tipik nümunələridir. Hazır plaqinin kifayət etmədiyi, sizin iş qaydalarınıza uyğun işləməli olan bağlantıları xüsusi olaraq hazırlayırıq.
Bu səhifədə inteqrasiya edə biləcəyimiz sistemləri kateqoriyalar üzrə, şirkət adları ilə tapa bilərsiniz: kargo API inteqrasiyası, virtual POS inteqrasiyası, marketpleys inteqrasiyası, e-Fatura inteqrasiyası, mühasibat və ERP bağlantıları, SMS, WhatsApp, xəritə, süni intellekt və daha çoxu. Hər kartda inteqrasiyanın praktikada hansı işə yaradığını da izah edirik.
API inteqrasiyası kimlər üçün uyğundur?
- E-ticarət müəssisələri: Saytı ilə Trendyol, Hepsiburada, N11 və Amazon kimi marketpleyslər arasında məhsul, stok, qiymət və sifarişləri vahid mərkəzdən idarə etmək istəyən mağazalar.
- Hər gün göndəriş hazırlayan şirkətlər: Barkodu, etiketi və izləmə nömrəsini kargo şirkətinin ekranından əl ilə köçürməkdən qurtulmaq istəyən müəssisələr.
- Maliyyə və mühasibat komandaları: Satışları Logo, Mikro, Paraşüt və ya e-Fatura inteqratoruna tək-tək daxil etmək əvəzinə avtomatik ötürmə istəyən şirkətlər.
- Xidmət və abunə şirkətləri: Onlayn ödənişi, təkrarlanan ödənişləri, avtomatik fakturanı və müştəri bildirişlərini vahid axına bağlamaq istəyənlər.
- Proqram təminatını xaricə açmaq istəyənlər: Mobil tətbiqinə, dilerlərinə və ya biznes tərəfdaşlarına təhlükəsiz və sənədləşdirilmiş API təqdim etmək istəyən şirkətlər.
- Bir neçə sistemdən istifadə edən qurumlar: CRM, ERP, veb sayt və daxili alətlərində eyni məlumatın fərqli versiyaları olan komandalar.
API və inteqrasiya xidmətimiz nələri əhatə edir?
Hazır xidmətlərə qoşulma
Ödəniş, kargo, marketpleys, mühasibat və kommunikasiya xidmətlərinin API sənədlərini öyrənir, giriş şərtlərini və istifadə limitlərini müəyyənləşdirir, bağlantını saytınıza, idarəetmə panelinizə və ya mobil tətbiqinizə əlavə edirik. Proqram təminatınızı başqa şirkət hazırlayıbsa, əvvəlcə kod strukturunu və server girişini yoxlayırıq.
REST API dizaynı və sənədləşdirmə
Öz sisteminizi xaricə açmaq istəyirsinizsə, son nöqtələri, məlumat strukturlarını, xəta kodlarını, səhifələmə və avtorizasiya qaydalarını dizayn edirik. Hər son nöqtə üçün nümunə sorğu və cavabları olan sənədləşdirmə hazırlayırıq; mobil komandanız və ya biznes tərəfdaşlarınız bağlantını təxmin etmədən qurur.
Webhook və hadisə əsaslı axınlar
Bir sistemdəki hadisənin digərini dərhal işə salmasını təmin edirik: ödəniş təsdiqlənəndə sifarişin qəti hal alması, kargo statusu dəyişəndə müştəriyə bildiriş getməsi kimi. Daxil olan webhook-ların imzasını yoxlayır, eyni bildiriş iki dəfə gəlsə belə əməliyyatı yalnız bir dəfə icra edirik.
Məlumat uyğunlaşdırması və ikitərəfli sinxronizasiya
Hansı sahənin hansı sahəyə uyğun gəldiyini, hansı sistemin əsas mənbə olduğunu və ziddiyyət zamanı nəyin keçərli olacağını yazılı uyğunlaşdırma cədvəlində müəyyən edirik. Kateqoriya, variant, vergi dərəcəsi və ölçü vahidi kimi fərqlər kod yazılmazdan əvvəl bu mərhələdə həll olunur.
Planlaşdırılmış tapşırıqlar və toplu ötürmə
Ani bildiriş təqdim etməyən sistemlər üçün müəyyən fasilələrlə işləyən tapşırıqlar qururuq. Təchizatçı XML-ləri, toplu qiymət siyahıları, valyuta məzənnələri və stok faylları bu tapşırıqlarla müntəzəm olaraq idxal və ya ixrac edilir.
Panel ekranları və monitorinq
İnteqrasiyanın vəziyyətini idarəetmə panelinizdən görə bilməyiniz üçün əməliyyat jurnalları, xəta siyahıları və əl ilə yenidən göndərmə ekranları əlavə edə bilərik. Sifariş ötürülmədikdə səbəbini və qeydi yenidən göndərməyin yolunu komandanız özü görür.
Ödəniş və virtual POS inteqrasiyaları
Ödəniş infrastrukturu inteqrasiyası
Kartla ödənişi saytınıza və ya tətbiqinizə əlavə edirik: 3D Secure doğrulama, taksit seçimləri, geri qaytarma və qismən geri qaytarma, provayder dəstəkləyirsə yadda saxlanmış kart və təkrarlanan ödəniş. Ödəniş nəticəsini yalnız brauzer yönləndirməsinə etibar etmir, provayderin serverdən serverə göndərdiyi bildirişlə təsdiqləyirik. Kart məlumatları sizin serverinizdə saxlanmır, provayderin təhlükəsiz ödəniş forması vasitəsilə qəbul edilir.
Bank virtual POS inteqrasiyası
Bankınızla birbaşa virtual POS müqaviləniz varsa, ödənişi vasitəçisiz bankın infrastrukturuna bağlayırıq. 3D Secure axını, kart proqramlarına görə taksit cədvəli, ilkin avtorizasiya və sonradan bağlama, ləğv və geri qaytarma əməliyyatları əhatə dairəsinə daxildir. Bir neçə bankla işləyirsinizsə, kart növünə görə düzgün POS-a yönləndirmə qurula bilər.
Kargo və logistika API inteqrasiyaları
Yerli kargo API inteqrasiyası
Sifariş təsdiqlənəndə göndəriş qeydi kargo şirkətində avtomatik yaradılır; barkod və etiket panelinizdən çap olunur, izləmə nömrəsi sifarişə və müştəriyə gedən e-poçta və ya SMS-ə əlavə edilir. Göndəriş statusları webhook ilə və ya müntəzəm sorğu ilə yenilənir. Desi və qiymət hesablaması, geri qaytarma kodunun yaradılması və qapıda ödəniş məlumatı da şirkətin API-sinin imkan verdiyi qədər qurulur. Yurtiçi Kargo, Aras Kargo və MNG Kargo inteqrasiyası ən çox istənilən nümunələrdir.
Beynəlxalq kargo inteqrasiyası
Xaricə göndəriş edirsinizsə, qiymət təklifinin alınması, göndərişin yaradılması, etiket və gömrük sənədlərinin hazırlanması, kuryer çağırılması və beynəlxalq izləmə addımlarını sisteminizə bağlayırıq. DHL Express API inteqrasiyasında çəki, ölçülər və gömrük üçün lazım olan məhsul məlumatları sifarişdən avtomatik götürülür; eyni yanaşma UPS, FedEx, Aramex və Royal Mail üçün də tətbiq olunur.
Marketpleys, e-Fatura və mühasibat inteqrasiyaları
Marketpleys inteqrasiyası
Məhsullarınızı bir yerdən idarə edib marketpleyslərə ötürürük: kateqoriya və xüsusiyyət uyğunlaşdırması, stok və qiymət yeniləməsi, sifarişlərin panelinizə çəkilməsi, kargo məlumatının marketpleysə geri göndərilməsi, ləğv və geri qaytarma prosesləri. Trendyol API inteqrasiyası, Hepsiburada inteqrasiyası və Amazon SP-API bağlantısı ən çox istənilən nümunələrdir. Marketpleysə xüsusi qiymət və ya stok qaydaları da təyin edilə bilər.
E-ticarət platforması inteqrasiyası
Mağazanız Shopify, WooCommerce və ya başqa platformadadırsa, sifarişləri mühasibat proqramınıza, stokları anbar və ya ERP sisteminizə bağlayırıq. Bir platformadan digərinə keçərkən məhsul, müştəri və sifariş məlumatlarının köçürülməsində də eyni bağlantılardan istifadə edirik.
E-Fatura, e-Arşiv və e-İrsaliye inteqrasiyası
Satış tamamlananda alıcının e-Fatura mükəllefi olub-olmadığı yoxlanılır; nəticəyə görə e-Fatura və ya e-Arşiv faktura xüsusi inteqratorunuz vasitəsilə tərtib edilir, PDF-i müştəriyə göndərilir və faktura nömrəsi sifarişə yazılır. Göndərişlərdə e-İrsaliye, daxil olan fakturaların qəbulu və ləğv prosesləri də inteqratorun API-sinə uyğun qurulur.
Mühasibat və ERP inteqrasiyası
Kontragent hesabları, stok kartları, sifarişlər, fakturalar və ödənişlər mühasibat və ya ERP sisteminizə avtomatik ötürülür; lazım olduqda stok və qiymət əks istiqamətdə sayta qayıdır. Qeydlər uyğunlaşdırma açarları ilə saxlanıldığı üçün eyni faktura iki dəfə yaradılmır. Birləşmiş Krallıqdakı müəssisələr üçün Xero, QuickBooks, QuickFile və Sage bağlantıları da qurula bilər.
Kommunikasiya, xəritə, identifikasiya və digər API-lər
CRM və iş alətləri
Veb formalar, təklif sorğuları və yeni müştəri qeydləri CRM-inizə kontakt və imkan kimi düşür; satış mərhələsi dəyişəndə komandanıza Slack və ya Teams vasitəsilə bildiriş gedir. Dəstək sorğuları Jira və ya Trello kartına çevrilə bilər.
SMS, WhatsApp və mesajlaşma
Sifariş təsdiqi, kargo izləmə nömrəsi, görüş xatırlatması və birdəfəlik təsdiq kodları SMS və ya WhatsApp ilə göndərilir. WhatsApp Business Platform (Cloud API) vasitəsilə təsdiqlənmiş şablon mesajlar qurulur; kommersiya mesajlarında alıcının razılığı nəzərə alınır.
E-poçt göndərişi
Sifariş, faktura və şifrənin bərpası kimi əməliyyat e-poçtlarını göndəriş xidmətinə bağlayır, SPF, DKIM və DMARC qeydlərini tənzimləyərək spam qovluğuna düşmə riskini azaldırıq. Bülleten siyahıları Mailchimp və ya Brevo ilə sinxronlaşdırıla bilər.
Xəritə və məkan xidmətləri
Filial və diler axtarışı, ünvanın avtomatik tamamlanması, ünvandan koordinatların tapılması, məsafəyə görə çatdırılma haqqı və çatdırılma zonasının yoxlanılması kimi funksiyalar xəritə xidmətləri ilə qurulur.
İdentifikasiya və giriş
Müştəriləriniz Google, Apple, Microsoft və ya Facebook hesabı ilə şifrə yaratmadan daxil ola bilər; korporativ tətbiqlərdə OAuth 2.0 və OpenID Connect ilə mərkəzləşdirilmiş sessiya qurulur. Lazım olduqda T.C. şəxsiyyət nömrəsinin yoxlanılması da əlavə edilir.
- Google ilə giriş
- Apple ilə giriş
- Microsoft ilə giriş
- Facebook ilə giriş
- OAuth 2.0
- OpenID Connect
- T.C. şəxsiyyət nömrəsinin yoxlanılması
Google alətləri və axtarış sistemləri
Konversiya izləməsi üçün Google Analytics 4 və Tag Manager hadisələrini, məhsul siyahıları üçün Merchant Center feed-ini, görüşlər üçün Calendar-ı, hesabatlar üçün Sheets-i bağlayırıq. Yeni və yenilənmiş səhifələr IndexNow ilə Bing və Yandex-ə bildirilə bilər.
Süni intellekt inteqrasiyası
Məhsul təsviri qaralamaları, dəstək sorğularının təsnifatı, sənədlərin xülasəsi və öz məzmunlarınızda semantik axtarış kimi işlər üçün böyük dil modellərini sisteminizə bağlayırıq. Modelə yalnız lazım olan məlumat göndərilir; nəticələr dərc edilməzdən əvvəl insan təsdiqinə təqdim oluna bilər.
Video, görüş və rezervasiya
Təlim videoları YouTube, Vimeo və ya Bunny Stream vasitəsilə yayımlanır; onlayn görüşlər üçün Zoom və ya Google Meet linki avtomatik yaradılır. Qonaqlama müəssisələrində otaq, qiymət və rezervasiya məlumatları kanal meneceri ilə sinxronlaşdırılır.
Mobil bildiriş və tətbiq xidmətləri
Mobil tətbiqinizə push bildirişləri, tətbiqdaxili satınalma və abunəliyin yoxlanılması, çökmə hesabatları və xəta monitorinqi xidmətlərini bağlayırıq. Satınalmalar mağazanın server tərəfli yoxlaması ilə nəzarət olunur.
Digər məlumat mənbələri və protokollar
TCMB valyuta məzənnələri ilə gündəlik qiymət yeniləməsi, təchizatçı XML-ləri və Excel və ya CSV faylları ilə toplu məhsul ötürülməsi, FTP və ya SFTP vasitəsilə fayl mübadiləsi, köhnə korporativ sistemlərdəki SOAP xidmətləri və GraphQL API-ləri də bu əhatəyə daxildir.
Siyahılardakı şirkətlər haqqında: Bunlar API-si vasitəsilə inteqrasiya edə biləcəyimiz sistemlərdir; tərəfdaşlıq, dilerlik və ya rəsmi təsdiq mənasını vermir. İnteqrasiya üçün müvafiq şirkətdə öz hesabınızın və API girişinizin olması lazımdır. Siyahıda olmayan, lakin API-si olan sistemlər də qoşula bilər.
REST, SOAP, webhook, yoxsa fayl ötürmə: hansı üsul nə vaxt istifadə olunur?
| Üsul | Necə işləyir | Uyğun olduğu hallar | Diqqət yetirdiyimiz məqamlar |
|---|---|---|---|
| REST API | HTTPS üzərindən, əsasən JSON formatında sorğu və cavab | Ödəniş, marketpleys, kargo və CRM xidmətlərinin əksəriyyəti | İstifadə limitləri, tokenin yenilənməsi, versiya dəyişiklikləri |
| SOAP | WSDL ilə təyin edilmiş, XML əsaslı xidmət çağırışları | Bəzi bank, kargo, e-Fatura və dövlət xidmətləri, köhnə korporativ sistemlər | Sxem yoxlaması, sertifikatlar, gözləmə müddətinin idarəsi |
| Webhook | Qarşı sistem hadisə baş verəndə sizin ünvanınıza bildiriş göndərir | Ödəniş təsdiqi, kargo statusu, sifariş dəyişikliyi kimi ani hadisələr | İmza yoxlaması, təkrarlanan bildirişlər, buraxılmış hadisələrin sorğulanması |
| Fayl ötürmə (XML / CSV / FTP) | Fayllar müəyyən fasilələrlə hazırlanır, yüklənir və ya endirilir | Təchizatçı məhsul siyahıları, toplu qiymət və stok, API-si olmayan sistemlər | Format yoxlaması, simvol kodlaşdırması, yarımçıq qalan fayllar |
Əksər layihələrdə bu üsullar birlikdə istifadə olunur: sifariş REST ilə göndərilir, status dəyişikliyi webhook ilə gəlir, toplu stok faylı gündə bir dəfə qəbul edilir. Seçimi qarşı sistemin təqdim etdiyi imkanlar və məlumatın nə dərəcədə aktual olmalı olduğu müəyyən edir.
İnteqrasiyalarda texniki yanaşmamız
- Server tərəfində yoxlama: Xarici sistemdən gələn hər məlumat format, tip və məcburi sahələr baxımından yoxlanılır; səhv qeyd sistemə qəbul edilmir.
- Təkrarlanan sorğulara davamlılıq: Eyni sifariş və ya bildiriş bir neçə dəfə gəlsə belə, əməliyyat yalnız bir dəfə icra olunur.
- Növbə və yenidən cəhd: Qarşı sistem müvəqqəti cavab vermədikdə sorğular nəzarətli şəkildə təkrarlanır, daimi xətalar barədə bildiriş göndərilir.
- Əməliyyat jurnalları: Hansı məlumatın nə vaxt və hansı sistemə göndərildiyi izlənilə bilir; problemin mənbəyi asanlıqla tapılır.
- Əvvəlcə test mühiti: Ödəniş, kargo və e-Fatura bağlantıları əvvəlcə provayderlərin test mühitlərində sınaqdan keçirilir, canlı rejimə sonra keçilir.
- Gizli açarların qorunması: API açarları kodda deyil, vebdən əlçatan olmayan konfiqurasiya fayllarında saxlanılır; icazələr minimum imtiyaz prinsipinə əsasən verilir.
- Şəxsi məlumatlara diqqət: Ötürülən məlumat işin tələb etdiyi ilə məhdudlaşdırılır, bağlantılar şifrələnmiş kanallarla qurulur, KVKK və GDPR prinsiplərinə əməl olunur.
- İstifadə limitlərinə uyğunluq: Provayderlərin sorğu limitlərinə görə toplu əməliyyatlar hissələrə bölünür, lazımsız sorğular keşləmə ilə azaldılır.
API inteqrasiyası layihəsi necə irəliləyir?
- Kəşf: İstifadə etdiyiniz sistemləri, əl ilə görülən işləri və hansı məlumatın hara ötürülməli olduğunu birlikdə müəyyənləşdiririk.
- Texniki təhlil: Qoşulacaq xidmətlərin API sənədlərini, giriş şərtlərini, test mühitlərini və istifadə limitlərini öyrənirik.
- Əhatə dairəsi və təklif: Məlumat uyğunlaşdırma cədvəli, axın sxemi, müddət və qiyməti əhatə edən yazılı təklif təqdim edirik.
- Hazırlanma və test: İnteqrasiyanı test mühitində qurur, real ssenarilər və xəta halları ilə sınaqdan keçiririk.
- Canlı rejimə keçid: Real giriş məlumatları ilə istifadəyə veririk, ilk əməliyyatları sizinlə birlikdə izləyirik.
- Monitorinq və dəstək: Provayder tərəfindəki versiya dəyişikliklərini izləyir, lazımi yeniləmələri planlaşdırırıq.
İnteqrasiyanın qiyməti nəyə görə müəyyən edilir?
- Sistemlərin sayı: Qoşulacaq xidmətlərin sayı və hər birinin API strukturu.
- Məlumat axınının istiqaməti: Birtərəfli ötürmənin, yoxsa ikitərəfli sinxronizasiyanın tələb olunması.
- Aktuallıq ehtiyacı: Məlumatın anında, yoxsa müəyyən fasilələrlə ötürülməsi.
- Uyğunlaşdırmanın mürəkkəbliyi: Kateqoriya, variant, vergi və ölçü vahidi fərqlərinin nə qədər çevirmə tələb etməsi.
- Provayderin imkanları: API sənədlərinin keyfiyyəti, test mühitinin və webhook dəstəyinin olub-olmaması.
- Panel və hesabatlar: Monitorinq, xəta siyahısı və əl ilə yenidən göndərmə ekranlarının əhatəyə daxil olub-olmaması.
Müddət və qiymət kəşf və texniki təhlildən sonra yazılı təklifdə dəqiqləşir.
Niyə ADK Yazılım?
- Öz infrastrukturumuzda istifadə etdiyimiz üsullar: Sifariş sistemimizdə kartla ödəniş, ödəniş təsdiqi bildirişləri, avtomatik faktura, e-poçt və SMS bildirişləri bir-birinə bağlı işləyir.
- Dəqiq əhatə, dəqiq müddət, dəqiq qiymət: Hansı məlumatın hansı istiqamətdə ötürüləcəyi və əhatədən kənarda qalanlar təklifdə yazılı göstərilir.
- Test edilmiş, təhlükəsiz kod: Hər inteqrasiya xəta ssenariləri ilə birlikdə test edilir, gizli məlumatlar qorunur.
- Yerli və beynəlxalq sistemlər: Virtual POS, e-Fatura və yerli kargo ilə yanaşı Stripe, Xero və Royal Mail kimi beynəlxalq xidmətləri də bağlayırıq.
- Yayımdan sonra dəstək: Provayder dəyişikliklərində yeniləmə edirik; dəstək sorğularınızı müştəri panelindən göndərirsiniz.

