جميع الأدلة

الفريق والإدارة

طباعة مستندات Stripe

اطبع الفواتير والإشعارات الدائنة وعروض الأسعار والإيصالات من Stripe تلقائيًا باستخدام تطبيق Sealed Print لـ Stripe.

يطبع تطبيق Sealed Print لـ Stripe المستندات التي ينشئها Stripe في حسابك: الفواتير والإشعارات الدائنة وعروض الأسعار وإيصالات الدفع. تقرر لكل نوع من المستندات ما إذا كان يُطبع ومتى وإلى أين يذهب. يرسل التطبيق كل مستند إلى نقطة نهاية API في مؤسستك، فيصبح كل مستند مهمة نيابةً عن مالك نقطة النهاية، مثل أي مستند آخر.

التطبيق داخل Stripe Dashboard غير متوفر باللغة العربية بعد ويعرض نصوصه بالإنجليزية؛ لذلك تبقى أسماء عناصره أدناه بالإنجليزية.

المتطلبات المسبقة

  • حساب Stripe يُسمح لك فيه بتثبيت التطبيقات (دور Stripe: Administrator).
  • يفعّل أحد المسؤولين قناة الإدخال REST API ضمن الإعدادات ← قنوات الإدخال.
  • نقطة نهاية API ينبغي أن تستقبل وجهتها المستندات.
  • يتطلب استخدام عدة معرّفات لكل نوع من المستندات، أو مجموعة وجهات، خطة Team (راجع مجموعات الوجهات).
المستنديمكن طباعته
الفواتيرعند إنهاء الفاتورة أو إرسالها أو دفعها
الإشعارات الدائنةعند إنشاء الإشعار الدائن
عروض الأسعارعند إنهاء عرض السعر أو قبوله
الإيصالات (تجريبي)عند نجاح الدفع أو استرداده

يوفّر Stripe الإيصالات كصفحة ويب فقط. يطبع Sealed Print نسختها بصيغة PDF، وهي نسخة لا يوثّقها Stripe؛ وإذا غيّرها Stripe، تتوقف طباعة الإيصالات حتى نكيّف التطبيق. أما فواتير Stripe الخاصة برسومه فهي متاحة فقط في Stripe Dashboard ولا يستطيع التطبيق طباعتها.

الإعداد لمرة واحدة

  1. في Sealed Print، انتقل إلى المصادر ← نقاط نهاية API واختر نقطة نهاية API جديدة. اختر الهدف الذي ينبغي أن تذهب إليه المستندات وانسخ عنوان URL لنقطة النهاية.
  2. في Stripe Dashboard، ثبّت التطبيق Sealed Print من Stripe App Marketplace وافتح إعداداته.
  3. الصق عنوان URL في API endpoint URL.
  4. ضمن Documents، فعّل Print automatically لكل نوع من المستندات تريده على الورق. اختر When تتم الطباعة، وعدد النسخ Copies، وإذا لم يكن ينبغي أن يذهب إلى وجهة نقطة النهاية، فأدخل Identifiers الوجهات أو المجموعات أو مسار عمل، مفصولة بفواصل.
  5. اختر Save، ثم Check connection. عندما تظهر الرسالة “Everything is ready”، تُطبع المستندات الجديدة. يواصل الحقل API endpoint URL عرض عنوان URL المتصل، فترى لاحقًا أي endpoint مضبوط.

لوضع التشغيل الفعلي ووضع الاختبار في Stripe إعدادات منفصلة، لذا يمكنك تجربة كل شيء ببيانات اختبار أولًا.

في كل مرة

  • تُطبع المستندات الجديدة تلقائيًا. تظهر في قائمة الانتظار كمهام تحمل اسم المستند، مثلًا “Invoice INV-0042 – Example Ltd”، مع قناة الإدخال REST API.
  • يُطبع كل مستند مرة واحدة لكل حدث، حتى لو أرسل Stripe الحدث مرة أخرى.
  • لطباعة فاتورة يدويًا، افتحها في Stripe Dashboard واختر Print with Sealed Print في لوحة Sealed Print. يستخدم ذلك المعرّفات وعدد النسخ الخاصة بقاعدة الفواتير، حتى لو كانت الطباعة التلقائية متوقفة.
  • إذا كان المعرّف الأول مسار عمل، تمر المستندات عبره، مثلًا لتوقيعها أولًا (راجع مسارات العمل). أما المعرّف hold فيُبقيها في Sealed Print حتى يرسلها شخص ما.
  • لإرسال الفواتير إلى عملائك كفواتير إلكترونية (ZUGFeRD أو XRechnung)، أدخل للفواتير معرّف سير عمل يتضمن الخطوتين تحويل إلى فاتورة إلكترونية وإرسال بالبريد الإلكتروني. ترسل خطوة البريد الإلكتروني إلى عنوان البريد الإلكتروني للمشتري المقروء من الفاتورة (راجع المثال في مسارات العمل).

استكشاف الأخطاء وإصلاحها

  • يعرض Check connection ما يمنع الطباعة، بالرسائل نفسها التي يستخدمها التطبيق أدناه.
  • “The URL of the API endpoint was renewed”: اختار شخص ما إنشاء عنوان URL جديد. الصق عنوان URL الجديد.
  • “The API endpoint no longer exists”: أنشئ نقطة نهاية جديدة والصق عنوان URL الخاص بها.
  • “There is no destination, group or workflow with the identifier …”: تحقق من كتابة المعرّف في الوجهة، ومن أن مالك نقطة النهاية يحق له الطباعة إليها (يجب أن تكون وجهة مستخدم آخر مُشارَكة).
  • “The inbound channel REST API is turned off”: يفعّلها أحد المسؤولين ضمن الإعدادات ← قنوات الإدخال.
  • لا تُطبع فاتورة: المسودات ليس لها ملف PDF. ينشئه Stripe عند إنهاء الفاتورة.
  • لا يُطبع إيصال: لم يوفّر Stripe الإيصال بصيغة PDF (تجريبي، راجع أعلاه).

الخطوات التالية