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

ساختن آرایه‌ی سفارش

پاتریس یار هر سفارش را با یک قالب ثابت JSON می‌خواند. این صفحه تابع my_patris_order_to_array را می‌دهد که یک WC_Order را به همین قالب تبدیل می‌کند. صفحه‌های GET /orders، GET /orders/:id و ارسال سفارش به سرور پاتریس از آن استفاده می‌کنند.

فیلدها چه هستند؟​

توضیح کامل هر فیلد، وضعیت‌های سفارش و قاعده‌ی شناسایی مشتری در قالب سفارش آمده است. این قالب برای وردپرس و سایت اختصاصی یکی است. مهم‌ترین قاعده‌ها:

نامنوعالزامیتوضیح
idintegerبلهشناسه‌ی سفارش ووکامرس ($order->get_id()).
statusstringبلهوضعیت ووکامرس بدون پیشوند wc-. processing و completed یعنی پرداخت‌شده.
مبلغ‌هاnumberبلهبه واحد پاتریس: مبلغ سایت × ضریب (مثلاً 10 برای تومان به ریال).
lines[].pipstringبلهکد کالای پاتریس از meta _pip محصول؛ برای متغیر بدون PIP، PIP محصول اصلی.
lines[].unit_pricenumberبلهقیمت واحد پیش از تخفیف قلم.
lines[].discountnumberبلهجمع تخفیف قلم.

تابع تبدیل​

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 را پس از ارسال تغییر ندهید. پاتریس یار کد کالای اقلام بی‌کد را بر اساس جایگاه قلم کامل می‌کند.