PDFVela — pdfvela.com
جميع أدوات PDF

كيفية حفظ نص Base64 كملف PDF

استجابة API أو ملف XML لفاتورة أو المصدر الخام لرسالة بريد يحتوي على كتلة نص طويلة تبدأ بالأحرف JVBERi0، وتحتاج إلى المستند الذي بداخلها. إليك الطريقة، من العثور على الكود حتى فتح الملف.

بقلم · تاريخ التحديث: 10 نوفمبر 2026

ما ملف PDF بترميز Base64، ولماذا يصل على شكل نص؟

يكتب ترميز Base64 الملف باستخدام الحروف والأرقام وبضعة رموز فقط. وهذا ما يسمح للصيغ النصية، مثل JSON وXML والبريد الإلكتروني، بأن تحمل ملف PDF في داخلها. يحتفظ الكود بنسخة مطابقة تمامًا من المستند، فإذا فككت ترميزه استعدت الملف الأصلي بايتًا بايتًا، وتبقى أي توقيعات رقمية فيه صالحة.

ستصادفه عادةً في هذه المواضع:

  • واجهات برمجة الفوترة والمحاسبة. كثيرًا ما تعيد منصات الفوترة الإلكترونية وبرامج المحاسبة نسخة PDF من الفاتورة في حقل بترميز Base64. ويمكن لملفات XML المنظمة للفواتير (مثل UBL) أن تضمّن نسخة PDF القابلة للطباعة بالطريقة نفسها.
  • الشحن. عند إنشاء شحنة، تعيد شركات الشحن غالبًا ملصق الشحن كملف PDF بترميز Base64.
  • المدفوعات والبنوك. قد تعيد خدمات الإيصالات وقسائم الرواتب وكشوف الحساب المستند في حقل نصي.
  • منصات التوقيع الإلكتروني وإدارة المستندات. يعود المستند الموقّع من خدمة التوقيع بترميز Base64.
  • مصدر رسائل البريد الإلكتروني. في المصدر الخام للرسالة، تُخزَّن مرفقات PDF على شكل كتل Base64.

1. اعثر على الكود وانسخه كاملًا

  • استجابة JSON: ابحث عن الحقل الذي يحمل ملف PDF، وكثيرًا ما يكون اسمه pdf أو content أو data أو document أو file أو label. تبدأ قيمته بالأحرف JVBERi0. انسخ كل ما بين علامتي التنصيص. ويمكنك أيضًا نسخ الاستجابة كلها، فالأداة تعثر وحدها على الجزء الذي يبدأ بالأحرف JVBERi0.
  • ملف XML: ابحث عن العنصر الذي يحمل ملف PDF (مثل EmbeddedDocumentBinaryObject) وانسخ النص الواقع بين وسم البداية ووسم النهاية. لا مشكلة في فواصل الأسطر.
  • مصدر الرسالة: افتح خيار «Show original» أو «View source» (أي عرض الرسالة الأصلية أو مصدرها). مرفق PDF هو الكتلة الواقعة تحت السطرين Content-Type: application/pdf وContent-Transfer-Encoding: base64. انسخ كل شيء حتى أول سطر فارغ بعدها.
  • أدوات المطور: في تبويب Network بالمتصفح، افتح الاستجابة، وانقر بزر الفأرة الأيمن على الحقل واختر «Copy value» (نسخ القيمة). هذه الطريقة أوثق بكثير من تحديد نص طويل يدويًا.

ولأن الكود طويل جدًا، فمن السهل أن تُقطع نهايته. بعد النسخ، تأكد من أن ما لصقته ينتهي بالطريقة نفسها التي ينتهي بها في المصدر.

2. حوّل الكود وتحقق من المستند

افتح Base64 إلى PDF، واضغط «أو اكتب نصًا أو الصقه»، ثم الصق الكود. بمجرد فك الترميز تظهر الصفحة الأولى، ويظهر تحتها عدد الصفحات وإصدار PDF وحجم الملف. وإذا كان الكود محفوظًا في ملف .txt، فما عليك إلا اختيار هذا الملف.

تتيح لك المعاينة التحقق سريعًا:

  • هل هو المستند الصحيح؟ رقم الفاتورة أو اسم العميل أو بيانات الملصق ظاهرة في الصفحة الأولى.
  • هل عدد الصفحات كما توقعت؟ الصفحات الناقصة تعني أن الكود نُسخ جزئيًا فقط.
  • هل الملف محمي بكلمة مرور؟ عندها تظهر ملاحظة بدلًا من المعاينة، ويُحفظ الملف كما هو تمامًا.

3. احفظ ملف PDF وافتحه

