...
| 代码块 |
|---|
/api/aggregator/v1/accountManage/createShippercreateShipperWithCredential |
请求方式
| 代码块 |
|---|
POST |
请求头
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
Accept | String | 是 | 请求接受类型,固定值:application/json, text/plain, / |
Content-Type | String | 是 | 请求内容类型,固定值:application/json;charset=UTF-8 |
language | String | 是 | 语言 |
Referer | String | 是 | 来源地址 |
sessionId | String | 是 | 会话ID |
语言取值:
值 | 说明 |
|---|---|
zh_CN | 中文 |
en_US | 英文 |
请求参数
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
isShipper | Boolean | 是 | 是否为发件人(默认值:true) |
organizationType | Number | 是 | 组织类型(0-公司,1-个人) |
isCarrier | Boolean | 是 | 也是物流商(默认值:false) |
chineseName | String | 是 | 公司名称(中文)/ |
| 发件人姓名(中文),最大长度60 | |||
name | String | 是 | 公司名称(英文)/ |
发件人姓名(英文),最大长度50,仅支持英文字符 | |||
organizationCode | String | 是 | 组织机构代码证 / 身份证号码 |
code | String | 是 |
简称,最大长度10 | |||
legacyId | String | 否 | 客户ID (隐藏字段) |
contact | String | 是 |
联系人,最大长度50,仅支持英文字符 | ||
phone | String | 是 |
电话号码,支持数字、空格、*、#、()、- | |||
String | 是 | 邮箱 | |
language | String | 是 | 系统语言 (zh_CN/en_US) |
relationLabelIds | Array |
否 | 关联标签ID列表 | ||
salesId | Number | 是 | 销售人员ID |
csId | Number | 是 | 客服人员ID |
companyId | String | 是 | 所属公司 |
invoiceOption | Number | 是 | 开票选项 (1=不需要, 2=必填) |
logoId | String | 否 | Logo |
source | String | 否 | 客户来源 |
autoReleaseBulkyCargo | Boolean | 否 | 异常件设置-大货自动释放 (true/false) |
erpSource | String | 否 |
ERP,最大长度40 | |||
bagWeightDifference | String | 否 | 大包重量差(克) |
repeatScanWarn | Boolean | 否 | 重复扫描提醒 (true/false) |
shopUrl | String | 否 | 店铺地址 (隐藏字段) |
facilityCode | String |
是 | 网点编码 | ||
facilityAddress | String | 否 | 网点地址 |
address | Object | 是 | 地址对象 |
address 字段说明
字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
addressId | String | 否 | 地址ID |
addressLine1 | String | 是 | 地址行1 |
addressLine2 | String | 否 | 地址行2 |
addressLine3 | String | 否 | 地址行3 |
city | String | 是 | 城市 |
state | String | 是 | 州/省 |
postcode | String | 否 | 邮编 |
country | String | 是 | 国家代码 |
请求示例
| 代码块 |
|---|
curl 'https://tracking-qa.etowertech.com/api/aggregator/v1/accountManage/createShippercreateShipperWithCredential' \ -X 'POST' \ -H 'Accept: application/json, text/plain, */*' \ -H 'Content-Type: application/json;charset=UTF-8' \ -H 'language: zh_CN' \ -H 'sessionIdSessionId: cTsFECJgSI6aTLVFTGmBCgfROl7TJut5wEQeIU0PUm3A' \ -H 'Referer: https://tracking-qa.etowertech.com/aggregator/' \ --data-raw '{ "isShipper": true, "organizationType": 0, "isCarrier": false, "chineseName": "乙古文测试01", "name": "yiguwenTest01", "organizationCode": "qwe123123", "code": "yiguwen123", "legacyId": "", "contact": "qqqzhangsan", "phone": "1582345098715834509876", "email": "yiwengu@163test123456@163.com", "language": "zh_CN", "relationLabelIds": [ 9 ], "salesId": 33963346, "csId": 33963346, "companyId": "0KkCR4UUB82p7ttaGmaN", "invoiceOption": 1"", "logoId": "", "source": "", "autoReleaseBulkyCargo": false, "erpSource": "", "bagWeightDifference": "", "repeatScanWarn": false, "shopUrl": "", "facilityCode": "qwe1", "facilityAddress": "注册地址", "address": { "addressId": "", "addressLine1": "南京东路aolanquandao", "addressLine2": "", "addressLine3": "", "city": "SHAao", "state": "SHA", "postcode": "", "country": "CNAX" } }' |
返回示例
| 代码块 |
|---|
{
"success": true,
"code": "0",
"data": {
"createPlatform": "etower",
"dateCreated": "2026-03-1220 1714:2804:35",
"createdBy": 25000010063346,
"isAggregator": false,
"isShipper": true,
"isCarrier": false,
"parentTenantId": 10030394,
"topShipperId": 1982219856,
"organizationType": 0,
"salesId": 33963346,
"csId": 33963346,
"uuid": "qxjRfEFmsb3IRtMnGi_eiQy-fhv02Kmos2RNx8C6N7eQ",
"tenantId": 1982219856,
"adminUserId": 6334763382,
"platformAdminUserId": 6334763382,
"code": "yiguwen123",
"name": "yiguwenTest01",
"chineseName": "乙古文测试01",
"organizationCode": "qwe123123",
"language": "zh_CN",
"contact": "qqqzhangsan",
"phone": "1582345098715834509876",
"email": "yiwengu@163test123456@163.com",
"address": {
"addressId": "rWD_H_dYpt9kfES3d00PNx24eqUWbberCGBPgjY9-6UGTwehnE1JBA",
"addressLine1": "南京东路aolanquandao",
"addressLine2": "",
"addressLine3": "",
"city": "SHAao",
"state": "SHA",
"postcode": "",
"country": "CNAX"
},
"companyId": "0KkCR4UUB82p7ttaGmaN",
"relationLabelIds": [
9
],
"logoId": "",
"logo": [],
"autoReleaseBulkyCargo": false,
"source": "",
"erpSource": "",
"repeatScanWarn": false,
"shopUrl": "",
"facilityCode": "qwe1",
"weightDifferences": [],
"aggregator": 30394,
"invoiceOptioncurrentTenant": 130394,
"aggregatorcallFrom": 1001,
"currentTenantaccessKey": 100,"testMMmd-gAyAIziSRPf1rg",
"callFromsecretKey": "OfwDYLK2MbfiRy0N60O0bw"
1 },
"errors": []
}
|
返回字段说明
字段 | 类型 | 说明 |
|---|---|---|
success | Boolean | 请求是否成功 |
code | String | 响应状态码,"0"表示成功 |
data | Object | 创建的发件人信息 |
errors | Array | 错误信息列表 |
data 字段说明(主要字段)
字段 | 类型 | 说明 |
|---|---|---|
tenantId | Number | 租户ID(创建成功后返回) |
| accessKey | String | API Key |
| secretKey | String | API Secret |
adminUserId | Number | 管理员用户ID |
uuid | String | 租户UUID |
code | String | 租户代码 |
name | String | 英文名称 |
chineseName | String | 中文名称 |
organizationCode | String | 组织代码 |
contact | String | 联系人 |
phone | String | 电话 |
String | 邮箱 | |
address | Object | 地址信息 |
salesId | Number | 销售人员ID |
csId | Number | 客服人员ID |
invoiceOption | Number | 发票选项 |
facilityCode | String | 设施代码 |