پرش به مطلب اصلی

خواندن دوباره‌ی یک سفارش

پاتریس یار با GET /wp-json/payava-patris/v1/orders/:id یک سفارش را دوباره می‌خواند. این کار برای سفارش‌هایی است که قلمی بدون کد کالای پاتریس داشتند و بعداً کد آن در سایت ثبت شده است.

این endpoint کی صدا زده می‌شود؟​

در هر دور همگام‌سازی، پاتریس یار حداکثر ۲۰ سفارشِ دارای قلم بی‌کد را دوباره می‌خواند. اقلام بر اساس جایگاه با هم تطبیق داده می‌شوند. اگر تعداد اقلام تغییر کرده باشد، آن سفارش رد می‌شود.

پیش‌نیازها​

Endpoint​

GET /wp-json/payava-patris/v1/orders/1532

هدرها​

نامنوعالزامیتوضیح
X-Payava-Keystringبلهکلید API حساب پاتریس.

پارامترها​

نامنوعالزامیتوضیح
idinteger (path)بلههمان id سفارش که در GET /wp-json/payava-patris/v1/orders فرستاده شد.

پیاده‌سازی در وردپرس​

GET /orders/:id
function my_patris_order(WP_REST_Request $request)
{
$order = wc_get_order((int) $request['id']); // any status, delivered or not
if (!$order) {
return new WP_Error('payava_patris_not_found', 'Order not found', ['status' => 404]);
}
return my_patris_order_to_array($order, (float) get_option('my_patris_price_factor', 1) ?: 1.0);
}

نمونه پاسخ موفق​

پاسخ خود سفارش است، نه آرایه:

200 OK
{
"id": 1532,
"number": "1532",
"status": "processing",
"created": "2026-11-07T10:42:13+03:30",
"customer_name": "علی رضایی",
"phone": "09120000000",
"subtotal": 2400000,
"discount": 200000,
"shipping": 300000,
"total": 2500000,
"lines": [
{ "pip": "101009001", "sku": "", "name": "لنت ترمز جلو", "quantity": 2, "unit_price": 1200000, "discount": 200000 }
]
}

فیلدهای کامل در ساختن آرایه‌ی سفارش آمده‌اند.

کدهای خطا​

نامنوعالزامیتوضیح
401payava_patris_unauthorized—کلید نادرست است.
404payava_patris_not_found—سفارش پیدا نشد. پاتریس یار آن را نادیده می‌گیرد و خطا نشان نمی‌دهد.

نکته‌ها​

  • این endpoint باید سفارش را با هر وضعیتی برگرداند، حتی اگر قبلاً تحویل شده باشد.
  • شکل پاسخ باید دقیقاً همان شکل هر سفارش در GET /wp-json/payava-patris/v1/orders باشد.