WC_API_Orders::create_order() │ public │ WC 2.2

Create an order

Method of the class: WC_API_Orders{}

Return

Array|WP_Error.

Usage

$WC_API_Orders = new WC_API_Orders();
$WC_API_Orders->create_order( $data );

$data(array) (required)

raw order data

Changelog

WC_API_Orders::create_order() WC API Orders::create order code ^{WC 7.7.0}

public function create_order( $data ) {
	global $wpdb;

	try {
		if ( ! isset( $data['order'] ) ) {
			throw new WC_API_Exception( 'woocommerce_api_missing_order_data', sprintf( __( 'No %1$s data specified to create %1$s', 'woocommerce' ), 'order' ), 400 );
		}

		$data = $data['order'];

		// permission check
		if ( ! current_user_can( 'publish_shop_orders' ) ) {
			throw new WC_API_Exception( 'woocommerce_api_user_cannot_create_order', __( 'You do not have permission to create orders', 'woocommerce' ), 401 );
		}

		$data = apply_filters( 'woocommerce_api_create_order_data', $data, $this );

		// default order args, note that status is checked for validity in wc_create_order()
		$default_order_args = array(
			'status'        => isset( $data['status'] ) ? $data['status'] : '',
			'customer_note' => isset( $data['note'] ) ? $data['note'] : null,
		);

		// if creating order for existing customer
		if ( ! empty( $data['customer_id'] ) ) {

			// make sure customer exists
			if ( false === get_user_by( 'id', $data['customer_id'] ) ) {
				throw new WC_API_Exception( 'woocommerce_api_invalid_customer_id', __( 'Customer ID is invalid.', 'woocommerce' ), 400 );
			}

			$default_order_args['customer_id'] = $data['customer_id'];
		}

		// create the pending order
		$order = $this->create_base_order( $default_order_args, $data );

		if ( is_wp_error( $order ) ) {
			throw new WC_API_Exception( 'woocommerce_api_cannot_create_order', sprintf( __( 'Cannot create order: %s', 'woocommerce' ), implode( ', ', $order->get_error_messages() ) ), 400 );
		}

		// billing/shipping addresses
		$this->set_order_addresses( $order, $data );

		$lines = array(
			'line_item' => 'line_items',
			'shipping'  => 'shipping_lines',
			'fee'       => 'fee_lines',
			'coupon'    => 'coupon_lines',
		);

		foreach ( $lines as $line_type => $line ) {

			if ( isset( $data[ $line ] ) && is_array( $data[ $line ] ) ) {

				$set_item = "set_{$line_type}";

				foreach ( $data[ $line ] as $item ) {

					$this->$set_item( $order, $item, 'create' );
				}
			}
		}

		// set is vat exempt
		if ( isset( $data['is_vat_exempt'] ) ) {
			update_post_meta( $order->get_id(), '_is_vat_exempt', $data['is_vat_exempt'] ? 'yes' : 'no' );
		}

		// calculate totals and set them
		$order->calculate_totals();

		// payment method (and payment_complete() if `paid` == true)
		if ( isset( $data['payment_details'] ) && is_array( $data['payment_details'] ) ) {

			// method ID & title are required
			if ( empty( $data['payment_details']['method_id'] ) || empty( $data['payment_details']['method_title'] ) ) {
				throw new WC_API_Exception( 'woocommerce_invalid_payment_details', __( 'Payment method ID and title are required', 'woocommerce' ), 400 );
			}

			update_post_meta( $order->get_id(), '_payment_method', $data['payment_details']['method_id'] );
			update_post_meta( $order->get_id(), '_payment_method_title', sanitize_text_field( $data['payment_details']['method_title'] ) );

			// mark as paid if set
			if ( isset( $data['payment_details']['paid'] ) && true === $data['payment_details']['paid'] ) {
				$order->payment_complete( isset( $data['payment_details']['transaction_id'] ) ? $data['payment_details']['transaction_id'] : '' );
			}
		}

		// set order currency
		if ( isset( $data['currency'] ) ) {

			if ( ! array_key_exists( $data['currency'], get_woocommerce_currencies() ) ) {
				throw new WC_API_Exception( 'woocommerce_invalid_order_currency', __( 'Provided order currency is invalid.', 'woocommerce' ), 400 );
			}

			update_post_meta( $order->get_id(), '_order_currency', $data['currency'] );
		}

		// set order meta
		if ( isset( $data['order_meta'] ) && is_array( $data['order_meta'] ) ) {
			$this->set_order_meta( $order->get_id(), $data['order_meta'] );
		}

		// HTTP 201 Created
		$this->server->send_status( 201 );

		wc_delete_shop_order_transients( $order );

		do_action( 'woocommerce_api_create_order', $order->get_id(), $data, $this );
		do_action( 'woocommerce_new_order', $order->get_id() );

		return $this->get_order( $order->get_id() );
	} catch ( WC_Data_Exception $e ) {
		return new WP_Error( $e->getErrorCode(), $e->getMessage(), array( 'status' => 400 ) );
	} catch ( WC_API_Exception $e ) {
		return new WP_Error( $e->getErrorCode(), $e->getMessage(), array( 'status' => $e->getCode() ) );
	}
}