客户批量开通套餐卡

接口地址

/marketing/card/bill/batchAutoAddPackageCardMakeBill

入参

字段说明

名称	类型	必填	示例	描述
idCustomer	Number	是	10545360219000304622	开卡客户唯一标识。
cardTemplateList	CardTemplateQuantityParam[]	是		开卡模板列表，最多支持 5 张卡模板，同时 sum(模板x数量) 要小于 10
idEmployee	Number	是	10545360219000304622	开卡单服务顾问员工唯一标识。
idOwnOrg	Number	是	10545360219000304622	开卡门店唯一标识。
paymentName	String	是	"微信支付"	开卡单收款方式名称。取自"财务参数设置-收款方式"，需要该收款方式开启，否则会报错。
serialNumber	String	是	"b8b5418a439f417fa9527015aaf53bfb"	开卡流水号。用作幂等，长度为10~32个字符。注意：流水号要保证在整个卡的业务域内唯一，包括套餐卡开卡、套餐卡退卡、储值卡开卡等。
gatheringMemo	String	否		收银备注，最大长度 200

CardTemplateQuantityParam

名称	类型	必填	示例	描述
idCardTemplate	Number	是	10545360219000304629	开卡的套餐卡模板唯一标识。
quantity	Number	是	5	当前套餐卡模板开卡数量

JSON示例

{
  "paramValues": [
    {
      "idCustomer": 10545360219000304622,
      "paymentName": "微信支付",
      "idOwnOrg": 10545360219000304622,
      "idEmployee": 10545360219000304622,
      "serialNumber": "b8b5418a439f417fa9527015aaf53bfb",
      "cardTemplateList": [
        {
          "cardTemplateList": 10545360219000304629,
          "quantity": 2
        },
        {
          "cardTemplateList": 15446577379572653835,
          "quantity": 3
        }
      ]
    }
  ]
}

出参

字段说明

名称	类型	示例	描述
status	Number	1	状态，-1 失败（部分失败）、0 处理中 、1 已完成（全部成功）
totalCount	Number	5	开卡总数
successCount	Number	2	开卡成功数
failCount	Number	3	开卡失败数。当 failCount > 0 时可使用相同的参数再次调用批量开卡接口进行重试，已成功的部分不会重复开卡。
failureDetails	String(2048)		失败信息
successList	CardMakeBillGatewayInfo[]		开卡成功明细列表

CardMakeBillGatewayInfo

名称	类型	示例	描述
idCardTemplate	Number	10545360219000304629	卡模板唯一标识
idCardBill	Number	15446577379574709715	开卡单唯一标识
idCardEntity	Number	15446577379574686183	卡实体唯一标识

JSON示例

{
  "code": 200,
  "message": "OK",
  "data": {
    "totalCount": 5,
    "successCount": 2,
    "failCount": 3,
    "successList": [
      {
        "idCardTemplate": 10545360219000304629,
        "idCardBill": 15446577379574709715,
        "idCardEntity": 15446577379574686183
      },
      {
        "idCardTemplate": 10545360219000304629,
        "idCardBill": 15446577379574631096,
        "idCardEntity": 15446577379572653837
      }
    ]
  }
}