Yardım › Entegrasyon kataloğu

Entegrasyon kataloğu: HNR neye bağlanır?

Bu sayfa HNR'nin bankaya, kargoya, pazaryerine, vergi idaresine, muhasebe dosyalarına ve başka programlara nasıl bağlandığını tek yerde toplar. Her satırın önündeki etiket bugünkü gerçeği söyler: neyin kendi başına çalıştığını, neyin sizin hesabınızla ya da bir sözleşmeyle açılacağını, neyin henüz olmadığını. Bir bağlantı gerçek bir hesapla denenmediyse bu açıkça yazılır.

1. Etiketler ne anlatır

• KullanımdaBugün çalışır. Dışarıdan bir hesap ya da sözleşme gerekmez; gereken şey varsa kendi sunucunuz, dosyanız ya da anahtarınızdır.
• Hazır, hesabınızla denenmeliBağlantı kodu karşı tarafın resmî belgesine göre eksiksiz yazıldı ve HNR'nin kendi testlerinden geçti, ama gerçek bir hesapla denenmedi. İlk bağlantıyı karşı tarafın test ortamıyla kurup doğrulayın.
• Sözleşme gerekliKarşı taraf teknik belgesini yalnız sözleşmeyle veriyor. HNR'de yeri hazırdır; belge ve kimlik bilgileri gelince bağlantı tamamlanır.
• YakındaGeliştirme kuyruğunda; bugün yok.
• YokBugün yok ve kuyrukta da değil. Çoğu zaman bir dosya yolu (CSV, XLSX, XML) aynı işi görür.

2. Banka

• KullanımdaBanka ekstresi içe aktarma — MT940, CSV/Excel ve DBS dosyaları okunur; Türk ve Endonezya bankaları için hazır sütun profilleri vardır, kendi bankanızı bir kez eşlersiniz. Hareketler faturalarla puanlanarak eşleşir, onayınızla makbuz yazılır.
• KullanımdaBanka servisi (e-posta ve PDF) — Bankanın gönderdiği hareket bildirimi e-postaları ve PDF ekstreler ayrı çalışan banka servisi tarafından okunur; POS takası da burada izlenir.
• Hazır, hesabınızla denenmeliCanlı banka bağlantısı: açık bankacılık — Türkiye'de ÖHVPS (BKM hesap bilgisi hizmeti) standardı, Endonezya'da Bank Indonesia SNAP standardı (BCA, Mandiri, BNI, BRI ve genel SNAP). Hareketler ekstre indirmeden çekilir; yetkili hizmet sağlayıcı sözleşmesi ve bankanın verdiği anahtarlar gerekir.
• Sözleşme gerekliTürk bankalarının kurumsal web servisleri — Garanti BBVA, İş Bankası, Yapı Kredi, Akbank, Ziraat, Halkbank, VakıfBank, QNB, DenizBank ve Kuveyt Türk katalogda görünür. Servis belgesi şubeyle yapılan ERP entegrasyonu sözleşmesiyle gelir; o gün sürücüye işlenir.
• KullanımdaMaaş ödeme dosyası — Bordrodan bankanın istediği sabit sütunlu metin dosyası şablonla üretilir. Bankalar bu biçimi yayımlamadığı için şablonu bankanızla bir kez doğrularsınız.
• YakındaTedarikçilere toplu ödeme emri dosyası — Ödeme planından bankaya tek dosyayla toplu ödeme talimatı.

3. Kargo ve lojistik

• KullanımdaKargo takip bağlantısı ve etiketler — Kargo firmasının takip adresini {takip} yer tutucusuyla bir kez yazarsınız; sevkiyattaki takip numarası tıklanabilir bağlantı olur. Kargo etiketi, çeki listesi, koli etiketi ve irsaliye tek PDF belge setinde basılır.
• Sözleşme gerekliKargo firmasının API'si — Gönderiyi kargo sisteminde açmak ve durumu otomatik sorgulamak bugün yok; kargo durumu sevkiyatta elle yazılır. Kargo firmasıyla API sözleşmeniz olduğunda sürücünün yeri hazırdır.
• YakındaNakliye tarifeleri ve palet etiketi — Bölge × kg/desi tarifesiyle sevkiyat maliyetinin siparişe ve müşteriye dağıtılması, SSCC/GS1-128 palet etiketi.

4. Pazaryerleri

• Hazır, hesabınızla denenmeliTrendyol, Hepsiburada, Tokopedia, Shopee — Sipariş çekme, ürün eşleme, stok ve fiyat gönderimi, paketleme ve kargo, iade ve hakediş. Platformların resmî API belgesine göre yazıldı, gerçek bir mağaza hesabıyla denenmedi; ilk bağlantıyı platformun test ortamıyla kurun.
• KullanımdaSimülasyon pazaryeri — Bütün akışı gerçek mağazaya dokunmadan kendi stok kartlarınızla ve örnek siparişlerle prova eder.
• YokDiğer platformlar — Amazon, N11, Çiçeksepeti, Lazada, TikTok Shop ve benzerleri için sürücü yok; bu platformların siparişleri bugün elle girilir.

5. E-belge ve resmî dosyalar

