ICV (عدّاد الفاتورة)

من فريق ماثل، مبني على مواصفات الهيئة و SDK 3.4.8 · آخر تحديث

ICV هو عدّاد متسلسل يختم به كل جهاز (EGS) كل فاتورة وإشعار يصدره، يبدأ من 1 ويزيد واحد مع كل مستند، وتتحقق منه القاعدة BR-KSA-33.

ICV اختصار Invoice Counter Value، يعني عدّاد الفاتورة. كل جهاز فوترة (EGS) له عدّاد خاص فيه، يبدأ من 1 ويزيد واحد مع كل مستند يصدره: فاتورة أو إشعار دائن أو إشعار مدين، بدون قفزات. العدّاد مع هاش الفاتورة السابقة (PIH) هم اللي يربطون فواتير الجهاز في سلسلة وحدة.

مكانه في الـ XML (الحقل KSA-16): عنصر cac:AdditionalDocumentReference قيمة cbc:ID فيه ICV، والرقم نفسه داخل cbc:UUID. انتبه: هذا غير رقم الفاتورة (cbc:ID في رأس المستند) وغير الـ UUID حق الفاتورة.

وش يغلط في الواقع؟ إذا غاب العنصر أو كان فاضي تطلع BR-KSA-33 وهي خطأ يرفض الفاتورة. وإذا حطيت فيه حروف مثل INV-10 تطلع BR-KSA-34، لأن العدّاد أرقام بس. وكثير من المصادر تنسب العدّاد لـ BR-KSA-16، والصحيح إن BR-KSA-16 قاعدة رمز وسيلة الدفع.

القاعدة الذهبية: لا تزيد العدّاد إلا بعد ما ترجع الفاتورة مقبولة (cleared أو reported). الفاتورة المرفوضة ما تستهلك رقم: صلّحها وأرسلها بنفس العدّاد.

في ماثل، الـ device_token يحمل آخر عدّاد للجهاز، فماثل يحط الرقم اللي بعده بنفسه ويرفض أي عدّاد ما يطابق، ويرد 409 device_token_reused لو جهازين استخدموا نفس التوكن.

مثال

<cac:AdditionalDocumentReference>
    <cbc:ID>ICV</cbc:ID>
    <cbc:UUID>10</cbc:UUID>
</cac:AdditionalDocumentReference>

أسئلة شائعة

هل ICV هو نفسه رقم الفاتورة؟

لا. رقم الفاتورة (cbc:ID) تختاره أنت ويقبل حروف مثل INV-1001، أما ICV فعدّاد أرقام بس يحطه الجهاز في cbc:UUID داخل مرجع ICV.

وش يصير للعدّاد إذا الهيئة رفضت الفاتورة؟

ولا شي. المرفوضة ما تاخذ رقم: صلّحها وأرسلها بنفس العدّاد، وزِد العدّاد بعد القبول بس.

هل الإشعار الدائن ياخذ رقم عدّاد خاص فيه؟

إيه. الإشعارات الدائنة والمدينة مستندات في نفس سلسلة الجهاز، وكل واحد منها ياخذ الرقم اللي بعده.

قواعد الهيئة المرتبطة

مصطلحات قريبة

خلّ ماثل يتعامل مع هذا عنك

ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.

جرّب ماثل بدون تسجيل توثيق ماثل API