Анықтама › Интеграциялар каталогы

Интеграциялар каталогы: HNR неге қосылады?

Бұл бет HNR-дің банктерге, курьерлік қызметтерге, маркетплейстерге, салық органына, бухгалтерлік файлдарға және басқа бағдарламаларға қалай қосылатынын бір жерге жинайды. Әр жолдың алдындағы белгі бүгінгі шындықты айтады: не өз бетінше жұмыс істейді, не сіздің тіркелгіңізбен немесе келісімшартпен ашылады және не әлі жоқ. Егер қосылым нақты тіркелгімен сыналмаған болса, бұл ашық жазылады.

1. Белгілер нені білдіреді

• Жұмыс істейдіБүгін жұмыс істейді. Сырттан тіркелгі немесе келісімшарт қажет емес; бір нәрсе қажет болса, ол сіздің өз серверіңіз, файлыңыз немесе кілтіңіз.
• Дайын, өз тіркелгіңізбен сынаңызҚосылым коды қарсы тараптың ресми құжатына сай толық жазылды және HNR-дің өз сынақтарынан өтті, бірақ нақты тіркелгімен сыналмады. Алғашқы қосылымды қарсы тараптың сынақ ортасында орнатып, тексеріңіз.
• Келісімшарт қажетҚарсы тарап техникалық құжатын тек келісімшарт бойынша береді. HNR-де оның орны дайын; құжат пен кіру деректері келгенде қосылым аяқталады.
• ЖақындаӘзірлеу кезегінде; бүгін жоқ.
• ЖоқБүгін жоқ және кезекте де жоқ. Көбіне файл жолы (CSV, XLSX, XML) сол жұмысты атқарады.

2. Банк

• Жұмыс істейдіБанк үзіндісін импорттау — MT940, CSV/Excel және DBS файлдары оқылады; Түркия мен Индонезия банктері үшін дайын баған профильдері бар, өз банкіңізді бір рет сәйкестендіресіз. Қозғалыстар ұпаймен шот-фактураларға сәйкестендіріледі, сіз растағанда түбіртек жазылады.
• Жұмыс істейдіБанк қызметі (электрондық пошта және PDF) — Банк жіберетін қозғалыс туралы хабарлама хаттары мен PDF үзінділерді бөлек жұмыс істейтін банк қызметі оқиды; POS есеп айырысуы да осында бақыланады.
• Дайын, өз тіркелгіңізбен сынаңызБанкпен тікелей қосылым: ашық банкинг — Түркияда ÖHVPS стандарты (BKM шот ақпараты қызметі), Индонезияда Bank Indonesia SNAP стандарты (BCA, Mandiri, BNI, BRI және жалпы SNAP). Қозғалыстар үзіндіні жүктемей алынады; уәкілетті қызмет көрсетуші келісімшарты және банк берген кілттер қажет.
• Келісімшарт қажетТүрік банктерінің корпоративтік веб-қызметтері — Garanti BBVA, İş Bankası, Yapı Kredi, Akbank, Ziraat, Halkbank, VakıfBank, QNB, DenizBank және Kuveyt Türk каталогта көрінеді. Қызмет құжаты филиалмен жасалған ERP интеграция келісімшартымен келеді; сол күні драйверге енгізіледі.
• Жұмыс істейдіЖалақы төлеу файлы — Жалақы ведомосынан банк сұрайтын бекітілген бағанды мәтін файлы үлгі арқылы жасалады. Банктер бұл форматты жарияламайды, сондықтан үлгіні банкіңізбен бір рет тексересіз.
• ЖақындаЖеткізушілерге топтық төлем тапсырмасы файлы — Төлем жоспарынан банкке бір файлмен топтық төлем нұсқауы.

3. Курьерлік қызмет және логистика

