首页 登录 注册

开始免费体验

芸豆票据API接口文档说明-V2.0

概述

嘉芸汇以其独有的资源和实力，为客户提供扫描票据的云端识别服务。 只需上传符合质量要求的（300dpi，格式为jpg）图片，即可返回票据识别的数据结果，用于后续应用。

签名验证

本接口通过调用者在header传入的＇x-cid＇，x-oid，＇x-signature＇，＇t＇及c-url等相关数据，将部分数据拼合成字符串并进行md5加密生成私密钥，与调用者传入的私密钥进行比对校验，以此对客户信息进行验证。

传票需知

本接口对用户传入的＇image＇参数值有无及大小进行审核（不大于２Ｍ）。


票据识别接口

概述

嘉芸汇以其独有的资源和实力，为客户提供扫描票据的云端识别服务。
只需上传符合质量要求的（300dpi，格式为jpg）图片，即可返回票据识别的数据结果，用于后续应用。

发票上传接口地址

请求方式 url
POST http(s)://cloud.yundoukuaiji.com/api/bill/upload

Headers 以及 签名验证

参数 参数说明 备注
x-cid 公司ID 相关信息联系管理员开通所要
x-signature 加密参数 小写(md5(加密串))
t 时间戳
oid 数据的id 唯一标示，防止重新上传 （调用方提供）
c-url 回调地址 客户自定义回调地址 
  1.  备注:
  2.  1. 加密串 = (私钥-API-公司ID-时间戳)
  3.  2. API = /api/bill/upload （接口地址）

POST 请求参数

参数 参数说明 备注
image 识别图片 （0，2）M Base64(图片文件数据)

响应参数

返回值为json格式，示例如下

  1. {                    
  2.     data: {'id':1},//返回上传的图片ID               
  3.     code:1,//0、成功 1、失败                    
  4.     message:"",//提示信息，文字部分
  5. }

POST 发票信息同步

  1.  备注:
  2.  1.请求地址,此地址为合作方提供的接口地址
  3.  2.信息同步规则
  1. 回掉数据结构
  2. {
  3.     code: 0,//0成功，其他失败
  4.     x-oid:123//合作方提供的id
  5.     bid:123//票据ID
  6.     message:''//提示信息
  7.     type : 'xxx'//发票类型    
  8.     data: {'xxx'}//根据发票类型返回不同的数据格式 
  9. }

type 详解

  1. 发票类型集合： 火车票，飞机票，出租车票，长途客车票，定额发票，过路过桥费，水电费，工缴费，办公用品，住宿费，停车费，快递费，电话费，船票，门票，汽油费，公交一卡通，银行发票，增值税专用发票，增值税普通发票

