Mündəricat
1. Etiketlər nəyi bildirir2. Bank3. Kargo və logistika4. Marketpleyslər5. Elektron sənədlər və rəsmi fayllar6. Mühasibat və məlumat ötürmə7. Rabitə və xarici xidmətlər8. Açıq API, portallar və verilənlər bazasıKömək › İnteqrasiya kataloqu
İnteqrasiya kataloqu: HNR nəyə qoşulur?
Bu səhifə HNR-in banklara, kargo şirkətlərinə, marketpleyslərə, vergi orqanına, mühasibat fayllarına və başqa proqramlara necə qoşulduğunu bir yerdə toplayır. Hər sətrin qarşısındakı etiket bugünkü reallığı deyir: nə özü işləyir, nə sizin hesabınızla və ya müqavilə ilə açılır və nə hələ yoxdur. Əgər bağlantı real hesabla sınanmayıbsa, bu açıq yazılır.
Aktuallıq. Bu kataloq 2 oktyabr 2026-cı ildə hər bənd proqramın öz kodu ilə tutuşdurularaq yazılıb. Bağlantının vəziyyəti dəyişəndə bu səhifə də yenilənir.
1. Etiketlər nəyi bildirir
- İşləyirBu gün işləyir. Kənar hesab və ya müqavilə lazım deyil; bir şey lazımdırsa, o da sizin öz serveriniz, faylınız və ya açarınızdır.
- Hazırdır, öz hesabınızla sınayınBağlantı kodu qarşı tərəfin rəsmi sənədinə uyğun tam yazılıb və HNR-in öz testlərindən keçib, lakin real hesabla sınanmayıb. İlk bağlantını qarşı tərəfin test mühitində qurub yoxlayın.
- Müqavilə lazımdırQarşı tərəf texniki sənədini yalnız müqavilə ilə verir. HNR-də onun yeri hazırdır; sənəd və giriş məlumatları gələndə bağlantı tamamlanır.
- Tezlikləİnkişaf növbəsindədir; bu gün yoxdur.
- YoxdurBu gün yoxdur və növbədə də deyil. Çox vaxt fayl yolu (CSV, XLSX, XML) eyni işi görür.
2. Bank
- İşləyirBank çıxarışının idxalı — MT940, CSV/Excel və DBS faylları oxunur; Türkiyə və İndoneziya bankları üçün hazır sütun profilləri var, öz bankınızı bir dəfə uyğunlaşdırırsınız. Hərəkətlər bal ilə fakturalarla tutuşdurulur, təsdiqinizlə qəbz yazılır.
- İşləyirBank xidməti (e-poçt və PDF) — Bankın göndərdiyi hərəkət bildiriş məktubları və PDF çıxarışlar ayrıca işləyən bank xidməti tərəfindən oxunur; POS hesablaşması da burada izlənir.
- Hazırdır, öz hesabınızla sınayınCanlı bank bağlantısı: açıq bankçılıq — Türkiyədə ÖHVPS standartı (BKM hesab məlumatı xidməti), İndoneziyada Bank Indonesia SNAP standartı (BCA, Mandiri, BNI, BRI və ümumi SNAP). Hərəkətlər çıxarış yükləmədən çəkilir; səlahiyyətli xidmət təminatçısı müqaviləsi və bankın verdiyi açarlar lazımdır.
- Müqavilə lazımdırTürk banklarının korporativ veb xidmətləri — Garanti BBVA, İş Bankası, Yapı Kredi, Akbank, Ziraat, Halkbank, VakıfBank, QNB, DenizBank və Kuveyt Türk kataloqda görünür. Xidmət sənədi filialla bağlanan ERP inteqrasiya müqaviləsi ilə gəlir; həmin gün sürücüyə daxil edilir.
- İşləyirƏmək haqqı ödəniş faylı — Əmək haqqı cədvəlindən bankın istədiyi sabit sütunlu mətn faylı şablonla hazırlanır. Banklar bu formatı dərc etmir, buna görə şablonu bankınızla bir dəfə yoxlayırsınız.
- TezlikləTəchizatçılara toplu ödəniş tapşırığı faylı — Ödəniş planından banka bir faylda toplu ödəniş göstərişi.
Giriş məlumatları. Bankın və marketpleysin verdiyi açarlar şifrələnərək saxlanılır və ekranda bir daha göstərilmir. HNR xarici şəbəkəyə yalnız sizin açdığınız bağlantı üçün sorğu göndərir.
3. Kargo və logistika
- İşləyirKargo izləmə keçidi və etiketlər — Kargo şirkətinin izləmə ünvanını
{takip}yer tutucusu ilə bir dəfə yazırsınız; göndərişdəki izləmə nömrəsi kliklənən keçidə çevrilir. Kargo etiketi, qablaşdırma siyahısı, qutu etiketləri və qaimə bir PDF sənəd dəstində çap olunur. - Müqavilə lazımdırKargo şirkətinin API-si — Göndərişi kargo sistemində açmaq və vəziyyətini avtomatik soruşmaq bu gün yoxdur; kargo vəziyyəti göndərişdə əllə yazılır. Kargo şirkəti ilə API müqaviləniz olduqda sürücünün yeri hazırdır.
- TezlikləDaşıma tarifləri və palet etiketi — Region × kq/həcm çəkisi tarifi ilə göndəriş xərcinin sifarişə və müştəriyə bölüşdürülməsi, SSCC/GS1-128 palet etiketi.
4. Marketpleyslər
- Hazırdır, öz hesabınızla sınayınTrendyol, Hepsiburada, Tokopedia, Shopee — Sifarişlərin çəkilməsi, məhsul uyğunlaşdırması, qalıq və qiymət göndərilməsi, qablaşdırma və göndəriş, qaytarma və hesablaşma. Platformaların rəsmi API sənədinə uyğun yazılıb, real mağaza hesabı ilə sınanmayıb; ilk bağlantını platformanın test mühitində qurun.
- İşləyirSimulyasiya marketpleysi — Real mağazaya toxunmadan öz məhsul kartlarınız və nümunə sifarişlərlə bütün axını sınaqdan keçirir.
- YoxdurDigər platformalar — Amazon, N11, Çiçeksepeti, Lazada, TikTok Shop və bənzərləri üçün sürücü yoxdur; bu platformaların sifarişləri bu gün əllə daxil edilir.
5. Elektron sənədlər və rəsmi fayllar
- İşləyirElektron faktura XML (UBL-TR 1.2) — Satış və qaytarma fakturalarından əsas və ticari faktura profilində XML hazırlanır və yüklənir; inteqrator hesabı olmadan yoxlanıla bilər.
- Müqavilə lazımdırElektron sənədi birbaşa göndərmək — Türkiyədə e-Fatura özəl inteqrator vasitəsilə göndərilir: Uyumsoft və İzibiz sürücüləri yazılıb, onların ünvanları inteqrator hesabı açılanda yoxlanılır, maliyyə möhürünü inteqrator vurur; e-Arşiv və e-İrsaliye göndərilməsi də eyni müqavilə ilə əlavə olunur. İndoneziyada HNR PJAP deyil; faylı Coretax-a özünüz yükləyirsiniz.
- İşləyirCoretax və e-Bupot faylları (İndoneziya) — e-Faktur toplu XML, qaytarma (retur) XML, e-Bupot Unifikasi, PPh 21 (BPMP) və 1721-A1 faylları hazırlanır; hər fayl DJP-nin XSD-sinə, XSD dərc edilməyibsə DJP şablonundan çıxarılan sxemə görə yoxlanılır və uyğun gəlməyən fayl verilmir. Portala yükləyən sizsiniz.
- İşləyirRəsmi bəyannamə faylları — Türkiyədə tutulan vergi və sığorta haqları üzrə birləşmiş bəyannamənin SGK hissəsi (XML); İndoneziyada BPJS (SIPP, Edabu), SPT Masa PPN, LKPM, SAK EP və IT Inventory ixracları. Öhdəliklər təqvimi son tarixləri xatırladır.
- İşləyirGələn fakturanı oxumaq — Təchizatçının e-Fatura və ya e-Faktur XML-i, PDF-i və ya şəkli alış fakturası qaralamasına çevrilir; siz yoxlayıb təsdiqləyirsiniz.
6. Mühasibat və məlumat ötürmə
- İşləyirCSV və Excel ixracı — Hər siyahı CSV verir; şirkət hesabatları, mühasibat yazılışları, dövriyyə cədvəli və maliyyə hesabatları Excel (XLSX) kimi də yüklənir.
- İşləyirAyrıca mühasibat proqramı lazım deyil — Faktura, mədaxil, çek və istehsal təsdiqi avtomatik olaraq jurnala düşür (Türkiyənin vahid hesablar planı, İndoneziyanın SAK EP); dövriyyə cədvəli, balans və mənfəət-zərər hesabatı HNR-dən çıxır.
- İşləyirLogo körpüsü (yalnız oxumaq) — Kontragent kartında Logo Wings çıxarışı yan-yana çıxır, HNR↔Logo qalıq hesabatı iki sistemi müqayisə edir. Logo MCP serveri lazımdır; HNR Logo-ya yazmır.
- İşləyirKöhnə HNR verilənlər bazasından köçürmə — İlk quraşdırma sehrbazındakı Verilənlər bazasını idxal et ilə köhnə HNR (Firebird) şirkətinin kartları, sənədləri, istehsalı və əlavələri uzlaşdırma hesabatı ilə köçürülür.
- İşləyirFayldan idxal — Qiymət siyahısı və marketpleys məhsul uyğunlaşdırması (CSV/XLSX), CMM ölçmə hesabatı (Q-DAS ASCII) və müştərinin EDI sifarişi (CSV/JSON → sifariş qaralaması). EDIFACT/VDA mesajları və OFTP2 ötürülməsi yoxdur.
- TezlikləBaşqa proqramlardan idxal sehrbazı — Logo, Mikro, Netsis, Nebim, Accurate, Jurnal, Zahir və Excel-dən kontragentlər, qalıq, açıq qalıqlar və qiymət siyahısı, proqramların rəsmi ixrac formatları ilə.
- YoxdurXarici mühasibat proqramı üçün yazılış faylı və e-Defter — Jurnalı Logo, Mikro, Luca və ya Accurate-ə köçürəcək hazır fayl və GİB e-Defter təqdimatı yoxdur. Yazılışları XLSX kimi almaq olar.
7. Rabitə və xarici xidmətlər
- İşləyirWhatsApp — Mesaj xidməti öz nömrənizi QR kodla bağlayır (WhatsApp Web vasitəsilə; rəsmi WhatsApp Business API deyil). Təklif, sifariş və faktura PDF-ləri və CRM mesaj şablonları göndərilir.
- İşləyirE-poçt — Təkliflər, sifarişlər və fakturalar öz SMTP serveriniz vasitəsilə müştəriyə göndərilir.
- İşləyirValyuta məzənnələri — Türkiyədə Mərkəzi Bankın (TCMB) məzənnələri avtomatik oxunur. İndoneziyada Bank Indonesia (JISDOR) məzənnəsi məzənnə cədvəlinə əllə daxil edilir; avtomatik oxuma yoxdur.
- İşləyirHNR Agent (süni intellekt) — Yalnız oxuyan köməkçi Anthropic Claude API ilə işləyir; API açarı və istifadə haqqı sizindir.
8. Açıq API, portallar və verilənlər bazası
- İşləyirHTTP API (REST/JSON) — İnterfeysin istifadə etdiyi bütün son nöqtələr (2 oktyabr 2026 sayımına görə 2150-dən çox) başqa proqramlar üçün də açıqdır. Hər sorğu quraşdırmanın API açarını (
Authorization: Bearer) və istifadəçinin sessiya tokenini (/api/auth/login→X-Oturum-Token) daşıyır; əməliyyat həmin istifadəçinin səlahiyyətləri və şirkəti ilə icra olunur. Yazma sorğusuIdempotency-Keyilə təhlükəsiz təkrarlana bilər. - YoxdurAçıq API sənədi və hadisə bildirişləri (webhook) — OpenAPI/Swagger sənədi və dəyişiklik olanda xaricə bildiriş yoxdur. Son nöqtələrin siyahısı quraşdırma komandasından alınır; dəyişiklikləri izləmək üçün yeniləmə sayğacı sorğulanır.
- İşləyirPortallar — Müştəri portalı, təchizatçı təklif portalı, podratçı portalı, B2B sifariş, səyyar satış tətbiqi və işçi portalı; hər biri ayrıca girişlə və öz səlahiyyət sərhədi ilə işləyir.
- İşləyirVerilənlər bazası mühərrikləri — Firebird, PostgreSQL, CockroachDB, Microsoft SQL Server və Oracle; buludda PostgreSQL (Neon) və CockroachDB Cloud. Mühərrik şirkət yaradılanda seçilir.
Siyahıda olmayan bağlantı lazımdır? Əvvəlcə fayl yolunu sınayın: HNR məlumatların çoxunu CSV, XLSX və ya XML kimi qəbul edir və verir. Alınmasa, platformanın adını və əlinizdəki texniki sənədi quraşdırma komandasına göndərin; sənədi olmayan format uydurulmur.