文档中心 > API类目 > 零售终端API

tmall.jiazhuang.fulfillment.sync (家装涂刷履约数据回流接口)

家装涂刷履约数据回流接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
urls String [] 可选
  • 最大列表长度:10
  • 履约图片url
    seller_id Number 必须 1223 卖家id
    trade_order_id String 可选 2496456614746916910 新零售火凤凰尾款订单号
    description String 可选 描述文案
  • 最大长度:200
  • 说明文案;不超过200字符
    telephone String 可选 13188887654
  • 最大长度:20
  • 联系电话
    fulfillment_type String 必须 涂刷
  • 最大长度:10
  • 履约类型:涂刷,定制,装修监理
    fulfillment_role_type String 可选 工程经理
  • 最大长度:20
  • 履约角色类型,不超过20字符
    fulfillment_time String 必须 2022-3-4 15:30:30
  • 最大长度:20
  • 履约时间,格式:2022-3-4 15:30:30
    fulfillment_node_name String 必须 订单受理
  • 最大长度:20
  • 履约节点名称;节点名称:订单受理,签约报价,施工进场,工程跟踪,验收结算;存在工程跟踪,可能存在多次传输;当前是无序的,按更新时间来排序
    fulfillment_role_name String 可选 工程经理
  • 最大长度:20
  • 履约角色名称,不超过20字符
    out_id String 可选 1234522 外部单号id(如客资id等)

    响应参数

    名称 类型 示例值 描述
    result ResultDO 返回结果
    • data
    • SyncFulfillmentRespDTO
    • 响应数据
    • └ trade_order_id
    • String
    • 2496456614746916910
    • 交易主订单号
    • └ fulfillment_order_id
    • String
    • 122333
    • 履约单Id号
    • └ err_code
    • String
    • INVALID_PARAM
    • 错误码
    • └ success
    • Boolean
    • false
    • 接口调用结果
    • └ err_msg
    • String
    • 参数非法
    • 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallJiazhuangFulfillmentSyncRequest req = new TmallJiazhuangFulfillmentSyncRequest();
    req.setUrls("");
    req.setSellerId(1223L);
    req.setTradeOrderId("2496456614746916910");
    req.setDescription("描述文案");
    req.setTelephone("13188887654");
    req.setFulfillmentType("涂刷");
    req.setFulfillmentRoleType("工程经理");
    req.setFulfillmentTime("2022-3-4 15:30:30");
    req.setFulfillmentNodeName("订单受理");
    req.setFulfillmentRoleName("工程经理");
    req.setOutId("1234522");
    TmallJiazhuangFulfillmentSyncResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_jiazhuang_fulfillment_sync_response>
        <result>
            <data>
                <trade_order_id>2496456614746916910</trade_order_id>
                <fulfillment_order_id>122333</fulfillment_order_id>
            </data>
            <err_code>INVALID_PARAM</err_code>
            <success>false</success>
            <err_msg>参数非法</err_msg>
        </result>
    </tmall_jiazhuang_fulfillment_sync_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>

    错误码解释

    错误码 错误描述 解决方案
    TRADE_ORDER_NOT_EXIST 订单不存在 正常错误码
    FULFILLMENT_ORDER_NOT_VALID 履约阶段非法 正常业务逻辑拦截
    TRADE_DEPOSIT_ORDER_NOT_EXIST 订单不存在预约单 确认传递订单是否有效

    API工具

    如何获得此API

    FAQ

    返回
    顶部