راهنما › فهرست یکپارچه‌سازی‌ها

فهرست یکپارچه‌سازی‌ها: HNR به چه چیزهایی وصل می‌شود؟

این صفحه در یک جا گرد می‌آورد که HNR چگونه به بانک‌ها، شرکت‌های حمل، بازارهای آنلاین، اداره مالیات، فایل‌های حسابداری و برنامه‌های دیگر وصل می‌شود. برچسب جلوی هر سطر واقعیت امروز را می‌گوید: چه چیزی خودش کار می‌کند، چه چیزی با حساب خود شما یا با قرارداد فعال می‌شود، و چه چیزی هنوز وجود ندارد. اگر اتصالی با حساب واقعی آزموده نشده باشد، این صریح نوشته می‌شود.

1. معنای برچسب‌ها

• در دسترسهمین امروز کار می‌کند. حساب یا قرارداد بیرونی لازم نیست؛ اگر چیزی لازم باشد، سرور، فایل یا کلید خود شماست.
• آماده، با حساب خود بیازماییدکد اتصال کامل و مطابق مستندات رسمی طرف مقابل نوشته شده و از آزمون‌های خود HNR گذشته است، اما با حساب واقعی آزموده نشده است. نخستین اتصال را در محیط آزمایشی طرف مقابل برقرار و بررسی کنید.
• قرارداد لازم استطرف مقابل مستندات فنی خود را فقط با قرارداد می‌دهد. جای آن در HNR آماده است؛ با رسیدن مستندات و اطلاعات ورود، اتصال کامل می‌شود.
• به‌زودیدر صف توسعه است؛ امروز در دسترس نیست.
• موجود نیستامروز وجود ندارد و در صف هم نیست. معمولاً مسیر فایلی (CSV، XLSX، XML) همان کار را انجام می‌دهد.

2. بانک

• در دسترسورود صورت‌حساب بانکی — فایل‌های MT940، CSV/Excel و DBS خوانده می‌شوند؛ برای بانک‌های ترکیه و اندونزی پروفایل ستون آماده وجود دارد و بانک خود را یک بار نگاشت می‌کنید. تراکنش‌ها با امتیازدهی با فاکتورها تطبیق داده می‌شوند و با تأیید شما رسید ثبت می‌شود.
• در دسترسسرویس بانک (ایمیل و PDF) — ایمیل‌های اطلاع‌رسانی تراکنش که بانک می‌فرستد و صورت‌حساب‌های PDF را سرویس بانک که جداگانه اجرا می‌شود می‌خواند؛ تسویه کارت‌خوان (POS) هم همین‌جا پیگیری می‌شود.
• آماده، با حساب خود بیازماییداتصال مستقیم بانک: بانکداری باز — در ترکیه استاندارد ÖHVPS (سرویس اطلاعات حساب BKM) و در اندونزی استاندارد 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 (اندونزی) — XML گروهی e-Faktur، XML مرجوعی (retur)، e-Bupot Unifikasi، PPh 21 (BPMP) و 1721-A1 ساخته می‌شوند؛ هر فایل با XSD سازمان DJP، و اگر XSD منتشر نشده باشد با طرح‌واره‌ای که از الگوی DJP استخراج شده، بررسی می‌شود و فایل نامنطبق داده نمی‌شود. بارگذاری در درگاه با شماست.
• در دسترسفایل‌های اظهارنامه رسمی — در ترکیه بخش SGK اظهارنامه یکپارچه کسر مالیات و حق بیمه (XML)؛ در اندونزی خروجی‌های BPJS (SIPP، Edabu)، SPT Masa PPN، LKPM، SAK EP و IT Inventory. تقویم تکالیف مهلت‌ها را یادآوری می‌کند.
• در دسترسخواندن فاکتورهای دریافتی — XML صورت‌حساب الکترونیکی (e-Fatura یا e-Faktur)، 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 و ارسال دفتر الکترونیکی e-Defter به GİB وجود ندارد. اسناد را می‌توان به‌صورت XLSX گرفت.

7. ارتباطات و سرویس‌های بیرونی

• در دسترسواتس‌اپ — سرویس پیام شماره خود شما را با کد QR وصل می‌کند (از راه WhatsApp Web؛ API رسمی WhatsApp Business نیست). PDF پیش‌فاکتور، سفارش و فاکتور و الگوهای پیام CRM فرستاده می‌شوند.
• در دسترسایمیل — پیش‌فاکتورها، سفارش‌ها و فاکتورها از راه سرور SMTP خود شما برای مشتری فرستاده می‌شوند.
• در دسترسنرخ ارز — در ترکیه نرخ‌های بانک مرکزی (TCMB) خودکار خوانده می‌شوند. در اندونزی نرخ Bank Indonesia (JISDOR) دستی در جدول نرخ وارد می‌شود؛ خواندن خودکار وجود ندارد.
• در دسترسدستیار HNR (هوش مصنوعی) — دستیار فقط‌خواندنی با API Anthropic Claude کار می‌کند؛ کلید API و هزینه استفاده با شماست.

8. API باز، درگاه‌ها و پایگاه داده

• در دسترسHTTP API (REST/JSON) — همه نقاط پایانی که رابط کاربری به کار می‌برد (بیش از ۲۱۵۰ بنابر شمارش ۲ اکتبر ۲۰۲۶) برای برنامه‌های دیگر هم باز است. هر درخواست کلید API نصب (Authorization: Bearer) و توکن نشست یک کاربر (/api/auth/login ← X-Oturum-Token) را با خود دارد؛ عملیات با دسترسی‌ها و شرکت همان کاربر اجرا می‌شود. درخواست نوشتن را می‌توان با Idempotency-Key بی‌خطر تکرار کرد.
• موجود نیستمستندات عمومی API و اعلان رویداد (وب‌هوک) — سند OpenAPI/Swagger و اعلان بیرونی هنگام تغییر وجود ندارد. فهرست نقاط پایانی از تیم نصب گرفته می‌شود؛ برای دنبال کردن تغییرات، شمارنده به‌روزرسانی پرس‌وجو می‌شود.
• در دسترسدرگاه‌ها — درگاه مشتری، درگاه پیشنهاد قیمت تأمین‌کننده، درگاه پیمانکار فرعی، سفارش B2B، برنامه فروش میدانی و درگاه کارکنان؛ هر کدام با ورود جداگانه و محدوده دسترسی خودش کار می‌کند.
• در دسترسموتورهای پایگاه داده — Firebird، PostgreSQL، CockroachDB، Microsoft SQL Server و Oracle؛ در فضای ابری PostgreSQL (Neon) و CockroachDB Cloud. موتور هنگام ساخت شرکت انتخاب می‌شود.