# 销项发票管理

# 开蓝票

# 请求体参数

# 表单说明

参数	描述	说明
requestdatas	开票申请发票信息，包含发票头、发票明细
email	邮件推送配置(可选)	开具特殊票种-电子行程单该字段必传。
sms	短信推送配置(可选)
url	回调服务配置(可选)
delurl	退回业务系统回调服务配置(可选)
autoAudit	是否自动审核(可选)	true:自动审核，即不需要人工在发票平台确认开票，直接进行开票 false:不自动审核，即需要人工确认如果不传，代表true
nc6x-ubl	ncc友企联回调参数

# 发票头

参数	类型	长度	是否必填	默认值	描述	说明
FPQQLSH	String	20	是		发票请求流水号
FPLX	String	1	否	1	发票类型	1：增值税电子普通发票； 2：增值税电子专用发票； 3：增值税普通发票； 4：增值税专用发票、增值税专用发票(机动车)； 5：机动车销售统一发票； 8：增值税电子普通发票（成品油）； 10：成品油普通发票； 11：成品油专用发票； 15：二手车销售统一发票； 31：数电专用发票； 32：数电普通发票； 33：数电纸质发票(增值税专用发票)； 34：数电纸质发票(普通发票)；
XSF_NSRSBH	String	20	是		销售方纳税人识别号
XSF_MC	String	100	否		销售方名称	如果为空，获取发票平台配置的销售方名称;开具特殊票种-电子行程单该字段必传。
XSF_DZDH	String	100	否		销售方地址、电话	如果为空，获取发票平台配置的销售方地址及电话
XSF_DZ	String	300	否		销售方地址	如果为空，获取发票平台配置的销售方地址数电专用字段
XSF_DH	String	60	否		销售方电话	如果为空，获取发票平台配置的销售方电话数电专用字段
XSF_YHZH	String	100	否		销售方银行、账号	如果为空，获取发票平台配置的销售方银行及账号
XSF_YH	String	120	否		销售方银行	如果为空，获取发票平台配置的销售方银行数电专用字段
XSF_ZH	String	100	否		销售方账号	如果为空，获取发票平台配置的销售方账号数电专用字段
GMF_NSRSBH	String	20	否		购买方纳税人识别号	发票类型31 数电专用发票（必填）
GMF_MC	String	100	是		购买方名称
GMF_DZDH	String	100	否		购买方地址、电话	数电票此字段非必填
GMF_YHZH	String	100	否		购买方银行、账号	数电票此字段非必填
GMF_DZ	String	300	否		购买方地址	数电专用字段
GMF_DH	String	60	否		购买方电话	数电专用字段
GMF_YH	String	120	否		购买方银行	数电专用字段
GMF_ZH	String	100	否		购买方账号	数电专用字段
ALLELCUSERNAME	String	300	否		数电发票用户名	如果发票类型是数电发票用户名必填，并且是国密4密文
ALLELCPASSWORD	String	300	否		数电发票密码	如果发票类型是数电发票密码必填，并且是国密4密文
KPR	String	8	否		开票人	如果为空，获取发票平台配置的开票人
SKR	String	8	否		收款人	如果为空，获取发票平台配置的收款人
FHR	String	8	否		复核人	如果为空，获取发票平台配置的复核人
SLSM	String	1	否		税率说明	1:当小规模纳税人开具3%税率时需要填写税率说明; 2:前期已开具发票，发生销售折让、中止或者退回等情形需要开具红字发票，或者开票有误需要重新开具; 3:因为实际经营业务需要，放弃享受减按1%征收率征收增值税政策。
JSHJ	BigDecimal	15,2	是		价税合计	两位小数。明细价税合计之和必须与总的价税合计一致
HJJE	BigDecimal	15,2	否		合计金额	两位小数。为空时，根据明细项目进行合计。
HJSE	BigDecimal	15,2	否		合计税额	两位小数。为空时，根据明细项目进行合计。
BZ	String	200	否		备注
LYID	String	100	否		请求来源唯一标识
BMB_BBH	String	20	否		编码版本号	增加商品编码功能后，税局下载的商品编码表版本
ORGCODE	String	50	否		开票点编码	如果一个税号对应多个开票点，此字段必输，用于确定唯一开票点
WXORDERID	String		否		微信订单号	商户开票完成后，传入订单号和商户id将自动插入用户微信卡包(参考`微信卡包指引`) (opens new window)
WXAPPID	String		否		微信商户id	商户开票完成后，传入订单号和商户id将自动插入用户微信卡包(参考`微信卡包指引`) (opens new window)
WXAUTHID	String		否		微信批量插入卡包的授权id	如果使用批量插入卡包的授权，需要传此参数，否则不需要
ZDYBZ	String	200	否		自定义备注
SGBZ	String	1	否		收购标志	2-农产品收购
TSPZ	String	1	否		特殊票种	0-一般 2-燃油增值税专用发票 8-农产品销售 9-农产品收购 11-烟草发票 12-机动车发票 14-成品油发票 DK-代开发票 16-矿产品发票 E01-成品油发票 E03-建筑服务发票 E04 货物运输 E05-不动产销售 E06-不动产租赁服务发票 E07-代收车船税 E09-旅客运输 E12-自产农产品销售 E16-农产品收购 E17-光伏收购 E18-卷烟发票 E22-电子行程单
ZSFS	String	1	否	0	征税方式	0-普通征税 2-差额征税
PROJECTCODE	String	50	否		项目编号
TDZZSXMBH	String		否		土地增值税项目编号	数电特殊票种-建筑服务必传
BDCDZ	String		否		动产租赁地址	数电特殊票种-不动产租赁服务必传。格式：省/市/区*详细地址
ZLQQ	String		否		租赁日期起	数电特殊票种-不动产租赁服务必传。例：2023-03-22
ZLQZ	String		否		租赁日期止	数电特殊票种-不动产租赁服务必传。例：2024-03-22
KDSBZ	String		否		是否跨地址标志	数电特殊票种-不动产租赁服务及建筑服务必传。枚举Y：是；N:否
SDLC	String		否		数电纸票联次Value	数电纸质发票联次信息。枚举为： {"label":"2016版增值税普通发票（二联折叠票）","value":"04","type":"3"} {"label":"2016版增值税普通发票（五联折叠票）","value":"05","type":"3"} {"label":"增值税专用发票（中文三联无金额限制版）","value":"1130","type":"1"} {"label":"增值税专用发票（中文六联无金额限制版）","value":"1160","type":"1"} 注：传值为对应的value字段，枚举不完善，如不满足您的需求可联系我们补充
tspzs	List		否		数电特殊票种其他要素属性集合	数电特殊票种-建筑服务及旅客运输等必传。
LYDJH	String	200	否		业务来源单据号
TICKETNUMBER	String		否		13位电子票号	开具特殊票种-电子行程单该字段必传
BUYERTYPE	String		否		购买机票方类型	0:企业 1:机关或事业单位 2:个人3:其他；开具特殊票种-电子行程单该字段必传
FAREAMOUNT	String		否		加减价
ORDERNUMBER	String		否		企业购票订单号
USERNAME	String		否		用户名
GPCODE	String		否		GP单号
PASSENGERNAME	String		否		乘客姓名
PASSENGERIDNUM	String		否		乘客身份证号码/护照号码
ENDORSEMENTS	String		否		签注
OFFICE	String		否		出票Office号
ISSUEDBY	String		否		出票单位
IATA	String		否		IATA号
PNR	String		否		PNR号
TICKETINFORMATION	String		否		机票票面提示信息
INSURANCE	String		否		保险信息
ELECTRONICTICKETTYPE	String		否		机票类型	0：国内； 1：国际
VERIFYCODE	String		否		验证码
OVERDUEFLAG	String		否		超期标识	true: 超期；false: 未超期

# 发票明细

参数	类型	长度	是否必填	默认值	描述	说明
FPHXZ	Integer	2	否	0	发票行性质	0-正常行1-折扣行2-被折扣行
XMMC	String	600	是		项目名称
XMBM	String	90	是		项目编码	如果项目名称为空，会根据项目编码匹配云平台的商品档案
GGXH	String	150	否		规格型号	非数电发票规格型号最大长度为40个字符，数电发票长度为150个字符
DW	String	300	否		单位	如果是成品油发票，必填且只能是"吨或升"<\br>如果是矿产品发票，必填且只能是"立方米、吨、千克、克或克拉"
XMSL	BigDecimal	15,6	否		项目数量	如果是成品油发票，必填。
XMDJ	BigDecimal	15,6	否		项目单价	项目单价为空时，根据项目金额反算。不为空时不进行计算
XMJE	BigDecimal	15,2	否		项目金额	项目金额为空，根据项目价税合计反算。不为空时不进行计算
XMJSHJ	BigDecimal	15,2	是		项目价税合计
SL	BigDecimal	6,6	是		税率	6 位小数，例 17%为 0.17
SE	BigDecimal	15,2	否		税额	税额为空，根据价税合计反算。不为空时不进行计算。
HH	string	60	否		行号	有折扣时需要必输
ZKHHH	string	60	否		折扣行行号	有折扣时需要必输
SPBM	string	19	是		商品编码	税收分类编码
ZXBM	string	20	否	10	商品自行编码
YHZCBS	int	2	否	0	享受优惠标识	0：不使用，1：使用
LSLBS	string	1	否		零税率标识	空：非零利率，0：出口退税，1：免税，2：不征收，3普通零税率
ZZSTSGL	string	50	否		优惠政策说明	按3%简易征收,按5%简易征收 (此字段非空时，享受优惠标识YHZCBS字段值需为1)
KCE	BigDecimal	15,2	否		扣除额	扣除额
detailMotor	Object		否		明细特殊票种扩展属性	机动车及数电特殊票种-不动产租赁服务及建筑服务必传

# 明细特殊票种扩展属性 -> detailMotor

参数	类型	是否必填	描述	说明
CQZSBH	String	否	产权证书编号	数电特殊票种-不动产租赁服务必传。没有传无
JZFWFSD	String	否	建筑服务发生地	数电特殊票种-建筑服务必传
JZXMMC	String	否	建筑项目名称	数电特殊票种-建筑服务必传
CD	String	否	产地	机动车开具时-产地必传
CJHM	String	否	车架号码	机动车开具-车架号码必传
CLLX	String	否	车辆类型	机动车开具-车辆类型必传
CPXH	String	否	厂牌型号	机动车开具-厂牌型号必传
SCQYMC	String	否	生产企业名称	机动车开具-生产企业名称必传
SFZHM	String	否	身份证号码/组织机构代码	机动车开具-身份证号码/组织机构代码非必填
HGZH	String	否	合格证号	机动车开具-合格证号非必填
JKZMSH	String	否	进口证明书号	机动车开具-进口证明书号非必填
SJDH	String	否	商检单号	机动车开具-商检单号非必填
FDJHM	String	否	发动机号码	机动车开具-发动机号码非必填
DUNWEI	String	否	吨位	机动车开具-吨位非必填
XCRS	String	否	限乘人数	机动车开具-限乘人数非必填
DH	String	否	电话	机动车开具-电话非必填
DZ	String	否	地址	机动车开具-地址非必填
KHYH	String	否	开户银行	机动车开具-开户银行非必填
ZH	String	否	账户	机动车开具-账户非必填
SWJGDM	String	否	主管税务机关代码	机动车开具-主管税务机关代码非必填
SWJGMC	String	否	主管税务机关名称	机动车开具-主管税务机关名称非必填
WSPZH	String	否	完税凭证号	机动车开具-完税凭证号非必填
GFDZ	String	否	买方单位/个人住址	机动车开具-买方单位/个人住址非必填
GFDH	String	否	买方电话	机动车开具-买方电话非必填
CPZH	String	否	车牌照号	机动车开具-车牌照号非必填
DJZH	String	否	登记证号	机动车开具-登记证号非必填
CGSMC	String	否	转入地车辆车管所名称	机动车开具-转入地车辆车管所名称非必填
XFDW	String	否	卖方单位/个人	机动车开具-卖方单位/个人非必填
XFHM	String	否	卖方单位代码/身份证号	机动车开具-卖方单位代码/身份证号非必填
XFDZ	String	否	卖方单位/个人住址	机动车开具-卖方单位/个人住址非必填
XFDH	String	否	卖方电话	机动车开具-卖方电话非必填
JYDW	String	否	经营、拍卖单位	机动车开具-经营、拍卖单位非必填
JYDZ	String	否	经营、拍卖单位地址	机动车开具-经营、拍卖单位地址非必填
JYSBH	String	否	经营、拍卖单位纳税人识别号	机动车开具-经营、拍卖单位纳税人识别号非必填
JYYHZH	String	否	开户银行及账号	机动车开具-开户银行及账号非必填
JYDH	String	否	经营、拍卖单位电话	机动车开具-经营、拍卖单位电话非必填
SCMC	String	否	二手车市场	机动车开具-二手车市场非必填
SCSBH	String	否	二手车市场纳税人识别号	机动车开具-二手车市场纳税人识别号非必填
SCDZ	String	否	二手车市场地址	机动车开具-二手车市场地址非必填
SCYHZH	String	否	二手车市场开户银行及账号	机动车开具-二手车市场开户银行及账号非必填
SCDH	String	否	二手车市场电话	机动车开具-二手车市场电话非必填
VEHICLEVERSION	String	否	机动车统一销售发票版本	机动车开具-机动车统一销售发票版本非必填
GMFSFZJLX	String	否	机动车统一销售发票购买方身份证件类型	机动车开具-机动车统一销售发票购买方身份证件类型非必填
GMFSFZJLX	String	否	机动车统一销售发票购买方身份证件类型	机动车开具-机动车统一销售发票购买方身份证件类型非必填

