跳至主内容

prod

增值税发票查验

增值税发票查验API (COM148)


向客户提供标准化接口服务，主要用于发票四要素的查验，查验后可自动返回发票的全票面数据信息以及当日最新的发票状态

New

400-110-8298
9:30-17:30
bd@yushanshuju.com

des

合规提示：

•使用数据服务的场景应当合理合规，如涉及个人隐私或商业机密，请您确保获得当事人的授权。

•在KYC场景中，推荐搭配使用身份证核验（IDV034）、护照核验（PCB608）或人脸比对核验（IVG000）等服务，确保实人认证授权。

•在KYB场景中，推荐搭配使用企业四要素认证（COM101）、企业打款认证（COM084）、法人短信认证（CLC001）等服务，确保企业认证授权。

•如需了解更多授权核验类产品请咨询您的专属客服~
  • -

    产品特点

    -

    •覆盖范围广


    支持增值税发票、汽车票、火车票、出租车票、过路费发票、航空运输行程单、机动车销售发票、购物小票、卷票、定额发票等全类型发票。


    •提升质量、效率


    实现全增值税发票验真、认证，有效防范• 防范套票、假票的出现。提高供应链三单匹配效率，降低增值税发票风险。

  • -

    应用场景

    -

    •企业报销


    可应用于企业税务核算及内部员工差旅及办公采购报销等场景，对报销发票进行内控合规检查 以及真伪查验。除此之外还可有效协助企业将金额和明细与审批、预算进行比对，降低潜在风险，提高业务效率。


    •PO订单业务


    有效协助相关工作人员对发票内控合规性进行检查，从源头防止‘假票’泛滥现象，助力业务管理端实现 三单匹配自动化

  • -

    覆盖体量

    -

    全国增值税发票全覆盖
  • -

    产品标签

    -

    发票核验

出入参数

羽山数据API产品详细介绍

分类 : 输入字段
名称说明
fpdm
发票代码
fphm
发票号码
kprq
开票日期
jshj
发票价税合计金额（含税）
je
发票金额（不含税）
jym
校验码后六位
分类 : 返回字段
名称说明
times
查验次数（第几次）
success
查验是否成功标识 true成功false失败
time
查验时间
data
查验返回的发票数据
fplx
发票类型代码
dq
地区
fpdm
发票代码
fphm
发票号码
kprq
开票日期
jym
校验码
xfsbh
销方识别号
xfmc
销方名称
xsfdzdh
销售方地址电话
xsfyhzh
销售方银行账号
gfsbh
购方识别号
gfmc
购方名称
gmfdzdh
购买方地址电话
gmfyhzh
购买方银行账号
je
金额（不含税）
se
税额
jshj
价税合计
jshjcn
价税合计（中文大写）
bz
备注
xhqdBz
清单标志：发票明细中是否有清单行（Y清单 N非清单）
kjlx
开具类型 1自开 2代开
tspzDm
特殊票种代码，02农产品收购发票 08成品油发票
sbbh
设备编号
fpztDm
发票状态代码
hwxx
货物信息
mxxh
明细序号
spbm
商品编码
mc
名称
ggxh
规格型号
sl
数量
jldw
计量单位
dj
单价
slv
税率
ysslv
原始税率
se
税额
ysse
原始税额
txrqq
通行日期起（通行费发票专有）
txrqz
通行日期止（通行费发票专有）
dkXsfsbh
代开销售方识别号
dkXsfmc
代开销售方名称
txfbz
通行费标识。如果是通行费，则有该字段，Y表示该通行费可抵扣，N表示不可以抵扣
url
OFD版式文件下载链接（只有税务ukey开具的电子专票和电子普票有）
purl
PDF版式文件下载链接（只有税务ukey开具的电子专票和电子普票有）
sfzhm
身份证号码/组织机构代码
cllx
车辆类型
cpxh
厂牌型号
cd
产地
hgzh
合格证号
jkzmsh
进口证明书号
sjdh
商检单号
fdjhm
发动机号码
cjhm
车架号码/车辆识别代码
xhdwmc
销货单位名称
dh
电话
xhdwsbh
销货单位纳税人识别号
zh
账号
dz
地址
khyh
开户银行
zzsse
增值税税额
swjgDm
主管税务机关代码
swjgMc
主管税务机关名称
wspzhm
完税凭证号码
dw
吨位
xcrs
限乘人数
skm
税控码
fpjyPmSbhlx
经营、拍卖单位纳税人识别号
zrdclglsMc
转入地车辆管理所名称
jyPmMc
经营、拍卖单位名称
jyPmDz
经营、拍卖单位地址
clsbdm
车架号/车辆识别代码
escSbh
二手车市场识别号
djzh
登记证号
xfMc
卖方单位/个人名称
xfDz
卖方单位/个人地址
escDh
二手车市场电话
jyPmDh
经营、拍卖单位电话
gfMc
买方单位/个人名称
gfDz
买方单位/个人地址
xfDh
卖方单位/个人电话
escMc
二手车市场名称
escDz
二手车市场地址
xfDm
卖方单位/个人代码
gfDh
买方单位/个人电话
cpzh
车牌照号
jyPmYhzh
经营、拍卖单位开户银行账号
gfDm
买方单位/个人代码
escYhzh
二手车市场开户行账号
cjhj
车价合计
cjhjcn
车价合计(中文大写)
qdlx
全电发票类型 10 电子发票（普通发票） 20 电子发票（增值税专用发票）
kpr
开票人
skr
收款人
fhr
复核人
hsdj
合计单价
hsje
合计金额
mxts
明细条数
kpjh
开票机号
lslbs
零税率标识 空代表无出口退税；1出口免税和其他免税优惠政策；2不征增值税＿普通零税率

