دریافت قیمت و موجودی کالاها
پاتریس یار تغییرات کالاهای پاتریس را با POST /wp-json/payava-patris/v1/products به سایت میفرستد. سایت این ردیفها را ذخیره میکند و قیمت و موجودی محصولاتی را که به کد پاتریس متصلاند بهروز میکند.
این endpoint کی صدا زده میشود؟
- وقتی گزینهی «بهروزرسانی قیمت و موجودی» برای این سایت در پاتریس یار روشن باشد.
- در هر دور همگامسازی، فقط ردیفهایی که از ارسال قبلی تغییر کردهاند.
- در دستههایی به اندازهی «تعداد در هر ارسال» (پیشفرض ۱۰۰ و حداکثر ۵۰۰۰ ردیف)، تا ۵۰ دسته در هر دور.
پیشنیازها
- مسیرها و احراز هویت در وردپرس
- هر محصول سایت که باید از پاتریس بهروز شود، کد کالای پاتریس را داشته باشد (همان
pipدر ساختن آرایهی سفارش).
Endpoint
POST /wp-json/payava-patris/v1/products
هدرها
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
X-Payava-Key | string | بله | کلید API حساب پاتریس. |
Content-Type | string | بله | application/json; charset=utf-8 |
پارامترها
بدنه یک شیء با آرایهی products است. هر عضو یک ردیف «کالا در یک انبار» است:
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
code | integer | بله | کد کالا در پاتریس. |
anbar | integer | بله | کد انبار. -1 یعنی جمع موجودی همهی انبارها. |
action | string | بله | UpdateProduct برای افزودن یا بهروزرسانی، DeleteProduct برای حذف کالا در پاتریس. |
name | string | خیر | نام کالا در پاتریس. |
unit | string | خیر | واحد کالا، مثل «عدد». |
price | number | بله | قیمت اصلی، به واحد پاتریس. |
price1 | number | بله | قیمت سطح ۱، به واحد پاتریس. |
price2 | number | بله | قیمت سطح ۲، به واحد پاتریس. |
price3 | number | بله | قیمت سطح ۳، به واحد پاتریس. |
price_wg | number | بله | قیمت عمده، به واحد پاتریس. |
inventory | number | بله | موجودی این انبار. |
سایت با هر ردیف چه کند؟
- ردیف را با کلید
codeوanbarذخیره یا جایگزین کند.DeleteProductرا فقط علامت «حذفشده» بزنید. - محصولات و متغیرهای ووکامرس با meta
_pipبرابر همینcodeرا پیدا کند. - قیمت را از سطح قیمت انتخابی (مثلاً
price) بخواند، بر ضریب واحد تقسیم کند و اگر بزرگتر از صفر بود، روی محصول بگذارد. - موجودی را از انبار انتخابی بگذارد. اگر انبار خاصی انتخاب نشده، ردیف
anbarبرابر-1را به کار ببرد.
پیادهسازی در وردپرس
POST /products
function my_patris_products(WP_REST_Request $request)
{
$factor = (float) get_option('my_patris_price_factor', 1) ?: 1.0; // e.g. 10: shop in Toman, Patris in Rial
$stored = $updated = $notFound = 0;
foreach ((array) $request->get_param('products') as $row) {
$code = (int) ($row['code'] ?? 0);
if ($code <= 0) {
continue;
}
$stored++; // keep the row in your own table if you need warehouses / a catalog
if (($row['action'] ?? '') === 'DeleteProduct') {
continue; // never delete WooCommerce products automatically
}
$ids = get_posts(['post_type' => ['product', 'product_variation'], 'post_status' => 'any', 'fields' => 'ids',
'posts_per_page' => -1, 'meta_key' => '_pip', 'meta_value' => (string) $code]);
if (!$ids) {
$notFound++;
continue;
}
foreach ($ids as $id) {
$product = wc_get_product($id);
$price = (float) ($row['price'] ?? 0);
if ($price > 0) {
$product->set_regular_price(wc_format_decimal($price / $factor, wc_get_price_decimals()));
}
if ((int) ($row['anbar'] ?? 0) === -1) { // -1 = total of all warehouses
$product->set_manage_stock(true);
$product->set_stock_quantity(wc_stock_amount((float) ($row['inventory'] ?? 0)));
}
$product->save();
$updated++;
}
}
return ['stored' => $stored, 'updated' => $updated, 'not_found' => $notFound, 'skipped' => 0];
}
نمونه پاسخ موفق
200 OK
{ "stored": 1, "updated": 1, "not_found": 0, "skipped": 0 }
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
stored | integer | خیر | تعداد ردیفهای ذخیرهشده. |
updated | integer | خیر | تعداد محصولات سایت که تغییر کردند. پاتریس یار این عدد را در log خود ثبت میکند. |
not_found | integer | خیر | تعداد کدهایی که محصول متصل در سایت نداشتند. |
skipped | integer | خیر | تعداد کدهای ردشده. |
کدهای خطا
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
401 | payava_patris_unauthorized | — | کلید نادرست است. |
400 | invalid_json | — | بدنهی درخواست JSON معتبر نیست. |
413 | — | — | بدنه از حد مجاز سرور بزرگتر است. حد سرور را بالا ببرید یا «تعداد در هر ارسال» را در پاتریس یار کم کنید. |
نکتهها
ردیفها فقط پس از پاسخ موفق ارسالشده حساب میشوند
اگر پاسخ موفق نباشد، پاتریس یار همان ردیفها را در دور بعد دوباره میفرستد. پس ذخیره را با کلید code و anbar و به صورت جایگزینی بنویسید تا تکرار مشکلی ایجاد نکند.
- محصولی را که در پاتریس حذف شده (
DeleteProduct)، در سایت حذف نکنید. ردیف را علامت بزنید و تصمیم دربارهی محصول را به مدیر سایت بسپارید. - قیمت
0یعنی پاتریس برای آن سطح قیمت ندارد. قیمت محصول سایت را با0بازنویسی نکنید. - دستهی ۵۰۰۰ ردیفی چند مگابایت حجم دارد.
post_max_sizeدر PHP و حد اندازهی بدنه در وبسرور یا فایروال باید برای آن کافی باشد.