财务发票
<p>[TOC]</p>
<h5>概述</h5>
<p>财务发票元数据接收接口</p>
<h5>请求方式</h5>
<ul>
<li><a href="https://www.showdoc.com.cn/2408347292986702/10707580304343109">参考通用接口</a></li>
</ul>
<h5>请求参数说明</h5>
<ul>
<li><a href="https://www.showdoc.com.cn/2408347292986702/10708991673231672">参数说明详细文档</a></li>
</ul>
<h5>请求参数示例（xml）</h5>
<pre><code> &lt;datas&gt;
&lt;data&gt;
&lt;arc appId=&quot;wsdarchivefinance&quot;&gt;
&lt;/arc&gt;
&lt;files&gt;
&lt;file&gt;
&lt;document ftpName=&quot;&quot; needDownLoad=&quot;true&quot;&gt;
&lt;param name=&quot;arc_document_name&quot; title=&quot;文档名称（带后缀）&quot;&gt;&lt;/param&gt;
&lt;param name=&quot;path&quot; title=&quot;文件路径&quot;&gt;&lt;/param&gt;
&lt;/document&gt;
&lt;metadata type=&quot;uf_arc_invoice&quot;&gt;
&lt;field name=&quot;invoice_resource&quot; title=&quot;发票来源&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;title&quot; title=&quot;名称&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;seller&quot; title=&quot;销售方&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;purchaser_bank&quot; title=&quot;购方开户银行&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;contax_usage_tag&quot; title=&quot;消费税用途标签&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;taxincludedprice&quot; title=&quot;价税合计&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;invoice_state&quot; title=&quot;发票状态&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;if_negative_sales&quot; title=&quot;是否销项负数&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;purchaser_address&quot; title=&quot;购方地址&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;seller_phone&quot; title=&quot;销方电话&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;invoicenumber_blue&quot; title=&quot;蓝字发票号码&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;seller_bank_account&quot; title=&quot;销方银行账号&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;invoicenumber_digital&quot; title=&quot;数电票号码&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;invoicenumber&quot; title=&quot;发票号码&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;seller_bank&quot; title=&quot;销方开户银行&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;purchaser&quot; title=&quot;购买方&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;purchaser_bank_account&quot; title=&quot;购方银行账号&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;pricewithouttax&quot; title=&quot;金额（不含税价）&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;tax&quot; title=&quot;税额&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;billingdate&quot; title=&quot;开票日期&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;invoicecode&quot; title=&quot;发票代码&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;invoicetype&quot; title=&quot;发票类型&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;remark&quot; title=&quot;备注&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;purchaser_number&quot; title=&quot;购买方纳税识别号&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;invoice_posting_status&quot; title=&quot;发票入账状态&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;fpid&quot; title=&quot;发票id&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;invoice_handle&quot; title=&quot;发票更新状态&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;valtax_usage_tag&quot; title=&quot;增值税用途标签&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;contax_period&quot; title=&quot;消费税勾选属期&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;purchaser_operator&quot; title=&quot;购方经办人&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;ciphertext&quot; title=&quot;密码区&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;invoicesort&quot; title=&quot;票种&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;drawer&quot; title=&quot;开票人&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;seller_address&quot; title=&quot;销方地址&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;invoiceserviceyype&quot; title=&quot;货物或应税服务类型&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;risk_level&quot; title=&quot;发票风险等级&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;valtax_period&quot; title=&quot;增值税勾选属期&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;purchaser_phone&quot; title=&quot;购方电话&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;seller_number&quot; title=&quot;销售方纳税识别号&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;invoice_posting_date&quot; title=&quot;发票入账时间&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;owner_user&quot; title=&quot;所属人员&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;owner_dept&quot; title=&quot;所属部门&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;owner_company&quot; title=&quot;所属分部&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;data_type&quot; title=&quot;数据类型&quot;&gt;&lt;/field&gt;
&lt;field name=&quot;unique_code&quot; title=&quot;唯一编码&quot;&gt;&lt;/field&gt;
&lt;/metadata&gt;
&lt;/file&gt;
&lt;/files&gt;
&lt;/data&gt;
&lt;/datas&gt;</code></pre>
<h5>请求参数示例（json）</h5>
<pre><code>{
&quot;datas&quot;:[
{
&quot;arc&quot;:{
&quot;appId&quot;:&quot;wsdarchivefinance&quot;
},
&quot;files&quot;:[
{
&quot;metadata&quot;:{
&quot;field&quot;:[
{
&quot;name&quot;:&quot;invoice_resource&quot;,
&quot;title&quot;:&quot;发票来源&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;title&quot;,
&quot;title&quot;:&quot;名称&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;seller&quot;,
&quot;title&quot;:&quot;销售方&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;purchaser_bank&quot;,
&quot;title&quot;:&quot;购方开户银行&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;contax_usage_tag&quot;,
&quot;title&quot;:&quot;消费税用途标签&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;taxincludedprice&quot;,
&quot;title&quot;:&quot;价税合计&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;invoice_state&quot;,
&quot;title&quot;:&quot;发票状态&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;if_negative_sales&quot;,
&quot;title&quot;:&quot;是否销项负数&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;purchaser_address&quot;,
&quot;title&quot;:&quot;购方地址&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;seller_phone&quot;,
&quot;title&quot;:&quot;销方电话&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;invoicenumber_blue&quot;,
&quot;title&quot;:&quot;蓝字发票号码&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;seller_bank_account&quot;,
&quot;title&quot;:&quot;销方银行账号&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;invoicenumber_digital&quot;,
&quot;title&quot;:&quot;数电票号码&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;invoicenumber&quot;,
&quot;title&quot;:&quot;发票号码&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;seller_bank&quot;,
&quot;title&quot;:&quot;销方开户银行&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;purchaser&quot;,
&quot;title&quot;:&quot;购买方&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;purchaser_bank_account&quot;,
&quot;title&quot;:&quot;购方银行账号&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;pricewithouttax&quot;,
&quot;title&quot;:&quot;金额（不含税价）&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;tax&quot;,
&quot;title&quot;:&quot;税额&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;billingdate&quot;,
&quot;title&quot;:&quot;开票日期&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;invoicecode&quot;,
&quot;title&quot;:&quot;发票代码&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;invoicetype&quot;,
&quot;title&quot;:&quot;发票类型&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;remark&quot;,
&quot;title&quot;:&quot;备注&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;purchaser_number&quot;,
&quot;title&quot;:&quot;购买方纳税识别号&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;invoice_posting_status&quot;,
&quot;title&quot;:&quot;发票入账状态&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;valtax_usage_tag&quot;,
&quot;title&quot;:&quot;增值税用途标签&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;contax_period&quot;,
&quot;title&quot;:&quot;消费税勾选属期&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;purchaser_operator&quot;,
&quot;title&quot;:&quot;购方经办人&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;ciphertext&quot;,
&quot;title&quot;:&quot;密码区&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;invoicesort&quot;,
&quot;title&quot;:&quot;票种&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;drawer&quot;,
&quot;title&quot;:&quot;开票人&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;seller_address&quot;,
&quot;title&quot;:&quot;销方地址&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;invoiceserviceyype&quot;,
&quot;title&quot;:&quot;货物或应税服务类型&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;risk_level&quot;,
&quot;title&quot;:&quot;发票风险等级&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;valtax_period&quot;,
&quot;title&quot;:&quot;增值税勾选属期&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;purchaser_phone&quot;,
&quot;title&quot;:&quot;购方电话&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;seller_number&quot;,
&quot;title&quot;:&quot;销售方纳税识别号&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;invoice_posting_date&quot;,
&quot;title&quot;:&quot;发票入账时间&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;owner_user&quot;,
&quot;title&quot;:&quot;所属人员&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;owner_dept&quot;,
&quot;title&quot;:&quot;所属部门&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;owner_company&quot;,
&quot;title&quot;:&quot;所属分部&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;data_type&quot;,
&quot;title&quot;:&quot;数据类型&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;unique_code&quot;,
&quot;title&quot;:&quot;唯一编码&quot;,
&quot;content&quot;:&quot;&quot;
}
],
&quot;type&quot;:&quot;uf_arc_invoice&quot;
},
&quot;document&quot;:[
{
&quot;ftpName&quot;:&quot;&quot;,
&quot;needDownLoad&quot;:&quot;true&quot;,
&quot;param&quot;:[
{
&quot;name&quot;:&quot;arc_document_name&quot;,
&quot;title&quot;:&quot;文档名称（带后缀）&quot;,
&quot;content&quot;:&quot;&quot;
},
{
&quot;name&quot;:&quot;path&quot;,
&quot;title&quot;:&quot;文件路径&quot;,
&quot;content&quot;:&quot;&quot;
}
]
}
]
}
]
}
]
}</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;">docFormBizId</td>
<td style="text-align: left;">String</td>
<td>预归档库电子原文ID</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">boolean</td>
<td>接口执行状态</td>
</tr>
<tr>
<td style="text-align: left;">messsage</td>
<td style="text-align: left;">String</td>
<td>提示信息</td>
</tr>
<tr>
<td style="text-align: left;">uniqueV</td>
<td style="text-align: left;">String</td>
<td>业务请求传入的唯一值</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>
{
&quot;result&quot;: [
{
&quot;docFormBizId&quot;: &quot;54581000524,54582000524&quot;,
&quot;formBizId&quot;: &quot;-1&quot;,
&quot;messsage&quot;: &quot;xml接收成功！&quot;,
&quot;status&quot;: true,
&quot;uniqueV&quot;: &quot;2dcbd2d3-d25e-4e91-8558-f0e0738adddb&quot;
},
{
&quot;docFormBizId&quot;: &quot;54581000524,54582000524&quot;,
&quot;formBizId&quot;: &quot;-1&quot;,
&quot;messsage&quot;: &quot;更新成功！&quot;,
&quot;status&quot;: true,
&quot;uniqueV&quot;: &quot;2dcbd2d3-d25e-4e91-8558-f0e0738adddb&quot;
}
],
&quot;runStatus&quot;: true
}
</code></pre>