التكامل مع فوترة عبر واجهة برمجة التطبيقات يعني إرسال بيانات فاتورتك إلى نقطة نهاية واحدة. تحوّلها GoRoute إلى معيار PINT OM، وتتحقق منها وفق ملفات Schematron الرسمية، وتطبّق توقيع XAdES، وتنشئ المعرّف الفريد UUID والتجزئة ورمز QR بصيغة TLV، وترسل الفاتورة عبر شبكة بيبول، وتودع مستند البيانات الضريبية لدى هيئة الضرائب العُمانية.
امتثال كامل لهيئة الضرائب العُمانية
GoRoute.ai مزوّد خدمة معتمد بالكامل لمشروع فوترة للفوترة الإلكترونية في سلطنة عُمان، بعد إتمام اختبارات OpenPeppol PINT واعتماد هيئة الضرائب العُمانية.
يجب أن يصدر حل الفوترة الإلكترونية في عُمان فواتير بمعيار PINT OM تجتاز ملفات Schematron الرسمية، وأن يوقّعها بتوقيع XAdES، وينشئ رمز QR بصيغة TLV، ويتبادلها عبر شبكة بيبول من خلال نقطة وصول معتمدة، ويودع مستند البيانات الضريبية لدى هيئة الضرائب، ويستقبل المستندات الواردة، ويحتفظ بها جميعًا لأغراض التدقيق.
تنفّذ GoRoute كل ذلك بصفتها مزوّد خدمة فوترة معتمدًا. ويوضح دليل الجاهزية لفوترة ما يتطلبه بناء كل جزء منها، بينما يتناول كيفية اختيار مزوّد الخدمة ما ينبغي السؤال عنه قبل التوقيع.
كل ما تحتاجه لتلبية متطلبات الفوترة الإلكترونية لهيئة الضرائب العُمانية
توقيع XAdES مغلف تلقائي لكل فاتورة. إثبات تشفيري للأصالة والسلامة كما تتطلبه هيئة الضرائب العُمانية.
رموز QR مُشفّرة بصيغة TLV تحتوي على اسم البائع ورقم ضريبة القيمة المضافة وإجمالي الفاتورة ومبلغ الضريبة والطابع الزمني. قابلة للمسح من قبل مفتشي الضرائب.
مُعرّف فريد (UUID) وتجزئة تشفيرية SHA-256 لكل فاتورة لضمان التتبع وعدم التلاعب بالسجلات.
مبالغ ضريبة القيمة المضافة الخاصة بعُمان على مستوى البند (BT-OM-16) وإجماليات البنود شاملة الضريبة (BT-OM-17) تُحسب تلقائيًا.
التحقق قبل الإرسال وفقًا لجميع قواعد قاموس بيانات الفوترة الإلكترونية في عُمان. اكتشف الأخطاء قبل أن تسبب الرفض.
دعم أصلي للريال العُماني مع تحويل تلقائي للعملات. فواتير العملات الأجنبية تتضمن مبالغ الضريبة بالريال العُماني.
أنشئ مستندات متوافقة لجميع سيناريوهات الأعمال في عُمان
الرمز 388
فاتورة ضريبة القيمة المضافة القياسية للسلع والخدمات
الرمز 381
تصحيح للمبالغ الزائدة أو المرتجعات
الرمز 383
رسوم إضافية بعد الفاتورة الأصلية
الرمز 386
دفعة مقدّمة قبل التسليم
جميع رموز فئات ضريبة القيمة المضافة المعتمدة في عُمان مع التحقق التلقائي
٥٪ ض.ق.م.
٠٪ مع بيان السبب
توريدات معفاة من الضريبة
غير خاضع للضريبة
المشتري يحتسب الضريبة
Oman's PINT profile adds 120 country-specific rules on top of Peppol BIS Billing 3.0. These are the ones that decide whether your invoice clears — taken from the ruleset GoRoute validates against, not from a summary.
Asking what the file itself has to be — UBL 2.1 XML, the PINT OM profile, and whether JSON is an alternative? That question is answered in full in what format an Oman e-invoice must be in.
Oman-specific rules (IBR-…-OM)
Document types with their own rule packs
Zero-rating reason codes (VATZR-OM)
Exemption reason codes (VATEX-OM)
Every Oman invoice carries a 20-character string of 1s and 0s, with at least one 1. Fifteen of the twenty positions are defined; the remainder are reserved. Each position marks an active transaction type, and several rules key off specific positions — set the wrong bit and an otherwise valid invoice is rejected.
0248 — the identifier that trips people up
Oman participants are registered under Peppol scheme 0248, and the identifier keeps its OM prefix. A common integration error is registering under a generic scheme or stripping the country prefix — the participant then cannot be resolved through SMP lookup, and senders get a delivery failure that looks like a network problem rather than a registration one.
| Rule | Applies to | What it requires |
|---|---|---|
| IBR-032-OM fatal | Credit note 381, debit note 383, self-billed credit note 261 |
Must carry the preceding invoice reference (IBT-025), issue date (IBT-026) and UUID (BTOM-031). All three. Missing any one is fatal — and a credit note is the single most common thing to get wrong. |
| IBR-177-OM | Self-billed invoice 389, self-billed credit note 261 |
BTOM-001 is restricted to a short list: self-billed, import of services under RCM, profit-margin self-billing, or import of goods. Self-billing outside those cases is rejected. |
| IBR-002-OM | All documents | The invoice UUID must be a deterministic version 5 UUID, not a random one. Re-deriving the same invoice must produce the same UUID. |
| IBR-034-OM | Any non-OMR invoice | If the invoice currency (IBT-005) is not OMR, the VAT accounting currency (IBT-006) must be present. |
380 Commercial invoice — the standard case381 Credit note383 Debit note386 Prepayment invoice389 Self-billed invoice — buyer issues on the supplier's behalf261 Self-billed credit noteGoRoute ships separate rule packs for invoice, credit note, self-billed invoice and self-billed credit note — each validated against its own Schematron rather than one generic pass.
Zero-rated and exempt lines must carry a reason code from the Oman code lists — VATZR-OM-01 to VATZR-OM-16 for zero-rating, and VATEX-OM-01 to VATEX-OM-12 for exemption. A zero-rated line with no reason code fails validation.
This matters most for importers and exporters: export of services and re-export of goods each have their own code, and medicines and Ministry-of-Health-approved medical equipment are zero-rated under Ministerial Decision 59/2021, made under Articles 51–53 of Sultani Decree 151/2020.
See it running: the Odoo and Oracle APEX demos both validate against this ruleset end to end.
استدعاء REST واحد يغطي الإصدار والتحقق والإرسال عبر بيبول ومستند البيانات الضريبية. اربط نظام تخطيط الموارد ERP أو برنامج المحاسبة أو تطبيقك المخصص، وجرّبه على البيئة التجريبية المجانية قبل الالتزام.
أرسل الفواتير عبر واجهة JSON أو UBL XML بسيطة. احصل على نتائج التحقق والمستندات الموقّعة فورًا.
POST /api/v1/invoices
{
"seller_vat": "OM1234567890",
"buyer_vat": "OM0987654321",
"currency": "OMR",
"items": [...],
"cius": "OM" // Oman CIUS validation
}تكاملات جاهزة مع برامج الأعمال الشائعة المستخدمة في عُمان ودول مجلس التعاون الخليجي.
شرح مفصّل لكل نظام، مع قواعد عُمان التي يجب أن يستوفيها كل منها: Microsoft Dynamics 365 وSAP S/4HANA وOdoo وتطبيقات Oracle وQuickBooks وZoho Books وTallyPrime وExcel.
ابدأ بإنشاء فواتير إلكترونية متوافقة مع التوقيعات الرقمية ورموز QR والتحقق الكامل من هيئة الضرائب في دقائق.
كل ما تحتاج معرفته حول الامتثال لفوترة عُمان الإلكترونية
فوترة هي مبادرة الفوترة الإلكترونية في عُمان التي تديرها هيئة الضرائب العُمانية. ويجعل القرار 189/2026 الفواتير الضريبية الإلكترونية إلزامية اعتبارًا من 1 أبريل 2027 للمكلفين الذين تتجاوز توريداتهم السنوية 5,000,000 ريال عُماني، ومن 1 أكتوبر 2027 لمن كانت توريداتهم عند هذا الحد أو دونه. وتسري المواعيد نفسها على الفواتير المبسطة (B2C). يساعدك GoRoute.ai على الاستعداد الآن لتجنب الاستعجال في اللحظة الأخيرة.
أرقام ضريبة القيمة المضافة في عُمان تتبع التنسيق OM متبوعًا بـ 10 أرقام (مثال: OM1234567890). هذا إلزامي لجميع البائعين المقيمين في عُمان على الفواتير الإلكترونية. GoRoute.ai يتحقق من تنسيق رقم الضريبة قبل الإرسال لاكتشاف الأخطاء مبكرًا.
يجب أن تحتوي رموز QR للفواتير الإلكترونية في عُمان على بيانات مُشفّرة بصيغة TLV تشمل: اسم البائع، رقم ضريبة القيمة المضافة للبائع، الطابع الزمني للفاتورة، إجمالي الفاتورة شاملة الضريبة، ومبلغ الضريبة. GoRoute.ai ينشئ تلقائيًا رموز QR متوافقة ويضمّنها في فواتيرك.
تتطلب عُمان توقيعات XAdES (التوقيعات الإلكترونية المتقدمة XML) بصيغة مغلفة ضمن امتدادات UBL. يجب أن يستخدم التوقيع معرّف URI القياسي وطريقة التوقيع المغلف. GoRoute.ai يتولى جميع عمليات التوقيع التشفيري تلقائيًا باستخدام شهادة مؤسستك.
نسبة ضريبة القيمة المضافة الأساسية في عُمان هي ٥٪. تنطبق على معظم السلع والخدمات ما لم تكن معفاة أو بنسبة صفرية تحديدًا. GoRoute.ai يتحقق من أن بنود النسبة الأساسية (S) تتضمن نسبة ٥٪ الصحيحة ويُنبّه إذا استُخدمت نسبة مختلفة.
يجب أن تشير إشعارات الدائن في عُمان (رمز النوع 381) إلى الفاتورة الأصلية التي يتم تصحيحها. يشمل ذلك رقم الفاتورة الأصلية (BT-OM-31) واختياريًا مُعرّف UUID للفاتورة الأصلية. يجب أيضًا تقديم رمز السبب (BT-OM-32). GoRoute.ai يفرض هذه المراجع أثناء التحقق.
تتطلب عُمان ٨ حقول إضافية بخلاف EN16931: BT-OM-01 (مُعرّف UUID)، BT-OM-14 (رمز QR)، BT-OM-16 (مبلغ الضريبة للبند)، BT-OM-17 (إجمالي البند شاملاً الضريبة)، BT-OM-28 (التوقيع الرقمي)، BT-OM-29 (تجزئة الفاتورة)، BT-OM-84 (مرجع المستند لكل بند). GoRoute.ai يتحقق من جميع الحقول الـ ٧٥ الخاصة بعُمان.
نعم، ولكن بشروط. يجب أن تستخدم الفواتير المحلية في عُمان الريال العُماني (OMR). إذا أصدرت فاتورة بالدولار أو اليورو أو عملات أخرى، يجب تعيين الريال العُماني كعملة ضريبية (cbc:TaxCurrencyCode) لحساب مبالغ الضريبة بالريال. GoRoute.ai يتحقق من ذلك ويُنبّه إذا لم تكن عملة المستند أو الضريبة بالريال العُماني.
يحدد قاموس بيانات الفوترة الإلكترونية في عُمان الإصدار 1.0.1 عدد ٣٣٦ قاعدة أعمال و٢٩٠ مصطلحًا تجاريًا و١٧ قائمة رموز. تغطي كل شيء من وجود الحقول الإلزامية إلى التحقق من القيم والحسابات المتقاطعة. GoRoute.ai ينفذ جميع القواعد كتحقق Schematron لاكتشاف الأخطاء قبل الإرسال.
نعم! عُمان الآن هيئة بيبول رسمية. يعني ذلك أن الشركات في عُمان يمكنها إرسال واستقبال فواتير إلكترونية متوافقة عبر شبكة بيبول إلى أكثر من ٤٠ دولة حول العالم. مواصفة فوترة مبنية على EN16931 و UBL 2.1 — نفس الأساس الذي يقوم عليه Peppol BIS 3.0. GoRoute.ai يوفر دعمًا كاملاً لمتطلبات فوترة المحلية والاتصال الدولي عبر بيبول من خلال منصة واحدة.
تتشابه فوترة عُمان وفاتورة ZATCA السعودية والإلزام القطري المرتقب في المفاهيم — إذ تتطلب جميعها توقيعات رقمية ورموز QR ومعرّفات فريدة. لكن المواصفات الفنية تختلف في التفاصيل (تعيينات الحقول وقوائم الرموز وقواعد التحقق). ويدعم GoRoute.ai هذه الأنظمة بوحدات CIUS خاصة بكل بلد، بحيث يمكنك إصدار الفواتير لكل منها بتكامل واحد.
GoRoute.ai يتحقق من الفواتير قبل إرسالها ويقدم رسائل خطأ تفصيلية مع القاعدة الدقيقة التي فشلت (مثال: BR-OM-01: مُعرّف UUID مفقود). يتضمن كل خطأ موقع XPath والقيمة المتوقعة لتتمكن من إصلاح المشكلة بسرعة. الأخطاء الحرجة تمنع الإرسال؛ التحذيرات للعلم فقط.
GoRoute.ai تديره شركة ClayDesk LLC، شركة تكنولوجيا أمريكية والكيان القانوني المسؤول عن منصة GoRoute.ai للفوترة الإلكترونية. وClayDesk مزوّد خدمة Peppol معتمد (POP000991) يخدم عُمان وأكثر من 40 دولة أخرى متصلة بشبكة Peppol من خلال بنية تحتية عالمية واحدة معتمدة من Peppol.
احجز عرضًا توضيحيًا مع فريقنا لترى كيف يبسّط GoRoute امتثالك للفوترة الإلكترونية.