> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# رمز QR من نوع GS1

> إنشاء رمز QR متوافق مع معيار GS1 للتجزئة وسلسلة التوريد.

## الغرض منه

يُرمّز رمز QR من نوع GS1 رابطًا رقميًا [GS1 Digital Link](https://ref.gs1.org/standards/digital-link/) — وهو عنوان URI مبني من معرّفات تطبيق GS1 (Application Identifiers، أو AIs) يحدّد منتجًا أو موقعًا أو شحنة أو أي كائن آخر في سلسلة التوريد. في التطبيق، تُوصف الفئة بأنها "GS1 Application Identifier codes for products, locations & logistics."

على عكس أنواع Quick Code الأخرى في هذه الصفحة، لا تُمثَّل GS1 بنموذج ذي شاشة واحدة: بل هي معالج مخصص من 5 خطوات على المسار `/qr/quick/gs1`، منفصل عن غلاف Quick Code العام، لأن بيانات رمز GS1 مُهيكلة (معرّف أساسي بالإضافة إلى مؤهّلات اختيارية، وسمات إضافية، وأهداف تحليل) بدلًا من عدد قليل من الحقول المسطحة.

<Note>
  GS1 هي فئة Quick Code الوحيدة التي يمكن أن تكون إما **Dynamic** أو **Static** — ويعتمد ذلك كليًا على المُحلِّل (resolver) الذي تختاره في الخطوة 1، وليس على مفتاح تبديل منفصل للنوع. راجع **الخطوة 1: Resolver** أدناه.
</Note>

## الخطوات الخمس

يعرض مؤشر خطوات المعالج: **Resolver → Identify → Data Attributes → Resolution → Review**. تظهر خطوة **Resolution** فقط عند اختيار مُحلِّل مستضاف من Scanova (‏**Scanova Resolver** أو **Your Custom Domain**) في الخطوة 1 — أما إذا اخترت **GS1 Global Resolver** أو **Custom Resolver** بدلًا من ذلك، فتُتخطى الخطوة 4 بالكامل، إذ لا تملك Scanova وجهة لتهيئتها لرمز لا تُحلّله بنفسها.

### 1. Resolver — من يُحلّل هذا الرمز؟

يحدد هذا الاختيار أي نطاق يظهر في الرابط الرقمي النهائي، وما إذا كان رمز QR الناتج ديناميكيًا أو ثابتًا:

| الخيار              | النطاق                       | نوع QR  | ملاحظات                                                            |
| :------------------ | :--------------------------- | :------ | :----------------------------------------------------------------- |
| Scanova Resolver    | `scnv.io`                    | Dynamic | الافتراضي. مستضاف من Scanova — يعمل مباشرة دون إعداد.              |
| Your Custom Domain  | أحد نطاقاتك المخصصة الموثّقة | Dynamic | يتطلب حصة خطة نطاق مخصص؛ مقفل (مع دعوة للترقية) في حال عدم توفرها. |
| GS1 Global Resolver | `id.gs1.org`                 | Static  | يُحلَّل عبر بنية GS1 التحتية الخاصة، وليس Scanova.                 |
| Custom Resolver     | نطاق مُحلِّل تكتبه بنفسك     | Static  | أنت من يتحكم في المُحلِّل؛ Scanova تخزّن فقط بيانات المعرّف.       |

<Frame caption="الخطوة 1: Resolver، مع تحديد Scanova Resolver كخيار افتراضي">
  <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/gs1/gs1-step1-resolver.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=e5ede2d1db0f5289ad5c633b423b39e4" alt="الخطوة 1 من معالج GS1، وهي Resolver، تعرض أربعة خيارات مُحلِّل مع تحديد Scanova Resolver كخيار افتراضي" width="1280" height="720" data-path="images/v2/qr-codes/create/gs1/gs1-step1-resolver.png" />
</Frame>

### 2. Identify — ماذا يحدّد هذا الرمز؟

اختر **Application Identifier** المطابق لما تقوم بوسمه (مثال: `(01) Global Trade Item Number (GTIN)`، وهو الافتراضي)، ثم أدخل **Value** الخاصة به. يفرض حقل القيمة قواعد GS1 الحقيقية لمعرّف التطبيق مباشرة — الطول المطلوب، وتنسيق أرقام فقط مقابل أبجدي رقمي، وبالنسبة لمعرّفي التطبيق `00` و`01`، رقم تحقق GS1 صالح.

يمكن أن يعرض كل معرّف تطبيق أيضًا **Qualifiers** — بالنسبة لـ GTIN، هذه هي Serial Number (معرّف التطبيق 21)، وConsumer Product Variant (معرّف التطبيق 22)، وBatch or Lot Number (معرّف التطبيق 10)، وكلها اختيارية. بجانب Serial Number يوجد رابط "Need more than one? Bulk generate" يوصلك إلى [العمليات المجمّعة](/ar/qr-codes/manage/folders-tags-bulk-operations) لتوليد نطاق من الرموز المسلسلة دفعة واحدة.

### 3. Data Attributes

خطوة اختيارية لإرفاق قيم إضافية مفتاحها معرّف تطبيق GS1 بنفس الرمز — تواريخ، وقياسات، وما شابه. لا تحتاج معظم رموز GS1 إلى هذا؛ تبدأ الخطوة مطوية مع مفتاح تبديل "Add data attributes" بدلًا من حقول فارغة.

### 4. Resolution (للمُحلِّلات المستضافة من Scanova فقط)

اضبط الوجهة الفعلية التي يُحلَّل إليها الرمز عند مسحه. يوجد دائمًا إدخال **Product Page** وهو مطلوب فعليًا — إنه الوجهة التي يصل إليها مسح مجرد. يمكنك إضافة أنواع روابط أخرى (‏**Datasheet**، **Video**، **Custom**) يمكن للتطبيقات المتوافقة مع GS1 اكتشافها بشكل منفصل.

لكل إدخال، اختر:

* **Simple URL** — عنوان وجهة مجرد، أو
* **Existing QR** — الإشارة إلى أحد رموز QR الديناميكية الأخرى غير المرتبطة بـ GS1 (رمز Website URL، أو رمز من منشئ الصفحات، أو Document، أو رمز App Store، حسب النية التي تختارها).

يوفّر إدخال Product Page أيضًا خيار **Auto-build a page** — وهذا يُنشئ رمز QR حقيقيًا لصفحة هبوط من قيم معرّف التطبيق التي أدخلتها بالفعل (بعد اختيار سمة في مربع حوار المعاينة)، ثم يربطه كمرجع "Existing QR" لذلك الإدخال، بحيث يبقى رمز QR عاديًا من منشئ الصفحات يمكنك مواصلة تعديله لاحقًا.

<Frame caption="الخطوة 4: Resolution، بتهيئة وجهة Product Page المطلوبة">
  <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/gs1/gs1-step4-resolution.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=bb7025263a719c8db5e5237ad4c5a72f" alt="الخطوة 4 من معالج GS1، وهي Resolution، تعرض إدخال Product Page المطلوب مضبوطًا على Simple URL مع حقل وجهة، بالإضافة إلى خيار إضافة المزيد من أنواع الروابط" width="1280" height="744" data-path="images/v2/qr-codes/create/gs1/gs1-step4-resolution.png" />
</Frame>

<Note>
  لا يمكن أبدًا لرمز GS1 أن يشير إلى رمز GS1 آخر كوجهة تحليل — يُستبعد هذا الخيار كليًا من أداة الاختيار، وليس مجرد أمر غير مُستحسن.
</Note>

### 5. Review & publish

تعرض **Digital link preview** المجمّعة (مثال: `https://scnv.io/LpqE/01/04012345678901`) وملخصًا بلغة واضحة لما يحدده الرمز، ومن يحلّله، وأين يصل المسح. يمكنك أيضًا إعادة تسمية رمز QR هنا قبل النشر.

<Frame caption="الخطوة 5: Review and publish، مع الرابط الرقمي المجمّع وملخص بلغة واضحة">
  <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/gs1/gs1-step5-review.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=d9b316051d08951102bd4af11a08a16f" alt="الخطوة 5 من معالج GS1، وهي Review and publish، تعرض الرابط الرقمي المجمّع، وملخصًا بلغة واضحة، وزر Publish" width="1280" height="776" data-path="images/v2/qr-codes/create/gs1/gs1-step5-review.png" />
</Frame>

## إنشاء رمز QR من نوع GS1

<Steps>
  <Step title="فتح Create QR Code واختيار Quick Code">
    من الشريط الجانبي، انتقل إلى **QR Codes**، ثم انقر على **Create QR Code** (أو انتقل إلى `/qr/create`). انقر على بطاقة **Quick Code**.
  </Step>

  <Step title="اختيار GS1">
    في شبكة أنواع **Quick Code**، انقر على **Configure** أسفل **GS1**، في قسم **Dynamic** أعلى الصفحة. سيفتح هذا المعالج على المسار `/qr/quick/gs1`.
  </Step>

  <Step title="اختيار مُحلِّل">
    في خطوة **Resolver**، اختر من يُحلّل الرمز. يُحدَّد **Scanova Resolver** افتراضيًا ولا يتطلب أي إعداد إضافي — انقر على **Continue**.
  </Step>

  <Step title="تحديد ما يمثله الرمز">
    في خطوة **Identify**، اختر معرّف تطبيق وأدخل قيمته (مثال: GTIN مكوّن من 14 رقمًا). أضف أي مؤهّلات تحتاجها، ثم **Continue**.
  </Step>

  <Step title="إضافة سمات بيانات (اختياري)">
    تخطَّ هذه الخطوة ما لم تحتج إلى إرفاق سمات GS1 إضافية، ثم **Continue**.
  </Step>

  <Step title="تهيئة Resolution">
    إذا اخترت مُحلِّلًا مستضافًا من Scanova، اضبط وجهة **Product Page** على الأقل — إما Simple URL، أو رمز QR موجود، أو صفحة مُنشأة تلقائيًا — ثم **Continue**.
  </Step>

  <Step title="المراجعة والنشر">
    تحقق من الرابط الرقمي المجمّع والملخص، وعدّل اسم رمز QR إذا لزم الأمر، ثم انقر على **Publish**. تنفتح لوحة لتأكيد مجلد رمز QR ووسومه، وضبط تصميم رمز QR، قبل التأكيد.
  </Step>
</Steps>

## إنشاؤه عبر الـ API

لإنشاء رمز QR من نوع GS1 عبر الـ API بدلًا من الواجهة، استخدم معرّف الفئة `31` (المسمّى **GS1** في جدول **Category dropdown reference** ضمن [Create QR Code](/v1/api-reference/endpoint/qr_manager/create)، حيث `allowed_qr_types: "bt"` — القيمتان `"dy"` و`"st"` كلتاهما صالحتان لـ `qr_type`، بحسب المُحلِّل الذي تختاره). حمولة `info` هي **مصفوفة صِرفة (bare array)** من كتل مصنّفة بالنوع، واحدة لكل خطوة من خطوات المعالج تحتوي بيانات:

```json theme={null}
[
  {
    "type": "resolver",
    "data": { "name": "scanova_resolver", "domain": "scnv.io" }
  },
  {
    "type": "primaryKey",
    "data": { "id": "01", "value": "04012345678901" }
  },
  {
    "type": "qualifier",
    "data": [{ "id": 21, "value": "SER456" }]
  },
  {
    "type": "dataAttributes",
    "data": [{ "id": "3103", "value": "000195" }]
  },
  {
    "type": "resolution",
    "data": {
      "linkType": "pip",
      "name": "simple_url",
      "target": { "url": "https://acme.com/products/widget-42" }
    }
  }
]
```

كتل `qualifier` و`dataAttributes` و`resolution` كل منها اختيارية وقابلة للتكرار (كتلة `resolution` واحدة لكل نوع رابط مُهيَّأ)؛ أما `resolver` و`primaryKey` فمطلوبان. حقل `target` في كتلة `resolution` هو إما `{ "url": "..." }` (عندما تكون `name` هي `"simple_url"`) أو `{ "qrid": "..." }` (عندما تكون `name` هي `"qr_reference"`) — تُحذف كتل `resolution` كليًا بالنسبة للمُحلِّلات `gs1`/`custom_resolver`، إذ ليس لديها وجهة مستضافة من Scanova لتخزينها.

راجع [Create QR Code](/v1/api-reference/endpoint/qr_manager/create) للاطلاع على مخطط الطلب الكامل.

## ذات صلة

* [رمز QR للمنتج](/ar/qr-codes/create/product) — صفحة هبوط تسويقية لمنتج، مقابل معرّف GS1 المُهيكل لسلسلة التوريد.
* [المجلدات والوسوم والعمليات المجمّعة](/ar/qr-codes/manage/folders-tags-bulk-operations) — توليد جماعي لنطاق من رموز GS1 المسلسلة، وتنظيم الرموز بعد نشرها.
* [Quick Code مقابل صفحة كاملة](/ar/qr-codes/create/quick-code-vs-page) — كيف تندرج GS1 بين أنواع Quick Code الأخرى.