1. 发票查验

1.1. 接口说明

单张发票信息查验

1.2. 调用方式

请求方式:POST

https://invoice.youepiao.com/input/openApi/checkInvoiceSingle

1.3. 请求参数

1.3.1. 参数示例

{
    "jym": "",
    "fpje": "",
    "fpdm": "",
    "kprq": "",
    "fphm": "",
    "fpzl": ""
}

1.3.2. 参数说明

参数 参数名称 类型 长度 必须 说明
jym 校验码 String 6 校验码;发票校验码后 6 位,发票种类为 04,10,11,14 , 16(全部)时此项为必填项;发票种类参考发票种类 (fpzl)字段
fpje 不含税金额 String 不含税金额;当发票种类为 01,02,03,15,08,16,21,22 时此 项为必填项:且当 01,02,03,16 填写发票不含税金 额,15 填写发票车价合计;发票种类参考发票种类 (fpzl)字段;且当 21,22 时填写发票价税合计金额
fpdm 发票代码 String 10/12 发票代码;全电发票(普通/专用)可为空
kprq 开票日期 String 8 开票日期;格式 yyyyMMdd 例:20200324
fphm 发票号码 String 8 发票号码;
fpzl 发票种类 String 2 发票种类;增值税专用发票:01 货运运输业增值税专用发票:02 机动车销售统一发票:03 增值税普通发票:04 增值税普通发票(电子):10 增值税普通发票(卷式):11 通行费发票:14 二手车发票:15 增值税电子专用发票:08 区块链电子发票:16(只支持深圳地区) 全电发票(专用发票):21 全电发票(普通发票):22

1.4. 返回结果

1.4.1. 返回示例

{
    "success": true,
    "code": "0000",
    "message": "default success",
    "data": {
        "detailList": [{
            "sl": "6%",
            "je": "12092.26",
            "ggxh": "",
            "jldw": "批",
            "se": "725.54",
            "fyxm": "",
            "txrqq": "",
            "spsl": "",
            "hsje": "",
            "mxbh": "1",
            "txrqz": "",
            "lx": "",
            "hwmc": "*物流辅助服务*收派服务",
            "cph": "",
            "bhsdj": "",
            "hsdj": "",
            "ssflbm": "",
        }],
        "fpdm": "4100191130",
        "jym": "",
        "fpzl": "01",
        "fpje": "12092.26",
        "kprq": "20190806",
        "cyjg": "0001",
        "fphm": "07537241",
        "cyjgxx": "查验成功发票一致",
        "jshj": "12817.80",
        "xhfdzdh": "三门峡市崤山西路 5 号 15238990130",
        "zfbz": "N",
        "bswjurl": "",
        "cd": "",
        "xhfsbh": "91411200558331044L",
        "cllx": "",
        "sjdh": "",
        "xhfmc": "中国邮政速递物流股份有限公司三门峡市分公司",
        "gmfdzdh": "芮城县风陵渡开发区工业大道 1 号 0359-3388045",
        "bz": "明细见附件起运地-到达地:三门峡-郑州-全国各地 车种车号:9.6 米 邮政厢车 豫 AN3061 豫 AG9992 豫 AU1113 吨位:13T 运输货物信息:医药",
        "kpr": "",
        "fdjhm": "",
        "jqbh": "499906906488",
        "hgzs": "",
        "clshb": "",
        "gmfyhzh": "中国工商银行芮城风陵渡支行 0511038309200004046",
        "jkzmsh": "",
        "cycs": "22",
        "xhfyhzh": "100433485660019999 邮政储蓄银行三门峡分行中心支行",
        "gmfsbh": "91140830757262627K",
        "gmfmc": "山西亚宝医药经销有限公司",
        "fpse": "",
        "fhr": "",
        "skr": "",
        "sfzh": "",
        "cpxh": "",
        "mfdwgr": "",
        "khyh": "",
        "fhrsbh": "",
        "khyhjzh": "",
        "mfdh": "",
        "escscdz": "",
        "jypmdwdz": "",
        "spfshb": "",
        "zrdcgsmc": "",
        "escsckhyhzh": "",
        "escsc": "",
        "xhfdz": "",
        "cpzh": "",
        "mfdwdmsfzh": "",
        "xcrs": "",
        "txfbz": "",
        "jypmdwdh": "",
        "cyrsbh": "",
        "jypmdw": "",
        "cjhj": "",
        "escscdh": "",
        "sl": "",
        "dw": "",
        "fhrmc": "",
        "skph": "",
        "smfdwgrzz": "",
        "djzh": "",
        "khzh": "",
        "lslbs": "",
        "jypmdwdzsbh": "",
        "shrmc": "",
        "yshwxx": "",
        "smfdwdmsfzh": "",
        "zgswjgmc": "",
        "mfdwgrdz": "",
        "smfdwgr": "",
        "smfdh": "",
        "shrsbh": "",
        "ccdw": "",
        "escscsbh": "",
        "wspzhm": "",
        "qydjyddd": "",
        "czch": "",
        "cyrmc": "",
        "zgswjgdm": "",
        "spfmc": ""
    }
}

