2.4.1新版发票识别接口 - 百旺金穗云-SaaS标准化接口

通过该接口，用户可以上传发票文件（图片（png，jpg，jpeg），pdf，OFD，XML等），文件大小不能超过10M，系统通过识别服务字段识别出发票内容。可识别前提：网关密钥正确，企业识别查验剩余次数充足。注意：不能保证发票的百分百识别，会存在部分字段识别错误。须保持图片清晰，无损，褶皱。
接口请求类型为：multipart/form-data

请求参数

Header 参数

Content-Type

string

必需

默认值:

application/json

Date

string

必需

默认值:

host

string

必需

默认值:

x-htjs-nonce

string

必需

默认值:

x-htjs-ua

string

必需

默认值:

Authorization

string

必需

默认值:

Body 参数application/json

czlsh

string

操作流水号，不允许为空，长度32以内，建议UUID

必需

file

string

发票文件

必需

czr

string

操作人

必需

jtNsrsbh

string

集团税号，填写集团计次或计费税号

必需

nsrsbh

string

纳税人税号，填写操作企业税号

必需

nsrmc

string

纳税人名称，填写操作企业名称

必需

bcsbxxbz

string

保存识别信息标志，取值为Y/N ，默认N

可选

示例

params: {
    "czlsh": "",
    "jtNsrsbh": "",
    "nsrsbh": "",
    "nsrmc": "",
    "czr": "",
    "bcsbxxbz": ""
},
file: ""

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

success

boolean

是否成功，true 表示成功

必需

code

integer

返回 Code，0 表示成功，其他值表示失败

必需

msg

string

提示信息

必需

data

array [object {48}]

返回报文

必需

fplxdm

string

发票类型

可选

fpdm

string

发票代码

可选

fphm

string

发票号码

可选

zpfphm

string

纸票发票号码

可选

fpzt

string

发票状态

可选

jym

string

校验码后六位

可选

jqbm

string

机器编码

可选

kprq

string

开票日期

可选

hjje

string

合计金额

可选

hjse

string

合计税额

可选

jshj

string

价税合计

可选

xfnsrsbh

string

销方纳税人识别号

可选

xfmc

string

销方名称

可选

xfkhhzh

string

销方开户行及账号

可选

xfdzdh

string

销方地址、电话

可选

gfnsrsbh

string

购方纳税人识别号

可选

gfmc

string

购方名称

可选

gfkhhzh

string

购方银行账号

可选

gfdzdh

string

购方地址、电话

可选

skr

null

收款人

可选

fhr

null

复核人

可选

kpr

null

开票人

可选

fpbz

string

发票备注

可选

fpslv

string

发票税率

可选

fpslvLable

string

发票税率名称，如 13%

可选

fpdkse

null

发票抵扣税额

可选

tdyslxdm

null

特定要素类型代码，1：货物运输服务，2：旅客运输服务，3：建筑服务，4：不动产经营租赁服务，5：不动产销售

可选

base64Str

string

图片 Base64 字符串

可选

bccgbz

string

保存成功标志，Y：成功 N:失败

可选

bcsbyy

string

保存失败原因

可选

fpmxList

array [object {9}]

发票明细列表

可选

jdcxx

object

机动车销售统一发票

可选

escxx

object

二手车明细

可选

tldzkpxx

object

铁路电子客票明细

可选

fyfpxx

object

费用发票明细

可选

hkxcd

object

航空电子客票行程单明细

可选

hwysmxList

array [object {6}]

货物运输明细

可选

lkysmxList

array [object {8}]

旅客运输明细

可选

jzfwmxList

array [object {8}]

建筑服务明细

可选

bdczlmxList

array [object {10}]

不动产租赁明细

可选

bdcxsmxList

array [object {10}]

不动产销售明细

可选

txfmxList

array [object {10}]

通行费发票明细

可选

wszmxx

object

完税证明

可选

wszmmxList

array [object {6}]

完税证明明细

可选

hgjksxx

object

海关缴款书

可选

hgjksmxList

array [object {7}]

海关缴款书明细