羽山数据API产品接入信息

报表设置

分类 : 业务异常(retcode)
名称说明
warn_037超过该张票当天查验次数
warn_038查询发票不规范
warn_030所查发票不存在
warn_002发票不一致(收费)
分类 : 系统代码(retcode)
名称说明
000000交易成功（收费）
200000调用远程数据异常
200010账号不存在
200012未找到账号与产品的订购关系
200013该产品测试条数已用完，请联系羽山数据
200014加解密错误
err_012传入参数不正确
err_015数据源请求时出现异常

羽山数据API产品接入信息

报表设置

分类 : 1.对接信息
名称说明
IP白名单
本系统具有IP白名单限制，
需要先将自身服务器公网IP,
提供给羽山数据网络工程师配置。
协议
HTTP/HTTPS POST
编码格式
UTF8
HEAD: ACCT_ID
必填，开户后将获得接入账号APP_ID，如“test_user”
HEAD: CONTENT-TYPE
application/json
测试环境URL
http://122.152.195.249:21000/credit-gw/service
生产环境URL
https://api.yushanshuju.com/credit-gw/service
明文Request JSON样例
{  
 "prod_id": "COM148",  
 "req_data": {    这里是业务入参  },  
 "req_time": 1545270159122, 
 "request_sn": "4df1e3c9583d40a9a57f63e4ab153189"
}
明文Request JSON样例说明
prod_id 为产品编号。
req_data 为业务入参，请参考下面详细信息。
req_time 为Linux 毫秒时间，可使用echo `date +%s`"000" 命令获得最新时间。
request_sn为请求单号，不可重复，需自行生成。
明文Response JSON样例
{
    "response_sn": "20190602020740639KIBG",
    "retdata": {
        "final_auth_result": "1"   },
    "version": "1.0",
    "request_sn": "4a5f3f52e5324a87b96e16c0585",
    "retmsg": "交易成功",
    "retdate": 1559412461182,
    "retcode": "000000"
}
明文Response JSON样例说明
response_sn 返回单号。 
retdata 返回业务json。 
retmsg 返回描述。 
retcode 系统代码。
技术支持
400-110-8298
分类 : 2.加解密方法
名称说明
私钥
登录系统或联系技术支持获得接入KEY，
加密JSON Request 和解密response密文时需要使用。
注意要严格保密使用，请勿外泄，如有遗失，自行负责！
请求报文加密算法
将request JSON明文aes-128-cbc 加密后base64编码,随后POST提交.
接收报文解密算法
将response JSON使用base64解码后,aes-128-cbc解密为明文.
分类 : 公共参数
名称说明
request_sn
请求序列号
acct_id
账号
prod_id
产品ID
req_data
传入参数
req_time
请求时间
response_sn
返回单号
retdata
返回参数
retcode
返回代码
retmsg
返回信息
retdate
返回时间戳

API推荐

公司新闻  隐私政策  沪ICP备19015600号-1  Copyright © 2018-2019 羽山数据 格兰德上海 版权所有   监督电话：400-110-8298