新建客户 CreateCustomer

POST

/hitf/v1/rest/invoke

请求参数

Query 参数

namespace

string

可选

示例值:

HZERO

serverCode

string

可选

示例值:

ZOSC_OPEN_API

interfaceCode

string

可选

示例值:

zosc-open-api.customer-open-api-controller.createCustomer

Body 参数application/json

customerCode

string

客户编码

必需

租户下唯一

customerDesc

string

客户描述

必需

customerShortName

string

客户简称

可选

unifiedSocialCode

string

社会信用代码

可选

若需启用协同，则社会信用代码必输

defaultTaxRateCode

string

默认税率代码

可选

同时输入时，以编码为主

defaultTaxRateDesc

string

默认税率描述

可选

同时输入时，以编码为主

defaultCurrencyCode

string

默认币种编码

可选

同时输入时，以编码为主

defaultCurrencyName

string

默认币种名称

可选

同时输入时，以编码为主

enabledFlag

string

是否有效

可选

默认为1，1表示有效，0表示无效

collaborationFlag

string

启用协同

可选

默认为0，1表示启用，0表示未启用，若希望启用协同，则社会信用代码必输，且在启用协同的客户中社会信用代码不允许重复

doAutoTransferFlag

string

需求订单自动转销售订单

可选

默认为0，1表示该客户需求订单满足条件下会自动转换为销售订单，0表示不自动转换

addressList

object

可选

addressCode

string

地点编码

可选

若维护客户地点，则必输

countryCode

string

国家编码

可选

维护客户地点，则不能同时为空同时输入时，以编码为主

countryName

string

国家名称

可选

维护客户地点，则不能同时为空同时输入时，以编码为主

provinceCode

string

省编码

可选

非必填，同时输入时，以编码为主

provinceName

string

省名称

可选

非必填，同时输入时，以编码为主

cityCode

string

市编码

可选

非必填，同时输入时，以编码为主

cityName

string

市名称

可选

非必填，同时输入时，以编码为主

districtCode

string

区编码

可选

非必填，同时输入时，以编码为主

districtName

string

区名称

可选

非必填，同时输入时，以编码为主

streetCode

string

街道编码

可选

streetName

string

街道名称

可选

detailedAddress

string

详细地址

可选

若维护客户地点，则必输

postalCode

string

邮政编码

可选

customerOrganizationName

string

客户组织名称

可选

客户启用协同后才能维护客户组织名称

enabledFlag

string

有效

可选

默认为1，1表示有效，0表示无效

companyList

object

可选

contactList

object

可选

invoiceList

object

可选

sequenceNum

string

序号

可选

若维护客户开票信息，则必输

defaultTypeCode

string

默认开票类型

可选

若维护客户开票信息，则必输，若输入，不能同时为空同时输入时，以编码为主

defaultTypeName

string

默认开票类型名称

可选

若维护客户开票信息，则必输，若输入，不能同时为空同时输入时，以编码为主

name

string

开票名称

可选

若维护客户开票信息，则必输

unifiedSocialCode

string

税号

可选

address

string

开票地址

可选

phone

string

开票电话

可选

depositBankName

string

银行开户行名称

可选

bankAccount

string

银行账号

可选

string

收票邮箱

可选

defaultFlag

string

默认开票信息

可选

示例