可选

zyfssrxx

object

中央非税收入信息

可选

zyfssrmxList

array [object {6}]

中央非税收入明细

可选

示例

{
    "success": true,
    "code": 0,
    "msg": "操作成功",
    "data": [
        {
            "fplxdm": "81",
            "fpdm": "",
            "fphm": "",
            "zpfphm": "",
            "fpzt": "0",
            "jym": "",
            "jqbm": "",
            "kprq": "20221124",
            "hjje": "123584.06",
            "hjse": "16065.94",
            "jshj": "139650.00",
            "xfnsrsbh": "",
            "xfmc": "",
            "xfkhhzh": "",
            "xfdzdh": "",
            "gfnsrsbh": "",
            "gfmc": "",
            "gfkhhzh": "",
            "gfdzdh": "",
            "skr": null,
            "fhr": null,
            "kpr": null,
            "fpbz": "",
            "fpslv": "0.13",
            "fpslvLable": "13%",
            "fpdkse": null,
            "tdyslxdm": null,
            "base64Str": "",
            "bccgbz": "Y",
            "bcsbyy": "",
            "fpmxList": [
                {
                    "hwmc": "*塑料制品*复合纯PU胶带",
                    "ggxh": "0.10*20",
                    "jldw": "米",
                    "spbm": null,
                    "sl": "350000",
                    "dj": "0.1035398285714",
                    "slv": "0.13",
                    "se": "4711.06",
                    "je": "36238.94"
                },
                {
                    "hwmc": "*塑料制品*PU胶带",
                    "ggxh": "0.08*20",
                    "jldw": "米",
                    "spbm": null,
                    "sl": "160000",
                    "dj": "0.0407079375",
                    "slv": "0.13",
                    "se": "846.73",
                    "je": "6513.27"
                }
            ],
            "jdcxx": {
                "cd": "",
                "cjh": "",
                "cllx": "",
                "cpxh": "",
                "dw": "",
                "fdjhm": "",
                "hgzh": "",
                "jddm": "",
                "jdhm": "",
                "jkzmsh": "",
                "sjdh": "",
                "wspzhm": "",
                "xcrs": "",
                "zgswjgdm": "",
                "zgswjgmc": ""
            },
            "escxx": {
                "cjh": "",
                "cllx": "",
                "cpxh": "",
                "cpzh": "",
                "djzh": "",
                "escscdh": "",
                "escscdz": "",
                "escsckhhjzh": "",
                "escscmc": "",
                "escsctyshxydm": "",
                "jddm": "",
                "jdhm": "",
                "jypmdw": "",
                "jypmdwdh": "",
                "jypmdwdz": "",
                "jypmdwkhjzh": "",
                "jypmdwtyshxydm": "",
                "zrdclglsmc": ""
            },
            "tldzkpxx": {
                "cc": "",
                "ccrq": "",
                "cfsj": "",
                "cfz": "",
                "cx": "",
                "ddz": "",
                "dzkph": "",
                "kpdw": "",
                "kpdwdm": "",
                "kttz": "",
                "pz": "",
                "pzlx": "",
                "xb": "",
                "xm": "",
                "xw": "",
                "yhbs": "",
                "ypcfz": "",
                "ypddz": "",
                "yppj": "",
                "ytje": "",
                "ywlx": "",
                "zfje": "",
                "zjh": ""
            },
            "fyfpxx": {
                "cfd": "",
                "ddd": "",
                "lksfzh": "",
                "lkXm": "",
                "xcrq": "",
                "xcsj": ""
            },
            "hkxcd": {
                "bxf": "",
                "chyy": "",
                "cyr": "",
                "cyrq": "",
                "dzkphm": "",
                "gngjbs": "",
                "gpdh": "",
                "hbh": "",
                "hd": "",
                "jehj": "",
                "kpjb": "",
                "kpsxr": "",
                "kpzt": "",
                "lkxm": "",
                "mdz": "",
                "mfxle": "",
                "mhfzj": "",
                "pj": "",
                "qfsj": "",
                "qtsf": "",
                "qz": "",
                "ryfjf": "",
                "sdphm": "",
                "sfz": "",
                "tkdw": "",
                "tkrg": "",
                "tsxx": "",
                "xswddh": "",
                "ysdphm": "",
                "yxjzr": "",
                "yxsfzhm": "",
                "yzm": "",
                "zwdj": "",
                "zzSslmc": "",
                "zzsse": "",
                "zzssl": ""
            },
            "hwysmxList": [
                {
                    "xh": "",
                    "ddd": "",
                    "qyd": "",
                    "ysgiph": "",
                    "ysgjzl": "",
                    "yshwmc": ""
                }
            ],
            "lkysmxList": [
                {
                    "xh": "",
                    "cfd": "",
                    "cxr": "",
                    "cxrq": "",
                    "ddd": "",
                    "dj": "",
                    "jtgjlx": "",
                    "yxsfzjh": ""
                }
            ],
            "jzfwmxList": [
                {
                    "xh": "",
                    "je": "",
                    "jzfwfsd": "",
                    "jzxmmc": "",
                    "se": "",
                    "slv": "",
                    "slvmc": "",
                    "xmmc": ""
                }
            ],
            "bdczlmxList": [
                {
                    "xh": "",
                    "bdcqzsh": "",
                    "dj": "",
                    "je": "",
                    "mjdw": "",
                    "se": "",
                    "sl": "",
                    "slv": "",
                    "slvmc": "",
                    "xmmc": ""
                }
            ],
            "bdcxsmxList": [
                {
                    "xh": "",
                    "bdcqzsh": "",
                    "dj": "",
                    "je": "",
                    "mjdw": "",
                    "se": "",
                    "sl": "",
                    "slv": "",
                    "slvmc": "",
                    "xmmc": ""
                }
            ],
            "txfmxList": [
                {
                    "xh": "",
                    "cph": "",
                    "je": "",
                    "lx": "",
                    "se": "",
                    "slv": "",
                    "slvmc": "",
                    "txrqq": "",
                    "txrqz": "",
                    "xmmc": ""
                }
            ],
            "wszmxx": {
                "fphm": "",
                "tfrq": "",
                "swjg": "",
                "jkrsbh": "",
                "gmfnsrmc": "",
                "zjexx": "",
                "zjemx": "",
                "bz": ""
            },
            "wszmmxList": [
                {
                    "pmmc": "",
                    "rtkrq": "",
                    "sjtje": "",
                    "sksssq": "",
                    "sz": "",
                    "ypzh": ""
                }
            ],
            "hgjksxx": {
                "hgmc": "",
                "srxt": "",
                "tfrq": "",
                "hm": "",
                "hgkadm": "",
                "skdwsrjg": "",
                "skdwkm": "",
                "skdwysjc": "",
                "skdwskgk": "",
                "jkdwmc": "",
                "jkdwzh": "",
                "jkdwkhyh": "",
                "hjjedx": "",
                "hjjexx": "",
                "sqdwbh": "",
                "bgdbh": "",
                "tzdw": "",
                "htpwh": "",
                "ysgjh": "",
                "jkqx": "",
                "tzhdh": "",
                "bz": "",
                "bzbz": "",
                "bzjshl": ""
            },
            "hgjksmxList": [
                {
                    "sh": "",
                    "hwmc": "",
                    "spsl": "",
                    "dw": "",
                    "wsjg": "",
                    "sl": "",
                    "skje": ""
                }
            ],
            "zyfssrxx": {
                "pjdm": "",
                "pjhm": "",
                "jkrtyshxydm": "",
                "jkr": "",
                "jym": "",
                "kprq": "",
                "jehjxx": "",
                "jehjdx": "",
                "fhr": "",
                "skr": "",
                "skdw": "",
                "qtxx": ""
            },
            "zyfssrmxList": [
                {
                    "xmbm": "",
                    "xmmc": "",
                    "sjtje": "",
                    "sksssq": "",
                    "sz": "",
                    "ypzh": ""
                }
            ]
        }
    ]
}