فاتورة زاتكا في تطبيق Flutter

من فريق ماثل · آخر تحديث

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

بطاقة فاتورة زاتكا داخل تطبيق فلاتر: رمز QR والإجمالي والضريبة وزر عرض الـ PDF

نزّل الباكدج من pub.dev

١. السيرفر يرسل الفاتورة

بعد ما الدفع ينجح، السيرفر حقك يستدعي ماثل بالدالة الجاهزة (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

أسئلة شائعة

التطبيق يكلّم ماثل مباشرة؟

لا. مفتاح ماثل يبقى في السيرفر حقك: السيرفر يرسل الفاتورة بعد الدفع، والتطبيق ياخذ منه qr ورابط الـ PDF ويعرضهم بالباكدج.

رمز QR يقرأه تطبيق الهيئة؟

إيه، الباكدج يرسم نفس نص الـ TLV اللي ترجعه ماثل وهو نفس اللي في الفاتورة، ويقدر أي قارئ يتحقق منه.

أقدر أستخدم QR بس بدون البطاقة؟

إيه: ZatcaQrImage للرمز لحاله، و ZatcaQrData.decode يرجّع البائع والرقم الضريبي والوقت والإجمالي والضريبة.

جرّبه الحين على بيئة المطورين

بدون مفتاح ولا تسجيل: الرد رد الهيئة الحقيقي، ومعه الفاتورة PDF عربي وإنجليزي ورمز QR.

ابدأ الأسعار