Banas 开放平台
账户
  1. 数电开票
  • 公共业务
    • 健康检查
      GET
    • 获取 access_token
      POST
  • 票据识别
    • 国内通用票据识别
      POST
  • 发票查验
    • 增值税发票查验
      POST
    • 区块链发票查验
      POST
  • 发票认证
    • 简介
    • 业务流程
    • 自主授权登录
      POST
    • 自主授权登录并提交短信验证码
      POST
    • 同步纳税所属期
      POST
    • 同步进项发票
      POST
    • 同步海关缴款书
      POST
    • 全量发票列表(含发票文件)
      POST
    • 全量发票查询(含发票明细)
      POST
    • 发票-抵扣勾选
      POST
    • 申请、撤销、确认
      POST
    • 统计信息查询
      POST
    • 查询统计信息(历史)
      POST
    • 发票入账查询
      POST
    • 发票入账
      POST
    • 入账调整
      POST
    • 海关缴款书勾选抵扣
      POST
  • 数电开票
    • 登记应用
      POST
    • 自主授权登录
      POST
    • 自主授权登录并提交短信验证码
      POST
    • 自主授权异步查询扫码状态接口
      POST
    • 授权存活状态查询
      POST
    • 获取人脸识别二维码
      POST
    • 获取人脸识别结果
      POST
    • 发票开具(蓝票)
      POST
    • 红字发票信息表申请
      POST
    • 红字发票信息表查询(仅数电)
      POST
    • 红字发票信息表明细查询(仅数电)
      POST
    • 红字发票信息审核(仅数电)
      POST
    • 蓝字发票数据统计(仅数电)
      POST
    • 红字发票数据统计(仅数电)
      POST
    • 数电发票文件获取(数电)
      POST
    • 数电发票文件链接获取(数电)
      POST
  • 附录
    • 发票类型
    • 地区代码
  • 常见问题
    • 发票业务
  • 版本发布
    • 2024年8月发布内容
  1. 数电开票

红字发票信息表申请

