客如云 API
  1. 供应链基础数据1.0
客如云 API
  • 平台简介
  • 对接流程-API接口对接流程及操作步骤(不上架服务市场)
  • 对接流程-API接口对接流程及操作步骤(上架服务市场)
  • 认证指南-服务商认证
  • 认证指南-品牌商认证
  • 接口能力大图
  • https对接说明
  • 接口请求公共参数
  • 响应参数
  • V2签名规则
  • 订单取消原因表
  • 订单状态
  • 错误码
  • 订单配送状态
  • 订单支付状态表
  • 回调接口编码
  • 支付机构代码
  • 接收菜品分类变更通知
  • 接收菜品变更通知
  • 订单状态推送通知收费
  • 自配送场景介绍
  • 客如云下发配送通知
  • 订单配送状态通知
  • 优惠券核销通知接口-上行
  • 第三方券核销介绍
  • 登录成功回调收费
  • 获取授权码code收费
  • 新手指南
    • 平台简介
    • 对接流程-API接口对接流程及操作步骤(不上架服务市场)
    • 对接流程-API接口对接流程及操作步骤(上架服务市场)
    • 认证指南-服务商认证
    • 认证指南-品牌商认证
  • 接口能力大图
    • 接口能力大图
  • 公共说明
    • https对接说明
    • 接口请求公共参数
    • 响应参数
    • V2签名规则
    • 附录
      • 订单取消原因表
      • 订单状态
      • 错误码
      • 订单配送状态
      • 订单支付状态表
      • 回调接口编码
      • 支付机构代码
    • 获取门店token
  • 接口列表
    • 门店信息
      • 获取服务下可用门店
      • 获取门店列表
      • 获取门店信息
      • 获取门店经营时间
      • 查询门店营业状态
      • 修改门店营业状态
      • 查询桌台信息
      • 附加费配置查询接口
      • 支付类型查询
      • 门店设备列表查询接口
      • 门店设备状态推送接口
    • 菜品
      • 接收菜品分类变更通知
      • 接收菜品变更通知
      • 菜品分类信息查询
      • 菜品父级信息查询
      • 菜品分类查询
      • 菜品分页查询
      • 菜品精确查询
      • 批量修改门店菜品售卖数量
    • 订单信息
      • 订单状态推送通知收费
      • 查询订单详情
      • 查询订单列表
    • 后厨管理服务
      • 后厨菜品制作状态变更推送
    • 配送服务
      • 自配送场景介绍
      • 客如云下发配送通知
      • 订单配送状态通知
      • 商家自配送状态推送
    • 会员1.0
      • 会员基本信息1.0
        • 创建顾客
        • 创建/升级会员
        • 查询会员实体卡列表
        • 会员详情查询
        • 修改会员详情
        • 查询品牌下会员等级
        • 修改会员等级信息
      • 会员登录1.0
        • 会员登录
        • 会员登录二维码
        • 获取免登录token
      • 会员充值1.0
        • 会员充值接口
        • 查询门店储值消费金额
        • 会员充值/消费记录查询
      • 积分 1.0
        • 会员积分增加
        • 会员积分扣减
    • 优惠券1.0
      • 优惠券核销通知接口-上行
      • 查询优惠券列表
      • 查询券模板列表
      • 查询优惠券详情
      • 查询门店营销规则
      • 券模板发券接口
      • 客如云券核销
    • 第三方券核销
      • 第三方券核销介绍
      • 券查询
      • 券核销
      • 券反核销
    • 供应链1.0
      • 供应链基础数据1.0
        • 查询供应链物品接口
          POST
        • 查询仓库列表
          POST
        • 查询物品分类
          POST
        • 查询供应链物品库存
          POST
        • 查询商品库存收费
          POST
        • 接收商品库存变更
          POST
        • 查询供应商类别
          POST
        • 查询供应商列表
          POST
        • 查询交易记录
          POST
        • 获取交易凭证
          POST
        • 查询商户余额
          POST
      • 采购单据1.0
        • 查询采购入库单列表
        • 查询采购订单收费
        • 查询采购入库单明细
        • 查询采购退货单明细
        • 采购退货单列表收费
      • 销售单据1.0
        • 查询非销售单出库明细收费
      • 库存单据1.0
        • 入库单保存
        • 入库详情查询
        • 入库分页查询
        • 收货单详情
        • 收货单分页查询
        • 调拨单详情查询
        • 调拨单分页查询
        • 出库单保存
        • 出库详情查询
        • 出库分页查询
        • 配送签收单修改保存
        • 查询配送签收单详情
        • 配送签收单分页查询
        • 退回单详情查询
        • 退回单分页查询
        • 退回入库单分页查询
        • 退回入库单详情查询
        • 盘点单详情查询
        • 盘点单分页查询
        • 报废单详情查询收费
        • 报废单分页查询
    • 支付收银服务
      • 支付状态查询
      • 扫码支付(主扫)
      • 扫码支付(被扫)
      • 退款状态查询
      • 退款申请
    • OAUTH 授权服务
      • 登录成功回调收费
      • 获取授权码code收费
      • 获取用户信息
      • 获取token
  1. 供应链基础数据1.0