اضغط «تنزيل PDF». يُحفظ الملف دون أي تغيير، ويفتح في أي قارئ PDF. وبعدها الأمر لك: اجمع فواتير شهر كامل في ملف واحد باستخدام دمج PDF، أو صغّر حجمه ليناسب البريد الإلكتروني باستخدام ضغط PDF، أو احصل على صورة للصفحة الأولى باستخدام PDF إلى JPG.

ماذا تخبرك بداية الكود؟

بداية الكودالملف الذي بداخله
JVBERi0مستند PDF
data:application/pdf;base64,مستند PDF (بصيغة data URI)
iVBORw0KGgoصورة PNG
/9j/صورة JPG
UEsDBملف ZIP أو Word (.docx) أو Excel (.xlsx)
PD94bWwgنص XML (مثل بيانات الفاتورة نفسها)

يفسّر السطر الأخير التباسًا شائعًا مع الفواتير الإلكترونية: بعض الخدمات ترسل ملف XML للفاتورة بترميز Base64 بدلًا من ملف PDF. وعند فك ترميز هذا الكود تحصل على نص XML مقروء، لا على مستند.

أخطاء شائعة

حفظ الكود كملف نصي بامتداد .pdf. يبقى الملف محتويًا على نص Base64، ويعرضه القارئ على أنه تالف. يجب فك ترميز الكود أولًا.

نسخ أكثر من القيمة. إذا انتهى الكود بفاصلة «,» زائدة أو بكلمة «status»، يصبح غير صالح. انسخ القيمة وحدها أو الاستجابة كاملة، فالأداة تستخرج الكود بشكل صحيح في الحالتين.

فواصل الأسطر المكتوبة كرموز. في نصوص JSON قد يُقسَّم الكود كل 76 حرفًا بالرمز \n. هذه الرموز ليست جزءًا من ملف PDF، وتحذفها الأداة تلقائيًا.

الاستجابة الخاطئة. إذا لم يكن المستند جاهزًا بعد، تعيد بعض واجهات API حقلًا فارغًا أو رسالة خطأ. وإذا كان الكود قصيرًا جدًا، أي بضع مئات من الأحرف، فهو على الأرجح نص خطأ وليس ملف PDF.

ملاحظة حول الخصوصية

لا يحمي Base64 مستندك، بل يغيّر صيغته فقط. تجنّب فك ترميز الفواتير أو العقود أو التقارير الطبية أو نسخ الهويات على مواقع ترفع الملف إلى خادم. تفك أداة PDFVela ترميز الكود على جهازك، وتواصل العمل حتى لو انقطع اتصالك بالإنترنت بعد فتح الصفحة.

هل أنت مستعد للتجربة؟ الأداة مجانية، ويبقى ملفك على جهازك.

افتح أداة Base64 إلى PDF

أسئلة حول تحويل Base64 إلى PDF

كيف أعرف أن النص هو ملف PDF بترميز Base64؟

أوضح علامة أن يبدأ النص بالأحرف JVBERi0، فهكذا تبدو الأحرف الأولى %PDF- في كل ملف PDF بعد ترميزها. والنص الذي يبدأ بالأحرف data:application/pdf;base64, هو ملف PDF أيضًا. لا يحتوي الكود إلا على حروف وأرقام والرمزين + و/، وقد ينتهي بعلامة = واحدة أو اثنتين.

هل يكفي أن ألصق الكود في ملف وأسميه .pdf؟

لا. حفظ النص بامتداد .pdf يكتب نصًا داخل الملف رغم ذلك، ولا يستطيع قارئ PDF فتحه. يجب أولًا فك ترميز الكود وإعادته إلى بايتات، وهذا ما تفعله أداة «Base64 إلى PDF» داخل متصفحك.

أين يوجد ملف PDF داخل ملف XML للفاتورة الإلكترونية؟

توجد النسخة القابلة للطباعة من الفاتورة عادةً في عنصر مثل EmbeddedDocumentBinaryObject يحمل السمة mimeCode="application/pdf". وكل النص داخل هذا العنصر هو كود Base64 لملف PDF. بعض الخدمات ترسل بدلًا من ذلك HTML أو ورقة أنماط XSLT، وهذا الكود لا يبدأ بالأحرف JVBERi0.

المستند سري. هل هذه الطريقة آمنة؟

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

ماذا لو كان الكود يحتوي على صورة؟

الكود الذي يبدأ بالأحرف iVBORw0KGgo (PNG) أو /9j/ (JPG) هو صورة. تلاحظ أداة «Base64 إلى PDF» ذلك وترشدك إلى أداة «Base64 إلى صورة». وبعد حفظ الصورة يمكنك تحويلها إلى PDF باستخدام «JPG إلى PDF» إذا احتجت إلى ذلك.