متابع الفواتير

# مطاردة الفواتير

## البدء السريع

اسحب تقرير تصنيف الذمم المدينة، أعط درجة لكل عميل بناءً على سجل الدفع، اصنع تذكيراً متوازن النبرة لكل فاتورة متأخرة، وقدّمها للمالك. لا شيء يُرسل حتى يوافق المالك.

``` المستخدم: "من يدين لي بأموال" → اسحب تقرير تصنيف الذمم المدينة من السجل → ارجع إلى الدفعات الأخيرة (نافذة زمنية 7 أيام لـ PayPal؛ معالجات أخرى والمتجر 14 يوم؛ حالة Airwallex المدفوعة) → أعط درجة لكل عميل: دافع جيد / متأخر أحياناً / متأخر بصفة متكررة → اصنع تذكيرات متوازنة النبرة → أظهر جدول الملخص + المسودات. انتظر "أرسل هذه." ```

## الإعداد (التشغيل الأول فقط)

اطرح على المالك سؤالاً واحداً قبل التشغيل لأول مرة:

1. **موصل البريد**: "هل تستخدم Gmail أم Microsoft 365 للمسودات؟" — احفظ الإجابة؛ استخدمها لكل قائمة انتظار مسودات غير تابعة لـ PayPal. إذا كان موصل بريد واحد فقط متصلاً، استخدمه وتخطّ السؤال. على أي حال، أكّد أن صندوق البريد هو صندوق المالك قبل إضافة مسودة فيه (`../../shared/tenant-scope.md`).

لا تسأل مرة أخرى في التشغيلات اللاحقة. Stripe ليس سؤال إعداد: عند توصيله، يتم سحب فواتيره المتأخرة في كل تشغيل (`reference/v2_sources.md`).

## سير العمل

1. **اسحب الذمم المدينة المتأخرة.** استعلم عن تقرير تصنيف الذمم المدينة من السجل — MYOB أو NetSuite أو QuickBooks أو Xero أو Zoho Books، أيهما كان متصلاً (`../../shared/connector-neutrality.md`) — عن جميع الفواتير المتأخرة أكثر من يوم واحد. إذا كان Stripe متصلاً، اسحب أيضاً فواتيره المتأخرة. إذا كان Airwallex متصلاً، اسحب أيضاً فواتيره غير المدفوعة: `list_billing_invoices` مع `status: FINALIZED` و `payment_status: UNPAID` (الفاتورة الملغاة لا تزال تظهر UNPAID، لذا مرشح الحالة ليس اختيارياً)، ثم طابق كل واحدة بالسجل برقم الفاتورة في السجل الموجود في `metadata` — أبداً برقم Airwallex الخاص به، الذي يعينه بنفسه ولا يطابق شيئاً في الدفاتر؛ بدون `metadata`، طابق حسب العميل بالإضافة إلى المبلغ والتاريخ المستحق. تحمل المبالغ رمز عملة العمل (`../../shared/currency-and-locale.md`).

2. **ارجع إلى سجل الدفع.** لكل عميل متأخر، استعلم عن PayPal عن المعاملات المستقرة باستخدام هذه الحدود: - `transaction_status: S` (مستقرة فقط — تصفية المعاملات المعلقة والمرفوضة التي تزيد من حجم النتيجة وتزيد من خطر تجاوز معدل الحد) - نافذة زمنية: **آخر 7 أيام** حتى اليوم (ليس 14 أو 30 — النوافذ الأوسع هي السبب الأساسي لأخطاء معدل حد PayPal 429)

**إذا عادت PayPal برمز خطأ معدل حد 429:** - أعد المحاولة مرة واحدة فوراً بـ **نافذة زمنية 3 أيام** بدلاً من ذلك. - إذا عادت المحاولة الثانية أيضاً برمز 429، تخطّ المرجع المتبادل مع PayPal تماماً لهذا التشغيل. علّم جميع العملاء في المجموعة بـ "PayPal غير متاح — تحقق يدوياً" في جدول الملخص. تابع إلى التصنيف باستخدام سجل QuickBooks فقط. لا تحذف التنبيه بصمت.

إذا أظهر العميل دفعة مستقرة ضمن نافذة الاستعلام، علّم بـ "يُحتمل أن يكون مدفوعاً — تحقق" واستبعد من قائمة انتظار المسودات.

قم بنفس فحص الدفع الأخير مقابل كل معالج أو متجر متصل آخر — تهمات Stripe، دفعات Square، طلبات Shopify (`list-orders` حسب العميل، الحالة المدفوعة) — قبل صياغة المسودة، على مدى **آخر 14 يوم**. يقتصر PayPal وحده على 7 بسبب معدل حده؛ قاعدة 14 يوم في بوابات الموافقة هي المعيار، وغطاء PayPal هو الاستثناء الوحيد، مذكور في النتيجة عند تطبيقه. المصادر وقاعدة إزالة التكرار موجودة في `reference/v2_sources.md`. التسوية في أي منها هي علم "يُحتمل أن يكون مدفوعاً — تحقق"، وليس تذكير.

**طابق على البريد الإلكتروني حيث كلا الطرفين لديهما واحد.** المعالجات والمتاجر تفتاح العملاء حسب البريد الإلكتروني؛ السجلات تفتاح حسب الاسم. استخدم بريد العميل الإلكتروني من السجل عندما يكون واضحاً (QuickBooks و Xero و Zoho Books و NetSuite يفعلون؛ MYOB لا يفعل). حيث يتوفر الاسم فقط، فإن مطابقة الاسم فقط غير مؤكدة: احتفظ بالعميل في قائمة انتظار المسودات وعلّم الصف "مطابقة اسم فقط — تحقق" بدلاً من التعامل معه كمدفوع أو غير متطابق.

إذا كان Airwallex متصلاً، فإن جانبه من الفحص هو الفاتورة نفسها: فاتورة Airwallex بـ `payment_status` وهو `PAID` بينما السجل لا يزال يظهر الرصيد مفتوحاً هو "يُحتمل أن يكون مدفوعاً — تحقق" أيضاً. لا نافذة زمنية ولا إعادة محاولة معدل حد مطلوبة؛ إنها استدعاء قائمة واحد.

3. **أعط درجة لكل عميل.** اقرأ [reference/tone-matching.md](reference/tone-matching.md) لمنطق التصنيف. النتيجة: `good-payer` أو `occasionally-late` أو `repeat-late`.

4. **اصنع رسائل تذكير بالبريد الإلكتروني.** رسالة بريد إلكترونية واحدة لكل عميل — دمّج فواتير متعددة متأخرة في رسالة بريد إلكترونية واحدة. طابق النبرة مع الدرجة. انظر [reference/examples/gentle-reminder.md](reference/examples/gentle-reminder.md) و [reference/examples/firm-reminder.md](reference/examples/firm-reminder.md).

5. **قدّم المسودات للمالك.** أظهر جدول ملخص أولاً:

| العميل | المبلغ المستحق | أيام التأخير | النبرة | الإرسال عبر | |---|---|---|---|---| | Acme Corp | USD 1,200 | 18 يوم | لطيفة | PayPal | | Smith LLC | USD 450 | 47 يوم | حازمة | مسودة Gmail | | Pearl St Bistro | USD 467 | 91 يوم | حازمة | مسودة Gmail + رابط دفع Airwallex |

ثم أظهر كل مسودة