跳至主内容

prod

New

9:00-21:00
  • #CARD_INITIALS#

    产品特点

    #CARD_SUBTITLE#

    •覆盖范围广


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


    •提升质量、效率


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

    应用场景

    #CARD_SUBTITLE#

    •企业报销


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


    •PO订单业务


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

    覆盖体量

    #CARD_SUBTITLE#

    全国增值税发票全覆盖
  • #CARD_INITIALS#

    产品标签

    #CARD_SUBTITLE#

    发票核验

业务参数

羽山数据API产品详细介绍

分类 : 输入字段
名称说明备注
invoice_type
发票类型
必填;
01 – 增值税专用发票
04 – 增值税普通发票
10 – 增值税普通发票(电子)
11 – 增值税普通发票(卷式)
invoice_no
发票号码
必填
invoice_code
发票代码
必填
check_code_last6
校验码后六位
必填;校验码后六位,专票可为空
total
发票金额(不含税)
必填;发票金额(不含税),普票可为空
create_date
开票日期
必填
分类 : 返回字段
名称说明备注
invoice_code
发票代码
发票类型-01,04,10
invoice_no
发票号码
发票类型-01,04,10
verify_count
查验次数
发票类型-01,04,10
create_date
开票日期
发票类型-01,04,10
buyer_name
购方名称
发票类型-01,04,10
buyer_tax_no
购方纳税人识别号
发票类型-01,04,10
buyer_address
购方地址电话
发票类型-01,04,10
buyer_bank_info
购方开户行及账号
发票类型-01,04,10
seller_name
销方名称
发票类型-01,04,10
seller_tax_no
销方纳税人识别号
发票类型-01,04,10
seller_address
销方地址电话
发票类型-01,04,10
seller_bank_info
销方开户行及账号
发票类型-01,04,10
total
合计金额
发票类型-01,04,10
total_tax
合计税额
发票类型-01,04,10
amount
价税合计
发票类型-01,04,10
note
备注
发票类型-01,04,10
machine_no
机器编号
发票类型-01,04,10
check_code
校验码
发票类型-01,04,10
cancel_flag
作废标志,取值Y/N
发票类型-01,04,10
productO_oil_flag
成品油标志,取值Y/N
发票类型-01,04,10
verify_date
查验时间
发票类型-01,04,10
detail_list
货物明细列表
发票类型-01,04,10;
name	         货物或应税劳务名称 	子节点
type	         单位		        子节点
unit	         数量		        子节点
count	         单价		        子节点
unit_price	 金额		        子节点
amount	         税率		        子节点
tax	         税额		        子节点
invoice_code
发票代码
发票类型-11
invoice_no
发票号码
发票类型-11
verify_count
查验次数
发票类型-11
create_date
开票日期
发票类型-11
seller_name
销方名称
发票类型-11
seller_tax_no
购方纳税人识别号
发票类型-11
buyer_name
购方名称
发票类型-11
buyer_tax_no
购方纳税人识别号
发票类型-11
machine_no
机器编号
发票类型-11
total_tax
合计税额
发票类型-11
amount
价税合计
发票类型-11
note
备注
发票类型-11
check_code
校验码
发票类型-11
total
合计金额
发票类型-11
receiver
收款员
发票类型-11
cancel_flag
作废标志,取值Y/N
发票类型-11
productO_oil_flag
成品油标志,取值Y/N
发票类型-11
verify_date
查验时间
发票类型-11
detail_list
货物明细列表
发票类型-11;
item	          项目		子节点
count	          单价		子节点
unit_price  	  含税单价       子节点
amount	          含税金额       子节点

返回码

羽山数据API产品接入信息

报表设置

分类 : 业务异常(retcode)
名称说明
warn_001查无记录
warn_002发票不一致
warn_030所查发票不存在
warn_037超过该张票当天查验次数
warn_038查询发票不规范
warn_043发票代码格式错误
分类 : 系统代码(retcode)
名称说明
000000交易成功
200000调用远程数据异常
200010用户不存在或者状态不存在
200011产品/接口,没有映射关系,或者产品/接口状态不正确
200012未找到账号与产品的订购关系
200013账号冻结,请联系羽山数据
200014您的账户被销户
200015Account 没有AES key 请联系羽山数据运维人员
err_000交易失败
err_008客户端回调失败
err_011无合适的适配产品
err_012传入参数不正确
err_014模型请求失败
err_015数据源请求时出现异常
err_016模型计算时出现异常
err_017数据源请求超时
err_018模型请求超时
-99999系统处理异常,请联系羽山数据

羽山数据API产品接入信息

报表设置

分类 : 1.对接信息
名称说明
IP白名单
本系统具有IP白名单限制,需要先请确认自身服务器公网IP已由羽山数据运维工程师加入
协议
HTTP/HTTPS POST
编码格式
UTF8
HEAD: X_GLAD_ACCT_ID
必填,开户后将获得接入账号acct_id,如“yushan_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样例
{
  "acct_id": "yushan_test_user",
  "prod_id": "P_B_B606",
  "req_data": {
    这里是业务入参
  },
  "req_time": 1545270159122,
  "request_sn": "4df1e3c9583d40a9a57f63e4ab153189"
}
明文Request JSON样例说明
acct_id 需要使用自己的账户。inf_id&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 系统代码。
技术支持
13764219628 阿南
分类 : 2.加解密方法
名称说明
私钥
登录系统或联系技术支持获得接入KEY,加密JSON Request 和解密response密文时需要使用。注意要严格保密使用,请勿外泄,如有遗失,自行负责!
请求报文加密算法
将request JSON明文aes-128-cbc 加密后base64编码,随后POST提交.
接收报文解密算法
将response JSON使用base64解码后,aes-128-cbc解密为明文.
加解密样例(Linux 命令)
##加密命令实现
echo -n '{"acct_id":"yushan_test_user","prod_id":"P_C_B008","req_data":{"cardNo":"120105198504090312","name":"刘北"},
"req_time":1545270159122,"request_sn":"4df1e3c9583d40a9a57f63e4ab153189"}' | 
openssl  aes-128-cbc  -K 8f781ee51319e00535de09525af6068b -iv 30303030303030303030303030303030 |base64  -w 0

##解密命令实现
echo -n 'lQCG4JX7L0VwyAMBP7v05DwqdgVRiKEp6ExdIvlyCVpvDCSc671
csbiSsLIsORrJVXVvuAPKKYhPKeJhe6XYolGa6VvfXK7irFcohKmcMVxokNba1+
o4GQkjMXxQdVC1Lqx2Q9XeVS2pGcFrzJKlOHRt7yJWVahURpEmXL8IA2d
ozEhrG5bBnWc3jTZYO50OQBH0jCOsjRE8q5qI5UQCA42gNposviVrVfcnZJRqqyrvVW
kOGF8uqc57sKLzVVzgvdTZuoHWWwoyPmKUXq9dNw==' | base64 -d | openssl aes-128-cbc -d -K 8f781ee51319e00535de09525af6068b -iv 30303030303030303030303030303030 -p