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提供的更新订单的接口还是挺完整的，可惜文档里没体现出来，会误导人。