# 数电特殊票种其他要素属性 -> tspzs

参数	类型	是否必填	描述	说明
JTGJLXDM	String	否	交通工具类型	数电特殊票种-建筑服务及旅客运输等必传
YSMXXH	String	否	运输明细序号	数电特殊票种-建筑服务及旅客运输等必传
QYD	String	否	起运地	数电特殊票种-建筑服务及旅客运输等必传
DDD	String	否	到达地	数电特殊票种-建筑服务及旅客运输等必传
YSGJZL	String	否	运输工具种类	数电特殊票种-建筑服务及旅客运输等必传
YSGJPH	String	否	运输工具牌号	数电特殊票种-建筑服务及旅客运输等必传
YSHWMC	String	否	运输货物名称	数电特殊票种-建筑服务及旅客运输等必传
CXRXH	Object	否	出行人序号
CXR	string	否	承运人名称
CARRIERCODE	string	否	承运人二字码
CHUXRQ	string	否	出行日期	格式yyyy-MM-dd HH:mm
CFD	string	否	出发地
LKDDD	string	否	到达地
ZWDJ	string	否	座位等级
YSGJPH	string	否	航班号
FAREBASIS	string	否	客票级别/客票类别
NOTVALIDBEFORE	string	否	客票生效日期	yyyy-MM-dd
NOTVALIDAFTER	string	否	有效截至日期	yyyy-MM-dd
ALLOW	string	否	免费行李
ITINERARYTYPE	string	否	行程类型	0：普通运输段 1：地面运输

# 邮件推送配置

参数	类型	长度	是否必填	默认值	描述	说明
fpqqlsh	String	20	是		发票请求流水号	必须和上面的开票请求对应
address	String	500	是		接收地址	接收地址，多个地址使用","分隔开

# 短信推送配置

参数	类型	长度	是否必填	默认值	描述	说明
fpqqlsh	String	20	是		发票请求流水号	必须和上面的开票请求对应
address	String	500	是		接收地址	接收地址，多个地址使用","分隔开

# 回调服务配置

参数	类型	长度	是否必填	描述	说明
fpqqlsh	String	20	是	发票请求流水号	必须和上面的开票请求对应
url	String	500	是	回调url	开票申请调用方配置回调url，当电子发票开具成功后，调用此服务，POST电子发票相关信息。信息包含：1、pdf版式文件2、发票数据、3、发票下载链接 ncc通过友企联方案回调可不传此参数
intf	String	200	否	ncc回调接口名	ncc通过友企联方案回调时必传
method	String	200	否	ncc回调方法名	ncc通过友企联方案回调时必传

# 退回回调推送配置

参数	类型	长度	是否必填	默认值	描述	说明
fpqqlsh	String	20	是		发票请求流水号	必须和上面的开票请求对应
url	String	500	是		回调url,使用业务系统退回功能时，退回将会调用此服务，post方式，相关信息1.fpqqlsh发票请求流水号 2.xsfNsrsbh销售方纳税人识别号	接收地址，多个地址使用","分隔开

# 请求样例

标准表单参数样例

requestdatas=[ {
	"FPQQLSH" : "12345678901234567890",
	"XSF_NSRSBH" : "销售方纳税人识别号",
	"XSF_MC" : "销售方名称",
	"XSF_DZDH" : "销售方地址、电话",
    "XSF_DZ" : "销售方地址",
    "XSF_DH" : "销售方电话",
	"XSF_YHZH" : "销售方银行、账号",
    "XSF_YH" : "销售方银行",
    "XSF_ZH" : "销售方账号",
	"GMF_NSRSBH" : "购买方纳税人识别号",
	"GMF_MC" : "购买方名称",
	"GMF_DZDH" : "购买方地址、电话",
    "GMF_DZ" : "购买方地址",
    "GMF_DH" : "购买方电话",
	"GMF_YHZH" : "购买方银行、账号",
    "GMF_YH" : "购买方银行",
    "GMF_ZH" : "购买方账号",
    "ALLELCUSERNAME": "电子税务局用户名（发票类型为数电发票时必传并且是国密四密文）",
    "ALLELCPASSWORD": "电子税务局密码 （发票类型为数电发票时必传并且是国密四密文）",
	"KPR" : "开票人",
	"SKR" : "收款人",
	"FHR" : "复核人",
	"JSHJ" : "价税合计",
	"HJJE" : "合计金额",
	"HJSE" : "合计税额",
	"BZ" : "备注",
	"BMB_BBH" : "10.0",
	"items" : [{
            "FPHXZ" : "发票行性质",
            "XMMC" : "项目名称",
            "GGXH" : "规格型号",
            "DW" : "单位",
            "XMSL" : "项目数量",
            "XMDJ" : "项目单价",
            "XMJE" : "项目金额",
            "XMJSHJ" : "项目价税合计",
            "SL" : "税率",
            "SE" : "税额",
            "HH":"行号",
            "SPBM":"商品编码",
            "ZXBM":"自行编码",
            "KCE":300
		}
	]
}]
&email=[
    {
	    "fpqqlsh":"12345678901234567890",
        "address": "x1@yonyou.com,x2@yonyou.com"
    }, 
    {
	    "fpqqlsh":"12345678901234567890",
        "address": "x3@yonyou.com"
    }
]
&sms=[{
	"fpqqlsh":"12345678901234567890",
        "address": "13511111111,13511111112"
    }]
&url=[{
		"fpqqlsh":"12345678901234567890",
        "url": "http://url.com/msg"
    }]
&delurl=[{
		"fpqqlsh":"12345678901234567890",
        "url": "http://url.com/msg"
    }]
&nc6x-ubl=[{
        "fpqqlsh":"12345678901234567890",
        "method":"queryUserPermAppPksOrCodes",
        "intf":"nccloud.pubitf.baseapp.apprbac.IAppAndOrgPermQueryPubService"   
}]
&autoAudit=true

最小请求参数样例

TIP

销售方地址及电话、银行及账号、销售方名称可以通过销售方纳税人识别号获取

requestdatas=[{
	"FPQQLSH" : "12345678901234567890",
    "XSF_NSRSBH" : "销售方纳税人识别号",
    "GMF_MC" : "购买方名称",
    "JSHJ" : 117,
    "items" : 
		    [
			    {
		            "XMMC" : "项目名称",
		            "XMJSHJ" : 117,
		            "SL" : 0.17,
		            "SPBM" : "1010101020000000000"
		        }
		    ]
}]

包含折扣行开票样例

TIP

包含折扣行的单据需要增加以下信息 FPHXZ：发票行性质 HH：行号 ZKHHH：折扣行行号折扣行上规则型号、单位、数量、单价不用设值。折扣行的项目名称必须与被折扣行一样。被折扣行记录对应折扣行行号。

requestdatas=[{
	"FPQQLSH" : "12345678901234567890",
    "XSF_NSRSBH" : "销售方纳税人识别号",
    "GMF_MC" : "购买方名称",
    "JSHJ" : 799,
    "items" : 
		    [
			    {
				    "FPHXZ" : 2,
		            "XMMC" : "项目名称",
		            "XMSL" : 1,
		            "XMJSHJ" : 899,
		            "SL" : 0.17,
		            "HH":"1",
		            "ZKHHH":"2"
		        },
		        {
			        "FPHXZ" : 1,
		            "XMMC" : "项目名称",
		            "XMJSHJ" : -100,
		            "SL" : 0.17,
		            "HH":"2",
		        }
		    ]
}]

数电不动产接口报文样例

requestdatas=[{
	"FPQQLSH": "202302171613262049",
	"FPLX": "31",
	"XSF_NSRSBH": "441234567AAAAAA",
	"XSF_MC": "htt灰度01AAAA",
	"TSPZ": "E06",//特殊票种-不动产租赁代码
    "BDCDZ": "北京市/北京市辖区/东城区*滨河公园5-4-1803",//不动产租赁地址：省/市/区*详细地址
    "ZLQQ": "2023-03-22",//租赁日期起
    "ZLQZ": "2023-04-30",//租赁日期止
    "KDSBZ": "N",//是否跨地址标志 Y：是；N:否
	"ORGCODE": "htt001",
	"GMF_NSRSBH": "913418025914242188",
	"GMF_MC": "labo1",
	"GMF_DZDH": "",
	"GMF_YHZH": "",
	"KPR": "hett",
	"SKR": "hett",
	"FHR": "hett",
	"JSHJ": 14837.170000000000000,
	"HJJE": 13130.240000000000000,
	"HJSE": 1706.930000000000000,
	"BZ": "",
	"BMB_BBH": "28.0",
	"XSF_DZ": "北京",
	"XSF_DH": "13141422555",
	"XSF_YH": "北京",
	"XSF_ZH": "65456787889",
	"GMF_DZ": "",
	"GMF_DH": null,
	"GMF_YH": "",
	"GMF_ZH": "",
	"items": [{
		"FPHXZ": 0,
		"XMMC": "*经营租赁*小熊",
		"XMBM": "3040502020101000000",
		"GGXH": "",
		"XMJE": 13130.240000000000000,
		"XMJSHJ": 14837.17,
		"SL": 0.13,
		"SE": 1706.930000000000000,
		"HH": 1,
		"SPBM": "3040502020101000000",
		"DW": "公顷",//面积单位，取值为：平方千米、平方米、公顷、亩
		"XMSL": 870.000000000000000,
		"detailMotor": {
			"CQZSBH": "2324423231231231" //产权证书编号
		}
	}]
}]

数电建筑服务接口报文样例

requestdatas=[{
    "FPQQLSH": "202302171613262049",
    "FPLX": "31",
    "XSF_NSRSBH": "441234567AAAAAA",
    "XSF_MC": "htt灰度01AAAA",
    "TSPZ": "E03",//特殊票种-建筑服务代码
    "TDZZSXMBH": "232342131",//土地增值税项目编号
    "KDSBZ": "N",//是否跨地址标志 Y：是；N:否
    "ORGCODE": "htt001",
    "GMF_NSRSBH": "913418025914242188",
    "GMF_MC": "labo1",
    "GMF_DZDH": "",
    "GMF_YHZH": "",
    "KPR": "hett",
    "SKR": "hett",
    "FHR": "hett",
    "JSHJ": 14837.170000000000000,
    "HJJE": 13130.240000000000000,
    "HJSE": 1706.930000000000000,
    "BZ": "",
    "BMB_BBH": "28.0",
    "XSF_DZ": "北京",
    "XSF_DH": "13141422555",
    "XSF_YH": "北京",
    "XSF_ZH": "65456787889",
    "GMF_DZ": "",
    "GMF_DH": null,
    "GMF_YH": "",
    "GMF_ZH": "",
    "items": [{
        "FPHXZ": 0,
        "XMMC": "*经营租赁*小熊",
        "XMBM": "3040502020101000000",
        "GGXH": "",
        "XMJE": 13130.240000000000000,
        "XMJSHJ": 14837.17,
        "SL": 0.13,
        "SE": 1706.930000000000000,
        "HH": 1,
        "SPBM": "3040502020101000000",
        "DW": "公顷",
        "XMSL": 870.000000000000000,
        "detailMotor": {
            "JZFWFSD": "北京市/北京市辖区/东城区",//建筑服务发生地
            "JZXMMC": "地砖"//建筑项目名称
        }
    }]
 }]

