# 红字信息表申请

# 应用场景

调用该接口可以用于纸质专票和电子专票申请购方或销方的红字信息表（当前仅支持UKey托管）

# 地址

/tax-api/invoice/redform-apply/v1

# 请求参数

参数名称	类型	必填	描述	示例
apply_sn	string	是	申请流水号，参考：税盘对应的12位盘号+12位时间，生成唯一性的请求流水号。	667234567789202101011200
terminal_code	string	是	税盘号：12位Ukey设备编号	667234567789
taxpayer_num	string	是	商户税号，申请红字发票信息表时的商户税号。	914403001234567890
seller_taxpayer_num	string	否	销售方税号，申请原因为2时必填，为0、1时无需填写。	914403001234567890
seller_name	string	否	销售方名称，申请原因为2时必填，为0、1时无需填写。	高灯计算机科技
buyer_taxpayer_num	string	否	购方税号，申请原因为0、1时必填，为2时无需填写。	914403009876543210
buyer_name	string	否	购方名称，申请原因为0、1时必填，为2时无需填写。	高灯云科技
phone	string	否	联系方式	13000000000
taxtation_type_code	string	是	应用类型代码：1、国税，2、地税	1
invoice_type_code	string	否	发票类型代码，004、增值税专用发票，028、增值税电子专票	028
blue_ticket_sn	string	否	蓝票发票号码，红字专票购方已抵扣可不填	10位发票代码
blue_ticket_code	string	否	蓝票发票代码，红字专票购方已抵扣可不填	8位发票号码
blue_ticket_date	string	否	蓝票发票日期，红字专票购方已抵扣可不填，格式：“YYYY-MM-DD”	2021-01-01
amount_without_tax	string	否	不含税总金额（精确两位小数）	1.10
tax_amount	string	是	税额（精确两位小数）	0.03
apply_reason	string	是	申请原因购方申请： 0、已抵扣 1、对应以下四个理由中的其中一个：未抵扣无法认证；未抵扣税号认证不符；未抵扣代码号码认证不符；货物不属于增值税项目范围销方申请： 2、对应以下两个理由中的其中一个：开票有误购买方拒收；开票有误等原因尚未交付	0
apply_person_name	string	否	申请人名称	张三
apply_org_name	string	否	申请机构名称	高灯科技
auto_flag	int	否	自动上传标记（手动审批及上传需要到高灯商家平台上进行操作）	0：手动审批、手动上传； 1：手动审批、自动上传； 2：自动审批、自动上传；
is_paper	int	是	0:纸票 1:电子发票	1
tax_flag	string	是	税种标识 0、营业税，1、增值税（目前为 1）	1
apply_method	string	是	申请方式 0：全部冲红(fyxm省略);1：部分冲红 (ukey支持)	0
goods_table_version	string	是	编码表版本号 (建议使用当前税局最新的编码以满足开票需求，目前为：39.0)	39.0
taxation_method	string	是	征税方式 0、普通征税;1、减按计征;2、差额征税 (ukey支持)	0
items	Array	是	商品明细
items.name	string	是	项目名称	技术服务
items.tax_code	string	是	税收分类编码编码，参照蓝票开具接口	3040409030000000000
items.tax_type	string	否	税目类别
items.models	string	否	项目规格	GGXH
items.unit	string	否	项目单位，成品油项目必填且单位只能为“升”或“吨”	个
items.total_price	string	是	商品总价(单位：元，两位小数位)	1.10
items.total	string	否	商品数量(精确到8位，和price成对存在)	1
items.price	string	否	商品单价(精确到8位,和total成对存在,单位：元)	1.10
items.tax_rate	string	是	税率(3位小数位)	0.030,代表3%的税率
items.tax_amount	string	是	税额(单位：元，两位小数位)	0.03
items.discount	string	否	总的折扣金额,金额必须是负数(单位：元，两位小数位)
items.zero_tax_flag	string	否	零税率标识：空、非零税率， 0、出口零税，1、免税，2、不征税，3、普通零税率
items.preferential_policy_flag	string	否	惠政策标志：0、不使用，1、使用。	0
items.vat_special_management	string	否	增值税特殊管理,preferential_policy_flag 优惠政策标识位 1 时必填)
items.hsbz	string	否	含税标记，标记明细中的总价、单价是否含税（0、不含税，1、含税）	0

# 响应参数

字段	类型	必须	备注
code	int	是	0表示已提交成功，非0表示失败
massage	string	是	错误描述

# 请求示例

{
    "apply_sn": "2021010112000000",
    "invoice_type_code": "028",
    "blue_ticket_sn": "89990005",
    "blue_ticket_code": "011111111108",
    "terminal_code": "517010030424",
    "apply_reason": "2",
    "apply_person_name": "",
    "apply_org_name": "",
    "phone": "",
    "seller_taxpayer_num": "911021490189012800x20",
    "seller_name": "测试商户",
    "buyer_taxpayer_num": "132201196801149010x20",
    "buyer_name": "高灯科技",
    "auto_flag": 0,
    "is_paper": 1,
    "amount_without_tax": "-100.00",
    "tax_amount": "-3.00",
    "tax_flag": "",
    "items": [{
        "name":"派送服务",       
        "sub_name":"",   
        "models":"",     
        "unit":"",         
        "quantity":"",   
        "price":"",        
        "total_price":"-100.00",  
        "tax_rate":"0.03",     
        "tax_amount":"-3.00",   
        "tax_code":"3040409030000000000", 
        "tax_type":"1",
        "preferential_policy_flag": "0",
        "zero_tax_flag": "",
        "vat_special_management": ""
    }],
    "apply_method": "0",
    "apply_type": "",
    "goods_table_version": "",
    "taxation_method": "0",
    "apply_type_code": "",
    "taxpayer_num": "911021490189012800x20"
}

# 响应示例

{
  "code": 0,
  "message": ""
}

← 上一篇：红字信息表查询下载下一篇：税分类商品编码表 →