# 淘宝订单接口-插旗备注接口API

**Repository Path**: elton_xia/taobao-order-flag

## Basic Information

- **Project Name**: 淘宝订单接口-插旗备注接口API
- **Description**: 适用于各种返利特卖、淘客等业务场景需求系统。

使用淘宝订单接口，可以对订单数据进行同步。同步后，可以做订单金额、订单状态等信息的校验。

服务器集群，R2资质，比市面上其它租用的接口要稳定、靠谱的多。

在官方基础上接口做了二层封装，完善的API文档，一般团队1天内即可完成从开发接入的完整流程。

独立的技术支持，专属维护。


- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 0
- **Created**: 2021-02-25
- **Last Updated**: 2025-11-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 淘店CRM电商API接口, 店铺插旗接口

## README

###完整对接流程
> 全面支持淘宝、京东、拼多多、抖音小店等覆盖全网订单接口、插旗备注接口，支持的应用场景有返利特卖、折扣特卖、0元活动等类似业务

![输入图片说明](junyu.png)

###插旗接口：新增/更新已有的订单备注
```
http://{domain}/api/v1/taobao/memo/order/update?token={token}&accessToken={授权码}
4.1.2 请求参数
名称	类型	是否必填	说明
payOrderNo	String	是	店铺掌柜旺旺号
flag	int	是	旗帜的颜色：0（灰色），1(红色), 2(黄色), 3(绿色), 4(蓝色), 5(粉红色)
content	string	否	备注内容，限制100个字节以内
请求示例
{
    "payOrderNo":"3306003444536392060",
    "flag":2,
    "content":"ces666"
}

4.1.3 响应结果
名称	类型	说明
code	Integer	响应代码，200成功，其他异常
message	String	响应消息
messageCode	Integer	消息代码
data	结果对象	授权信息
响应示例 

成功的返回RESPONSE示例：
 {
    "code": 200,
    "message": "success",
    "messsageCode": null,
    "data": {
        "result": true,    --【result:true说明备注成功】
        "apiMsg": null    --【result:true时为空，否则，会给到备注失败的具体提示】
    }
}

```

###订单信息：订单详情接口

```
http://{domain}/api/v1/taobao/fullorder?token={换成接口token}&payOrderNo={订单号}&accessToken={授权码}
1.1.2 请求参数
名称	类型	是否必填	说明
payOrderNo	String	是	淘宝订单号
请求示例
http://{domain}/api/v1/taobao/fullorder?token={换成接口token}&payOrderNo=4133069748128893403&accessToken=472d16a47560f1558a81356abe09fe1

响应示例 
{
    "code": 200,
    "message": "success",
    "messsageCode": null,
    "data": {
        "tid": "4133069748128893403",
        "sellerNick": null,
        "buyerNick": "t**",
        "numIid": "696552823130",
        "numIids": null,
        "picPath": "https://img.alicdn.com/bao/uploaded/i1/877695387/O1CN01TJBURh1pfIPeuzlRi_!!877695387.jpg",
        "payment": "39.0",
        "couponFee": 0,
        "discountFee": 0,
        "sellerRate": null,
        "postFee": null,
        "receiverName": "雨**",
        "receiverState": "河北省",
        "receiverCity": "邢台市",
        "receiverDistrict": "南宫市",
        "receiverTown": null,
        "receiverAddress": "段**镇徐马**街",
        "receiverMobile": "***********",
        "receiverPhone": "",
        "oaid": "1zRVyAYAr3nHdx2J49MqqKypCrOd7MH5t0qO1SBKPcrPsaNYCr4fAv3aJB2DxDTwzp7x37U",
        "buyerOpenUid": "AAEwCekzABHD55D7_dDTC34u",
        "consignTime": null,
        "receivedPayment": null,
        "num": null,
        "status": "TRADE_FINISHED",
        "price": "79.00",
        "hasPostFee": null,
        "totalFee": null,
        "created": "2024-11-19 09:47:49",
        "title": "男士内裤纯棉平角短裤潮牌夏季男生潮流全棉舒适性感运动四角裤衩",
        "payTime": "2024-11-19 09:48:13",
        "modified": null,
        "endTime": null,
        "buyerMessage": null,
        "buyerMemo": null,
        "sellerFlag": 5,
        "sellerMemo": "礼",
        "markDesc": null,
        "shippingType": null,
        "buyerCodFee": null,
        "adjustFee": null,
        "tradeFrom": null,
        "buyerRate": false,
        "refundStatus": "NO_REFUND",
        "apiDisabled": false,
        "errCode": null,
        "errMsg": null,
        "refund": false,
        "apiErr": false
    }
}
淘宝订单信息字段注释：
名称	类型	说明
tid	String	淘宝订单号
sellerNick	String	卖家昵称
buyerNick	String	买家昵称
numIid	numIid	商品ID 
picPath	String	商品主图地址
payment	String	实付金额
sellerRate	String	卖家是否已评价
postFee	String	邮费
oaid	String	用于解密收货人敏感信息
receiverName	String	收货人的姓名
receiverState	String	收货人的所在省份
receiverCity	String	收货人的所在城市
receiverDistrict	String	收货人的所在区
receiverTown	String	收货人的所在街道
receiverAddress	String	收货人的详细地址
receiverMobile	String	收货人的手机号码
receiverPhone	String	收货人的电话号码
consignTime	String	卖家发货时间
receivedPayment	String	卖家实际收到的支付宝打款金额;由于子订单可以部分确认收货，这个金额会随着子订单的确认收货而不断增加;
num	String	商品购买数量
status	String	订单状态；
TRADE_NO_CREATE_PAY(没有创建支付宝交易)
WAIT_BUYER_PAY(等待买家付款)
SELLER_CONSIGNED_PART(卖家部分发货)
WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款)
WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货)
TRADE_BUYER_SIGNED(买家已签收,货到付款专用)
TRADE_FINISHED(交易成功)
TRADE_CLOSED(付款以后用户退款成功，交易自动关闭)
TRADE_CLOSED_BY_TAOBAO(付款以前，卖家或买家主动关闭交易)
PAY_PENDING(国际信用卡支付付款确认中)
WAIT_PRE_AUTH_CONFIRM(0元购合约中)
PAID_FORBID_CONSIGN(拼团中订单或者发货强管控的订单，已付款但禁止发货)
price	String	商品价格
hasPostFee	String	是否包含邮费
totalFee	String	商品金额（商品价格乘以数量的总金额）
created	String	交易创建时间
title	String	宝贝标题
payTime	String	付款时间
modified	String	交易修改时间
endTime	String	交易结束时间
buyerMessage	String	买家留言
buyerMemo	String	买家备注
sellerFlag	String	卖家备注插旗
sellerMemo	String	卖家备注
refundStatus	String	退款状态；
WAIT_SELLER_AGREE(买家已经申请退款，等待卖家同意)
WAIT_BUYER_RETURN_GOODS(卖家已经同意退款，等待买家退货)
WAIT_SELLER_CONFIRM_GOODS(买家已经退货，等待卖家确认收货)
SELLER_REFUSE_BUYER(卖家拒绝退款)
CLOSED(退款关闭)
SUCCESS(退款成功)
isRefund	String	 是否退款


```