数电货物运输服务接口报文样例

requestdatas=[{
    "FPQQLSH": "202302171613262050",
    "FPLX": "31",
    "XSF_NSRSBH": "44123456789012AAAAAA",
    "XSF_MC": "AAAA广东全电",
    "TSPZ": "E04",
    "ORGCODE": "AAAA03",
    "GMF_NSRSBH": "913418025914242188",
    "GMF_MC": "labo1",
    "GMF_DZDH": "",
    "GMF_YHZH": "",
    "KPR": "hett",
    "SKR": "hett",
    "FHR": "hett",
    "JSHJ": 14837.170000000000000,
    "HJJE": 13130.240000000000000,
    "HJSE": 1706.930000000000000,
    "BZ": "",
    "BMB_BBH": "28.0",
    "XSF_DZ": "北京",
    "XSF_DH": "13141422555",
    "XSF_YH": "北京",
    "XSF_ZH": "65456787889",
    "GMF_DZ": "",
    "GMF_DH": null,
    "GMF_YH": "",
    "GMF_ZH": "",
    "items": [{
        "FPHXZ": 0,
        "XMMC": "*运输服务*国内道路货物运输服务",
        "XMBM": "3010102020100000000",
        "GGXH": "",
        "XMJE": 13130.240000000000000,
        "XMJSHJ": 14837.17,
        "SL": 0.13,
        "SE": 1706.930000000000000,
        "HH": 1,
        "SPBM": "3040502020101000000",
        "DW": "吨",
        "XMSL": 870.000000000000000
    }],
    "tspzs": [{
        "YSMXXH": "1",
        "YSGJZL": "铁路运输",
        "YSGJPH": "G443",
        "QYD": "北京市>北京市辖区>东城区",
        "DDD": "河北省>石家庄市>长安区",
        "YSHWMC": "煤矿"
    }, {
        "YSMXXH": "2",
        "YSGJZL": "铁路运输",
        "YSGJPH": "Z3232",
        "QYD": "河北省>石家庄市>桥西区",
        "DDD": "天津市>天津市辖区>和平区",
        "YSHWMC": "瓷器"
    }]
 }]

数电不动产销售接口报文样例

requestdatas=[{
  "FPQQLSH": "202302171613262049",
  "FPLX": "31",
  "XSF_NSRSBH": "441234567AAAAAA",
  "XSF_MC": "htt灰度01AAAA",
  "TSPZ": "E05", //特殊票种-不动产销售代码
  "BDCDZ": "北京市/北京市辖区/东城区*滨河公园5-4-1803", //不动产地址：省/市/区*详细地址
  "WQHTBABH": "312312312123", //网签合同备案编号
  "TDZZSXMBH": "312312312123", //土地增值税项目编号
  "BDCDWDM": "312312312123", //不动产单元代码
  "HDJSJG": "312312312123", //核定计税价格。不属于核定计税不动产销售的可不填写
  "SJCJHSJE": "312312312123", //实际成交含税金额。若按核定计税价格征税的，为必填
  "KDSBZ": "N", //是否跨地址标志 Y：是；N:否
  "ORGCODE": "htt001",
  "GMF_NSRSBH": "913418025914242188",
  "GMF_MC": "labo1",
  "GMF_DZDH": "",
  "GMF_YHZH": "",
  "KPR": "hett",
  "SKR": "hett",
  "FHR": "hett",
  "JSHJ": 14837.170000000000000,
  "HJJE": 13130.240000000000000,
  "HJSE": 1706.930000000000000,
  "BZ": "",
  "BMB_BBH": "28.0",
  "XSF_DZ": "北京",
  "XSF_DH": "13141422555",
  "XSF_YH": "北京",
  "XSF_ZH": "65456787889",
  "GMF_DZ": "",
  "GMF_DH": null,
  "GMF_YH": "",
  "GMF_ZH": "",
  "items": [{
    "FPHXZ": 0,
    "XMMC": "*经营租赁*小熊",
    "XMBM": "3040502020101000000",
    "GGXH": "",
    "XMJE": 13130.240000000000000,
    "XMJSHJ": 14837.17,
    "SL": 0.13,
    "SE": 1706.930000000000000,
    "HH": 1,
    "SPBM": "3040502020101000000",
    "DW": "公顷", //面积单位，取值为：平方千米、平方米、公顷、亩
    "XMSL": 870.000000000000000,
    "detailMotor": {
      "CQZSBH": "2324423231231231" //产权证书编号
    }
  }]
}]

数电旅客运输接口报文样例

requestdatas=[{
  "FPQQLSH": "202302171613262049",
  "FPLX": "31",
  "XSF_NSRSBH": "441234567AAAAAA",
  "XSF_MC": "htt灰度01AAAA",
  "TSPZ": "E09",//特殊票种-旅客运输服务
  "ORGCODE": "htt001",
  "GMF_NSRSBH": "913418025914242188",
  "GMF_MC": "labo1",
  "GMF_DZDH": "",
  "GMF_YHZH": "",
  "KPR": "hett",
  "SKR": "hett",
  "FHR": "hett",
  "JSHJ": 14837.170000000000000,
  "HJJE": 13130.240000000000000,
  "HJSE": 1706.930000000000000,
  "BZ": "",
  "BMB_BBH": "28.0",
  "XSF_DZ": "北京",
  "XSF_DH": "13141422555",
  "XSF_YH": "北京",
  "XSF_ZH": "65456787889",
  "GMF_DZ": "",
  "GMF_DH": null,
  "GMF_YH": "",
  "GMF_ZH": "",
  "items": [{
    "FPHXZ": 0,
    "XMMC": "*运输服务*国际旅客运输",
    "XMBM": "3040502020101000000",
    "GGXH": "",
    "XMJE": 13130.240000000000000,
    "XMJSHJ": 14837.17,
    "SL": 0.13,
    "SE": 1706.930000000000000,
    "HH": 1,
    "SPBM": "3040502020101000000",
    "DW": "",
    "XMSL": 870.000000000000000
  }],
  "tspzs": [{
    "CXRXH": "1",//出行人序号
    "CXR": "张三",//出行人
    "CHUXRQ": "2022-11-01",//出行日期，格式yyyy-MM-dd
    "CXRZJLXDM": "101",//出行人证件类型代码
    "SFZJHM": "1233445",//身份证件号码
    "CFD": "北京市怀柔区",//出发地
    "LKDDD北京市平谷区",//到达地
    "ZWDJ": "二等座",//座位等级若交通工具为火车、飞机、船舶，则该要素为必填，其他选项选填；
    ---交通工具为火车：一等座、二等座、软席（软座、软卧）、硬席（硬座、硬卧）
    ---交通工作为飞机： 经济舱、头等舱、公务舱
    ---交通工具为船舶： 一等舱、二等舱 、三等舱
    "JTGJLXDM": "2"//交通工具类型代码（1：飞机 2：火车 3：长途汽车 4：公共交通 5：出租车 6：汽车 7：船舶 9：其他）
  }]
}]

# 出行人证件类型代码枚举

证据类型代码	证据名称
101	组织机构代码证
102	营业执照
103	税务登记证
199	其他单位证件
201	居民身份证
202	军官证
203	武警警官证
204	士兵证
205	军队离退休干部证
206	残疾人证
207	残疾军人证（1-8级）
208	外国护照
210	港澳居民来往内地通行证
212	中华人民共和国往来港澳通行证
213	台湾居民来往大陆通行证
214	大陆居民往来台湾通行证
215	外国人居留证
216	外交官证
217	使（领事）馆证
218	海员证
219	香港永久性居民身份证
220	台湾身份证
221	澳门特别行政区永久性居民身份证
222	外国人身份证件
224	就业失业登记证
225	退休证
226	离休证
227	中国护照
228	城镇退役士兵自谋职业证
229	随军家属身份证明
230	中国人民解放军军官转业证书
231	中国人民解放军义务兵退出现役证
232	中国人民解放军士官退出现役证
233	外国人永久居留身份证（外国人永久居留证）
234	就业创业证
235	香港特别行政区护照
236	澳门特别行政区护照
237	中华人民共和国港澳居民居住证
238	中华人民共和国台湾居民居住证
239	《中华人民共和国外国人工作许可证》（A类）
240	《中华人民共和国外国人工作许可证》（B类）
241	《中华人民共和国外国人工作许可证》（C类）
291	出生医学证明
299	其他个人证件

数电代收车船税发票报文样例

requestdatas=[{
  "FPQQLSH": "202302171613262049",
  "FPLX": "31",
  "XSF_NSRSBH": "441234567AAAAAA",
  "XSF_MC": "htt灰度01AAAA",
  "TSPZ": "E07",//特殊票种-代收车船税代码
  "BXDH": "89293943482432",//保险单号
  "CPHCBDJH": "豫MUX555",//车牌号/船舶登记号
  "SKSSQ": "2023-01 2023-03",//税款所属期yyyy-MM+空格+yyyy-MM
  "DSCCSJE": "350000",//代收车船税金额
  "ZNJ": "100",//滞纳金
  "JEHJ": "350100",//金额合计
  "CJH": "233134133384938",//车辆识别代码/车架号码
  "ORGCODE": "htt001",
  "GMF_NSRSBH": "913418025914242188",
  "GMF_MC": "labo1",
  "GMF_DZDH": "",
  "GMF_YHZH": "",
  "KPR": "hett",
  "SKR": "hett",
  "FHR": "hett",
  "JSHJ": 14837.170000000000000,
  "HJJE": 13130.240000000000000,
  "HJSE": 1706.930000000000000,
  "BZ": "",
  "BMB_BBH": "28.0",
  "XSF_DZ": "北京",
  "XSF_DH": "13141422555",
  "XSF_YH": "北京",
  "XSF_ZH": "65456787889",
  "GMF_DZ": "",
  "GMF_DH": null,
  "GMF_YH": "",
  "GMF_ZH": "",
  "items": [{
    "FPHXZ": 0,
    "XMMC": "*代收车船*宝马X6",
    "XMBM": "3040502020101000000",
    "GGXH": "",
    "XMJE": 13130.240000000000000,
    "XMJSHJ": 14837.17,
    "SL": 0.13,
    "SE": 1706.930000000000000,
    "HH": 1,
    "SPBM": "3040502020101000000",
    "DW": "辆",
    "XMSL": 870.000000000000000
  }]
}]

数电差额征收-差额开票报文样例

requestdatas=[{
  "FPQQLSH": "202302171613262050",
  "FPLX": "31",
  "XSF_NSRSBH": "44123456789012AAAAAA",
  "XSF_MC": "AAAA广东全电",
  "ZSFS": "2",//征收方式：差额征收-差额开票
  "ORGCODE": "AAAA03",
  "GMF_NSRSBH": "913418025914242188",
  "GMF_MC": "labo1",
  "GMF_DZDH": "",
  "GMF_YHZH": "",
  "KPR": "hett",
  "SKR": "hett",
  "FHR": "hett",
  "JSHJ": 14837.170000000000000,
  "HJJE": 13130.240000000000000,
  "HJSE": 1706.930000000000000,
  "BZ": "",
  "BMB_BBH": "28.0",
  "XSF_DZ": "北京",
  "XSF_DH": "13141422555",
  "XSF_YH": "北京",
  "XSF_ZH": "65456787889",
  "GMF_DZ": "",
  "GMF_DH": null,
  "GMF_YH": "",
  "GMF_ZH": "",
  "items": [{
    "FPHXZ": 0,
    "XMMC": "*运输服务*国内道路货物运输服务",
    "XMBM": "3010102020100000000",
    "GGXH": "",
    "XMJE": 13130.240000000000000,
    "XMJSHJ": 14837.17,
    "SL": 0.13,
    "SE": 1706.930000000000000,
    "HH": 1,
    "SPBM": "3040502020101000000",
    "DW": "吨",
    "XMSL": 870.000000000000000,
    "KCE": 100.00//扣除总额
  }],
  "cepzs": [{
    "XH": 1,//序号
    "PZLX": "01",//凭证类型，01 数电票、02 增值税专用发票、03 增值税普通发票、04 营业税发票、05 财政票据、06 法院裁决书、07 契税完税凭证、08 其他发票类、09 其他扣除凭证
    "FPHM": "23442000000000000293",//全电发票号码
    "FPDM": "",//非全电发票代码
    "ZZFPHM": "",//非全电发票号码
    "PZHM": "",//凭证号码
    "KJRQ": "2023-01-04",//开票日期，格式形如：yyyy-MM-dd
    "HJJE": 1000.00,//合计金额
    "KCE": 100.00,//扣除额
    "BZ": "",//备注
    "LY": "手工录入",//录入方式，取值范围如下：手工录入 勾选录入 模板录入
    "BCKCJE": 100.00,//本次扣除金额
    "PZHJJE": 1000.00//凭证合计金额
  }]
}]

