数电扫码开票
<h5>简要描述</h5>
<ul>
<li>实现单据新增，返回取票码、开票Url</li>
<li>发票类型目前只支持 81:全电发票(专用发票)，82:全电发票(普通发票)</li>
</ul>
<h5>服务码</h5>
<ul>
<li>yspt_sdp_smkp</li>
</ul>
<h5>数据格式</h5>
<ul>
<li><code>JSON</code></li>
</ul>
<h5>发票类型说明</h5>
<table>
<thead>
<tr>
<th>发票类型编码</th>
<th>发票种类说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>81</td>
<td>全电发票(专用发票)</td>
</tr>
<tr>
<td>82</td>
<td>全电发票(普通发票)</td>
</tr>
</tbody>
</table>
<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>单据日期，为空时自动取系统时间 格式：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>fjh</td>
<td>分机号</td>
<td>string</td>
<td>10</td>
<td>否</td>
<td>数电不传，传统纸票才传(空：发票开具业务时，随机路由该纳税人设备进行开具；</br>其他查询业务时，查询该纳税人下所有设备终端相关信息。</br>不为空：指定设备（终端）开具（或查询）。</br>金税盘有终端情况下，传递“分机号-终端号”信息。如分机1的2号终端，则赋值“1-2”；</br>无终端情况下，传递“分机号”信息。如分机1，则赋值“1”。</br>分机号0是主机,非0是分机，范围0-65535)</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></td>
</tr>
<tr>
<td>gfyhjzh</td>
<td>购方银行及账号</td>
<td>string</td>
<td>100</td>
<td>否</td>
<td></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>sky</td>
<td>收款人</td>
<td>string</td>
<td>8</td>
<td>否</td>
<td>数电不用，中文 4 个字符，英文 8 个字符</td>
</tr>
<tr>
<td>fhr</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>wctz</td>
<td>误差调整</td>
<td>int</td>
<td>1</td>
<td>否</td>
<td>误差调整 0：不调整 1：调整单价 2：调整数量</td>
</tr>
<tr>
<td>fpxz</td>
<td>发票性质</td>
<td>string</td>
<td>1</td>
<td>是</td>
<td>0：正数票</td>
</tr>
<tr>
<td>sfcpy</td>
<td>是否成品油</td>
<td>int</td>
<td>1</td>
<td>否</td>
<td>数电目前不支持该特殊票种 默认空：非成品油 1：成品油 0：非成品油</td>
</tr>
<tr>
<td>sfkcp</td>
<td>是否矿产品</td>
<td>int</td>
<td>1</td>
<td>否</td>
<td>数电目前不支持该特殊票种 默认空：非矿产品 1：矿产品 0：非矿产品</td>
</tr>
<tr>
<td>xmxxs</td>
<td>发票明细信息</td>
<td></td>
<td></td>
<td></td>
<td>父节点，包含下面的字段【注：最多100条】</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>ggxh</td>
<td>规格型号</td>
<td>string</td>
<td>40</td>
<td>否</td>
<td>规格型号</td>
</tr>
<tr>
<td>dw</td>
<td>单位</td>
<td>string</td>
<td>22</td>
<td>否</td>
<td>计量单位</td>
</tr>
<tr>
<td>count</td>
<td>数量</td>
<td>string</td>
<td>16.8</td>
<td>否</td>
<td>小数点后 8 位。为空时，单价也必须为空</td>
</tr>
<tr>
<td>price</td>
<td>单价</td>
<td>string</td>
<td>16.8</td>
<td>否</td>
<td>小数点后 8 位。为空时，数量也必须为空</td>
</tr>
<tr>
<td>je</td>
<td>金额</td>
<td>string</td>
<td>16.2</td>
<td>是</td>
<td>小数点后 2 位，以元为单位精确到分。 </br>等于=单价*数量，根据fptxx含税标志，确定此金额是否为含税金额</td>
</tr>
<tr>
<td>sl</td>
<td>税率</td>
<td>string</td>
<td>4.2</td>
<td>是</td>
<td>正常税率以小数形式给出（如 0.03）。收购票税率为 0</td>
</tr>
<tr>
<td>se</td>
<td>税额</td>
<td>string</td>
<td>16.2</td>
<td>否</td>
<td>小数点后 2 位，以元为单位精确到分。收购票税额为 0。为空时将自动计算</td>
</tr>
<tr>
<td>ssflbm</td>
<td>税收分类编码</td>
<td>string</td>
<td>19</td>
<td>否</td>
<td>税收分类编码，与商品劳务名称对应</td>
</tr>
<tr>
<td>bmbbh</td>
<td>编码版本号</td>
<td>string</td>
<td>10</td>
<td>否</td>
<td>编码版本号，非必填，目前均取平台中设置的版本号</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>
</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>qpm</td>
<td>取票码</td>
<td>string</td>
<td></td>
<td>返回的取票码</td>
</tr>
<tr>
<td>kpurl</td>
<td>发票url</td>
<td>string</td>
<td></td>
<td>返回的扫码开票url</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code class="language-java">{
&quot;fptxx&quot;: {
&quot;djrq&quot;: &quot;2021-04-27 12:30:30&quot;,
&quot;xsdh&quot;: &quot;2021021000000001&quot;,
&quot;fjh&quot;: &quot;0-1&quot;,
&quot;fplx&quot;: &quot;51&quot;,
&quot;gfmc&quot;: &quot;太原******有限公司&quot;,
&quot;gfnsrsbh&quot;: &quot;313713122330236248&quot;,
&quot;gfdzdh&quot;: &quot;&quot;,
&quot;gfyhjzh&quot;: &quot;&quot;,
&quot;gfsj&quot;: &quot;15888668866&quot;,
&quot;gfyx&quot;: &quot;&quot;,
&quot;bz&quot;: &quot;&quot;,
&quot;kpy&quot;: &quot;张三&quot;,
&quot;sky&quot;: &quot;&quot;,
&quot;fhr&quot;: &quot;&quot;,
&quot;xfmc&quot;: &quot;&quot;,
&quot;xfnsrsbh&quot;: &quot;413713122330236248&quot;,
&quot;xfdzdh&quot;: &quot;&quot;,
&quot;xfyhjzh&quot;: &quot;&quot;,
&quot;hsbz&quot;:&quot;1&quot;,
&quot;wctz&quot;:&quot;0&quot;,
&quot;fpxz&quot;:&quot;0&quot;,
&quot;sfcpy&quot;:&quot;&quot;,
&quot;sfkcp&quot;:&quot;&quot;,
&quot;sftxf&quot;:&quot;&quot;
},
&quot;xmxxs&quot;: [{
&quot;spfldm&quot;: &quot;&quot;,
&quot;splwmc&quot;: &quot;企业贷款1&quot;,
&quot;ggxh&quot;: &quot;&quot;,
&quot;dw&quot;: &quot;笔&quot;,
&quot;count&quot;: &quot;1&quot;,
&quot;price&quot;: &quot;468666.44&quot;,
&quot;je&quot;: &quot;468666.44&quot;,
&quot;sl&quot;: &quot;0.06&quot;,
&quot;se&quot;: &quot;26528.29&quot;,
&quot;ssflbm&quot;: &quot;3060110010000000000&quot;,
&quot;bmbbh&quot;: &quot;&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;spfldm&quot;: &quot;&quot;,
&quot;splwmc&quot;: &quot;企业贷款1&quot;,
&quot;ggxh&quot;: &quot;&quot;,
&quot;dw&quot;: &quot;笔&quot;,
&quot;count&quot;: &quot;1&quot;,
&quot;price&quot;: &quot;468666.44&quot;,
&quot;je&quot;: &quot;468666.44&quot;,
&quot;sl&quot;: &quot;0.06&quot;,
&quot;se&quot;: &quot;26528.29&quot;,
&quot;ssflbm&quot;: &quot;3060110010000000000&quot;,
&quot;bmbbh&quot;: &quot;&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;
}]
}</code></pre>
<h5>返回示例</h5>
<pre><code>成功：
{
&quot;rtnCode&quot;:&quot;0000&quot;,&quot;rtnMsg&quot;:&quot;操作成功&quot;,
&quot;qpm&quot;:&quot;fbf23babe6610b9f64ae19c699d12acd&quot;,
&quot;kpurl&quot;:&quot;http://***/***/fbf23babe6610b9f64ae19c699d12acd&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>