问 FLEX订单如何区分

Orders API 目前没有字段可以直接区分“FLEX（Seller Flex / FBA Onsite）订单”和标准 FBA 订单。 getOrders 只能按履约渠道筛到 AFN（FBA）或 MFN（卖家自配送），在 AFN 里不会再细分出 FLEX。

曲线方法你试试：
用 Reports API 的 FBA 发货报告抓“履约中心ID（fulfillment-center-id）”，靠映射识别 FLEX

通过 Reports API 申请 FBA Amazon Fulfilled Shipments 报告（发票/税务版本任一都包含发货明细字段），该类报告包含成交明细与物流信息。
报告字段里有 fulfillment-center-id（发货仓代码）。你可以把你自家 Seller Flex 站点的 FC 代码维护成白名单映射；命中这些 FC 代码即可判定为 FLEX，否则为常规 FBA。亚马逊帮助页也明确“fulfillment-center-id 为订单发货的履约中心标识”

0 条评论收藏感谢

问亚马逊VC链接状态获取

你有没有尝试使用 searchListingsItems 这些看看能否拉到VC的数据?

如果能拉到，说明SC这个接口也适合VC的，就可以用notication来更新库存了(准实时)

你可以试试。或者需要我一起协助可以加我微信 sfgoods

我配合你测试一下

0 条评论收藏感谢

问 putListingsItem使用

需要使用getListingsItem 接口拉取一下，看看issue是什么，一般是有错误导致的查不到

