旅客运输
<h5>简要描述</h5>
<ul>
<li>此接口用于开具发票，目前支持旅客运输蓝字发票和差额票的开具</li>
</ul>
<h5>服务码</h5>
<ul>
<li>yspt_sdp_tspz_lkys_kp</li>
</ul>
<h5>数据格式</h5>
<ul>
<li><code>JSON</code></li>
</ul>
<h5>请求参数</h5>
<table>
<thead>
<tr>
<th>参数 </th>
<th>参数名 </th>
<th>类型 </th>
<th>长度 </th>
<th>必须 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>fptxx</td>
<td>发票头信息</td>
<td></td>
<td></td>
<td></td>
<td>父节点，包含下面的字段</td>
</tr>
<tr>
<td>djrq</td>
<td>单据日期</td>
<td>string</td>
<td>19</td>
<td>否</td>
<td>单据日期，为空时自动取系统时间 </br>格式：yyyy-MM-dd hh:mm:ss</td>
</tr>
<tr>
<td>xsdh</td>
<td>销售单号</td>
<td>string</td>
<td>40</td>
<td>是</td>
<td>销售订单号，每个企业唯一</td>
</tr>
<tr>
<td>fplx</td>
<td>发票类型</td>
<td>string</td>
<td>2</td>
<td>是</td>
<td>81:全电发票(专用发票)，82:全电发票(普通发票)</td>
</tr>
<tr>
<td>gfmc</td>
<td>购方名称</td>
<td>string</td>
<td>100</td>
<td>是</td>
<td>购方名称</td>
</tr>
<tr>
<td>gfnsrsbh</td>
<td>购方纳税人识别号</td>
<td>string</td>
<td>20</td>
<td>否</td>
<td>个人可为空，但必须有此节点。</td>
</tr>
<tr>
<td>gfdzdh</td>
<td>购方地址电话</td>
<td>string</td>
<td>100</td>
<td>否</td>
<td>个人可为空，但必须有此节点。</br>地址和电话两个字符串用</br>单个英文空格分隔</td>
</tr>
<tr>
<td>gfyhjzh</td>
<td>购方银行及账号</td>
<td>string</td>
<td>100</td>
<td>否</td>
<td>个人可为空，但必须有此节点。</br>银行和账号两个字符串用</br>单个英文空格分隔</td>
</tr>
<tr>
<td>gfsj </td>
<td>购方手机 </td>
<td>string </td>
<td>11 </td>
<td>否 </td>
<td>短信交付时使用，本节点可为空</td>
</tr>
<tr>
<td>gfyx</td>
<td>购方邮箱</td>
<td>string</td>
<td>30</td>
<td>否</td>
<td>邮箱交付时使用，本节点可为空</td>
</tr>
<tr>
<td>bz</td>
<td>备注</td>
<td>string</td>
<td>240</td>
<td>否</td>
<td>备注，可为空</td>
</tr>
<tr>
<td>kpy</td>
<td>开票员</td>
<td>string</td>
<td>8</td>
<td>是</td>
<td>中文 4 个字符，英文 8 个字符</td>
</tr>
<tr>
<td>xfmc</td>
<td>销方名称</td>
<td>string</td>
<td>100</td>
<td>否</td>
<td>销方名称</td>
</tr>
<tr>
<td>xfnsrsbh</td>
<td>销方纳税人识别号</td>
<td>string</td>
<td>20</td>
<td>是</td>
<td>销方纳税人识别号</td>
</tr>
<tr>
<td>xfdzdh</td>
<td>销方地址电话</td>
<td>string</td>
<td>100</td>
<td>否</td>
<td></td>
</tr>
<tr>
<td>xfyhjzh</td>
<td>销方银行及账号</td>
<td>string</td>
<td>100</td>
<td>否</td>
<td></td>
</tr>
<tr>
<td>hsbz</td>
<td>含税标志</td>
<td>int</td>
<td>1</td>
<td>否</td>
<td>含税标志 0：不含税 1：含税</td>
</tr>
<tr>
<td>fpxz</td>
<td>发票性质</td>
<td>string</td>
<td>1</td>
<td>否</td>
<td>0：正数票；1：负数票。为空时，</br>将根据订单金额自动补全</td>
</tr>
<tr>
<td>hzqrdbh</td>
<td>红字确认单编号</td>
<td>string</td>
<td>20</td>
<td>否</td>
<td>红字确认单编号</td>
</tr>
<tr>
<td>hzqrduuid</td>
<td>红字确认单uuid</td>
<td>string</td>
<td>32</td>
<td>否</td>
<td>红字确认单uuid</td>
</tr>
<tr>
<td>gmfzrr_bz</td>
<td>购买方自然人标志</td>
<td>string</td>
<td>32</td>
<td>否</td>
<td>购买方自然人标志</td>
</tr>
<tr>
<td>ghfqylx</td>
<td>购买方企业类型</td>
<td>string</td>
<td>32</td>
<td>否</td>
<td>01：企业 02：机关事业单位 03：个人 04：其它</td>
</tr>
<tr>
<td>yfpdm</td>
<td>原发票代码</td>
<td>string</td>
<td>12</td>
<td>否</td>
<td>发票性质为 1 时，必填，不满 12 位左补 0</td>
</tr>
<tr>
<td>yfphm</td>
<td>原发票号码</td>
<td>string</td>
<td>8</td>
<td>否</td>
<td>发票性质为 1 时，必填，不满 8 位左补 0</td>
</tr>
<tr>
<td>ykprq</td>
<td>原开票日期</td>
<td>string</td>
<td>16</td>
<td>否</td>
<td>格式：yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>yfpzl_dm</td>
<td>原发票种类代码</td>
<td>string</td>
<td>2</td>
<td>否</td>
<td>对应的发票为增值税管理系统</br>发票或全电纸票冲红时为必填</td>
</tr>
<tr>
<td>zzfp_bz</td>
<td>纸质发票标志</td>
<td>string</td>
<td>1</td>
<td>否</td>
<td>Y/N</td>
</tr>
<tr>
<td>xmxxs</td>
<td>发票明细信息</td>
<td></td>
<td></td>
<td></td>
<td>父节点，包含下面的字段,特殊票种只能有一条明细</td>
</tr>
<tr>
<td>spfldm</td>
<td>商品代码</td>
<td>string</td>
<td>25</td>
<td>否</td>
<td>商品的企业自编码</td>
</tr>
<tr>
<td>splwmc</td>
<td>商品名称</td>
<td>string</td>
<td>92</td>
<td>是</td>
<td>商品或劳务名称</td>
</tr>
<tr>
<td>count</td>
<td>数量</td>
<td>string</td>
<td>16.8</td>
<td>否</td>
<td>小数点后 8 位。为空时，</br>单价也必须为空</td>
</tr>
<tr>
<td>price</td>
<td>单价</td>
<td>string</td>
<td>16.8</td>
<td>否</td>
<td>小数点后 8 位。为空时，</br>数量也必须为空</td>
</tr>
<tr>
<td>je</td>
<td>金额</td>
<td>string</td>
<td>16.2</td>
<td>是</td>
<td>小数点后 2 位，以元为单位精确到分。 </br>等于=单价*数量，根据fptxx含税标志，</br>确定此金额是否为含税金额</td>
</tr>
<tr>
<td>sl</td>
<td>税率</td>
<td>string</td>
<td>4.2</td>
<td>是</td>
<td>正常税率以小数形式给出（如 0.16）。收购票税率为 0</td>
</tr>
<tr>
<td>se</td>
<td>税额</td>
<td>string</td>
<td>16.2</td>
<td>否</td>
<td>小数点后 2 位，以元为单位精确到分。</br>收购票税额为 0。为空时将自动计算</td>
</tr>
<tr>
<td>ssflbm</td>
<td>税收分类编码</td>
<td>string</td>
<td>19</td>
<td>否</td>
<td>税收分类编码，与商品劳务名称对应。</br>为空时将从商品库关联，商品库中没有时，必传。</td>
</tr>
<tr>
<td>bmbbh</td>
<td>编码版本号</td>
<td>string</td>
<td>10</td>
<td>否</td>
<td>编码版本号，非必填，</br>目前均取平台中设置的版本号</td>
</tr>
<tr>
<td>lslbs</td>
<td>零税率标识</td>
<td>string</td>
<td>1</td>
<td>否</td>
<td>空：非零税率 0：出口退税 1：免税 2：不征税 </br>3：普通零税率</td>
</tr>
<tr>
<td>yhzcbs</td>
<td>优惠政策标识</td>
<td>string</td>
<td>1</td>
<td>否</td>
<td>0：不使用 1：使用 默认0</td>
</tr>
<tr>
<td>yhzcsm</td>
<td>优惠政策说明</td>
<td>string</td>
<td>100</td>
<td>否</td>
<td>当 yhzcbs(优惠政策标识)为 1 时必填</td>
</tr>
<tr>
<td>fphxz</td>
<td>发票行性质</td>
<td>string</td>
<td>1</td>
<td>是</td>
<td>0：正常 1：折扣行 2：被折扣行</td>
</tr>
<tr>
<td>kce</td>
<td>扣除额</td>
<td>string</td>
<td>16.2</td>
<td>否</td>
<td>小数点后两位。</br>差额征收的发票目前只支持一行明细。</br>不含税差额 = 不含税金额 - 扣除额； </br>税额 = 不含税差额*税率 </br>注意：传0、空或字段不传，都表示非差额征税</td>
</tr>
<tr>
<td>tspzlx</td>
<td>特殊票种类型</td>
<td>string</td>
<td>2</td>
<td>是</td>
<td>见数电相关字典</td>
</tr>
<tr>
<td>cepzmxs </td>
<td>差额发票父字段 </td>
<td>JSONArray </td>
<td> </td>
<td>否 </td>
<td>开具差额发票时必填，以下为列表项字段</td>
</tr>
<tr>
<td>xh </td>
<td>差额凭证序号 </td>
<td>string </td>
<td>3 </td>
<td>否 </td>
<td>列表序号</td>
</tr>
<tr>
<td>pzlx </td>
<td>凭证类型 </td>
<td>string </td>
<td>1 </td>
<td>否 </td>
<td>01 全电发票<br/>02 增值税专用发票<br/>03 增值税普通发票<br/>04 营业税发票<br/>05 财政票据<br/>06 法院裁决书<br/>07 契税完税凭证<br/>08 其他发票类<br/>09 其他扣除凭证</td>
</tr>
<tr>
<td>fpdm </td>
<td>发票代码 </td>
<td>string </td>
<td>12 </td>
<td>否 </td>
<td>差额凭证类型选纸质发票的时候，录入</td>
</tr>
<tr>
<td>fphm </td>
<td>发票号码 </td>
<td>string </td>
<td>20 </td>
<td>否 </td>
<td> </td>
</tr>
<tr>
<td>zzfphm </td>
<td>纸质发票号码 </td>
<td>string </td>
<td>8 </td>
<td>否 </td>
<td> </td>
</tr>
<tr>
<td>pzhm </td>
<td>凭证号码 </td>
<td>string </td>
<td>32 </td>
<td>否 </td>
<td> </td>
</tr>
<tr>
<td>kjrq </td>
<td>开具日期 </td>
<td>Datetime </td>
<td>16 </td>
<td>是 </td>
<td>格式：yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>hjje </td>
<td>合计金额 </td>
<td>string </td>
<td>16 </td>
<td>否 </td>
<td> </td>
</tr>
<tr>
<td>kce </td>
<td>扣除额 </td>
<td>string </td>
<td>16 </td>
<td>否 </td>
<td> </td>
</tr>
<tr>
<td>bz </td>
<td>备注 </td>
<td>string </td>
<td>200 </td>
<td>否 </td>
<td> </td>
</tr>
<tr>
<td>lrfs </td>
<td>录入方式 </td>
<td>string </td>
<td>4 </td>
<td>否 </td>
<td>手工录入<br/>勾选录入<br/>模板录入</td>
</tr>
<tr>
<td>bckcje </td>
<td>本次扣除金额 </td>
<td>string </td>
<td>16 </td>
<td>否 </td>
<td> </td>
</tr>
<tr>
<td>pzhjje </td>
<td>凭证合计金额 </td>
<td>string </td>
<td>16 </td>
<td>否 </td>
<td> </td>
</tr>
<tr>
<td>fjys_xxs </td>
<td>附加要素列表父节点</td>
<td>JSONArray </td>
<td></td>
<td>否 </td>
<td>以下为列表字段</td>
</tr>
<tr>
<td>fjysmc </td>
<td>附加要素名称 </td>
<td>string </td>
<td>100 </td>
<td>否 </td>
<td> </td>
</tr>
<tr>
<td>fjysz </td>
<td>附加要素值 </td>
<td>string </td>
<td>100 </td>
<td>否 </td>
<td></td>
</tr>
<tr>
<td>sjlx </td>
<td>数据类型 </td>
<td>string </td>
<td>10 </td>
<td>否 </td>
<td>string：文本型<br/>number：数值型<br/>date：日期型</td>
</tr>
<tr>
<td>lkysfw_tdys </td>
<td>旅客运输</td>
<td>JSONArray </td>
<td> </td>
<td>是</td>
<td>旅客运输需传值，以下为列表字段</td>
</tr>
<tr>
<td>cxr</td>
<td>出行人</td>
<td>Varchar</td>
<td>20</td>
<td>否</td>
</tr>
<tr>
<td>chuxrq</td>
<td>出行日期</td>
<td>Varchar</td>
<td>10</td>
<td>否</td>
<td>yyyy-MM-dd</td>
</tr>
<tr>
<td>cxrzjlx</td>
<td>出行人证件类型</td>
<td>Varchar</td>
<td>40</td>
<td>否</td>
<td>见附录证件类型</td>
</tr>
<tr>
<td>sfzjhm</td>
<td>身份证件号码</td>
<td>Varchar</td>
<td>20</td>
<td>否</td>
</tr>
<tr>
<td>cfd</td>
<td>出发地</td>
<td>Varchar</td>
<td>80</td>
<td>否</td>
</tr>
<tr>
<td>cfd_sqxcode</td>
<td>出发地省区县区划编码以“,”分割</td>
<td>Varchar</td>
<td>80</td>
<td>否</td>
</tr>
<tr>
<td>ddd</td>
<td>到达地</td>
<td>Varchar</td>
<td>80</td>
<td>否</td>
</tr>
<tr>
<td>ddd_sqxcode</td>
<td>到达地省区县区划编码以“,”分割</td>
<td>Varchar</td>
<td>80</td>
<td>否</td>
</tr>
<tr>
<td>dengj</td>
<td>等级</td>
<td>Varchar</td>
<td>20</td>
<td>否</td>
</tr>
<tr>
<td>jtgjlx</td>
<td>交通工具类型</td>
<td>Varchar</td>
<td>80</td>
<td>否</td>
<td>1 飞机<br>2 火车<br>3 长途汽车<br>4 公共交通<br>5 出租车<br>6 汽车<br>7 船舶<br>8 其他</td>
</tr>
<tr>
<td>xh</td>
<td>序号</td>
<td>Varchar</td>
<td>10</td>
<td>是</td>
</tr>
</tbody>
</table>
<h5>返回数据</h5>
<table>
<thead>
<tr>
<th>参数 </th>
<th>参数名 </th>
<th>类型 </th>
<th>长度</th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>rtnCode</td>
<td>响应代码</td>
<td>string</td>
<td>4</td>
<td>请求结果反馈代码</td>
</tr>
<tr>
<td>rtnMsg</td>
<td>响应消息</td>
<td>string</td>
<td></td>
<td>请求结果反馈信息</td>
</tr>
<tr>
<td>fpzt</td>
<td>发票状态</td>
<td>string</td>
<td>2</td>
<td>开票状态： </br>2 :开票完成（ 最终状态），其他状态分别为: 20:开票中;4:发票已红冲</td>
</tr>
<tr>
<td>fpqqlsh</td>
<td>发票请求流水号</td>
<td>string</td>
<td>30</td>
<td>发票请求流水号</td>
</tr>
<tr>
<td>fphm</td>
<td>发票号码</td>
<td>string</td>
<td>20</td>
<td>发票号码</td>
</tr>
<tr>
<td>kprq</td>
<td>开票日期</td>
<td>string</td>
<td>18</td>
<td>开票日期</td>
</tr>
<tr>
<td>fplx</td>
<td>发票类型</td>
<td>string</td>
<td>2</td>
<td>81:全电发票(专用发票)，82:全电发票(普通发票)</td>
</tr>
<tr>
<td>hjbhsje</td>
<td>合计不含税金额</td>
<td>string</td>
<td>16.2</td>
<td>开票成功时返回</td>
</tr>
<tr>
<td>kphjse</td>
<td>合计税额</td>
<td>string</td>
<td>16.2</td>
<td>开票成功时返回</td>
</tr>
<tr>
<td>pdf_file</td>
<td>base64格式发票pdf</td>
<td>string</td>
<td></td>
<td>开票成功时返回</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code class="language-java">{
&quot;fptxx&quot;: {
&quot;djrq&quot;: &quot;2023-08-07 11:30:30&quot;,
&quot;xsdh&quot;: &quot;20230807112120311647&quot;,
&quot;fplx&quot;: &quot;82&quot;,
&quot;gfmc&quot;: &quot;****&quot;,
&quot;gfnsrsbh&quot;: &quot;**********&quot;,
&quot;gfdzdh&quot;: &quot;&quot;,
&quot;gfyhjzh&quot;: &quot;&quot;,
&quot;gfyx&quot;: &quot;&quot;,
&quot;bz&quot;: &quot;&quot;,
&quot;kpy&quot;: &quot;吴至权&quot;,
&quot;xfmc&quot;: &quot;佛山简捷陶瓷材料科技有限公司&quot;,
&quot;xfnsrsbh&quot;: &quot;91440604MA51034K4Q&quot;,
&quot;xfdzdh&quot;: &quot;&quot;,
&quot;xfyhjzh&quot;: &quot;&quot;,
&quot;hsbz&quot;: &quot;1&quot;,
&quot;fpxz&quot;: &quot;0&quot;,
&quot;hzqrdbh&quot;: &quot;&quot;,
&quot;hzqrduuid&quot;: &quot;&quot;,
&quot;gmfzrr_bz&quot;: &quot;Y&quot;,
&quot;ghfqylx&quot;: &quot;01&quot;,
&quot;yfpdm&quot;: &quot;&quot;,
&quot;yfphm&quot;: &quot;&quot;,
&quot;ykprq&quot;: &quot;&quot;,
&quot;yfpzl_dm&quot;: &quot;&quot;,
&quot;zzfp_bz&quot;: &quot;N&quot;
},
&quot;xmxxs&quot;: [{
&quot;spfldm&quot;: &quot;&quot;,
&quot;splwmc&quot;: &quot;商品名称&quot;,
&quot;count&quot;: &quot;4.00000000&quot;,
&quot;price&quot;: &quot;55.00000000&quot;,
&quot;je&quot;: &quot;220.00&quot;,
&quot;sl&quot;: &quot;0.09&quot;,
&quot;se&quot;: &quot;18.17&quot;,
&quot;ssflbm&quot;: &quot;3040502020199000000&quot;,
&quot;bmbbh&quot;: &quot;48.0&quot;,
&quot;lslbs&quot;: &quot;&quot;,
&quot;yhzcbs&quot;: &quot;0&quot;,
&quot;yhzcsm&quot;: &quot;&quot;,
&quot;fphxz&quot;: &quot;0&quot;,
&quot;kce&quot;: &quot;&quot;
}],
&quot;cepzmxs&quot;: [{}],
&quot;lkysfw_tdys&quot;:[
{
&quot;xh&quot;:&quot;1&quot;,
&quot;cxr&quot;:&quot;出行人&quot;,
&quot;chuxrq&quot;:&quot;出行日期&quot;,
&quot;cxrzjlx&quot;:&quot;出行人证件类型代码&quot;,
&quot;sfzjhm&quot;:&quot;身份证件号码&quot;,
&quot;cfd&quot;:&quot;出发地&quot;,
&quot;ddd&quot;:&quot;到达地&quot;,
&quot;dengj&quot;:&quot;等级&quot;,
&quot;jtgjlx&quot;:&quot;交通工具类型&quot;
}
]
&quot;fjys_xxs&quot;:[]
}</code></pre>
<h5>返回示例</h5>
<pre><code>成功：
{
&quot;rtnCode&quot;: &quot;0000&quot;,
&quot;rtnMsg&quot;: &quot;开票完成&quot;,
&quot;fpzt&quot;: 2,
&quot;fpqqlsh&quot;: &quot;20230807112220942001&quot;,
&quot;fphm&quot;: &quot;23442000000001863657&quot;,
&quot;kprq&quot;: &quot;2023-08-07 15:28:03.0&quot;,
&quot;fplx&quot;: &quot;82&quot;,
&quot;hjbhsje&quot;: &quot;201.83&quot;,
&quot;kphjse&quot;: &quot;18.17&quot;,
&quot;pdf_file&quot;:&quot;&quot;
}
失败：
{
&quot;rtnCode&quot;:&quot;9999&quot;,
&quot;rtnMsg&quot;:&quot;数电票对外接口 任务执行失败，报文缺少必要字段&quot;
}
</code></pre>
<h5>错误码说明</h5>
<table>
<thead>
<tr>
<th>错误码</th>
<th>错误描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>9999</td>
<td>参数错误，修改参数重新传入</td>
</tr>
<tr>
<td>9009</td>
<td>系统错误，联系厂商排查</td>
</tr>
<tr>
<td>4000</td>
<td>检查是否加密</td>
</tr>
</tbody>
</table>
<h5>计算公式说明</h5>
<p>不含税金额=含税金额/（1+税率）,并保留两位小数
不含税单价=含税单价/（1+税率）,最大8位小数位
税额=含税金额-不含税金额，并保留两位小数</p>