## 全局定义:

    支付状态 pay_status:
        'PAYMENT_PAY_ALL' => 1,             // 已支付
        'PAYMENT_PAY_PART' => 3,            //部分支付
        'PAYMENT_REFUNDS_ALL' => 5,         //已退款
        'PAYMENT_REFUNDS_PART' => 4,        //部分退款
        'PAYMENT_PAY_NOTYET' => 0,          //未支付

    发货状态：ship_status
        'SHIPMENT_NOTYET' => 0,             //未发货
        'SHIPMENT_SHIPOUT' => 1,            //已发货
        'SHIPMENT_SHIPOUT_PART' => 2,       //部分发货
        'SHIPMENT_RETURN_PART' => 3,        //部分退货
        'SHIPMENT_RETURN' => 4,             //已退货

    参数中重复使用的参数键值说明：
        api_version     //接口版本号
        act             //接口名称
    配送方式：
        'payment' => '-1',   //当payment的值是-1时，代表是货到付款

1. ## ome:fetch_order_list 根据时间段和订单号拉取发生改变的订单

#### 入参：

    $arr = array(
        'orders'=>array('20120525179242','20120528112174'),   //订单号
        'status'=>array('active','dead','finish'),   // 订单状态 (可以考虑用矩阵定义的字符串)
        'dtline'=>array('2012-05-23 09:26:19','2012-05-23 10:26:19'),//两个元素指定时间区间;如果只有一个元素则第二个元素为当前时间
        '_offset_'=>0,//
        '_pagesize_'=>300, //每页大小，最多查询的数据行数
        'act' => 'ome:fetch_order_list',
        'date' => '2012-05-23 09:26:19',
        'return_data' => 'json',
        'api_version' => '2.0',  //版本号
    );

#### 返回：

    $return = array (
      'result' => 'success',
      'msg' => '',
      'info' =>
      array (
        0 =>
        array (
          'order_id' => '20090312138789',  //订单号
          ''status' => 'active',  //订单状态 (可以考虑用矩阵定义的字符串)
          'createtime' => 1236836229,       //下单时间
          'lastmtime' => 1236836229,       //最后更新时间
        ),
        1 =>
        array (
          'order_id' => '20090312133395',
          ''status' => 'dead',  //订单状态 (可以考虑用矩阵定义的字符串)
          'createtime' => 1236836229,
          'lastmtime' => 1236836345,
        ),
      ),
    );

2. ## ome:fetch_order_detail：根据订单号获取订单详情

#### 入参：

    $arr = array (
      'order_id' => '2009031d2133395',  //订单号
      'act' => 'ome:fetch_order_detail',
      'date' => '2012-05-23 09:26:19',
      'return_data' => 'json',
      'api_version' => '2.0',
    );

#### 返回：

    $return = array (
      'result' => 'success',
      'msg' => '',
      'info' => 矩阵定义的订单结构 http://open.shopex.cn/apidocs/data_structures/30/10/8.htm
    );

3. ## ome:update_order_info —— 根据订单号修改订单相关信息

#### 入参

        矩阵定义的订单结构 http://open.shopex.cn/apidocs/data_structures/30/10/8.htm

#### 返回

    $return = array (
      'result' => 'success',
      'msg' => NULL,
      'info' => '订单商品修改成功',
    );

4. ## ome:update_delivery —— 创建、修改发货（退货）单

#### 入参

        矩阵定义的发货单、退货单结构 http://open.shopex.cn/apidocs/data_structures/33/10/8.htm

#### 返回

    参数【type】 和 【delivery_id】的值不同时的结果如下：
    delivery_id = "" && 'type' => 'delivery':
        array (
          'result' => 'success',
          'msg' => NULL,
          'info' => '创建发货单成功',
        )；
    delivery_id = "120120531000001" && 'type' => 'delivery':
        array (
          'result' => 'success',
          'msg' => NULL,
          'info' => '更新发货单成功',
        )；
    delivery_id = "" && 'type' => 'return':
        array (
          'result' => 'success',
          'msg' => NULL,
          'info' => '创建退货单成功',
        )；
    delivery_id = "120120531000001" && 'type' => 'return':
        array (
          'result' => 'success',
          'msg' => NULL,
          'info' => '更新退货单成功',
        )；

5. ## 前端新建或修改订单打数据到矩阵 http://open.shopex.cn/apidocs/api/57/0/8.htm