用友BIP客户档案保存_v1API接口文档

所属平台： 用友BIP
类型： WebAPI
作用： EXECUTE
接口版本： 0.1
适配器： \Adapter\YYBIP\BIPExecuteAdapter
帮助链接： https://open.diwork.com/#/doc-center/docDes/api?code=yonbip&section=9fccfe02f1f34eacaf3557a3e76f01fc
描述：
更新日期： 2022-04-17 15:11:28
客户档案保存_v1

接口地址：/yonbip/digitalModel/merchant/save

请求方法： POST

加工厂： {"operation":{"method":"none"}}

接口请求参数
序号 字段 名称 类型 默认值 描述 是否必要
1 attachmentGroupId attachmentGroupId string 1 附件分组id 否
2 merchantAddressInfos merchantAddressInfos array 1 地址信息 是
3 attachmentGroupId_Name attachmentGroupId_Name string 1 附件分组名称 否
4 id id string 1 主键ID ，新增时无需填写，修改时必填 否
5 attachmentGroupItemId_Name attachmentGroupItemId_Name string 1 附件分组项 否
6 merchantId merchantId string 1 客户ID 否
7 longitude longitude long 1 经度    示例：0 否
8 id id string 1 客户ID 新增时无需填写，修改时必填 否
9 createOrg createOrg string 1 管理组织id 是
10 latitude latitude long 1 纬度    示例：0 否
11 createOrg_name createOrg_name string 1 管理组织名称 否
12 addressCode addressCode string 1 地址编码 是
13 mergerName mergerName string 1 组合名称 否
14 belongOrg_Name belongOrg_Name string 1 使用组织名称 否
15 createOrg_code createOrg_code string 1 管理组织编码 否
16 regionCode regionCode string 1 行政区划 否
17 code code string 1 客户编码(不能为空，新增会自动重新生成) 是
18 address address string 1 详细地址 否
19 zipCode zipCode string 1 邮政编码 否
20 name name muti_lang 1 客户名称,支持多语 否
21 shortname shortname muti_lang 1 客户简称,支持多语 否
22 receiver receiver string 1 联系人姓名 否
23 mobile mobile string 1 联系人手机 否
24 transType_Code transType_Code string 1 交易类型编码,商家登录时，不需要输 否
25 telePhone telePhone string 1 固定电话 否
26 merchantAppliedDetail merchantAppliedDetail object 1 业务信息 是
27 email email string 1 邮箱 否
28 erpCode erpCode string 1 del外部编码 否
29 qq qq string 1 QQ 否
30 country country string 1 国家id 否
31 timeZone timeZone string 1 时区id 否
32 weChat weChat string 1 微信 否
33 isDefault isDefault string 1 默认地址, true:是、false:否、 是
34 language language string 1 语言id 否
35 country_name country_name string 1 国家名称 否
36 erpCode erpCode string 1 外部编码 否
37 remarks remarks string 1 备注 否
38 timeZone_Name timeZone_Name string 1 时区名称 否
39 language_Name language_Name string 1 语言名称 否
40 _status _status string 1 操作标识, Insert:新增、Update:更新 否
41 merchantContacterInfos merchantContacterInfos array 1 联系人信息 是
42 country_code country_code string 1 国家编码 否
43 id id string 1 主键ID ，新增时无需填写，修改时必填 否
44 invoicingCustomers invoicingCustomers string 1 开票客户id 否
45 parentCustomer parentCustomer string 1 上级客户id 否
46 merchantId merchantId string 1 客户ID 否
47 invoicingCustomers_Name invoicingCustomers_Name string 1 开票客户名称 否
48 fullName fullName muti_lang 1 姓名,支持多语 是
49 gender gender string 1 性别, 0:未知、1:男、2:女、 否
50 parentCustomer_Name parentCustomer_Name string 1 上级客户名称 否
51 positionName positionName string 1 职务 否
52 suppliers suppliers string 1 对应供应商id 否
53 mobile mobile string 1 手机号 否
54 suppliers_Name suppliers_Name string 1 对应供应商名称 否
55 telePhone telePhone string 1 固定电话 否
56 isCreator isCreator boolean 1 是否创建者    示例：true 否
57 email email string 1 邮箱 否
58 isApplied isApplied boolean 1 是否被分配者使用    示例：true 否
59 qq qq string 1 QQ 否
60 channCustomerClass channCustomerClass string 1 渠道客户分类id 否
61 channCustomerClass_Name channCustomerClass_Name string 1 渠道客户分类名称 否
62 weChat weChat string 1 微信 否
63 channCustomerLevel channCustomerLevel string 1 del渠道客户级别id 否
64 isDefault isDefault string 1 默认联系人, true:是、false:否、 是
65 remarks remarks string 1 备注 否
66 channCustomerLevel_Name channCustomerLevel_Name string 1 del渠道客户级别名称 否
67 _status _status string 1 操作标识, Insert:新增、Update:更新 是
68 channCustomerArea channCustomerArea string 1 del渠道客户区域id 否
69 channCustomerArea_Name channCustomerArea_Name string 1 del渠道客户区域名称 否
70 merchantAgentFinancialInfos merchantAgentFinancialInfos array 1 银行信息 是
71 channCustomerIndustry channCustomerIndustry string 1 del渠道客户行业id 否
72 id id string 1 主键ID ，新增时无需填写，修改时必填 否
73 channCustomerIndustry_Name channCustomerIndustry_Name string 1 del渠道客户行业名称 否
74 merchantId merchantId string 1 客户编码 否
75 country country string 1 国家id 是
76 retailInvestors retailInvestors boolean 1 散户, true:是、false:否、    示例：true 否
77 province province string 1 省份id 否
78 internalOrg internalOrg boolean 1 是否内部组织, true:是、false:否、    示例：true 否
79 internalOrgId internalOrgId string 1 组织id 否
80 country_name country_name string 1 国家名称 否
81 province_Name province_Name string 1 省份名称 否
82 internalOrgId_Name internalOrgId_Name string 1 内部组织名称 否
83 currency currency string 1 币种id 是
84 taxPayingCategories taxPayingCategories long 1 纳税类别, 0:一般纳税人、1:小规模纳税人、2:海外纳税、    示例：0 是
85 belongOrg belongOrg string 1 使用组织id，编辑保存时必输 否
86 currency_name currency_name string 1 币种名称 否
87 customerClass customerClass string 1 客户分类id 是
88 accountType accountType string 1 账户类型, 0:对公账号、1:对私账号、 是
89 bank bank string 1 银行类别id 是
90 customerClass_Name customerClass_Name string 1 客户分类名称 否
91 customerClass_code customerClass_code string 1 客户分类编码 否
92 bank_name bank_name string 1 银行类别名称 否
93 openBank openBank string 1 银行网点id 是
94 customerIndustry customerIndustry string 1 客户行业id 否
95 openBank_name openBank_name string 1 银行网点名称 否
96 customerIndustry_Name customerIndustry_Name string 1 客户行业名称 否
97 customerIndustry_code customerIndustry_code string 1 客户行业编码 否
98 bankAccount bankAccount string 1 银行账号 否
99 bankAccountName bankAccountName string 1 账户名称 是
100 merchantsManager merchantsManager object 1 客户管理员信息 否
101 merchantRole merchantRole object 1 客户角色 否
102 jointLineNo jointLineNo string 1 联行号 否
103 isDefault isDefault string 1 默认银行, true:是、false:否、 是
104 merchantOptions merchantOptions boolean 1 是否商家， true:是、false:否    示例：false 是
105 enterpriseNature enterpriseNature string 1 企业类型, 0:企业、1:个人、2:非营利组织、 是
106 stopstatus stopstatus boolean 1 启用状态, false:启用、true:停用、 否
107 remarks remarks string 1 备注 否
108 enterpriseName enterpriseName string 1 企业名称 否
109 _status _status string 1 操作标识, Insert:新增、Update:更新 是
110 leaderName leaderName string 1 法人代表 否
111 leaderNameIdNo leaderNameIdNo string 1 法人代表身份证号 否
112 merchantAgentInvoiceInfos merchantAgentInvoiceInfos array 1 发票信息 是
113 id id string 1 主键ID ，新增时无需填写，修改时必填 否
114 personName personName string 1 del姓名 否
115 merchantId merchantId string 1 客户编码 否
116 idNo idNo string 1 del身份证号 否
117 orgName orgName string 1 del组织名称 否
118 billingType billingType string 1 默认发票类型, 0:收据、3:增值税电子普通发票、2:增值税普通发票、1:增值税专用发票、5:增值税电子普通发票(成品油)、6:增值税普通发票(成品油)、7:增值税专用发票(成品油)、8:电子收购发票、4:机动车销售统一发票、 是
119 title title string 1 发票抬头 是
120 creditCode creditCode string 1 统一社会信用代码 否
121 personCharge personCharge string 1 负责人 否
122 receievInvoiceEmail receievInvoiceEmail string 1 收票邮箱 否
123 receievInvoiceMobile receievInvoiceMobile string 1 收票手机号 否
124 personChargeIdNo personChargeIdNo string 1 负责人身份证号 否
125 frontIdNo frontIdNo string 1 法人证件正面照 否
126 taxNo taxNo string 1 税号 否
127 telephone telephone string 1 电话 否
128 backIdNo backIdNo string 1 法人证件背面照 否
129 address address muti_lang 1 地址,支持多语 否
130 businessLicense businessLicense string 1 营业执照 否
131 orgIdNo orgIdNo string 1 组织相关证件 否
132 name name string 1 银行类别id 否
133 businessLicenseNo businessLicenseNo string 1 经营许可证号 否
134 name_Name name_Name string 1 银行类别名称 否
135 regionCode regionCode string 1 注册地区 否
136 bankName bankName string 1 银行网点id 否
137 bankName_Name bankName_Name string 1 银行网点名称 否
138 address address muti_lang 1 详细地址,支持多语 否
139 longitude longitude long 1 经度    示例：0 否
140 bankAccount bankAccount string 1 银行账号 否
141 latitude latitude long 1 纬度    示例：0 否
142 isDefault isDefault string 1 默认发票信息, true:是、false:否、 是
143 postCode postCode string 1 邮编 否
144 remarks remarks string 1 备注 否
145 contactName contactName string 1 联系人 否
146 _status _status string 1 操作标识, Insert:新增、Update:更新 是
147 merchantCorpImages merchantCorpImages array 1 证照证书图片 是
148 contactTel contactTel string 1 联系电话 否
149 folder folder string 1 附件路径 否
150 email email string 1 邮箱 否
151 buildTime buildTime string 1 成立时间 否
152 merchantId merchantId string 1 客户ID 否
153 sort sort long 1 顺序    示例：0 否
154 enterNature enterNature string 1 企业性质id 否
155 type type string 1 附件类型 否
156 enterNature_Name enterNature_Name string 1 企业性质名称 否
157 size size string 1 附件大小 否
158 currencyCode currencyCode string 1 注册资金币种 否
159 imgName imgName string 1 证照证书名称 否
160 money money double 1 注册资金    示例：0.1 否
161 id id string 1 主键ID ，新增时无需填写，修改时必填 否
162 peopleNum peopleNum long 1 员工人数    示例：0 否
163 scopeModel scopeModel string 1 经营模式, 0:生产加工、1:批发经销、 否
164 _status _status string 1 操作标识, Insert:新增、Update:更新 是
165 merchantAttachments merchantAttachments array 1 附件 是
166 yearMoney yearMoney double 1 年营业额    示例：0.1 否
167 folder folder string 1 附件路径 否
168 scope scope muti_lang 1 经营范围,支持多语 否
169 website website string 1 网址 否
170 merchantId merchantId string 1 客户ID 否
171 sort sort string 1 顺序 否
172 wid wid string 1 微信公众号 否
173 type type string 1 附件类型 否
174 verfyMark verfyMark string 1 核实状态, 0:未核实、1:已核实、 否
175 size size string 1 附件大小 否
176 _status _status string 1 操作标识, Insert:新增、Update:更新 否
177 fileName fileName string 1 附件名称 否
178 id id string 1 主键ID ，新增时无需填写，修改时必填 否
179 _status _status string 1 操作标识, Insert:新增、Update:更新 是
180 merchantApplyRanges merchantApplyRanges array 1 客户适用组织 是
181 id id string 1 主键ID ，新增时无需填写，修改时必填 否
182 merchantId merchantId string 1 客户ID 否
183 rangeType rangeType string 1 客户分配范围类型,固定为1 是
184 orgId orgId string 1 组织ID 否
185 isCreator isCreator string 1 是否创建者, true:是、false:否、 否
186 isApplied isApplied string 1 是否被分配者使用, true:是、false:否、 否
187 orgCode orgCode string 1 组织编码 否
188 orgName orgName string 1 组织名称 否
189 _status _status string 1 操作标识, Insert:新增、Update:更新 是
190 customerAreas customerAreas array 1 销售区域 否
191 isDefault isDefault boolean 1 是否默认值, true:是、false:否、传销售区域子集时必填    示例：true 否
192 saleAreaId_code saleAreaId_code string 1 销售区域编码    示例：test11 否
193 saleAreaId saleAreaId long 1 销售区域id，传销售区域子集时必填    示例：2077177841307904 否
194 saleAreaId_name saleAreaId_name string 1 销售区域名称    示例：test11 否
195 _status _status string 1 操作标识, Insert:新增、Update:更新，传销售区域子集时必填    示例：Insert 否
接口响应参数
序号 字段 名称 类型 默认值 描述 是否必要
用友BIP的接口：客户档案保存_v1（/yonbip/digitalModel/merchant/save），由轻易云数据集成平台API资产管理模块整理收纳，并且根据用友BIP版本更新同步实时更新。通过API资产管理，企业可以更好地控制API的访问权限和使用限制，防止未授权访问和滥用，保障企业数据的安全和合规性。
联系轻易云集成专家
联系系统对接开发人员何海波

何海波 加微信

18175716035

轻易云的技术专家，拥有丰富的数据集成规划经验。他能够为客户提供专业、全面的数据集成规划方案，熟练掌握多种集成技术和工具，帮助企业在数据集成领域得到长远发展。

数据集成平台运行原理
更多系统对接方案