龙收银开放平台标准API接口文档

openapi


下单创建订单

简要描述:

  • 下单创建订单

请求URL:

  • http://192.168.12.67/s1/openapi/openapi/base/order/create

请求方式:

  • POST

请求类型:

  • application/json

加密类型:

  • RSA

    请求示例

  {
    "ispInfoId": 10001,
    "data":
"EZuaEYHl9CmijAsMmODB9lKY++8hXrIYMAknd5B8rhJuTu2ASvt2LoW8eBvko0hPv+fY9r3KCrELcyAuZsupFtbN+3J1j7nApomGeMq9IEk+BLzHhxZfdvCNTaVv/4tCv0jzEYEXe3hJsv/wzJS5Q6+EkcH81PI2yhHkcey4cTErhR/wmMs7LKl8kiG045c2E5yAoA+4Apm198Sayke+MP9+GuhhZeAZuDmxjyuS6ThnUXYCqH1vBzRBrrQdCeeAjVc3EX19P5/Z6u4YvEsOkHfIupbHJZ0BBk60j8md+lpPIvDmyXwYQGd/RUAx4umcGD1WwQYr5spTsD/Rpb8DzITMPm9PhiAfPBvR0yLItFgCpDOKlVqoNVOTRvA2lPKcKnCgk/fNxxZKS9DyQxqWDs1fIrCJnlrzmQZRNqjOF31QuoGH2JpLH7HZO5tXjopfVZw7s3WDznYXVi20EJ9OMYekIh9I2DSFd88HXK7CeKvLL5RebmT7ji1wPecoE08IereB59PU7OvDfdn3hTczxqMAmPprjDS2rmRrR5sCIzKH0QTICyprQmxf/3DVrn3elQqdRo4cKYe95mGmSmmxjS9UDpqBGfd0yfxueIf3SAv2Xmx+uhVy4sT/aubu/rcq7tCTkkudl6EfaDfbgh2wbQ36YjDGj7Pkba8jVIwCh4k="
  }

data

参数名 必选 类型 说明
ispInfoName string 服务商名称
printType Integer 打印类型 0:外卖单 1:堂食单
thirdSerialNo string 第三方流水号(请求微信/支付宝支付)
orderType Integer 订单类型 1:下单 2:退单 3:部分退 此处为1
thirdTransactionId string 第三方交易ID
createShopId Integer 店铺ID
origTotal Integer 总原价(分)
lastTotal Integer 实收(分)
totalDiscount Integer 总优惠
createTime string 订单创建时间 yyyy-MM-dd HH:mm:ss
settleStatus Integer 订单状态(0:未支付 1:已支付)
settleInfo String 第三方订单牌号信息
remark String 整单备注
takeMoney Integer 收款额
giveChange Integer 找零
itemInfoList List<ThirdOrderItemCnd> 品项信息列表
paywayInfoList List<ThirdOrderPaywayCnd> 支付方式信息列表
ticketInfoList List<ThirdOrderTicketCnd> 券信息列表
crmTickList List<ThirdOrderCrmTickCnd> 消费券信息列表
thirdOrderUserCnd ThirdOrderUserCnd 用户信息
thirdOrderMembersCnd ThirdOrderMembersCnd 会员信息
activityList List<ThirdSettlementActivity> 活动列表

ThirdOrderItemCnd

参数名 必选 类型 说明
id Long 商品ID
name String 菜品名称
unitId Long 单位id
itemClassId Long 分类ID
origPrice Integer 原价(分)
lastPrice Integer 实收(分)
costPrice Integer 成本价 (分)
qty number 数量
itemType Integer 菜品类型(0、菜品;1、套餐;2、打包盒)
pkgList List<ThirdOrderPkgCnd> 套餐明细
raisePrice Integer 套餐加价
methodVoList List<SettlementItemMethodVo> 做法列表

SettlementItemMethodVo

参数名 必选 类型 说明
id Long 品项制作方法ID
type Integer 制作方法类型:1、共有做法;2、私有做法;3、自定义
methodName String 做法名称
remark String 做法描述(type = 3时传入)
price BigDecimal 制作方法价格
addPri BigDecimal 做法加价
methodQty BigDecimal 做法数量,入参使用

ThirdOrderPkgCnd

