Kömek › Integrasiýa katalogy

Integrasiýa katalogy: HNR nämelere birikýär?

Bu sahypa HNR-iň banka, kargo kompaniýasyna, marketpleýse, salgyt edarasyna, buhgalteriýa faýllaryna we beýleki programmalara nähili birikýändigini bir ýere jemleýär. Her setiriň öňündäki bellik şu günki hakykaty aýdýar: näme özbaşdak işleýär, näme siziň hasabyňyz ýa-da şertnama bilen açylýar we näme entek ýok. Eger birikme hakyky hasap bilen synanyşylmadyk bolsa, bu aç-açan ýazylýar.

1. Bellikler nämäni aňladýar

• UlanylýarŞu gün işleýär. Daşarky hasap ýa-da şertnama gerek däl; bir zat gerek bolsa, ol siziň öz serweriňiz, faýlyňyz ýa-da açaryňyzdyr.
• Taýýar, öz hasabyňyz bilen synaňBirikme kody garşy tarapyň resmi resminamasyna laýyklykda doly ýazyldy we HNR-iň öz synaglaryndan geçdi, ýöne hakyky hasap bilen synanyşylmady. Ilkinji birikmäni garşy tarapyň synag gurşawynda guruň we barlaň.
• Şertnama gerekGarşy tarap tehniki resminamasyny diňe şertnama bilen berýär. HNR-de onuň ýeri taýýar; resminama we giriş maglumatlary gelende birikme tamamlanýar.
• Ýakyn wagtdaIşläp düzüş nobatynda; şu gün ýok.
• ÝokŞu gün ýok we nobatda hem däl. Köplenç faýl ýoly (CSV, XLSX, XML) şol işi edýär.

2. Bank

• UlanylýarBank göçürmesini import etmek — MT940, CSV/Excel we DBS faýllary okalýar; Türkiýe we Indoneziýa banklary üçin taýýar sütün profilleri bar, öz bankyňyzy bir gezek gabat getirýärsiňiz. Hereketler bal bilen fakturalar bilen gabat getirilýär, tassyklanyňyzda kwitansiýa ýazylýar.
• UlanylýarBank hyzmaty (e-poçta we PDF) — Bankyň iberýän hereket habarnama hatlary we PDF göçürmeler aýratyn işleýän bank hyzmaty tarapyndan okalýar; POS hasaplaşygy hem şu ýerde yzarlanýar.
• Taýýar, öz hasabyňyz bilen synaňGöni bank birikmesi: açyk bankçylyk — Türkiýede ÖHVPS standarty (BKM hasap maglumat hyzmaty), Indoneziýada Bank Indonesia SNAP standarty (BCA, Mandiri, BNI, BRI we umumy SNAP). Hereketler göçürmäni ýüklemezden alynýar; ygtyýarly hyzmat üpjünçisiniň şertnamasy we bankyň beren açarlary gerek.
• Şertnama gerekTürk banklarynyň korporatiw web hyzmatlary — Garanti BBVA, İş Bankası, Yapı Kredi, Akbank, Ziraat, Halkbank, VakıfBank, QNB, DenizBank we Kuveyt Türk katalogda görünýär. Hyzmat resminamasy şahamça bilen baglaşylan ERP integrasiýa şertnamasy bilen gelýär; şol gün sürüjä girizilýär.
• UlanylýarAýlyk töleg faýly — Aýlyk sanawyndan bankyň isleýän berk sütünli tekst faýly şablon arkaly taýýarlanýar. Banklar bu formaty çap etmeýär, şonuň üçin şablony bankyňyz bilen bir gezek barlaýarsyňyz.
• Ýakyn wagtdaÜpjünçilere köpçülikleýin töleg tabşyryk faýly — Töleg meýilnamasyndan banka bir faýlda köpçülikleýin töleg görkezmesi.

3. Kargo we logistika

