الدليل التقني لإعداد التكامل بين ZenHR و SAP S/4HANA لقيود الرواتب
يوضح هذا الدليل التقني آلية تكامل ZenHR مع SAP S/4HANA لترحيل قيود الرواتب. ويغطي بيانات الاعتماد ونقاط الاتصال (Endpoints) المطلوبة من SAP، وصيغة القيود المحاسبية المتوقعة، بالإضافة إلى إعدادات ZenHR اللازمة لإنشاء قيود الرواتب الملخصة وإرسالها إلى SAP.
يهدف هذا التكامل إلى:
إرسال البيانات المالية الخاصة بالرواتب من ZenHR إلى SAP تلقائياً.
إلغاء الحاجة إلى إدخال القيود المحاسبية يدوياً.
ضمان دقة واتساق السجلات المالية.
هدف التكامل
يهدف هذا التكامل إلى تمكين ZenHR من إرسال البيانات المالية الخاصة بالرواتب تلقائياً إلى SAP S/4HANA.
يساعد ذلك المنشآت على:
ترحيل قيود الرواتب من ZenHR إلى SAP تلقائياً.
تقليل العمل اليدوي المرتبط بإدخال القيود المحاسبية.
تحسين دقة واتساق السجلات المالية.
تعزيز التنسيق بين فرق الموارد البشرية والرواتب والمالية.
آلية التكامل
يتبع التكامل أفضل الممارسات الموصى بها كما يلي:
تتم معالجة الرواتب داخل ZenHR.
يقوم ZenHR بإنشاء قيود محاسبية ملخصة.
يتم إرسال القيود الملخصة إلى SAP S/4HANA.
يقوم SAP بالتحقق من القيود وترحيلها.
المتطلبات من جهة SAP
قبل تفعيل التكامل، يجب على فريق SAP لدى العميل تزويد ZenHR ببيانات الاعتماد وواجهات البرمجة (APIs) ونقطة الترحيل المطلوبة.
للوصول إلى إعدادات التكامل في ZenHR:
التكاملات ← إعداد SAP S/4HANA ← صفحة الإعداد
1. بيانات اعتماد مستخدم SAP
يجب على فريق SAP توفير مستخدم تقني (Technical User) يمتلك الصلاحيات اللازمة للقيام بما يلي:
إنشاء القيود المحاسبية.
الوصول إلى حسابات الأرقام المحاسبية (GL Accounts) ضمن دليل الحسابات (Chart of Accounts).
بيانات الاعتماد المطلوبة:
اسم المستخدم (Username)
كلمة السر (Password)
بيانات العميل (Client Credentials) أو مفتاح API إن وجد
2. واجهة برمجة الأرقام المحاسبية (GL Accounts API)
تُستخدم هذه الواجهة لجلب الأرقام المحاسبية من SAP بحيث يمكن استخدامها وربطها بشكل صحيح داخل ZenHR.
مثال على نقطة الاتصال (Endpoint)
1 https://<your-sap
domain>/sap/opu/odata/sap/YY1_I_GLACCOUNT_ZENHR_CDS/YY1_I_GLACCOUNT_ZEN
HR
ملاحظة: قد يختلف عنوان الـ Endpoint الفعلي بناءً على إعدادات SAP الخاصة بكم.
مثال على الاستجابة (Response)
1 {
2 "d": {
3 "results": [
4 {
5 "__metadata": {
6 "id": "https://my431328999-
api.s4hana.cloud.sap/sap/opu/odata/sap/YY1_I_GLACCOUNT_ZENHR_CDS/YY1_I
_GLACCOUNT_ZENHR(ChartOfAccounts='YCOAAA',GLAccount='1101010100',Langu
age='EN',GLAccountLongName='AHLI%20Mainas;ldm')",
7 "uri": "https://my431328999-
api.s4hana.cloud.sap/sap/opu/odata/sap/YY1_I_GLACCOUNT_ZENHR_CDS/YY1_I
_GLACCOUNT_ZENHR(ChartOfAccounts='YCOAAA',GLAccount='1101010100',Langu
age='EN',GLAccountLongName='AHLI%20Main;asldm')",
8 "type":
"YY1_I_GLACCOUNT_ZENHR_CDS.YY1_I_GLACCOUNT_ZENHRType"
9 },
10 "ChartOfAccounts": "YCOAAA",
11 "GLAccount": "1101010100",
12 "Language": "EN",
13 "GLAccountLongName": "Main"
14 },
15 {
16 "__metadata": {
17 "id": "https://my431328999-
api.s4hana.cloud.sap/sap/opu/odata/sap/YY1_I_GLACCOUNT_ZENHR_CDS/YY1_I
_GLACCOUNT_ZENHR(ChartOfAccounts='YCOAAA',GLAccount='1111010800',Langu
age='EN',GLAccountLongName='AC%20%2F%20Semi%20Finished%20Medicinedasd;
')",
18 "uri": "https://my431328999-
api.s4hana.cloud.sap/sap/opu/odata/sap/YY1_I_GLACCOUNT_ZENHR_CDS/YY1_I
_GLACCOUNT_ZENHR(ChartOfAccounts='YCOAAA',GLAccount='1111010800',Langu
age='EN',GLAccountLongName='AC%20%2F%20Semi%20Finished%20Medicineasdlm
a;s')",
19 "type":
"YY1_I_GLACCOUNT_ZENHR_CDS.YY1_I_GLACCOUNT_ZENHRType"
20 },
21 "ChartOfAccounts": "YCOAAA",
22 "GLAccount": "1111010800",
23 "Language": "EN",
24 "GLAccountLongName": "Medicine"
25 }
26 ]
27 }
28 }
3. رابط ترحيل القيود المحاسبية (Journal Entry Posting URL)
وهو الرابط الذي سيستقبل قيود الرواتب المرسلة من ZenHR.
مثال على نقطة الاتصال (Endpoint)
1 https://<your-sap
domain>/sap/bc/srt/scs_ext/sap/journalentrycreaterequestconfi
صيغة قيود اليومية المتوقعة
فيما يلي مثال على صيغة XML المتوقعة عند إرسال قيود الرواتب إلى SAP S/4HANA.
تم توفير هذا المثال لكي يتمكن فريق SAP من:
مراجعة الهيكلية التي يعتمدها ZenHR.
التأكد من إمكانية قبول الصيغة مباشرة.
تعديل الصيغة إذا لزم الأمر بما يتوافق مع إعدادات SAP لديهم.
1 <soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:sfin="http://sap.com/xi/SAPSCORE/SFIN">
2
3 <soapenv:Header/>
4
5 <soapenv:Body>
6
7 <sfin:JournalEntryBulkCreateRequest>
8
9 <MessageHeader>
10
11 <ID>MSG_2025-12-01_APITEST</ID>
12
13 <!--<ReferenceID></ReferenceID>-->
14
15 <CreationDateTime>2025-12-
01T12:00:00.1234567Z</CreationDateTime>
16
17 </MessageHeader>
18
19 <JournalEntryCreateRequest>
20
21 <MessageHeader>
22
23 <ID>SUB_MSG_2025-12-01_001</ID> 24
25 <!--<ReferenceID></ReferenceID>--> 26
27 <CreationDateTime>2025-12-
01T12:00:00.1234567Z</CreationDateTime>
28
29 </MessageHeader>
30
31 <JournalEntry>
32
33
<OriginalReferenceDocumentType>BKPFF</OriginalReferenceDocumentType> 34
35
<BusinessTransactionType>RFBU</BusinessTransactionType> 36
37
<AccountingDocumentType>SA</AccountingDocumentType>
38
39 <DocumentReferenceID>2</DocumentReferenceID> 40
41 <DocumentHeaderText>Test AR Item Postinggggggg</DocumentHeaderText>
42
43 <CreatedByUser>CC0000000011</CreatedByUser> 44
45 <CompanyCode>1000</CompanyCode> 46
47 <DocumentDate>2025-12-01</DocumentDate> 48
49 <PostingDate>2025-12-01</PostingDate> 50
51 <Item>
52
53
<ReferenceDocumentItem>1</ReferenceDocumentItem>
54
55 <GLAccount>61100000</GLAccount> 56
57 <AmountInTransactionCurrency currencyCode="SAR">1001</AmountInTransactionCurrency>
58
59 <DebitCreditCode>S</DebitCreditCode> 60
61 <DocumentItemText>Test Item 2</DocumentItemText>
62
63 <AccountAssignment>
64
65 <CostCenter>1110001</CostCenter> 66
67 </AccountAssignment>
68
69 </Item>
70
71 <Item>
72
73
<ReferenceDocumentItem>2</ReferenceDocumentItem>
74
75 <GLAccount>21501000</GLAccount> 76
77 <AmountInTransactionCurrency currencyCode="SAR">-1001</AmountInTransactionCurrency>
78
79 <DebitCreditCode>H</DebitCreditCode>
80
81 <DocumentItemText>Test Item
2</DocumentItemText>
82
83 </Item>
84
85 </JournalEntry>
86
87 </JournalEntryCreateRequest>
88
89 </sfin:JournalEntryBulkCreateRequest>
90
91 </soapenv:Body>
92
93 </soapenv:Envelope>
الإعدادات المطلوبة داخل ZenHR
يجب إكمال الإعدادات التالية في ZenHR قبل إرسال قيود الرواتب إلى SAP S/4HANA.
1. إعداد الأرقام المحاسبية (GL Accounts Setup)
يجب إعداد جميع الأرقام المحاسبية المطلوبة داخل ZenHR، وأن تتطابق تماماً مع دليل الحسابات المستخدم في SAP.
التكاملات ← إعداد SAP S/4HANA ← الأرقام المحاسبية (GL Accounts)
في هذه الصفحة ستجد دليل قائمة الأرقام المحاسبية (Chart of Accounts) على شكل قائمة خيارات متاحة لكل حقل.
ملاحظة: يرجى الرجوع إلى مستند شرح دليل قائمة الأرقام المحاسبية لفهم وظيفة كل حقل.
2. ربط الهيكل التنظيمي (Organizational Mapping)
يجب أن تتطابق جميع المستويات التنظيمية المستخدمة لأغراض التجميع المالي مع القيم المعرفة في SAP.
التكاملات ← إعداد SAP S/4HANA ← المستوى التنظيمي
في هذه الصفحة يجب إدخال المعرف الداخلي الخاص بـ SAP Internal ID لكل مستوى تنظيمي يراد تضمينه في القيود المحاسبية.
3. تهيئة القيود المحاسبية (Journal Entries Structure)
يجب تهيئة القيود المحاسبية داخل ZenHR لإنشاء القيود الملخصة بناءً على الآلية المتفق عليها بين العميل وZenHR.
المسار:
تفضيلات النظام ← تهيئة القيود المحاسبية
ملاحظة: يمكن الرجوع إلى مستند تهيئة القيود المحاسبية للحصول على شرح تفصيلي لهذه الصفحة.
ملاحظات مهمة
يرجى أخذ النقاط التالية بعين الاعتبار قبل تفعيل التكامل:
يدعم هذا التكامل القيود الملخصة فقط (Summary Journals).
يجب أن تكون جميع حسابات الأستاذ العام موجودة مسبقاً في SAP.
يجب أن تتطابق الأرقام المحاسبية المعرفة في ZenHR بشكل كامل مع قائمة الأرقام المحاسبية في SAP.
يجب أن تتطابق مراكز التكلفة والأبعاد المالية الأخرى مع القيم الموجودة في SAP.
ينبغي على فريق SAP مراجعة نموذج XML قبل تفعيل التكامل.
يجب على فريق SAP تأكيد إمكانية قبول صيغة XML الحالية أو تحديد أي تعديلات مطلوبة وفقاً لإعداداتهم.
تعتمد عملية ترحيل القيود بنجاح على صحة إعداد الأرقام المحاسبية، وربط الهيكل التنظيمي، وتهيئة القيود المحاسبية داخل ZenHR.
هل كانت هذه المقالة مفيدة؟
هذا رائع!
شكرًا لك على ملاحظاتك
نعتذر أننا لم نتمكن من إفادتك
شكرًا لك على ملاحظاتك
تم إرسال الملاحظات
نحن نقدر جهودك وسنحاول تحسين المقالة