Amazon Selling Partner API (SP-API)-中文

updateShipmentSourceAddress

北美(North America）

PUT

https://sellingpartnerapi-na.amazon.com/inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/sourceAddress

FBA inbound operations. 2024-03-20

更新现有货物的源地址。货物的源地址只能在确认货物承运人之前进行更新。由于更新了源地址，现有的运输选项将无效，需要重新生成以捕捉由于新的源地址而可能导致的运输选项和报价的差异。

使用计划：

速率（请求每秒）	突发
2	30

x-amzn-RateLimit-Limit 响应头在可用时返回应用于请求操作的使用计划速率限制。上表指示此操作的默认速率和突发值。对更高吞吐量有商业需求的销售合作伙伴可能会看到比此处所示更高的速率和突发值。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Path 参数

inboundPlanId

string

入境计划的标识符。

必需

>= 38 字符<= 38 字符

正则匹配:

^[a-zA-Z0-9-]*$

shipmentId

string

必需

货物的识别码。货物包含正在入库的箱子和单位。

>= 38 字符<= 38 字符

正则匹配:

^[a-zA-Z0-9-]*$

Body 参数application/json

`UpdateShipmentSourceAddress` 请求。

address

object (AddressInput)

必需

识别地点的具体细节。

示例值:

{"addressLine1":"123 example street","addressLine2":"Floor 19","city":"Toronto","companyName":"Acme","countryCode":"CA","email":"email@email.com","name":"name","phoneNumber":"1234567890","postalCode":"M1M1M1","stateOrProvinceCode":"ON"}

addressLine1

string

街道地址信息。

必需

>= 1 字符<= 180 字符

addressLine2

string

附加街道地址信息。

可选

>= 1 字符<= 60 字符

city

string

城市。

必需

>= 1 字符<= 30 字符

companyName

string

企业名称。

可选

>= 1 字符<= 50 字符

countryCode

string

必需

国家代码采用两位字符的ISO 3166-1 alpha-2格式。

>= 2 字符<= 2 字符

正则匹配:

^[A-Z]{2}$

string

电子邮箱地址。

可选

>= 1 字符<= 1024 字符

name

string

主要联系人姓名。

必需

>= 1 字符<= 50 字符

phoneNumber

string

电话号码。

必需

>= 1 字符<= 20 字符

postalCode

string

邮政编码。

必需

>= 1 字符<= 32 字符

stateOrProvinceCode

string

州或省代码。

可选

>= 1 字符<= 64 字符

示例

{
  "address": {
    "addressLine1": "123 example street",
    "addressLine2": "Floor 19",
    "city": "Toronto",
    "companyName": "Acme",
    "countryCode": "CA",
    "email": "email@email.com",
    "name": "name",
    "phoneNumber": "1234567890",
    "postalCode": "M1M1M1",
    "stateOrProvinceCode": "ON"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://sellingpartnerapi-na.amazon.com/inbound/fba/2024-03-20/inboundPlans//shipments//sourceAddress' \
--header 'Content-Type: application/json' \
--data-raw '{
    "address": {
        "addressLine1": "123 example street",
        "addressLine2": "Floor 19",
        "city": "Toronto",
        "companyName": "Acme",
        "countryCode": "CA",
        "email": "email@email.com",
        "name": "name",
        "phoneNumber": "1234567890",
        "postalCode": "M1M1M1",
        "stateOrProvinceCode": "ON"
    }
}'

返回响应

🟢202成功

application/json

更新货运源地址 202 响应

Headers

x-amzn-RequestId

string

可选

唯一请求参考标识符。

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

Body

`UpdateShipmentSourceAddress` 响应。

operationId

string

必需

给定操作的 UUID。

>= 36 字符<= 38 字符

正则匹配:

^[a-zA-Z0-9-]*$

示例

{
  "operationId": "stringstringstringstringstringstring"
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

修改于 2025-03-15 12:29:09

scheduleSelfShipAppointment

updateShipmentTrackingDetails