Amazon Selling Partner API (SP-API)-中文
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
  1. Listings Items 2021-08-01
  • Orders
    • getOrders
      GET
    • getOrder
      GET
    • getOrderBuyerInfo
      GET
    • getOrderAddress
      GET
    • getOrderItems
      GET
    • getOrderItemsBuyerInfo
      GET
    • updateShipmentStatus
      POST
    • getOrderRegulatedInfo
      GET
    • updateVerificationStatus
      PATCH
    • confirmShipment
      POST
  • Reports 2021-06-30
    • getReports
      GET
    • createReport
      POST
    • cancelReport
      DELETE
    • getReport
      GET
    • getReportSchedules
      GET
    • createReportSchedule
      POST
    • cancelReportSchedule
      DELETE
    • getReportSchedule
      GET
    • getReportDocument
      GET
  • Feeds 2021-06-30
    • getFeeds
      GET
    • createFeed
      POST
    • cancelFeed
      DELETE
    • getFeed
      GET
    • createFeedDocument
      POST
    • getFeedDocument
      GET
  • Sellers
    • getMarketplaceParticipations
  • Pricing 2022-05-01
    • getFeaturedOfferExpectedPriceBatch
    • getCompetitiveSummary
  • Notifications
    • getSubscription
    • createSubscription
    • getSubscriptionById
    • deleteSubscriptionById
    • getDestinations
    • createDestination
    • getDestination
    • deleteDestination
  • A+ Content Management
    • searchContentDocuments
    • createContentDocument
    • getContentDocument
    • updateContentDocument
    • listContentDocumentAsinRelations
    • postContentDocumentAsinRelations
    • validateContentDocumentAsinRelations
    • searchContentPublishRecords
    • postContentDocumentApprovalSubmission
    • postContentDocumentSuspendSubmission
  • Application Management
    • rotateApplicationClientSecret
  • The AWD
    • getInboundShipment
    • listInboundShipments
    • listInventory
  • Catalog Items V0
    • listCatalogItems
    • getCatalogItem
    • listCatalogCategories
  • Catalog Items 2020-12-01
    • searchCatalogItems
    • getCatalogItem
  • Catalog Items 2022-04-01
    • searchCatalogItems
    • getCatalogItem
  • Data Kiosk
    • getQueries
    • createQuery
    • cancelQuery
    • getQuery
    • getDocument
  • Product Type Definitions
    • searchDefinitionsProductTypes
    • getDefinitionsProductType
  • Automotive.
    • getVehicles
  • Easy Ship
    • listHandoverSlots
    • getScheduledPackage
    • createScheduledPackage
    • updateScheduledPackages
    • createScheduledPackageBulk
  • FBA Inbound Eligibilty
    • getItemEligibilityPreview
  • FBA Inventory
    • getInventorySummaries
    • createInventoryItem
    • deleteInventoryItem
    • addInventory
  • Finances
    • listFinancialEventGroups
    • listFinancialEventsByGroupId
    • listFinancialEventsByOrderId
    • listFinancialEvents
  • Finances 2024-06-19
    • listTransactions
  • Fulfillment Inbound V0
    • createInboundShipmentPlan
    • createInboundShipment
    • updateInboundShipment
    • getPreorderInfo
    • confirmPreorder
    • getPrepInstructions
    • getTransportDetails
    • putTransportDetails
    • voidTransport
    • estimateTransport
    • confirmTransport
    • getLabels
    • getBillOfLading
    • getShipments
    • getShipmentItemsByShipmentId
    • getShipmentItems
  • Listings Items 2021-08-01
    • deleteListingsItem
      DELETE
    • getListingsItem
      GET
    • patchListingsItem
      PATCH
    • putListingsItem
      PUT
    • searchListingsItems
      GET
  • Listings Restrictions
    • getListingsRestrictions
  • Merchant Fulfillment
    • getEligibleShipmentServices
    • getShipment
    • cancelShipment
    • createShipment
    • getAdditionalSellerInputs
  • Messaging
    • getMessagingActionsForOrder
    • confirmCustomizationDetails
    • createConfirmDeliveryDetails
    • createLegalDisclosure
    • createNegativeFeedbackRemoval
    • createConfirmOrderDetails
    • createConfirmServiceDetails
    • CreateAmazonMotors
    • CreateWarranty
    • GetAttributes
    • createDigitalAccessKey
    • createUnexpectedProblem
    • sendInvoice
  • Product Fees
    • getMyFeesEstimateForSKU
    • getMyFeesEstimateForASIN
    • getMyFeesEstimates
  • Pricing V0
    • getPricing
    • getCompetitivePricing
    • getListingOffers
    • getItemOffers
    • getItemOffersBatch
    • getListingOffersBatch
  • Replenishment
    • getSellingPartnerMetrics
    • listOfferMetrics
    • listOffers
  • Sales
    • getOrderMetrics
  • Services
    • getServiceJobByServiceJobId
    • cancelServiceJobByServiceJobId
    • completeServiceJobByServiceJobId
    • getServiceJobs
    • addAppointmentForServiceJobByServiceJobId
    • rescheduleAppointmentForServiceJobByServiceJobId
    • assignAppointmentResources
    • setAppointmentFulfillmentData
    • getRangeSlotCapacity
    • getFixedSlotCapacity
    • updateSchedule
    • createReservation
    • updateReservation
    • cancelReservation
    • getAppointmmentSlotsByJobId
    • getAppointmentSlots
    • createServiceDocumentUploadDestination
  • Shipment Invoicing
    • getShipmentDetails
    • submitInvoice
    • getInvoiceStatus
  • Shipping
    • createShipment
    • getShipment
    • cancelShipment
    • purchaseLabels
    • retrieveShippingLabel
    • purchaseShipment
    • getRates
    • getAccount
    • getTrackingInformation
  • Amazon Shipping API V2
    • getRates
    • directPurchaseShipment
    • purchaseShipment
    • oneClickShipment
    • getTracking
    • getShipmentDocuments
    • cancelShipment
    • getAdditionalInputs
    • getCarrierAccountFormInputs
    • getCarrierAccounts
    • linkCarrierAccount
    • unlinkCarrierAccount
    • generateCollectionForm
    • getCollectionFormHistory
    • getUnmanifestedShipments
    • getCollectionForm
    • getAccessPoints
  • Solicitations
    • getSolicitationActionsForOrder
    • createProductReviewAndSellerFeedbackSolicitation
  • Supply Sources
    • getSupplySources
    • createSupplySource
    • getSupplySource
    • updateSupplySource
    • archiveSupplySource
    • updateSupplySourceStatus
  • Transfers. transfers_2024-06-01
    • initiatePayout
    • getPaymentMethods
  • Tokens
    • createRestrictedDataToken
  • Uploads
    • createUploadDestinationForResource
  • Invoices.
    • getInvoicesAttributes
    • getInvoicesDocument
    • createInvoicesExport
    • getInvoicesExports
    • getInvoicesExport
    • getInvoices
    • getInvoice
  • FBA inbound operations. 2024-03-20
    • listInboundPlans
    • createInboundPlan
    • getInboundPlan
    • listInboundPlanBoxes
    • cancelInboundPlan
    • listInboundPlanItems
    • updateInboundPlanName
    • listPackingGroupBoxes
    • listPackingGroupItems
    • setPackingInformation
    • listPackingOptions
    • generatePackingOptions
    • confirmPackingOption
    • listInboundPlanPallets
    • listPlacementOptions
    • generatePlacementOptions
    • confirmPlacementOption
    • getShipment
    • listShipmentBoxes
    • listShipmentContentUpdatePreviews
    • generateShipmentContentUpdatePreviews
    • getShipmentContentUpdatePreview
    • confirmShipmentContentUpdatePreview
    • getDeliveryChallanDocument
    • listDeliveryWindowOptions
    • generateDeliveryWindowOptions
    • confirmDeliveryWindowOptions
    • listShipmentItems
    • updateShipmentName
    • listShipmentPallets
    • cancelSelfShipAppointment
    • getSelfShipAppointmentSlots
    • generateSelfShipAppointmentSlots
    • scheduleSelfShipAppointment
    • updateShipmentSourceAddress
    • updateShipmentTrackingDetails
    • listTransportationOptions
    • generateTransportationOptions
    • confirmTransportationOptions
    • listItemComplianceDetails
    • updateItemComplianceDetails
    • createMarketplaceItemLabels
    • getInboundOperationStatus
  • Fulfillment Outbound
    • getFulfillmentPreview
    • deliveryOffers
    • listAllFulfillmentOrders
    • createFulfillmentOrder
    • getPackageTrackingDetails
    • listReturnReasonCodes
    • createFulfillmentReturn
    • getFulfillmentOrder
    • updateFulfillmentOrder
    • cancelFulfillmentOrder
    • submitFulfillmentOrderStatusUpdate
    • getFeatures
    • getFeatureInventory
    • getFeatureSKU
  • Feeds 2020-09-04
    • getFeeds
    • createFeed
    • getFeed
    • cancelFeed
    • createFeedDocument
    • getFeedDocument
  • Reports 2020-09-04
    • getReports
    • createReport
    • getReport
    • cancelReport
    • getReportSchedules
    • createReportSchedule
    • getReportSchedule
    • cancelReportSchedule
    • getReportDocument
  • Listings Items 2020-09-01
    • deleteListingsItem
    • patchListingsItem
    • putListingsItem
  • Application integrations.
    • createNotification
    • deleteNotifications
    • recordActionFeedback
  • Direct Fulfillment Inventory Updates
    • submitInventoryUpdate
  • Direct Fulfillment Orders V1
    • getOrders
    • getOrder
    • submitAcknowledgement
  • Direct Fulfillment Orders 2021-12-28
    • getOrders
    • getOrder
    • submitAcknowledgement
  • Direct Fulfillment Payments
    • submitInvoice
  • Vendor Direct Fulfillment Sandbox Test Data
    • generateOrderScenarios
    • getOrderScenarios
  • Direct Fulfillment Shipping V1
    • getShippingLabels
    • submitShippingLabelRequest
    • getShippingLabel
    • submitShipmentConfirmations
    • submitShipmentStatusUpdates
    • getCustomerInvoices
    • getCustomerInvoice
    • getPackingSlips
    • getPackingSlip
  • Direct Fulfillment Shipping 2021-12-28
    • getShippingLabels
    • submitShippingLabelRequest
    • getShippingLabel
    • createShippingLabels
    • submitShipmentConfirmations
    • submitShipmentStatusUpdates
    • getCustomerInvoices
    • getCustomerInvoice
    • getPackingSlips
    • getPackingSlip
  • Direct Fulfillment Transaction Status V1
    • getTransactionStatus
  • Direct Fulfillment Transaction Status 2021-12-28
    • getTransactionStatus
  • Retail Procurement Payments
    • submitInvoices
  • Retail Procurement Orders
    • getPurchaseOrders
    • getPurchaseOrder
    • submitAcknowledgement
    • getPurchaseOrdersStatus
  • Retail Procurement Shipments
    • SubmitShipmentConfirmations
    • SubmitShipments
    • GetShipmentDetails
  • Retail Procurement Transaction Status
    • getTransaction
  1. Listings Items 2021-08-01