返回说明

参数 参数名称 类型 长度 必须 说明
cyjg 查验结果 String 10
cyjgxx 查验结果信息 String 100 查询结果的信息
fpzl 发票种类 String 2
fpdm 发票代码 String 20
fphm 发票号码 String 8
cycs 查验次数 String 100
xhfmc 销售方名称 String 100
xhfsbh 销售方识别号 String 20
xhfdzdh 销售方地址电话 String 100
xhfyhzh 销售方开户行及账号 String 100
gmfsbh 购买方识别号 String 20
gmfmc 购买方名称 String 100
gmfmc 购买方名称 String 100
gmfdzdh 购方地址、电话 String 100
gmfyhzh 购买方开户行及账号 String 100
kprq 开票日期 String 8 格式 yyyyMMdd
fpje 发票金额 String 20
fpse 发票税额 String 20
jshj 价税合计 String 16
bz 备注 String 200
jqbh 机器编号 String 20
kpr 开票人 String 8
skr 收款人 String 8
fhr 复核人 String 8
jym 校验码 String 32 区块链电子发票返回 5 位
zfbz 作废标志 String 100 Y:已作废 H:已冲红 N:未作 废
qdbz 清单标识 String 1 Y:带清单;N:无清单;备注; 只有当发票种类为:专用发 票,电子专用发票,电子发票, 普通发票时返回此字段的值
detailList
mxbh 明细编号 String 90
hwmc 货物名称 String 40
je 金额 String 22
spsl 数量 String 22
sl 税率 String 24
se 税额 String 24
hsdj 含税单价 String 24
hsje 含税金额 String 24
bhsdj 不含税单价 String 24
ggxh 规格型号 String 100
jldw 计量单位 String 100
fyxm 费用项目 String 100 货运发票返回信息
cph 车牌号 String 100 通行费发票返回信息
lx 类型 String 100 通行费发票返回信息
txrqq 通行日期起 String 100 通行费发票返回信息
txrqz 通行日起止 String 100 通行费发票返回信息
ssflbm 税收分类编码 String 100
bswjurl 版式文件 URL String 100 ofd 类型文件返回该字段

1.4.2. 返回代码说明

类型 返回码 返回说明 说明
查验失败 9999 查验失败 查验失败
查验成功发票一致 0001 查验成功发票一致 查验成功
超过该张票当天查验次数 0002 查验失败 此发票今日查询次数已达上限 (5 次),请次日查询
请求不合法 0005 请求不合法 发票信息有误,请核对后再查询
发票信息不一致 0006 发票信息不一致 发票信息有误,请核对后再查询
发票不存在 0009 发票不存在 所查发票不存在
已超过最大查验量 1004 已超过最大查验量 已超过最大查验量,请联系管理 员
查询发票不规范 1005 查询发票不规范 信息有误,请核对后再查询
查验异常 1006 查验异常 发票信息有误,请核对后再查询
该批次已过 期,请重新更 换批次号查 验 1007 该批次已过期,请重新更 换批次号查验 该批次已过期,请重新更换批次 号查验
字段不能为空 1008 字段不能为空 发票请求参数不能为空
参数长度不正确 1009 参数长度不正确 参数长度不符合规范,确认参数,再次查验
当前查验未完成 1010 当前查验未完成 查验正在进行中(批量查验)
该批次已查验 1011 该批次已查验 批量已查验(应当调用发票获 取 接口 获得查验发票信息)
超过规定张数 1012 超过规定张数 批量查验接口默认 200 张,超过 规定张数
批次号不存 在 1013 批次号不存在 可重新请求,换批次号
日期当天的不能查验 1014 日期当天的不能查验 日期当天的不能查验,请隔天再 查
超过5年的不能查验 1015 超过 5 年的不能查验 超过 5 年的不能查验
没有查验权 限 1020 没有查验权限 没有查验权限,请联系管理员
网络超时 1021 网络超时 税局维护升级

results matching ""

    No results matching ""