凭证单新增接口
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>凭证单新增接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://(域名|IP):端口/nccloud/api/nantou/bill/voucher/insert</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST</li>
</ul>
<h5>请求字符集</h5>
<ul>
<li>UTF-8</li>
</ul>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">thirdSysCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>来源系统编码</td>
</tr>
<tr>
<td style="text-align: left;">thirdSysName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>来源系统名称</td>
</tr>
<tr>
<td style="text-align: left;">thirdSysBillTypeCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>来源单据类型编码</td>
</tr>
<tr>
<td style="text-align: left;">thirdSysBillTypeName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>来源单据类型名称</td>
</tr>
<tr>
<td style="text-align: left;">thirdSysBillCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>来源单据号</td>
</tr>
<tr>
<td style="text-align: left;">thirdSysURL</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>来源URL</td>
</tr>
<tr>
<td style="text-align: left;">orgCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>业务单元编码</td>
</tr>
<tr>
<td style="text-align: left;">orgName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>业务单元名称</td>
</tr>
<tr>
<td style="text-align: left;">tradeTypeCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>凭证单类别编码，VR01-Cxx-001=费用计提表； VR01-Cxx-002=薪酬类费用结转表； VR01-Cxx-003=费用预提表； VR01-Cxx-004=费用预提冲销表；</td>
</tr>
<tr>
<td style="text-align: left;">tradeTypeName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>凭证单类别名称</td>
</tr>
<tr>
<td style="text-align: left;">billDate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>单据日期, 数据格式: yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: left;">period</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>会计期间</td>
</tr>
<tr>
<td style="text-align: left;">voucherTypeCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>凭证类别编码，02=收；03=付；04=转；</td>
</tr>
<tr>
<td style="text-align: left;">voucherTypeName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>凭证类别名称</td>
</tr>
<tr>
<td style="text-align: left;">explanation</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>备注</td>
</tr>
<tr>
<td style="text-align: left;">thirdSysScanId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>第三方系统注册影像ID</td>
</tr>
<tr>
<td style="text-align: left;">billMaker</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>制单人</td>
</tr>
<tr>
<td style="text-align: left;">def6</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>共享作业组</td>
</tr>
<tr>
<td style="text-align: left;"><strong><em>detail</em></strong></td>
<td style="text-align: left;"><strong><em>array</em></strong></td>
<td style="text-align: left;"><strong><em>数据</em></strong></td>
</tr>
<tr>
<td style="text-align: left;">explanation</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>摘要</td>
</tr>
<tr>
<td style="text-align: left;">accasoaCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>会计科目编码</td>
</tr>
<tr>
<td style="text-align: left;">accasoaName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>会计科目名称</td>
</tr>
<tr>
<td style="text-align: left;">debitAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>借方金额，借贷金额不能同时有值，另一方需为空</td>
</tr>
<tr>
<td style="text-align: left;">creditAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>贷方金额，借贷金额不能同时有值，另一方需为空</td>
</tr>
<tr>
<td style="text-align: left;">etbankFlag</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>银行对账标识码</td>
</tr>
<tr>
<td style="text-align: left;">thirdSysBillCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>第三方来源单据号或ID（明细）</td>
</tr>
<tr>
<td style="text-align: left;"><strong><em>assItemList</em></strong></td>
<td style="text-align: left;"><strong><em>array</em></strong></td>
<td style="text-align: left;"><strong><em>辅助核算明细</em></strong></td>
</tr>
<tr>
<td style="text-align: left;">accassItemTypeCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>辅助核算类型编码</td>
</tr>
<tr>
<td style="text-align: left;">accassItemTypeName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>辅助核算类型名称</td>
</tr>
<tr>
<td style="text-align: left;">accassItemCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>辅助核算内容编码</td>
</tr>
<tr>
<td style="text-align: left;">accassItemName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>辅助核算内容名称</td>
</tr>
</tbody>
</table>
<h5>传参示例</h5>
<p><strong>说明:传参为JSON格式, 放在请求的BODY中</strong></p>
<pre><code> {
&quot;thirdSysBillTypeName&quot;: &quot;个人还款单&quot;,
&quot;period&quot;: &quot;11&quot;,
&quot;orgName&quot;: &quot;DL07&quot;,
&quot;billDate&quot;: &quot;2022-11-18 19:47:41&quot;,
&quot;explanation&quot;: &quot;工程结算&quot;,
&quot;thirdSysScanId&quot;: &quot;1847a0aa70e59101e9f3cdc460cad470&quot;,
&quot;tradeTypeName&quot;: &quot;薪酬类费用结转表&quot;,
&quot;voucherTypeCode&quot;: &quot;04&quot;,
&quot;orgCode&quot;: &quot;DL07&quot;,
&quot;voucherTypeName&quot;: &quot;转账凭证&quot;,
&quot;thirdSysURL&quot;: &quot;http://www.baidu.com&quot;,
&quot;thirdSysCode&quot;: &quot;lyxt02&quot;,
&quot;thirdSysBillTypeCode&quot;: &quot;1007&quot;,
&quot;detail&quot;: [
{
&quot;accasoaCode&quot;: &quot;5301010101&quot;,
&quot;accasoaName&quot;: &quot;人员工资&quot;,
&quot;debitAmount&quot;: &quot;1000&quot;,
&quot;assItemList&quot;: [
{
&quot;accassItemTypeCode&quot;: &quot;65&quot;,
&quot;accassItemTypeName&quot;: &quot;研发项目&quot;,
&quot;accassItemName&quot;: &quot;测试研发项目&quot;,
&quot;accassItemCode&quot;: &quot;ysxm001&quot;
}
],
&quot;explanation&quot;: &quot;工程结算&quot;,
&quot;creditAmount&quot;: &quot;&quot;,
&quot;thirdSysBillCode&quot;: &quot;1&quot;
},
{
&quot;accasoaCode&quot;: &quot;1130&quot;,
&quot;accasoaName&quot;: &quot;应收退货成本&quot;,
&quot;debitAmount&quot;: &quot;&quot;,
&quot;explanation&quot;: &quot;工程结算&quot;,
&quot;creditAmount&quot;: &quot;1000&quot;,
&quot;thirdSysBillCode&quot;: &quot;2&quot;
}
],
&quot;thirdSysBillCode&quot;: &quot;MD20221118194741&quot;,
&quot;tradeTypeCode&quot;: &quot;VR01-Cxx-002&quot;,
&quot;thirdSysName&quot;: &quot;一体化平台&quot;
}
</code></pre>
<h5>返回示例</h5>
<pre><code> {
&quot;success&quot;: true,
&quot;data&quot;: {
&quot;head&quot;: {
&quot;pk_group&quot;: {
&quot;code&quot;: &quot;nftzjt&quot;,
&quot;name&quot;: &quot;NT集团&quot;,
&quot;pk&quot;: &quot;0001B110000000001I45&quot;
},
&quot;year&quot;: &quot;2022&quot;,
&quot;pk_accountingbook&quot;: {
&quot;code&quot;: &quot;DL07-0001&quot;,
&quot;name&quot;: &quot;DL07-0001&quot;,
&quot;pk&quot;: &quot;1001B11000000000RC7L&quot;
},
&quot;explanation&quot;: &quot;工程结算&quot;,
&quot;pk_org&quot;: {
&quot;code&quot;: &quot;DL07&quot;,
&quot;name&quot;: &quot;广州南方投资集团有限公司电力建设分公司&quot;,
&quot;pk&quot;: &quot;0001B11000000000F7VI&quot;
},
&quot;pk_vouchertype&quot;: {
&quot;code&quot;: &quot;04&quot;,
&quot;name&quot;: &quot;转&quot;,
&quot;pk&quot;: &quot;1001B11000000000ORM8&quot;
},
&quot;pk_tradetypecode&quot;: &quot;VR01-Cxx-002&quot;,
&quot;totaldebit&quot;: &quot;1000.00000000&quot;,
&quot;pk_voucher&quot;: &quot;1001A21000000004WXO5&quot;,
&quot;totaldebitglobal&quot;: &quot;0.00000000&quot;,
&quot;period&quot;: &quot;11&quot;,
&quot;billstatus&quot;: 2,
&quot;totaldebitgroup&quot;: &quot;0.00000000&quot;,
&quot;def20&quot;: &quot;1847a0aa70e59101e9f3cdc460cad470&quot;,
&quot;pk_exratetype2&quot;: {
&quot;code&quot;: &quot;E001&quot;,
&quot;name&quot;: &quot;基准汇率方案-中间汇率&quot;,
&quot;pk&quot;: &quot;0001Z010000000000001&quot;
},
&quot;billdate&quot;: &quot;2022-11-18 19:47:41&quot;,
&quot;creationtime&quot;: &quot;2022-11-18 19:47:57&quot;,
&quot;pk_org_v&quot;: {
&quot;code&quot;: &quot;DL07&quot;,
&quot;name&quot;: &quot;广州南方投资集团有限公司电力建设分公司&quot;,
&quot;pk&quot;: &quot;0001B11000000000F7VH&quot;
},
&quot;billno&quot;: &quot;VRD12022111800000011&quot;,
&quot;saga_status&quot;: 0,
&quot;pk_billtypecode&quot;: &quot;VR01&quot;,
&quot;approvestatus&quot;: 3,
&quot;totalcreditgroup&quot;: &quot;0.00000000&quot;,
&quot;def3&quot;: &quot;MD20221118194741&quot;,
&quot;pk_prepared&quot;: {
&quot;code&quot;: &quot;ythpt&quot;,
&quot;name&quot;: &quot;一体化平台&quot;,
&quot;pk&quot;: &quot;1001B11000000000RRDW&quot;
},
&quot;def4&quot;: &quot;http://www.baidu.com&quot;,
&quot;creator&quot;: {
&quot;code&quot;: &quot;ythpt&quot;,
&quot;name&quot;: &quot;一体化平台&quot;,
&quot;pk&quot;: &quot;1001B11000000000RRDW&quot;
},
&quot;def1&quot;: {
&quot;code&quot;: &quot;lyxt02&quot;,
&quot;name&quot;: &quot;一体化平台&quot;,
&quot;pk&quot;: &quot;1001B11000000002FK68&quot;
},
&quot;def2&quot;: {
&quot;code&quot;: &quot;1007&quot;,
&quot;name&quot;: &quot;个人还款单&quot;,
&quot;pk&quot;: &quot;1001A11000000003PR8R&quot;
},
&quot;pk_tradetypeid&quot;: &quot;1001A11000000003PNG1&quot;,
&quot;totalcredit&quot;: &quot;1000.00000000&quot;,
&quot;totalcreditglobal&quot;: &quot;0.00000000&quot;,
&quot;pk_billtypeid&quot;: &quot;0001Z31000000003YKEV&quot;,
&quot;saga_frozen&quot;: 0,
&quot;ts&quot;: &quot;2022-11-18 19:48:02&quot;
},
&quot;detail&quot;: [
{
&quot;pk_group&quot;: {
&quot;code&quot;: &quot;nftzjt&quot;,
&quot;name&quot;: &quot;NT集团&quot;,
&quot;pk&quot;: &quot;0001B110000000001I45&quot;
},
&quot;localdebitamount&quot;: &quot;1000&quot;,
&quot;pk_unit&quot;: {
&quot;code&quot;: &quot;DL07&quot;,
&quot;name&quot;: &quot;广州南方投资集团有限公司电力建设分公司&quot;,
&quot;pk&quot;: &quot;0001B11000000000F7VI&quot;
},
&quot;explanation&quot;: &quot;工程结算&quot;,
&quot;pk_org&quot;: {
&quot;code&quot;: &quot;DL07&quot;,
&quot;name&quot;: &quot;广州南方投资集团有限公司电力建设分公司&quot;,
&quot;pk&quot;: &quot;0001B11000000000F7VI&quot;
},
&quot;pk_voucher&quot;: &quot;1001A21000000004WXO5&quot;,
&quot;debitamount&quot;: &quot;1000&quot;,
&quot;def20&quot;: &quot;【ysxm001/测试研发项目】&quot;,
&quot;creditamount&quot;: &quot;0.00000000&quot;,
&quot;pk_org_v&quot;: {
&quot;code&quot;: &quot;DL07&quot;,
&quot;name&quot;: &quot;广州南方投资集团有限公司电力建设分公司&quot;,
&quot;pk&quot;: &quot;0001B11000000000F7VH&quot;
},
&quot;localcreditamount&quot;: &quot;0.00000000&quot;,
&quot;pk_currtype&quot;: {
&quot;code&quot;: &quot;CNY&quot;,
&quot;name&quot;: &quot;人民币&quot;,
&quot;pk&quot;: &quot;1002Z0100000000001K1&quot;
},
&quot;assid&quot;: &quot;1001A11000000004WB0F&quot;,
&quot;pk_accasoa&quot;: {
&quot;code&quot;: &quot;5301010101&quot;,
&quot;name&quot;: &quot;人员工资&quot;,
&quot;pk&quot;: &quot;1001B11000000000QWPU&quot;
},
&quot;pk_unit_v&quot;: {
&quot;code&quot;: &quot;DL07&quot;,
&quot;name&quot;: &quot;广州南方投资集团有限公司电力建设分公司&quot;,
&quot;pk&quot;: &quot;0001B11000000000F7VH&quot;
},
&quot;excrate2&quot;: &quot;0.00000000&quot;,
&quot;excrate3&quot;: &quot;0.00000000&quot;,
&quot;excrate1&quot;: &quot;1.00000000&quot;,
&quot;detailindex&quot;: 1,
&quot;pk_detail&quot;: &quot;1001A21000000004WXO6&quot;,
&quot;ts&quot;: &quot;2022-11-18 19:47:57&quot;
},
{
&quot;pk_group&quot;: {
&quot;code&quot;: &quot;nftzjt&quot;,
&quot;name&quot;: &quot;NT集团&quot;,
&quot;pk&quot;: &quot;0001B110000000001I45&quot;
},
&quot;localdebitamount&quot;: &quot;0.00000000&quot;,
&quot;pk_unit&quot;: {
&quot;code&quot;: &quot;DL07&quot;,
&quot;name&quot;: &quot;广州南方投资集团有限公司电力建设分公司&quot;,
&quot;pk&quot;: &quot;0001B11000000000F7VI&quot;
},
&quot;explanation&quot;: &quot;工程结算&quot;,
&quot;pk_org&quot;: {
&quot;code&quot;: &quot;DL07&quot;,
&quot;name&quot;: &quot;广州南方投资集团有限公司电力建设分公司&quot;,
&quot;pk&quot;: &quot;0001B11000000000F7VI&quot;
},
&quot;pk_voucher&quot;: &quot;1001A21000000004WXO5&quot;,
&quot;debitamount&quot;: &quot;0.00000000&quot;,
&quot;creditamount&quot;: &quot;1000&quot;,
&quot;pk_org_v&quot;: {
&quot;code&quot;: &quot;DL07&quot;,
&quot;name&quot;: &quot;广州南方投资集团有限公司电力建设分公司&quot;,
&quot;pk&quot;: &quot;0001B11000000000F7VH&quot;
},
&quot;localcreditamount&quot;: &quot;1000&quot;,
&quot;pk_currtype&quot;: {
&quot;code&quot;: &quot;CNY&quot;,
&quot;name&quot;: &quot;人民币&quot;,
&quot;pk&quot;: &quot;1002Z0100000000001K1&quot;
},
&quot;pk_accasoa&quot;: {
&quot;code&quot;: &quot;1130&quot;,
&quot;name&quot;: &quot;应收退货成本&quot;,
&quot;pk&quot;: &quot;1001B11000000000R4I5&quot;
},
&quot;pk_unit_v&quot;: {
&quot;code&quot;: &quot;DL07&quot;,
&quot;name&quot;: &quot;广州南方投资集团有限公司电力建设分公司&quot;,
&quot;pk&quot;: &quot;0001B11000000000F7VH&quot;
},
&quot;excrate2&quot;: &quot;0.00000000&quot;,
&quot;excrate3&quot;: &quot;0.00000000&quot;,
&quot;excrate1&quot;: &quot;1.00000000&quot;,
&quot;detailindex&quot;: 2,
&quot;pk_detail&quot;: &quot;1001A21000000004WXO7&quot;,
&quot;ts&quot;: &quot;2022-11-18 19:47:57&quot;
}
]
},
&quot;code&quot;: &quot;1000000000&quot;,
&quot;message&quot;: null,
&quot;errorStack&quot;: null
}
</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">string</td>
<td>编号</td>
</tr>
<tr>
<td style="text-align: left;">success</td>
<td style="text-align: left;">string</td>
<td>接口调用状态, true:成功, false:失败</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">string</td>
<td>错误信息</td>
</tr>
<tr>
<td style="text-align: left;">errorStack</td>
<td style="text-align: left;">string</td>
<td>错误信息堆栈</td>
</tr>
<tr>
<td style="text-align: left;"><strong><em>data</em></strong></td>
<td style="text-align: left;"><strong><em>array</em></strong></td>
<td><strong><em>数据</em></strong></td>
</tr>
<tr>
<td style="text-align: left;">pk_voucher</td>
<td style="text-align: left;">string</td>
<td>单据ID</td>
</tr>
<tr>
<td style="text-align: left;">billUrl</td>
<td style="text-align: left;">string</td>
<td>单据访问URL</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>