منهجية أسعار زيت النخيل في السوق الفعلية

معنى السعر

تحافظ كل مشاهدة لسعر سلعة فعلية على المنتج ونوع السعر الذي يحدده المصدر ونوع الفترة والعملة والوحدة الأصليتين. وتجمع جداول شراء عناقيد الثمار الطازجة (FFB) الإندونيسية جميع صفوف أعمار الأشجار المنشورة معًا. أما أسعار زيت النخيل الخام (CPO) والأسعار المرجعية الماليزية لعناقيد الثمار الطازجة فتبقى مشاهدات ذات قيمة مفردة.

يستخدم CPO الماليزي متوسطات سوق التسليم المحلي بوحدة MYR لكل طن متري. ويستخدم FFB الماليزي السعر المرجعي المنشور عند بوابة المعصرة بوحدة MYR لكل 1% من معدل استخلاص الزيت (OER). لا يفترض Narwhal معدل استخلاص، ولا يحول هذا المرجع إلى سعر شراء لكل طن.

هذه المشاهدات ليست أسعار تسوية لعقود مستقبلية أو إشارات تداول. ويحدد الاكتشاف المعنى الدقيق للسعر والنطاق الجغرافي لكل سلسلة مقبولة.

المصادر والحقوق

تأتي جداول عناقيد الثمار الطازجة (FFB) الإندونيسية من سلطات المقاطعات. وتأتي الأسعار المرجعية لزيت النخيل الخام (CPO) الإندونيسي من قرارات Ministry of Trade. وتأتي متوسطات السوق لزيت النخيل الخام والأسعار المرجعية الإقليمية لعناقيد الثمار الطازجة في ماليزيا من Malaysian Palm Oil Board (MPOB).

قرارات Indonesian Ministry of Trade · تقارير أسعار MPOB · شرح MPOB لمعنى 1% من معدل استخلاص الزيت (OER)

لا تتيح Narwhal إلا المصادر التي لها سجل حقوق ساري المفعول وآخر إصدار مكتمل. وعند سحب الحقوق، تُحجب بيانات المصدر فورًا عن الاكتشاف وطلبات أحدث البيانات والسجل التاريخي.

هوية السلسلة

• series_id هو معرّف ثابت يُستخدم في المسار لسلسلة واحدة من أسعار سوق السلع الفعلية.
• product يميّز بين ffb وcpo.
• country هو ISO 3166-1 alpha-3; area يستخدم ISO 3166-2 حيث ينطبق، أو معرّفات nwl-* التي يحددها Narwhal مثل nwl-mys-north. تحذف السلاسل الوطنية area.
• producer_arrangement هو purchase_agreement أو supported_scheme. يُحذف عندما لا يحدد المصدر أي ترتيب.

مصطلحات المصدر مثل mitra swadaya, plasma، و pekebun تبقى بيانات وصفية توثّق المصدر، ولا تصبح قيمًا تعدادية موحّدة على مستوى API.

جداول أسعار كاملة

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

تحل التنقيحات محل الجدول بأكمله. ولا يمكن تنقيح صف على حدة لأن الجهة نشرت الصفوف ضمن قرار تسعير واحد.

التواريخ والتنقيحات

• period_start و period_end يحددان تواريخ سريان الأسعار الإندونيسية مع شمول يومَي البداية والنهاية. أما المشاهدات اليومية الماليزية فتستخدم تاريخ التقرير بدايةً واليوم التالي نهايةً غير مشمولة.
• revision يبدأ من 1 ويتغير عند تغيير السعر أو جدول الأسعار الكامل.
• لا تنشئ عمليات الجلب المتطابقة تنقيحات.

السجل

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

في كل صفحة تالية، أبقِ جميع معلمات الطلب دون تغيير، بما فيها limit وأي price_month. عند تغيير البيانات المنشورة يُعاد cursor_expired؛ ابدأ من جديد دون مؤشر.

يتضمن السجل الأسعار المقبولة وجداول الأسعار الكاملة. يشمل CPO الإندونيسي 68 فترة سريان، وCPO الماليزي 1,457 تقريرًا يوميًا، وFFB الماليزي 71 شهرًا من البيانات اليومية. لا تضمن حدود الفترة تغطية متصلة دون فجوات.

الحدود

تبقى التقارير غير المتاحة والقيم المتعارضة خارج السجل المنشور. ففي بيانات زيت النخيل الخام (CPO) الماليزي، هناك 289 تاريخًا لا تتوفر تقاريرها وتقرير واحد غير متسق. وتُستبعد أربعة أشهر من بيانات عناقيد الثمار الطازجة (FFB) الماليزية بسبب تعارض صيغ المصدر. ولا تتحول أي قيمة مفقودة إلى صفر، ولا يُفترض أن تاريخها عطلة. ولا تُدرج عقود FCPO المستقبلية.

راجع الـ مرجع واجهة API للسلع و التغطية.