رمز الخطأ 1004: تسلسل عدّاد الفاتورة ICV غير صحيح

عند إرسال فاتورتك الإلكترونية إلى منصة فاتورة التابعة لهيئة الزكاة والضريبة والجمارك، قد يردّ النظام برسالة رفض تحمل الرمز 1004 مع وصف يشير إلى أن تسلسل عدّاد الفاتورة (ICV) غير صحيح. هذا الرمز لا يعني أن نظامك المحاسبي تعطّل، بل يعني أن الرقم التسلسلي الذي رافق فاتورتك لم يأتِ في موضعه المتوقّع. عدّاد الفاتورة يجب أن يزيد بمقدار واحد فقط مع كل فاتورة على الجهاز نفسه. أي قفزة في الرقم، أو تكرار لرقم سابق، أو رجوع إلى رقم أصغر، يكسر التسلسل وتردّ المنصة الفاتورة.

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

ما معنى «تسلسل عدّاد الفاتورة ICV غير صحيح»؟

عدّاد الفاتورة، ويُعرف اختصارًا بـ ICV من العبارة الإنجليزية Invoice Counter Value، هو رقم تسلسلي يبدأ من 1 ويزيد بمقدار واحد مع كل فاتورة جديدة يُصدرها الجهاز أو وحدة الإصدار. الفاتورة الأولى تحمل العدّاد 1، والثانية 2، والثالثة 3، وهكذا دون انقطاع. هذا الرقم يُدرَج داخل ملف الفاتورة ويُدخَل في حساب التوقيع الرقمي، فتتحقق منصة فاتورة من تسلسله قبل اعتماد الفاتورة.

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

من المهم التمييز هنا: العدّاد ICV يختلف عن المعرّف الفريد UUID. العدّاد رقم تسلسلي متتابع تحدده وحدة الإصدار محليًا، بينما المعرّف الفريد سلسلة فريدة لا تتكرر لكل فاتورة. كلاهما حقل إلزامي، لكن العدّاد وحده هو الذي يخضع لقاعدة التتابع بمقدار واحد. تركيزنا في هذه الصفحة على عدّاد الفاتورة ICV فقط.

لماذا ربطت الهيئة العدّاد بسلسلة الفواتير

قاعدة التتابع ليست تعقيدًا تقنيًا بلا هدف. الغرض منها ضمان عدم وجود فواتير محذوفة أو مخفية أو مُدرَجة لاحقًا خارج التسلسل. عندما يزيد العدّاد بمقدار واحد دائمًا، يصبح من السهل التأكد أن سلسلة الفواتير كاملة ولم تُحذف منها فاتورة في المنتصف. فلو قفز العدّاد من 50 إلى 52، فهذا يثير سؤالًا مشروعًا: أين الفاتورة رقم 51؟

لهذا يرتبط العدّاد بآلية أخرى هي تجزئة الفاتورة السابقة (PIH)، حيث يحمل كل توقيع بصمة الفاتورة التي قبلها. العدّاد والتجزئة معًا يصنعان سلسلة مترابطة لا يمكن العبث بترتيبها. للتعمّق في الترابط بين الحقول، راجع دليل أخطاء التجزئة (Hash).

كيف يتسلسل العدّاد بشكل صحيح

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

• العدّاد يبدأ من 1 لأول فاتورة على الجهاز.
• كل فاتورة لاحقة تأخذ العدّاد السابق + 1.
• العدّاد لا يتكرر أبدًا لفاتورتين على الجهاز نفسه.
• العدّاد لا يقفز فوق رقم ولا يرجع إلى رقم أصغر.
• كل جهاز أو وحدة إصدار يحتفظ بعدّاده الخاص المستقل عن بقية الأجهزة.

النقطة الأخيرة جوهرية. لو كان لديك ثلاثة فروع لكل فرع جهاز إصدار، فلكل جهاز عدّاده الخاص الذي يبدأ من 1 ويتتابع بمعزل عن الفرعين الآخرين. خلط العدّادات بين الأجهزة، أو محاولة جعلها متسلسلة عبر كل المنشأة، هو أحد أكثر أسباب الرمز 1004 شيوعًا.

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

