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

taobao.trade.memo.add (对一笔交易添加备注)

根据登录用户的身份(买家或卖家),自动添加相应的交易备注,不能重复调用些接口添加备注,需要更新备注请用taobao.trade.memo.update

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tid Number 必须 123456789 交易编号
memo String 必须 交易备注 交易备注。最大长度: 1000个字节
flag Number 可选 1
  • 默认值:0
  • 交易备注旗帜,可选值为:0(灰色), 1(红色), 2(黄色), 3(绿色), 4(蓝色), 5(粉红色),默认值为0
    tag String 可选 红色旗子 插旗备注

    响应参数

    名称 类型 示例值 描述
    trade Trade 对一笔交易添加备注后返回其对应的Trade,Trade中可用的返回字段有tid和created
    • └ tid
    • Number
    • 2231958349
    • 交易编号 (父订单的交易编号)
    • └ created
    • 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);
    TradeMemoAddRequest req = new TradeMemoAddRequest();
    req.setTid(123456789L);
    req.setMemo("交易备注");
    req.setFlag(1L);
    req.setTag("红色旗子");
    TradeMemoAddResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <trade_memo_add_response>
        <trade>
            <tid>2231958349</tid>
            <created>2000-01-01 00:00:00</created>
        </trade>
    </trade_memo_add_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.trade-not-exist trade 不存在
    isv.invalid-parameter 参数无效,格式不对、非法值、越界等
    isv.invalid-permission 必须是此交易的卖家或买家才能添加交易备注 查看是否程序出问导致添加交易备注的交易不属于该卖家,出现错误不要重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部