getListingsItem

北美(North America)
https://sellingpartnerapi-na.amazon.com
北美(North America)
https://sellingpartnerapi-na.amazon.com
GET
https://sellingpartnerapi-na.amazon.com
/listings/2021-08-01/items/{sellerId}/{sku}
Listings Items 2021-08-01
返回有关销售伙伴列表项目的详细信息。
注意: 与此操作相关的参数可能包含必须编码的特殊字符,以成功调用API。为避免在编码URL时出现SKU错误,请参阅URL编码。
使用计划:
速率(每秒请求)暴发
510
x-amzn-RateLimit-Limit响应头返回请求操作应用的使用计划速率限制(如可用)。上表指示此操作的默认速率和暴发值。业务需求更高的销售伙伴可能会看到比这里所示更高的速率和暴发值。有关更多信息,请参阅销售伙伴API中的使用计划和速率限制。

请求参数

Path 参数
sellerId
string 
必需
卖家合作伙伴标识符,例如商户账户或供应商代码。
sku
string 
必需
一个销售伙伴提供的亚马逊列表标识符。
Query 参数
marketplaceIds
array[string]
必需
请求的以逗号分隔的亚马逊市场标识符列表。
<= 1 items
示例值:
ATVPDKIKX0DER
issueLocale
string 
可选
用于问题本地化的区域设置。当未提供时,使用第一个市场的默认语言代码。示例:en_US、fr_CA、fr_FR。当指定区域设置中没有可用的本地化时,本地化消息默认为 en_US。
示例值:
en_US
includedData
array[string]
可选
响应中包含的数据集的逗号分隔列表。默认:summaries。
枚举值:
summariesattributesissuesoffersfulfillmentAvailabilityprocurementrelationshipsproductTypes
默认值:
summaries
示例值:
summaries

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items//?marketplaceIds=ATVPDKIKX0DER'

