财务票据OCR
<p>[TOC]</p>
<h3>接口描述</h3>
<ul>
<li>支持财务场景中13种常见票据的识别，包括增值税发票、卷票、机打发票、定额发票、火车票（含铁路电子客票）、出租车票、网约车行程单、飞机行程单、汽车票、过路过桥费、船票、机动车/二手车销售发票</li>
<li>支持多张不同种类票据在同一张图片上的混贴场景，可返回每张票据的种类及票面信息的识别结果</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/ocr/finance-bill</code></p>
<h3>请求方式</h3>
<ul>
<li>POST</li>
</ul>
<h3>请求格式</h3>
<ul>
<li>x-www-form-urlencoded</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>appId</td>
<td>String</td>
<td>是</td>
<td>服务商分配的唯一标识</td>
</tr>
<tr>
<td>timestamp</td>
<td>Long</td>
<td>是</td>
<td>当前时间的毫秒数</td>
</tr>
<tr>
<td>sign</td>
<td>String</td>
<td>是</td>
<td>签名，见签名算法说明</td>
</tr>
<tr>
<td>image</td>
<td>String</td>
<td>否</td>
<td>票据图片base64</td>
</tr>
<tr>
<td>pdf</td>
<td>String</td>
<td>否</td>
<td>票据PDF文件的base64</td>
</tr>
<tr>
<td>pdfNum</td>
<td>String</td>
<td>否</td>
<td>需要识别的PDF文件的对应页码，不传默认识别第 1 页</td>
</tr>
<tr>
<td>ofd</td>
<td>String</td>
<td>否</td>
<td>票据OFD文件的base64</td>
</tr>
<tr>
<td>ofdNum</td>
<td>String</td>
<td>否</td>
<td>需要识别的OFD文件的对应页码，不传默认识别第 1 页</td>
</tr>
<tr>
<td>file</td>
<td>File</td>
<td>否</td>
<td>票据文件</td>
</tr>
<tr>
<td>url</td>
<td>String</td>
<td>否</td>
<td>票据图片url，pdf文件url、ofd文件url</td>
</tr>
</tbody>
</table>
<ul>
<li>image、pdf、ofd、file、url 必须提供一个，优先级：image > pdf > ofd > file > url</li>
<li>发票图片、pdf或odf文件不超过4M，最短边至少15px，最长边最大4096px，支持jpg/jpeg/png/bmp格式</li>
<li>发票图片支持jpg/jpeg/png/bmp格式</li>
</ul>
<h3>签名算法说明</h3>
<pre><code>sign = sha256( appId + appSecret + timestamp)</code></pre>
<p>用服务商分配的 appId、服务商分配的 appSecret，当前时间毫秒数 timestamp，按上述顺序拼接成字符串，再进行 sha256 哈希得到。如下：</p>
<pre><code class="language-java">String appId = &quot;xyzxy2121zxyz&quot;；
String timestamp = &quot;1555378976238&quot;；
String appSecret = &quot;efcefcef1121cefcefc1212121&quot;；
String str = appId + appSecret + timestamp；
String sign = sha256(str)；</code></pre>
<h3>正确返回样例</h3>
<pre><code class="language-json">{
&quot;data&quot;: {
&quot;resultCount&quot;: 2,
&quot;results&quot;: [ // 识别结果，多张不同种类的票据，混贴在一起，返回多个
{
&quot;type&quot;: &quot;vat_invoice&quot;, // 票据种类, 详见type字段说明
&quot;content&quot;: {
//单张票据的识别结果,详见各种类说明
}
}
],
&quot;pdfSize&quot;:1, //传入PDF文件的总页数，当 pdf_file 参数有效时返回该字段
},
&quot;code&quot;: 200, // 详见code返回码说明
&quot;msg&quot;: &quot;成功&quot;, // code 对应的描述
&quot;charge&quot;: true, // 计费标志
&quot;taskNo&quot;: &quot;30853523396532582768&quot;, // 本次请求号
}</code></pre>
<h3>错误返回样例</h3>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;照片格式不正确&quot;,
&quot;code&quot;: 400
}</code></pre>
<h3>返回字段说明</h3>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>返回码，详见code返回码说明</td>
</tr>
<tr>
<td>msg</td>
<td>code对应的描述</td>
</tr>
<tr>
<td>charge</td>
<td>是否计费</td>
</tr>
<tr>
<td>taskNo</td>
<td>本次请求号</td>
</tr>
<tr>
<td>data</td>
<td>返回具体结果，object类型，详见成功返回体</td>
</tr>
</tbody>
</table>
<h4>type 字段说明</h4>
<table>
<thead>
<tr>
<th>type</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>vat_invoice</td>
<td>增值税专用发票</td>
</tr>
<tr>
<td>taxi_receipt</td>
<td>出租车票</td>
</tr>
<tr>
<td>train_ticket</td>
<td>火车票</td>
</tr>
<tr>
<td>quota_invoice</td>
<td>定额发票</td>
</tr>
<tr>
<td>air_ticket</td>
<td>飞机行程单</td>
</tr>
<tr>
<td>roll_normal_invoice</td>
<td>增值税普通发票（卷票）</td>
</tr>
<tr>
<td>printed_invoice</td>
<td>机打发票</td>
</tr>
<tr>
<td>bus_ticket</td>
<td>汽车票</td>
</tr>
<tr>
<td>toll_invoice</td>
<td>过路过桥费发票</td>
</tr>
<tr>
<td>ferry_ticket</td>
<td>船票</td>
</tr>
<tr>
<td>motor_vehicle_invoice</td>
<td>机动车销售发票</td>
</tr>
<tr>
<td>used_vehicle_invoice</td>
<td>二手车发票</td>
</tr>
<tr>
<td>taxi_online_ticket</td>
<td>网约车行程单</td>
</tr>
<tr>
<td>limit_invoice</td>
<td>限额发票</td>
</tr>
<tr>
<td>shopping_receipt</td>
<td>购物小票</td>
</tr>
<tr>
<td>pos_invoice</td>
<td>POS小票</td>
</tr>
<tr>
<td>others</td>
<td>其他</td>
</tr>
</tbody>
</table>
<h4>增值税发票</h4>
<p>type 的返回结果为 vat_invoice，即“增值税发票”时，识别结果的返回字段如下：</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>ServiceType</td>
<td>发票消费类型。不同消费类型输出：餐饮、电器设备、通讯、服务、日用品食品、医疗、交通、其他</td>
</tr>
<tr>
<td>InvoiceTypeOrg</td>
<td>发票名称</td>
</tr>
<tr>
<td>InvoiceType</td>
<td>增值税发票的细分类型。 不同细分类型的发票输出：普通发票、专用发票、电子普通发票、电子专用发票、通行费电子普票、区块链发票、通用机打电子发票、电子发票(专用发票)、电子发票(普通发票)</td>
</tr>
<tr>
<td>InvoiceTag</td>
<td>增值税发票左上角标志。 包含：通行费、销项负数、代开、收购、成品油、其他</td>
</tr>
<tr>
<td>InvoiceCode</td>
<td>发票代码</td>
</tr>
<tr>
<td>InvoiceNum</td>
<td>发票号码</td>
</tr>
<tr>
<td>InvoiceCodeConfirm</td>
<td>发票代码的辅助校验码，一般业务情景可忽略</td>
</tr>
<tr>
<td>InvoiceNumConfirm</td>
<td>发票号码的辅助校验码，一般业务情景可忽略</td>
</tr>
<tr>
<td>CheckCode</td>
<td>校验码。增值税专票无此参数</td>
</tr>
<tr>
<td>InvoiceNumDigit</td>
<td>数电票号码。密码区部分的数电票号码，仅在纸质的数电票上出现</td>
</tr>
<tr>
<td>InvoiceDate</td>
<td>开票日期</td>
</tr>
<tr>
<td>PurchaserName</td>
<td>购方名称</td>
</tr>
<tr>
<td>PurchaserRegisterNum</td>
<td>购方纳税人识别号</td>
</tr>
<tr>
<td>PurchaserAddress</td>
<td>购方地址及电话</td>
</tr>
<tr>
<td>PurchaserBank</td>
<td>购方开户行及账号</td>
</tr>
<tr>
<td>Password</td>
<td>密码区</td>
</tr>
<tr>
<td>Province</td>
<td>省</td>
</tr>
<tr>
<td>City</td>
<td>市</td>
</tr>
<tr>
<td>SheetNum</td>
<td>联次信息。专票第一联到第三联分别输出：第一联：记账联、第二联：抵扣联、第三联：发票联；普通发票第一联到第二联分别输出：第一联：记账联、第二联：发票联</td>
</tr>
<tr>
<td>Agent</td>
<td>否代开</td>
</tr>
<tr>
<td>OnlinePay</td>
<td>子支付标识。仅区块链发票含有此参数</td>
</tr>
<tr>
<td>SellerName</td>
<td>销售方名称</td>
</tr>
<tr>
<td>SellerRegisterNum</td>
<td>销售方纳税人识别号</td>
</tr>
<tr>
<td>SellerAddress</td>
<td>销售方地址及电话</td>
</tr>
<tr>
<td>SellerBank</td>
<td>销售方开户行及账号</td>
</tr>
<tr>
<td>TotalAmount</td>
<td>合计金额</td>
</tr>
<tr>
<td>TotalTax</td>
<td>合计税额</td>
</tr>
<tr>
<td>AmountInWords</td>
<td>价税合计(大写)</td>
</tr>
<tr>
<td>AmountInFiguers</td>
<td>价税合计(小写)</td>
</tr>
<tr>
<td>Payee</td>
<td>收款人</td>
</tr>
<tr>
<td>Checker</td>
<td>复核</td>
</tr>
<tr>
<td>NoteDrawer</td>
<td>开票人</td>
</tr>
<tr>
<td>Remarks</td>
<td>备注</td>
</tr>
<tr>
<td>CommodityName</td>
<td>货物名称</td>
</tr>
<tr>
<td>CommodityType</td>
<td>规格型号</td>
</tr>
<tr>
<td>CommodityUnit</td>
<td>单位</td>
</tr>
<tr>
<td>CommodityNum</td>
<td>数量</td>
</tr>
<tr>
<td>CommodityPrice</td>
<td>单价</td>
</tr>
<tr>
<td>CommodityAmount</td>
<td>金额</td>
</tr>
<tr>
<td>CommodityTaxRate</td>
<td>税率</td>
</tr>
<tr>
<td>CommodityTax</td>
<td>税额</td>
</tr>
<tr>
<td>CommodityPlateNum</td>
<td>车牌号。仅通行费增值税电子普通发票含有此参数</td>
</tr>
<tr>
<td>CommodityVehicleType</td>
<td>类型。仅通行费增值税电子普通发票含有此参数</td>
</tr>
<tr>
<td>CommodityStartDate</td>
<td>通行日期起。仅通行费增值税电子普通发票含有此参数</td>
</tr>
<tr>
<td>CommodityEndDate</td>
<td>通行日期止。仅通行费增值税电子普通发票含有此参数</td>
</tr>
</tbody>
</table>
<h4>出租车票</h4>
<p>type 的返回结果为 taxi_receipt，即“出租车票”时，识别结果的返回字段如下</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>ServiceType</td>
<td>发票消费类型。出租车票此字段固定输出：交通</td>
</tr>
<tr>
<td>InvoiceCode</td>
<td>发票代号</td>
</tr>
<tr>
<td>InvoiceNum</td>
<td>发票号码</td>
</tr>
<tr>
<td>TaxiNum</td>
<td>车牌号</td>
</tr>
<tr>
<td>Date</td>
<td>日期</td>
</tr>
<tr>
<td>Time</td>
<td>上下车时间</td>
</tr>
<tr>
<td>PickupTime</td>
<td>上车时间</td>
</tr>
<tr>
<td>DropoffTime</td>
<td>下车时间</td>
</tr>
<tr>
<td>Fare</td>
<td>金额</td>
</tr>
<tr>
<td>FuelOilSurcharge</td>
<td>燃油附加费</td>
</tr>
<tr>
<td>CallServiceSurcharge</td>
<td>叫车服务费</td>
</tr>
<tr>
<td>TotalFare</td>
<td>总金额</td>
</tr>
<tr>
<td>Location</td>
<td>开票城市</td>
</tr>
<tr>
<td>Province</td>
<td>省</td>
</tr>
<tr>
<td>City</td>
<td>市</td>
</tr>
<tr>
<td>PricePerkm</td>
<td>单价</td>
</tr>
<tr>
<td>Distance</td>
<td>里程</td>
</tr>
</tbody>
</table>
<h4>火车票</h4>
<p>type 的返回结果为 train_ticket，即“火车票”时，识别结果的返回字段如下</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>ServiceType</td>
<td>发票消费类型。火车票此字段固定输出：交通</td>
</tr>
<tr>
<td>ticket_num</td>
<td>车票号</td>
</tr>
<tr>
<td>starting_station</td>
<td>始发站</td>
</tr>
<tr>
<td>train_num</td>
<td>车次号</td>
</tr>
<tr>
<td>destination_station</td>
<td>到达站</td>
</tr>
<tr>
<td>date</td>
<td>出发日期</td>
</tr>
<tr>
<td>ticket_rates</td>
<td>车票金额</td>
</tr>
<tr>
<td>seat_category</td>
<td>席别</td>
</tr>
<tr>
<td>name</td>
<td>乘客姓名</td>
</tr>
<tr>
<td>ID_card</td>
<td>身份证号</td>
</tr>
<tr>
<td>serial_number</td>
<td>序列号</td>
</tr>
<tr>
<td>sales_station</td>
<td>售站</td>
</tr>
<tr>
<td>time</td>
<td>时间</td>
</tr>
<tr>
<td>seat_num</td>
<td>座位号</td>
</tr>
<tr>
<td>Waiting_area</td>
<td>候检区</td>
</tr>
<tr>
<td>word</td>
<td>识别结果字符串，以上各字段均包含</td>
</tr>
</tbody>
</table>
<h4>定额发票</h4>
<p>type 的返回结果为 quota_invoice，即“定额发票”时，识别结果的返回字段如下</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>ServiceType</td>
<td>发票消费类型。定额发票此字段固定输出：交通</td>
</tr>
<tr>
<td>invoice_code</td>
<td>发票代码</td>
</tr>
<tr>
<td>invoice_number</td>
<td>发票号码</td>
</tr>
<tr>
<td>invoice_rate</td>
<td>金额</td>
</tr>
<tr>
<td>invoice_rate_in_figure</td>
<td>金额小写</td>
</tr>
<tr>
<td>invoice_rate_in_word</td>
<td>金额大写</td>
</tr>
<tr>
<td>Province</td>
<td>省</td>
</tr>
<tr>
<td>City</td>
<td>市</td>
</tr>
<tr>
<td>Location</td>
<td>发票所在地</td>
</tr>
<tr>
<td>invoice_type</td>
<td>发票名称</td>
</tr>
</tbody>
</table>
<h4>飞机行程单</h4>
<p>type 的返回结果为 air_ticket，即“飞机行程单”时，识别结果的返回字段如下</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>ServiceType</td>
<td>发票消费类型。飞机行程单此字段固定输出：交通</td>
</tr>
<tr>
<td>name</td>
<td>姓名</td>
</tr>
<tr>
<td>starting_station</td>
<td>始发站</td>
</tr>
<tr>
<td>destination_station</td>
<td>目的站</td>
</tr>
<tr>
<td>flight</td>
<td>航班号</td>
</tr>
<tr>
<td>date</td>
<td>日期</td>
</tr>
<tr>
<td>ticket_number</td>
<td>电子客票号码</td>
</tr>
<tr>
<td>fare</td>
<td>票价</td>
</tr>
<tr>
<td>dev_fund</td>
<td>民航发展基金/基建费</td>
</tr>
<tr>
<td>oil_money</td>
<td>燃油附加费</td>
</tr>
<tr>
<td>other_tax</td>
<td>其他税费</td>
</tr>
<tr>
<td>ticket_rates</td>
<td>合计金额</td>
</tr>
<tr>
<td>start_date</td>
<td>填开日期</td>
</tr>
<tr>
<td>id_no</td>
<td>身份证号</td>
</tr>
<tr>
<td>carrier</td>
<td>承运人</td>
</tr>
<tr>
<td>time</td>
<td>时间</td>
</tr>
<tr>
<td>issued_by</td>
<td>订票渠道</td>
</tr>
<tr>
<td>serial_number</td>
<td>印刷序号</td>
</tr>
<tr>
<td>insurance</td>
<td>保险费</td>
</tr>
<tr>
<td>fare_basis</td>
<td>客票级别</td>
</tr>
<tr>
<td>class</td>
<td>座位等级</td>
</tr>
<tr>
<td>agent_code</td>
<td>销售单位号</td>
</tr>
<tr>
<td>endorsement</td>
<td>签注</td>
</tr>
<tr>
<td>allow</td>
<td>免费行李</td>
</tr>
<tr>
<td>ck</td>
<td>验证码</td>
</tr>
<tr>
<td>effective_date</td>
<td>客票生效日期</td>
</tr>
<tr>
<td>expiration_date</td>
<td>有效期截止日期</td>
</tr>
</tbody>
</table>
<h4>卷票</h4>
<p>type 的返回结果为 roll_normal_invoice，即“卷票”时，识别结果的返回字段如下</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>InvoiceType</td>
<td>发票名称</td>
</tr>
<tr>
<td>InvoiceCode</td>
<td>发票代码</td>
</tr>
<tr>
<td>InvoiceNum</td>
<td>发票号码</td>
</tr>
<tr>
<td>MachineNum</td>
<td>机打号码。仅增值税卷票含有此参数</td>
</tr>
<tr>
<td>MachineCode</td>
<td>机器编号。仅增值税卷票含有此参数</td>
</tr>
<tr>
<td>InvoiceDate</td>
<td>开票日期</td>
</tr>
<tr>
<td>PurchaserName</td>
<td>购方名称</td>
</tr>
<tr>
<td>PurchaserRegisterNum</td>
<td>购方纳税人识别号</td>
</tr>
<tr>
<td>SellerName</td>
<td>销售方名称</td>
</tr>
<tr>
<td>SellerRegisterNum</td>
<td>销售方纳税人识别号</td>
</tr>
<tr>
<td>TotalTax</td>
<td>价税合计</td>
</tr>
<tr>
<td>AmountInWords</td>
<td>合计金额(大写)</td>
</tr>
<tr>
<td>AmountInFiguers</td>
<td>合计金额(小写)</td>
</tr>
<tr>
<td>Payee</td>
<td>收款人</td>
</tr>
<tr>
<td>CheckCode</td>
<td>校验码。增值税专票无此参数</td>
</tr>
<tr>
<td>Province</td>
<td>省</td>
</tr>
<tr>
<td>City</td>
<td>市</td>
</tr>
<tr>
<td>CommodityName</td>
<td>货物名称</td>
</tr>
<tr>
<td>CommodityNum</td>
<td>数量</td>
</tr>
<tr>
<td>CommodityPrice</td>
<td>单价</td>
</tr>
<tr>
<td>CommodityAmount</td>
<td>金额</td>
</tr>
</tbody>
</table>
<h4>机打发票</h4>
<p>type 的返回结果为 printed_invoice，即“机打发票”时，识别结果的返回字段如下</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>ServiceType</td>
<td>发票消费类型。不同消费类型输出：餐饮、电器设备、通讯、服务、日用品食品、医疗、交通、其他</td>
</tr>
<tr>
<td>InvoiceType</td>
<td>发票类型</td>
</tr>
<tr>
<td>InvoiceCode</td>
<td>发票代码</td>
</tr>
<tr>
<td>InvoiceNum</td>
<td>发票号码</td>
</tr>
<tr>
<td>InvoiceDate</td>
<td>开票日期</td>
</tr>
<tr>
<td>AmountInFiguers</td>
<td>合计金额小写</td>
</tr>
<tr>
<td>AmountInWords</td>
<td>合计金额大写</td>
</tr>
<tr>
<td>MachineNum</td>
<td>机打号码</td>
</tr>
<tr>
<td>CheckCode</td>
<td>校验码</td>
</tr>
<tr>
<td>SellerName</td>
<td>销售方名称</td>
</tr>
<tr>
<td>SellerRegisterNum</td>
<td>销售方纳税人识别号</td>
</tr>
<tr>
<td>PurchaserName</td>
<td>购买方名称</td>
</tr>
<tr>
<td>PurchaserRegisterNum</td>
<td>购买方纳税人识别号</td>
</tr>
<tr>
<td>TotalTax</td>
<td>合计税额</td>
</tr>
<tr>
<td>Province</td>
<td>省</td>
</tr>
<tr>
<td>City</td>
<td>市</td>
</tr>
<tr>
<td>Time</td>
<td>时间</td>
</tr>
<tr>
<td>SheetNum</td>
<td>联次</td>
</tr>
<tr>
<td>CommodityName</td>
<td>商品名称</td>
</tr>
<tr>
<td>CommodityUnit</td>
<td>商品单位</td>
</tr>
<tr>
<td>CommodityPrice</td>
<td>商品单价</td>
</tr>
<tr>
<td>CommodityNum</td>
<td>商品数量</td>
</tr>
<tr>
<td>CommodityAmount</td>
<td>商品金额</td>
</tr>
</tbody>
</table>
<h4>汽车票</h4>
<p>type 的返回结果为 bus_ticket，即“汽车票”时，识别结果的返回字段如下</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>ServiceType</td>
<td>发票消费类型。汽车票此字段固定输出：交通</td>
</tr>
<tr>
<td>InvoiceCode</td>
<td>发票代码</td>
</tr>
<tr>
<td>InvoiceNum</td>
<td>发票号码</td>
</tr>
<tr>
<td>Date</td>
<td>日期</td>
</tr>
<tr>
<td>Time</td>
<td>时间</td>
</tr>
<tr>
<td>ExitStation</td>
<td>出发站</td>
</tr>
<tr>
<td>Amount</td>
<td>金额</td>
</tr>
<tr>
<td>IdCard</td>
<td>身份证号</td>
</tr>
<tr>
<td>ArrivalStation</td>
<td>到达站</td>
</tr>
<tr>
<td>Name</td>
<td>姓名</td>
</tr>
<tr>
<td>InvoiceTime</td>
<td>开票日期</td>
</tr>
</tbody>
</table>
<h4>过路过桥费</h4>
<p>type 的返回结果为 toll_invoice，即“过路过桥费”时，识别结果的返回字段如下</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>ServiceType</td>
<td>发票消费类型。过路过桥费此字段固定输出：交通</td>
</tr>
<tr>
<td>InvoiceCode</td>
<td>发票代码</td>
</tr>
<tr>
<td>InvoiceNum</td>
<td>发票号码</td>
</tr>
<tr>
<td>Entrance</td>
<td>入口</td>
</tr>
<tr>
<td>Exit</td>
<td>出口</td>
</tr>
<tr>
<td>OutDate</td>
<td>日期</td>
</tr>
<tr>
<td>OutTime</td>
<td>时间</td>
</tr>
<tr>
<td>TotalAmount</td>
<td>金额</td>
</tr>
<tr>
<td>Province</td>
<td>省</td>
</tr>
<tr>
<td>City</td>
<td>市</td>
</tr>
</tbody>
</table>
<h4>船票</h4>
<p>type 的返回结果为 toll_invoice，即“船票”时，识别结果的返回字段如下</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>ServiceType</td>
<td>发票消费类型。船票此字段固定输出：交通</td>
</tr>
<tr>
<td>InvoiceType</td>
<td>发票类型</td>
</tr>
<tr>
<td>InvoiceCode</td>
<td>发票代码</td>
</tr>
<tr>
<td>InvoiceNum</td>
<td>发票号码</td>
</tr>
<tr>
<td>ExitStation</td>
<td>出发地点</td>
</tr>
<tr>
<td>ArrivalStation</td>
<td>到达地点</td>
</tr>
<tr>
<td>Amount</td>
<td>总金额</td>
</tr>
<tr>
<td>Date</td>
<td>开票日期</td>
</tr>
<tr>
<td>MoneyType</td>
<td>金额类型</td>
</tr>
<tr>
<td>BarCode</td>
<td>条码</td>
</tr>
<tr>
<td>BarCodeNum</td>
<td>条码编号</td>
</tr>
<tr>
<td>City</td>
<td>市</td>
</tr>
<tr>
<td>Province</td>
<td>省</td>
</tr>
<tr>
<td>InvoiceTitle</td>
<td>发票抬头，这里指该张船票的运行公司名</td>
</tr>
<tr>
<td>QrCode</td>
<td>二维码</td>
</tr>
<tr>
<td>Time</td>
<td>出发时间</td>
</tr>
<tr>
<td>TicketTime</td>
<td>制票时间</td>
</tr>
<tr>
<td>TicketDate</td>
<td>制票日期</td>
</tr>
<tr>
<td>PassengerName</td>
<td>乘客姓名</td>
</tr>
<tr>
<td>IdCard</td>
<td>乘客身份证号</td>
</tr>
</tbody>
</table>
<h4>机动车销售发票</h4>
<p>type 的返回结果为 motor_vehicle_invoice，即“机动车销售发票”时，识别结果的返回字段如下</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>date</td>
<td>开票日期</td>
</tr>
<tr>
<td>fapiao-daima</td>
<td>发票代码/机打代码</td>
</tr>
<tr>
<td>fapiao-haoma</td>
<td>发票号码/机打号码</td>
</tr>
<tr>
<td>printed-daima</td>
<td>机打代码</td>
</tr>
<tr>
<td>printed-haoma</td>
<td>机打号码</td>
</tr>
<tr>
<td>machine-num</td>
<td>机器编号</td>
</tr>
<tr>
<td>buyer-name</td>
<td>购买方名称</td>
</tr>
<tr>
<td>payer-tax-num</td>
<td>购买方身份证号码/组织机构代码</td>
</tr>
<tr>
<td>car-class</td>
<td>车辆类型</td>
</tr>
<tr>
<td>car-model</td>
<td>厂牌型号</td>
</tr>
<tr>
<td>product-location</td>
<td>产地</td>
</tr>
<tr>
<td>certificate-num</td>
<td>合格证号</td>
</tr>
<tr>
<td>engine-num</td>
<td>发动机号码</td>
</tr>
<tr>
<td>vin-num</td>
<td>车架号码</td>
</tr>
<tr>
<td>price-tax-big</td>
<td>价税合计</td>
</tr>
<tr>
<td>price-tax-small</td>
<td>价税合计小写</td>
</tr>
<tr>
<td>saler</td>
<td>销货单位名称</td>
</tr>
<tr>
<td>saler-phone</td>
<td>销货单位电话</td>
</tr>
<tr>
<td>saler-tax-num</td>
<td>销货单位纳税人识别号</td>
</tr>
<tr>
<td>saler-bank-num</td>
<td>销货单位账号</td>
</tr>
<tr>
<td>saler-address</td>
<td>销货单位地址</td>
</tr>
<tr>
<td>saler-bank</td>
<td>销货单位开户银行</td>
</tr>
<tr>
<td>tax-rate</td>
<td>税率</td>
</tr>
<tr>
<td>tax</td>
<td>税额</td>
</tr>
<tr>
<td>tax-jiguan</td>
<td>主管税务机关</td>
</tr>
<tr>
<td>tax-jiguan-daima</td>
<td>主管税务机关代码</td>
</tr>
<tr>
<td>price</td>
<td>不含税价格</td>
</tr>
<tr>
<td>limit-mount</td>
<td>限乘人数</td>
</tr>
<tr>
<td>toonage</td>
<td>吨位</td>
</tr>
<tr>
<td>sheet-num</td>
<td>联次</td>
</tr>
<tr>
<td>drawer</td>
<td>开票人</td>
</tr>
<tr>
<td>remarks</td>
<td>备注</td>
</tr>
<tr>
<td>import-certificate-num</td>
<td>进口证明书号</td>
</tr>
<tr>
<td>tax-payment-voucher-no</td>
<td>完整凭税编号</td>
</tr>
<tr>
<td>inspection-form-num</td>
<td>商检单号</td>
</tr>
</tbody>
</table>
<h4>二手车销售发票</h4>
<p>type 的返回结果为 used_vehicle_invoice，即“二手车销售发票”时，识别结果的返回字段如下</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>invoice_code</td>
<td>发票代码</td>
</tr>
<tr>
<td>invoice_num</td>
<td>发票号码</td>
</tr>
<tr>
<td>date</td>
<td>开票日期</td>
</tr>
<tr>
<td>tax_code</td>
<td>税控码</td>
</tr>
<tr>
<td>buyer</td>
<td>买方</td>
</tr>
<tr>
<td>buyer_id</td>
<td>买方身份证号</td>
</tr>
<tr>
<td>buyer_station</td>
<td>买方地址</td>
</tr>
<tr>
<td>buyer_tel</td>
<td>买方电话</td>
</tr>
<tr>
<td>saler</td>
<td>卖方</td>
</tr>
<tr>
<td>saler_id</td>
<td>卖方身份证号</td>
</tr>
<tr>
<td>saler_station</td>
<td>卖方地址</td>
</tr>
<tr>
<td>saler_tel</td>
<td>卖方电话</td>
</tr>
<tr>
<td>car_plate</td>
<td>车牌号</td>
</tr>
<tr>
<td>car_certificate</td>
<td>登记证号</td>
</tr>
<tr>
<td>car_class</td>
<td>车辆类型</td>
</tr>
<tr>
<td>vin_num</td>
<td>车架号</td>
</tr>
<tr>
<td>model</td>
<td>厂牌型号</td>
</tr>
<tr>
<td>to_station</td>
<td>转入地车管所名称</td>
</tr>
<tr>
<td>big_price</td>
<td>车价合计大写</td>
</tr>
<tr>
<td>small_price</td>
<td>车价合计小写</td>
</tr>
<tr>
<td>car_market</td>
<td>二手车市场</td>
</tr>
<tr>
<td>tax_num</td>
<td>纳税人识别号</td>
</tr>
<tr>
<td>tax_location</td>
<td>纳税人地址</td>
</tr>
<tr>
<td>tax_tel</td>
<td>纳税人电话</td>
</tr>
<tr>
<td>sheet_num</td>
<td>联次</td>
</tr>
</tbody>
</table>
<h4>网约车行程单</h4>
<p>type 的返回结果为 taxi_online_ticket，即“网约车行程单”时，识别结果的返回字段如下</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>ServiceType</td>
<td>发票消费类型。网约车行程单此字段固定输出：交通</td>
</tr>
<tr>
<td>service_provider</td>
<td>服务商</td>
</tr>
<tr>
<td>start_time</td>
<td>行程开始时间</td>
</tr>
<tr>
<td>destination_time</td>
<td>行程结束时间</td>
</tr>
<tr>
<td>phone</td>
<td>行程人手机号</td>
</tr>
<tr>
<td>application_date</td>
<td>申请日期</td>
</tr>
<tr>
<td>total_fare</td>
<td>总金额</td>
</tr>
<tr>
<td>item_num</td>
<td>行程信息中包含的行程数量</td>
</tr>
<tr>
<td>items</td>
<td>行程信息</td>
</tr>
<tr>
<td>item_id</td>
<td>行程信息的对应序号</td>
</tr>
<tr>
<td>item_provider</td>
<td>行程信息的对应服务商</td>
</tr>
<tr>
<td>pickup_time</td>
<td>上车时间</td>
</tr>
<tr>
<td>pickup_date</td>
<td>上车日期</td>
</tr>
<tr>
<td>car_type</td>
<td>车型</td>
</tr>
<tr>
<td>distance</td>
<td>里程</td>
</tr>
<tr>
<td>start_place</td>
<td>起点</td>
</tr>
<tr>
<td>destination_place</td>
<td>终点</td>
</tr>
<tr>
<td>city</td>
<td>城市</td>
</tr>
<tr>
<td>fare</td>
<td>金额</td>
</tr>
</tbody>
</table>
<h3>code返回码说明</h3>
<table>
<thead>
<tr>
<th>code</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功 （计费）</td>
</tr>
<tr>
<td>400</td>
<td>参数错误</td>
</tr>
<tr>
<td>404</td>
<td>接口地址不正确</td>
</tr>
<tr>
<td>500</td>
<td>系统维护，请稍候再试</td>
</tr>
<tr>
<td>601</td>
<td>接口未开通</td>
</tr>
<tr>
<td>602</td>
<td>账号停用</td>
</tr>
<tr>
<td>603</td>
<td>余额不足请充值</td>
</tr>
<tr>
<td>604</td>
<td>接口停用</td>
</tr>
<tr>
<td>606</td>
<td>调用超限，请稍候再试</td>
</tr>
<tr>
<td>607</td>
<td>ip不在白名单</td>
</tr>
<tr>
<td>609</td>
<td>请求过于频繁，请稍候再试</td>
</tr>
<tr>
<td>610</td>
<td>请求超时</td>
</tr>
<tr>
<td>999</td>
<td>其他，以实际返回为准</td>
</tr>
</tbody>
</table>