إدارة مخزون eSIM

تشرح هذه الدليل كيفية تكوين مخزون eSIM لقنوات التوزيع المختلفة - الرقمية (عبر الإنترنت) مقابل المطبوعة (بطاقات فعلية).

انظر أيضًا: المخزون لإدارة المخزون العامة، توفير بطاقة SIM لعمليات التوفير وواجهة برمجة التطبيقات لمصدر eSIM.

نظرة عامة

يمكن توزيع eSIMs من خلال قناتين:

1. التوزيع الرقمي — يصدر على الفور عبر بوابة التسجيل الذاتي، يتم تسليمه عبر البريد الإلكتروني مع رمز QR
2. التوزيع المطبوع — مطبوعة مسبقًا على بطاقات كرتونية للتوزيع الفعلي أو البيع بالتجزئة

يحدد حقل item_location في جدول المخزون القناة المتاحة لـ eSIM.

تكوين قناة التوزيع

يحدد حقل item_location كيفية توزيع eSIM:

القيمة	الوصف	متاحة عبر
digital	متاحة للإصدار عبر الإنترنت / الفوري	بوابة التسجيل الذاتي، API
printed	محجوزة لتوزيع بطاقة فعلية	تعيين يدوي فقط
قيم أخرى	غير متاحة للإصدار التلقائي	تعيين يدوي فقط

إعداد eSIMs الرقمية

لجعل eSIMs متاحة للتوزيع عبر الإنترنت:

1. انتقل إلى المخزون في OmniCRM
2. حدد عناصر مخزون eSIM المخصصة للتوزيع الرقمي
3. اضبط item_location على digital
4. احفظ التغييرات

إعداد eSIMs المطبوعة

بالنسبة لـ eSIMs التي تم طباعتها على بطاقات فعلية:

1. انتقل إلى المخزون في OmniCRM
2. حدد عناصر مخزون eSIM المطبوعة
3. اضبط item_location على printed (أو أي قيمة غير digital)
4. احفظ التغييرات

كيفية عمل الإصدار الرقمي

عندما يطلب عميل eSIM عبر بوابة التسجيل الذاتي عبر POST /crm/oam/issue-esim:

1. تستعلم واجهة برمجة التطبيقات عن المخزون للحصول على eSIMs المتاحة
2. يتم اعتبار فقط eSIMs التي تتطابق مع جميع المعايير أدناه
3. يتم اختيار eSIM واحدة عشوائيًا من المجموعة المتاحة
4. يتم إرسال تفاصيل eSIM إلى العميل عبر البريد الإلكتروني

معايير اختيار المخزون

الحقل	الشرط	الغرض
item	يحتوي على "esim" (غير حساسة لحالة الأحرف)	يحدد عناصر مخزون eSIM
item_location	يساوي digital	يقيد إلى قناة التوزيع الرقمية
customer_id	فارغ	لم يتم تعيينه بعد لعميل
service_id	فارغ	لم يتم تعيينه بعد ل��دمة

للحصول على تفاصيل كاملة حول نقطة النهاية issue-esim بما في ذلك معلمات الطلب، وحدود المعدل، واستجابات الأخطاء، انظر توفير بطاقة SIM - واجهة برمجة التطبيقات العامة لمصدر eSIM.

معالجة الأخطاء

إذا لم تكن هناك eSIMs رقمية متاحة، ترجع واجهة برمجة التطبيقات:

حالة HTTP	نوع الخطأ	الرسالة
503	NoInventory	"لا توجد eSIMs متاحة حاليًا. يرجى المحاولة مرة أخرى لاحقًا أو اختيار SIM فعلية."

الحقول الرئيسية للمخزون لـ eSIMs

الحقل	النوع	الوصف
item	سلسلة	معرف نوع العنصر (يجب أن يحتوي على "esim" لعناصر eSIM)
item_location	سلسلة	قناة التوزيع: digital للإنترنت، قيم أخرى للموقع الفعلي
itemtext1	سلسلة	ICCID — المعرف الفريد لـ eSIM
management_url	سلسلة	سلسلة تفعيل LPA (مثل LPA:1$rsp-eu.simlessly.com$...)
customer_id	عدد صحيح	العميل المعين (فارغ إذا لم يتم تعيينه)
service_id	عدد صحيح	الخدمة المعينة (فارغ إذا لم يتم تعيينها)

