eTowerOne Developers
页面树结构
转至元数据结尾
转至元数据起始

接口名称

创建发件人

接口地址

/api/aggregator/v1/accountManage/createShipperWithCredential

请求方式

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

是

电话号码，支持数字、空格、*、#、()、-

email

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/createShipperWithCredential' \
  -X 'POST' \
  -H 'Accept: application/json, text/plain, */*' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'language: zh_CN' \
  -H 'SessionId: fROl7TJut5wEQeIU0PUm3A' \
  -H 'Referer: https://tracking-qa.etowertech.com/aggregator/' \
  --data-raw '{
    "isShipper": true,
    "organizationType": 0,
    "isCarrier": false,
    "chineseName": "测试01",
    "name": "Test01",
    "organizationCode": "123",
    "code": "123",
    "legacyId": "",
    "contact": "zhangsan",
    "phone": "15834509876",
    "email": "test123456@163.com",
    "language": "zh_CN",
    "relationLabelIds": [
        9
    ],
    "salesId": 63346,
    "csId": 63346,
    "companyId": "",
    "invoiceOption": "",
    "logoId": "",
    "source": "",
    "autoReleaseBulkyCargo": false,
    "erpSource": "",
    "bagWeightDifference": "",
    "repeatScanWarn": false,
    "shopUrl": "",
    "facilityCode": "1",
    "facilityAddress": "注册地址",
    "address": {
        "addressId": "",
        "addressLine1": "aolanquandao",
        "addressLine2": "",
        "addressLine3": "",
        "city": "ao",
        "state": "",
        "postcode": "",
        "country": "AX"
    }
}'

返回示例

{
    "success": true,
    "code": "0",
    "data": {
        "createPlatform": "etower",
        "dateCreated": "2026-03-20 14:04:35",
        "createdBy": 63346,
        "isAggregator": false,
        "isShipper": true,
        "isCarrier": false,
        "parentTenantId": 30394,
        "topShipperId": 19856,
        "organizationType": 0,
        "salesId": 63346,
        "csId": 63346,
        "uuid": "y-fhv02Kmos2RNx8C6N7eQ",
        "tenantId": 19856,
        "adminUserId": 63382,
        "platformAdminUserId": 63382,
        "code": "123",
        "name": "Test01",
        "chineseName": "测试01",
        "organizationCode": "123",
        "language": "zh_CN",
        "contact": "zhangsan",
        "phone": "15834509876",
        "email": "test123456@163.com",
        "address": {
            "addressId": "WbberCGBPgjY9-6UGTwehnE1JBA",
            "addressLine1": "aolanquandao",
            "addressLine2": "",
            "addressLine3": "",
            "city": "ao",
            "state": "",
            "postcode": "",
            "country": "AX"
        },
        "companyId": "",
        "relationLabelIds": [
            9
        ],
        "logoId": "",
        "logo": [],
        "autoReleaseBulkyCargo": false,
        "source": "",
        "erpSource": "",
        "repeatScanWarn": false,
        "shopUrl": "",
        "facilityCode": "1",
        "weightDifferences": [],
        "aggregator": 30394,
        "currentTenant": 30394,
        "callFrom": 1,
        "accessKey": "testMMmd-gAyAIziSRPf1rg",
        "secretKey": "OfwDYLK2MbfiRy0N60O0bw"
    },
    "errors": []
}

返回字段说明

字段

类型

说明

success

Boolean

请求是否成功

code

String

响应状态码，"0"表示成功

data

Object

创建的发件人信息

errors

Array

错误信息列表

data 字段说明（主要字段）

字段

类型

说明

tenantId

Number

租户ID（创建成功后返回）

accessKeyStringAPI Key
secretKeyStringAPI Secret

adminUserId

Number

管理员用户ID

uuid

String

租户UUID

code

String

租户代码

name

String

英文名称

chineseName

String

中文名称

organizationCode

String

组织代码

contact

String

联系人

phone

String

电话

email

String

邮箱

address

Object

地址信息

salesId

Number

销售人员ID

csId

Number

客服人员ID

invoiceOption

Number

发票选项

facilityCode

String

设施代码

  • 无标签