POST
/api/sale/redInvoiceApply
sale

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json
红字发票信息表申请
uid
string 
唯一编码
必需
>= 16 字符<= 36 字符
nsrsbh
string 
税号
必需
>= 1 字符
dlsfsjh
string 
登录身份 手机号
必需
>= 1 字符
chyydm
string  | null 
可选
冲红原因代码
1-销货退回
2-开票有误
3-服务中止
4-销售折让
fplxdm
string  | null 
发票类型代码
可选
fplydm
string  | null 
可选
发票来源代码
1-增值税发票管理系统
2-电子发票服务平台
gmfnsrsbh
string  | null 
购买方纳税人识别号
可选
hzcxje
string  | null 
红字合计金额
可选
hzcxse
string  | null 
红字合计税额
可选
sqly
string  | null 
购销方选择
可选
yzzfpdm
string  | null 
原纸质发票代码
可选
yzzfphm
string  | null 
原纸质发票号码
可选
yfphm
string  | null 
原发票号码
可选
ykprq
string  | null 
可选
原开票日期 格式: yyyy-MM-dd HH:mm:ss
xsfnsrsbh
string  | null 
销售方纳税人识别号
可选
tdyslxdm
string  | null 
特定要素类型代码
可选
invoiceItemList
array[object (SaleInvoiceItem) {18}]  | null 
明细信息
可选
xh
string  | null 
序号
可选
fphxz
string  | null 
发票行性质
可选
spmc
string  | null 
商品名称
可选
ggxh
string  | null 
规格型号
可选
dw
string  | null 
单位
可选
spsl
string  | null 
数量
可选
dj
string  | null 
单价
可选
je
string  | null 
金额
可选
sl
string  | null 
税率
可选
se
string  | null 
税额
可选
kcje
string  | null 
扣除金额
可选
hsbz
string  | null 
可选
含税标识 0 不含税 1 含税
spbm
string  | null 
税收分类编码
可选
yhzcbs
string  | null 
可选
优惠政策标识 0 是不使用,1 是使用
slbs
string  | null 
税率标识
可选
zzstsgl
string  | null 
可选
增值税特殊管理(优惠政策名称)
tdzsfsdm
string  | null 
可选
特定征税方式代码 01:不征税 02:零税率 03:减按 04:免税 05:简易征税
zzstsgldm
string  | null 
可选
税收优惠政策类型代码 01:简易征收 02:稀土产品 03:免税 04:不征税 05:先征后退
示例
{
    "uid": "stringstringstri",
    "nsrsbh": "string",
    "dlsfsjh": "string",
    "chyydm": "string",
    "fplxdm": "string",
    "fplydm": "string",
    "gmfnsrsbh": "string",
    "hzcxje": "string",
    "hzcxse": "string",
    "sqly": "string",
    "yzzfpdm": "string",
    "yzzfphm": "string",
    "yfphm": "string",
    "ykprq": "string",
    "xsfnsrsbh": "string",
    "tdyslxdm": "string",
    "invoiceItemList": [
        {
            "xh": "string",
            "fphxz": "string",
            "spmc": "string",
            "ggxh": "string",
            "dw": "string",
            "spsl": "string",
            "dj": "string",
            "je": "string",
            "sl": "string",
            "se": "string",
            "kcje": "string",
            "hsbz": "string",
            "spbm": "string",
            "yhzcbs": "string",
            "slbs": "string",
            "zzstsgl": "string",
            "tdzsfsdm": "string",
            "zzstsgldm": "string"
        }
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://banas.ccitcn.com/api/sale/redInvoiceApply' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uid": "stringstringstri",
    "nsrsbh": "string",
    "dlsfsjh": "string",
    "chyydm": "string",
    "fplxdm": "string",
    "fplydm": "string",
    "gmfnsrsbh": "string",
    "hzcxje": "string",
    "hzcxse": "string",
    "sqly": "string",
    "yzzfpdm": "string",
    "yzzfphm": "string",
    "yfphm": "string",
    "ykprq": "string",
    "xsfnsrsbh": "string",
    "tdyslxdm": "string",
    "invoiceItemList": [
        {
            "xh": "string",
            "fphxz": "string",
            "spmc": "string",
            "ggxh": "string",
            "dw": "string",
            "spsl": "string",
            "dj": "string",
            "je": "string",
            "sl": "string",
            "se": "string",
            "kcje": "string",
            "hsbz": "string",
            "spbm": "string",
            "yhzcbs": "string",
            "slbs": "string",
            "zzstsgl": "string",
            "tdzsfsdm": "string",
            "zzstsgldm": "string"
        }
    ]
}'

返回响应

🟢200OK
application/json
Body
Banas 返回结果
result
object (RedInvoiceApplyResponse) 
可选
fpdm
string  | null 
发票代码
可选
fphm
string  | null 
发票号码
可选
fplxdm
string  | null 
发票类型代码
可选
qdfphm
string  | null 
全电发票号码
可选
kprq
string  | null 
开票日期
可选
ewmUrl
string  | null 
可选
pdfUrl
string  | null 
PDF 链接
可选
ofdUrl
string  | null 
OFD 链接
可选
xmlUrl
string  | null 
XML 链接
可选
qrjkpbz
string  | null 
确认即开票标志
可选
lrrq
string  | null 
录入日期
可选
xxbbh
string  | null 
信息表编号
可选
xxbid
string  | null 
信息表 id
可选
hzfpxxqrdZtdm
string  | null 
可选
红字发票信息确认单状态代码
error
string  | null 
异常描述
可选
status
integer <int32>
可选
状态码 200 成功
errorMessage
string  | null 
异常信息
可选
示例
{
    "result": {
        "fpdm": "string",
        "fphm": "string",
        "fplxdm": "string",
        "qdfphm": "string",
        "kprq": "string",
        "ewmUrl": "string",
        "pdfUrl": "string",
        "ofdUrl": "string",
        "xmlUrl": "string",
        "qrjkpbz": "string",
        "lrrq": "string",
        "xxbbh": "string",
        "xxbid": "string",
        "hzfpxxqrdZtdm": "string",
        "error": "string"
    },
    "status": 0,
    "errorMessage": "string"
}
修改于 2024-08-26 06:29:53
上一页
发票开具(蓝票)
下一页
红字发票信息表查询(仅数电)
Built with