فاتورة زاتكا في تطبيق Flutter
باكدج matheel_zatca على pub.dev: بطاقة فاتورة عربي (أو إنجليزي) فيها رمز QR الهيئة مرسوم داخل التطبيق، والإجمالي والضريبة، وزر يفتح الـ PDF.

١. السيرفر يرسل الفاتورة
بعد ما الدفع ينجح، السيرفر حقك يستدعي ماثل بالدالة الجاهزة (PHP، Laravel، Node.js، Python وغيرها)، ويحفظ qr و pdf مع الطلب.
٢. التطبيق يعرضها
// flutter pub add matheel_zatca url_launcher
import 'package:matheel_zatca/matheel_zatca.dart';
import 'package:url_launcher/url_launcher.dart';
// invoice = what YOUR server returned after filing with Matheel: {"qr": "...", "pdf_url": "..."}
ZatcaInvoiceCard(
qr: invoice['qr'],
onOpenPdf: () => launchUrl(Uri.parse(invoice['pdf_url'])),
)
// Or just the fields: ZatcaQrData.decode(invoice['qr']).total
ZatcaInvoiceCard: البطاقة كاملة،arabic: falseللإنجليزي.ZatcaQrImage: الرمز لحاله.ZatcaQrData.decode: الحقول من الـ TLV (البائع، الرقم الضريبي، الوقت، الإجمالي، الضريبة، الهاش، التوقيع، المفتاح).
أسئلة شائعة
التطبيق يكلّم ماثل مباشرة؟
لا. مفتاح ماثل يبقى في السيرفر حقك: السيرفر يرسل الفاتورة بعد الدفع، والتطبيق ياخذ منه qr ورابط الـ PDF ويعرضهم بالباكدج.
رمز QR يقرأه تطبيق الهيئة؟
إيه، الباكدج يرسم نفس نص الـ TLV اللي ترجعه ماثل وهو نفس اللي في الفاتورة، ويقدر أي قارئ يتحقق منه.
أقدر أستخدم QR بس بدون البطاقة؟
إيه: ZatcaQrImage للرمز لحاله، و ZatcaQrData.decode يرجّع البائع والرقم الضريبي والوقت والإجمالي والضريبة.