数电差额征收-全额开票报文样例

requestdatas=[{
  "FPQQLSH": "202302171613262050",
  "FPLX": "31",
  "XSF_NSRSBH": "44123456789012AAAAAA",
  "XSF_MC": "AAAA广东全电",
  "ZSFS": "3", //征收方式：差额征收-全额开票
  "ORGCODE": "AAAA03",
  "GMF_NSRSBH": "913418025914242188",
  "GMF_MC": "labo1",
  "GMF_DZDH": "",
  "GMF_YHZH": "",
  "KPR": "hett",
  "SKR": "hett",
  "FHR": "hett",
  "JSHJ": 14837.170000000000000,
  "HJJE": 13130.240000000000000,
  "HJSE": 1706.930000000000000,
  "BZ": "",
  "BMB_BBH": "28.0",
  "XSF_DZ": "北京",
  "XSF_DH": "13141422555",
  "XSF_YH": "北京",
  "XSF_ZH": "65456787889",
  "GMF_DZ": "",
  "GMF_DH": null,
  "GMF_YH": "",
  "GMF_ZH": "",
  "items": [{
    "FPHXZ": 0,
    "XMMC": "*运输服务*国内道路货物运输服务",
    "XMBM": "3010102020100000000",
    "GGXH": "",
    "XMJE": 13130.240000000000000,
    "XMJSHJ": 14837.17,
    "SL": 0.13,
    "SE": 1706.930000000000000,
    "HH": 1,
    "SPBM": "3040502020101000000",
    "DW": "吨",
    "XMSL": 870.000000000000000,
    "KCE": 100.00 //扣除总额,与差额征收差额开票一样
  }],
  "cepzs": [{
    "XH": 1, //序号
    "PZLX": "01", //凭证类型，01 数电票、02 增值税专用发票、03 增值税普通发票、04 营业税发票、05 财政票据、06 法院裁决书、07 契税完税凭证、08 其他发票类、09 其他扣除凭证
    "FPHM": "23442000000000000293", //全电发票号码
    "FPDM": "", //非全电发票代码
    "ZZFPHM": "", //非全电发票号码
    "PZHM": "", //凭证号码
    "KJRQ": "2023-01-04", //开票日期，格式形如：yyyy-MM-dd
    "HJJE": 1000.00, //合计金额
    "KCE": 100.00, //扣除额
    "BZ": "", //备注
    "LY": "手工录入", //录入方式，取值范围如下：手工录入 勾选录入 模板录入
    "BCKCJE": 100.00, //本次扣除金额
    "PZHJJE": 1000.00 //凭证合计金额
  }]

}]

数电电子行程单

requestdatas=[{
  "FPQQLSH": "202302171613262049",
  "FPLX": "35",
  "LYDJH": "00023123123123", //业务来源单据号
  "XSF_NSRSBH": "441234567AAAAAA",
  "XSF_MC": "htt灰度01AAAA",
  "TSPZ": "E22", //特殊票种-电子行程单
  "ORGCODE": "htt001",
  "GMF_NSRSBH": "913418025914242188",
  "GMF_MC": "labo1",
  "TICKETNUMBER": "9992181190174", //13位电子票号
  "BUYERTYPE": "2", //购买机票方类型：0:企业 1:机关或事业单位 2:个人3:其他
  "FAREAMOUNT": "20", //加减价
  "ORDERNUMBER": "23234234dg2323dsdf", //企业购票订单号
  "USERNAME": "zhangwuji", //用户名
  "GPCODE": "1312314132131", //GP单号
  "PASSENGERNAME": "boge", //乘客姓名
  "PASSENGERIDNUM": "212312312321423123123", //乘客身份证号码/护照号码
  "ENDORSEMENTS": "Q/改退收费", //签注
  "OFFICE": "PEK112", //出票Office号
  "ISSUEDBY": "中国国际航空股份有限公司( 电话销售服务中心 )", //出票单位
  "IATA": "XXXXXX", //IATA号
  "PNR": "XXXXXX", //PNR号
  "TICKETINFORMATION": "CA1501T3 乘机", //机票票面提示信息
  "INSURANCE": "XXX", //保险信息
  "ELECTRONICTICKETTYPE": "0", //机票类型 0：国内 1：国际
  "VERIFYCODE": "ielldje", //验证码
  "OVERDUEFLAG": "false", //超期标识true: 超期 false: 未超期
  "GMF_DZDH": "",
  "GMF_YHZH": "",
  "KPR": "hett",
  "SKR": "hett",
  "FHR": "hett",
  "JSHJ": 1420.00,
  "HJJE": 1306.88,
  "HJSE": 113.12,
  "BZ": "",
  "BMB_BBH": "28.0",
  "XSF_DZ": "北京",
  "XSF_DH": "13141422555",
  "XSF_YH": "北京",
  "XSF_ZH": "65456787889",
  "GMF_DZ": "",
  "GMF_DH": null,
  "GMF_YH": "",
  "GMF_ZH": "",
  "items": [{
    "FPHXZ": 0,
    "XMMC": "*运输服务*票价",
    "XMBM": "3040502020101000000",
    "GGXH": "",
    "XMJE": 1238.53,
    "XMJSHJ": ,
    "SL": 0.09,
    "SE": 111.47,
    "HH": 1,
    "SPBM": "3040502020101000000",
    "DW": "",
    "XMSL": "",
  },
    {
      "FPHXZ": 0,
      "XMMC": "*运输服务*燃油附加费",
      "XMBM": "3040502020101000000",
      "GGXH": "",
      "XMJE": 18.35,
      "XMJSHJ": ,
      "SL": 0.09,
      "SE": 0,
      "HH": 2,
      "SPBM": "3040502020101000000",
      "DW": "",
      "XMSL": "",
    },
    {
      "FPHXZ": 0,
      "XMMC": "*运输服务*代收民航发展基金",
      "XMBM": "3040502020101000000",
      "GGXH": "",
      "XMJE": 50,
      "XMJSHJ": ,
      "SL": 0.00,
      "LSLBS": "3",
      "SE": 0,
      "HH": 3,
      "SPBM": "3040502020101000000",
      "DW": "",
      "XMSL": "",
    },
    {
      "FPHXZ": 0,
      "XMMC": "*运输服务*其他",
      "XMBM": "3040502020101000000",
      "GGXH": "",
      "XMJE": 0,
      "XMJSHJ": ,
      "SL": 0.00,
      "LSLBS": "3",
      "SE": 0,
      "HH": 4,
      "SPBM": "3040502020101000000",
      "DW": "",
      "XMSL": "",
    }

  ],
  "tspzs": [{
    "CXRXH": "1", //出行人序号
    "CXR": "张三", //承运人名称
    "CARRIERCODE": "CA", //承运人二字码
    "CHUXRQ": "2022-11-01 08:30 ", //出行日期，格式yyyy-MM-dd HH:mm
    "CFD": "北京-首都###T3###PEK", //出发地
    "LKDDD": "上海-虹桥###T2###SHA", //到达地
    "ZWDJ": "Y", //座位等级
    "YSGJPH": "2" //航班号
    "FAREBASIS": "Y" //客票级别/客票类别
    "NOTVALIDBEFORE": "2024-05-17" //客票生效日期
    "NOTVALIDAFTER": "2024-05-17" //有效截至日期
    "ALLOW": "20K" //免费行李
    "ITINERARYTYPE": "0" //行程类型 0：普通运输段 1：地面运输
  }]
}]

# 返回结果说明

参数	类型	描述	说明
code	String	状态码	详见状态码说明
msg	String	信息说明

# 返回样例

{
	"code": "0000", 
	"msg": "success"
}

# 开蓝票-自动拆分

# 请求体参数

# 表单说明

参数	描述	说明
requestdatas	开票申请发票信息，包含发票头、发票明细
email	邮件推送配置(可选)
sms	短信推送配置(可选)
url	回调服务配置(可选)
autoAudit	是否自动审核(可选)	true:自动审核，即不需要人工在发票平台确认开票，直接进行开票 false:不自动审核，即需要人工确认如果不传，代表true
nc6x-ubl	ncc友企联回调参数

# 发票头

参数	类型	长度	是否必填	默认值	描述	说明
FPQQLSH	String	20	是		发票请求流水号
FPLX	String	1	否	1	发票类型	1：增值税电子普通发票； 2：增值税电子专用发票； 3：增值税普通发票； 4：增值税专用发票、增值税专用发票(机动车)； 5：机动车销售统一发票； 8：增值税电子普通发票（成品油）； 10：成品油普通发票； 11：成品油专用发票； 15：二手车销售统一发票； 31：数电专用发票； 32：数电普通发票； 33：数电纸质发票(增值税专用发票)； 34：数电纸质发票(普通发票)；
XSF_NSRSBH	String	20	是		销售方纳税人识别号
XSF_MC	String	100	是		销售方名称	如果为空，获取发票平台配置的销售方名称
XSF_DZDH	String	100	是		销售方地址、电话	如果为空，获取发票平台配置的销售方地址及电话
XSF_DZ	String	300	否		销售方地址	如果为空，获取发票平台配置的销售方地址（数电专用字段）
XSF_DH	String	60	否		销售方电话	如果为空，获取发票平台配置的销售方电话（数电专用字段）
XSF_YHZH	String	100	否		销售方银行、账号	如果为空，获取发票平台配置的销售方银行及账号
XSF_YH	String	120	否		销售方银行	如果为空，获取发票平台配置的销售方银行（数电专用字段）
XSF_ZH	String	100	否		销售方账号	如果为空，获取发票平台配置的销售方账号（数电专用字段）
GMF_NSRSBH	String	20	否		购买方纳税人识别号	发票类型31 数电专用发票（必填）
GMF_MC	String	100	是		购买方名称
GMF_DZDH	String	100	否		购买方地址、电话	数电票此字段非必填
GMF_YHZH	String	100	否		购买方银行、账号	数电票此字段非必填
GMF_DZ	String	300	否		购买方地址	（数电专用字段）
GMF_DH	String	60	否		购买方电话	如果为空，获取发票平台配置的购买方地址（数电专用字段）
GMF_YH	String	120	否		购买方银行	如果为空，获取发票平台配置的购买方电话（数电专用字段）
GMF_ZH	String	100	否		购买方账号	如果为空，获取发票平台配置的购买方账号（数电专用字段）
ALLELCUSERNAME	String	300	否		数电发票用户名	如果发票类型是数电发票用户名必填，并且是国密四密文（数电专用字段）
ALLELCPASSWORD	String	300	否		数电发票密码	如果发票类型是数电发票密码必填，并且是国密四密文（数电专用字段）
KPR	String	8	否		开票人	如果为空，获取发票平台配置的开票人
SKR	String	8	否		收款人	如果为空，获取发票平台配置的收款人
FHR	String	8	否		复核人	如果为空，获取发票平台配置的复核人
SLSM	String	1	否		税率说明	1：当小规模纳税人开具3%税率时需要填写税率说明 2：前期已开具发票，发生销售折让、中止或者退回等情形需要开具红字发票，或者开票有误需要重新开具； 3：因为实际经营业务需要，放弃享受减按1%征收率征收增值税政策。
JSHJ	BigDecimal	15,2	是		价税合计	两位小数。明细价税合计之和必须与总的价税合计一致
HJJE	BigDecimal	15,2	否		合计金额	两位小数。为空时，根据明细项目进行合计。
HJSE	BigDecimal	15,2	否		合计税额	两位小数。为空时，根据明细项目进行合计。
BZ	String	230	否		备注	长度不能大于230
LYID	String	100	否		请求来源唯一标识
BMB_BBH	String	20	否	13.0	编码版本号	增加商品编码功能后，税局下载的商品编码表版本
ORGCODE	String	50	否		开票点编码	支持一个公司多个开票点场景。如果为空，获取默认的开票点
PROJECTCODE	String	50	否		项目编号	https://developers.weixin.qq.com/doc/offiaccount/WeChat_Invoice/E_Invoice/Instruction.html
WXORDERID	String		否		微信订单号	商户开票完成后，传入订单号和商户id将自动插入用户微信卡包(参考`微信卡包指引`) (opens new window)
WXAPPID	String		否		微信商户id	商户开票完成后，传入订单号和商户id将自动插入用户微信卡包(参考`微信卡包指引`) (opens new window)
TSPZ	String	1	否		特殊票种	0-一般 2-燃油增值税专用发票 8-农产品销售 9-农产品收购 11-烟草发票 12-机动车发票 14-成品油发票 DK-代开发票 16-矿产品发票 E01-成品油发票 E03-建筑服务发票 E04 货物运输 E05-不动产销售 E06-不动产租赁服务发票 E07-代收车船税 E09-旅客运输 E12-自产农产品销售 E16-农产品收购 E17-光伏收购 E18-卷烟发票
LYDJH	String	200	否		业务来源单据号