{
"headerParamMap":{},
"pathVariableMap":{},
"requestParamMap":{},
"bodyParamMap":{},
"payload":"[{\"customerCode\":\"openapi\",\"customerDesc\":\"加工厂\",\"customerShortName\":\"加工厂1\",\"unifiedSocialCode\":\"YU1234567899999999\",\"defaultTaxRateCode\":\"3\",\"defaultTaxRateDesc\":\"3%\",\"defaultCurrencyCode\":\"CNY\",\"defaultCurrencyName\":\"人民币\",\"enabledFlag\":\"\",\"collaborationFlag\":1,\"doAutoTransferFlag\":\"\",\"addressList\":[{\"addressCode\":\"10\",\"countryCode\":\"\",\"countryName\":\"中国\",\"provinceName\":\"湖南\",\"cityName\":\"长沙市\",\"districtName\":\"岳麓区\",\"streetName\":\"麓谷街道\",\"detailedAddress\":\"麓谷企业广场\",\"postalCode\":\"415900\",\"customerOrganizationName\":\"加工厂一车间\",\"enabledFlag\":\"\",\"companyList\":[{\"sequenceNum\":\"10\",\"code\":\"Co00000290\",\"name\":\"甄一test公司D\",\"defaultReceivingAddressFlag\":\"\",\"defaultBillingAddressFlag\":\"\",\"enabledFlag\":\"\"}],\"contactList\":[{\"sequenceNum\":\"10\",\"name\":\"魏子龙\",\"mobilephone\":\"123554658\",\"telephone\":\"55489754\",\"email\":\"111@11.com\",\"fax\":\"\",\"defaultFlag\":\"\",\"enabledFlag\":\"\"}]}],\"invoiceList\":[{\"sequenceNum\":\"10\",\"defaultTypeCode\":\"VAT_INVOICE\",\"defaultTypeName\":\"增值税普通发票\",\"name\":\"测试开票地址\",\"unifiedSocialCode\":\"5487212164\",\"address\":\"长沙城区\",\"phone\":\"5445122\",\"depositBankName\":\"长沙银行\",\"bankAccount\":\"5455521389\",\"email\":\"123123@33.com\",\"defaultFlag\":\"\"}]}]"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/hitf/v1/rest/invoke' \
--header 'Content-Type: application/json' \
--data-raw '{
"headerParamMap":{},
"pathVariableMap":{},
"requestParamMap":{},
"bodyParamMap":{},
"payload":"[{\"customerCode\":\"openapi\",\"customerDesc\":\"加工厂\",\"customerShortName\":\"加工厂1\",\"unifiedSocialCode\":\"YU1234567899999999\",\"defaultTaxRateCode\":\"3\",\"defaultTaxRateDesc\":\"3%\",\"defaultCurrencyCode\":\"CNY\",\"defaultCurrencyName\":\"人民币\",\"enabledFlag\":\"\",\"collaborationFlag\":1,\"doAutoTransferFlag\":\"\",\"addressList\":[{\"addressCode\":\"10\",\"countryCode\":\"\",\"countryName\":\"中国\",\"provinceName\":\"湖南\",\"cityName\":\"长沙市\",\"districtName\":\"岳麓区\",\"streetName\":\"麓谷街道\",\"detailedAddress\":\"麓谷企业广场\",\"postalCode\":\"415900\",\"customerOrganizationName\":\"加工厂一车间\",\"enabledFlag\":\"\",\"companyList\":[{\"sequenceNum\":\"10\",\"code\":\"Co00000290\",\"name\":\"甄一test公司D\",\"defaultReceivingAddressFlag\":\"\",\"defaultBillingAddressFlag\":\"\",\"enabledFlag\":\"\"}],\"contactList\":[{\"sequenceNum\":\"10\",\"name\":\"魏子龙\",\"mobilephone\":\"123554658\",\"telephone\":\"55489754\",\"email\":\"111@11.com\",\"fax\":\"\",\"defaultFlag\":\"\",\"enabledFlag\":\"\"}]}],\"invoiceList\":[{\"sequenceNum\":\"10\",\"defaultTypeCode\":\"VAT_INVOICE\",\"defaultTypeName\":\"增值税普通发票\",\"name\":\"测试开票地址\",\"unifiedSocialCode\":\"5487212164\",\"address\":\"长沙城区\",\"phone\":\"5445122\",\"depositBankName\":\"长沙银行\",\"bankAccount\":\"5455521389\",\"email\":\"123123@33.com\",\"defaultFlag\":\"\"}]}]"
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

修改于 2023-03-31 08:03:31

更新客户 UpdateCustomer

确认需求订单 Confirm DemandOrder