• Жұмыс істейдіЖүкті бақылау сілтемесі және жапсырмалар — Курьерлік компанияның бақылау мекенжайын {takip} орынбасарымен бір рет жазасыз; жөнелтімдегі бақылау нөмірі басылатын сілтемеге айналады. Жүк жапсырмасы, қаптама тізімі, қорап жапсырмалары және жүкқұжат бір PDF құжаттар жиынтығында басылады.
• Келісімшарт қажетКурьерлік компания API — Жөнелтімді курьерлік жүйеде ашу және күйін автоматты сұрау бүгін жоқ; курьерлік күй жөнелтімде қолмен жазылады. Курьерлік компаниямен API келісімшартыңыз болғанда драйвердің орны дайын.
• ЖақындаЖүк тасымалдау тарифтері және паллет жапсырмасы — Аймақ × кг/көлемдік салмақ тарифімен жөнелту шығынын тапсырыс пен клиентке бөлу, SSCC/GS1-128 паллет жапсырмасы.

4. Маркетплейстер

• Дайын, өз тіркелгіңізбен сынаңызTrendyol, Hepsiburada, Tokopedia, Shopee — Тапсырыстарды алу, тауарларды сәйкестендіру, қалдық пен бағаны жіберу, қаптау және жөнелту, қайтару және есеп айырысу. Платформалардың ресми API құжатына сай жазылды, нақты дүкен тіркелгісімен сыналмады; алғашқы қосылымды платформаның сынақ ортасында орнатыңыз.
• Жұмыс істейдіСимуляция маркетплейсі — Нақты дүкенге тимей, өз тауар карточкаларыңыз бен үлгі тапсырыстармен бүкіл үдерісті сынап көреді.
• ЖоқБасқа платформалар — Amazon, N11, Çiçeksepeti, Lazada, TikTok Shop және ұқсастары үшін драйвер жоқ; бұл платформалардың тапсырыстары бүгін қолмен енгізіледі.

5. Электрондық құжаттар және ресми файлдар

• Жұмыс істейдіЭлектрондық шот-фактура XML (UBL-TR 1.2) — Сату және қайтару шот-фактураларынан негізгі және коммерциялық профильдегі XML жасалып, жүктеледі; интегратор тіркелгісінсіз тексеруге болады.
• Келісімшарт қажетЭлектрондық құжатты тікелей жіберу — Түркияда e-Fatura жеке интегратор арқылы жіберіледі: Uyumsoft пен İzibiz драйверлері жазылған, олардың мекенжайлары интегратор тіркелгісі ашылғанда тексеріледі, қаржылық мөрді интегратор басады; e-Arşiv және e-İrsaliye жіберу де сол келісімшартпен қосылады. Индонезияда HNR PJAP емес; файлды Coretax-қа өзіңіз жүктейсіз.
• Жұмыс істейдіCoretax және e-Bupot файлдары (Индонезия) — e-Faktur топтық XML, қайтару (retur) XML, e-Bupot Unifikasi, PPh 21 (BPMP) және 1721-A1 файлдары жасалады; әр файл DJP-нің XSD схемасы бойынша, XSD жарияланбаса DJP үлгісінен алынған схема бойынша тексеріледі және сәйкес келмейтін файл берілмейді. Порталға сіз жүктейсіз.
• Жұмыс істейдіРесми декларация файлдары — Түркияда ұсталатын салық пен сақтандыру жарналары бойынша біріктірілген декларацияның SGK бөлігі (XML); Индонезияда BPJS (SIPP, Edabu), SPT Masa PPN, LKPM, SAK EP және IT Inventory экспорттары. Міндеттемелер күнтізбесі мерзімдерді еске салады.
• Жұмыс істейдіКелген шот-фактураны оқу — Жеткізушінің e-Fatura немесе e-Faktur XML файлы, PDF немесе фотосы сатып алу шот-фактурасының жобасына айналады; сіз тексеріп бекітесіз.

6. Бухгалтерия және деректерді тасымалдау

