endpoint

是

终端节点，即调用API的请求地址。

不同服务不同区域的endpoint不同，您可以从终端节点中获取。

例如，OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。

project_id

是

项目ID，您可以从获取项目ID中获取。

X-Auth-Token

是

String

用户Token。

用于获取操作API的权限。获取Token接口响应消息头中X-Subject-Token的值即为Token。

Content-Type

是

String

发送的实体的MIME类型，参数值为“application/json”。

Enterprise-Project-Id

否

String

企业项目ID。OCR支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。

获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。

企业项目创建步骤请参见用户指南。

code

是

String

发票代码。

发票种类为全电发票时，该参数须为空字符串。

number

是

String

发票号码。

issue_date

是

String

发票日期格式YYYY-MM-DD。

check_code

否

String

校验码后六位。

• 以下种类发票，check_code参数为必选。

  增值税普通发票、增值税电子普通发票、增值税普通发票（卷式）、增值税电子普通发票（通行费）、区块链电子发票。

• 区块链电子发票需要填写5位校验码。

subtotal_amount

否

String

合计金额。和票据上的金额的有效数字保持一致，例如票据上的金额为88.00，则需要输入字符串为“88.00”，否则可能验真不成功。如果输入“88”或“88.0”可能会产生"result_code": "1010", " Parameter error."报错。

发票种类为全电发票时，该参数须为价税合计金额，其他票种使用不含税合计金额。

• 以下种类发票，参数不可为空。

  增值税专用发票、增值税电子专用发票、机动车销售统一发票、二手车销售统一发票、区块链电子发票、全电发票。

• 填写发票合计金额（不含税）

  增值税专用发票、增值税电子专用发票、机动车销售统一发票、区块链电子发票。

• 填写发票车价合计

  二手车发票。

• 填写发票合计金额

  全电发票。

• 填写票价或者退票费

  全电发票（铁路电子客票）。

result

Object

识别结果。

调用失败时不返回此字段。

依据发票类型不同，返回参数不同。

• 增值税发票

  含增值税专用发票、增值税普通发票、增值税普通发票（卷式）、增值税电子专用发票、增值税电子普通发票、增值税电子普通发票（通行费）、区块链电子发票。

• 机动车销售统一发票
• 二手车销售统一发票

result

Object

调用成功时返回的识别结果。

type

String

发票类型，取值范围：

• 增值税专用发票：vat_special
• 增值税普通发票：vat_normal
• 增值税普通发票（卷式）：vat_normal_roll
• 增值税电子专用发票：vat_special_electronic
• 增值税电子普通发票：vat_normal_electronic
• 增值税电子普通发票（通行费）：vat_normal_electronic_toll
• 区块链电子发票：blockchain_electronic
• 全电专用发票：fully_digitalized_special_electronic
• 全电普通发票：fully_digitalized_normal_electronic

code

String

发票代码。

number

String

发票号码。

issue_date

String

开票日期。

machine_number

String

机器编号。

check_code

String

校验码。

status

String

发票状态，取值范围：

• 正常：valid
• 已作废：invalidated
• 已红冲：reversed

subtotal_amount

String

