商城→ERP 接收客户信息
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>商城→ERP 接收客户信息</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://connector.glgw.com/prod-api/modules-receive/customer/receive_customer</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </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;">dbCustomerDto</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Object</td>
<td>客户基本信息</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户名称</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.userId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>用户ID</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.foundAt</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string (datetime)</td>
<td>创建时间</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.customerCategory</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户类别</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.customerCategoryDictionaryValueId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>客户类别字典值ID</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户类型</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.typeDictionaryValueId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>客户类型字典值ID</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.trade</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>行业</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.tradeDictionaryValueId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>行业字典值ID</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.star</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户星级</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.starDictionaryValueId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>客户星级字典值ID</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.origin</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户来源</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.originDictionaryValueId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>客户来源字典值ID</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.status</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户状态</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.statusDictionaryValueId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>客户状态字典值ID</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.province</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>省份</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.city</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>城市</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.area</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>地区</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.address</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>详细地址</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.country</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>国别</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.saleType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>销售类型</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.region</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>客户所属地区(大区)</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.personnel</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>人员规模</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.personnelDictionaryValueId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>人员规模字典值ID</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerDto.remark</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>备注信息</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Object</td>
<td>客户首联系人信息</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.userId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>用户ID</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>联系人姓名</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.respect</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>称呼</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.respectDictionaryValueId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>称呼字典值ID</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.role</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>角色</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.roleDictionaryValueId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>角色字典值ID</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>类型</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.typeDictionaryValueId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>类型字典值ID</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.country</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>国别</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.birthday</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string (date)</td>
<td>生日</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.job</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>职位</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.phone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>手机号</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.tel</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>座机号</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.fax</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>传真</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.email</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>邮箱</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.wx</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>微信</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.qq</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>QQ</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.province</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>省份</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.city</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>城市</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.area</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>地区</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.address</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>详细地址</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerContactsDto.remark</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>备注</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerInvoiceDto</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Object</td>
<td>客户发票信息</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerInvoiceDto.invoiceHeader</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>发票抬头</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerInvoiceDto.creditCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>税号</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerInvoiceDto.bank</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>开户银行</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerInvoiceDto.bankAccount</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>银行账号</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerInvoiceDto.contactTel</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>联系电话</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerInvoiceDto.contactAddress</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>联系地址</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerInvoiceDto.type</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>发票类型</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerInvoiceDto.taxRate</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">float</td>
<td>税率</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerInvoiceDto.currencyNum</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>币种</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerAttachDto</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Object</td>
<td>客户附件信息 无附件信息 直接传入 null 即可</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerAttachDto.type</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">byte</td>
<td>附件类型：1-客户附件，2-客户跟进附件，3-客户资料</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerAttachDto.url</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>文件URL</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerAttachDto.originName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>原始文件名</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerAttachDto.extension</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>文件扩展名</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerAttachDto.size</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">double</td>
<td>文件大小（单位：字节）</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerAttachDto.userId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>上传用户ID</td>
</tr>
<tr>
<td style="text-align: left;">dbCustomerAttachDto.remark</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>备注信息</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code> {
&quot;dbCustomerDto&quot;: {
&quot;name&quot;: &quot;测试&quot;,
&quot;userId&quot;: 0,
&quot;mnemonic&quot;: &quot;&quot;,
&quot;foundAt&quot;: &quot;2025-01-17 11:19:11&quot;,
&quot;customerCategory&quot;: &quot;终端客户&quot;,
&quot;customerCategoryDictionaryValueId&quot;: 239,
&quot;type&quot;: &quot;个人客户&quot;,
&quot;typeDictionaryValueId&quot;: 22,
&quot;trade&quot;: &quot;家用电器&quot;,
&quot;tradeDictionaryValueId&quot;: 11,
&quot;star&quot;: &quot;一星客户&quot;,
&quot;starDictionaryValueId&quot;: 57,
&quot;origin&quot;: &quot;阿里&quot;,
&quot;originDictionaryValueId&quot;: 29,
&quot;status&quot;: &quot;了解商品&quot;,
&quot;statusDictionaryValueId&quot;: 23,
&quot;province&quot;: &quot;山西省&quot;,
&quot;city&quot;: &quot;忻州市&quot;,
&quot;area&quot;: &quot;代县&quot;,
&quot;address&quot;: &quot;&quot;,
&quot;country&quot;: &quot;&quot;,
&quot;saleType&quot;: 0,
&quot;region&quot;: &quot;&quot;,
&quot;personnel&quot;: &quot;&quot;,
&quot;personnelDictionaryValueId&quot;: 0,
&quot;remark&quot;: &quot;&quot;,
&quot;firstChar&quot;: &quot;&quot;,
&quot;contactId&quot;: 0,
&quot;contactName&quot;: &quot;&quot;,
&quot;contactPhone&quot;: &quot;&quot;
},
&quot;dbCustomerAttachDto&quot;: {
&quot;type&quot;: 0,
&quot;customerId&quot;: 0,
&quot;url&quot;: &quot;&quot;,
&quot;originName&quot;: &quot;&quot;,
&quot;extension&quot;: &quot;&quot;,
&quot;size&quot;: 0.0,
&quot;userId&quot;: 0,
&quot;remark&quot;: &quot;&quot;
},
&quot;dbCustomerContactsDto&quot;: {
&quot;userId&quot;: 0,
&quot;name&quot;: &quot;测试&quot;,
&quot;respect&quot;: &quot;化神境&quot;,
&quot;respectDictionaryValueId&quot;: 82,
&quot;role&quot;: &quot;联系人&quot;,
&quot;roleDictionaryValueId&quot;: 73,
&quot;type&quot;: &quot;财务&quot;,
&quot;typeDictionaryValueId&quot;: 256,
&quot;country&quot;: &quot;&quot;,
&quot;birthday&quot;: &quot;&quot;,
&quot;job&quot;: &quot;打工人&quot;,
&quot;phone&quot;: &quot;&quot;,
&quot;tel&quot;: &quot;&quot;,
&quot;fax&quot;: &quot;&quot;,
&quot;email&quot;: &quot;&quot;,
&quot;wx&quot;: &quot;&quot;,
&quot;qq&quot;: &quot;&quot;,
&quot;province&quot;: &quot;&quot;,
&quot;city&quot;: &quot;&quot;,
&quot;area&quot;: &quot;&quot;,
&quot;address&quot;: &quot;&quot;,
&quot;remark&quot;: &quot;&quot;
},
&quot;dbCustomerInvoiceDto&quot;: {
&quot;invoiceHeader&quot;: &quot;&quot;,
&quot;creditCode&quot;: &quot;&quot;,
&quot;bank&quot;: &quot;&quot;,
&quot;bankAccount&quot;: &quot;&quot;,
&quot;contactTel&quot;: &quot;&quot;,
&quot;contactAddress&quot;: &quot;&quot;,
&quot;type&quot;: 0,
&quot;taxRate&quot;: 0.0,
&quot;currencyNum&quot;: &quot;&quot;
}
}</code></pre>
<h5>返回示例</h5>
<pre><code> {
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;操作成功&quot;,
&quot;data&quot;: null
}</code></pre>
<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;">code</td>
<td style="text-align: left;">响应码</td>
<td style="text-align: left;">Integer</td>
<td>返回响应码 例：200 成功</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">响应信息</td>
<td style="text-align: left;">String</td>
<td>返回响应码 例：“操作成功”</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">响应数据</td>
<td style="text-align: left;">Object</td>
<td>返回相应数据</td>
</tr>
</tbody>
</table>