参数名 必选 类型 说明
id Long 商品ID
name String 菜品名称
unitId Long 单位id
itemClassId Long 分类ID
origPrice Integer 原价(分)
lastPrice Integer 实收(分)
costPrice Integer 成本价 (分)
qty number 数量
itemType Integer 菜品类型(0、菜品;1、套餐;2、打包盒)
raisePrice Integer 套餐加价
methodVoList List<SettlementItemMethodVo> 套餐做法列表

ThirdOrderPaywayCnd

参数名 必选 类型 说明
paywayId Long 支付方式ID(1、现金; 2、银行卡; 4、微信;5、支付宝; 8、会员(储值); 9、会员(积分); 10、会员(券))
payMoney Integer 支付金额(分)

ThirdOrderTicketCnd

参数名 必选 类型 说明
id Long 劵id
ticketName String 劵的名称
fullMoney Integer 劵满足多少钱可以使用(分)
offMoney Integer 劵减免金额(分)
ticketCount Integer 用劵张数
isRecordIncome Boolean 是否计入收入
ratio number 劵抵扣率

ThirdOrderCrmTickCnd

参数名 必选 类型 说明
couponType Integer 券类型
couponCode String 券code
couponUseMoney BigDecimal 券实际抵扣金额
couponTrueMoney BigDecimal 券的实际金额(面值)
couponDiscMoney BigDecimal 券优惠金额
couponName String 券名称
couponBuyMoney BigDecimal 券购买金额

ThirdOrderMembersCnd

参数名 必选 类型 说明
cardNo Long 卡号
cardAllMoney BigDecimal 会员卡消费总金额
consumeMoney BigDecimal 会员卡消费金额
scoreConverMoney BigDecimal 会员卡积分转消费金额
couponUseMoney BigDecimal 券的抵用金额
cardType BigDecimal 卡型
cardMoney BigDecimal 本次当前的余额
cardScore BigDecimal 本次当前的积分
freeMoney BigDecimal 本次赠送金额
mobile String 会员电话号
addScore String 本次产生的积分
consumeIntegralMoney String 积分抵扣金额

ThirdOrderUserCnd

参数名 必选 类型 说明
mobile String 用户电话号(非会员)

ThirdSettlementActivity

参数名 必选 类型 说明
planType Integer 优惠活动类型:-2:定额优惠;
discMoney Integer 优惠金额 (没有金额时传零)

返回示例

  {
    &quot;result&quot;: 0,
    &quot;msg&quot;: &quot;请求成功&quot;,
    &quot;code&quot;: &quot;0&quot;,
    &quot;errorMsg&quot;: &quot;&quot;,
    &quot;data&quot;:
&quot;QSdQsLNAUSYthYwEhLzBNSK29kjrpoK7GtA/08Did8LoP2zRsuqM1rv4Glq+RalembMkWWTMFJdoQvyJNtNJ9rixHkTlKUVKfLbp8Q+61Sf1n/goJiHRrCIz6up8kxGIYMYsjGXTcNfao1hxFDh2b924m49jxkvl+r5KdmLAV28=&quot;
  }

返回参数说明

参数名 类型 说明
result int 状态(0-成功,-1-失败)
msg String 调用成功返回信息)
code String 调用结果Code
errorMsg String 错误信息

data返回示例

{
    &quot;result&quot;: 0,
    &quot;data&quot;: {
        &quot;bsCode&quot;: &quot;YY15500-9998-210527-0005&quot;,
        &quot;bsId&quot;: &quot;604718245256507392&quot;,
        &quot;tsCode&quot;: &quot;JS15500-9998-210527-0005&quot;,
        &quot;shopId&quot;: 15500,
        &quot;tsId&quot;: &quot;604718245554302976&quot;
    }
}

data失败示例

{
    &quot;result&quot;: -1,
    &quot;errorMsg&quot;: &quot;店铺[155,000]不存在,请检查店铺号是否正确,如果店铺号确认无误,请联系管理员!&quot;
}

返回data说明

参数名 类型 说明
result int 状态(0-成功,-1-失败)
bsCode String YY号
bsId Long 营业流水ID
tsCode String JS号
tsId Long 结算流水ID
shopId Integer 门店号
errorMsg String 错误信息

备注

  • 更多返回错误代码请看首页的错误代码描述

页面列表

ITEM_HTML