• pdd.order.basic.list.get订单基础信息列表查询接口(拼多多店铺订单列表查询接口)代码对接教程


    pdd.order.basic.list.get订单基础信息列表查询接口(拼多多店铺订单列表查询接口)代码对接教程如下:

    1.公共请求参数

    参数名称参数类型是否必填参数描述 (代码接口教程wx19970108018)
    typeString必填API接口名称(点击获取请求key和secret)
    client_idString必填POP分配给应用的client_id
    access_tokenString非必填通过code获取的access_token
    timestampString必填UNIX时间戳,单位秒,需要与拼多多服务器时间差值在10分钟内
    data_typeString非必填响应格式,即返回数据的格式,JSON或者XML(二选一),默认JSON,注意是大写
    versionString非必填API协议版本号,默认为V1,可不填
    signString必填API输入参数签名结果,签名算法参考开放平台接入指南第三部分底部。

    2.请求参数说明

    参数接口参数类型是否必填说明
    end_confirm_atINTEGER必填必填,成交时间结束时间的时间戳,指格林威治时间 1970 年 01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时 00 分 00 秒)起至现在的总秒数 PS:开始时间结束时间间距不超过 24 小时
    order_statusINTEGER必填发货状态,1:待发货,2:已发货待签收,3:已签收 5:全部
    pageINTEGER必填返回页码 默认 1,页码从 1 开始 PS:当前采用分页返回,数量和页数会一起传,如果不传,则采用 默认值
    page_sizeINTEGER必填返回数量,默认 100。最大 100
    refund_statusINTEGER必填售后状态 1:无售后或售后关闭,2:售后处理中,3:退款中,4: 退款成功 5:全部
    start_confirm_atINTEGER必填必填,成交时间开始时间的时间戳,指格林威治时间 1970 年 01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时 00 分 00 秒)起至现在的总秒数
    trade_typeINTEGER非必填订单类型 0-普通订单 ,1- 定金订单
    use_has_nextBOOLEAN非必填是否启用has_next的分页方式,如果指定true,则返回的结果中不包含总记录数,但是会新增一个是否存在下一页的的字段,通过此种方式获取增量交易,效率在原有的基础上有80%的提升。

     3.返回参数

    1. 参数接口 参数类型 例子 说明
    2. order_basic_list_get_response OBJECT 1 请求response
    3. has_next BOOLEAN 是否存在下一页
    4. order_list OBJECT[] 1 订单信息列表
    5. cat_id_1 LONG 1 商品一级分类
    6. cat_id_2 LONG 1 商品二级分类
    7. cat_id_3 LONG 1 商品三级分类
    8. cat_id_4 LONG 1 商品四级分类
    9. confirm_time STRING 1 成交时间
    10. delivery_home_value DOUBLE 1 送货入户费用 单位:元
    11. delivery_install_value DOUBLE 1 送货入户并安装费用 单位:元
    12. discount_amount DOUBLE 1 折扣金额,单位:元,折扣金额=平台优惠+商家优惠+团长免单优惠金额
    13. goods_amount DOUBLE 1 商品金额,单位:元,商品金额=商品销售价格*商品数量-改价金额(接口暂无该字段)
    14. home_delivery_type INTEGER 1 送货入户并安装服务 0-不支持送货,1-送货入户不安装,2-送货入户并安装
    15. home_install_value DOUBLE 1 上门安装费用 单位:元
    16. is_lucky_flag INTEGER 1 是否是抽奖订单,1-非抽奖订单,2-抽奖订单
    17. item_list OBJECT[] 1 订单商品列表
    18. goods_count INTEGER 1 商品数量
    19. goods_id STRING 1 商品编码
    20. goods_img STRING 1 商品图片
    21. goods_name STRING 1 商品名称
    22. goods_price DOUBLE 1 商品单件 单价:元
    23. goods_spec STRING 1 商品规格
    24. outer_goods_id STRING 1 商品维度外部编码,注意:编辑商品后必须等待商品审核通过后方可生效,订单中商品信息为交易快照的商品信息。
    25. outer_id STRING 1 sku维度商家外部编码,注意:编辑商品后必须等待商品审核通过后方可生效,订单中商品信息为交易快照的商品信息。
    26. sku_id STRING 1 商品sku编码
    27. order_sn STRING 1 订单编号
    28. order_status INTEGER 1 订单状态
    29. pay_amount DOUBLE 1 支付金额,单位:元,支付金额=商品金额-折扣金额+邮费
    30. platform_discount DOUBLE 1 平台优惠金额,单位:元
    31. postage DOUBLE 1 邮费,单位:元
    32. refund_status INTEGER 1 售后状态
    33. risk_control_status INTEGER 订单审核状态(0-正常订单, 1-审核中订单)
    34. seller_discount DOUBLE 1 商家优惠金额,单位:元
    35. step_order_info OBJECT 1 { "step_discount_amount":4, "advanced_paid_fee":1, "step_paid_fee":1.1, "step_trade_status":2 }
    36. advanced_paid_fee DOUBLE 1 已付定金 单位:元
    37. step_discount_amount DOUBLE 1 膨胀金额 单位:元
    38. step_paid_fee DOUBLE 1 分阶段已付金额 单位:元
    39. step_trade_status INTEGER 1 定金订单状态:step_trade_status 枚举:0-定金未付尾款未付、1-定金已付尾款未付、2-定金已付尾款已付
    40. trade_type INTEGER 1 订单类型 0-普通订单 ,1- 定金订单
    41. updated_at STRING 1 订单的更新时间
    42. total_count INTEGER 1 订单总数

    4.请求示例(CURL、PHP 、PHPsdk 、Java 、C# 、Python…)

    1. package com.pdd.pop.sdk.http.demo;
    2. import com.pdd.pop.sdk.common.util.JsonUtil;
    3. import com.pdd.pop.sdk.http.api.pop.request.PddOrderBasicListGetRequest;
    4. import com.pdd.pop.sdk.http.api.pop.response.PddOrderBasicListGetResponse;
    5. import com.pdd.pop.sdk.http.PopClient;
    6. import com.pdd.pop.sdk.http.PopHttpClient;
    7. public class PopClientDemo {
    8. public static void main(String[] args) throws Exception {
    9. String clientId = "your clientId";
    10. String clientSecret = "your clientSecret";
    11. String accessToken = "your accessToken";
    12. PopClient client = new PopHttpClient(clientId, clientSecret);
    13. PddOrderBasicListGetRequest request = new PddOrderBasicListGetRequest();
    14. request.setEndConfirmAt(1);
    15. request.setOrderStatus(1);
    16. request.setPage(1);
    17. request.setPageSize(1);
    18. request.setRefundStatus(1);
    19. request.setStartConfirmAt(1);
    20. request.setTradeType(1);
    21. request.setUseHasNext(false);
    22. PddOrderBasicListGetResponse response = client.syncInvoke(request, accessToken);
    23. System.out.println(JsonUtil.transferToJson(response));
    24. }
    25. }

    5.响应示例

    1. {
    2. "order_basic_list_get_response": {
    3. "has_next": false,
    4. "order_list": [
    5. {
    6. "cat_id_1": 1,
    7. "cat_id_2": 1,
    8. "cat_id_3": 1,
    9. "cat_id_4": 1,
    10. "confirm_time": "1",
    11. "delivery_home_value": 1.0,
    12. "delivery_install_value": 1.0,
    13. "discount_amount": 1.0,
    14. "goods_amount": 1.0,
    15. "home_delivery_type": 1,
    16. "home_install_value": 1.0,
    17. "is_lucky_flag": 1,
    18. "item_list": [
    19. {
    20. "goods_count": 1,
    21. "goods_id": "1",
    22. "goods_img": "1",
    23. "goods_name": "1",
    24. "goods_price": 1.0,
    25. "goods_spec": "1",
    26. "outer_goods_id": "1",
    27. "outer_id": "1",
    28. "sku_id": "1"
    29. }
    30. ],
    31. "order_sn": "1",
    32. "order_status": 1,
    33. "pay_amount": 1.0,
    34. "platform_discount": 1.0,
    35. "postage": 1.0,
    36. "refund_status": 1,
    37. "risk_control_status": 0,
    38. "seller_discount": 1.0,
    39. "step_order_info": {
    40. "advanced_paid_fee": 1.0,
    41. "step_discount_amount": 1.0,
    42. "step_paid_fee": 1.0,
    43. "step_trade_status": 1
    44. },
    45. "trade_type": 1,
    46. "updated_at": "1"
    47. }
    48. ],
    49. "total_count": 1
    50. }
    51. }

  • 相关阅读:
    隐藏在背后的真相——数据存储的方式(上)
    绿源:“老大哥”冲刺IPO,新的故事如何讲?
    【AI】《动手学-深度学习-PyTorch版》笔记(二十):图像增强、微调
    【Linux】常用命令总结(简略版)
    Botowski:SEO友好的AI内容生成器
    go:快速添加接口方法及其实现
    已经安装tensorflow,仍报错No module named ‘tensorflow‘
    创建WCF服务
    qt模拟鼠标事件
    mac安装redis及springboot整合redis,简单快速
  • 原文地址:https://blog.csdn.net/Andyfu2019/article/details/126162392