# 发票明细

参数	类型	长度	是否必填	默认值	描述	说明
FPHXZ	Integer	2	否	0	发票行性质	0-正常行1-折扣行2-被折扣行
XMMC	String	600	是		项目名称
GGXH	String	150	否		规格型号	非数电发票规格型号最大长度为40个字符，数电发票长度为150个字符
DW	String	300	否		单位	如果是成品油发票，必填且只能是"吨或升"<\br>如果是矿产品发票，必填且只能是"立方米、吨、千克、克或克拉"
XMSL	BigDecimal	15,6	否		项目数量	如果是成品油发票，必填。
XMDJ	BigDecimal	15,6	否		项目单价	项目单价为空时，根据项目金额反算。不为空时不进行计算
XMJE	BigDecimal	15,2	否		项目金额	项目金额为空，根据项目价税合计反算。不为空时不进行计算
XMJSHJ	BigDecimal	15,2	是		项目价税合计
SL	BigDecimal	6,6	是		税率	6 位小数，例 17%为 0.17
SE	BigDecimal	15,2	否		税额	税额为空，根据价税合计反算。不为空时不进行计算。
HH	string	60	否		行号	有折扣时需要必输
ZKHHH	string	60	否		折扣行行号	有折扣时需要必输
SPBM	string	19	是		商品编码	税收分类编码
ZXBM	string	20	否	10	商品自行编码
YHZCBS	int	2	否	0	享受优惠标识	0：不使用，1：使用
LSLBS	string	1	否		零税率标识	空：非零利率，0：出口退税，1：免税，2：不征收，3普通零税率
ZZSTSGL	string	50	否		优惠政策说明	按3%简易征收,按5%简易征收 (此字段非空时，享受优惠标识YHZCBS字段值需为1)
KCE	BigDecimal	15,2	否		扣除额	扣除额

# 邮件推送配置

参数	类型	长度	是否必填	默认值	描述	说明
fpqqlsh	String	20	是		发票请求流水号	必须和上面的开票请求对应
address	String	500	是		接收地址	接收地址，多个地址使用","分隔开

# 短信推送配置

参数	类型	长度	是否必填	默认值	描述	说明
fpqqlsh	String	20	是		发票请求流水号	必须和上面的开票请求对应
address	String	500	是		接收地址	接收地址，多个地址使用","分隔开

# 回调服务配置

参数	类型	长度	是否必填	描述	说明
fpqqlsh	String	20	是	发票请求流水号	必须和上面的开票请求对应
url	String	500	是	回调url	开票申请调用方配置回调url，当电子发票开具成功后，调用此服务，POST电子发票相关信息。信息包含：1、pdf版式文件2、发票数据、3、发票下载链接ncc通过友企联方案回调可不传此参数
intf	String	200	否	ncc回调接口名	ncc通过友企联方案回调时必传
method	String	200	否	ncc回调方法名	ncc通过友企联方案回调时必传

# 请求样例

标准表单参数样例

requestdatas=[ {
	"FPQQLSH" : "12345678901234567890",
	"XSF_NSRSBH" : "销售方纳税人识别号",
	"XSF_MC" : "销售方名称",
	"XSF_DZDH" : "销售方地址、电话",
    "XSF_DZ" : "销售方地址",  （数电专用字段）
    "XSF_DH" : "销售方电话",（数电专用字段）
	"XSF_YHZH" : "销售方银行、账号",
    "XSF_YH" : "销售方银行",（数电专用字段）
    "XSF_ZH" : "销售方账号",（数电专用字段）
	"GMF_NSRSBH" : "购买方纳税人识别号", （发票类型31 数电专用发票（必填））（数电专用字段）
	"GMF_MC" : "购买方名称",
	"GMF_DZDH" : "购买方地址、电话",
    "GMF_DZ" : "购买方地址",（数电专用字段）
    "GMF_DH" : "购买方电话",（数电专用字段）
	"GMF_YHZH" : "购买方银行、账号",
    "GMF_YH" : "购买方银行",（数电专用字段）
    "GMF_ZH" : "购买方账号",（数电专用字段）
    "ALLELCUSERNAME": "电子税务局用户名（发票类型为数电发票时必传并且是国密四密文）",（数电专用字段）
    "ALLELCPASSWORD": "电子税务局密码 （发票类型为数电发票时必传并且是国密四密文）",  （数电专用字段）
	"KPR" : "开票人",
	"SKR" : "收款人",
	"FHR" : "复核人",
	"JSHJ" : "价税合计",
	"HJJE" : "合计金额",
	"HJSE" : "合计税额",
	"BZ" : "备注",
	"BMB_BBH" : "10.0",
	"items" : [{
            "FPHXZ" : "发票行性质",
            "XMMC" : "项目名称",
            "GGXH" : "规格型号",
            "DW" : "单位",
            "XMSL" : "项目数量",
            "XMDJ" : "项目单价",
            "XMJE" : "项目金额",
            "XMJSHJ" : "项目价税合计",
            "SL" : "税率",
            "SE" : "税额",
            "HH":"行号",
            "SPBM":"商品编码",
            "ZXBM":"自行编码"
            "KCE":300
		}
	]
}]
&email=[
    {
	    "fpqqlsh":"12345678901234567890",
        "address": "x1@yonyou.com,x2@yonyou.com", 
    }, 
    {
	    "fpqqlsh":"12345678901234567890",
        "address": "x3@yonyou.com", 
    }
]
&sms=[{
	"fpqqlsh":"12345678901234567890",
        "address": "13511111111,13511111112", 
    }]
&url=[{
		"fpqqlsh":"12345678901234567890",
        "url": "http://url.com/msg"
    }]
&nc6x-ubl=[{
        "fpqqlsh":"12345678901234567890",
        "method":"queryUserPermAppPksOrCodes",
        "intf":"nccloud.pubitf.baseapp.apprbac.IAppAndOrgPermQueryPubService"   
}]
&autoAudit=true

最小请求参数样例

TIP

销售方地址及电话、银行及账号、销售方名称可以通过销售方纳税人识别号获取

requestdatas=[{
	"FPQQLSH" : "12345678901234567890",
    "XSF_NSRSBH" : "销售方纳税人识别号",
    "GMF_MC" : "购买方名称",
    "JSHJ" : 117,
    "items" : 
		    [
			    {
		            "XMMC" : "项目名称",
		            "XMSL" : 1,
		            "XMJSHJ" : 117,
		            "SL" : 0.17
		        }
		    ]
}]

包含折扣行开票样例

TIP

requestdatas=[{
	"FPQQLSH" : "12345678901234567890",
    "XSF_NSRSBH" : "销售方纳税人识别号",
    "GMF_MC" : "购买方名称",
    "JSHJ" : 799,
    "items" : 
		    [
			    {
				    "FPHXZ" : 2,
		            "XMMC" : "项目名称",
		            "XMSL" : 1,
		            "XMJSHJ" : 899,
		            "SL" : 0.17,
		            "HH":"1",
		            "ZKHHH":"2"
		        },
		        {
			        "FPHXZ" : 1,
		            "XMMC" : "项目名称",
		            "XMJSHJ" : -100,
		            "SL" : 0.17,
		            "HH":"2",
		        }
		    ]
}]

# 返回结果说明

参数	类型	描述	说明
code	String	状态码	详见状态码说明
msg	String	信息说明
datas	JSONArray	拆分结果数据	拆分结果数据

# 拆分结果数据

发票头数据

参数	类型	必填	描述	说明
bmbBbh	String	否	商品编码表版本
fpjz	String	否	发票介质 0.电票 2.纸票
fplx	String	是	发票类型	详见发票类型
fpzt	String	否	发票状态	详见发票状态
kplx	String	是	开票类型 0.蓝票 1.红票
lylx	String	否	来源类型	详见开票来源类型
lyid	String	否	存储ID	存储拆分前发票的发票请求流水号
zdrq	String	否	制单日期
zsfs	String	否	征税方式：0.征税 2.差额
fpqqlsh	String	是	发票请求流水号	拆分后的发票请求流水号
jqbh	String	否	机器编号
fpHm	String	是	发票号码
fpDm	String	是	发票代码
fpMw	String	否	发票密文
jym	String	否	校验码
kprq	String	否	开票日期	格式YYYYMMDDHHMMSS
gmfDzdh	String	否	购买方地址、电话
gmfMc	String	是	购买方名称
gmfNsrsbh	String	否	购买方纳税人识别号
gmfYhzh	String	否	购买方银行、账户
xsfDzdh	String	否	销售方地址、电话
xsfMc	String	是	销售方名称
xsfNsrsbh	String	是	销售纳税人识别号
xsfYhzh	String	否	销售方银行、账户
yfpDm	String	否	原发票代码
yfpHm	String	否	原发票号码
hjje	BigDecimal	是	合计金额
hjse	BigDecimal	否	合计税额
jshj	BigDecimal	是	价税合计
kpr	String	否	开票人
fhr	String	否	复核人
skr	String	否	收款人
bz	String	否	备注
zfbz	String	否	作废标志	Y:是；N否
bred	String	否	是否红冲	Y:是；N否
zdybz	String	否	自定义备注
items	Object	是	发票明细	发票明细数据

发票明细数据

参数	类型	必填	描述
xmmc	String	是	项目名称
ggxh	String	否	规格型号
spbm	String	否	商品编码
xmhsdj	String	否	项目含税单价
yhzcbs	String	否	销售优惠标识；0：不使用，1：使用
zxbm	String	否	商品自行编码
dw	String	否	单位
xmsl	doube	否	项目数量
xmdj	doube	否	项目单价
xmje	doube	是	项目金额
xmjshj	String	否	项目价税合计
sl	String	否	税率
se	String	否	税额
hh	string	否	行号

# 返回样例

