数据中转系统


商城→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> {   &amp;quot;dbCustomerDto&amp;quot;: {     &amp;quot;name&amp;quot;: &amp;quot;测试&amp;quot;,     &amp;quot;userId&amp;quot;: 0,     &amp;quot;mnemonic&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;foundAt&amp;quot;: &amp;quot;2025-01-17 11:19:11&amp;quot;,     &amp;quot;customerCategory&amp;quot;: &amp;quot;终端客户&amp;quot;,     &amp;quot;customerCategoryDictionaryValueId&amp;quot;: 239,     &amp;quot;type&amp;quot;: &amp;quot;个人客户&amp;quot;,     &amp;quot;typeDictionaryValueId&amp;quot;: 22,     &amp;quot;trade&amp;quot;: &amp;quot;家用电器&amp;quot;,     &amp;quot;tradeDictionaryValueId&amp;quot;: 11,     &amp;quot;star&amp;quot;: &amp;quot;一星客户&amp;quot;,     &amp;quot;starDictionaryValueId&amp;quot;: 57,     &amp;quot;origin&amp;quot;: &amp;quot;阿里&amp;quot;,     &amp;quot;originDictionaryValueId&amp;quot;: 29,     &amp;quot;status&amp;quot;: &amp;quot;了解商品&amp;quot;,     &amp;quot;statusDictionaryValueId&amp;quot;: 23,     &amp;quot;province&amp;quot;: &amp;quot;山西省&amp;quot;,     &amp;quot;city&amp;quot;: &amp;quot;忻州市&amp;quot;,     &amp;quot;area&amp;quot;: &amp;quot;代县&amp;quot;,     &amp;quot;address&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;country&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;saleType&amp;quot;: 0,     &amp;quot;region&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;personnel&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;personnelDictionaryValueId&amp;quot;: 0,     &amp;quot;remark&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;firstChar&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;contactId&amp;quot;: 0,     &amp;quot;contactName&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;contactPhone&amp;quot;: &amp;quot;&amp;quot;   },   &amp;quot;dbCustomerAttachDto&amp;quot;: {     &amp;quot;type&amp;quot;: 0,     &amp;quot;customerId&amp;quot;: 0,     &amp;quot;url&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;originName&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;extension&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;size&amp;quot;: 0.0,     &amp;quot;userId&amp;quot;: 0,     &amp;quot;remark&amp;quot;: &amp;quot;&amp;quot;   },   &amp;quot;dbCustomerContactsDto&amp;quot;: {     &amp;quot;userId&amp;quot;: 0,     &amp;quot;name&amp;quot;: &amp;quot;测试&amp;quot;,     &amp;quot;respect&amp;quot;: &amp;quot;化神境&amp;quot;,     &amp;quot;respectDictionaryValueId&amp;quot;: 82,     &amp;quot;role&amp;quot;: &amp;quot;联系人&amp;quot;,     &amp;quot;roleDictionaryValueId&amp;quot;: 73,     &amp;quot;type&amp;quot;: &amp;quot;财务&amp;quot;,     &amp;quot;typeDictionaryValueId&amp;quot;: 256,     &amp;quot;country&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;birthday&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;job&amp;quot;: &amp;quot;打工人&amp;quot;,     &amp;quot;phone&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;tel&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;fax&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;email&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;wx&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;qq&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;province&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;city&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;area&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;address&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;remark&amp;quot;: &amp;quot;&amp;quot;   },   &amp;quot;dbCustomerInvoiceDto&amp;quot;: {     &amp;quot;invoiceHeader&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;creditCode&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;bank&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;bankAccount&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;contactTel&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;contactAddress&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;type&amp;quot;: 0,     &amp;quot;taxRate&amp;quot;: 0.0,     &amp;quot;currencyNum&amp;quot;: &amp;quot;&amp;quot;   } }</code></pre> <h5>返回示例</h5> <pre><code> {     &amp;quot;code&amp;quot;: 200,     &amp;quot;msg&amp;quot;: &amp;quot;操作成功&amp;quot;,     &amp;quot;data&amp;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>

页面列表

ITEM_HTML