Wialon API: GPS-monitorinqin sistemlərinizlə inteqrasiyası
Wialon API vasitəsilə ERP, CRM, dispetçer xidmətiniz və ya mobil tətbiqiniz koordinatları, yürüşləri, yanacağı və hadisələri əl ilə çıxarmalar olmadan alır. Girişi veririk, startda tərtibatçılara kömək edirik və öz komandanız yoxdursa, inteqrasiyanı tam öz üzərimizə götürürük.
- 09:12 POST /hooks/geofence · Sumqayıt anbarına giriş · 200 OK
- 09:14 Sifariş №4812 → status: yükləməyə gəldi
- 10:37 POST /hooks/stop · müştəridə dayanacaq 3 dəq · 200 OK
- 11:02 POST /hooks/sos · SOS, Furqon 10-XX-123 · 200 OK
- 11:03 CRM: həyəcan siqnalı növbə rəhbərinə ötürüldü
Bortdakı məlumatdan dispetçerin qərarına qədər
Treker
Koordinatlar, sensorlar və hadisələr adi monitorinqdə olduğu kimi Wialon serverinə gedir.
Wialon
Mesajları saxlayır, hesabatları hesablayır və qaydalara uyğun sizin ünvana HTTP-sorğular göndərir.
Token və sorğular
Sisteminiz obyektləri, trekləri və hesabatları məhdud hüquqlu token ilə götürür.
ERP, CRM, sayt
Sifarişlərin statusları, 1C-də yürüşlər, saytda xəritə — əl ilə çıxarma və köçürmə olmadan.
İmkanlar və alətlər
Giriş
- Remote API: obyektlər, mesajlar, hesabatlar
- İnteqrasiyalar üçün giriş tokenləri və hüquqlar
- Webhooks: hadisə üzrə HTTP-sorğu
- Məlumatların kənar sistemlərə retranslyasiyası
Sistemlər
İnterfeyslər
- Veb və mobil tətbiqlər üçün SDK
- Saytınızda nəqliyyatı göstərən xəritə
API-dən keçən bir sifariş
Şərti nümunə: distribyutor, CRM və Sumqayıtdakı anbar. Heç kim məlumatı əl ilə köçürmür.
- Maşın anbarın geozonasına girdi vebhuk
Wialon CRM-ə HTTP-sorğu göndərir, sifariş avtomatik olaraq yükləmədə statusunu alır.
- Anbardan çıxış, müştəriyə keçid göndərilir trekinq
CRM maşını göstərən xəritəyə keçid yaradır, müştəri menecerə zəng etmədən sifarişinin harada olduğunu görür.
- Müştəridə dayanacaq yalnız 3 dəqiqə yoxlama
Boşaltma həddən qısadır — menecer CRM-də qeydi görür və müştəriyə zəng edir.
- Gün üzrə yürüş 1C-yə çıxarıldı API üzrə
Cədvəl üzrə işləyən skript yürüş və yanacaq hesabatını götürür, mühasibatlıq YSM-i fakt üzrə silir.
Wialon interfeysi artıq kifayət etməyəndə
Monitorinq tətbiq edildikdən sonrakı ilk aylarda şirkətlərin çoxuna veb-interfeys və hesabatlar bəs edir. Sonra başqa cür suallar yaranır. Mühasibatlıq yürüşü 1C-də yol vərəqəsinin yanında görmək istəyir. Satış şöbəsi müştəri sifarişi olan maşının indi harada olduğunu birbaşa CRM kartında. Loqistlər isə öz sistemlərindəki yeni reyslərin özləri monitorinqə düşməsini.
Rəqəmləri Excel-dən Excel-ə köçürmək mümkündür, lakin bu, gündəlik əl işidir və səhv mənbəyidir. Düzgün yol sistemlərin bir-biri ilə birbaşa danışmasını təmin etməkdir. Bunun üçün Wialon-un açıq API-si var, bizdə isə onu Azərbaycandakı şirkətlərin uçot sistemlərinə qoşma təcrübəsi.
Sizə ümumi şəkildə API deyil, konkret bir proqramla əlaqələndirmə lazımdırsa, ERP və CRM ilə inteqrasiya səhifəsinə də baxın. Burada söhbət alətlərin özündən və qoşulmanın necə qurulduğundan gedir.
Monitorinqdən məlumatı götürməyin dörd üsulu
Platformaya HTTP üzrə sorğular
Əsas alət. Proqramınız HTTP-sorğu göndərir və cavabı JSON-da alır. API vasitəsilə istifadəçinin interfeysdə gördüyü az qala hər şey əlçatandır:
- obyektlərin siyahısı, onların son koordinatları, sürəti və sensorların vəziyyəti
- dövr üzrə mesajların tarixçəsi — trekin xam nöqtələri
- şablonlardan hesabatların icrası və nəticələrin cədvəllərlə alınması
- geozonalar, sürücülər, qoşqular, bildirişlər
- obyektlərin yaradılması və dəyişdirilməsi, trekerə əmrlərin göndərilməsi
Sisteminizin məlumatı nə vaxt soruşacağını özünün müəyyən etdiyi hallar üçün uyğundur: 5 dəqiqədən bir, sutkada bir dəfə və ya istifadəçinin düyməsi ilə.
API-ni necə qoşuruq
İlk məktubdan işlək inteqrasiyaya qədər beş addım. Tipik məsələlərdə bir-iki həftəyə sığırıq, mürəkkəb layihələri ayrıca müzakirə edirik.
İşin qaydası
1. Məsələni araşdırırıq
Hansı məlumat, hansı sistemə, nə tezliklə və kim ona baxacaq. Tez-tez məlum olur ki, API deyil, cədvəl üzrə poçta gələn hazır hesabat lazımdır. O zaman elə də deyirik.
2. Texniki istifadəçi yaradırıq
İnteqrasiya üçün yalnız lazımi obyektlərə hüququ olan ayrıca hesab. İnteqrasiya sıradan çıxsa və ya açar sızsa, bu, dispetçerlərinizin girişinə toxunmayacaq.
3. Token veririk
İnteqrasiya parolla deyil, tokenlə avtorizasiya olunur. Tokeni müddətə və hüquqlara görə məhdudlaşdırmaq və insanların parollarını dəyişmədən istənilən an geri çağırmaq olar.
4. Tərtibatçılara kömək edirik
Məsələlərinizə uyğun sorğu nümunələri veririk, lazımi sensorların harada olduğunu və konkret trekerlərin parametrlərinin necə adlandığını göstəririk. Bu, proqramçılara sənədləşməni öyrənmək üçün günlərə qənaət edir.
5. Real məlumatda yoxlayırıq
Sisteminizdəki rəqəmləri bir-iki maşın üzrə bir həftəlik Wialon hesabatları ilə tutuşdururuq. İnteqrasiyanı bütün parka yalnız bundan sonra qoşuruq.
API üzərində adətən nə qururlar
1C-də yürüş
Hər maşın üzrə yürüşün və motosaatların yol vərəqələrinə günlük çıxarılması. Mühasibatlıq odometri əl ilə yazmağı dayandırır.
CRM-də sifarişin statusu
Menecer sövdələşmə kartında yüklü maşının anbardan çıxdığını və müştəridə təxminən bir saatdan sonra olacağını görür.
ERP-də yanacaq
Sensorlar üzrə yanacaqdoldurmalar və sərf YSM uçotuna gedir və yanacaq kartları ilə tutuşdurulur. Uyğunsuzluqlar əl ilə yekunlaşdırma olmadan görünür.
Səyyar işçilərin iş cədvəli
Geozonalar üzrə hesabatlardan obyektlərdə keçən vaxt iş cədvəlinin və işəmuzd ödənişin hesablanmasının əsasına çevrilir.
Öz BI-nız
Məlumat hər gün sizin bazanıza yığılır, analitiklər isə panelləri Power BI-da və ya digər adət etdikləri alətdə qurur.
Müştəri portalı
Böyük sifarişçi öz reyslərini özgə interfeysdə deyil, sizin kabinetinizdə görür. Qonşu məsələ — izləmə üçün açıq keçid.
Tərtibata başlamazdan əvvəl nəyi nəzərə almağa dəyər
Hətta təcrübəli komandaların büdrədiyi bir neçə məqam.
- Sorğu limitləri. Platformada sorğuların tezliyinə və həcminə məhdudiyyətlər var. 200 maşını saniyədə bir dəfə bir-bir sorğulamaq pis fikirdir. Dəyişikliklərə abunə olmaq və ya məlumatı dəstələrlə götürmək daha düzgündür.
- Sensorlar fərqli adlanır. Teltonika FMC130-da və Queclink-də eyni yanacaq parametri fərqli adlarla gəlir. Buna görə inteqrasiyada xam parametrlərə deyil, Wialon-da qurulmuş sensorlara əsaslanırıq.
- Saat qurşaqları. API vaxtı Unix formatında, yəni UTC üzrə verir. Bakı üçün fərqi (UTC+4) yaddan çıxarsanız, 1C-dəki hesabat 4 saat sürüşəcək və gecə yarısından səhər saat dördə qədərki gedişlər əvvəlki günə düşəcək.
- Obyektlərin adının dəyişməsi. Maşınları adındakı dövlət nişanına deyil, daxili identifikatora bağlayın. Nömrələr dəyişir, əlaqələndirmə isə sınmamalıdır.
Öz tərtibatçılarınız yoxdursa, inteqrasiyanı bizdən tam sifariş etmək olar — işə salındıqdan sonra SLA xidməti çərçivəsində dəstəklə birlikdə.
Sənədləşmə, ilk sorğu və səhvlərlə nə etməli
Remote API və SDK üzrə sənədləşməni Gurtam sdk.wialon.com saytında yayımlayır. İnteqrasiyanızın müraciət etdiyi serverin dəqiq ünvanı hesabın harada işlədiyindən asılıdır — onu tərtibatçılar təxmin etməsin deyə tokenlə birlikdə veririk.
İşin başlanğıcı konkret dilə bağlanmadan belə görünür:
- Token ilə giriş.
tokenparametri ilətoken/loginservisinə sorğu. Cavabda sessiya identifikatoru (eid) və istifadəçi məlumatları olan JSON gəlir. Bu identifikator növbəti sorğularda ötürülür. - Obyektlərin axtarışı.
avl_unittipi iləcore/search_itemsservisi tokenin girişi olan maşınların siyahısını qaytarır, sahələr dəsti isə bayraqlarla verilir: ad, son mesaj, sensorlar. - Hesabat. Hesabat şablonunun dövr üzrə icrası və cədvəl sətirlərinin alınması. Yürüş və yanacaq adətən məhz belə 1C-yə götürülür.
Hüquqlar token verilərkən təyin olunur: yalnız oxuma yoxsa idarəetmə, hansı obyektlər, etibarlılıq müddəti. Uçot sisteminə çıxarma üçün oxuma bəs edir. Trekerə əmr hüquqlarını ayrıca və yalnız bu həqiqətən lazım olanda veririk.
Səhvləri platforma JSON-da error sahəsi və rəqəm kodu ilə qaytarır. Nəzərə almağı xahiş etdiyimiz praktik minimum belədir:
- etibarsız sessiya — token ilə yenidən daxil olmaq və sorğunu təkrarlamaq;
- girişdən imtina — təkrarlamamaq, administratora bildirmək: tokenin hüquqları çatmır və ya obyekt qrupdan çıxarılıb;
- yanlış parametrlər — sorğunu bütövlükdə loqa yazmaq, bu, inteqrasiya kodundakı səhvdir;
- taymaut və ya serverin səhvlə cavabı — dövrədə dərhal deyil, fasilə ilə təkrarlamaq, yoxsa inteqrasiya limitlərə dirənəcək.
Sorğu tezliyinə və cavabın həcminə konkret limitlər serverin konfiqurasiyasından asılıdır. Onları startda, tərtibatçı hər beş saniyədən bir sorğulama yazmamışdan əvvəl müzakirə edirik.
Bu kimlər üçün məna daşıyır
Uçot sistemi olan şirkətlər
Yol vərəqələri, sifarişlər və ya YSM artıq 1C, SAP yaxud öz ERP-nizdə aparılırsa, API məlumatın ikiqat daxil edilməsini aradan qaldırır.
Loqistika operatorları
Hər reys barədə sifarişçilərə hesabat verən və bunu avtomatik etmək istəyən 3PL şirkətləri və ekspeditorlar.
Məhsul tərtibatçıları
Öz tətbiqinin içində hazır telematika lazım olan çatdırılma, karşerinq və icarə startapları.
Böyük parklar
Maşınların sayı yüzü keçəndə əl ilə çıxarmalar bütöv bir işçi ştatı tutmağa başlayır.
Əlaqələndirmə nümunəsi: distribyutor, CRM və Sumqayıtdakı anbar
Tipik inteqrasiyanın içəridən necə göründüyünü göstərək. İçki distribyutoru malı Sumqayıtdakı anbardan Bakı və Abşeronun mağazalarına paylayır. Sifarişlər CRM-də yaşayır, maşınlar Wialon-da, əvvəllər isə bu iki dünya kəsişmirdi.
Səhər CRM API vasitəsilə xəttə çıxan maşınların siyahısını götürür və onlara marşrut vərəqələrini bağlayır. Maşın mağazanın geozonasına girəndə Wialon webhook göndərir və CRM-dəki sifariş çatdırıldı, təsdiq gözləyir statusunu alır. Maşın nöqtədən 3 dəqiqədən tez çıxıbsa, menecer qeydi görür və müştəriyə zəng edir: ola bilsin ki, mal boşaldılmayıb.
Axşam ayrıca sorğu hər maşının yürüşünü və iş vaxtını götürüb uçot sisteminə yerləşdirir. Heç kim heç nəyi əl ilə köçürmür.
Mürəkkəblik burada kodda deyil, razılaşmalardadır: hansı statusu çatdırıldı saymaq, koordinatı olmayan nöqtələrlə nə etmək, CRM əlçatan olmayanda kim cavabdehdir. Bu sualları tərtibata başlamazdan əvvəl komandanızla danışırıq.
Maşına nə quraşdırırıq
Remote API, vebhuklar yoxsa retranslyasiya
Məlumatı götürməyin üç üsulu. Seçim mübadiləni kimin başlatdığından və çıxışda nəyin lazım olduğundan asılıdır.
| Remote API | Vebhuklar | Retranslyasiya | |
|---|---|---|---|
| Sisteminizin sorğusu üzrə məlumat | Bəli | Xeyr | Xeyr |
| Hadisə üzrə ani | Xeyr, sorğulama | Bəli | Bəli, axınla |
| Hazır Wialon hesabatları | Bəli | Xeyr | Xeyr, özünüz hesablayırsınız |
| Trekerin bütün xam mesajları | Bəli, sorğu üzrə | Xeyr | Bəli |
Quraşdırma və dəyər
Funksiya GPS.az platformasına qoşulduqdan sonra əlçatan olur. Dəyər avadanlıq, quraşdırma və SIM-kart trafiki daxil olan aylıq abonent haqqından yaranır — yekun nəqliyyatın tipindən və sensorların dəstindən asılıdır. Avtoparkınız üçün dəqiq hesablamanı 1 iş günü ərzində pulsuz hazırlayırıq.
- 1 Müraciət və maşınların siyahısı
- 2 Hesablama və quraşdırma qrafikinin razılaşdırılması
- 3 Avadanlığın sizin ərazinizdə quraşdırılması
- 4 Wialon-da hesabat və bildirişlərin qurulması, dispetçerin təlimi
Suallar: «Wialon API: GPS-monitorinqin sistemlərinizlə inteqrasiyası»
Müraciət göndərin
Mütəxəssis zəng edib texnikanıza və məsələnizə uyğun həll seçəcək.