مركز المساعدةمركز المساعدة / المطورون · مرجع
أنشئ مجموعات قوائم الأسعار، واضبط أسعار منتجاتها، وأضف عملاءها أو أزلهم من نظام ERP لديك.
هذه الصفحة ترجمة آلية ولم تُراجع بعد.
نوع التاجر مجموعة من العملاء لها أسعارها الخاصة، مثل مشتري الجملة. جانب اللوحة مشروح في أنواع الموردين.
سبع نقاط نهاية POST تحت /api/webhook تديرها. كلها تحتاج إلى تفعيل Webhook نوع التاجر. راجع تبويب Webhooks/Pushers.
كل شيء يُطابَق بمعرّفاتك أنت:
| المعرّف في الطلب | يطابق |
|---|---|
vendor_type_external_id | قيمة external_id التي أرسلتها إلى /vendor-type-store |
item_external_id | قيمة item_id التي أرسلتها إلى /item-create |
customer_external_id | قيمة external_id التي أرسلتها إلى /user-create |
/vendor-type-store| الحقل | مطلوب | المعنى |
|---|---|---|
external_id | نعم | معرّفك لنوع التاجر، حتى 255 حرفًا |
name | نعم | الاسم، حتى 255 حرفًا |
description | لا | حتى 1000 حرف |
is_active | لا | true أو false |
يُجيب بـ "Vendor type created successfully" أو "Vendor type updated successfully".
/vendor-type-product-store يضبط سعرًا واحدًا.
| الحقل | مطلوب | المعنى |
|---|---|---|
vendor_type_external_id | نعم | نوع التاجر |
item_external_id | نعم | المنتج |
price | نعم | السعر لهذا النوع من التجار، 0 أو أكثر |
old_price | لا | السعر قبل الخصم |
is_active | لا | عرض المنتج لهذا النوع من التجار |
/vendor-type-product-bulk-store يأخذ vendor_type_external_id وقائمة products. لكل عنصر الحقول نفسها item_external_id وprice وold_price وis_active.
استجابة الجملة هي "Bulk vendor type products processed" مع successful وerrors وtotal_processed وsuccessful_count وerror_count. المنتج غير الموجود يُدرج تحت errors مع "Item not found". المنتجات الأخرى تُحفظ مع ذلك.
| نقطة النهاية | المحتوى | الأثر |
|---|---|---|
/vendor-type-customer-store | vendor_type_external_id, customer_external_id | تضيف عميلًا واحدًا |
/vendor-type-customer-bulk-store | vendor_type_external_id, customers[] وفيه customer_external_id | تضيف عدة عملاء |
/vendor-type-customer-remove | vendor_type_external_id, customer_external_id | تزيل عميلًا واحدًا |
/vendor-type-customer-bulk-remove | vendor_type_external_id, customers[] وفيه customer_external_id | تزيل عدة عملاء |
ينتمي العميل إلى نوع تاجر واحد في الوقت نفسه. لنقل عميل، أزله أولًا، ثم أضفه إلى النوع الجديد.
| الحالة | الرسالة | السبب |
|---|---|---|
| 400 | "Vendor webhook is not enabled for this shop" | Webhook نوع التاجر متوقف. فعّله واختر حفظ الإعدادات |
| 404 | "Vendor type not found" | لا يوجد نوع تاجر بهذا external_id في متجرك |
| 404 | "Item not found" | لا يوجد منتج بهذا المعرّف الخارجي |
| 404 | "Customer not found" | لا يوجد عميل في متجرك بهذا المعرّف الخارجي |
| 409 | "Customer is already assigned to a vendor type" | الاستجابة تسمّي نوع التاجر الحالي |
| 409 | "Customer is not assigned to this vendor type" | طلب إزالة لعميل في نوع تاجر آخر، أو ليس في أي نوع |
| 422 | "Validation failed" | حقل مطلوب مفقود أو نوعه خاطئ |
في طلبات الجملة، العميل أو المنتج الذي يفشل يُبلَّغ عنه لكل عنصر ولا يوقف الباقي.