{
    "code": "0000",
    "msg": "success",
    "datas": [
        {
            "bmbBbh": "13.0",
            "bz": "BZSHY",
            "fhr": "FHR",
            "fpjz": "0",
            "fplx": "1",
            "fpqqlsh": "shy100000000000006",
            "fpzt": "2",
            "gmfDzdh": "address",
            "gmfMc": "shy00004",
            "gmfNsrsbh": "214356654322666",
            "gmfYhzh": "213456543233523",
            "hjje": 30000,
            "hjse": 5100,
            "jshj": 35100,
            "kplx": 0,
            "kpr": "KPR",
            "lyid":"<对于确实已发生拆分行为的发票，这里是：拆分前发票的发票请求流水号FPQQLSH>",
            "lylx": "1",
            "skr": "SKR",
            "xsfDzdh": "XSFDZDH",
            "xsfMc": "测试3",
            "xsfNsrsbh": "111222333456333",
            "xsfYhzh": "6217000010005805406",
            "zdrq": 1505400195352,
            "zsfs": "0",
            "items": [
                {
                    "dw": "DW",
                    "fphxz": 0,
                    "ggxh": "GGXH",
                    "hh": "1",
                    "kce": 0,
                    "se": 5100,
                    "sl": 0.17,
                    "spbm": "1060301010100000000",
                    "xmdj": 15000,
                    "xmhsdj": 17550,
                    "xmje": 30000,
                    "xmjshj": 35100,
                    "xmmc": "JYZBSS",
                    "xmsl": 2,
                    "yhzcbs": 0,
                    "zkhhh": "",
                    "zxbm": "10"
                }
            ]
        }
    ]
}

# 发票红冲请求

# 请求体参数

# 表单说明

参数	描述	说明
requestdatas	发票红冲参数
email	邮件推送配置(可选)
sms	短信推送配置(可选)
url	回调服务配置(可选)
autoAudit	是否自动审核(可选)	true:自动审核，false:不自动审核。如果不传，代表false
nc6x-ubl	ncc友企联回调参数

# 发票红冲参数

参数	类型	长度	是否必填	描述	说明
FPQQLSH	String	20	是	发票请求流水号	注意不是蓝字的发票请求流水号，是本次发票红冲的请求流水号
fpDm	String	12	是	蓝字发票代码	被红冲的发票代码
fpHm	String	20	是	蓝字发票号码	被红冲的发票号码
GMF_MC	String	100	否	购买方名称
GMF_DZDH	String	100	否	购买方地址电话
GMF_YHZH	String	100	否	购买方银行账号
GMF_NSRSBH	String	100	否	购买方纳税人识别号
ORGCODE	String	50	否	开票点编码	如果一个税号对应多个开票点，此字段必输，用于确定唯一开票点
KPR	String	8	否	开票人	如果为空，获取发票平台配置的开票人
SKR	String	8	否	收款人	如果为空，获取发票平台配置的收款人
FHR	String	8	否	复核人	如果为空，获取发票平台配置的复核人
SLSM	String	1	否	税率说明	1：当小规模纳税人开具3%税率时需要填写税率说明 2：前期已开具发票，发生销售折让、中止或者退回等情形需要开具红字发票，或者开票有误需要重新开具；3：因为实际经营业务需要，放弃享受减按1%征收率征收增值税政策。
HCYY	String	1	否	红冲原因说明：1 销货退回 2 开票有误 3 开票中止 4 销售折让	数电发票红冲原因必填
hzxxbbh	String	20	否	红字信息表编号	专票红冲时必传
ALLELCUSERNAME	String	300	否	数电发票用户名	如果发票类型是数电发票用户名必填，并且是国密四密文（数电专用字段）
ALLELCPASSWORD	String	300	否	数电发票密码	如果发票类型是数电发票密码必填，并且是国密四密文（数电专用字段）
lydjh	String	200	否	业务来源单据号

# 邮件推送配置

参数	类型	长度	是否必填	默认值	描述	说明
fpqqlsh	String	20	是		发票请求流水号	必须和上面的开票请求对应
address	String	500	是		接收地址	接收地址，多个地址使用","分隔开

# 短信推送配置

参数	类型	长度	是否必填	默认值	描述	说明
fpqqlsh	String	20	是		发票请求流水号	必须和上面的开票请求对应
address	String	500	是		接收地址	接收地址，多个地址使用","分隔开

# 回调服务配置

参数	类型	长度	是否必填	描述	说明
fpqqlsh	String	20	是	发票请求流水号	必须和上面的开票请求对应
url	String	500	是	回调url	开票申请调用方配置回调url，当电子发票开具成功后，调用此服务，POST电子发票相关信息。信息包含：1、pdf版式文件2、发票数据、3、发票下载链接ncc通过友企联方案回调可不传此参数
intf	String	200	否	ncc回调接口名	ncc通过友企联方案回调时必传
method	String	200	否	ncc回调方法名	ncc通过友企联方案回调时必传

# 请求样例

表单参数如下

