php swiss qr bill

فاتورة QR السويسرية

مكتبة PHP لإنشاء أجزاء دفع فاتورة QR السويسرية ( QR-Rechnung ).

ابدء

 composer require sprain/swiss-qr-bill

ثم قم بإلقاء نظرة على example/example.php.

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

• لماذا لا يعمل رقم IBAN الخاص بي؟
  تتطلب فاتورة QR النموذجية (مثال) وجود رقم IBAN خاص بـ QR. يمكنك الحصول على حسابك من البنك الذي تتعامل معه. يمكن استخدام رقم IBAN الكلاسيكي لفواتير QR مع مرجع SCOR (مثال) أو بدون رقم مرجعي على الإطلاق (مثال).

• كيف يمكنني التعرف على QR IBAN؟
  في QR IBAN، يكون معرف المعهد ، المحدد بالحرف الخامس إلى التاسع، عبارة عن رقم يتراوح بين 30000 إلى 31999. (مثال: CH44 3199 9 123 0008 8901 2). لمعرفة كيفية اكتشافه في الكود، راجع رقم 182 (تعليق)

• كيف يمكنني إنشاء فواتير QR لأرقام IBAN الدولية؟
  لا يمكنك. فاتورة QR حسب المواصفات تدعم فقط أرقام IBAN من سويسرا وليختنشتاين.

• كيف أدعم عملات أخرى غير الفرنك السويسري أو اليورو؟
  لا يمكنك. فاتورة QR حسب المواصفات تدعم فقط الفرنك السويسري واليورو.

• كيف يمكنني تغيير الترجمات لاستخدام صياغتي الخاصة؟
  لا يمكنك. يتم تعريف الترجمات في مواصفات فاتورة QR وليس المقصود من المستخدم تغييرها. انظر هذه الوثيقة، الصفحة 31.

• كيف يمكنني جعل فواتير QR الخاصة بي قابلة للدفع عن طريق Twint؟
  انظر رقم 129

• ما هي مكتبات PDF التي تدعمها هذه المكتبة؟
  المكتبات التالية مدعومة حاليًا بشكل نشط:

  • fpdf/fpdf
  • tecnickcom/tcpdf
  • setasign/fpdi (مقبول بواسطة FpdfOutput و TcPdfOutput )

  من المعروف أن مخرجات HtmlOutput تُستخدم لإنشاء ملفات PDF باستخدام PrinceXML وDocraptor وdompdf/dompdf (مع بعض التعديلات كما هو موضح هنا)

• لماذا تستخدم final في معظم الفصول الدراسية؟ أريد تمديدها!
  تطبق هذه المكتبة المواصفات الرسمية لفاتورة QR. ليس من المفترض تعديل هذا التنفيذ لأنه قد يؤدي إلى كسر فواتير QR. لذلك يتم وضع علامة على العديد من الفصول على أنها نهائية. إذا وجدت الحاجة إلى توسيع إحدى هذه الفئات النهائية، فربما تكون قد وجدت خطأً في هذه المكتبة. في هذه الحالة، سيكون من المفيد جدًا تقديم تقرير خطأ أو حتى طلب سحب هنا. شكرًا لك!

الحصول على المساعدة

هل تحتاج إلى المزيد من المساعدة في استخدام هذه المكتبة؟

• ابحث في المشكلات الموجودة والمغلقة لمعرفة ما إذا كنت ستجد إجابتك هناك.
• إذا كنت لا تزال بحاجة إلى المساعدة، فيمكنك إنشاء مشكلة بنفسك لطرح سؤالك.

يرجى ملاحظة أن المشرف على هذه المكتبة لن يقدم أي دعم عبر البريد الإلكتروني. يكمن جمال البرمجيات مفتوحة المصدر في حقيقة أنه يمكن للجميع الاستفادة من بعضهم البعض. لذلك لن يتم الرد على الأسئلة إلا في الأماكن العامة.

الإصدار

يتم استخدام الإصدارات الدلالية لهذه المكتبة.

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

دعم نسخة PHP

تدعم هذه المكتبة إصدار PHP طالما أنها تمثل 10% تقريبًا من التثبيتات الحالية على الأقل.

دعم التبعية

يتم دعم الإصدارات الأقدم من التبعيات طالما أنها لا تعيق المزيد من التطوير أو تمثل ما لا يقل عن 10% تقريبًا من التثبيتات الحالية للتبعية المقابلة.

دعم المشروع

• هل يعجبك هذا المشروع؟ النظر في رعاية جيثب.
• هل ترغب في المساهمة؟ ألق نظرة على القضايا المفتوحة. كن لطيفا مع بعضكما البعض.
• انشر الكلمة!

الموارد الرسمية

يحتوي المستودع على المواصفات الرسمية التي تعتمد عليها المكتبة:

• المبادئ التوجيهية للتنفيذ السويسرية QR-فاتورة
• معلومات فنية حول QR-IID وQR-IBAN
• دليل الأنماط QR-فاتورة
• أداة التحقق من الصحة

لمزيد من المعلومات الرسمية انظر

• https://www.six-group.com/en/products-services/banking-services/Payment-standardization/standards/qr-bill.html

للمساهمين في هذه المكتبة

كيفية إنشاء بيانات اختبار جديدة:

1. قم بتعيين $regenerateReferenceFiles = true في TestQrBillCreatorTrait
2. composer update --prefer-lowest
3. vendor/bin/phpunit – تجاهل الاختبارات الفاشلة في testQrFile
4. composer update
5. vendor/bin/phpunit - يجب ألا يكون هناك المزيد من الأخطاء
6. قم بتعيين $regenerateReferenceFiles = false في TestQrBillCreatorTrait