• Kullanımdae-Fatura XML'i (UBL-TR 1.2) — Satış ve iade faturasından temel ve ticari fatura profilinde XML üretilir ve indirilir; entegratör hesabı olmadan doğrulanabilir.
• Sözleşme gereklie-Belgeyi doğrudan gönderme — Türkiye'de e-Fatura özel entegratör üzerinden gider: Uyumsoft ve İzibiz sürücüleri yazıldı, uç adresleri entegratör hesabı açılınca doğrulanır, mali mühür entegratördedir; e-Arşiv ve e-İrsaliye gönderimi de aynı sözleşmeyle eklenir. Endonezya'da HNR bir PJAP değildir; dosyayı Coretax'a siz yüklersiniz.
• KullanımdaCoretax ve e-Bupot dosyaları (Endonezya) — e-Faktur toplu XML'i, iade (retur) XML'i, e-Bupot Unifikasi, PPh 21 (BPMP) ve 1721-A1 dosyaları üretilir; her dosya DJP'nin XSD'sine, XSD yayımlanmamışsa DJP şablonundan türetilen şemaya göre denetlenir ve uymayan dosya verilmez. Portala yükleyen sizsiniz.
• KullanımdaResmî beyan dosyaları — Türkiye'de SGK muhtasar ve prim hizmet beyannamesinin SGK bölümü (XML); Endonezya'da BPJS (SIPP, Edabu), SPT Masa PPN, LKPM, SAK EP ve IT Inventory dökümleri. Yükümlülükler takvimi son günleri hatırlatır.
• KullanımdaGelen faturayı okuma — Tedarikçinin e-Fatura ya da e-Faktur XML'i, PDF'i veya fotoğrafı alış faturası taslağına çevrilir; siz kontrol edip onaylarsınız.

6. Muhasebe ve veri aktarımı

• KullanımdaCSV ve Excel dışa aktarma — Her liste CSV verir; firma raporları, muhasebe fişleri, mizan ve mali tablolar Excel (XLSX) olarak da indirilir.
• KullanımdaAyrı muhasebe programı gerekmez — Fatura, tahsilat, çek ve üretim teyidi otomatik yevmiyeye düşer (Türkiye Tekdüzen Hesap Planı, Endonezya SAK EP); mizan, bilanço ve gelir tablosu HNR'den çıkar.
• KullanımdaLogo köprüsü (salt okur) — Cari kartında Logo Wings ekstresi yan yana gelir, HNR↔Logo stok raporu iki sistemi karşılaştırır. Logo MCP sunucusu gerekir; HNR Logo'ya yazmaz.
• KullanımdaEski HNR veritabanından aktarım — İlk kurulum sihirbazındaki Veritabanı içe aktar ile eski HNR (Firebird) firmasının kartları, belgeleri, üretimi ve ekleri mutabakat raporuyla taşınır.
• KullanımdaDosyayla içe aktarma — Fiyat listesi ve pazaryeri ürün eşlemesi (CSV/XLSX), CMM ölçüm raporu (Q-DAS ASCII) ve müşteri EDI siparişi (CSV/JSON → sipariş taslağı). EDIFACT/VDA mesajları ve OFTP2 taşıma yok.
• YakındaBaşka programdan içe aktarma sihirbazı — Logo, Mikro, Netsis, Nebim, Accurate, Jurnal, Zahir ve Excel'den cari, stok, açık bakiye ve fiyat listesi; programların resmî dışa aktarma biçimleriyle.
• YokDış muhasebe programına fiş dosyası ve e-Defter — Yevmiyeyi Logo, Mikro, Luca ya da Accurate'e aktaracak hazır dosya ve GİB e-Defter beratı yok. Fişler XLSX olarak alınabilir.

7. İletişim ve dış servisler

• KullanımdaWhatsApp — Mesaj servisi kendi numaranızı QR koduyla bağlar (WhatsApp Web yoluyla; resmî WhatsApp Business API değildir). Teklif, sipariş ve fatura PDF'i ile CRM mesaj şablonları gönderilir.
• KullanımdaE-posta — Teklif, sipariş ve fatura kendi SMTP sunucunuz üzerinden müşteriye gönderilir.
• KullanımdaDöviz kurları — Türkiye'de TCMB kurları otomatik okunur. Endonezya'da Bank Indonesia (JISDOR) kuru kur tablosuna elle girilir; otomatik okuma yok.
• KullanımdaHNR Ajan (yapay zekâ) — Salt okur asistan Anthropic Claude API'si ile çalışır; API anahtarı ve kullanım ücreti sizindir.

8. Açık API, portallar ve veritabanı

• KullanımdaHTTP API (REST/JSON) — Arayüzün kullandığı bütün uçlar (2 Ekim 2026 sayımıyla 2.150'yi aşkın) başka programlara da açıktır. Her istek kurulumdaki API anahtarını (Authorization: Bearer) ve bir kullanıcının oturum jetonunu (/api/auth/login → X-Oturum-Token) taşır; işlem o kullanıcının yetkileri ve firmasıyla çalışır. Yazma isteği Idempotency-Key ile güvenle tekrarlanır.
• YokHerkese açık API belgesi ve olay bildirimi (webhook) — OpenAPI/Swagger belgesi ve bir değişiklikte dışarıya bildirim yok. Uç listesi kurulum ekibinden alınır; değişiklikleri izlemek için güncelleme sayacı sorgulanır.
• KullanımdaPortallar — Müşteri portalı, tedarikçi teklif portalı, fason portalı, B2B sipariş, saha satış uygulaması ve personel portalı; her biri ayrı girişle ve kendi yetki sınırıyla çalışır.
• KullanımdaVeritabanı motorları — Firebird, PostgreSQL, CockroachDB, Microsoft SQL Server ve Oracle; bulutta PostgreSQL (Neon) ve CockroachDB Cloud. Motor firma kurulurken seçilir.