轻流 x 聚水潭

应用场景

通过轻流应用表单实现与聚水潭进行对接

落地方案

原文画板

图文/视频演示

帮助文档

一、进行授权操作

1、访问该表单链接获取授权链接

https://qingflow.com/f/f5b57ef5

其中的username为聚水潭的账号

点击查询之后，会返回一个链接，请点击打开，然后进行授权操作

输入账号密码之后，正常会显示授权成功

二、获取access_token

1、postman测试

接口说明：用户获取调用聚水潭OpenApi的凭证token，授权后超过30天不使用，token会失效，需要重新进行授权
接口地址：https://connect.oalite.com/api/jst/accessToken
请求方式：GET
请求头（Header）：无
请求参数（查询参数）：

参数	是否必填	说明
username	是	聚水潭账号

请求示例

curl --location 'https://connect.oalite.com/api/jst/accessToken?username=1*848021***'

响应示例

{
    "errCode": 0,
    "data": {
        "access_token": "eb8d3cffcf4b4590aefc44e640906600"
    },
    "errMsg": null
}

2、鉴权配置

将postman测试成功之后，将相同配置放置在轻流鉴权配置即可

三、以查询聚水潭采购单为例

对应的接口文档：https://openweb.jushuitan.com/dev-doc?docType=6&docId=26

准备工作：

1、进行聚水潭参数加签操作

接口说明：用户调用聚水潭需要进行参数加签，包含时间戳，token等参数；该接口对加签进行了封装，返回内容可以直接用于调用聚水潭openApi接口
接口地址：https://connect.oalite.com/api/jst/signature
请求方式：POST
请求头（Header）：无
请求参数（查询参数）：

参数	是否必填	说明
access_token	是	鉴权接口获得的token

请求体：根据请求的聚水潭接口的请求体确定
以聚水潭采购单查询中的请求示例为例
实际业务场景可以根据接口文档的请求参数做具体调整

请求示例：以请求聚水潭采购单查询接口为例

curl --location 'https://connect.oalite.com/api/jst/signature?access_token=f**259de3e014575b34a8be1******' \
--header 'Content-Type: application/json' \
--data '{"so_ids":[],"page_index":1,"modified_begin":"2023-08-10","modified_end":"2023-08-16","page_size":30,"po_ids":[]}'

响应示例：

{
  "msg": "执行成功",
  "code": 0,
  "data": {
    "datas": [
      {
        "seller": "广州许诺化妆品有限公司123",
        "po_date": "2021-11-1815:31:49",
        "send_address": "上海上海市浦东新区华业公寓",
        "po_id": 113622,
        "item_type": "成品",
        "freight": 0,
        "remark": "",
        "tax_rate": 0,
        "finish_time": "",
        "labels": "",
        "receive_status": "",
        "wms_co_id": 0,
        "so_id": "",
        "purchaser_name": "肺棘",
        "confirm_date": "2021-11-1817:43:20",
        "term": "",
        "supplier_id": 763,
        "items": [
          {
            "i_id": "102025",
            "delivery_date": "",
            "field_3": "",
            "po_id": 113622,
            "price": 5999.4,
            "plan_arrive_qty": 0,
            "qty": 1,
            "name": "羊毛双面围巾",
            "sku_id": "1234560",
            "remark": "",
            "poi_id": 620961,
            "tax_rate": 0
          }
        ],
        "status": "Confirmed",
        "more_rate": 0.0
      }
    ],
    "page_index": 1,
    "has_next": false,
    "data_count": 2,
    "page_count": 1,
    "page_size": 2
  }
}