11.4 员工喜好分析

接口URL

{开放平台域名地址}/openApi/open/hxgd/ordermerge/list 注：本接口为T+1查询接口，非特殊情况只允许查询近30天内的数据，且每次分页最多返回200条数据，更新开始时间与更新结束时间跨度不能超过7天，如首次对接需全量拉取数据，请联系百福得进行配置。

HTTP请求方式

POST

公共参数

字段	类型	是否必填	中文意描述
appId	String	是	由百福得向客户方发放
timestamp	String	是	毫秒级时间戳 防止重复攻击
sign	String	是	签名
version	String	否	业务接口版本号，如1.0.0

body参数

字段	类型	是否必填	中文意描述
currentPage	Integer	否	页码，默认1
itemsPerPage	Integer	否	页数，默认10，分页数量不能超过200
updateStartTime	String	是	更新开始时间，格式为yyyy-MM-dd HH:mm:ss
updateEndTime	String	是	更新结束时间，格式为yyyy-MM-dd HH:mm:ss，开始结束时间跨度不能超过7天

请求示例

POST /openApi/open/hxgd/ordermerge/list?appId=abc&timestamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
{
	"currentPage": 1,
	"itemsPerPage": 200,
	"updateStartTime": "2025-01-01 00:00:00",
	"updateEndTime": "2025-01-01 23:59:59"
}

返回参数说明

字段	类型	中文意描述
code	String	返回码
data	ResponseData	相应报文
msg	String	如果错误，返回错误信息

ResponseData：

字段	类型	中文意描述
orderNo	String	订单号
account	String	员工账号
orderStatus	String	订单状态：1、待支付；2、待收货；3、待使用；4、已完成；5、已取消；6、已支付
createTime	Integer	创建时间，格式为yyyy-MM-dd HH:mm:ss
updateTime	String	更新时间，格式为yyyy-MM-dd HH:mm:ss
totalAmount	BigDecimal	订单总金额（单位：元）
goodsList	List<MallOrderGoodsResponse>	商品列表

MallOrderGoodsResponse：

字段	类型	中文意描述
goodsId	String	商品ID
goodsName	String	商品名称
num	Integer	购买数量
channel	String	所属频道
imageUrl	String	商品图片

返回示例

success:

{
  "code": "0",
  "data": {
    "listObj": [
      {
        "orderNo": "21241105160600060589",
        "account": "lisi",
        "orderStatus": 5,
        "updateTime": "2024-11-05 16:06:02",
        "totalAmount": 5.00,
        "goodsList": [
          {
            "goodsId": "2440671",
            "goodsName": "测试商品_9999",
            "num": 1,
            "channel": "东福超市",
            "imageUrl": "https://oss-scm-goods-prd.dongfangfuli.com/merchantSpu/picture/12ec11e8bc8c4517a26f18805fdc9275.jpg"
          }
        ],
        "createTime": "2024-11-05 16:06:02"
      }
    ],
    "total": 1,
    "currentPage": 1,
    "itemsPerPage": 10
  },
  "msg": "success",
  "errMsg": null
}

fail:

{
  "code": "10016",
  "data": null,
  "msg": "签名错误"
}