• Жұмыс істейдіCSV және Excel экспорты — Әр тізім CSV береді; кәсіпорын есептері, бухгалтерлік жазбалар, айналым ведомосы және қаржылық есептер Excel (XLSX) түрінде де жүктеледі.
• Жұмыс істейдіБөлек бухгалтерлік бағдарлама қажет емес — Шот-фактура, төлем қабылдау, чек және өндіріс растауы автоматты түрде журналға түседі (Түркияның бірыңғай шоттар жоспары, Индонезияның SAK EP); айналым ведомосы, баланс және пайда мен залал есебі HNR-ден шығады.
• Жұмыс істейдіLogo көпірі (тек оқу) — Контрагент карточкасында Logo Wings үзіндісі қатар шығады, HNR↔Logo қалдық есебі екі жүйені салыстырады. Logo MCP сервері қажет; HNR Logo-ға жазбайды.
• Жұмыс істейдіЕскі HNR дерекқорынан көшіру — Алғашқы орнату шеберіндегі Дерекқорды импорттау арқылы ескі HNR (Firebird) кәсіпорнының карточкалары, құжаттары, өндірісі және тіркемелері салыстыру есебімен көшіріледі.
• Жұмыс істейдіФайлдан импорттау — Баға тізімі мен маркетплейс тауарларын сәйкестендіру (CSV/XLSX), CMM өлшеу есебі (Q-DAS ASCII) және клиенттің EDI тапсырысы (CSV/JSON → тапсырыс жобасы). EDIFACT/VDA хабарламалары мен OFTP2 тасымалдау жоқ.
• ЖақындаБасқа бағдарламалардан импорттау шебері — Logo, Mikro, Netsis, Nebim, Accurate, Jurnal, Zahir және Excel-ден контрагенттер, қалдық, ашық сальдо және баға тізімі, бағдарламалардың ресми экспорт форматтарымен.
• ЖоқСыртқы бухгалтерлік бағдарламаға арналған жазба файлы және e-Defter — Журналды Logo, Mikro, Luca немесе Accurate-қа көшіретін дайын файл және GİB e-Defter тапсыру жоқ. Жазбаларды XLSX түрінде алуға болады.

7. Байланыс және сыртқы қызметтер

• Жұмыс істейдіWhatsApp — Хабар қызметі өз нөміріңізді QR-код арқылы байланыстырады (WhatsApp Web арқылы; ресми WhatsApp Business API емес). Коммерциялық ұсыныс, тапсырыс және шот-фактура PDF-тері мен CRM хабар үлгілері жіберіледі.
• Жұмыс істейдіЭлектрондық пошта — Коммерциялық ұсыныстар, тапсырыстар және шот-фактуралар өз SMTP серверіңіз арқылы клиентке жіберіледі.
• Жұмыс істейдіВалюта бағамдары — Түркияда Орталық банктің (TCMB) бағамдары автоматты оқылады. Индонезияда Bank Indonesia (JISDOR) бағамы бағамдар кестесіне қолмен енгізіледі; автоматты оқу жоқ.
• Жұмыс істейдіHNR Агент (жасанды интеллект) — Тек оқитын көмекші Anthropic Claude API арқылы жұмыс істейді; API кілті мен пайдалану ақысы сіздікі.

8. Ашық API, порталдар және дерекқор

• Жұмыс істейдіHTTP API (REST/JSON) — Интерфейс пайдаланатын барлық нүктелер (2026 жылғы 2 қазандағы санақ бойынша 2150-ден астам) басқа бағдарламалар үшін де ашық. Әр сұрау орнатудағы API кілтін (Authorization: Bearer) және пайдаланушының сеанс токенін (/api/auth/login → X-Oturum-Token) алып жүреді; әрекет сол пайдаланушының құқықтары мен кәсіпорнымен орындалады. Жазу сұрауын Idempotency-Key арқылы қауіпсіз қайталауға болады.
• ЖоқЖария API құжаты және оқиға хабарламалары (webhook) — OpenAPI/Swagger құжаты және өзгеріс болғанда сыртқа хабарлама жоқ. Нүктелер тізімі орнату тобынан алынады; өзгерістерді бақылау үшін жаңарту санағышы үнемі сұралады.
• Жұмыс істейдіПорталдар — Клиент порталы, жеткізуші ұсыныс порталы, мердігер порталы, B2B тапсырыс, далалық сату қосымшасы және қызметкерлер порталы; әрқайсысы бөлек кірумен және өз құқықтар шегімен жұмыс істейді.
• Жұмыс істейдіДерекқор қозғалтқыштары — Firebird, PostgreSQL, CockroachDB, Microsoft SQL Server және Oracle; бұлтта PostgreSQL (Neon) және CockroachDB Cloud. Қозғалтқыш кәсіпорын құрылғанда таңдалады.