建筑服务
<h5>简要描述</h5>
<ul>
<li>此接口用于建筑服务发票开具，目前支持通用蓝/红字发票和差额票的开具</li>
</ul>
<h5>服务码</h5>
<ul>
<li>yspt_sdp_tspz_jzfw_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>单据日期，为空时自动取系统时间 格式：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>个人可为空，但必须有此节点。</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>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：负数票。为空时，将根据订单金额自动补全</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>对应的发票为增值税管理系统发票或全电纸票冲红时为必填</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 位。为空时，单价也必须为空</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.16）。收购票税率为 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>
<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>jzfw_tdys</td>
<td>建筑服务特定要素</td>
<td>JSONObject</td>
<td></td>
<td></td>
<td>父节点包含下面字段</td>
</tr>
<tr>
<td>tdzzsxmbh</td>
<td>土地增值税项目编号</td>
<td>string</td>
<td>否</td>
<td>土地增值税项目编号</td>
</tr>
<tr>
<td>jzfwfsd</td>
<td>建筑服务发生地 地址区县</td>
<td>string</td>
<td>50</td>
<td>否</td>
<td>地址区县 示例：山西省太原市万柏林区</td>
</tr>
<tr>
<td>full_address</td>
<td>详细地址</td>
<td>string</td>
<td>200</td>
<td>否</td>
<td>full_address 示例：羊市街43号</td>
</tr>
<tr>
<td>jzxmmc</td>
<td>建筑项目名称</td>
<td>string</td>
<td>50</td>
<td>否</td>
<td>建筑项目名称</td>
</tr>
<tr>
<td>kdsbz</td>
<td>跨地市标志</td>
<td>string</td>
<td>1</td>
<td>否</td>
<td>跨地(市)标志，Y是N否</td>
</tr>
<tr>
<td>kdsbzConfirm</td>
<td>跨地市确认标志</td>
<td>string</td>
<td>1</td>
<td>否</td>
<td>开票返回：“GT4000101221027建筑服务发生地与销售方注册地址未在同一县市，您当前选择的跨地市标志为“否”，请确认是否开具?”的时候，需要传此字段为1</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;jzfw_tdys&quot;: {
&quot;tdzzsxmbh&quot;: &quot;土地增值税项目编号&quot;,
&quot;jzfwfsd&quot;: &quot;建筑服务发生地 &quot;,
&quot;full_address&quot;: &quot;详细地址 &quot;,
&quot;jzxmmc&quot;: &quot;建筑项目名称 &quot;,
&quot;kdsbz&quot;: &quot;Y&quot;,
&quot;kdsbzConfirm&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>