كيف تعمل تاكس لاين، خطوة بخطوة

خدمة واحدة تغطي مسار الفاتورة كاملًا في عُمان: من النظام الذي يصدرها، إلى المشتري، إلى جهاز الضرائب، ثم إلى الأرشيف.

إرسال الفواتير

يرسل نظامك إلى تاكس لاين بيانات كل فاتورة، فتحوّلها تاكس لاين إلى مستند بصيغة PINT OM، وهي الصيغة الإلكترونية المعتمدة في عُمان على شبكة Peppol، ثم تفحصه على مرحلتين:

  • فحص أولي يكشف الأخطاء الشائعة فورًا، مثل غياب الرقم الضريبي للمشتري، أو إشعار دائن لا يذكر الفاتورة التي يصححها.
  • التحقق الرسمي الذي يطبّق مجموعات القواعد العُمانية المنشورة كاملةً. ولا يُرسل أي مستند لم يجتز هذا التحقق.

بعد ذلك تُسلَّم الفاتورة الصحيحة عبر شبكة Peppol. تبحث تاكس لاين عن المشتري في السجل المركزي لشبكة Peppol لدى جهاز الضرائب (SMP)، وتحدد مزوّد خدمته، وتسلّمه المستند عبر بروتوكول AS4، وهو وسيلة النقل الآمنة في شبكة Peppol، موقّعًا ومشفّرًا. يؤكد المزوّد المستلِم الاستلام، ثم يُبلغ بقبول الفاتورة أو رفضها، ويُسجَّل الردّان مع الفاتورة.

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

استلام الفواتير

تصل الفواتير الموجهة إليك عبر الشبكة نفسها. تستلمها تاكس لاين نيابةً عنك، وتتحقق منها، وترسل إلى المرسِل رسالة حالة عن كل مستند، مقبولًا كان أو مرفوضًا، كما تشترط القواعد العُمانية، ثم تعرضها في لوحتك إلى جانب الفواتير التي ترسلها.

وبصفتنا مزوّد خدمتك، نسجّل منشأتك على شبكة Peppol بعد أن تختار تاكس لاين على بوابة «فوترة» التابعة لجهاز الضرائب، لتتمكن المنشآت الأخرى من الوصول إليك.

الإبلاغ الضريبي

يُبلَّغ جهاز الضرائب عن كل فاتورة تُتبادل في عُمان بتقرير ضريبي يُرسل عبر اتصال Peppol الآمن نفسه. وترسله تاكس لاين بصفتيها: مزوّدًا للبائع في الفواتير التي تصدرها، ومزوّدًا للمشتري في الفواتير التي تستلمها.

التقريرالمهلةتُحسب من
البيع إلى منشأة أو جهة حكومية (جهة البائع)15 دقيقةاجتياز الفاتورة للتحقق
البيع إلى مستهلك (جهة البائع)30 دقيقةاجتياز الفاتورة للتحقق
فاتورة مستلمة من مورّد (جهة المشتري)15 دقيقةاستلام الفاتورة

المصدر: المتطلبات الخاصة بسلطة Peppol في عُمان، الإصدار 1.0، الملحق (أ).

تضع تاكس لاين كل تقرير في قائمة انتظار مرتبطة بمهلته، وتنبّه قبل بلوغ المهلة لا بعدها، وتسجّل رد جهاز الضرائب. وإن رُفض تقرير، يظهر سبب الرفض وما ينبغي فعله.

ربط نظامك

تقرأ تاكس لاين الفواتير بالصيغة التي ينتجها نظامك اليوم، فلا يحتاج أحد إلى كتابة PINT OM يدويًا. وتتوفر ثلاث طرق للربط، تعتمد كلها على الربط المحفوظ نفسه والفحوص نفسها:

  1. الواجهة البرمجية. يرسل نظامك كل فاتورة إلى تاكس لاين لحظة إصدارها، بصيغة JSON الخاصة به أو بصيغة تاكس لاين. وهي الطريقة المناسبة للمبيعات الفورية ونقاط البيع.
  2. رفع الملفات. ارفع ملف تصدير بصيغة CSV أو JSON، أو دع نظامك يضعه تلقائيًا. لا تحتاج هذه الطريقة إلى تثبيت أي شيء، وهي أسرع طريقة للبدء.
  3. الموصلات المباشرة. ستقرأ تاكس لاين الفواتير الجديدة مباشرة من أنظمة مختارة. ونُعدّ هذه الموصلات نظامًا تلو الآخر، ولا نطرح أيًّا منها إلا بعد اختباره على الإصدار الحالي من النظام.
