接口名称

更新发件人信息

接口地址

/api/aggregator/v1/accountManage/updateShipper

请求方式

POST

请求头

参数

类型

必填

说明

sessionId

String

是

登录会话ID

language

String

是

语言

Content-Type

String

是

固定值：application/json;charset=UTF-8

语言取值：

值

说明

zh_CN

中文

en_US

英文

请求参数

请求体为 JSON 格式

字段

类型

必填

说明

tenantId

Number

是

租户ID/发件人ID

organizationType

Number

是

客户类型，0=公司，1=个人

isCarrier

Boolean

是

是否也是物流商

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

salesId

Number

否

销售ID

relationLabelIds

Array

否

发件人标签ID数组

csId

Number

否

客服ID

companyId

String

否

所属公司ID

invoiceOption

Number

否

开票选项，1=不需要，2=必填

logoId

String

否

Logo图片ID

source

String

否

客户来源，如"eBay"

autoReleaseBulkyCargo

Boolean

否

异常件设置-大货自动释放

erpSource

String

否

ERP，最大长度40

bagWeightDifference

Number

否

大包重量差（克）

repeatScanWarn

Boolean

否

重复扫描提醒

shopUrl

String

否

店铺地址

weightDifferences

Array

否

重量差数组

timeDifference

Object

否

时间差对象

address

Object

是

注册地址对象

facilityCode

String

否

网点编码（新增时必填，编辑时不传）

facilityAddress

String

否

网点地址（新增时必填，编辑时不传）

address 对象字段说明

字段

类型

必填

说明

addressId

String

否

地址ID

addressLine1

String

否

地址第一行

addressLine2

String

否

地址第二行

addressLine3

String

否

地址第三行

city

String

否

市，仅支持英文字符

state

String

否

省/州，仅支持英文字符

postcode

String

否

邮编

country

String

否

国家/地区代码，如"CN"、"US"、"AF"等

weightDifferences 数组字段说明

字段

类型

说明

weightStart

Number

起始重量

weightEnd

Number

结束重量

weightDifference

Number

重量差值

timeDifference 对象字段说明

字段

类型

说明

hour

Number

小时差

minute

Number

分钟差

deleteFlag

Boolean

是否删除标记

请求示例

curl 'https://tracking-qa.etowertech.com/api/aggregator/v1/accountManage/updateShipper' \
  -H 'Accept: application/json, text/plain, */*' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'language: zh_CN' \
  -H 'sessionId: 59XGRoYc2ICTR_456jT4Og' \
  -d '{
    "tenantId": 19824,
    "organizationType": 0,
    "isCarrier": false,
    "chineseName": "TEST0313",
    "name": "TEST0313",
    "organizationCode": "1",
    "code": "TEST0313",
    "contact": "TEST",
    "phone": "123456",
    "email": "zhuyarong4@gmail.com",
    "language": "zh_CN",
    "relationLabelIds": [9],
    "salesId": 250000100,
    "csId": 250000100,
    "companyId": "0KkCR4UUB82p7ttaGmaN",
    "invoiceOption": 1,
    "logoId": "",
    "source": "",
    "autoReleaseBulkyCargo": false,
    "erpSource": "",
    "bagWeightDifference": 0,
    "repeatScanWarn": false,
    "shopUrl": "",
    "weightDifferences": [],
    "address": {
      "addressId": "uZ2guAFwDNrCcPz4cYpa5MEPWKI",
      "addressLine1": "TEST0313",
      "addressLine2": "",
      "addressLine3": "",
      "city": "TEST",
      "state": "",
      "postcode": "",
      "country": "AF"
    }
  }'

返回示例

{
  "success": true,
  "code": "0",
  "data": {
    "tenantId": 19824,
    "organizationType": 0,
    "isCarrier": false,
    "chineseName": "TEST0313",
    "name": "TEST0313",
    "organizationCode": "1",
    "code": "TEST0313",
    "contact": "TEST",
    "phone": "123456",
    "email": "zhuyarong4@gmail.com",
    "language": "zh_CN",
    "salesId": 250000100,
    "csId": 250000100,
    "csUsername": "support100@walltechsystem.cn",
    "companyId": "0KkCR4UUB82p7ttaGmaN",
    "relationLabelIds": [9],
    "logoId": "",
    "logo": "",
    "autoReleaseBulkyCargo": false,
    "source": "",
    "erpSource": "",
    "repeatScanWarn": false,
    "shopUrl": "",
    "bagWeightDifference": 0.0,
    "weightDifferenceRate": 0,
    "weightDifferences": [],
    "invoiceOption": 1,
    "address": {
      "addressId": "uZ2guAFwDNrCcPz4cYpa5MEPWKI",
      "addressLine1": "TEST0313",
      "addressLine2": "",
      "addressLine3": "",
      "city": "TEST",
      "state": "",
      "postcode": "",
      "country": "AF"
    },
    "aggregator": 100,
    "currentTenant": 100,
    "callFrom": 1
  },
  "errors": []
}

返回字段说明

字段

类型

说明

success

Boolean

请求是否成功

code

String

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

data

Object

发件人信息对象

errors

Array

错误信息列表

data 字段说明

data 返回的是 更新后的发件人完整信息对象，包含请求的所有字段，以及以下额外字段：

字段

类型

说明

isShipper

Boolean

是否是发件人

isAggregator

Boolean

是否是集成商

isPlatform

Boolean

是否是平台

dateCreated

String

创建时间

createdBy

Number

创建人ID

csUsername

String

客服账号

logo

String

Logo地址

weightDifferenceRate

Number

重量差异率

aggregator

Number

集成商ID

currentTenant

Number

当前租户ID

callFrom

Number

调用来源

错误码说明

code

说明

0

成功

其他

失败，具体错误信息见 errors 字段