用友BIP 客户档案保存_v1 API

Platform: 用友BIP
Type: WebAPI
Effect: EXECUTE
API Version: 0.1
Adapter: \Adapter\YYBIP\BIPExecuteAdapter
Auth Mode: OTHER
Help Link: https://open.diwork.com/#/doc-center/docDes/api?code=yonbip&section=9fccfe02f1f34eacaf3557a3e76f01fc
Doc Link: https://open.diwork.com/#/doc-center/docDes/api?code=yonbip&section=9fccfe02f1f34eacaf3557a3e76f01fc
Updated At: 2022-04-17

客户档案保存_v1

POST/yonbip/digitalModel/merchant/save

Factory

{
  "operation": {
    "method": "none"
  }
}

Request Parameters

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

Response Parameters

No parameter reference available

The 客户档案保存_v1 API (/yonbip/digitalModel/merchant/save) of 用友BIP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 用友BIP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.