返回响应

🟢200成功。
application/json
Body
亚马逊目录中的一件商品。
description
string 
交易中项目的描述
可选
relatedIdentifiers
array[object (ItemRelatedIdentifier) {2}] 
可选
与交易中项目相关的商业标识符。
itemRelatedIdentifierName
enum<string> 
可选
该项目的相关项目标识符名称的枚举集合。
枚举值:
ORDER_ADJUSTMENT_ITEM_IDCOUPON_IDREMOVAL_SHIPMENT_ITEM_IDTRANSACTION_ID
itemRelatedIdentifierValue
string 
可选
对应的项目相关标识符名称值
totalAmount
object (Currency) 
可选
一种货币类型和金额。
currencyCode
string 
可选
以ISO 4217格式表示的三位数字货币代码。
currencyAmount
number 
可选
具有 BigDecimal 结构类型的字段是带符号的小数(例如 CurrencyAmount)。
breakdowns
array[object (Breakdown) {3}] 
可选
财务交易中总金额计算细节的明细清单。
breakdownType
string 
收费类型。
可选
breakdownAmount
object (Currency) 
可选
一种货币类型和金额。
breakdowns
object (Breakdown) 
可选
细分提供了有关金融交易下资金流动的详细信息。细分进一步被分类为细分类型、细分金额,以及在层次结构中的进一步细分。
contexts
array[object (Context) {17}] 
可选
有关该项目的附加信息清单。
contextType
string 
必需
storeName
string 
可选
与交易相关的商店名称。
orderType
string 
交易的订单类型。
可选
channel
string 
可选
相关交易的渠道细节。
asin
string 
可选
亚马逊标准识别号码 (ASIN) 的商品。
sku
string 
可选
商品的库存单位(SKU)。
quantityShipped
integer <int32>
发货商品数量。
可选
fulfillmentNetwork
string 
该商品的履行网络。
可选
paymentType
string 
付款方式。
可选
paymentMethod
string 
付款方式已完成。
可选
paymentReference
string 
已支付的参考编号。
可选
paymentDate
string <date-time>
Date
可选
具有日期模式类型的字段采用 ISO 8601 日期时间格式(例如 GroupBeginDate)。
deferralReason
string 
可选
交易中适用的延期政策。
示例:'B2B','DD7'
maturityDate
string <date-time>
Date
可选
具有日期模式类型的字段采用 ISO 8601 日期时间格式(例如 GroupBeginDate)。
deferralStatus
string 
可选
交易状态。
示例:'冻结','释放'
startTime
string <date-time>
Date
可选
具有日期模式类型的字段采用 ISO 8601 日期时间格式(例如 GroupBeginDate)。
endTime
string <date-time>
Date
可选
具有日期模式类型的字段采用 ISO 8601 日期时间格式(例如 GroupBeginDate)。
示例
{
    "sku": "GM-ZDPI-9B4E",
    "summaries": [
        {
            "marketplaceId": "ATVPDKIKX0DER",
            "asin": "B071VG5N9D",
            "productType": "LUGGAGE",
            "conditionType": "new_new",
            "status": [
                "BUYABLE"
            ],
            "itemName": "Hardside Carry-On Spinner Suitcase Luggage",
            "createdDate": "2021-02-01T00:00:00Z",
            "lastUpdatedDate": "2021-03-01T00:00:00Z",
            "mainImage": {
                "link": "https://www.example.com/luggage.png",
                "height": 500,
                "width": 500
            }
        }
    ],
    "offers": [
        {
            "marketplaceId": "ATVPDKIKX0DER",
            "offerType": "B2C",
            "price": {
                "currencyCode": "USD",
                "amount": "100.00"
            },
            "audience": {
                "value": "ALL",
                "displayName": "Sell on Amazon"
            }
        }
    ],
    "fulfillmentAvailability": [
        {
            "fulfillmentChannelCode": "DEFAULT",
            "quantity": 100
        }
    ],
    "issues": [
        {
            "code": "90220",
            "message": "'size' is required but not supplied.",
            "severity": "ERROR",
            "attributeNames": [
                "size"
            ],
            "categories": [
                "MISSING_ATTRIBUTE"
            ]
        },
        {
            "code": "18027",
            "message": "We believe the main image has text, logo, graphic or watermark which is not permitted for this product type. Please submit a compliant image to lift the suppression. Also refer to Product image requirements.",
            "severity": "ERROR",
            "categories": [
                "INVALID_IMAGE"
            ],
            "enforcements": {
                "actions": [
                    {
                        "action": "SEARCH_SUPPRESSED"
                    }
                ],
                "exemption": {
                    "status": "EXEMPT_UNTIL_EXPIRY_DATE",
                    "expiryDate": "2025-05-28T00:36:48.914Z"
                }
            }
        },
        {
            "code": "99300",
            "message": "Product Detail Page Rules Violation (Inaccurate information on product detail page)",
            "severity": "ERROR",
            "categories": [],
            "enforcements": {
                "actions": [
                    {
                        "action": "ATTRIBUTE_SUPPRESSED"
                    }
                ],
                "exemption": {
                    "status": "EXEMPT"
                }
            }
        },
        {
            "code": "18155",
            "message": "The 'minimum price' is greater than the selling price (excluding shipping) for the listing. Please review and update your price and/or minimum price.",
            "severity": "ERROR",
            "categories": [
                "INVALID_PRICE"
            ],
            "enforcements": {
                "actions": [
                    {
                        "action": "LISTING_SUPPRESSED"
                    }
                ],
                "exemption": {
                    "status": "NOT_EXEMPT"
                }
            }
        },
        {
            "code": "18742",
            "message": "Restricted Products Policy Violation",
            "severity": "ERROR",
            "categories": [],
            "enforcements": {
                "actions": [
                    {
                        "action": "CATALOG_ITEM_REMOVED"
                    }
                ],
                "exemption": {
                    "status": "NOT_EXEMPT"
                }
            }
        }
    ]
}
🟠400请求缺少或无效的参数,无法解析。
🟠403表示禁止访问该资源。可能的原因包括访问被拒绝、未经授权、令牌过期或签名无效。
🟠404指定的资源不存在。
🟠413请求大小超过了最大接受大小。
🟠415请求负载格式不受支持。
🟠429请求的频率超过了允许的范围。
🔴500发生了意外情况,导致服务器无法完成请求。
🔴503服务器的临时超载或维护。

技术咨询扫码联系作者

SP-API技术咨询,开发者申请,Amazon ERP源码

扫码加入交流群
上一页
deleteListingsItem
下一页
patchListingsItem
Built with