ساختن آرایهی سفارش
پاتریس یار هر سفارش را با یک قالب ثابت JSON میخواند. این صفحه تابع my_patris_order_to_array را میدهد که یک WC_Order را به همین قالب تبدیل میکند. صفحههای GET /orders، GET /orders/:id و ارسال سفارش به سرور پاتریس از آن استفاده میکنند.
فیلدها چه هستند؟
توضیح کامل هر فیلد، وضعیتهای سفارش و قاعدهی شناسایی مشتری در قالب سفارش آمده است. این قالب برای وردپرس و سایت اختصاصی یکی است. مهمترین قاعدهها:
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
id | integer | بله | شناسهی سفارش ووکامرس ($order->get_id()). |
status | string | بله | وضعیت ووکامرس بدون پیشوند wc-. processing و completed یعنی پرداختشده. |
| مبلغها | number | بله | به واحد پاتریس: مبلغ سایت × ضریب (مثلاً 10 برای تومان به ریال). |
lines[].pip | string | بله | کد کالای پاتریس از meta _pip محصول؛ برای متغیر بدون PIP، PIP محصول اصلی. |
lines[].unit_price | number | بله | قیمت واحد پیش از تخفیف قلم. |
lines[].discount | number | بله | جمع تخفیف قلم. |
تابع تبدیل
my_patris_order_to_array()
function my_patris_pip(?WC_Product $product): string
{
if (!$product) {
return '';
}
$pip = (string) $product->get_meta('_pip');
if ($pip === '' && $product->get_parent_id()) {
$parent = wc_get_product($product->get_parent_id()); // variation without its own PIP
$pip = $parent ? (string) $parent->get_meta('_pip') : '';
}
return $pip;
}
function my_patris_order_to_array(WC_Order $order, float $factor = 1.0): array
{
$lines = [];
foreach ($order->get_items('line_item') as $item) {
/** @var WC_Order_Item_Product $item */
$product = $item->get_product();
$qty = (float) $item->get_quantity();
$subtotal = (float) $item->get_subtotal();
$lines[] = [
'pip' => my_patris_pip($product ?: null),
'sku' => $product ? (string) $product->get_sku() : '',
'name' => $item->get_name(),
'quantity' => $qty,
'unit_price' => $qty > 0 ? round($subtotal / $qty * $factor, 2) : 0,
'discount' => round(($subtotal - (float) $item->get_total()) * $factor, 2),
];
}
$user = $order->get_user();
$created = $order->get_date_created();
return [
'id' => $order->get_id(),
'number' => (string) $order->get_order_number(),
'status' => $order->get_status(),
'created' => $created ? $created->format(DATE_ATOM) : gmdate(DATE_ATOM),
'customer_name' => trim($order->get_billing_first_name() . ' ' . $order->get_billing_last_name()),
'username' => $user ? $user->user_login : '',
'user_mobile' => $user ? (string) get_user_meta($user->ID, 'billing_phone', true) : '',
'phone' => $order->get_billing_phone(),
'email' => $order->get_billing_email(),
'country' => $order->get_billing_country(),
'state' => $order->get_billing_state(),
'city' => $order->get_billing_city(),
'address' => trim($order->get_billing_address_1() . ' ' . $order->get_billing_address_2()),
'postcode' => $order->get_billing_postcode(),
'subtotal' => round((float) $order->get_subtotal() * $factor, 2),
'discount' => round((float) $order->get_total_discount() * $factor, 2),
'shipping' => round((float) $order->get_shipping_total() * $factor, 2),
'total' => round((float) $order->get_total() * $factor, 2),
'transaction_id' => $order->get_transaction_id(),
'order_key' => $order->get_order_key(),
'note' => $order->get_customer_note(),
'visitor_code' => (int) $order->get_meta('_billing_visitorCode'), // 0 = no visitor
'visitor_name' => (string) $order->get_meta('_billing_visitorName'),
'lines' => $lines,
];
}
نکتهها
stateدر این نمونه کد استان ووکامرس است (مثلاًTHR). برای نام استان ازWC()->countries->get_states($country)استفاده کنید.- اگر سفارش آدرس صورتحساب ندارد، فیلدهای آدرس ارسال (
get_shipping_*) را جایگزین کنید. idو تعداد و ترتیبlinesرا پس از ارسال تغییر ندهید. پاتریس یار کد کالای اقلام بیکد را بر اساس جایگاه قلم کامل میکند.