طلبات التسعير وعروض الموردين

طلب التسعير (RFQ) هو الجانب الشرائي من المنافسة: قائمة بنود تطلب من مورديك تسعيرها، وتجمد القائمة لحظة إنشاء الطلب. وكل رد من مورد يسجل عرض مورد بأسطره المسعرة وبعملة المورد نفسها. تنشئ هذه الأدوات الطلبات وتديرها، وتسجل العروض وتصححها، وتقرأ الأسعار التي جمعتها مؤسستك. ودليل التطبيق في طلبات عروض الأسعار.

طلبات التسعير

أنشئ طلبا من بنود منافسة، واقرأه، وغير عملته، ونزل ملف المورد أو احذفه.

rfqs_list

يعرض طلبات التسعير في مؤسستك عبر كل المنافسات، الأحدث أولا، ومع كل طلب منافسته وعدد بنوده وعدد عروض الموردين عليه. حدد tender_id لمنافسة واحدة، أو kind لاستبعاد الطلبات الحاضنة التي تحمل أسعار التوريد المفردة.

للقراءة فقط · الصلاحية rfqs.read · الأدوار: المالك، المدير، المشتريات، المشاهد · الخطة الاحترافية وخطة المؤسسات

{
  "tender_id": 48213,
  "kind": "rfq",
  "page": 1
}

ما يعيده: صفحة من الطلبات في data مع total وpage وpage_size وtotal_pages. لكل طلب id وtender_id وtitle وkind وcurrency وcreated_at واسم منافسته وجهتها، وitem_count وresponse_count.

• تظهر الطلبات الحاضنة (النوع sourcing) في القائمة ما لم تستبعدها بـkind. هي تحمل أسعارا كتبت على بنود مفردة، وليست طلبات ترسلها لمورد.

rfqs_get

يعيد طلبا واحدا كاملا: قائمة بنوده المجمدة، وكل عرض مورد سجل عليه، وكل سطر مسعر في تلك العروض. استخدمه لتجد المعرفات وأرقام البنود وأكواد نوبكو قبل تسجيل عرض، أو لتراجع ما رد به الموردون.

للقراءة فقط · الصلاحية rfqs.read · الأدوار: المالك، المدير، المشتريات، المشاهد · الخطة الاحترافية وخطة المؤسسات

ما يعيده: rfq (ومنه tender_id وcurrency وkind)، وitems وهي البنود المجمدة (id وitem_number وdescription وquantity وunit، ومعها item_name وmaterial_code من بند المنافسة الحالي)، وresponses عرض لكل مورد (بيانات المورد وsource وsubmitted_at وcurrency وfx_rate وتاريخه ومصدره وmanufacturer_name)، وresponse_items وهي السطور المسعرة (unit_price بالدولار، وquoted_unit_price كما قدمه المورد، ومدة التوريد ورقم الكتالوج والأوزان والتعبئة وproduct_id).

• description في كل بند نسخة مجمدة لحظة الإنشاء، أما item_name وmaterial_code فيقرآن من بند المنافسة الحالي، فيظهر فيهما أي تعديل لاحق على البند.
• يرد الخادم بخطأ 404 إذا لم يكن الطلب من مؤسستك.

rfqs_create

ينشئ طلب تسعير لمنافسة من البنود التي تختارها. يجمد الطلب هذه البنود لحظة إنشائه، فلا يغير تعديل المنافسة لاحقا ملفا وصل إلى مورد. وكل استدعاء ينشئ طلبا مستقلا، فتستطيع إرسال بنود مختلفة لموردين مختلفين. لا يرسل شيئا: نزل الملف بـrfq_excel_export وأرسله بنفسك.

يغير البيانات · الصلاحية rfqs.write · الأدوار: المالك، المدير، المشتريات · الخطة الاحترافية وخطة المؤسسات

{
  "tender_id": 48213,
  "item_ids": [
    902114,
    902115,
    902118
  ],
  "currency": "EUR"
}

ما يعيده: الطلب الجديد: rfq_id وitem_count وcurrency.

• يرد الخادم بـ400 invalid_items إذا كان أي معرف ليس بندا حيا من هذه المنافسة (والبند المحذوف ليس حيا)، وبـ404 إذا لم تكن المنافسة ظاهرة لمؤسستك.
• يأخذ الطلب عنوان المنافسة (أول 200 حرف) وتأتي بنوده بترتيب بنود المنافسة.

rfqs_update

