kboss/b/reseller/请求返回字段长度.md
2025-07-16 14:27:17 +08:00

111 lines
9.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

### 用户信息同步提交字段
| 参数 | 类型 | 必填 | 描述 | 对应表格 | 对应字段 |
| :--------------: | :----: | :--: | :--------------------: | :----------: | :---------------: |
| fullName | String | 是 | 客户全称 | organization | orgname 1 |
| name | String | 是 | 客户名称 | organization | orgname 1 |
| identityCode | String | 是 | 统一社会信用代码 | organization | orgcode |
| address | String | 是 | 客户地址 | organization | address 1 |
| contact | String | 是 | 联系人 | organization | contactor 1 |
| tel | String | 是 | 联系人电话 | organization | contactor_phone 1 |
| email | String | 是 | 联系人邮箱 | organization | emailaddress 1 |
| saleMgrName | String | 是 | 销售经理名称 | users | username |
| saleMgrEmail | String | 是 | 销售经理邮箱 | users | email |
| saleMgrTel | String | 是 | 销售经理电话 | users | mobile |
| userAc | String | 是 | 客户账号, 以kboss_开头 | zj_users | userAc |
| userPhone | String | 是 | 客户账号的手机号 | zj_users | userPhone |
| bankName | String | 是 | 开户行 | invoice_attr | bank_name |
| bankAcc | String | 是 | 银行账号 | invoice_attr | bank_account |
| identityName | String | 是 | 发票抬头 | invoice_attr | invoice_title |
| taxTel | String | 是 | 发票联系电话 | invoice_attr | phone |
| taxpayerIdentity | String | 是 | 纳税人识别号 | invoice_attr | tax_no |
| taxAddress | String | 是 | 发票地址 | invoice_attr | address |
| remark | String | 是 | 备注 | zj_users | remark |
| ak | String | 是 | 腾讯ak | zj_users | ak |
| sk | String | 是 | 腾讯sk | zj_users | sk |
| thirdId | String | 是 | 腾讯id | zj_users | thirdId |
| appId | String | 是 | 腾讯appid | zj_users | appId |
| supId | String | 是 | 渠道商id | zj_users | supId |
### 产品信息字段
| 参数名 | 类型 | 必填 | 说明 | 长度 |
| :-----------: | :--: | :--: | :------------------: | :--: |
| id | int | 是 | 产品主键 | |
| category_id | int | 是 | 产品大类主键 | |
| category_name | str | 是 | 产品大类名称 | |
| name | str | 是 | 产品名称 | |
| code | str | 是 | 产品编码, 唯一 | |
| description | str | 是 | 产品简介 | |
| status | int | 是 | 产品状态 1正常 0禁用 | |
### 获取账单列表提交字段
| 参数 | 类型 | 必填 | 描述 | 长度 |
| :-------: | ------- | :--: | :------------------------------: | :--: |
| supId | Integer | 是 | 代理商id | |
| uin | String | 是 | 腾讯云用户id | |
| page | Integer | 是 | 页码 | |
| limit | Integer | 是 | 每页条数(最大1000) | |
| billMonth | String | 是 | 账单月份 | |
| payTime | String | 否 | 账单支付日期(当月仅支持到昨日) | |
### 账单列表返回字段
| 参数名 | 类型 | 可否为空 | 说明 | 长度 |
| :--------------: | :----: | :------: | :----------------------------------------------------------: | :--: |
| resourceId | String | 否 | 资源别名/ID | |
| businessCode | String | 是 | 产品编码 | |
| businessCodeName | String | 是 | 产品名称 | |
| productCode | String | 是 | 子产品编码 | |
| productCodeName | String | 是 | 子产品名称 | |
| zoneName | String | 是 | 可用区 | |
| itemCodeName | String | 是 | 配置描述 | |
| payModeName | String | 否 | 计费模式1包年包月 2按量计费 | |
| actionTypeName | String | 否 | 交易类型1包年包月新购 2包年包月续费 3包年包月配置变更 4包年包月退款 5按量计费扣费 6按量计费小时结 7按量计费日结 8按量计费月结 9线下项目扣费 10线下产品扣费 11调账扣费 12调账补偿 13竞价实例小时结 14线下项目调账补偿 15线下产品调账补偿 16优惠扣费 17优惠补偿 18按量计费迁入资源 19按量计费迁出资源 20包年包月迁入资源 21包年包月迁出资源 22预付费用 23小时费用 24预留实例退款 25按量计费冲正 26包年包月转按量 | |
| payTime | String | 否 | 购买时间 | |
| cost | String | 否 | 原价金额(元) | |
| realCost | String | 否 | 优惠后金额(元) | |
| discountCost | String | 否 | 中金折后金额(元) | |
| orderId | String | 否 | 订单ID仅预付费显示真实订单后付费则显示资源ID | |
### 获取订单列表提交字段
| 参数 | 类型 | 必填 | 描述 | 长度 |
| :-------: | :-----: | :--: | :------------------: | :--: |
| supId | Integer | 是 | 代理商id | |
| uin | String | 是 | 腾讯云用户id | |
| page | Integer | 是 | 页码 | |
| limit | Integer | 是 | 每页条数最大1000 | |
| beginTime | String | 否 | 开始时间 | |
| endTime | String | 否 | 结束时间 | |
### 订单列表返回字段
| 参数名 | 类型 | 可否为空 | 说明 | 长度 |
| :------------: | :----: | :------: | :----------------------------------------------------------: | :--: |
| orderId | String | 否 | 订单号 | |
| productCode | String | 是 | 产品编码 | |
| productName | String | 是 | 产品 | |
| subProductCode | String | 是 | 子产品编码 | |
| subProductName | String | 是 | 子产品 | |
| zoneName | String | 是 | 可用区 | |
| payMode | String | 否 | 资源类型prePay=预付费postPay=后付费) | |
| action | String | 是 | 交易类型1modifyNetworkMode 调整带宽模式 2modifyNetworkSize 调整带宽大小 3refund 退款 4downgrade 降配 5upgrade 升配 6renew 续费 7purchase 购买 8preMoveOut 包年包月迁出资源 9preMoveIn 包年包月迁入资源 10preToPost 预付费转后付费 11postMoveOut 按量计费迁出资源 12postMoveIn 按量计费迁入资源)注意:此字段可能返回 null表示取不到有效值 | |
| createTime | String | 否 | 订单创建时间 | |
| status | String | 否 | 订单状态1未支付 2已支付 3发货中 4已发货 5发货失败 6已退款 7已关单 8订单过期 9订单已失效 10产品已失效 11代付拒绝 12支付中 | |
| totalCost | String | 否 | 原价金额(分) | |
| realTotalCost | String | 否 | 优惠后金额(分) | |
| discountCost | String | 否 | 中金折后金额(分) | |
| discount | String | 否 | 中金折扣率 | |
| resourceId | String | 是 | 资源ID注意此字段可能返回 null表示取不到有效值 | |