اربط فواتيرك مع الهيئة بطلب واحد.

ربطه بالذكاء الاصطناعي

انسخ البرومبت، والصقه في Claude أو Cursor أو ChatGPT.

البرومبت فيه كل اللي يحتاجه المساعد عشان يكتب الربط في مشروعك: الـ API، والسلسلة، والأخطاء، وأول تجربة على بيئة المطورين. وللأدوات اللي تقرأ التوثيق بنفسها، فيه llms.txt.

Integrate the Matheel API (https://matheel.app) into my app so it files Saudi ZATCA Phase 2 e-invoices.

Reference (read it first): https://matheel.app/llms.txt

API: POST https://matheel.app/api/v1/invoices
Header: Authorization: Bearer $MATHEEL_KEY (read it from an environment variable)
Body: { "environment": "sandbox" | "simulation" | "production", "seller": {...}, "csid": {...}, "invoice": {...} }

Do this:
1. Ask me which language/framework I use and where invoices are created, then add one small client module.
2. Keep the invoice chain per device (EGS): store the counter (ICV) and the last invoice_hash.
   Send previous_invoice_hash; move the counter forward only after a 200.
3. On 200 store invoice_xml (base64, the legal document) and qr (print it on the receipt).
4. On 422 show ZATCA's errors and keep the same counter. On 402 tell the user the plan is used up.
   On 429 or 503 retry with backoff using the same counter and uuid.
5. Start with "environment": "sandbox" and no seller/csid (Matheel's instant sandbox), and write one test that files an invoice.