النظامطريقة الربط حاليًا
Odooالواجهة البرمجية أو رفع ملف التصدير
SAP Business One، SAP S/4HANAالواجهة البرمجية أو رفع ملف التصدير
Microsoft Dynamics 365 (Business Central، Finance)الواجهة البرمجية أو رفع ملف التصدير
QuickBooks، Zoho Booksالواجهة البرمجية أو رفع ملف التصدير
جداول البيانات (CSV، أو Excel محفوظًا بصيغة CSV)رفع الملفات
البرامج الخاصة بمنشأتكالواجهة البرمجية

لإعداد الربط، تزوّد تاكس لاين بملف تصدير نموذجي واحد. تقترح تاكس لاين الحقل الذي يحمل كل جزء من الفاتورة، سواء كانت أسماء الحقول بالعربية أو الإنجليزية، وتعرض معاينة لكل فاتورة في الملف مع تمييز أي مشكلة. تصحّح ما يلزم ثم تحفظ. وكل تعديل يُنشئ إصدارًا جديدًا، وتحتفظ كل فاتورة بالإصدار الذي قرأها.

ولا تخمّن تاكس لاين ما لا يذكره ملف التصدير. فإن احتمل تاريخ مثل 03/04/2026 أن يكون الثالث من أبريل أو الرابع من مارس، أو غابت العملة أو نسبة الضريبة، يُطلب منك تأكيده.

الأخطاء بلغة واضحة

يعرض التحقق الرسمي الأخطاء في صورة رموز قواعد. وتترجم تاكس لاين كل رمز إلى جملة بالعربية والإنجليزية تبيّن الخطأ، والحقل الذي وقع فيه، وطريقة تصحيحه، مثل: «الرقم الضريبي للمشتري غير موجود». فيستطيع فريق المالية التصحيح وإعادة الإرسال دون الرجوع إلى قسم تقنية المعلومات.

الأرشيف

يوجب قانون ضريبة القيمة المضافة (المرسوم السلطاني رقم 121/2020، المادة 70) حفظ الفواتير الضريبية مدة عشر سنوات بعد نهاية السنة الضريبية التي قُدّم فيها الإقرار، وخمس عشرة سنة لما يتعلق منها بالعقارات. وتحفظ تاكس لاين لكل مستند:

  • ما أرسلته إلينا كما استُلم تمامًا؛
  • فاتورة PINT OM كما أُنشئت، والغلاف كما أُرسل أو استُلم؛
  • إشعار التسليم وكل رسائل الحالة؛
  • التقرير الضريبي ورد جهاز الضرائب عليه؛
  • نتيجة التحقق وإصدار القواعد المستخدم.

وتُحفظ المستندات افتراضيًا خمس عشرة سنة بعد سنة إصدارها، لأن الفاتورة وحدها لا تبيّن إن كانت تتعلق بعقار. ويمكن البحث في المستندات برقم الفاتورة أو المعرّف أو التاريخ أو الطرف التجاري، وتنزيلها مع ما يثبت أنها لم تُعدَّل. وتجد طريقة حماية الأرشيف في صفحة الأمان.

للمطوّرين

  • واجهة برمجية REST بمفاتيح وصول ينشئها مالك الحساب ويلغيها.
  • إشعارات Webhook بكل نتيجة: رُفض مع الأسباب، سُلّم، قبله المشتري أو رفضه، قبله جهاز الضرائب أو رفضه.
  • مفاتيح منع التكرار: الفاتورة المرسلة مرتين بالمفتاح نفسه تصدر مرة واحدة.
  • أخطاء تسمّي حقلك أنت لا حقلنا، ليصحّح مطوّرك الموضع الصحيح.
  • بيئة اختبار منفصلة، مميّزة بوضوح في كل شاشة، كي لا يصل أي اختبار إلى بيئة التشغيل الفعلية.

نشارك الوثائق التقنية مع العملاء خلال مرحلة التهيئة. اطلبها منا.

هل تريد أن ترى كيف ستُقرأ فواتيرك؟

أرسل إلينا ملف تصدير نموذجيًا من نظامك بعد حذف بيانات العملاء الحقيقية.

تواصل معنا