للحصول على مرجع كامل لجميع حقول عناصر المخزون، انظر المخزون - حقول عناصر المخزون.

الاستيراد التلقائي من HSS

عند استيراد SIMs من HSS باستخدام نص التوفير، يتم تعيين حقلين تلقائيًا بناءً على سجل HSS:

قناة التوزيع (item_location):

• إذا كان اسم الدفعة يحتوي على "digital" (غير حساسة لحالة الأحرف)، يتم وضع علامة على eSIM كـ item_location = 'digital' للتوزيع عبر الإنترنت
• خلاف ذلك، يتم تعيين eSIM إلى الموقع الفعلي الافتراضي (مثل "جزيرة الصعود")

سلسلة تفعيل LPA (management_url):

• يتم استيراد حقل lpa من سجل SIM HSS تلقائيًا كـ management_url
• هذا يمكّن من توليد رمز QR في CRM لتفعيل eSIM
• إذا لم يكن لدى سجل HSS قيمة lpa، يتم استيراد eSIM بدون سلسلة تفعيل

هذا يعني أن بيانات قناة التوزيع وLPA يمكن التحكم فيها على مستوى HSS:

• قم بتسمية الدفعات بشكل مناسب (مثل "eSIMs الرقمية Q1 2026"، "دفعة بطاقات مطبوعة 3")
• تأكد من أن eSIMs تحتوي على حقل lpa ممتلئ في HSS قبل الاستيراد

أفضل الممارسات

فصل المخزون

• احتفظ بمجموعات eSIM الرقمية والمطبوعة منفصلة باستخدام item_location
• راقب مستويات المجموعة الرقمية لضمان توفرها للعملاء الذين يس��لون أنفسهم
• اعتبر إعداد تنبيهات عندما ينخفض مخزون eSIM الرقمي

تحديثات الدفعات اليدوية

عند استيراد أو تحديث eSIMs يدويًا:

1. eSIMs الرقمية: اضبط item_location = 'digital' أثناء الاستيراد
2. eSIMs المطبوعة: اضبط item_location = 'printed' أو الموقع الفعلي (مثل "مكتب جورج تاون")

التحويل بين القنوات

لنقل eSIMs بين القنوات:

• من المطبوعة إلى الرقمية: تحديث item_location من printed إلى digital
• من الرقمية إلى المطبوعة: تحديث item_location من digital إلى printed (فقط إذا لم يتم إصدارها بعد)

استكشاف الأخطاء وإصلاحها

لا توجد eSIMs متاحة للإصدار عبر الإنترنت

الأعراض: يرى العملاء "لا توجد eSIMs متاحة حاليًا" عند طلب eSIM عبر الإنترنت.

الأسباب المحتملة:

• لا توجد eSIMs تم تعيين item_location لها كـ digital
• جميع eSIMs الرقمية قد تم تعيينها بالفعل (كلا من customer_id و service_id غير فارغين)
• عناصر eSIM لا ت��توي على "esim" في اسم العنصر

الحل:

1. تحقق من المخزون عن eSIMs مع item_location = 'digital'
2. تحقق من وجود eSIMs غير المعينة (كلا من customer_id و service_id فارغين)
3. أضف المزيد من eSIMs إلى المجموعة الرقمية أو قم بتحويل المطبوعة إذا كانت متاحة

إصدار eSIMs المطبوعة عبر الإنترنت

الأعراض: يتم إصدار eSIMs المخصصة للبطاقات الفعلية عبر البوابة.

الأسباب المحتملة:

• لم يتم تعيين item_location بشكل صحيح على eSIMs المطبوعة

الحل:

1. تحديث جميع eSIMs المطبوعة لتكون item_location = 'printed'
2. تأكد من أن الاستيرادات الجديدة لـ eSIMs المطبوعة تعين القيمة الصحيحة لـ item_location