[https://api.sp-api.net/zh/api-308930030
](https://api.sp-api.net/zh/api-308930030)

如果需要上传没有品牌名称和商品编号的商品，putListingsItem能实现吗

可以的，需要按照schema格式上传

2 条评论收藏感谢

问 EasyShip轨迹查询

通过 SP-API 无法直接获取 Easy Ship 订单的完整轨迹（包含所有历史状态和时间戳）；
但可以通过调用 getScheduledPackage 接口获取当前状态（带追踪 ID），结合轮询与通知机制（若能捕获状态变化），逐步构建出轨迹历史；同时可以借助报告接口做批量补充和审核。

0 条评论收藏感谢

问跨站点跟卖上架报错问题

看起来并不是“接口坏了”，而是没能在目标站点把你的 SKU 挂到同一个目录商品上，所以 LISTING_OFFER_ONLY 被系统判定为“没有找到可挂载的目录商品 → 走成了创建商品流（LISTING）”，于是返回了：

13013：西语提示“该商品不在该站点目录或已被删除。不要用 建议 ASIN，要用原始 UPC/GTIN 再发一次。”
90220：既然被当成“创建商品”，就需要 item_name 等标题类必填字段，但你没传，所以报缺失。

你的请求里最关键的一点是：
你只传了 merchant_suggested_asin（“建议 ASIN”），这不会保证在 ES 站点成功匹配。如果该 ASIN 在西班牙站没有对应目录条目（或还没被跨站同步），SP-API 就无法把你挂到现有目录，于是走创建流并要求标题等信息。

为什么后台/表格/历史 feed 可以成功，而 PUT Listings 失败？

后台和表格（Flat File）通常会用 GTIN（EAN/UPC）去匹配，而不是“建议 ASIN”。同一个 GTIN 在各站点的目录能自动归并，所以能顺利挂上。
你这次用 LISTING_OFFER_ONLY + merchant_suggested_asin，如果目标站点没有该 ASIN，系统就找不到“可挂”的目录 → 报 13013/90220。

可以这几个方面自查看看

该 ASIN 在目标站点是否存在？
用 Catalog Items API（2022-04-01 版）查 GET /catalog/2022-04-01/items/{ASIN}?marketplaceIds=A1RKKUPIHCS9HS。
- 存在：继续看第 2 点。
- 不存在：见“修复方案 B”。
productType 是否与该 ASIN 的 item_type_keyword 匹配？
你传的是 "productType": "CABINET"。如果目标站点该 ASIN 实际的 product type 不是 CABINET，会导致校验偏离。
- 用 Definitions API getDefinitionsProductType（传 marketplace=ES、locale=es_ES）核对该 ASIN 的 item_type_keyword，把 productType 改成目标站点实际的 product type。
用“报价专用”字段，不要混入创建商品字段
requirements: LISTING_OFFER_ONLY 下，只传报价/配送相关字段：价格（purchasable_offer）、库存（fulfillment_availability）、成色（condition_type）、运费模板（merchant_shipping_group）等。
你现在的字段基本没问题，但仅靠 merchant_suggested_asin 不足以匹配。
库存与价格
你请求里 quantity: 0，但响应里读回是 18——说明后面有别的系统/模板同步了库存。若想立即在 ES 站点上架，确保 quantity > 0 且有有效价格。

一个更稳的请求示例（已存在同 ASIN 的前提）

{
  "listingsItemPutRequest": {
    "attributes": {
      "purchasable_offer": [{
        "marketplace_id": "A1RKKUPIHCS9HS",
        "our_price": [{
          "schedule": [{ "value_with_tax": 149.99 }]
        }],
        "currency": "EUR"
      }],
      "condition_type": [{
        "marketplace_id": "A1RKKUPIHCS9HS",
        "value": "new_new"
      }],
      "fulfillment_availability": [{
        "quantity": 18,
        "fulfillment_channel_code": "DEFAULT"
      }],
      "merchant_shipping_group": [{
        "marketplace_id": "A1RKKUPIHCS9HS",
        "value": "legacy-template-id"
      }]
      /* 可选：supplier_declared_dg_hz_regulation 等 */
    },
    "productType": "<与该 ASIN 在ES的item_type_keyword一致>",
    "requirements": "LISTING_OFFER_ONLY"
  },
  "sellerId": "ES店铺SellerID",
  "site": "ES",
  "sku": "你的SellerSKU"
}

常见坑位对照

✅ 用 GTIN 做跨站匹配；ASIN 只是各站点的本地标识，可能不通用。
✅ 核对 productType（用 Definitions/Catalog 拿到 ES 站点的 item_type_keyword）。
✅ OFFER ONLY 只传报价/库存/成色等；一旦被系统判定为“创建”，就会要求 item_name、品牌等。
❌ 仅靠 merchant_suggested_asin。这是提示性字段，不保证匹配。
❌ 目标站点没有该 ASIN 还用 LISTING_OFFER_ONLY。应改走 LISTING+GTIN，或先用 BIL 建好。

0 条评论收藏感谢

问使用JSON备货时间修改问题

不确定你这个商品是否是做了FBA和FBM还是只有FBM？在这个不知道的前提下有几个场景你试试：

如果有FBA和FBM同时，那修改时候把FBA和FBM的都加上

比如：

{
  "fulfillmentAvailability": [
    {
      "fulfillmentChannelCode": "DEFAULT",   // 自发货
      "quantity": 10,
      "leadTimeToShipMinDays": 2,
      "leadTimeToShipMaxDays": 4
    },
    {
      "fulfillmentChannelCode": "AMAZON_NA"  // FBA 北美
      // 这里不要放 lead_time_to_ship / leadTimeToShip* / quantity
    }
  ]
}

或者不用PATCH使用MERGE

如果是单纯的FBM，你加上市场ID看看

{
    "productType": "PRODUCT",
    "patches": [
        {
            "op": "replace",
            "path": "/attributes/fulfillment_availability",
            "value": [
                {
                    "marketplace_id": "ABCDE",
                    "fulfillment_channel_code": "DEFAULT",
                    "lead_time_to_ship_max_days": 4,
                    "quantity": 543
                }
            ]
        }
    ]
}

这个修改和PT没关系。这个属性是通用属性，用PRODUCT或者不传PT（没记错的话）应该都可以修改

1 条评论收藏感谢

上线/可售与否要以 Listings 为准：用 listing 接口拉取并检查 issues 错误：
https://api.sp-api.net/zh/api-308930030

需要批量检查就用批量接口：
https://api.sp-api.net/zh/api-289540209

0 条评论收藏感谢

问调用getListingsItem指定includedData的relationships未返回

我试了下，有的情况有，有的没有

先说有的情况：

使用getListing接口 https://api.sp-api.net/zh/api-308930030

比如这个是变体：可以拉到对应的关系

"relationships": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "relationships": [
        {
          "parentSkus": [
            "xxxxxxx"
          ],
          "type": "VARIATION",
          "variationTheme": {
            "attributes": [
              "color"
            ],
            "theme": "COLOR"
          }
        }
      ]
    }
  ],

