2.2提交桌台账单

优质
小牛编辑
125浏览
2023-12-01

秒付业务,下行接口收到cash-request后(下行接口详见0.5),从业务系统中获取桌台账单,上传到服务端。

新版桌台码秒付时,生成的请求id为18位,请注意兼容性。

请求参数说明

参数描述必填示例值类型最大长度
action接口参数组object
└action需要调用的接口名称cash_post_billstring
getGET参数组,本组参数需要参与签名object
└id支付流水id(cash-request推送)721386328601451823string
└state1:有账单,-1:未开台无账单1number
└info当有结账错误时,返回错误信息。state非1时有效无账单string
postPOST参数组object
└dataobject
└└result1number
└└id线下账单号201411270006number
└└viewmode设置为1则表示账单还不能结算(不传或0为可以结算)0number
└└bill账单明细列表list
└└└qty数量11number
└└└amt金额 (amt=qty*price)33number
└└└name菜品名称农夫山泉string
└└└desc单位描述瓶/001string
└└└price单价3number
└└└value原价3number
└└└rebate设置为100表示这个菜品不打折(0或者不传为可以折扣)100number
└└└no_allow_pt不参与积分抵扣(1=不参与积分抵扣,其他/默认=参与积分抵扣)1number
└└└no_allow_co不参与优惠券抵扣(1=不参与优惠券抵扣,其他/默认=参与优惠券抵扣)1number

请求示例

{
  "action": {
    "action": "cash_post_bill"
  },
  "get": {
    "id": "721386328601451823",
    "state": "1",
    "info": "无账单"
  },
  "post": {
    "data": {
      "result": 1,
      "id": "201411270006",
      "viewmode": 0,
      "bill": [
        {
          "qty": "11",
          "amt": "33",
          "name": "农夫山泉",
          "desc": "瓶/001",
          "price": "3",
          "value": "3",
          "no_allow_pt": "1",
          "no_allow_co": "1",
          "rebate": 100
        },
        {
          "qty": "11",
          "amt": "55",
          "name": "雪碧",
          "desc": "罐/001",
          "price": "5",
          "value": "5"
        }
      ]
    }
  }
}

响应参数说明

参数描述必填示例值类型最大长度
status返回状态。接口成功时为1,出错为01number
info错误时会返回相应的错误信息提交成功string

响应示例

{
  "status": 1,
  "info": "提交成功"
}

参数参数名称必填描述范例
id账单号

会与支付单关联,方便查询

201411270006
bill账单明细列表订单列表数组数组
gdsid菜品编码收银系统菜品编码0051001
qty数量数量2
amt金额amt=qty*price22
desc单位描述单位等信息
name名称菜品名称、做法等多宝鱼红绕
price单价单价28
value原价如果price为特价、会员价等情况时,可以传原价38