获取平台全部订单列表 - 西瓜猪开放平台

此订单接口不支持霸王餐,其余全部支持；此接口需要验签;pageSize=每次要获取多少条数据；offset=从第几条开始获取数据，第一次传0，后面每调用一次offset加上pageSize的值；例如每次请求我要获取20条数据，第一次请求时，offset=0，pageSize=20；第二次请求时，offset=20，pageSize=20；第二次请求时，offset=40，pageSize=20；该接口未返回总条数，当集合长度小于pageSize，就视为最后一页

禁止多线程调用；禁止多线程调用；禁止多线程调用；
订单同步逻辑
建议每隔1分钟，按照更新时间获取最近30分钟内的订单即可(无论什么状态的订单都能获取到)，每天凌晨按照创建时间获取一次最近3天的订单，只要你的服务器不宕机，订单就不会少同步
建议每隔1分钟，按照更新时间获取最近30分钟内的订单即可(无论什么状态的订单都能获取到)，每天凌晨按照创建时间获取一次最近3天的订单，只要你的服务器不宕机，订单就不会少同步
建议每隔1分钟，按照更新时间获取最近30分钟内的订单即可(无论什么状态的订单都能获取到)，每天凌晨按照创建时间获取一次最近3天的订单，只要你的服务器不宕机，订单就不会少同步

请求参数

Body 参数application/json

endTime

string

必需

结束时间；yyyy-MM-dd HH:mm:ss 格式

offset

integer

必需

从第几条开始查询,第一次传0,后面每次加上pageSize

pageSize

integer

页大小

必需

queryType

integer

必需

1：按支付时间 2：按更新时间 3：创建时间，4-结算时间；默认：3

startTime

string

必需

开始时间；yyyy-MM-dd HH:mm:ss 格式

status

integer

可选

订单统一状态，0：未付款 1：已付款 2：待结算 3：已结算 4：无效订单

sid

string

用户唯一标识

可选

sign

string

签名

必需

timeStamp

integer

时间戳

必需

示例

