لديك أسئلة أو مشكلات؟ اكتب في GitHub Discussions.

حلّ Excel نفسه لأسعار الصرف هو نوع البيانات «العملات» في Microsoft 365: سعر مدمج لحظي لا يمكنك ربطه بمصدر محدد ولا استخراج سجله التاريخي. أما الدمج في Frankfurter فقابل للتدقيق، وحين يجب أن يكون المصدر دقيقًا يمكنك تثبيت جهة واحدة: السعر المرجعي للبنك المركزي الأوروبي لضريبة القيمة المضافة في الاتحاد الأوروبي، أو NBP في بولندا، أو PTAX في البرازيل. ويبقى سجل المصدر المثبّت كما نُشر. يتولى Power Query العمل على Windows وMac، ويحصل Windows أيضًا على صيغة من سطر واحد للتحويلات السريعة.

Power Query

الطريق الأساسي على Windows وMac كليهما. انتقل إلى بيانات، من ويب، والصق عنوان نقطة نهاية CSV، وحمّل جدول date,base,quote,rate. حدّثه متى شئت عبر بيانات، تحديث الكل:

https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=eur

اطلب عدة عملات مقابلة دفعة واحدة بفصلها بفواصل:

https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=eur,gbp,jpy

تحويل مبلغ

يحمّل Power Query السعر، لا المبلغ المحوّل. اضرب المبلغ في خلية السعر المحمَّل. ولتحويل لمرة واحدة دون استعلام، يستطيع Microsoft 365 على Windows استدعاء الواجهة مباشرة من الصيغة. أضف دالة مسمّاة (الصيغ، إدارة الأسماء، جديد) باسم FRANKFURTER بهذا التعريف:

=LAMBDA(amount, from, to, [date], amount * NUMBERVALUE(TEXTBEFORE(TEXTAFTER(WEBSERVICE("https://api.frankfurter.dev/v2/rate/" & from & "/" & to & IF(ISOMITTED(date), "", "?date=" & YEAR(date) & "-" & TEXT(MONTH(date), "00") & "-" & TEXT(DAY(date), "00"))), """rate"":"), "}"), "."))

ثم استدعها من أي خلية:

=FRANKFURTER(100, "usd", "eur")

مرّر تاريخًا للحصول على سعر تاريخي:

=FRANKFURTER(100, "usd", "eur", DATE(2020, 1, 2))

تعمل WEBSERVICE على Windows فقط، ولأن صيغ Excel لا تتضمن محلل JSON، تقرأ الدالة السعر مباشرة من نص الاستجابة. وتُبقي NUMBERVALUE مع فاصلة عشرية صريحة الدالةَ عاملة في الإعدادات الإقليمية التي تستخدم الفاصلة. وعلى Mac، اضرب في خلية سعر من Power Query بدلًا من ذلك.

تثبيت مصدر رسمي

تحصل افتراضيًا على السعر المدمج من جميع المصادر. أضف providers إلى عنوان الاستعلام لتثبيت جهة واحدة. وهذا مهم في الضرائب والمحاسبة: إذ تشترط دول كثيرة السعر الذي ينشره بنكها المركزي عند تحويل المبالغ بالعملات الأجنبية.

https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=eur&providers=ecb
ECB
السعر المرجعي للبنك المركزي الأوروبي، المعيار لضريبة القيمة المضافة والجمارك في الاتحاد الأوروبي.
NBP
Narodowy Bank Polski. تُحوَّل ضريبة القيمة المضافة وضريبة الشركات في بولندا بسعر NBP.
CNB
تثبيت البنك الوطني التشيكي، المستخدم في المحاسبة والضرائب التشيكية.
BCB
PTAX من Banco Central do Brasil، المرجع للعقود والضرائب البرازيلية.
BANXICO
سعر FIX من Banco de México لتسوية الالتزامات بالدولار الأمريكي.

تصفّح جميع المصادر. يتبع المصدر المثبّت جدول نشره الخاص، لذا قد يتأخر أحدث أسعاره عن أحدث سعر مدمج بيوم.

السلاسل التاريخية

استخدم from لنطاق تواريخ وgroup=month لاختصاره إلى صف واحد لكل شهر، جاهز للرسم البياني. حمّله عبر Power Query فيتحدّث كأي استعلام آخر. قد يتغير السجل المدمج قليلًا مع وصول بيانات جديدة، لذا ثبّت مصدرًا حين يجب أن تبقى الأرقام ثابتة.

https://api.frankfurter.dev/v2/rates.csv?from=1949-12-01&base=usd&quotes=gbp&providers=bbk&group=month

يجلب هذا الدولار الأمريكي مقابل الجنيه الإسترليني منذ 1949 من أرشيف Deutsche Bundesbank. يمكنك أن ترى ربط الـcable عند $2.80 ثابتًا لسنوات، ثم انكساره في 1967. ويمتد السجل العميق عبر تثبيتات البوندسبنك في فرانكفورت: الدولار مقابل المارك منذ 1948، ومعظم أزواج الدولار الأخرى من 1949 إلى 1970. ويتولى البنك المركزي الأوروبي المهمة منذ 1999، لذا تستخدم السلسلة الحديثة المتصلة السعر المدمج الافتراضي أو providers=ecb.