يغير العملة التي يطلب الطلب من الموردين التسعير بها. يسري التغيير على ملفات Excel التي تنزلها من الآن وعلى القيمة الافتراضية في rfq_responses_add. أما العروض المسجلة فتبقى بعملتها، وأي ملف أرسل سابقا يحمل العملة التي خرج بها.

يغير البيانات · الصلاحية rfqs.write · الأدوار: المالك، المدير، المشتريات · الخطة الاحترافية وخطة المؤسسات

{
  "id": 731,
  "currency": "CNY"
}

ما يعيده: معرف الطلب id وعملته الجديدة currency.

• ترفض الأداة الطلب الحاضن (النوع sourcing) بخطأ 400 sourcing_container، وترد بـ404 إذا لم يكن الطلب من مؤسستك.
• لتغيير عملة عرض مسجل استخدم `rfq_responses_update`.

rfqs_delete

يحذف طلب التسعير مع قائمة بنوده المجمدة وكل عرض مورد سجل عليه. لا يمكن التراجع عن ذلك.

يحذف بيانات أو يستبدلها · الصلاحية rfqs.write · الأدوار: المالك، المدير، المشتريات · الخطة الاحترافية وخطة المؤسسات

ما يعيده: تأكيد الحذف، مع deleted_responses وهو عدد العروض التي حذفت مع الطلب.

• لا يحذف الطلب الحاضن (النوع sourcing) ويرد الخادم بخطأ 400 sourcing_container. احذف أسعاره واحدا واحدا بـ`rfq_responses_delete`.

rfq_excel_export

يبني ملف Excel الذي ترسله إلى الموردين لطلب تسعير ويعيده ملفا. يعاد بناء الملف من قائمة بنود الطلب المجمدة ويحمل هوية الطلب في بيانات مخفية، فتطابق أي نسخة معبأة لاحقا مع طلبها. وقائمة العملة فيه محددة مسبقا بعملة الطلب. وبجانب وصف كل بند عمود «منتجات مشابهة» للاطلاع فقط: المصنع ورقم الكتالوج لكل منتج رسا عليه رمز البند في منافسات نوبكو سابقة، بلا تكرار ومفصولة بفواصل.

للقراءة فقط · الصلاحية rfqs.read · الأدوار: المالك، المدير، المشتريات، المشاهد · الخطة الاحترافية وخطة المؤسسات

ما يعيده: ملف Excel: filename (مثل rfq-731-tender-48213.xlsx) وcontent_type وsize_bytes وbase64.

• يرد الخادم بـ400 no_items إذا لم يكن للطلب بنود. وكل تنزيل جديد يحمل هوية الطلب نفسها، فتطابق كل النسخ طلبها.
• لتسجيل ما يعيده المورد اقرأ الملف المعبأ وسجل أسعاره بـ`rfq_responses_add`.

العملات وأسعار الصرف

يحتفظ العرض بعملته وبسعر صرف واحد مثبت لحظة تسجيله، ويقرأ السعر «كم وحدة من العملة تساوي دولارا واحدا».

fx_rates_get

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

للقراءة فقط · الصلاحية rfqs.read · كل الأدوار · الخطة الاحترافية وخطة المؤسسات

لا معاملات.

ما يعيده: base (دائما USD) وcurrencies وهي كل الرموز المدعومة، وrates وفيها لكل عملة لها سعر افتراضي: currency وfx_rate وrate_date (يوم نشر السعر الأوروبي، وفارغ للسعر الثابت وسعر الربط) وsource (identity أو peg أو ecb) وfixed.

• الدولار (1) والريال السعودي (3.75، سعر الربط الذي تحول به المنصة إلى الريال) ثابتان: لا يقبل عرض بهما سعرا آخر. ويعتمد الدرهم الإماراتي والريال القطري والدينار البحريني والريال العماني والدينار الأردني سعر الربط الرسمي. وبقية العملات على آخر سعر مرجعي للبنك المركزي الأوروبي، ويحدث في أيام العمل.
• العملة المدعومة التي لا تظهر في rates ليس لها سعر محفوظ (مثل الدينار الكويتي والجنيه المصري والروبية الباكستانية)، فأرسل fx_rate عند تسجيل عرض بها.
• يثبت العرض المسجل سعره، فلا تهم هذه الأسعار إلا العروض التي تسجلها من الآن. وهذه الأداة وحدها في الصفحة مفتوحة لكل دور وكل خطة.

عروض الموردين

العرض رد مورد واحد يغطي أيا من بنود الطلب. سجله، وصححه كم مرة شئت، أو احذفه.

rfq_responses_add