{
  "endTime": "2024-01-10 21:27:40",
  "offset": 0,
  "pageSize": 10,
  "queryType": 1,
  "startTime": "2024-01-01 21:27:40",
  "sign": "c4ca4238a0b923820dcc509a6f75849b",
  "timeStamp": 1714061925
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

cache

boolean

必需

code

integer

必需

data

array [object {23}]

必需

sid

string

用户唯一标识

必需

actName

string

活动名称

必需

parentOrderId

string

父订单号

必需

比如淘宝平台,用户在购物车多个商品一起下单时,父订单号就一致,子订单号不同

orderSn

string

子订单号；会重复

必需

京东的子订单那还会重复,全局唯一订单行使用xgzUuid；如淘宝平台,买家通过购物车购买的每个商品对应的订单编号，此订单编号并未在淘宝买家后台透出；其余平台若未透露出子订单号，则子订单号与父订单号相同

xgzUuid

string

西瓜猪平台全局唯一订单编号

必需

入库以及实现分销功能,根据此订单号来判断全局唯一

orderTitle

string

订单标题

必需

orderTime

string

下单时间

必需

payTime

string

支付时间

必需

modifiedTime

string

最后一次更换新时间

必需

payPrice

integer | number

支付金额

必需

xgzShareRate

integer

佣金率

必需

xgzShareFee

number

佣金

必需

status

integer

订单状态

必需

订单统一状态，0：未付款 1：已付款 2：待结算 3：已结算 4：无效订单；这里代表是的订单在官方那里的状态；订单为3，代表官方状态结算，并不是西瓜猪已结算

xgzSettleStatus

integer

西瓜猪平台是否已经将该笔佣金发放到平台余额

必需

订单状态等于3的时候,并不代表订单佣金已经发放到余额；比如淘宝官方，在用户确认收货后，就会进行结算，每月20号发放上个月所有结算的订单收入，因西瓜猪平台需要对账,西瓜猪目前将在每月的25号，发放上个月status=3的订单收入到您的余额。

xgzSettleTime

string

西瓜猪平台发放佣金时间

必需

佣金发放到余额

settleTime

string

官方结算时间

必需

platformType

string

平台标识taobao，pinduoduo；字母标识

必需

平台标识例如taobao，pinduoduo

sourcePlatform

string

订单来自哪个平台;中文标识

必需

picUrl

string

商品主图

必需

refundTag

integer

维权标签，0 含义为非维权 1 含义为维权订单

必需

维权订单,西瓜猪平台不给予结算;如您的业务涉及到分校需要,在您跟用户结算佣金时,需要判断下该笔订单是否维权

refundMoney

null

维权金额

必需

orderChannel

string

订单渠道

必需

订单渠道，主要为了告知开发者，哪些订单是由官方服务费的，在计算用户佣金时；做好预留，渠道目前包含以下，taobao( 官方有10%技术服务费) jingdong douyin( 官方有10%技术服务费) weipinhui pinduoduuo eleme( 官方有10%技术服务费) meituan didi qudao_1 无服务费 qudao_2 ( 有10%技术服务费) ；cpa 为CPA拉新订单，这些是指官方有无服务费，西瓜猪平台自身也会有10％的服务费

itemId

string | null

商品ID

必需

message

string

必需

示例

{
    "cache": false,
    "code": 0,
    "data": [
        {
            "sid": "170331529917170",
            "actName": "唯品会",
            "parentOrderId": "24010720959672",
            "orderSn": "24010720959672",
            "xgzUuid": "e35b6601b1a3495b92fe356ee915918b",
            "orderTitle": "【超值3包】家用纸巾3层抽纸面巾纸实惠擦手纸餐巾纸卫生纸",
            "orderTime": "2024-01-07 20:19:18",
            "payTime": "2024-01-07 20:40:09",
            "modifiedTime": "2024-03-20 16:24:44",
            "payPrice": 6,
            "xgzShareRate": 8,
            "xgzShareFee": 0.48,
            "status": 3,
            "xgzSettleStatus": 1,
            "xgzSettleTime": "2024-03-26 16:10:08",
            "settleTime": "2024-02-06 15:29:07",
            "platformType": "weipinhui",
            "sourcePlatform": "唯品会",
            "picUrl": "https://a.vpimg4.com/upload/merchandise/pdcpos/1100003853/2023/0703/147/f31d4cdc-f3d2-4eae-a50e-32645afc041b_750x750_50.jpg",
            "refundTag": 0,
            "refundMoney": null,
            "orderChannel": "weipinhui",
            "itemId": "2913051789893894"
        },
        {
            "sid": "170331529917170",
            "actName": "抖音",
            "parentOrderId": "6926008736813749772",
            "orderSn": "6926008736813749772",
            "xgzUuid": "69f2af33249348dbb4a4bb7dafb2ad32",
            "orderTitle": "【1元/包】420张/包大号抽纸餐巾纸擦手纸批发家庭实惠装卫生清洁纸",
            "orderTime": "2024-01-07 16:27:09",
            "payTime": "2024-01-07 16:27:09",
            "modifiedTime": "2024-03-20 16:24:44",
            "payPrice": 9.99,
            "xgzShareRate": 2,
            "xgzShareFee": 0.2,
            "status": 3,
            "xgzSettleStatus": 1,
            "xgzSettleTime": "2024-03-26 16:10:11",
            "settleTime": "2024-02-06 15:29:07",
            "platformType": "douyin",
            "sourcePlatform": "抖音联盟",
            "picUrl": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/gcwsZhgi_m_6feeb7d1611b53d8549bc8a173f9ef7b_sx_762533_www1500-1500",
            "refundTag": 0,
            "refundMoney": null,
            "orderChannel": "douyin",
            "itemId": null
        },
        {
            "sid": "170331529917170",
            "actName": "京东",
            "parentOrderId": "0",
            "orderSn": "285269808211",
            "xgzUuid": "f09e5c67d6c74c4994614de0f5ecfb0d",
            "orderTitle": "蓝漂星空系列抽纸卫生纸巾4D压花层加厚面巾纸【YH】【HG】 4层 1000张 2提",
            "orderTime": "2024-01-07 15:13:35",
            "payTime": "2024-01-07 15:13:44",
            "modifiedTime": "2024-03-20 16:24:44",
            "payPrice": 7.99,
            "xgzShareRate": 1,
            "xgzShareFee": 0.07,
            "status": 3,
            "xgzSettleStatus": 1,
            "xgzSettleTime": "2024-03-26 16:09:31",
            "settleTime": "2024-02-06 15:29:07",
            "platformType": "jingdong",
            "sourcePlatform": "京东联盟",
            "picUrl": "http://img11.360buyimg.com/n0/jfs/t1/178784/9/42168/146177/658a6902F67399638/1121db993047a409.jpg",
            "refundTag": 0,
            "refundMoney": null,
            "orderChannel": "jingdong",
            "itemId": null
        }
    ],
    "message": "操作成功"
}