ومن المفيد أن تعرف أن العدّاد قيمة محلية تديرها وحدة الإصدار على جهازك، وليست قيمة تمنحها لك المنصة. أي أن مسؤولية تتابعه السليم تقع على النظام الذي يصدر الفاتورة، والمنصة تكتفي بالتحقق منه ورفض ما يكسر القاعدة. لهذا فإن اختيار نظام يضبط العدّاد آليًا هو خط الدفاع الأول ضد هذا الخطأ.

تتابع العدّاد بصريًا

الأخطاء الشائعة في تتابع العدّاد

أغلب حالات الرمز 1004 لا تنشأ من عطل في النظام، بل من تصرّف أربك تتابع العدّاد. أبرز هذه الأخطاء:

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

لماذا ترفض الهيئة الفاتورة بهذا الرمز؟

الرفض بالرمز 1004 يحدث لأحد ثلاثة أسباب رئيسية. تحديد السبب الذي يخصّ حالتك ضروري لأن الحل يختلف بينها:

السبب الأول: قفز في العدّاد

العدّاد تجاوز رقمًا، فجاءت قيمته أكبر من قيمة الفاتورة السابقة زائد واحد. مثال: الفاتورة السابقة حملت العدّاد 50، والفاتورة الجديدة حملت 52 بدل 51. تتوقّع المنصة الرقم 51 فترفض الرقم 52. غالبًا يحدث هذا عند حذف فاتورة كانت ستأخذ الرقم المفقود، أو عند خلل في توليد الأرقام.

السبب الثاني: تكرار العدّاد

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

السبب الثالث: رجوع العدّاد للخلف

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

مسارات كسر التسلسل

كيف تكتشف السبب الدقيق

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

1. اقرأ رسالة الرفض كاملة: الرمز 1004 يصاحبه وصف نصّي يذكر القيمة المتوقّعة والقيمة التي وصلت. قارن بينهما لتعرف إن كان العدّاد قفز أو تكرّر أو رجع.
2. راجع عدّاد آخر فاتورة معتمدة: اعرف الرقم الذي بلغته السلسلة فعليًا على هذا الجهاز، فهو المرجع الذي يجب أن تبني عليه الفاتورة التالية.
3. تحقق من عدد أجهزة الإصدار: إن كان لديك أكثر من جهاز أو فرع، تأكد أن كل جهاز يحتفظ بعدّاده المستقل ولم تُخلَط العدّادات.
4. راجع آخر عملية على النظام: هل استرجعت نسخة احتياطية؟ هل حذفت فاتورة؟ هل نسخت بيئة الإصدار إلى جهاز جديد؟ آخر تغيير غالبًا هو سبب الكسر.
5. تأكد من عدم وجود جلسات متوازية: أغلق أي نافذة أو جلسة إصدار مفتوحة على جهاز آخر تصدر فواتير في الوقت نفسه.

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

إذا أردت تشخيصًا في أقل من دقيقتين، ابدأ بسؤال واحد: هل حدث شيء غير معتاد قبل ظهور الخطأ؟ استرجاع نسخة، أو جهاز جديد، أو حذف فاتورة. هذه الأحداث الثلاثة تفسّر أغلب حالات الرمز 1004. أما إذا لم يحدث أي منها وظهر الخطأ فجأة، فافحص احتمال جلستين متوازيتين تصدران في الوقت نفسه.

الحل خطوة بخطوة

بعد تحديد المسار، طبّق الحل المناسب. نعرض هنا المسارات الثلاثة.

إذا كان العدّاد قد قفز

1. تحقق هل حُذفت فاتورة كانت ستأخذ الرقم المفقود. الفواتير المعتمدة لا تُحذف من السلسلة.
2. لا تحاول إدراج الرقم المفقود يدويًا، فالمنصة تتوقّع التتابع من آخر رقم سجّلته فعليًا.
3. أصدر الفاتورة التالية بحيث يكون عدّادها مساويًا لعدّاد آخر فاتورة معتمدة زائد واحد، وأرسلها إلى منصة فاتورة.

إذا كان العدّاد قد تكرّر