data 详解

  1. 发票类型 ：火车票
  2. data:{
  3.      sign_date: 日期
  4.      full_name: 姓名
  5.      id_number: 身份证号码
  6.      amount: 金额
  7. }
  8. 发票类型 ：滴滴行程单
  9. data:{
  10.      sign_date: 日期
  11.      amount:金额
  12.      mobile: 手机号码
  13. }
  14. 发票类型：飞机票
  15. data:{
  16.      sign_date: 日期
  17.      amount: 金额
  18.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  19.      territory: 境内外标记   1、境内 2、境外
  20.      full_name: 姓名
  21.      id_number :身份证号码
  22.      chapter:章 (1有章，2无章)
  23. }
  24. 发票类型 ：出租车票
  25. data:{
  26.      sign_date: 日期
  27.      Invoice_code: 发票代码
  28.      invoice_number:发票号码
  29.      amount: 金额
  30.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  31.      time: 时间
  32.      license_number : 车号
  33.      chapter:章 (1有章，2无章)
  34. }
  35. 发票类型 ：长途客车票
  36. data:{
  37.      sign_date: 日期
  38.      Invoice_code: 发票代码
  39.      invoice_number:发票号码
  40.      full_name:姓名
  41.      amount: 金额
  42.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  43.      chapter:章 (1有章，2无章)
  44. }
  46. 发票类型 ：定额发票
  47. data:{
  48.      sign_date: 日期
  49.      Invoice_code: 发票代码
  50.      invoice_number:发票号码
  51.      type:费用类型
  52.      amount: 金额
  53.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  54.      chapter:章 (1有章，2无章)
  55. }
  56. 发票类型 ：过路过桥费
  57. data:{
  58.      sign_date: 日期
  59.      Invoice_code: 发票代码
  60.      invoice_number:发票号码
  61.      amount: 金额
  62.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  63.      chapter:章 (1有章，2无章)
  64. }
  65. 发票类型 ：水电费
  66. data:{
  67.      sign_date: 日期
  68.      Invoice_code: 发票代码
  69.      invoice_number:发票号码
  70.      amount: 金额
  71.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  72.      chapter:章 (1有章，2无章)
  73. }
  74. 发票类型 ：公交
  75. data:{
  76.      sign_date: 日期
  77.      Invoice_code: 发票代码
  78.      invoice_number:发票号码
  79.      amount: 金额
  80.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  81.      chapter:章 (1有章，2无章)
  82. }
  83. 发票类型 ：办公用品
  84. data:{
  85.      sign_date: 日期
  86.      Invoice_code: 发票代码
  87.      invoice_number:发票号码
  88.      amount: 金额
  89.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  90.      chapter:章 (1有章，2无章)
  91. }
  92. 发票类型 ：住宿费
  93. data:{
  94.      sign_date: 日期
  95.      Invoice_code: 发票代码
  96.      invoice_number:发票号码
  97.      amount: 金额
  98.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  99.      chapter:章 (1有章，2无章)
  100. }
  101. 发票类型 ：停车费
  102. data:{
  103.      sign_date: 日期
  104.      Invoice_code: 发票代码
  105.      invoice_number:发票号码
  106.      amount: 金额
  107.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  108.      chapter:章 (1有章，2无章)
  109. }
  110. 发票类型 ：快递费
  111. data:{
  112.      sign_date: 日期
  113.      Invoice_code: 发票代码
  114.      invoice_number:发票号码
  115.      amount: 金额
  116.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  117.      chapter:章 (1有章，2无章)
  118. }
  119. 发票类型 ：电话费
  120. data:{
  121.      sign_date: 日期
  122.      Invoice_code: 发票代码
  123.      invoice_number:发票号码
  124.      amount: 金额
  125.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  126.      chapter:章 (1有章，2无章)
  127. }
  128. 发票类型 ：船票
  129. data:{
  130.      sign_date: 日期
  131.      Invoice_code: 发票代码
  132.      invoice_number:发票号码
  133.      amount: 金额
  134.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  135.      chapter:章 (1有章，2无章)
  136. }
  137. 发票类型 ：门票
  138. data:{
  139.      sign_date: 日期
  140.      Invoice_code: 发票代码
  141.      invoice_number:发票号码
  142.      amount: 金额
  143.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  144.      chapter:章 (1有章，2无章)
  145. }
  146. 发票类型 ：汽油费
  147. data:{
  148.      sign_date: 日期
  149.      Invoice_code: 发票代码
  150.      invoice_number:发票号码
  151.      city:城市
  152.      province:省份
  153.      amount: 金额
  154.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  155.      chapter:章 (1有章，2无章)
  156. }
  157. 发票类型 ：公交一卡通
  158. data:{
  159.      sign_date: 日期
  160.      Invoice_code: 发票代码
  161.      invoice_number:发票号码
  162.      amount: 金额
  163.      producer: 监制章  61国家税务总局 62 国家税务局 63 其他(包含地方等监制)
  164.      chapter:章 (1有章，2无章)
  165. }
  166. 发票类型：银行票据
  167. data:{
  168.     sign_date:
  169.     Amount : 金额   
  170.     pay_name： 付款方名称
  171.     pay_bank： 付款方银行
  172.     pay_account： 付款方账号
  173.     recieve_name： 收款方名称
  174.     recieve_bank： 收款方银行
  175.     recieve_account：收款方账号
  176.     chapter:章 (1有章，2无章)
  177. }
  179. 发票类型：增值税专用发票，增值税普通发票
  180. data:{
  181.     sign_date:日期
  182.     Amount : 金额   
  183.     Tax:税额
  184.     total_price:合计
  185.     vcode:校验码
  186.     invoice_code:发票代码
  187.     invoice_number:发票号码
  188.     chapter:章 (1有章，2无章)
  189.     invoice_order: 联次 0，无。10发票联 11、抵扣联 12 销方联次(包含其他等联次)
  190.     pay_name： 付款方名称
  191.     pay_bank： 付款方银行
  192.     pay_account： 付款方账号
  193.     pay_tel:付款方手机
  194.     pay_address:付款方地址
  195.     payer_tax_identification_number:付款方识别号
  196.     recieve_name： 收款方名称
  197.     recieve_bank： 收款方银行
  198.     recieve_account：收款方账号
  199.     receive_tel:收款方手机
  200.     receive_address:收款方地址
  201.     receive_tax_identification_number:收款方识别号
  202.     Item：[
  203.         {
  204.              name:摘要名称
  205.              standard:
  206.              unit:单位
  207.              number:数量
  208.              unit_price:单价
  209.              amount:金额
  210.              tax:税额
  211.              taxrate:税率
  212.         }
  213.     ]
  214. }

二维码识别接口

1.1.1 二维码上传

请求地址URL：http(s)://{host}:{port}/api/bill/qr_upload

HTTP(S)请求方式：POST

1.1.2 参与签名参数（header）

字段名 描述
x-cid 用户ID
x-oid 数据的id，唯一标示，防止重新上传（调用方提供）
x-signature 签名私密钥 = APIKEY，URI，用户ID，时间戳 将此数据用"-"链接 并且 md5
c-url 自定义回调地址
t 当前时间戳

1.1.3 请求参数

字段名 限制 描述
image （０，２）Ｍ Base64(图片文件数据)

1.1.4 返回结果

字段名 描述
data 返回的数据
code 0、成功 1、失败
message 提示信息，文字部分

1.1.5 data 详细

字段名 描述
id 我方数据唯一标示

1.1.6 返回样例

{"data":{"id":34},"code":0,"message":"\u4e0a\u4f20\u6210\u529f"}

1.2.1 二维码信息同步

字段名 类型 描述
x-oid srting 合作方提供的ID
code int 状态 0 成功
message srting 提示信息
data array 返回的数据
   id int 发票ID
   content string 二维码信息

1.2.2 返回结果