获取交易凭证

测试环境
https://gldopenapi.keruyun.com
测试环境
https://gldopenapi.keruyun.com
POST
/open/v1/supplyChain/transactionVoucher
(下行接口)第三方合作方调用此接口,获取交易凭证 .
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://gldopenapi.keruyun.com/open/v1/supplyChain/transactionVoucher?appKey=&shopIdenty=&brandId=&version=&timestamp=&sign=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "shopId": 46,
    "bizType": 66,
    "startTime": 191586302120,
    "endTime": 1214751147837,
    "start": 57,
    "limit": 6,
    "orderType": 51,
    "wareHouseId": 81,
    "operationType": 20,
    "referenceNo": "ea",
    "creatorName": "活手阶因"
}'
响应示例响应示例
{
  "code": 0,
  "message": "成功[OK]",
  "messageUuid": "f2ba9732-44da-4890-bc74-b31493ba9938",
  "result": {
    "data": [
      {
        "bizType": 1,
        "brandId": 5200,
        "brandName": "scm正式",
        "commercialName": "scm正式一",
        "createTime": 1499073884000,
        "creatorName": "system",
        "fromWmId": 15,
        "fromWmName": "仓库一",
        "operationType": 1,
        "orderCreateTime": 1499073882000,
        "orderCreatorName": "system",
        "price": 18,
        "qty": 0.2,
        "referenceNo": "CK201707030021",
        "skuCode": "SKU0276",
        "skuName": "AAAAAAAAAAAAAA",
        "toWmId": 0,
        "toWmName": "",
        "totalPrice": 3.6,
        "uom": "kg"
      }
    ],
    "num": 10,
    "total": 123
  }
}

请求参数

Query 参数
appKey
string 
必需
开发者申请服务客如云分配的appKey
默认值:
{{appKey}}
shopIdenty
string 
必需
客如云门店id (门店维度接口传递门店ID)
默认值:
{{shopIdenty}}
brandId
string 
必需
客如云品牌id(品牌授权的接口传递品牌ID)
默认值:
{{brandId}}
version
string 
必需
版本,默认2.0(1.0版本仍可用)
默认值:
2.0
timestamp
string 
必需
时间戳,单位:秒,时间戳校验签名,开放平台校验签名时用此参数和服务器当前时间戳对比不能大于300秒,我方服务器使用阿里云授时中心
默认值:
{{timestamp}}
sign
string 
必需
签名,64位长度的字符串,获取规则详见签名规则
默认值:
{{sign}}
Body 参数application/json
shopId
integer 
必需
客如云门店ID,(如果是品牌,请传-1),默认-1
bizType
integer 
必需
业务类型,0入库 1出库
startTime
integer 
必需
确认开始时间,时间戳
endTime
integer 
必需
确认结束时间,时间戳 注: endTime与startTime相差时间不能超过1个月
start
integer 
偏移量
必需
limit
integer 
单页条数
必需
wareHouseId
integer 
仓库编号
可选
operationType
integer 
可选
操作类型,1:确认 ,-1:反确认 若为空则查询全部
orderType
integer 
可选
0 采购入库单 1采购退货单 2退回单 3移库单 4出库单 5入库单 6自产入库单 7盘点单 8收货单 9销售收货单 10报废单 若为空则查询全部
creatorName
string 
操作人
可选
referenceNo
string 
单据号
可选
示例

返回响应

🟢200成功
application/json
Body
code
integer 
必需
返回编码,详见错误码;
message
string 
返回信息
必需
messageUuid
string 
消息uuid
必需
result
object 
可选
返回响应数据,详见SupplyChainPageResponse
data
array [object {21}] 
交易凭证列表
可选
num
integer 
本次请求返回条数
必需
total
integer 
总条数
必需

【如客云】API开发者 微信交流群

用微信扫右侧二维码,加入【如客云】API开发者 交流群,互助沟通

扫码加入交流群
上一页
查询交易记录
下一页
查询商户余额
Built with