• UlanylýarKargo yzarlaýyş baglanyşygy we bellikler — Kargo kompaniýasynyň yzarlaýyş salgysyny {takip} ornuny tutujy bilen bir gezek ýazýarsyňyz; ugradyşdaky yzarlaýyş belgisi basylýan baglanyşyga öwrülýär. Kargo belligi, gaplama sanawy, gutu bellikleri we ýük haty bir PDF resminama toplumynda çap edilýär.
• Şertnama gerekKargo kompaniýasynyň API-si — Ugradyşy kargo ulgamynda açmak we ýagdaýyny awtomatik soramak şu gün ýok; kargo ýagdaýy ugradyşda elde ýazylýar. Kargo kompaniýasy bilen API şertnamaňyz bolanda sürüjiniň ýeri taýýar.
• Ýakyn wagtdaÝük daşama nyrhlary we palet belligi — Sebit × kg/göwrüm agramy nyrhy bilen ugradyş çykdajysyny sargyda we müşderä paýlamak, SSCC/GS1-128 palet belligi.

4. Marketpleýsler

• Taýýar, öz hasabyňyz bilen synaňTrendyol, Hepsiburada, Tokopedia, Shopee — Sargytlary almak, harytlary gabat getirmek, galyndy we baha ibermek, gaplamak we ugratmak, yzyna gaýtarmak we hasaplaşyk. Platformalaryň resmi API resminamasyna laýyklykda ýazyldy, hakyky dükan hasaby bilen synanyşylmady; ilkinji birikmäni platformanyň synag gurşawynda guruň.
• UlanylýarSimulýasiýa marketpleýsi — Hakyky dükana degmezden öz haryt kartlaryňyz we nusga sargytlar bilen tutuş akymy synap görýär.
• ÝokBeýleki platformalar — Amazon, N11, Çiçeksepeti, Lazada, TikTok Shop we meňzeşleri üçin sürüji ýok; bu platformalaryň sargytlary şu gün elde girizilýär.

5. Elektron resminamalar we resmi faýllar

• UlanylýarElektron faktura XML (UBL-TR 1.2) — Satuw we yzyna gaýtarma fakturalaryndan esasy we täjirçilik profilindäki XML taýýarlanýar we ýüklenip alynýar; integrator hasaby bolmazdan barlap bolýar.
• Şertnama gerekElektron resminamany göni ibermek — Türkiýede e-Fatura hususy integrator arkaly iberilýär: Uyumsoft we İzibiz sürüjileri ýazyldy, olaryň salgylary integrator hasaby açylanda barlanýar, maliýe möhrüni integrator basýar; e-Arşiv we e-İrsaliye ibermek hem şol şertnama bilen goşulýar. Indoneziýada HNR PJAP däl; faýly Coretax-a özüňiz ýükleýärsiňiz.
• UlanylýarCoretax we e-Bupot faýllary (Indoneziýa) — e-Faktur köpçülikleýin XML, yzyna gaýtarma (retur) XML, e-Bupot Unifikasi, PPh 21 (BPMP) we 1721-A1 faýllary taýýarlanýar; her faýl DJP-iň XSD-si boýunça, XSD çap edilmedik bolsa DJP şablonyndan alnan shema boýunça barlanýar we laýyk gelmeýän faýl berilmeýär. Portala ýükleýän sizsiňiz.
• UlanylýarResmi beýannama faýllary — Türkiýede saklanyp galynýan salgyt we sugurta tölegleriniň birleşdirilen beýannamasynyň SGK bölümi (XML); Indoneziýada BPJS (SIPP, Edabu), SPT Masa PPN, LKPM, SAK EP we IT Inventory eksportlary. Borçlar senenamasy möhletleri ýatladýar.
• UlanylýarGelen fakturany okamak — Üpjünçiniň e-Fatura ýa-da e-Faktur XML-i, PDF-i ýa-da suraty satyn alyş fakturasynyň garalamasyna öwrülýär; siz barlap tassyklaýarsyňyz.

6. Buhgalteriýa we maglumat geçirmek

