单据新增
<h5>简要描述</h5>
<ul>
<li>实现单据新增，返回新增结果</li>
</ul>
<h5>服务码</h5>
<ul>
<li>yspt_sdp_djxz</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>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:电子发票(普通发票) 85：纸质发票（增值税专用发票） 86：纸质发票（普通发票）</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>个人可为空，但必须有此节点。 地址与电话之间用空格分开 如：太原市小店区晋阳街 0351-2967331</td>
</tr>
<tr>
<td>gfyhjzh</td>
<td>购方银行及账号</td>
<td>string</td>
<td>100</td>
<td>否</td>
<td>个人可为空，但必须有此节点。 银行与账号之间必须用空格分开 如：中国工商银行太原坞城南路支行 000000000000000000</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>备注，可为空。</br>冲红专票时，备注格式为“开具红字增值税专用发票信息表编号ZZZZZZZZZZZZZZZZ”文案，其中“Z”为16位红字发票信息表编号，可通过开票软件申请，否则无法红冲。</br>冲红普票时，备注格式为“对应正数发票代码:XXXXXXXXX 号码:YYYYYYYY”文案，其中“X”为发票代码，“Y”为发票号码。</br>否则接口会自动添加该文案</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>cjr</td>
<td>创建人</td>
<td>string</td>
<td>20</td>
<td>否</td>
<td>人员代码。如果人名重复，通过kpy不能唯一确定创建人时，需要传此字段</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>销售方地址电话 地址与电话之间用空格分开 如：太原市小店区晋阳街 0351-2967331</td>
</tr>
<tr>
<td>xfyhjzh</td>
<td>销方银行及账号</td>
<td>string</td>
<td>100</td>
<td>否</td>
<td>销售方银行账号 银行与账号之间必须用空格分开 如：中国工商银行太原坞城南路支行 000000000000000000</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>chyy</td>
<td>冲红原因</td>
<td>string</td>
<td>200</td>
<td>否</td>
<td>发票红冲时必填</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>
</tr>
<tr>
<td>hzqrduuid</td>
<td>红字确认单uuid</td>
<td>string</td>
<td>32</td>
<td>否</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>gmfzrr_bz</td>
<td>购买方自然人标志</td>
<td>string</td>
<td>1</td>
<td>否</td>
<td>Y/N</td>
</tr>
<tr>
<td>sfzsgmfyhzh</td>
<td>是否显示购方银行账号</td>
<td>string</td>
<td>1</td>
<td>否</td>
<td>Y/N</td>
</tr>
<tr>
<td>sfzsxsfyhzh</td>
<td>是否显示销方银行账号</td>
<td>string</td>
<td>1</td>
<td>否</td>
<td>Y/N</td>
</tr>
<tr>
<td>sfzsgmfdzdh</td>
<td>是否显示购方地址电话</td>
<td>string</td>
<td>1</td>
<td>否</td>
<td>Y/N</td>
</tr>
<tr>
<td>sfzsxsfdzdh</td>
<td>是否显示销方地址电弧</td>
<td>string</td>
<td>1</td>
<td>否</td>
<td>Y/N</td>
</tr>
<tr>
<td>ghfqylx</td>
<td>购方企业类型</td>
<td>string</td>
<td>2</td>
<td>是</td>
<td>01：企业 02：机关事业单位 03：个人 04：其它</td>
</tr>
<tr>
<td>sfsgp</td>
<td>是否收购票</td>
<td>int</td>
<td>1</td>
<td>否</td>
<td>默认空：非收购票 1：收购票 0：非收购票</td>
</tr>
<tr>
<td>sfcpy</td>
<td>是否成品油</td>
<td>int</td>
<td>1</td>
<td>否</td>
<td>默认空：非成品油 1：成品油 0：非成品油</td>
</tr>
<tr>
<td>hzxxbbh</td>
<td>红字信息表编号</td>
<td>string</td>
<td>16</td>
<td>否</td>
<td>发票类型为 0 ，且发票性质为 1 时，必填</td>
</tr>
<tr>
<td>dknsrsbh</td>
<td>代开纳税人识别号</td>
<td>string</td>
<td>30</td>
<td>否</td>
<td>代开纳税人识别号</td>
</tr>
<tr>
<td>dkqymc</td>
<td>代开企业名称</td>
<td>string</td>
<td>200</td>
<td>否</td>
<td>代开企业名称</td>
</tr>
<tr>
<td>mtpzxx</td>
<td>煤炭品质信息</td>
<td>string</td>
<td>200</td>
<td>否</td>
<td>煤炭商品不含税合计金额大于等于1000万时需要传值。传值规范：煤炭发热量支持0-99999 整数；干基全硫支持0-100 数字；干燥无灰基挥发分支持0-100数字。示例：每千克煤炭发热量:100 千卡、干基全硫:5.00%、干燥无灰基挥发分:5.20%。</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>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.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>空：非零税率 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>注意：传null、空或字段不传，都表示非差额征税</td>
</tr>
<tr>
<td>sphh</td>
<td>商品行号</td>
<td>string</td>
<td>100</td>
<td>否</td>
<td>商品行号，同一订单内唯一，用于拆分、合并后回写</td>
</tr>
<tr>
<td>lzmxxh</td>
<td>蓝字明细序号</td>
<td>int</td>
<td>4</td>
<td>否</td>
<td>蓝字明细序号</td>
</tr>
<tr>
<td>mtzldm</td>
<td>煤炭种类代码</td>
<td>string</td>
<td>10</td>
<td>否</td>
<td>0100:政府保供煤;</br>0201:长协煤-协议期不足半年;</br>0202:长协煤-协议期在半年到一年之间;</br>0203:长协煤-协议期在一年到两年之间;</br>0204:长协煤-协议期在两年以上;</br>0300:市场煤</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>
</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;0&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;cjr&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;chyy&quot;: &quot;&quot;,
&quot;fpxz&quot;: &quot;0&quot;,
&quot;yfpdm&quot;: &quot;&quot;,
&quot;yfphm&quot;: &quot;&quot;,
&quot;sfsgp&quot;: &quot;&quot;,
&quot;sfcpy&quot;: &quot;&quot;,
&quot;hzxxbbh&quot;: &quot;&quot;
},
&quot;xmxxs&quot;: [{
&quot;spfldm&quot;: &quot;&quot;,
&quot;splwmc&quot;: &quot;商品名称&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;sphh&quot;: &quot;&quot;
}, {
&quot;spfldm&quot;: &quot;&quot;,
&quot;splwmc&quot;: &quot;商品名称&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;sphh&quot;: &quot;&quot;
}]
}</code></pre>
<h5>返回示例</h5>
<pre><code>成功：
{
&quot;rtnCode&quot;:&quot;success&quot;,
&quot;rtnMsg&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>