قاموس بيانات PINT AE في الإمارات: الحقول الإلزامية الـ 51 للفاتورة الإلكترونية مربوطة بـ SAP Business One
بقلم زين عباس, كودينوفا · آخر تحديث
معظم فرق SAP Business One في الإمارات تطرح السؤال نفسه أولًا: ما الحقول التي تحتاجها الفاتورة الإلكترونية، ومن أين تأتي في SAP؟ أجابت وزارة المالية عن النصف الأول في فبراير 2026 بقائمة الحقول الإلزامية. ويضيف هذا الدليل النصف الثاني: مسار كل حقل في XML بصيغة PINT AE ومصدره المعتاد في SAP Business One.
هناك مستندان مهمان. قائمة الوزارة «UAE Electronic Invoice Mandatory Fields» (V1.0، بتاريخ 23 فبراير 2026) تحدد ما يجب أن يظهر في كل فاتورة ضريبية إلكترونية. ومواصفات OpenPeppol PINT AE (Billing v1.0.4) تحدد موضع كل حقل في UBL XML. ويتحقق مزود الخدمة المعتمد (ASP) لديك من المستندين معًا.
قاموس بيانات PINT AE (قائمة الحقول): الإجابة المختصرة
- للـ فاتورة الضريبية الإلكترونية 51 حقلًا إلزاميًا، وللفاتورة التجارية 49.
- نحو 40 منها موجودة أصلًا في فاتورة مبيعات قياسية في SAP Business One.
- البقية تحتاج حقولًا معرّفة من قِبل المستخدم (UDF) وربطًا: علامات نوع المعاملة، و TIN، ونوع التسجيل القانوني، والفئة الضريبية في PINT AE، ومبالغ الأسطر بالدرهم.
- الملف بصيغة UBL 2.1 مع
CustomizationIDبقيمة urn:peppol:pint:billing-1@ae-1 وProfileIDبقيمة urn:peppol:bis:billing.
سجل الإصدارات (تم التحقق في أكتوبر 2026): PINT AE Billing v1.0.1 (31 يوليو 2025)، و v1.0.2 (8 ديسمبر 2025)، وإصلاح عاجل لـ v1.0.2 (28 يناير 2026)، وإصلاح عاجل v1.0.3 (25 مارس 2026)، وv1.0.4 (2 يونيو 2026، نهائي) وهو الذي تعتمده هذه الصفحة، وفق ملاحظات إصدارات PINT AE من OpenPeppol. أما قائمة الحقول الإلزامية من وزارة المالية فهي V1.0 بتاريخ 23 فبراير 2026.
حقول رأس الفاتورة
يعرض عمود SAP المصدر المعتاد في فاتورة المبيعات (الكائن 13). أسماء الحقول أعمدة قياسية في SAP Business One؛ وقد تخزّن حزمة التوطين لديك بعض القيم في حقول معرّفة من قِبل المستخدم بدلًا منها.
| # | الحقل | PINT AE | مسار UBL | المصدر في SAP Business One |
|---|---|---|---|---|
| 1 | رقم الفاتورة | IBT-001 | cbc:ID | OINV.DocNum (مع بادئة السلسلة إذا كنت تطبعها) |
| 2 | تاريخ الفاتورة | IBT-002 | cbc:IssueDate | OINV.DocDate |
| 3 | رمز نوع الفاتورة | IBT-003 | cbc:InvoiceTypeCode | 380، أو 480 للخارج عن النطاق |
| 4 | عملة الفاتورة | IBT-005 | cbc:DocumentCurrencyCode | OINV.DocCur |
| 5 | علامات نوع المعاملة | BTAE-02 | cbc:ProfileExecutionID | حقل مستخدم على OINV (8 خانات، انظر أدناه) |
| 6 | تاريخ استحقاق الدفع | IBT-009 | cbc:DueDate | OINV.DocDueDate |
| 7 | نوع عملية الأعمال | IBT-023 | cbc:ProfileID | ثابت: urn:peppol:bis:billing |
| 8 | معرّف المواصفات | IBT-024 | cbc:CustomizationID | ثابت: urn:peppol:pint:billing-1@ae-1 |
| 9 | رمز وسيلة الدفع | IBT-081 | cac:PaymentMeans/cbc:PaymentMeansCode | OINV.PeyMethod مربوطًا بـ UNTDID 4461 |
يتطلب PINT AE أيضًا معرّفًا فريدًا (BTAE-07، cbc:UUID) في XML. لا يخزّن SAP معرّفًا كهذا لكل فاتورة، لذلك ولّده في التكامل واحفظه في حقل مستخدم لأغراض التدقيق.
حقول البائع والمشتري
| # | الحقل | PINT AE | مسار UBL (تحت cac:Party) | المصدر في SAP Business One |
|---|---|---|---|---|
| 10 | اسم البائع | IBT-027 | cac:PartyLegalEntity/cbc:RegistrationName | OADM.CompnyName |
| 11 | العنوان الإلكتروني للبائع | IBT-034 | cbc:EndpointID | حقل مستخدم: TIN البائع (10 أرقام) |
| 12 | المعرّف الإلكتروني للبائع | IBT-034-1 | cbc:EndpointID/@schemeID | ثابت: 0235 |
| 13 | رقم التسجيل القانوني للبائع | IBT-030 | cac:PartyLegalEntity/cbc:CompanyID | حقل مستخدم أو OADM: رقم الرخصة التجارية |
| 14 | نوع رقم تسجيل البائع | BTAE-15 | cbc:CompanyID/@schemeAgencyID | حقل مستخدم: TL أو EID أو PAS أو CD |
| 15 | المعرّف الضريبي للبائع | IBT-031 | cac:PartyTaxScheme/cbc:CompanyID | OADM.TaxIdNum (رقم التسجيل الضريبي لضريبة القيمة المضافة) |
| 16 | رمز النظام الضريبي للبائع | IBT-031-1 | cac:PartyTaxScheme/cac:TaxScheme/cbc:ID | ثابت: VAT |
| 17 | سطر العنوان الأول للبائع | IBT-035 | cac:PostalAddress/cbc:StreetName | ADM1.Street |
| 18 | مدينة البائع | IBT-037 | cac:PostalAddress/cbc:CityName | ADM1.City |
| 19 | التقسيم الإداري لبلد البائع | IBT-039 | cac:PostalAddress/cbc:CountrySubentity | ADM1.State (الإمارة) |
| 20 | رمز بلد البائع | IBT-040 | cac:Country/cbc:IdentificationCode | AE |
| 21 | اسم المشتري | IBT-044 | cac:PartyLegalEntity/cbc:RegistrationName | OINV.CardName / OCRD.CardName |
| 22 | العنوان الإلكتروني للمشتري | IBT-049 | cbc:EndpointID | حقل مستخدم على OCRD: TIN المشتري |
| 23 | المعرّف الإلكتروني للمشتري | IBT-049-1 | cbc:EndpointID/@schemeID | 0235 للمشترين في الإمارات |
| 24 | المعرّف الضريبي للمشتري | IBT-048 | cac:PartyTaxScheme/cbc:CompanyID | OCRD.LicTradNum (رقم التسجيل الضريبي لضريبة القيمة المضافة) |
| 25 | رمز النظام الضريبي للمشتري | IBT-048-1 | cac:PartyTaxScheme/cac:TaxScheme/cbc:ID | ثابت: VAT |
| 26 | سطر العنوان الأول للمشتري | IBT-050 | cac:PostalAddress/cbc:StreetName | INV12.StreetB (عنوان الفوترة في الفاتورة) |
| 27 | مدينة المشتري | IBT-052 | cac:PostalAddress/cbc:CityName | INV12.CityB |
| 28 | التقسيم الإداري لبلد المشتري | IBT-054 | cac:PostalAddress/cbc:CountrySubentity | INV12.StateB |
| 29 | رمز بلد المشتري | IBT-055 | cac:Country/cbc:IdentificationCode | INV12.CountryB |
خذ عنوان المشتري من الفاتورة (INV12)، لا من البيانات الرئيسية لشريك الأعمال. تحتفظ الفاتورة بالعنوان الذي كان ساريًا في ذلك اليوم، حتى لو تغيرت البيانات الرئيسية لاحقًا.
الإجماليات وتفصيل ضريبة القيمة المضافة
| # | الحقل | PINT AE | مسار UBL | المصدر في SAP Business One |
|---|---|---|---|---|
| 30 | مجموع صافي مبالغ الأسطر | IBT-106 | cac:LegalMonetaryTotal/cbc:LineExtensionAmount | مجموع INV1.LineTotal (أو TotalFrgn) |
| 31 | الإجمالي دون ضريبة | IBT-109 | cac:LegalMonetaryTotal/cbc:TaxExclusiveAmount | OINV.DocTotal − OINV.VatSum |
| 32 | إجمالي مبلغ الضريبة | IBT-110 | cac:TaxTotal/cbc:TaxAmount | OINV.VatSum |
| 33 | الإجمالي شاملًا الضريبة | IBT-112 | cac:LegalMonetaryTotal/cbc:TaxInclusiveAmount | OINV.DocTotal |
| 34 | المبلغ المستحق | IBT-115 | cac:LegalMonetaryTotal/cbc:PayableAmount | OINV.DocTotal ناقص الدفعات المقدمة المطبقة |
| 35 | المبلغ الخاضع للضريبة للفئة | IBT-116 | cac:TaxSubtotal/cbc:TaxableAmount | INV1.LineTotal مجمّعًا حسب مجموعة الضريبة |
| 36 | مبلغ ضريبة الفئة | IBT-117 | cac:TaxSubtotal/cbc:TaxAmount | INV1.VatSum مجمّعًا حسب مجموعة الضريبة |
| 37 | رمز الفئة الضريبية | IBT-118 | cac:TaxCategory/cbc:ID | حقل مستخدم على مجموعة الضريبة (OVTG): S أو Z أو E أو O أو AE |
| 38 | نسبة الفئة الضريبية | IBT-119 | cac:TaxCategory/cbc:Percent | OVTG.Rate |
سبب الرفض المعتاد هنا رأس لا تتطابق أرقامه: يجب أن يساوي مجموع الأسطر IBT-106، وأن يساوي IBT-109 + IBT-110 قيمة IBT-112، وأن يكون كل تفصيل مجموع أسطره هو. قد يختلف التقريب لكل سطر في SAP عن التقريب لكل فئة في XML بفلس واحد، لذلك احسب إجماليات XML من قيم الأسطر المقرّبة نفسها.
للفاتورة بعملة أجنبية، يتوقع PINT AE أيضًا إجمالي ضريبة القيمة المضافة بعملة المحاسبة الضريبية (IBT-111) في عنصر cac:TaxTotal ثانٍ، ومبالغ الأسطر بالدرهم (الحقلان 48 و49 أدناه).
حقول أسطر الفاتورة
| # | الحقل | PINT AE | مسار UBL (تحت cac:InvoiceLine) | المصدر في SAP Business One |
|---|---|---|---|---|
| 39 | معرّف السطر | IBT-126 | cbc:ID | INV1.LineNum + 1 |
| 40 | الكمية المفوترة | IBT-129 | cbc:InvoicedQuantity | INV1.Quantity |
| 41 | رمز وحدة القياس | IBT-130 | cbc:InvoicedQuantity/@unitCode | INV1.UomCode مربوطًا بـ UN/ECE Rec 20 (مثل KGM و H87) |
| 42 | صافي مبلغ السطر | IBT-131 | cbc:LineExtensionAmount | INV1.LineTotal (أو TotalFrgn) |
| 43 | صافي سعر الصنف | IBT-146 | cac:Price/cbc:PriceAmount | INV1.Price |
| 44 | إجمالي سعر الصنف | IBT-148 | cac:Price/cac:AllowanceCharge/cbc:BaseAmount | INV1.PriceBefDi |
| 45 | الكمية الأساسية للسعر | IBT-149 | cac:Price/cbc:BaseQuantity | 1 (أو وحدة السعر لديك) |
| 46 | الفئة الضريبية للصنف | IBT-151 | cac:Item/cac:ClassifiedTaxCategory/cbc:ID | INV1.VatGroup ← حقل مستخدم للفئة الضريبية |
| 47 | نسبة ضريبة الصنف | IBT-152 | cac:Item/cac:ClassifiedTaxCategory/cbc:Percent | INV1.VatPrcnt |
| 48 | مبلغ ضريبة القيمة المضافة للسطر بالدرهم | BTAE-08 | cac:ItemPriceExtension/cac:TaxTotal/cbc:TaxAmount | INV1.VatSum (العملة المحلية الدرهم) |
| 49 | مبلغ السطر بالدرهم | BTAE-10 | cac:ItemPriceExtension/cbc:Amount | INV1.LineTotal + INV1.VatSum (العملة المحلية) |
| 50 | اسم الصنف | IBT-153 | cac:Item/cbc:Name | INV1.Dscription |
| 51 | وصف الصنف | IBT-154 | cac:Item/cbc:Description | OITM.UserText أو INV1.FreeTxt |
الحقلان 48 و49 إضافتان إماراتيتان. عندما تكون العملة المحلية للشركة في SAP Business One هي الدرهم، تحتوي أعمدة العملة المحلية في INV1 على هذه القيم أصلًا.
علامات نوع المعاملة (BTAE-02)
cbc:ProfileExecutionID نص من 8 خانات من الأصفار والآحاد. كل خانة تفعّل حالة خاصة واحدة:
| الخانة | المعنى | قيمة مثال |
|---|---|---|
| 1 | توريد في منطقة حرة | 10000000 |
| 2 | توريد مفترض (دون مقابل) | 01000000 |
| 3 | نظام هامش الربح | 00100000 |
| 4 | فاتورة ملخصة | 00010000 |
| 5 | توريد مستمر | 00001000 |
| 6 | فوترة الوكيل المُفصَح عنه | 00000100 |
| 7 | توريد عبر التجارة الإلكترونية | 00000010 |
| 8 | الصادرات | 00000001 |
الفاتورة المحلية القياسية قيمتها 00000000. بعض العلامات تستدعي حقولًا إضافية: توريدات المنطقة الحرة تحتاج معرّف المستفيد (BTAE-01)، وفوترة الوكيل المُفصَح عنه تحتاج رقم التسجيل الضريبي للموكّل (BTAE-14).
في SAP Business One يكون التصميم العملي ثمانية حقول مستخدم من نوع نعم/لا على المستند التسويقي (أو حقلًا واحدًا من 8 خانات مع بحث منسّق)، مع قيم افتراضية لكل مجموعة عملاء، فلا يحتاج المستخدمون إلى تعديلها إلا نادرًا.
TIN و TRN ومعرّف Peppol
وزارة المالية دقيقة هنا، وهذه النقطة تُربك كثيرًا من عمليات الربط:
- رقم TIN رقم من 10 خانات. تعرّفه إرشادات الفوترة الإلكترونية الصادرة عن وزارة المالية (الإصدار 2.0) بأنه أول 10 أرقام من رقم TRN الخاص بك، ولأعضاء المجموعة الضريبية هو رقم TRN الخاص بالعضو نفسه، لا بالممثل. وإذا ظهرت أرقام مختلفة في تسجيلك لضريبة القيمة المضافة وتسجيلك لضريبة الشركات، فراجع الهيئة الاتحادية للضرائب.
- معرّف Peppol (العنوان الإلكتروني) هو المخطط 0235 مع TIN، مثل
0235:1001234567. - رقم التسجيل الضريبي لضريبة القيمة المضافة (VAT TRN) (15 رقمًا) يبقى في حقول المعرّف الضريبي (IBT-031 و IBT-048).
لذلك خزّن TIN في حقل خاص به. لا تشتقه من رقم التسجيل في ضريبة القيمة المضافة في LicTradNum دون تحقق.
الإشعارات الدائنة
تستخدم الإشعارات الدائنة مستند CreditNote برمز النوع 381 (إشعار دائن ضريبي) أو 81 (إشعار دائن متعلق بسلع أو خدمات)، وتحتاج رمز سبب الإشعار الدائن (BTAE-03):
| الرمز | السبب |
|---|---|
| DL8.61.1.A | أُلغي التوريد |
| DL8.61.1.B | تغيّرت المعاملة الضريبية بسبب تغيّر طبيعة التوريد |
| DL8.61.1.C | عُدّل المقابل المتفق عليه (مثل الإعفاء من الديون المعدومة) |
| DL8.61.1.D | أُعيدت السلع أو الخدمات ورُدّ المقابل |
| DL8.61.1.E | فُرضت الضريبة أو طُبّقت المعاملة الضريبية بالخطأ |
| VD | خصم كمية |
في SAP Business One يُربط الإشعار الدائن للمبيعات (ORIN، الكائن 14) بالطريقة نفسها التي تُربط بها الفاتورة، إضافة إلى حقل مستخدم لرمز السبب والمرجع إلى الفاتورة الأصلية من المستند الأساس.
حقول المستخدم التي تضيفها في SAP Business One
| الجدول | حقل المستخدم | ما يحتويه |
|---|---|---|
| OADM (الشركة) | TIN البائع، ونوع التسجيل القانوني | رقم TIN من 10 أرقام؛ و TL أو EID أو PAS أو CD |
| OCRD (شريك الأعمال) | TIN المشتري، ورقم التسجيل القانوني ونوعه | معرّف Peppol وبيانات التسجيل |
| OVTG (مجموعات الضريبة) | الفئة الضريبية في PINT AE | S أو Z أو E أو O أو AE |
| OINV و ORIN | علامات نوع المعاملة، وسبب الإشعار الدائن، و UUID، وحالة مزود الخدمة | قيم لكل مستند ورد مزود الخدمة |
بوجود هذه الحقول يمكن إنشاء XML دون أن يُطلب من المستخدمين أي شيء وقت الترحيل.
ترتيب عمل عملي
- أضف حقول المستخدم أعلاه وعبّئ TIN لشركتك ولعملائك في الإمارات.
- اربط كل مجموعة ضريبة بفئة ضريبية في PINT AE.
- ابنِ XML لفاتورة واحدة وإشعار دائن واحد، وتحقق منه مقابل قواعد التحقق في PINT AE بأداة التحقق المجانية لدينا.
- اربط SAP Business One بمزود الخدمة لديك: أرسل كل مستند، وخزّن الرد، واعرض الحالة على الفاتورة.
- اختبر الحالات الخاصة التي تستخدمها فعلًا: الصادرات، والمنطقة الحرة، والعملة الأجنبية، والإشعارات الدائنة.
للمواعيد النهائية والغرامات واختيار مزود الخدمة، راجع الفوترة الإلكترونية في الإمارات لـ SAP Business One. وتحوّل أداة الجاهزية رقم TRN الخاص بك إلى معرّف Peppol وتعرض موعدك النهائي.
المصادر
- وزارة المالية الإماراتية: الحقول الإلزامية للفاتورة الإلكترونية V1.0 (23 فبراير 2026، PDF)
- وزارة المالية الإماراتية: إرشادات الفوترة الإلكترونية في الإمارات، الإصدار 2.0 (26 أكتوبر 2026، PDF، بالإنجليزية)
- وزارة المالية الإماراتية: صفحة مبادرة الفوترة الإلكترونية
- OpenPeppol: PINT AE Billing (BIS، النموذج الدلالي، الربط النحوي)
- OpenPeppol: قائمة رموز نوع المعاملة لفواتير PINT AE
- OpenPeppol: الربط النحوي لفواتير PINT AE
- OpenPeppol: ملاحظات إصدارات PINT AE Billing
- OpenPeppol: رموز أسباب الإشعارات الدائنة في PINT AE
خدمات ذات صلة
أسئلة شائعة
كم عدد الحقول الإلزامية في الفاتورة الضريبية الإلكترونية في الإمارات؟
51. يسرد مستند وزارة المالية «UAE Electronic Invoice Mandatory Fields» (V1.0، بتاريخ 23 فبراير 2026) واحدًا وخمسين حقلًا إلزاميًا للفاتورة الضريبية الإلكترونية و49 حقلًا للفاتورة التجارية. ويضم نموذج بيانات PINT AE الكامل حقولًا اختيارية أكثر بكثير.
ما معرّف Peppol لشركة إماراتية؟
المخطط 0235 مع رقم التعريف الضريبي (TIN)، مثل 0235:1001234567. تعرّف إرشادات الفوترة الإلكترونية الصادرة عن وزارة المالية رقم TIN بأنه أول 10 أرقام من رقم TRN الخاص بك، بما في ذلك لأعضاء المجموعة الضريبية (رقمهم الخاص)؛ وإذا ظهرت أرقام مختلفة في تسجيلك لضريبة القيمة المضافة وتسجيلك لضريبة الشركات، فراجع الهيئة الاتحادية للضرائب. والشركات الخاضعة للنطاق غير المسجلة في أي ضريبة يجب أن تسجّل لدى الهيئة الاتحادية للضرائب للحصول على TIN.
ما قيمة CustomizationID في PINT AE؟
urn:peppol:pint:billing-1@ae-1 للفواتير والإشعارات الدائنة معًا، مع ProfileID بقيمة urn:peppol:bis:billing.
ما رموز أنواع الفواتير التي يستخدمها PINT AE؟
380 للفاتورة التجارية أو الضريبية، و480 للفاتورة الخارجة عن نطاق الضريبة. وتستخدم الإشعارات الدائنة 381 (إشعار دائن ضريبي) أو 81 (إشعار دائن متعلق بسلع أو خدمات)، وتحتاج رمز سبب مثل DL8.61.1.A (إلغاء التوريد) أو VD (خصم كمية).
هل يستطيع SAP Business One إنتاج XML بصيغة PINT AE جاهزًا؟
ليس كملف PINT AE نهائي يُرسل إلى مزود الخدمة (ASP). البيانات موجودة في معظمها في SAP Business One، لكنك تحتاج الحقول الإضافية الموضحة هنا، وربطًا لملف XML، واتصالًا بمزود الخدمة المعتمد لديك يرسل كل مستند ويخزّن الرد.
جاهز للبدء؟
أخبرنا بما تحتاجه. ستحصل على إجابة تقنية واضحة ونطاق عمل محدد وسعر ثابت، عادةً خلال 24 ساعة.
