شرح مفتاح الوصول SRI clave de acceso: الأرقام الـ 49، ورقم التحقق módulo 11، وأسباب الرفض الشائعة (الإكوادور)

بقلم زين عباس, كودينوفا · آخر تحديث 16 أكتوبر 2026

الإجابة المختصرةمفتاح الوصول SRI clave de acceso رقم من 49 خانة يعرّف كل مستند إلكتروني (comprobante) في الإكوادور. يجمع تاريخ الإصدار، ونوع المستند، ورقم RUC للمُصدِر، والبيئة، والسلسلة (serie)، والرقم المتسلسل (secuencial)، ورمزًا رقميًا من 8 خانات (código numérico)، ونوع الإصدار (tipo de emisión)، ثم يضيف رقم تحقق بطريقة módulo 11. وفي النظام غير المتصل (offline) يصبح أيضًا رقم الاعتماد، لذلك يعني رقم واحد خاطئ أن المستند لا يمكن اعتماده.

يحمل كل مستند إلكتروني (comprobante) في الإكوادور مفتاح وصول (clave de acceso): رقمًا من 49 خانة يبنيه المُصدِر، لا SRI. إذا كان خاطئًا، يُرفض المستند أو لا يمكن العثور عليه عند الاستعلام عن اعتماده. يشرح هذا الدليل كل رقم، ورقم التحقق módulo 11، وأسباب الرفض التي نراها أكثر من غيرها في مشاريع SAP Business One.

يمكنك بناء مفتاح أو التحقق منه في أداة إنشاء مفتاح الوصول SRI clave de acceso والتحقق منه المجانية أثناء القراءة.

الأرقام الـ 49، حقلًا حقلًا

يأتي الهيكل من Ficha técnica de comprobantes electrónicos, esquema offline (الفيشة التقنية للمستندات الإلكترونية، النظام غير المتصل) الصادرة عن SRI (الإصدار 2.26، مارس 2024). يوضع المفتاح في الوسم <claveAcceso> في ملف XML.

الموضع	الحقل	الطول	ملاحظات
1–8	Fecha de emisión (تاريخ الإصدار)	8	بصيغة ddmmaaaa
9–10	Tipo de comprobante (نوع المستند)	2	انظر الجدول أدناه
11–23	RUC del emisor	13	رقم RUC للمُصدِر
24	Tipo de ambiente (البيئة)	1	1 = pruebas (اختبار)، 2 = producción (إنتاج)
25–30	Serie (السلسلة)	6	المنشأة (3) + نقطة الإصدار (3)، مثل 001001
31–39	Secuencial (الرقم المتسلسل)	9	مُكمّل بأصفار من اليسار
40–47	Código numérico (الرمز الرقمي)	8	يختاره المُصدِر
48	Tipo de emisión (نوع الإصدار)	1	1 = emisión normal (إصدار عادي)
49	Dígito verificador (رقم التحقق)	1	Módulo 11

رموز نوع المستند (Tipo de comprobante)

الرمز	المستند
01	Factura (فاتورة)
03	Liquidación de compra de bienes y prestación de servicios (تسوية شراء سلع وتقديم خدمات)
04	Nota de crédito (إشعار دائن)
05	Nota de débito (إشعار مدين)
06	Guía de remisión (إذن تسليم)
07	Comprobante de retención (مستند استقطاع)

بعض التفاصيل أهم مما تبدو:

السلسلة (Serie). تعرض الفيشة السلسلة كحقل واحد من 6 أرقام. أما ملف XML فيحمل المنشأة ونقطة الإصدار كرمزين منفصلين من 3 أرقام لكل منهما، لذلك يجب أن يطابقا المفتاح.
الرقم المتسلسل (Secuencial). يجب أن يكون 9 أرقام. الرقم المتسلسل القصير ينتج مفتاحًا مشوهًا ورفضًا.
الرمز الرقمي (Código numérico). تسمّيه SRI آلية أمان وتترك الخوارزمية بالكامل للمُصدِر. عشوائيًا كان أو مشتقًا، القرار لك، لكن يجب أن يكون 8 أرقام.
نوع الإصدار (Tipo de emisión). في النظام غير المتصل لا توجد إلا القيمة 1. أُزيلت مفاتيح الطوارئ في الإصدار 2.0 من الفيشة.

رقم التحقق módulo 11

يُحسب الرقم التاسع والأربعون على أول 48 رقمًا بطريقة módulo 11 وأوزان من 2 إلى 7.

خذ الأرقام الـ 48.
بدءًا من اليمين، اضرب كل رقم في 2، 3، 4، 5، 6، 7، ثم ابدأ مجددًا من 2.
اجمع كل حواصل الضرب.
اقسم المجموع على 11 واحتفظ بالباقي.
اطرح الباقي من 11.
إذا كانت النتيجة 11 فالرقم 0. وإذا كانت 10 فالرقم 1. وإلا فاستخدم النتيجة.

مثال مصغر محلول

تستخدم فيشة SRI السلسلة 41261533:

الرقم	4	1	2	6	1	5	3	3
الوزن	3	2	7	6	5	4	3	2
حاصل الضرب	12	2	14	36	5	20	9	6

المجموع = 104. باقي قسمة 104 على 11 = 5. ‏11 − 5 = 6. رقم التحقق هو 6.

مفتاح كامل

لنأخذ فاتورة (01) صادرة في 16 أكتوبر 2026 في بيئة الإنتاج (2)، من المنشأة 001، ونقطة الإصدار 001، والرقم المتسلسل 123، والرمز الرقمي 12345678، لرقم RUC وهمي 1790012345001:

16102026 01 1790012345001 2 001001 000000123 12345678 1

مجموع الأرقام الـ 48 بعد الضرب في الأوزان هو 468. باقي قسمة 468 على 11 = 6، و 11 − 6 = 5. مفتاح الوصول الكامل هو:

1610202601179001234500120010010000001231234567815

الصقه في أداة مفتاح الوصول لترى كل حقل مفصولًا.

كيف يستخدم النظام غير المتصل المفتاح

في النظام غير المتصل (esquema offline) يقوم المُصدِر بمعظم العمل:

أنشئ ملف XML وفق مخطط XSD الخاص بـ SRI لنوع المستند.
أنشئ مفتاح الوصول المكوّن من 49 رقمًا.
وقّع ملف XML بتوقيع XAdES-BES، باستخدام شهادة ‎.p12 الخاصة بتوقيعك الإلكتروني (firma electrónica).
أرسله إلى خدمة الويب recepción (الاستلام). يكون الرد RECIBIDA (مستلم) أو DEVUELTA (مُعاد).
انتظر، ثم استعلم من خدمة الويب autorización (الاعتماد) باستخدام مفتاح الوصول.
سلّم المستند (XML و RIDE) إلى المشتري.

نقطتان تأتيان مباشرة من الفيشة. أولًا، يصبح مفتاح الوصول رقم الاعتماد (número de autorización). ثانيًا، تذكر SRI أن معالجة المستند قد تستغرق حتى 24 ساعة، لذلك يجب أن يتعامل نظامك مع حالة «معلّق» بدل افتراض رد فوري.

لبيئة الاختبار (celcer.sri.gob.ec) وبيئة الإنتاج (cel.sri.gob.ec) نقاط اتصال منفصلة. ويجب أن يطابق رقم البيئة في المفتاح البيئة التي ترسل إليها.

أسباب الرفض الشائعة

هذه هي رسائل SRI والحالات التي نصادفها أكثر من غيرها. الرموز مأخوذة من القسم 10 من الفيشة التقنية.

المشكلة	رسالة SRI	السبب المعتاد
مفتاح مكرر	43 “Clave acceso registrada”	إرسال المفتاح نفسه مرتين، غالبًا بعد انتهاء المهلة وإعادة إرسال يدوية من مستند ثانٍ
رقم متسلسل مكرر	45 “Secuencial registrado”	مستندان في SAP B1 مربوطان بالسلسلة والرقم المتسلسل نفسيهما
المفتاح لا يطابق XML	58 “Error en la estructura de clave acceso”	التاريخ أو RUC أو السلسلة أو الرقم المتسلسل في المفتاح تختلف عن XML
المفتاح ما زال قيد المعالجة	70 “Clave de acceso en procesamiento”	إعادة إرسال بينما SRI ما زالت تعالج. لا تُنشئ مفتاحًا أو رقمًا متسلسلًا جديدًا؛ انتظر حتى 24 ساعة
التوقيع الإلكتروني	39 “Firma inválida”، 40 “Error en el certificado”، 42 “Certificado revocado”	ملف ‎.p12 خاطئ، أو كلمة مرور خاطئة، أو شهادة تجاوزت تاريخ انتهائها ولم تُجدَّد
مستند متأخر	65 “Fecha de emisión extemporánea”	مستندات احتُجزت في قائمة انتظار وأُرسلت متأخرة جدًا
هوية المشتري	تحذيرات 59 “Identificación no existe”، 62 “Identificación incorrecta”	رقم cédula أو RUC برقم تحقق خاطئ، أو نوع هوية (tipo de identificación) خاطئ

ملاحظات حول الحالات التي تستهلك أكبر قدر من الوقت:

المفتاح المكرر. تأتي معظم حالات التكرار من منطق إعادة المحاولة، لا من المعادلة. بعد انتهاء المهلة، استعلم أولًا من خدمة الاعتماد بالمفتاح نفسه.
RUC أو cédula المشتري. رموز نوع الهوية هي 04 RUC، و05 cédula، و06 جواز سفر، و07 المستهلك النهائي (13 تسعة)، و08 هوية أجنبية. لا يُسمح بالمستهلك النهائي في تسويات الشراء (liquidaciones de compra)، والإشعارات الدائنة والمدينة ومستندات الاستقطاع تحتاج دائمًا إلى مستلِم صالح. تحقق من الأرقام قبل وصولها إلى SAP B1 باستخدام أداة التحقق من cédula و RUC في الإكوادور.
فجوات الأرقام المتسلسلة. تطلب الفيشة من المُصدِرين الإصدار بترتيب زمني ومتسلسل، دون أرقام متسلسلة أو مفاتيح مكررة. تظهر الفجوات عادةً عندما يُلغى مستند في SAP B1 بعد أخذ الرقم، أو عندما يرحّل مستخدمان في الوقت نفسه. يصعب تفسيرها لاحقًا، لذلك احتفظ بالعدّاد في مكان واحد.
انتهاء صلاحية التوقيع الإلكتروني. تنتهي الشهادات في تاريخ محدد. ضع هذا التاريخ في التقويم وجدّد قبله، لأن كل المستندات تفشل حتى تُحمَّل شهادة ‎.p12 الجديدة.

كيف يُنشئ SAP Business One مفتاح الوصول

لا يحتوي SAP B1 في معظم الإعدادات على حقل باسم مفتاح الوصول جاهزًا. التكامل هو من يبنيه. في مشاريع SRI لدينا يكون النمط كالتالي:

اربط سلاسل الترقيم بالسلسلة (serie). تُربط كل سلسلة مستندات في SAP B1 بمنشأة واحدة ونقطة إصدار واحدة.
احتفظ برقم متسلسل منفصل. لا نعتمد على DocNum وحده. عدّاد مخصص لكل سلسلة ونوع مستند يتجنب التصادم بين المستخدمين والشركات.
ابنِ المفتاح وقت الترحيل. التاريخ من تاريخ المستند، و RUC من بيانات الشركة، والبيئة من إعداد يختلف بين قاعدتي بيانات الاختبار والإنتاج.
احفظه على المستند. يُحفظ المفتاح والحالة وتاريخ الاعتماد في حقول معرّفة من قِبل المستخدم على فاتورة المبيعات، أو الإشعار الدائن، أو مذكرة التسليم، أو فاتورة المشتريات التي تحمل استقطاعًا (retención)، ليراها المستخدمون دون مغادرة SAP B1.
اطبعه على RIDE. يعرض تصميم Crystal Reports مفتاح الوصول والباركود الخاص به.
تعامل مع حالتي التعليق والرفض. تسرد شاشة مراقبة المستندات في حالة RECIBIDA أو DEVUELTA أو غير المعتمدة، مع رسالة SRI، ليصلحها أحدهم في اليوم نفسه.

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

نفّذت كودينوفا تكاملات SRI لـ SAP Business One. إذا كانت مستنداتك تُرفض أو كنت تبدأ تطبيقًا جديدًا، تواصل معنا مع ذكر إصدار SAP B1 لديك وأنواع المستندات التي تُصدرها.

المصادر

خدمات ذات صلة

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

أسئلة شائعة

كم عدد أرقام مفتاح الوصول SRI clave de acceso؟

49. ثمانية وأربعون رقمًا تأتي من بيانات المستند (التاريخ، و tipo de comprobante، و RUC، و ambiente، و serie، و secuencial، و código numérico، و tipo de emisión)، والرقم الأخير هو رقم التحقق (dígito verificador) بطريقة módulo 11.

كيف يُحسب رقم التحقق (dígito verificador)؟

اضرب أول 48 رقمًا من اليمين إلى اليسار في الأوزان 2، 3، 4، 5، 6، 7، مع التكرار. اجمع حواصل الضرب، وخذ باقي القسمة على 11 واطرحه من 11. النتيجة 11 تصبح 0، والنتيجة 10 تصبح 1.

هل مفتاح الوصول هو نفسه رقم الاعتماد (número de autorización)؟

نعم، في النظام غير المتصل. تذكر الفيشة التقنية (ficha técnica) لـ SRI أن مفتاح الوصول الذي يُنشئه المُصدِر يصبح رقم اعتماد المستند.

هل يمكنني إعادة إرسال مستند مرفوض بمفتاح وصول جديد؟

إذا رفضت SRI مستندًا، تنص الفيشة التقنية على تصحيحه وإعادة إرساله بمفتاح الوصول نفسه والرقم المتسلسل نفسه. وإذا ظهر الخطأ 70 (clave de acceso en procesamiento، أي المفتاح قيد المعالجة)، فلا تُعد الإرسال ولا تُنشئ مفتاحًا جديدًا؛ انتظر الرد، وقد يستغرق حتى 24 ساعة.

هل يوجد مفتاح طوارئ في النظام غير المتصل؟

لا. أُزيلت مفاتيح الطوارئ في الإصدار 2.0 من الفيشة التقنية للنظام غير المتصل، ولا يوجد إلا نوع الإصدار 1 (emisión normal، أي الإصدار العادي).

جاهز للبدء؟

أخبرنا بما تحتاجه. ستحصل على إجابة تقنية واضحة ونطاق عمل محدد وسعر ثابت، عادةً خلال 24 ساعة.

ابدأ مشروعك تواصل عبر واتساب