1. أوقف الإصدار من أي جهاز أو جلسة متوازية، وأبقِ مصدر إصدار واحدًا فعّالًا لكل جهاز.
2. تأكد أن كل جهاز يحتفظ بعدّاده المستقل، ولا تنسخ بيئة الإصدار من جهاز إلى آخر.
3. أصدر الفاتورة التالية بعدّاد لم يُستخدم من قبل على هذا الجهاز، وهو آخر عدّاد معتمد زائد واحد.

إذا كان العدّاد قد رجع للخلف

1. إن كنت قد استرجعت نسخة احتياطية قديمة، فأعد العدّاد إلى الرقم الذي بلغته السلسلة فعليًا قبل الاسترجاع، لا إلى رقم النسخة القديمة.
2. لا تُعِد ضبط العدّاد يدويًا إلى رقم أصغر، حتى في بداية فترة محاسبية جديدة، فالتتابع لا يُصفَّر بتغيّر السنة.
3. تابِع الإصدار من آخر رقم معتمد زائد واحد، وأرسل الفاتورة إلى المنصة.

في الغالبية العظمى من الحالات يُحَلّ الأمر بمتابعة الإصدار من آخر رقم معتمد زائد واحد، دون أي تدخّل يدوي في العدّاد نفسه.

مثال تطبيقي على حالة واقعية

لنأخذ حالة شائعة. منشأة كانت تصدر فواتيرها من جهاز رئيسي وبلغ عدّادها 240. واجهت عطلًا في الجهاز فاسترجعت نسخة احتياطية من اليوم السابق، وكان العدّاد فيها قد بلغ 228 فقط. تابعت الإصدار، فحملت أول فاتورة جديدة العدّاد 229. ردّت المنصة بالرمز 1004 لأن العدّاد رجع إلى رقم أصغر من 240 الذي سجّلته فعليًا.

عند التشخيص، راجع المحاسب آخر فاتورة معتمدة على المنصة فوجدها بالعدّاد 240. أدرك أن النسخة الاحتياطية أعادت العدّاد إلى الخلف. عدّل بدء الإصدار ليكون من 241، أي آخر رقم معتمد زائد واحد، ثم أصدر الفاتورة وأرسلها فاعتُمدت فورًا. الدرس هنا: بعد أي استرجاع نسخة احتياطية، طابِق العدّاد مع آخر فاتورة معتمدة فعليًا، لا مع رقم النسخة القديمة.

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

مثال على رسالة الخطأ

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

{
  "validationResults": {
    "status": "ERROR",
    "errorMessages": [
      {
        "type": "ERROR",
        "code": "1004",
        "category": "INVOICE_COUNTER_VALUE",
        "message": "Invalid ICV sequence: expected 51 but received 52.",
        "field": "Invoice/AdditionalDocumentReference[ID='ICV']/UUID"
      }
    ]
  }
}

اقرأ الحقول التالية لتشخيص سريع: قيمة code تساوي 1004، وcategory تشير إلى عدّاد الفاتورة، وmessage يذكر القيمة المتوقّعة 51 مقابل القيمة الواردة 52، فيؤكد أن المسار قفز في العدّاد. الحقل field يحدد موضع العدّاد داخل ملف الفاتورة.

عدّاد سليم مقابل عدّاد مرفوض

كيف تمنع تكرار الخطأ مستقبلًا

تصحيح الفاتورة الواحدة سهل، لكن المنع الدائم يوفّر عليك تكرار المشكلة مع كل دفعة فواتير. اتبع هذه الممارسات:

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

المنشآت التي تعتمد على نظام محاسبي يدير العدّاد وتسلسله آليًا نادرًا ما تواجه هذا الخطأ، لأن النظام يضبط الرقم قبل الإرسال إلى المنصة ولا يترك مجالًا للتدخّل اليدوي.

احتياطات إضافية عند نقل النظام أو الترقية

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

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

الفرق بين العدّاد ICV والمعرّف الفريد UUID

يخلط بعض المستخدمين بين عدّاد الفاتورة والمعرّف الفريد لأن كليهما حقل إلزامي يميّز الفاتورة، لكن الفرق بينهما جوهري:

• العدّاد ICV: رقم تسلسلي متتابع يبدأ من 1 ويزيد بمقدار واحد على مستوى الجهاز، وغرضه إثبات اكتمال سلسلة الفواتير. اختلاله يُنتج الرمز 1004.
• المعرّف الفريد UUID: سلسلة فريدة لا تتكرر تُولَّد لكل فاتورة، وغرضها تمييز الفاتورة عن غيرها دون أي علاقة بالتتابع. اختلاله يُنتج رمزًا مختلفًا.

القاعدة المبسّطة: العدّاد يجيب على سؤال «ما ترتيب هذه الفاتورة؟»، والمعرّف الفريد يجيب على سؤال «ما هويتها المنفردة؟». للتفصيل في المعرّف الفريد، راجع دليل أخطاء المعرّف الفريد UUID.

أين يقع هذا الخطأ ضمن أخطاء الفوترة

الرمز 1004 ليس الخطأ الوحيد الذي قد تواجهه. يصنّف ضمن أخطاء التحقق من البيانات، وهي مجموعة تفحص فيها المنصة سلامة محتوى الفاتورة قبل الاعتماد. لفهم الصورة الكاملة، راجع دليل أخطاء هيئة الزكاة والضريبة والجمارك في الفوترة، ودليل عدّاد الفاتورة ICV الذي يشرح آلية العدّاد بالتفصيل، إضافة إلى دليل أخطاء التحقق.

للتعرّف على كيفية إصدار فواتير متوافقة من الأساس، اطّلع على صفحة الفاتورة الإلكترونية من قيود.

لماذا لا يجوز تجاهل هذا الخطأ

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

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

الخلاصة العملية: حدّد آخر رقم معتمد فعليًا، وتابِع منه زائد واحد، واترك إدارة العدّاد للنظام دون تدخّل يدوي. بهذه الخطوات الثلاث تغلق باب الرمز 1004 نهائيًا.

الأسئلة الشائعة

ماذا يعني الرمز 1004 في الفوترة الإلكترونية؟

يعني أن تسلسل عدّاد الفاتورة (ICV) غير صحيح. العدّاد رقم تسلسلي يجب أن يزيد بمقدار واحد مع كل فاتورة على الجهاز نفسه. إذا قفز فوق رقم، أو تكرّر، أو رجع إلى رقم أصغر، تردّ المنصة بالرمز 1004 وترفض الفاتورة قبل اعتمادها.

كيف يجب أن يتسلسل عدّاد الفاتورة؟

العدّاد يبدأ من 1 لأول فاتورة على الجهاز، ثم يأخذ كل فاتورة لاحقة قيمة العدّاد السابق زائد واحد دون تكرار ولا قفز ولا رجوع. كل جهاز إصدار يحتفظ بعدّاده المستقل عن بقية الأجهزة.

ظهر الرمز 1004 بعد استرجاع نسخة احتياطية، ماذا أفعل؟

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

لديّ أكثر من فرع، كيف أتجنّب تكرار العدّاد؟

امنح كل فرع أو جهاز إصدار بيئة مستقلة بعدّاد خاص، ولا تنسخ إعداد الإصدار من جهاز إلى آخر. تكرار العدّاد بين فرعين هو أحد أكثر أسباب الرمز 1004 شيوعًا في المنشآت متعددة الفروع.

هل العدّاد ICV هو نفسه المعرّف الفريد UUID؟

لا. العدّاد رقم تسلسلي متتابع يثبت ترتيب الفاتورة ضمن السلسلة، بينما المعرّف الفريد سلسلة فريدة لا تتكرر تميّز الفاتورة عن غيرها. العدّاد وحده هو الخاضع لقاعدة الزيادة بمقدار واحد.

هل يحلّ قيود هذا الخطأ تلقائيًا؟

يدير قيود عدّاد الفاتورة وتسلسله آليًا لكل جهاز إصدار، ويوقّع كل فاتورة بشهادة معرّف ختم الامتثال (CSID) معتمدة من الهيئة، فيقلّل احتمال وقوع هذا الخطأ من الأساس. مع ذلك يبقى تجنّب التدخّل اليدوي في العدّاد، وحذف الفواتير المعتمدة، مسؤولية المستخدم.