Creating Order and Line Items programmatically?

Hmm, answering my own question here, I guess. I now found the commerce_order_new and commerce_line_item_new functions, which I seem to have missed for some reason earlier. Presumably those would do what I want... After some spelunking, I also found the method to add fields to Orders. At first, I expected to find it under "Content types", but eventually found it under Store Configuration, Order Settings, Manage Fields. Somewhat confusing at first, but I guess there's a good reason for keeping this "content type" off to the side in the Store menu.

-JM

Thanks for your suggestions. I got things partially working. I first create the order using

	$order = commerce_order_new($user->uid, 'complete');

The goal of all this is to consolidate orders collected through another system, hence I set the order to already be "complete" to begin with. BTW, should that be "complete" or "completed"? I'm somwhat confused by the wording used in the array returned by commerce_order_commerce_order_state_info(), which I assume is what defines the valid states.

I then move on to creating the line items, as follows:

		$line_item = entity_create('commerce_line_item', array(
		    'type' => 'product',
		    'line_item_label' => $name,
		    'quantity' => $qty,
		));

I need to create line items based on what's received from the other system, hence I'm not creating them based on commerce product entities, but need to provide all details verbatim. I set the name and quantity as shown above, then do the following to add the price to the line item:

		// Wrap the line item and product to easily set field information.
		$line_item_wrapper = entity_metadata_wrapper('commerce_line_item', $line_item);

		// Set the unit price on the line item object.
		$basePrice = commerce_price_field_data_auto_creation();
		$basePrice['amount'] = $amount;
  		$line_item_wrapper->commerce_unit_price = $basePrice;

		// Save the line item now so we get its ID.
    	    	$line_item = commerce_line_item_save($line_item);
    	
    	    	// Add it to the order's line item reference value.
		$order_wrapper->commerce_line_items[] = $line_item;

Finally I save the complete order using commerce_order_save($order). This basically seems to work. However, when subsequently viewing the order in Commerce, each line item's name is enclosed in parenthesis, and there's no total calculated. I suspect there's some action involved in calculating totals which doesn't happen due to the way I add the line items. Please let me know if there's a better way to accomplish the above, which also performs the Total calculations, and other details that I may be overlooking. For instance, calling commerce_price_field_data_auto_creation() directly feels wrong. I'm sure there's a more "kosher" method for creating a price field that I'm supposed to use here, but I'm quite new to Drupal and haven't fully understood all the new "fields" stuff yet. Any pointers are most welcome!

-JM

Thanks, redben. Do I need to somehow declare another type of line item, or can I just give it a different name in the 'type' => 'product' entry? Any name? And I think I've figured out why the price calculation doesnät work. I have only the line item's total price specified – I think I need to fill it with its constituent "price components" as well (base price, VAT, etc), which serve as the basis of the order total price calculation, as far as I can tell.

Thanks, pcambra and redben. I've made some progress, and seem to have most things working now, except for the price components. I need to build these from scratch for the line item (since it's not directly based on a commerce product). I've been struggling here for a couple of days. It's a rather complex multi-level structure. What's the best way for adding this info to the line item, given a known base price amount and tax amount?

-JM

PS: Also, any thought on my question #7 above?

Thanks for the hint, redben. I believe I managed to add a line item type of my own. I also eventually got the, somewhat complex, price component stuff working, including the various kinds of VAT we have to deal with here.

-JM

Here's my code. It essentially imports orders with line items from another system. The trickiest part was getting the elaborate price structure, with its various components, to work. Perhaps there's a more elegant way, or an API function, that can perform this, rather than hard-coding the logic down to a fairly low level? If anyone knows a better way, please let me know.

-JM

	$line_item = commerce_line_item_new('myLineItemType', $order->order_id);

	$line_item->quantity = $orderItem['quantity'];
	$line_item->line_item_label = $name;

	// Wrap the line item and product to easily set field information.
	$line_item_wrapper = entity_metadata_wrapper('commerce_line_item', $line_item);

	$line_item_wrapper->commerce_total->amount = 0;	// Just establish field

	$price = $orderItem['price'] / 100;	// Qty 1 price inc VAT
	$vatRatio = $orderItem['tax'];
	$vatAmount = $price * (1 - (1 / (1 + $vatRatio)));
	$line_item_wrapper->commerce_unit_price->amount = $price;
	$currCode = $order->commerce_order_total[LANGUAGE_NONE][0]['currency_code'];

	$line_item_wrapper->commerce_unit_price->data = commerce_price_component_add(
		$line_item_wrapper->commerce_unit_price->value(),
		'base_price',
		array(
			'amount' => $price - $vatAmount,
			'currency_code' => $currCode,
			'data' => array(),
		),
		TRUE
	);

	// Determine price component name matching tax rate
	$rateCompName = "vat";	// Default name, of not found below
	$rates = commerce_tax_rates();
	foreach ($rates as $rate) {
		if ($vatRatio == $rate['rate']) {
			$rateCompName = $rate['price_component'];
			break;
		}
	}

	$line_item_wrapper->commerce_unit_price->data = commerce_price_component_add(
		$line_item_wrapper->commerce_unit_price->value(),
		$rateCompName,
		array(
			'amount' => $vatAmount,
			'currency_code' => $currCode,
			'data' => array(),
		),
	  TRUE
	);

	// Save the line item now so we get its ID.
	$line_item = commerce_line_item_save($line_item);

	// Add it to the order's line item reference value.
	$order_wrapper->commerce_line_items[] = $line_item;

Perhaps you're not declaring your line item type (i.e., "myLineItemType" in the snippet above)?