magento -- 关于更新订单状态的API接口函数

做Magento和其他系统的对接时需要调用Magento的Api，原以为更新一个订单的状态这样的函数Magento默认肯定自带有，一开始却找不到，打开官网看order部分提供的接口函数列表也没找到。

按说明，从上到下依次为批量获取订单，获取单个订单，给订单添加备注，锁定订单，解锁订单和取消订单。在我认为不存在这个函数准备自己写一个的时候，看代码发现其实addComment这个函数已经提供了更新订单状态的功能，而不仅仅是添加备注，看代码

public function addComment($orderIncrementId, $status, $comment = null, $notify = false) { $order = $this->_initOrder($orderIncrementId); $order->addStatusToHistory($status, $comment, $notify); try { if ($notify && $comment) { $oldStore = Mage::getDesign()->getStore(); $oldArea = Mage::getDesign()->getArea(); Mage::getDesign()->setStore($order->getStoreId()); Mage::getDesign()->setArea('frontend'); } $order->save(); $order->sendOrderUpdateEmail($notify, $comment); if ($notify && $comment) { Mage::getDesign()->setStore($oldStore); Mage::getDesign()->setArea($oldArea); } } catch (Mage_Core_Exception $e) { $this->_fault('status_not_changed', $e->getMessage()); } return true; } 

addStatusToHistory这个函数可以同时修改订单状态和添加订单备注，并且添加一条订单历史记录，要比直接修改订单的状态值要合理。同时addComment这个接口还可以发送订单更新邮件给客户，是否发送取决于$notify这个参数。

也就是说，Magento提供的更新订单的接口还是挺完整的，可惜文档里没体现出来，会误导人。