文档中心 > API类目 > 淘宝交易API

taobao.trade.memo.update (修改交易备注)

需要商家或以上权限才可调用此接口,可重复调用本接口更新交易备注,本接口同时具有添加备注的功能

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tid Number 必须 123456789 交易编号
memo String 可选 交易备注 卖家交易备注。最大长度: 1000个字节
flag Number 可选 1 卖家交易备注旗帜,可选值为:0(灰色), 1(红色), 2(黄色), 3(绿色), 4(蓝色), 5(粉红色),默认值为0
reset Boolean 可选 true
  • 默认值:false
  • 是否对memo的值置空若为true,则不管传入的memo字段的值是否为空,都将会对已有的memo值清空,慎用;若用false,则会根据memo是否为空来修改memo的值:若memo为空则忽略对已有memo字段的修改,若memo非空,则使用新传入的memo覆盖已有的memo的值

    响应参数

    名称 类型 示例值 描述
    trade Trade 更新交易的备注信息后返回的Trade,其中可用字段为tid和modified
    • └ tid
    • Number
    • 2231958349
    • 交易编号 (父订单的交易编号)
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 交易修改时间(用户对订单的任何修改都会更新此字段)。格式:yyyy-MM-dd HH:mm:ss

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TradeMemoUpdateRequest req = new TradeMemoUpdateRequest();
    req.setTid(123456789L);
    req.setMemo("交易备注");
    req.setFlag(1L);
    req.setReset(true);
    TradeMemoUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <trade_memo_update_response>
        <trade>
            <tid>2231958349</tid>
            <modified>2000-01-01 00:00:00</modified>
        </trade>
    </trade_memo_update_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-permission 权限不够、非法访问
    isv.trade-not-exist 交易不存在 传人正确的订单号
    isv.invalid-parameter:memo 备注错误 备注错误,一般是备注格式太长,根据api文档该字段要求,重新入参
    isp.trade-service-failed 交易接口服务错误 交易接口服务错误,稍后重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部