المساعدة › دليل التكاملات

دليل التكاملات: بماذا يتصل HNR؟

تجمع هذه الصفحة في مكان واحد كيفية اتصال HNR بالبنوك وشركات الشحن والأسواق الإلكترونية والإدارة الضريبية وملفات المحاسبة والبرامج الأخرى. تبيّن التسمية أمام كل سطر حقيقة اليوم: ما الذي يعمل وحده، وما الذي يُفعَّل بحسابك الخاص أو بعقد، وما الذي لا يوجد بعد. وإذا لم يُجرَّب اتصال بحساب حقيقي، يُكتب ذلك بوضوح.

1. ماذا تعني التسميات

• متاح الآنيعمل اليوم. لا يلزم حساب أو عقد خارجي؛ وإن لزم شيء فهو خادمك أو ملفك أو مفتاحك أنت.
• جاهز، يُختبر بحسابككُتبت شيفرة الاتصال كاملةً وفق الوثائق الرسمية للطرف الآخر واجتازت اختبارات HNR الخاصة، لكنها لم تُجرَّب بحساب حقيقي. أنشئ الاتصال الأول في بيئة الاختبار لدى الطرف الآخر وتحقّق منه.
• يلزم عقدلا يقدّم الطرف الآخر وثائقه الفنية إلا بموجب عقد. مكانه جاهز في HNR؛ ويكتمل الاتصال حين تصل الوثائق وبيانات الاعتماد.
• قريبًافي قائمة انتظار التطوير؛ غير متاح اليوم.
• غير متاحغير موجود اليوم وليس في قائمة الانتظار أيضًا. غالبًا ما يؤدي مسار الملفات (CSV وXLSX وXML) العمل نفسه.

2. البنوك

• متاح الآناستيراد كشف الحساب البنكي — تُقرأ ملفات MT940 وCSV/Excel وDBS؛ وتتوفر ملفات أعمدة جاهزة للبنوك التركية والإندونيسية، ويُربط بنكك مرة واحدة فقط. تُطابَق الحركات مع الفواتير بنظام نقاط، ويُسجَّل الإيصال بعد موافقتك.
• متاح الآنخدمة البنك (البريد الإلكتروني وPDF) — تقرأ خدمةُ البنك التي تعمل بشكل منفصل رسائلَ إشعار الحركات التي يرسلها البنك وكشوفَ الحساب بصيغة PDF؛ وتُتابَع تسويات نقاط البيع هنا أيضًا.
• جاهز، يُختبر بحسابكاتصال بنكي مباشر: الخدمات المصرفية المفتوحة — في تركيا معيار Ö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، أو وفق مخطط مشتق من قالب DJP حيث لم يُنشر XSD، ولا يُسلَّم ملف غير مطابق. وأنت من يرفعه إلى البوابة.
• متاح الآنملفات الإقرارات الرسمية — في تركيا: الجزء الخاص بـ 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؛ وليست واجهة WhatsApp Business API الرسمية). وتُرسَل ملفات PDF لعروض الأسعار والطلبات والفواتير وقوالب رسائل CRM.
• متاح الآنالبريد الإلكتروني — تُرسَل عروض الأسعار والطلبات والفواتير إلى العميل عبر خادم SMTP الخاص بك.
• متاح الآنأسعار الصرف — في تركيا تُقرأ أسعار البنك المركزي (TCMB) تلقائيًا. وفي إندونيسيا يُدخَل سعر بنك إندونيسيا (JISDOR) يدويًا في جدول الأسعار؛ ولا توجد قراءة آلية.
• متاح الآنوكيل HNR (الذكاء الاصطناعي) — يعمل المساعد المخصّص للقراءة فقط عبر واجهة Anthropic Claude API؛ ومفتاح API ورسوم الاستخدام على حسابك.

8. واجهة API المفتوحة والبوابات وقاعدة البيانات

• متاح الآنواجهة HTTP API (REST/JSON) — جميع نقاط الاتصال التي تستخدمها الواجهة (أكثر من 2150 بحسب إحصاء 2 أكتوبر 2026) مفتوحة أيضًا للبرامج الأخرى. يحمل كل طلب مفتاح 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. ويُختار المحرك عند إنشاء الشركة.