خواندن دوبارهی یک سفارش
پاتریس یار با GET /wp-json/payava-patris/v1/orders/:id یک سفارش را دوباره میخواند. این کار برای سفارشهایی است که قلمی بدون کد کالای پاتریس داشتند و بعداً کد آن در سایت ثبت شده است.
این endpoint کی صدا زده میشود؟
در هر دور همگامسازی، پاتریس یار حداکثر ۲۰ سفارشِ دارای قلم بیکد را دوباره میخواند. اقلام بر اساس جایگاه با هم تطبیق داده میشوند. اگر تعداد اقلام تغییر کرده باشد، آن سفارش رد میشود.
پیشنیازها
Endpoint
GET /wp-json/payava-patris/v1/orders/1532
هدرها
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
X-Payava-Key | string | بله | کلید API حساب پاتریس. |
پارامترها
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
id | integer (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 }
]
}
فیلدهای کامل در ساختن آرایهی سفارش آمدهاند.
کدهای خطا
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
401 | payava_patris_unauthorized | — | کلید نادرست است. |
404 | payava_patris_not_found | — | سفارش پیدا نشد. پاتریس یار آن را نادیده میگیرد و خطا نشان نمیدهد. |
نکتهها
- این endpoint باید سفارش را با هر وضعیتی برگرداند، حتی اگر قبلاً تحویل شده باشد.
- شکل پاسخ باید دقیقاً همان شکل هر سفارش در
GET /wp-json/payava-patris/v1/ordersباشد.