المهارات square-automation
💳

square-automation

آمن

أتمتة مدفوعات وطلبات Square

تبسيط معالجة مدفوعات Square وإدارة الطلبات دون الحاجة إلى استدعاءات API يدوية. أتمتة الفواتير، وتتبع المدفوعات، وإدارة المواقع من خلال Claude Code.

يدعم: Claude Codex Code(CC)
🥉 74 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "square-automation". سرد جميع المدفوعات من أمس

النتيجة المتوقعة:

تم العثور على 23 دفعة من 2024-01-15:
- الدفعة #1A2B3C: $145.00 (COMPLETED)
- الدفعة #4D5E6F: $89.50 (COMPLETED)
- الدفعة #7G8H9I: $210.00 (PENDING)

المجموع: $444.50

استخدام "square-automation". البحث عن الطلبات في موقع Downtown

النتيجة المتوقعة:

تم استرداد 47 طلبًا من موقع Downtown:
- الطلب #ORD-001: $350.00 (COMPLETED)
- الطلب #ORD-002: $125.00 (OPEN)
- الطلب #ORD-003: $75.00 (COMPLETED)

معرف الموقع: L1234ABCD

استخدام "square-automation". عرض جميع مواقع الأعمال

النتيجة المتوقعة:

تم العثور على 3 مواقع:
1. متجر Downtown (L1234ABCD) - ACTIVE
2. فرع Uptown (L5678EFGH) - ACTIVE
3. المستودع (L9012IJKL) - INACTIVE

التدقيق الأمني

آمن
v1 • 2/25/2026

All static findings are false positives. The detected 'external_commands' patterns (57 instances) are Ruby/shell backtick syntax examples in markdown documentation, not executable code. The network detection is a documentation URL (https://rube.app/mcp) showing where to obtain the Rube MCP server. This skill is legitimate documentation for automating Square payment tasks with no executable code or security risks.

1
الملفات التي تم فحصها
182
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

مطابقة المدفوعات

يمكن لأصحاب الأعمال سرد وتحليل المدفوعات اليومية تلقائيًا عبر جميع مواقع Square لمطابقة الحسابات وتحديد التباينات.

تتبع حالة الطلب

يمكن لفرق الدعم البحث عن واسترداد تفاصيل الطلبات حسب اسم العميل أو التاريخ لتوفير تحديثات حالة الطلب في الوقت الفعلي دون الوصول إلى لوحة تحكم Square.

أتمتة سير عمل الفواتير

يمكن لفرق المالية سرد الفواتير المجدولة وغير المدفوعة، وإلغاء الفواتير غير الصالحة، وتصدير بيانات الفواتير لأنظمة المحاسبة.

جرّب هذه الموجهات

سرد المدفوعات الأخيرة
سرد جميع مدفوعات Square من آخر 7 أيام. اعرض معرفات المدفوعات والمبالغ والحالات.
البحث عن الطلبات حسب التاريخ
ابحث عن جميع الطلبات المكتملة في موقع 'Main Street' بين 1 يناير و31 يناير. اعرض معرفات الطلبات والمبالغ الإجمالية.
إلغاء فاتورة معلقة
اعثر على الفاتورة غير المدفوعة للعميل 'John Doe' المرسلة هذا الشهر وألغها باستخدام رقم الإصدار الصحيح.
تقرير مدفوعات متعدد المواقع
استرد المدفوعات من جميع المواقع الثلاثة للربع الأول من 2024. جمّع حسب الموقع واحسب الإجماليات. تعامل مع الترقيم تلقائيًا.

أفضل الممارسات

  • اتصل دائمًا بـ RUBE_SEARCH_TOOLS أولاً للحصول على مخططات الأدوات الحالية قبل تنفيذ سير العمل
  • قم بتخزين معرفات المواقع مؤقتًا بعد الاسترداد الأولي لتجنب استدعاءات API الزائدة عن الحاجة
  • استخدم تنسيق طابع زمني RFC 3339 لجميع فلاتر نطاق التاريخ (مثل 2024-01-01T00:00:00Z)
  • تعامل مع الترقيم من خلال متابعة قيم المؤشر حتى تصبح غير موجودة لمجموعات النتائج الكبيرة

تجنب

  • لا تحاول إلغاء المدفوعات المكتملة - استخدم سير عمل استرداد الأموال بدلاً من ذلك
  • تجنب استدعاء UPDATE_ORDER دون استرداد رقم الإصدار الحالي أولاً
  • لا تقم مطلقًا بتضمين معرفات المواقع في الكود - قم بحلها ديناميكيًا دائمًا عبر LIST_LOCATIONS
  • لا تتخطى معالجة الترقيم - ستُرجع مجموعات البيانات الكبيرة نتائج غير مكتملة

الأسئلة المتكررة

هل أحتاج إلى مفتاح Square API؟
لا. تستخدم هذه المهارة Rube MCP الذي يتعامل مع مصادقة Square OAuth. ما عليك سوى إضافة https://rube.app/mcp كخادم MCP الخاص بك وإكمال عملية OAuth.
هل يمكنني معالجة مدفوعات جديدة من خلال هذه المهارة؟
لا. يمكن لهذه المهارة سرد وإلغاء ومراقبة المدفوعات الحالية، ولكنها لا تستطيع إنشاء معاملات دفع جديدة. استخدم سير عمل الدفع في Square للمدفوعات الجديدة.
لماذا أحصل على أخطاء 'عدم تطابق الإصدار' عند تحديث الطلبات؟
يتطلب UPDATE_ORDER حقل الإصدار الحالي. قم دائمًا باسترداد الطلب أولاً باستخدام SQUARE_RETRIEVE_ORDER للحصول على أحدث رقم إصدار قبل التحديث.
كيف أجد معرفات المواقع الخاصة بي؟
استدعِ SQUARE_LIST_LOCATIONS لاسترداد جميع المواقع. يحتوي كل موقع على حقل 'id' (مثل 'L1234ABCD') تستخدمه لتصفية الطلبات والمدفوعات.
هل يمكنني إلغاء المدفوعات المكتملة؟
لا. يمكن إلغاء المدفوعات المعلقة فقط. بالنسبة للمدفوعات المكتملة التي تحتاج إلى عكس، استخدم عملية استرداد الأموال من Square بدلاً من ذلك.
ماذا يحدث عندما يكون لدي أكثر من 100 نتيجة؟
يقوم Square بترقيم النتائج. تحقق من حقل 'cursor' في الاستجابة ومرره إلى الطلب التالي. استمر حتى يصبح المؤشر غير موجود للحصول على جميع النتائج.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md