如果换成父体，也能拉到子的

 "relationships": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "relationships": [
        {
          "childSkus": [
            "afdsfsdf",
            "fsdfds",
            "fsdfsdf",
            "fsdf"          
          ],
          "type": "VARIATION",
          "variationTheme": {
            "attributes": [
              "color"
            ],
            "theme": "COLOR"
          }
        }
      ]
    }
  ],

没有情况

官方没有说明，但是我实际测试，跟卖时候是没有返回的。
你看下merchant_suggested_asin 这个有没有。这个有，那是跟卖的，就可能是空的

当然还可能有其他情况是空的，欢迎发出来一起探讨

0 条评论收藏感谢

问多变体刊登时，店铺后台没有子体，主体显示报价缺失

因为你没有发PT（productType）所以我没法具体看，不过你可以先自查：

变体主体你看看是否有：SIZE/COLOR 或者 SIZE_NAME/COLOR_NAME

这个报错就是说，变体主体已经不被接受了，你看看是使用getDefinitionsProductType是不是最新的版本。

当然你后续追加一下具体的PT，我拉一下具体数据看看

2 条评论收藏感谢

需要用到AWS事件桥和SQS，详细如下：

目标

订阅商品更新（如：LISTINGS_ITEM_STATUS_CHANGE）
订阅订单更新（如：ORDER_CHANGE）

总体流程

有两种接收通知的方式：

Amazon EventBridge：用于商品相关通知（Listings）
Amazon SQS（Simple Queue Service）：用于订单等通知（Orders）

商品更新订阅流程（使用 Amazon EventBridge）

支持的通知类型示例

LISTINGS_ITEM_STATUS_CHANGE
LISTINGS_ITEM_MFN_QUANTITY_CHANGE
BRANDED_ITEM_CONTENT_CHANGE

步骤 1：创建 Destination（createDestination）

接口： POST /notifications/v1/destinations

参数：

{
  "resourceSpecification": {
    "eventBridge": {
      "region": "us-east-1",
      "accountId": "AWS_ACCOUNT_ID"
    }
  },
  "name": "MyEventBridgeDestination"
}

返回值中保存：

destinationId
resource.eventBridge.name（用于 EventBridge 配置）

步骤 2：在 AWS EventBridge 配置 partner event source

登录 AWS 控制台
找到 EventBridge > Partner event sources
找到格式为 aws.partner/sellingpartnerapi.amazon.com/{AWS Account Id}/{Application Id} 的 source
点击并关联事件总线（Event Bus）

步骤 3：创建 Rule 匹配通知类型

在 EventBridge 控制台，进入 Rules > Create rule
选择刚刚关联的 partner event bus
选择 “Use pattern form”
事件模式样例（仅接收某类通知）：

{
  "source": [
    {
      "prefix": "aws.partner/sellingpartnerapi.amazon.com"
    }
  ],
  "detail-type": ["LISTINGS_ITEM_STATUS_CHANGE"]
}

设置 Target（如 SQS queue、Lambda 等）

步骤 4：创建 Subscription（createSubscription）

接口： POST /notifications/v1/subscriptions/{notificationType}

参数示例：

