请求地址：/api/invoice/check

http请求方式：POST

接口诞生版本：派平台2.3版本

所属系统：π平台

接口说明：用于广东通用（电子）发票、浙江通用（电子）发票的查验

单次调用最大条数：1

使用场景

当前支持查验的发票类型：广东通用（电子）发票、浙江通用（电子）发票

请求报文

注意：类型默认为String，特殊的类型会标注；

派平台
字段编码	类型	是否必填	字段名称	说明
dq		是	地区代码	如3300
fpdm		是	发票代码
fphm		是	发票号码
xfsbh		是	销方识别号
kprq		是	开票日期	格式 yyyy-MM-dd / yyyyMMdd
jshj		是	价税合计

响应报文

返回参数：主表区
派平台
字段编码	类型	字段名称	说明
code		查验失败错误码
message		查验失败错误信息
validState	boolean	查验成功标识	Y-成功；N-失败
ok	boolean	接口响应标识
isDeduct	String	是否收费	Y收费，N不收费
fpdm		发票代码
fphm		发票号码
kprq		开票日期	yyyy-MM-dd HH:MM:SS
jym		校验码
je	number \| null	金额
jshj	number \| null	价税合计
skm	string \| null	税控码/密码区
fplx	string \| null	发票类型代码	102:通用电子发票
dq	string \| null	地区代码

invoiceTypeName		发票类型名称	通用电子发票
feeWithoutTax		价税合计
billingTime		开票日期	yyyy-MM-dd
billingNo		发票代码
billingCode		发票号码
sellerNumber		销方识别号

返回参数：明细区
派平台
字段编码	类型	字段名称	说明
xfsbh	string	销方识别号
gfsbh	string	购方识别号
fpdm	string	发票代码
gfmc	string	购方名称
dq	string	地区（中文）
fpzt	string	发票状态	0：正常 2：作废 3：已红冲 7：部分红冲 8：全额红冲
kprq	string	开票日期	yyyy-MM-dd
kjlx	string	开具类型	1：自开 2：代开 3：代办退税
jshj	string	价税合计
xfmc	string	销方名称
fplbmc	string	发票类别名称	例如：电子发票
fphm	string	发票号码

请求报文范例

{
    "data": {
        "fpdm": "233002400111",
        "fphm": "36578150",
        "kprq": "2024-05-19",
        "dq": "3300",
        "xfsbh": "92330322MA2HC9KJ90",
        "jshj": "270.00",
        "billTypeInvoice": "102"
    },
    "appId": "41053d8fe2d04726bae6069c481ef69c",
    "format": "json",
    "sign": "bQWhZwZzAIBaw23v8D4T/aiO3FQ=",
    "version": "V2.0",
    "noncestr": "e567b0bb-dd51-4590-9b0c-b10c101233e8",
    "timestamp": "2024-05-28 14:38:00"
}

响应报文范例

{
	"invoiceTypeName": "通用电子发票",
	"feeWithoutTax": "270.00",
	"billingTime": "2024-05-19",
	"billingNo": "233002400111",
	"rawData": "{\"code\":\"2000\",\"data\":[{\"data\":{\"xfsbh\":\"92330322MA2HC9KJ90\",\"gfsbh\":\"12100 00044 48850 142\",\"fpdm\":\"233002400111\",\"fpzt\":\"0\",\"gfmc\":\"中南大学湘雅医院\",\"kprq\":\"2024-05-19\",\"kjlx\":\"1\",\"jshj\":\"270\",\"xfmc\":\"温州市洞头东屏栖巷民宿\",\"dq\":\"浙江\",\"fplbmc\":\"电子发票\",\"fphm\":\"36578150\"},\"dq\":\"3300\",\"kprq\":\"2024-05-19 00:00:00\",\"fpdm\":\"233002400111\",\"fplx\":\"102\",\"customReqId\":\"10002210138a76b565c74b74b8b1aa8d083a7830\",\"tydz\":true,\"success\":true,\"jshj\":270.00,\"fphm\":\"36578150\"}],\"success\":true,\"reqId\":\"d58188405cd94ce09de2f164df72816f\"}",
	"message": "查验成功",
	"billingCode": "36578150",
	"paiResponseId": "faa9630ac01c49ccb026ec7c6b13597b",
	"validState": "Y",
	"extendCategory": "",
	"paiResponseCost": 477,
	"sellerNumber": "92330322MA2HC9KJ90",
	"appId": "41053d8fe2d04726bae6069c481ef69c",
	"invoiceTypeCode": "102",
	"id": "d84a0aca9884448aafc20ff3044dfe96",
	"ok": true,
	"isDeduct": "Y",
	"paiResponseTime": "2024-07-15 14:50:37"
}

A.1:错误代码

错误码	收费	场景说明	提示语	需求说明
	是		查验成功
201	是	所查发票不存在	所查发票不存在	201&216&243三种失败状态，前端系统会触发自动查验
202	是	超过该张票当天查验次数	超过该张票当天查验次数
211		参数不合法		其他错误码，保持原逻辑，取厂商返回的错误信息
212	是		发票信息不一致
213		服务器异常，请稍后重试	保持原逻辑，取厂商返回的错误信息	213&500两种失败状态，会自动触发降级查验
216		当日开具发票可于次日进行查验	保持原逻辑，取厂商返回的错误信息
217		超过五年不能查验	保持原逻辑，取厂商返回的错误信息
217		仅可查验最近一年内开具的财政电子票据!	保持原逻辑，取厂商返回的错误信息
241		没有查验权限	保持原逻辑，取厂商返回的错误信息
242		已超过最大查验量	保持原逻辑，取厂商返回的错误信息
243		查验异常	保持原逻辑，取厂商返回的错误信息
221		当前查验未完成	保持原逻辑，取厂商返回的错误信息
500		未知异常，请联系管理员	保持原逻辑，取厂商返回的错误信息	除与供应商映射错误信息外，还包含其他未知错误，属于兜底错误码，错误信息为“未知异常，请联系管理员”

通用电子发票查验（浙江）&（广东）

关联知识库

通用电子发票查验（浙江）&（广东）

关于作者

关联知识库

目录