يسجل عرض مورد واحد على طلب تسعير، ويغطي أي بنود منه. استخدمه حين يرد المورد بأي صيغة (ملف PDF أو بريد أو صورة أو جدول أعاد ترتيبه): طابق كل صف في الرد مع بند من الطلب وسجل سعره كما طبع. يحتفظ العرض بالأرقام كما قدمها المورد بعملته، ويحولها الخادم إلى الدولار للمقارنة بالسعر الذي يعيده إليك.

يغير البيانات · الصلاحية rfqs.write · الأدوار: المالك، المدير، المشتريات · الخطة الاحترافية وخطة المؤسسات

{
  "rfq_id": 731,
  "supplier_name": "Li Wei",
  "supplier_company": "Shenzhen Medical Co",
  "incoterms": "CIF Riyadh",
  "currency": "CNY",
  "lines": [
    {
      "item_number": 1,
      "unit_price": 2.35,
      "lead_time_days": 45,
      "catalog_no": "SY-10ML"
    },
    {
      "material_code": "4111610529900",
      "unit_price": 14.8,
      "units_per_case": 100
    }
  ]
}

ما يعيده: response_id للعرض الجديد، وsupplier_name المسجل، وعدد السطور المحفوظة في lines، وcurrency وfx_rate اللذان سجل العرض بهما.

• الإشارة التي لا تطابق أي بند في الطلب، أو تطابق أكثر من بند، ترفض برسالة تسمي السطر ولا يحفظ شيء، فلا يقع سعر على بند خطأ.
• يرد الخادم بـ400 إذا لم تحدد اسم مورد ولا شركة مصنعة، وبـ400 manufacturer_not_found إذا لم تكن الشركة من مؤسستك، وبـ400 product_not_found إذا لم يكن product_id من منتجاتك.
• يسجل العرض يدويا (source هو manual). ولا تدخل السطور بلا سعر في المقارنات ولا في كتاب الأسعار.

rfq_responses_update

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

يغير البيانات · الصلاحية rfqs.write · الأدوار: المالك، المدير، المشتريات · الخطة الاحترافية وخطة المؤسسات

{
  "rfq_id": 731,
  "response_id": 2087,
  "currency": "EUR",
  "lines": [
    {
      "item_number": 3,
      "unit_price": 4.1,
      "lead_time_days": 30
    }
  ],
  "remove_rfq_item_ids": [
    8812
  ]
}

ما يعيده: response_id وsupplier_name، وعدد السطور في updated_lines وinserted_lines وremoved_lines، وcurrency وfx_rate بعد التعديل، وrepriced_lines وهو عدد السطور التي أعيد حساب سعرها بالدولار بسبب تغيير العملة أو السعر.

• أرسل تغييرا واحدا على الأقل، فالتعديل الفارغ يرفض بخطأ 400.
• يسري تغيير العملة أو السعر أولا: السطور التي ترسلها في الاستدعاء نفسه تحفظ بالسعر النهائي، وتقرأ قيم unit_price فيها بالعملة النهائية.
• يرد الخادم بـ409 إذا ظهر بند واحد من الطلب أكثر من مرة في العرض (أزل المكرر بـremove_rfq_item_ids أولا)، وبـ404 إذا لم يكن العرض على هذا الطلب، وبـ400 missing_supplier_name إذا ترك التعديل العرض بلا اسم مورد ولا شركة مصنعة.
• يعمل على عرض من أي مصدر: ملف Excel عاد معبأ، أو عرض مكتوب يدويا، أو سعر توريد مفرد.

rfq_responses_delete

يزيل عرض مورد واحدا من طلب تسعير مع سطوره، مثل سعر توريد كتب خطأ أو استيراد قديم. لا يمكن التراجع عن ذلك، ويبقى الطلب نفسه.

يحذف بيانات أو يستبدلها · الصلاحية rfqs.write · الأدوار: المالك، المدير، المشتريات · الخطة الاحترافية وخطة المؤسسات

ما يعيده: تأكيد الحذف: success تساوي true.

• يرد الخادم بـ404 إذا لم يكن العرض على هذا الطلب. وبهذه الأداة تزيل سعر توريد مفردا، فهو محفوظ في الطلب الحاضن للمنافسة.

قراءة الأسعار المجمعة

ثلاث قراءات للبيانات نفسها دون تغييرها: منافسة واحدة، وكل سطر سعر في المؤسسة، والسطور نفسها مجمعة حسب المنتج.

tender_rfq_matrix

يعيد في استدعاء واحد كل ما يخص عروض الموردين على منافسة: كل طلب أنشئ لها، وبنوده، وكل عرض مورد، وكل سطر مسعر. هي المادة الخام لمقارنة الأسعار بين الموردين بندا بندا.