{
  "payloadVersion": "1.0",
  "destinationId": "YOUR_DESTINATION_ID"
}

notificationType 示例值：

"LISTINGS_ITEM_STATUS_CHANGE"
"BRANDED_ITEM_CONTENT_CHANGE"

订单更新订阅流程（使用 Amazon SQS）

支持的通知类型示例

ORDER_CHANGE
ANY_OFFER_CHANGED（可以包含 marketplaceIds 过滤器）

步骤 1：授权 SP-API 写入 SQS

参考 AWS 文档配置权限策略，允许 SP-API 写入您指定的 SQS 队列。

步骤 2：如使用加密，授权 SP-API 访问 KMS key（可选）

提供以下 IAM policy 示例：

{
  "Effect": "Allow",
  "Principal": {
    "AWS": "arn:aws:iam::437568002678:root"
  },
  "Action": ["kms:GenerateDataKey", "kms:Decrypt"],
  "Resource": "*"
}

步骤 3：创建 Destination（createDestination）

接口： POST /notifications/v1/destinations

参数：

{
  "resourceSpecification": {
    "sqs": {
      "arn": "arn:aws:sqs:region:account_id:queue_name"
    }
  },
  "name": "MySQSQueueDestination"
}

返回值中保存：

destinationId

步骤 4：创建 Subscription（createSubscription）

接口： POST /notifications/v1/subscriptions/{notificationType}

常见 notificationType 示例：

"ORDER_CHANGE"（订单状态/买家取消）
"ANY_OFFER_CHANGED"（包含市场过滤器）

参数示例（带过滤器）：

{
  "payloadVersion": "1.0",
  "destinationId": "YOUR_DESTINATION_ID",
  "processingDirective": {
    "eventFilter": {
      "eventFilterType": "ANY_OFFER_CHANGED",
      "marketplaceIds": ["ATVPDKIKX0DER"]
    },
    "aggregationSettings": {
      "aggregationTimePeriod": "FiveMinutes"
    }
  }
}

重要说明

SQS 类型必须是 Standard queue，不能是 FIFO
接收通知时需去重：通过 NotificationMetadata.notificationId
支持重复、乱序交付，需做好幂等处理
ORDER_CHANGE 不支持 marketplaceIds 过滤，若需要请使用 ANY_OFFER_CHANGED

具体流程是这个文档：https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide

0 条评论收藏感谢

问订单发货后怎么修改信息呀

同这个问题：
https://sp-api.net/ask/question/208658.html

0 条评论收藏感谢

如果需要上传没有品牌名称和商品编号的商品，putListingsItem能实现吗

为什么后台/表格/历史 feed 可以成功，而 PUT Listings 失败？

可以这几个方面自查看看

推荐的修复方案（择一）

方案 A：先确认 ASIN 在 ES 存在 → 纯“跟卖挂接”

方案 B：用 GTIN 在目标站点“先建后挂”

方案 C：用 BIL/全球开店工具做跨站同步

一个更稳的请求示例（已存在同 ASIN 的前提）

常见坑位对照

我试了下，有的情况有，有的没有

先说有的情况：

比如这个是变体：可以拉到对应的关系

如果换成父体，也能拉到子的

没有情况

需要用到AWS事件桥和SQS，详细如下：

目标

总体流程

商品更新订阅流程（使用 Amazon EventBridge）

支持的通知类型示例

步骤 1：创建 Destination（createDestination）

步骤 2：在 AWS EventBridge 配置 partner event source

步骤 3：创建 Rule 匹配通知类型

步骤 4：创建 Subscription（createSubscription）

订单更新订阅流程（使用 Amazon SQS）

支持的通知类型示例

步骤 1：授权 SP-API 写入 SQS

步骤 2：如使用加密，授权 SP-API 访问 KMS key（可选）

步骤 3：创建 Destination（createDestination）

步骤 4：创建 Subscription（createSubscription）

重要说明

会员统计