requestdatas=[
    {
        "fpHm": "03091804", 
        "fpDm": "000000000000", 
        "FPQQLSH": "test1101",
        "hzxxbbh":"1101081902045091",(数电专票红冲暂不需要红字信息表)
        "HCYY" :"1",  （数电发票红冲原因必填）
      "ALLELCUSERNAME": "电子税务局用户名（发票类型为数电发票时必传并且是国密四密文）", (数电专用字段）
      "ALLELCPASSWORD": "电子税务局密码 （发票类型为数电发票时必传并且是国密四密文）"   (数电专用字段）
    }
] 
&email=[
    {
	    "fpqqlsh":"12345678901234567890",
        "address": "x1@yonyou.com,x2@yonyou.com"
    }, 
    {
	    "fpqqlsh":"12345678901234567890",
        "address": "x3@yonyou.com"
    }
]
&sms=[{
	"fpqqlsh":"12345678901234567890",
        "address": "13511111111,13511111112"
    }]
&url=[{
		"fpqqlsh":"12345678901234567890",
        "url": "http://url.com/msg"
    }]
&nc6x-ubl=[{
        "fpqqlsh":"12345678901234567890",
        "method":"queryUserPermAppPksOrCodes",
        "intf":"nccloud.pubitf.baseapp.apprbac.IAppAndOrgPermQueryPubService"   
}]
&autoAudit=true

# 返回结果说明

参数类型描述说明

code String 状态码详见状态码说明

msg String 信息说明

# 返回样例

{
    "code": "0000", 
    "msg": "success"
}

# 发票部分红冲

# 请求体参数

# 表单说明

参数	描述	说明
requestdatas	开票申请发票信息，包含发票头、发票明细
email	邮件推送配置(可选)
sms	短信推送配置(可选)
url	回调服务配置(可选)
autoAudit	是否自动审核(可选)	true:自动审核，即不需要人工在发票平台确认开票，直接进行开票 false:不自动审核，即需要人工确认如果不传，代表true
nc6x-ubl	ncc友企联回调参数

# 发票头

参数	类型	长度	是否必填	默认值	描述	说明
FPQQLSH	String	20	是		发票请求流水号	注意不是蓝字的发票请求流水号，是本次发票红冲的请求流水号
fpDm	String	12	是		蓝字发票代码	被红冲的发票代码
fpHm	String	8	是		蓝字发票号码	被红冲的发票号码
GMF_MC	String	100	否		购买方名称
GMF_DZDH	String	100	否		购买方地址电话
GMF_YHZH	String	100	否		购买方银行账号
GMF_NSRSBH	String	100	否		购买方纳税人识别号
KPR	String	8	否		开票人	如果为空，获取发票平台配置的开票人
SKR	String	8	否		收款人	如果为空，获取发票平台配置的收款人
FHR	String	8	否		复核人	如果为空，获取发票平台配置的复核人
SLSM	String	1	否		税率说明	1：当小规模纳税人开具3%税率时需要填写税率说明 2：前期已开具发票，发生销售折让、中止或者退回等情形需要开具红字发票，或者开票有误需要重新开具； 3：因为实际经营业务需要，放弃享受减按1%征收率征收增值税政策。
HCYY	String	1	否		红冲原因说明：1 销货退回 2 开票有误 3 服务中止 4 销售折让	数电发票红冲原因必填
JSHJ	BigDecimal	15,2	是		价税合计	两位小数。明细价税合计之和必须与总的价税合计一致；价税合计小于0，并且绝对值不能大于蓝票
HJJE	BigDecimal	15,2	否		合计金额	两位小数。为空时，根据明细项目进行合计。合计金额小于0，并且绝对值不能大于蓝票
HJSE	BigDecimal	15,2	否		合计税额	两位小数。为空时，根据明细项目进行合计。
LYID	String	100	否		请求来源唯一标识
BMB_BBH	String	20	否	13.0	编码版本号	增加商品编码功能后，税局下载的商品编码表版本
ORGCODE	String	50	否		开票点编码	如果一个税号对应多个开票点，此字段必输，用于确定唯一开票点
hzxxbbh	String	20	否		红字信息表编号	专票红冲时必传
ALLELCUSERNAME	String	300	否		数电发票用户名	如果发票类型是数电发票用户名必填，并且是国密四密文（数电专用字段）
ALLELCPASSWORD	String	300	否		数电发票密码	如果发票类型是数电发票密码必填，并且是国密四密文（数电专用字段）
lydjh	String	200	否		业务来源单据号

# 发票明细

参数	类型	长度	是否必填	描述	说明
XMMC	String	90	是	项目名称
XMBM	String	90	否	项目编码	如果项目名称为空，会根据项目编码匹配云平台的商品档案
GGXH	String	40	否	规格型号	非数电发票规格型号最大长度为40个字符，数电发票长度为150个字符
DW	String	20	否	单位
XMSL	BigDecimal	15,6	否	项目数量	项目数量必须小于0
XMDJ	BigDecimal	15,6	否	项目单价	项目单价为空时，根据项目金额反算。不为空时不进行计算；
XMJE	BigDecimal	15,2	否	项目金额	项目金额为空，根据项目价税合计反算。不为空时不进行计算；金额必须小于0
XMJSHJ	BigDecimal	15,2	是	项目价税合计	价税合计必须小于0
SL	BigDecimal	6,6	是	税率	6 位小数，例 17%为 0.17
SE	BigDecimal	15,2	否	税额	税额为空，根据价税合计反算。不为空时不进行计算。
HH	string	60	否	行号	有折扣时需要必输
SPBM	string	19	否	商品编码	税收分类编码

# 邮件推送配置

参数	类型	长度	是否必填	默认值	描述	说明
fpqqlsh	String	20	是		发票请求流水号	必须和上面的开票请求对应
address	String	500	是		接收地址	接收地址，多个地址使用","分隔开

# 短信推送配置

参数	类型	长度	是否必填	默认值	描述	说明
fpqqlsh	String	20	是		发票请求流水号	必须和上面的开票请求对应
address	String	500	是		接收地址	接收地址，多个地址使用","分隔开

# 回调服务配置

参数	类型	长度	是否必填	描述	说明
fpqqlsh	String	20	是	发票请求流水号	必须和上面的开票请求对应
url	String	500	是	回调url	开票申请调用方配置回调url，当电子发票开具成功后，调用此服务，POST电子发票相关信息。信息包含：1、pdf版式文件2、发票数据、3、发票下载链接ncc通过友企联方案回调可不传此参数
intf	String	200	否	ncc回调接口名	ncc通过友企联方案回调时必传
method	String	200	否	ncc回调方法名	ncc通过友企联方案回调时必传

# 返回结果说明

参数	类型	描述	说明
code	String	状态码	详见状态码说明
msg	String	信息说明

# 返回样例

{
	"code": "0000", 
	"msg": "success"
}

# 请求样例

标准表单参数样例

requestdatas=[ {
	"FPQQLSH" : "12345678901234567890",
	"fpHm": "03091804", 
	"fpDm": "000000000000", 
	"KPR" : "开票人",
	"SKR" : "收款人",
	"FHR" : "复核人",
	"JSHJ" : "价税合计",
	"HJJE" : "合计金额",
	"HJSE" : "合计税额",
    "hzxxbbh":"1101081902045091",
	"items" : [{
            "XMMC" : "项目名称",
            "GGXH" : "规格型号",
            "DW" : "单位",
            "XMSL" : "项目数量",
            "XMDJ" : "项目单价",
            "XMJE" : "项目金额",
            "XMJSHJ" : "项目价税合计",
            "SL" : "税率",
            "SE" : "税额",
            "HH":"行号",
            "SPBM":"商品编码"
		}
	]
}]
&email=[
    {
	    "fpqqlsh":"12345678901234567890",
        "address": "x1@yonyou.com,x2@yonyou.com"
    }, 
    {
	    "fpqqlsh":"12345678901234567890",
        "address": "x3@yonyou.com"
    }
]
&sms=[{
	"fpqqlsh":"12345678901234567890",
        "address": "13511111111,13511111112"
    }]
&url=[{
		"fpqqlsh":"12345678901234567890",
        "url": "http://url.com/msg"
    }]
&nc6x-ubl=[{
        "fpqqlsh":"12345678901234567890",
        "method":"queryUserPermAppPksOrCodes",
        "intf":"nccloud.pubitf.baseapp.apprbac.IAppAndOrgPermQueryPubService"   
}]
&autoAudit=true

最小请求参数样例

TIP

销售方地址及电话、银行及账号、销售方名称可以通过销售方纳税人识别号获取

requestdatas=[{
    "FPQQLSH" : "12345678901234567890",
    "fpHm": "03091804", 
    "fpDm": "000000000000", 
    "JSHJ" : -117,
    "items" : 
		    [
			    {
		            "XMMC" : "项目名称",
		            "SPBM" : "1010101020000000000",
		            "XMJSHJ" : -117,
		            "SL" : 0.17
		        }
		    ]
}]

# 数电红字申请表添加并上传

# 请求体参数

# 发票头

参数	类型	长度	是否必填	默认值	描述	说明
hjje	BigDecimal	15,6	是		合计金额	合计金额，必传负数
hjse	BigDecimal	15,6	是		合计税额	合计税额，必传负数
jshj	BigDecimal	15,6	是		价税合计	价税合计，必传负数
BMB_BBH	String	20	否	13.0	编码版本号	增加商品编码功能后，税局下载的商品编码表版本
corpid	String	20	是		租户ID	租户ID 必填
fpHm	String	8	是		蓝字发票号码	被红冲的发票号码
yfpHm	String	8	是		原发票号码	原发票号码，必填
fplx	String	1	是		发票类型	31：数电专用发票； 32：数电普通发票；
FPQQLSH	String	20	是		发票请求流水号	注意不是蓝字的发票请求流水号，是本次发票红冲的请求流水号
fqfGXF	String	1	是		购销方	0：销方；1：购方
fqfNsrshbh	String	100	是		发起方税号	发起方税号，必填
gmfMc	String	100	否		购买方名称
gmfDzdh	String	100	否		购买方地址电话
gmfYhzh	String	100	否		购买方银行账号
gmfNsrsbh	String	100	否		购买方纳税人识别号
hzxxbbh	String	20	否		红字信息表编号	专票红冲时必传,数电专票红冲暂不需要红字信息表
fplx	String	1	是		开票类型	0.蓝票 1.红票
kpr	String	8	否		开票人	如果为空，获取发票平台配置的开票人
orgcode	String	50	否		开票点编码	如果一个税号对应多个开票点，此字段必输，用于确定唯一开票点
xsfMc	String	100	是		购买方名称
xsfDzdh	String	100	否		购买方地址电话
xsfYhzh	String	100	否		购买方银行账号
xsfNsrsbh	String	100	是		购买方纳税人识别号
lyid	String	100	否		请求来源唯一标识
kprq	String	10	是		蓝票开票日期	蓝票开票日期必传格式为：yyyyMMdd
zdrq	String	20	否		制单时间	制单时间格式为：yyyyMMdd
lylx	String	1	否		来源类型
HCYY	String	1	否		红冲原因说明：1 销货退回 2 开票有误 3 服务中止 4 销售折让	数电发票红冲原因必填,当发票类型是（增值税普通发票、增值税电子普通发票、增值税普通发票（卷式）、增值税电子普通发票（成品油）、增值税普通发票（成品油）、增值税普通发票（收购）、电子收购发票、数电专用发票、数电普通发票）时需要填写红冲原因
orgId	String	20	是		组织ID	组织ID 必传
zsfs	String	1	否		征收方式	征收方式 0-普通征税 2-差额征税

# 发票明细

参数	类型	长度	是否必填	默认值	描述	说明
fphxz	Integer	2	否	0	发票行性质	0-正常行1-折扣行2-被折扣行
xmmc	String	600	是		项目名称
ysxmmc	String	600	是		原项目名称
ggxh	String	150	否		规格型号	非数电发票规格型号最大长度为40个字符，数电发票长度为150个字符
dw	String	300	否		单位	如果是成品油发票，必填且只能是"吨或升"<\br>如果是矿产品发票，必填且只能是"立方米、吨、千克、克或克拉"
xmsl	BigDecimal	15,6	否		项目数量	如果是成品油发票，必填。
xmdj	BigDecimal	15,6	否		项目单价	项目单价为空时，根据项目金额反算。不为空时不进行计算
xmhsdj	BigDecimal	15,6	否		项目含税单价
xmje	BigDecimal	15,2	否		项目金额	项目金额为空，根据项目价税合计反算。不为空时不进行计算
xmjshj	BigDecimal	15,2	是		项目价税合计
sl	BigDecimal	6,6	是		税率	6 位小数，例 17%为 0.17
se	BigDecimal	15,2	否		税额	税额为空，根据价税合计反算。不为空时不进行计算。
hh	string	60	否		行号	有折扣时需要必输
LZMXXH	string	60	是		蓝字发票行号	蓝字发票行号，必填
zkhhh	string	60	否		折扣行行号	有折扣时需要必输
spbm	string	19	是		商品编码	税收分类编码
zxbm	string	20	否	10	商品自行编码
yhzcbs	int	2	否	0	享受优惠标识	0：不使用，1：使用
lslbs	string	1	否		零税率标识	空：非零利率，0：出口退税，1：免税，2：不征收，3普通零税率
hsbz	string	1	否		含税标志	N：不含税；Y：含税
zzstsgl	string	50	否		优惠政策说明（增值税特殊管理）	按3%简易征收,按5%简易征收 (此字段非空时，享受优惠标识YHZCBS字段值需为1)
kce	BigDecimal	15,2	否		扣除额	扣除额

# 返回结果说明

TIP

返回接口见api文档返回值参数

# 请求样例

标准表单参数样例

{
  "bmbBbh": "10.0",
  "corpid": "0000LEC83AYQD8S8W60000",
  "fpHm": "23881000000000000358",
  "fplx": "32",
  "fpqqlsh": "1646146274230431745", 
  "fqfGXF": "0", 
  "fqfNsrshbh": "91333000160983680C", 
  "gmfDzdh": null,
  "gmfMc": "panda一夜暴富哎哈哈", 
  "gmfNsrsbh": "111112222233333", 
  "gmfYhzh": null,
  "hcyy": "2", 
  "hjje": -1769.91, 
  "hjse": -230.09, 
  "hzxxbbh": null, 
  "items": [{
    "dw": "元",
    "fphxz": 0, 
    "ggxh": "11",
    "hh": "1", 
    "hsbz": "", 
    "kce": 0, 
    "lslbs": "",
    "LZMXXH": "1", 
    "se": -230.09, 
    "sl": 0.13,
    "spbm": "1090511030000000000", 
    "xmdj": null, 
    "xmhsdj": null, 
    "xmje": -1769.91, 
    "xmjshj": -2000, 
    "xmmc": "*计算机外部设备*通信设备计算机", 
    "xmsl": null, 
    "yhzcbs": 0,
    "ysxmmc": "通信设备计算机", 
    "zkhhh": "", 
    "zxbm": "10", 
    "zzstsgl": ""
  }],
  "jshj": -2000,
  "kplx": 1,
  "kpr": "税务测试管理员", 
  "kprq": "2022-12-30", 
  "lyid": null, 
  "lylx": "1",
  "orgcode": null,
  "orgId": "1664546805189705737",
  "xsfDzdh": "22 83121212",
  "xsfMc": "微乐",
  "xsfNsrsbh": "91333000160983680C",
  "xsfYhzh": "2 1231312123123", 
  "yfpHm": "23881000000000000358", 
  "zdrq": "2023-04-06 19:35:09", 
  "zsfs": "0",
  "urls": ["http://test1111.cn1.utools.club/hello测试新增"]
}

最小请求参数样例

{
  "items": [{
    "dw": "一二三",
    "ggxh": "一二三四五六七八",
    "sl": "0.01",
    "xmmc": "*运输服务*橡皮",
    "ysxmmc": "橡皮",
    "xmdj": "23.0041942911",
    "xmhsdj": "23.234213",
    "xmjshj": "-100",
    "se": "-0.99",
    "xmje": "-99.01",
    "xmsl": "-4.3039977296",
    "spbm": "3213124314324322"
  }],
  "hjje": "-99.01",
  "jshj": "-100.00",
  "hjse": "-0.99",
  "orgCode": "test333",
  "gmfMc": "用友金融信息技术股份有限公司123",
  "gmfNsrsbh": "111222333456333",
  "xsfMc": "测试333",
  "fpdm": "151111513512",
  "fphm": "1511122",
  "xsfNsrsbh": "111222333456333",
  "reqMemo": "1100000000",
  "kprq": "202101",
  "reqBillNo": "3213121232123",
  "urls": ["http://test1111.cn1.utools.club/hello测试新增"]
}

# 回调服务说明

# NCC友企联回调数据样例

{
	"method": "queryUserPermAppPksOrCodes",
	"interface": "nccloud.pubitf.baseapp.apprbac.IAppAndOrgPermQueryPubService",
	"serviceMethodArgInfo": [
		{
			"agg": false,
			"argType": "java.lang.String",
			"isArray": false,
			"isPrimitive": false,
			"argValue": "{\"data\":\"{\"ewm\":\"01,10,68974368,010011652011,20160906,,12345678901234567890,\",\"fhr\":\"ljm111\",\"fpDm\":\"010011652011\",\"fpHm\":\"68974368\",\"fpMw\":\"<-<>48938<4+<14>735+<2554*8-1-<+15<*026+848686/2/3//0>+*>>>356*<757/47>90+<25<<3575**934<+15<*026+848686--57\",\"fplx\":\"1\",\"fpjz\":\"0\",\"fpqqlsh\":\"12345677901234567897\",\"bmbBbh\":\"10.0\",\"gmfMc\":\"测试开票用户\",\"hjje\":100.00,\"hjse\":17.00,\"jqbh\":\"111111111111\",\"jshj\":117,\"jym\":\"12345678901234567890\",\"kplx\":0,\"kpr\":\"2\",\"kprq\":\"20160906202718\",\"skr\":\"ljm111\",\"corpId\":\"5bdfc3b7-fd88-4947-8a50-2474b97d7eef\",\"orgId\":\"12010101\",\"xsfDzdh\":\"北京市海淀区 110\",\"xsfMc\":\"北京\",\"xsfNsrsbh\":\"111112222233333\",\"xsfYhzh\":\"1 1\",\"yfpDm\":\"\",\"yfpHm\":\"\",\"items\":[{\"fphxz\":0,\"se\":17.00,\"sl\":0.17,\"xmdj\":100.000000,\"xmje\":100.00,\"xmjshj\":117,\"xmmc\":\"项目名称\",\"spbm\":\"3070101000000000000\",\"zxbm\":\"10\",\"yhzcbs\":0,\"xmsl\":1}]}\",  \"code\":\"0000\",   \"msg\": \"开票成功\", \"fpqqlsh\": \"12345677901234567897\", \"pdf\": \"pdf文件流\",\"shareurl\": \"http://192.168.52.101/invoiceent-web/s/ab799b5413221cc19088a465d62f8c4f\",\"sharecode\": \"E3N2\" }"
		}
	]
}

# 常规回调数据样例


{
    "data": "{\"ewm\":\"01,10,68974368,010011652011,20160906,,12345678901234567890,\",\"zdybz\":\"自定义备注\",\"fhr\":\"ljm111\",\"fpDm\":\"010011652011\",\"fpHm\":\"68974368\",\"fpMw\":\"<-<>48938<4+<14>735+<2554*8-1-<+15<*026+848686/2/3//0>+*>>>356*<757/47>90+<25<<3575**934<+15<*026+848686--57\",\"fplx\":\"1\",\"fpjz\":\"0\",\"fpqqlsh\":\"12345677901234567897\",\"bmbBbh\":\"10.0\",\"gmfMc\":\"测试开票用户\",\"hjje\":100.00,\"hjse\":17.00,\"jqbh\":\"111111111111\",\"jshj\":117,\"jym\":\"12345678901234567890\",\"kplx\":0,\"kpr\":\"2\",\"kprq\":\"20160906202718\",\"skr\":\"ljm111\",\"corpId\":\"5bdfc3b7-fd88-4947-8a50-2474b97d7eef\",\"orgId\":\"12010101\",\"xsfDzdh\":\"北京市海淀区 110\",\"xsfMc\":\"北京\",\"xsfNsrsbh\":\"111112222233333\",\"xsfYhzh\":\"1 1\",\"yfpDm\":\"\",\"yfpHm\":\"\",\"items\":[{\"fphxz\":0,\"se\":17.00,\"sl\":0.17,\"xmdj\":100.000000,\"xmje\":100.00,\"xmjshj\":117,\"xmmc\":\"项目名称\",\"spbm\":\"3070101000000000000\",\"zxbm\":\"10\",\"yhzcbs\":0,\"xmsl\":1}]}",
    "code": "0000",
    "msg": "开票成功",
    "fpqqlsh": "12345677901234567897",
    "pdf": "pdf/ofd文件流base64",
    "shareurl": "http://192.168.52.101/invoiceent-web/s/ab799b5413221cc19088a465d62f8c4f?tenantId=ab2c",
    "sharecode": "E3N2",
	"fileType": "ofd"
}

# 回调服务参数

参数	类型	描述	说明
code	String	开票信息码	0000代表开票成功
msg	String	开票失败信息
fpqqlsh	String	发票请求流水号
fileType	String	文件类型	增值税电子专用发票、电子发票（增值税专用发票）为ofd格式；其他为pdf格式；
pdf	String	pdf文件	使用Base64解码为二进制流，可以保存为pdf或ofd文件
shareurl	String	发票提取url
sharecode	String	发票提取码	与提取url配合使用
data	String	发票详细信息	回调服务发票详细信息

# 回调服务发票详细信息

发票头数据

参数	类型	描述	说明
bmbBbh	String	商品编码表版本
fpjz	String	发票介质 0.电票 2.纸票
fplx	String	发票类型
fpzt	String	发票状态
kplx	String	开票类型 0.蓝票 1.红票
lylx	String	来源类型
lyid	String	存储ID	存储拆分前发票的发票请求流水号
zdrq	String	制单日期
zsfs	String	征税方式：0.征税 2.差额
fpqqlsh	String	发票请求流水号
jqbh	String	机器编号
fpHm	String	发票号码
fpDm	String	发票代码
fpMw	String	发票密文
jym	String	校验码
kprq	String	开票日期	格式YYYYMMDDHHMMSS
gmfDzdh	String	购买方地址、电话
gmfMc	String	购买方名称
gmfNsrsbh	String	购买方纳税人识别号
gmfYhzh	String	购买方银行、账户
xsfDzdh	String	销售方地址、电话
xsfMc	String	销售方名称
xsfNsrsbh	String	销售纳税人识别号
xsfYhzh	String	销售方银行、账户
yfpDm	String	原发票代码
yfpHm	String	原发票号码
hjje	BigDecimal	合计金额
hjse	BigDecimal	合计税额
jshj	BigDecimal	价税合计
kpr	String	开票人
fhr	String	复核人
skr	String	收款人
bz	String	备注
zfbz	String	作废标志	Y:是；N否
bred	String	是否红冲	Y:是；N否
zdybz	String	自定义备注
items	Object	发票明细	发票明细数据

发票明细数据

参数	类型	描述
xmmc	String	项目名称
ggxh	String	规格型号
spbm	String	商品编码
xmhsdj	String	项目含税单价
yhzcbs	String	销售优惠标识；0：不使用，1：使用
zxbm	String	商品自行编码
dw	String	单位
xmsl	doube	项目数量
xmdj	doube	项目单价
xmje	doube	项目金额
xmjshj	String	项目价税合计
sl	String	税率
se	String	税额
hh	string	行号

# 回调服务返回结果

回调服务对回调信息处理后，需要返回处理结果信息。返回参数约定如下：

参数	类型	描述	说明
code	String	处理结果编码	0000：表示回调服务处理成功
msg	String	处理结果明细信息	回调处理的明细信息。如果存在错误，此处为错误信息

# 退回数据样例


{"fpqqlsh":"20230512123343121","backCause":"测试退回数据","xsfNsrsbh":"201609140000001"}

# 待开票明细回调

# 待开票明细回传结果样例

[{
"data":"{\"djqqlsh\":\"2023033101480035\",\"corpId\":\"um86vloe\",\"orgId\":1467284815433695241,\"orgName\":\"百望888开票点\",\"code\":\"1641688270826569728\",\"fplx\":\"3\",\"xsfNsrsbh\":\"111222333456888\",\"xsfMc\":\"用友税务云\",\"xsfDzdh\":\"测试地址和电话 13144445555\",\"xsfYhzh\":\"北京啦啦啦 345677890098990\",\"gmfNsrsbh\":\"1QAZ2WSX3EDC4RF\",\"gmfMc\":\"htt0331003\",\"gmfDzdh\":\"北清路68号13141422677\",\"gmfYhzh\":\"北京银行6345678987655678\",\"kpr\":\"111\",\"skr\":\"htt收款222\",\"fhr\":\"htt复核人\",\"zdybz\":\"自定义备注写了100字以内呢哈哈哈哈\",\"lylx\":\"2\",\"zdzfbz\":\"N\",\"lyid\":\"2237227707797763\",\"lydjh\":\"NBJS20221122120801\",\"creator\":\"348af872-f245-4eed-ab16-ed36f6cf5e37\",\"zdrq\":\"2023-03-23\",\"accountStatus\":\"1\",\"je\":400.00,\"jshj\":800.00,\"createTime\":1680243960000,\"ts\":1680246797000,\"isBilling\":\"1\",\"sqr\":\"北京人\",\"sqbm\":\"北京部门我访问的哦文件啦啦队冷冻机房了安家费了98698哦肌司研……%*&……（\",\"gmfDz\":\"北清路68号\",\"gmfDh\":\"13141422677\",\"gmfYh\":\"北京银行\",\"gmfZh\":\"6345678987655678\",\"se\":400.00,\"hisJe\":3.00,\"unJe\":397.00,\"hisSe\":0.00,\"redInfos\":[],\"enableRed\":false,\"invoiceWillBs\":[{\"id\":1692594719821922312,\"hh\":\"1\",\"spbm\":\"06000001\",\"xmmc\":\"餐费\",\"spssflbm\":\"3070401000000000000\",\"ggxh\":\"千克*箱\",\"dw\":\"套\",\"xmhsdj\":100.0000000000,\"xmsl\":2.0000000000,\"xmje\":200.00,\"sl\":0.000000,\"se\":0.00,\"xmjshj\":200.00,\"hisJe\":3.00,\"hisJshj\":3.00,\"hisZke\":0.00,\"hisSpsl\":0.0300000000,\"taxclassname\":\"餐饮服务\",\"taxclassjc\":\"餐饮服务\",\"createTime\":1680243960000,\"lymxid\":\"2237227707797771\",\"lyid\":\"2237227707797770\",\"ts\":1680246792000,\"isBilling\":\"1\",\"records\":[{\"fplx\":\"3\",\"hh\":\"1\",\"fpqqlsh\":\"1641700152848969728\",\"fpDm\":\"780000000000\",\"fpHm\":\"70000061\",\"kprq\":\"2023-03-31 15:13:15\",\"kprq4DMDB\":1680246795000,\"xmsl\":0.0100000000,\"xmhsdj\":100.0000000000,\"xmje\":1.00,\"xmjshj\":1.00,\"se\":0.00,\"sl\":0.000000,\"status\":\"4\",\"zfbz\":\"N\",\"bred\":\"N\",\"czrq\":\"2023-03-31\",\"createTime\":\"2023-03-31 03:13:12\",\"ts\":1680246796000,\"bid\":1692594719821922312},{\"fplx\":\"3\",\"hh\":\"2\",\"fpqqlsh\":\"1641700152848969728\",\"fpDm\":\"780000000000\",\"fpHm\":\"70000061\",\"kprq\":\"2023-03-31 15:13:15\",\"kprq4DMDB\":1680246795000,\"xmsl\":0.0200000000,\"xmhsdj\":100.0000000000,\"xmje\":2.00,\"xmjshj\":2.00,\"se\":0.00,\"sl\":0.000000,\"status\":\"4\",\"zfbz\":\"N\",\"bred\":\"N\",\"czrq\":\"2023-03-31\",\"createTime\":\"2023-03-31 03:13:12\",\"ts\":1680246796000,\"bid\":1692594719821922312}],\"lslbs\":\"1\",\"fphxz\":0},{\"hh\":\"2\",\"spbm\":\"JF01000216\",\"xmmc\":\"糯米糍粑\",\"spssflbm\":\"1030201020000000000\",\"ggxh\":\"千克*箱\",\"xmhsdj\":300.5000000000,\"xmsl\":2.0000000000,\"xmje\":200.00,\"sl\":0.000000,\"se\":400.00,\"xmjshj\":600.00,\"hisJe\":0.00,\"hisJshj\":0.00,\"zke\":1.00,\"hisZke\":0.00,\"hisSpsl\":0E-10,\"taxclassjc\":\"焙烤食品\",\"createTime\":1680243960000,\"lymxid\":\"2237227707797771\",\"lyid\":\"2237227707797770\",\"ts\":1680243960000,\"lslbs\":\"3\",\"fphxz\":0,\"zkhbs\":\"Y\"}]}",
"code":"0000",
"msg":"开票成功",
"fpqqlsh":"2023033101480035",
"corpid":"um86vloe"
}]

# 待开票明细回传参数说明

参数	类型	描述	说明
code	String	开票信息码	0000代表成功
msg	String	开票失败信息
fpqqlsh	String	发票请求流水号
corpid	String	租户id
data	String	发票详细信息

# 待开票明细回传data说明

参数	类型	描述	说明
code	String	状态码	详见状态码说明
msg	String	信息说明
accountNote	String	记账备注
accountStatus	String	记账状态：1-未记账 2-已记账
accountTime	String	记账日期 yyyy-MM-dd
accountUser	String	记账人
accountVoucherNo	String	记账凭证号
bz	String	备注
djqqlsh	String	单据请求流水号
fhr	String	复核人
fplx	String
gmfDzdh	String	购买方地址电话
gmfMc	String	购买方名称
gmfNsrsbh	String	购买方纳税人识别号
gmfYhzh	String	购买方银行账户
hisJe	BigDecimal	已开票金额
hisSe	BigDecimal	已开票税额
je	BigDecimal	单据金额
jshj	BigDecimal	单据价税合计
kpr	String	开票人
lyid	String	单据号
orgName	String	组织编码
se	BigDecimal	税额
skr	String	收款人
unJe	BigDecimal	待开票金额
xsfDzdh	String	销售方地址电话
xsfMc	String	销售方名称
xsfNsrsbh	String	销售方纳税人识别号
xsfYhzh	String	销售方银行账户
lc	Integer	联次 2-二联 3-三联 5-五联
zdrq	String	制单日期
dw	String	单位
hh	String	行号
hisJe	BigDecimal	已开票金额
hisJshj	BigDecimal	已开票价税合计
se	BigDecimal	税额
sl	BigDecimal	税率
spbm	String	商品编码
spssflbm	String	商品税收分类编码
xmje	BigDecimal	项目金额
xmjshj	BigDecimal	项目价税合计
xmmc	String	项目名称
bred	String	是否被红冲 Y-被红冲 N-正常
fpDm	String	发票代码
fpHm	String	发票号码
fplx	String	发票类型
fpqqlsh	String	开票请求流水号
hh	String	行号
se	BigDecimal	税额
sl	BigDecimal	税率
status	String	发票状态 1-待开票 2-开票中 3-开票失败 4-开票成功
xmje	BigDecimal	项目金额
xmjshj	BigDecimal	项目价税合计
zfbz	String	是否作废 Y=已作废，N-未作废，

# 申请红字信息表（购方销方）回调

# 回调业务成功系统样例

{
    "msg": "上传成功",
    "code": "0000",
    "corpid": "1937501a-b06f-4bf6-87d6-d5b515dacd26",
    "hzxxbbh": "123123321112233222",
    "reqBillNo": "3213121232123"
}

# 回调业务系统失败样例

{
  "code":"9999",
  "msg":"申请失败",
  "reqBillNo":"32131232131"
}

← 枚举值进项发票管理 →