合计金额(不含税）。

subtotal_tax

String

合计税额。

total

String

价税合计（小写）。

total_in_words

String

价税合计（大写）。

remarks

String

备注。

receiver

String

收款人。

issuer

String

开票人。

reviewer

String

复核人。

buyer_name

String

购买方名称。

buyer_id

String

购买方纳税人识别号。

buyer_address

String

购买方地址、电话。

buyer_bank

String

购买方开户行及账号。

seller_name

String

销售方名称。

seller_id

String

销售方纳税人识别号。

seller_address

String

销售方地址、电话。

seller_bank

String

销售方开户行及账号。

deductible_toll

String

通行费发票返回信息：

• Y：可抵扣通行费
• N：不可抵扣通行费

result_code

String

取值范围见表11。

result_message

String

取值范围见表11。

items

object

发票中包含的消费信息。

name

String

货物或应税劳务、服务名称、项目名称（通行费）。

specification

String

规格型号。

unit

String

单位。

quantity

String

数量。

unit_price

String

单价。

amount

String

金额。

tax_rate

String

税率。

tax

String

税额。

license_plate_number

String

车牌号。

vehicle_type

String

类型。

start_date

String

通行日期起。

end_date

String

通行日期止。

result

object

调用成功时返回的识别结果。

type

String

发票类型，取值范围：

机动车销售统一发票：motor_vehicle_sales。

code

String

发票代码。

number

String

发票号码。

issue_date

String

开票日期。

machine_number

String

机器编号。

status

String

发票状态，取值范围：

• 正常：valid
• 已作废：invalidated
• 已红冲：reversed

subtotal_amount

String

不含税价（小写）。

total

String

价税合计（小写）。

total_in_words

String

价税合计（大写）。

issuer

String

开票人。

buyer_name

String

购方名称。

buyer_organization_number

String

购买方身份证号码/组织机构代码。

buyer_id

String

购买方纳税人识别号。

seller_name

String

销货单位名称。

seller_id

String

销售方纳税人识别号。

seller_phone

String

销售方电话。

seller_account

String

销售方账号。

seller_address

String

销售方地址。

seller_bank

String

销售方开户银行。

tax_rate

String

税率。

tax

String

税额。

tax_authority

String

主管税务机关名称。

tax_authority_code

String

主管税务机关代码。

tax_payment_receipt

String

完税凭证号码。

tonnage

String

吨位。

seating_capacity

String

限乘人数。

vehicle_type

String

车辆类型。

brand_model

String

厂牌型号。

manufacturing_location

String

产地。

quality_certificate

String

合格证号。

import_certificate

String

进口证明书号。

inspection_number

String

商检单号。

engine_number

String

发动机号码。

vehicle_identification_number

String

车辆识别代号/车架号码。

result_code

String

取值范围见表11。

result_message

String

取值范围见表11。

result

object

调用成功时返回的识别结果。

type

String

发票类型，取值范围：

二手车销售统一发票：used_vehicle_sales。

code

String

发票代码。

number

String

发票号码。

issue_date

String

开票日期。

machine_number

String

机器编号。

status

String

发票状态，取值范围：

• 正常：valid
• 已作废：invalidated
• 已红冲：reversed

total

String

车价合计（小写）。

total_in_words

String

车价合计（大写）。

remarks

String

备注。

issuer

String

开票人。

buyer_name

String

买方单位/个人。

buyer_organization_number

String

买单位代码/身份证号码。

buyer_address

String

买方单位/个人住址。

buyer_phone

String

买方电话。

seller_name

String

卖方单位/个人。

seller_organization_number

String

卖方单位代码/身份证号码。

seller_address

String

卖方单位 /个人住址。

seller_phone

String

卖方电话。

vehicle_license_plate_number

String

车牌照号。

registration_certificate_number

String

登记证号。

vehicle_type

String

车辆类型。

vehicle_identification_number

String

车辆识别代号/车架号码。

brand_model

String

厂牌型号。

transfer_motor_vehicle_department_name

String

转入地车辆车管所名称。

auction_unit_name

String

经营，拍卖单位。

auction_unit_address

String

经营，拍卖单位地址。

auction_unit_tax_number

String

经营，拍卖单位纳税人识别号。

auction_unit_bank_and_account

String

开户银行及账号。

auction_unit_phone

String

经营，拍卖单位电话。

used_vehicle_market_name

String

二手车市场。

used_vehicle_market_tax_number

String

二手车市场纳税人识别号。

used_vehicle_market_address

String

二手车市场地址。

used_vehicle_market_bank_and_account

String

二手车市场开户银行及账号。

used_vehicle_market_phone

String

二手车市场电话。

result_code

String

取值范围见表11。

result_message

String

取值范围见表11。

result

object

调用成功时返回的调用结果。

type

String

发票类型，取值范围：

全电发票（航空运输电子客票行程单）：fully_digitalized_flight_itinerary。

international_flag

String

国内国际标识。

number

String

发票号码。

status

String

发票状态，取值范围：

• 正常：valid
• 已作废：invalidated
• 已红冲：reversed

passenger_name

String

旅客姓名。

id_number

String

有效身份证件号码。

gp_number

String

gp单号。

tax

String

增值税税额。

total

String

合计。

e_ticket_number

String

电子客票号码。

issue_date

String

填开日期。

buyer_name

String

购买方名称。

buyer_id

String

购买方纳税人识别号。

itinerary_list

Array of ItineraryList objects

机票行程列表。

departure_station

String

始发站。

destination_station

String

目的站。

carrier

String

承运人。

flight

String

航班号。

cabin_class

String

座位等级。

date

String

日期。

time

String

时间。

fare_basis

String

客票类别。

flight_segment

String

航段。

result

object

调用成功时返回的调用结果。

type

String

发票类型，取值范围：

全电发票（铁路电子客票）：fully_digitalized_train_ticket。

number

String

发票号码。

status

String

发票状态，取值范围：

• 正常：valid
• 已作废：invalidated
• 已红冲：reversed

business_type

String

业务类型，取值范围：

• 售票：ticketing
• 退票：refund

issue_date

String

开票日期。

name

String

车票持有人姓名。

id_number

String

车票持有人的身份证号。

ticket_price

String

票价。

tax_rate

String

税率。

tax

String

税额。

departure_station

String

始发站。

destination_station

String

终点站。

train_number

String

车次。

departure_date

String

乘车日期。

departure_time

String

出发时间。

seat_category

String

席别。

carriage

String

车厢。

seat_number

String

座位号。

e_ticket_number

String

电子客票号码。

air_conditioning

String

空调特征（是否是空调车厢）。

buyer_name

String

购买方名称。

unified_social_credit_code

String

购买方统一社会信用号码。

1000

The invoice verification information is consistent with the tax authority’s information.

发票验证信息与税务机关的信息一致。

无需处理，发票验证信息与税务机关信息一致。

1001

One invoice can be verified for only five times per day.

一张发票每天只能验证5次。

超过当天查验次数，请第二天再查验。

1002

The invoice verification information cannot be found in the tax authority’s information.

在税务机关的信息中找不到发票验证信息。

被查验发票信息有误，请核对发票信息是否填写正确。

1003

The invoice verification information is inconsistent with the tax authority’s information.

发票验证信息与税务机关的信息不一致。

被查验发票信息有误，请核对发票信息是否填写正确。

1004

Only invoices issued within the last five years can be verified.

只能验证最近五年内开具的发票。

超过5年的发票不能查验。

1005

Unsupported invoice type.

不支持的发票类型。

被查验发票信息有误，请核对发票信息是否填写正确。

1006

The invoice verification information is abnormal in the tax authority’s information.

The tax authority's interface is malfunctioning. Retry in 2 hours.

发票认证信息在税务机关信息中异常。

税局机关接口异常，请等候税局机关恢复后再重试，建议2小时后重试。

1007

This batch of invoices is being verified.

该批发票正在校验中。

该批次发票正在核验中，请第二天再查验。

1008

The request to the invoice verification service provided by the State Taxation Administration of China timed out.

The request to verify the invoice with the tax agency timed out. Retry in 2 hours.

向税务机关提供的发票验证服务的请求超时。

（税局机关）发票查询服务请求超时，请等候税局机关恢复后再重试，建议2小时后重试。

1009

Verification request rejected. Online invoice verification is currently not supported in this region.

验证请求被拒绝，此区域暂未开通线上查验通道。

（税局机关）查验请求被拒绝，此区域暂未开通线上查验通道。

1010

Parameter error.

参数错误。

参数错误，请检查请求参数是否填写正确。

0118

Service request error or the tax authority’s interface was malfunctioning.

Service request error as the tax agency's interface response timed out.

服务请求错误或税务机关的接口出现故障。

请等待税局机关接口恢复，建议2小时后重试。

error_code

String

调用失败时的错误码，具体请参见错误码。

调用成功时不返回此字段。

error_msg

String

调用失败时返回的错误信息。

调用成功时不返回此字段。

200

成功响应示例（增值税普通发票）

400

失败响应示例