للقراءة فقط · الصلاحية rfqs.read · الأدوار: المالك، المدير، المشتريات، المشاهد · الخطة الاحترافية وخطة المؤسسات

ما يعيده: rfqs (لكل طلب item_count) وitems وresponses (لكل عرض manufacturer_name) وresponse_items. وتكون القوائم الأربع فارغة إذا لم يكن للمنافسة طلب.

• لا تحسب الأداة المقارنة لك: اربط response_items بـitems عبر rfq_item_id وبـresponses عبر response_id. وunit_price بالدولار وquoted_unit_price كما قدمه المورد.
• تحمل items الوصف المجمد والكمية والوحدة ورقم البند، لكنها لا تحمل item_name ولا material_code. اقرأهما من `rfqs_get`.
• يشمل الناتج الطلب الحاضن للمنافسة (النوع sourcing) بما فيه من أسعار كتبت على بنود مفردة.

rfq_responses_list

يعرض كل سطر سعر جمعته مؤسستك من الموردين، سواء جاء من طلب تسعير أو رد Excel أو سعر توريد مفرد، الأحدث أولا، ومعه ملخص لكل مورد. استخدمه لترى ما قدمه مورد عبر الوقت أو لتقارن الموردين عبر المنافسات.

للقراءة فقط · الصلاحية rfqs.read · الأدوار: المالك، المدير، المشتريات، المشاهد · الخطة الاحترافية وخطة المؤسسات

{
  "manufacturer_id": 512,
  "limit": 200
}

ما يعيده: vendors ملخص لكل مورد (key وname وlineCount وresponseCount وproductCount وfirstQuoteAt وlastQuoteAt)، وlines وهي السطور الأحدث أولا. لكل سطر مورده ومنتجه أو وصف بنده، وcatalogNo وmaterialCode وquantity، والسعر بالدولار unitPriceUsd وبالريال unitPriceSar وبعملة المورد quotedUnitPrice مع currency، ثم leadTimeDays وsource وsubmittedAt والطلب والمنافسة اللذان جاء منهما. ومعها total وtruncated.

• total هو عدد كل السطور المطابقة، وtruncated تكون true حين يقطع الحد الأقصى 2000 القائمة. أما ملخصات الموردين فتغطي المجموعة كاملة ولا تتقلص حين ترشح.
• تستبعد الأداة السطور بلا سعر. وsource هو excel لملف عاد معبأ، أو manual للمكتوب يدويا (ومنه أسعار التوريد المفردة)، أو web لردود قديمة عبر الويب.

rfq_price_book

السطور المسعرة نفسها التي تعيدها `rfq_responses_list` لكن مجمعة حسب المنتج: صف لكل منتج، ومعه كل مورد قدم سعره وآخر سعر له والمورد الذي يجب أن تتفوق عليه. استخدمه لتعرف من الأرخص لمنتج عبر كل طلباتك.

للقراءة فقط · الصلاحية rfqs.read · الأدوار: المالك، المدير، المشتريات، المشاهد · الخطة الاحترافية وخطة المؤسسات

{
  "source": "excel",
  "limit": 100
}

ما يعيده: products الأحدث عرضا أولا. لكل منتج name وkind وproductId وvendorCount وquoteCount وآخر سعر وأدنى سعر وأعلى سعر بالدولار والريال، وbestVendorKey، وvendors مرتبين من الأرخص آخر سعر. ومعها vendors للمجموعة كلها وtotal وtruncated وquoteCount.

• كل مورد داخل المنتج يحمل أحدث عرض له: السعر بالدولار والريال وبعملته، ومدة التوريد، ورقم الكتالوج، والمصدر، والطلب أو المنافسة التي جاء منها، مع عدد عروضه ونطاق أسعاره. وbestVendorKey هو المورد الذي أحدث سعر له هو الأرخص، أي السعر الذي يجب التفوق عليه.
• الصف منتج من كتالوجك إذا وسم السطر به أو اخترته على البند المسعر، أو كان كود نوبكو في السطر يخص منتجا واحدا فقط في الكتالوج. وإلا فالصف هو كود نوبكو، وإلا فوصف البند. وkind يبين ذلك: product أو code أو description.
• المرشحات تختار المنتجات لا الموردين: يبقى المنتج إذا طابق أحد سطوره كل ما أرسلت، ثم يحتفظ بكل موردينه لتقارنهم. ويبقى total عدد المنتجات المطابقة، فيما تصف vendors وquoteCount المجموعة كلها مهما رشحت.