• UlanylýarCSV we Excel eksporty — Her sanaw CSV berýär; kärhana hasabatlary, buhgalteriýa ýazgylary, aýlanyşyk sanawy we maliýe hasabatlary Excel (XLSX) görnüşinde hem ýüklenip alynýar.
• UlanylýarAýratyn buhgalteriýa programmasy gerek däl — Faktura, tölegleriň kabul edilmegi, çek we önümçilik tassyklamasy awtomatik usulda žurnala düşýär (Türkiýäniň bitewi hasaplar meýilnamasy, Indoneziýanyň SAK EP); aýlanyşyk sanawy, balans we girdeji-çykdajy hasabaty HNR-den çykýar.
• UlanylýarLogo köprüsi (diňe okamak) — Kontragent kartynda Logo Wings göçürmesi ýanaşyk çykýar, HNR↔Logo galyndy hasabaty iki ulgamy deňeşdirýär. Logo MCP serweri gerek; HNR Logo-a ýazmaýar.
• UlanylýarKöne HNR maglumat bazasyndan geçirmek — Ilkinji gurnama ussatyndaky Maglumat bazasyny import et arkaly köne HNR (Firebird) kärhanasynyň kartlary, resminamalary, önümçiligi we goşundylary deňeşdirme hasabaty bilen geçirilýär.
• UlanylýarFaýldan import — Baha sanawy we marketpleýs haryt gabat getirilişi (CSV/XLSX), CMM ölçeg hasabaty (Q-DAS ASCII) we müşderiniň EDI sargydy (CSV/JSON → sargyt garalamasy). EDIFACT/VDA habarlary we OFTP2 geçiriş ýok.
• Ýakyn wagtdaBeýleki programmalardan import ussady — Logo, Mikro, Netsis, Nebim, Accurate, Jurnal, Zahir we Excel-den kontragentler, galyndy, açyk galyndy hasaplary we baha sanawy, programmalaryň resmi eksport formatlary bilen.
• ÝokDaşarky buhgalteriýa programmasy üçin ýazgy faýly we e-Defter — Žurnaly Logo, Mikro, Luca ýa-da Accurate-a geçirjek taýýar faýl we GİB e-Defter tabşyrmasy ýok. Ýazgylary XLSX görnüşinde alyp bolýar.

7. Aragatnaşyk we daşarky hyzmatlar

• UlanylýarWhatsApp — Habar hyzmaty öz belgiňizi QR kody bilen birikdirýär (WhatsApp Web arkaly; resmi WhatsApp Business API däl). Teklip, sargyt we faktura PDF-leri hem-de CRM habar şablonlary iberilýär.
• UlanylýarE-poçta — Teklipler, sargytlar we fakturalar öz SMTP serweriňiz arkaly müşderä iberilýär.
• UlanylýarWalýuta hümmetleri — Türkiýede Merkezi bankyň (TCMB) hümmetleri awtomatik okalýar. Indoneziýada Bank Indonesia (JISDOR) hümmeti hümmetler tablisasyna elde girizilýär; awtomatik okamak ýok.
• UlanylýarHNR Agent (emeli aň) — Diňe okaýan kömekçi Anthropic Claude API bilen işleýär; API açary we ulanyş tölegi siziňki.

8. Açyk API, portallar we maglumat bazasy

• UlanylýarHTTP API (REST/JSON) — Interfeýsiň ulanýan ähli nokatlary (2026-njy ýylyň 2-nji oktýabryndaky hasaba görä 2150-den gowrak) beýleki programmalar üçin hem açyk. Her haýyş gurnamadaky API açaryny (Authorization: Bearer) we ulanyjynyň sessiýa tokenini (/api/auth/login → X-Oturum-Token) göterýär; amal şol ulanyjynyň ygtyýarlary we kärhanasy bilen ýerine ýetirilýär. Ýazmak haýyşy Idempotency-Key bilen howpsuz gaýtalanyp bilner.
• ÝokKöpçülige açyk API resminamasy we waka habarnamalary (webhook) — OpenAPI/Swagger resminamasy we üýtgeşiklik bolanda daşaryk habarnama ýok. Nokatlaryň sanawy gurnama toparyndan alynýar; üýtgeşiklikleri yzarlamak üçin täzelenme sanagyjy yzygiderli soralýar.
• UlanylýarPortallar — Müşderi portaly, üpjünçi teklip portaly, potratçy portaly, B2B sargyt, meýdan satuw programmasy we işgär portaly; her biri aýratyn giriş we öz ygtyýar çägi bilen işleýär.
• UlanylýarMaglumat bazasy hereketlendirijileri — Firebird, PostgreSQL, CockroachDB, Microsoft SQL Server we Oracle; bulutda PostgreSQL (Neon) we CockroachDB Cloud. Hereketlendiriji kärhana döredilende saýlanýar.