دریافت سفارشهای جدید
پاتریس یار با GET /wp-json/payava-patris/v1/orders سفارشهایی را میگیرد که هنوز به پاتریس تحویل نشدهاند. سایت باید فقط سفارشهای تحویلنشده را، از قدیمی به جدید، برگرداند.
پاتریس یار سفارشها را چطور میگیرد؟
- پاتریس یار
GET /wp-json/payava-patris/v1/orders?limit=50را صدا میزند. - سفارشها را در پاتریس ذخیره میکند.
- شناسهی همهی سفارشهای دریافتی را به
POST /wp-json/payava-patris/v1/orders/deliveredمیفرستد. - اگر پاسخ خالی نبود، دوباره از مرحلهی ۱ شروع میکند (حداکثر ۲۰ صفحه در هر دور).
این کار وقتی روش اتصال در پاتریس یار «دریافت مستقیم از همین اتصال» است، در فاصلهی زمانی تنظیمشده انجام میشود.
پیشنیازها
- مسیرها و احراز هویت در وردپرس
- ساختن آرایهی سفارش
- برای هر سفارش علامت «تحویل به پاتریس» در meta سفارش (در نمونه
_my_patris_delivered).
Endpoint
GET /wp-json/payava-patris/v1/orders?limit=50
هدرها
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
X-Payava-Key | string | بله | کلید API حساب پاتریس. |
پارامترها
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
limit | integer (query) | خیر | حداکثر تعداد سفارش در پاسخ. پاتریس یار 50 میفرستد. مقدار را بین 1 و 100 محدود کنید. |
کدام سفارشها برگردانده شوند؟
- سفارشهایی که هنوز با
POST /wp-json/payava-patris/v1/orders/deliveredتحویل نشدهاند. - فقط وضعیتهایی که میخواهید به پاتریس برسند، مثلاً
processingوon-hold. - فقط سفارشهای ثبتشده پس از تاریخ شروع اتصال، تا کل سفارشهای قدیمی به پاتریس نرود.
- مرتبشده بر اساس زمان ثبت، از قدیمی به جدید.
پیادهسازی در وردپرس
GET /orders
function my_patris_orders(WP_REST_Request $request)
{
$limit = max(1, min(100, (int) ($request->get_param('limit') ?: 50)));
$args = [
'limit' => $limit,
'type' => 'shop_order',
'status' => ['processing', 'on-hold'], // statuses that go to Patris
'orderby' => 'date',
'order' => 'ASC', // oldest first
'meta_query' => [['key' => '_my_patris_delivered', 'compare' => 'NOT EXISTS']],
];
$since = (string) get_option('my_patris_since', ''); // e.g. the activation time, UTC
if ($since !== '') {
$args['date_created'] = '>=' . strtotime($since . ' UTC');
}
$factor = (float) get_option('my_patris_price_factor', 1) ?: 1.0;
$orders = [];
foreach (wc_get_orders($args) as $order) {
$orders[] = my_patris_order_to_array($order, $factor);
}
return ['orders' => $orders];
}
تابع my_patris_order_to_array در صفحهی ساختن آرایهی سفارش آمده است. این تابع WC_Order را به قالب سفارش تبدیل میکند و مبلغها را به واحد پاتریس میبرد.
نمونه پاسخ موفق
200 OK
{
"orders": [
{
"id": 1532,
"number": "1532",
"status": "processing",
"created": "2026-11-07T10:42:13+03:30",
"customer_name": "علی رضایی",
"username": "",
"user_mobile": "",
"phone": "09120000000",
"email": "",
"country": "IR",
"state": "تهران",
"city": "تهران",
"address": "خیابان نمونه، پلاک ۱",
"postcode": "1234567890",
"subtotal": 2400000,
"discount": 200000,
"shipping": 300000,
"total": 2500000,
"transaction_id": "",
"order_key": "",
"note": "",
"visitor_code": 0,
"visitor_name": "",
"lines": [
{ "pip": "101009001", "sku": "", "name": "لنت ترمز جلو", "quantity": 2, "unit_price": 1200000, "discount": 200000 }
]
}
]
}
سفارش جدیدی نیست؟ آرایهی خالی برگردانید:
200 OK
{ "orders": [] }
کدهای خطا
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
401 | payava_patris_unauthorized | — | کلید نادرست است. |
429 | — | — | سایت درخواست را محدود کرده است. پاتریس یار دور بعد دوباره تلاش میکند. |
500 | — | — | خطای سایت. پاتریس یار متن message را نشان میدهد و دور بعد دوباره تلاش میکند. |
نکتهها
سفارش تحویلشده را دوباره برنگردانید
اگر سایت پس از POST /wp-json/payava-patris/v1/orders/delivered همان سفارشها را دوباره برگرداند، پاتریس یار در هر دور ۲۰ بار همان صفحه را میخواند. پاتریس سفارش تکراری ثبت نمیکند، ولی بار بیدلیل روی سایت میماند.
- در روش «دریافت از طریق سرور پاتریس» هم این endpoint را نگه دارید. اگر سرور در دسترس نباشد، با گذاشتن اتصال روی «دریافت مستقیم از همین اتصال» سفارشها از همین endpoint گرفته میشوند.
wc_get_ordersهم با جدولهای سفارش جدید ووکامرس (HPOS) و هم با ذخیرهسازی قدیمی کار میکند. از کوئری مستقیم رویwp_postsاستفاده نکنید.