返回订单API

dangdang.order.cancel

取消订单(已下架)

  • 功能描述:商家都可以取消订单,商家一次只能取消一张订单。

    a)如果是当当代发订单,在当当快递系统入库前,允许商家取消订单,否则不允许取消订单,并返回不允许取消COD订单错误。

    b)如果是商家自发订单,在手动发货前,都允许取消订单。

    支持的数据格式:XML

    HTTP请求方式:GET

    版本:v1.0 v2.0

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:


    变量名称 变量命名 变量类型 是否必填 示例 说明

    订单编号

    o

    long

    12345678


    取消原因

    cr

    int

    800003

    只能填写数字:800003-800005
    800003全部缺货
    800004无法送达
    800005顾客要求退款


     

  • 商家接收到的XML文件格式说明:


    变量名称 变量命名 变量类型 说明

    处理结果

    Result

    -

    处理结果含:
    订单号
    操作码
    操作结果信息

    操作成功例子:
    <Result>
    <orderID>1562916335</orderID>
    <operCode>0</operCode>
    <operation>订单取消成功</operation>
    </Result>

    操作失败例子:
    <Result>
    <orderID>1562916337</orderID>
    <operCode>3</operCode>
    <operation>订单取消原因错误</operation>
    </Result>

    订单号

    orderID

    long


    操作码

    operCode

    int

    0,35,36,500,605

    操作结果信息

    operation

    int

    操作结果信息为下列中的一种:
      0 :操作成功
      35:订单编号错误
      36:订单取消原因错误
      605:订单状态决定该订单不能进行操作
    411=gshopID不存在
    420=未开通
    421=停用
    422=到期
    423=关闭
    424=欠费
    425=终止合作
    其它错误则返回如下结果:
      500:系统异常


     

  • 商家接收到的XML文件实例:

    <?xml version="1.0" encoding="GBK"?>

    <response>

     <functionID>dangdang.order.cancel</functionID>

     <time>2009-03-20 15:10:50</time>

    <Result>

    <orderID>1562916337</orderID>

    <operCode>0</operCode>

     <operation>订单取消成功</operation>

    </Result>

    </response>