Amazon Selling Partner API (SP-API)-中文
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
  1. FBA inbound operations. 2024-03-20
  • Orders
    • getOrders
    • getOrder
    • getOrderBuyerInfo
    • getOrderAddress
    • getOrderItems
    • getOrderItemsBuyerInfo
    • updateShipmentStatus
    • getOrderRegulatedInfo
    • updateVerificationStatus
    • confirmShipment
  • Reports 2021-06-30
    • getReports
    • createReport
    • cancelReport
    • getReport
    • getReportSchedules
    • createReportSchedule
    • cancelReportSchedule
    • getReportSchedule
    • getReportDocument
  • Feeds 2021-06-30
    • getFeeds
    • createFeed
    • cancelFeed
    • getFeed
    • createFeedDocument
    • getFeedDocument
  • 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
    • getListingsItem
    • patchListingsItem
    • putListingsItem
    • searchListingsItems
  • 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
      GET
    • createInboundPlan
      POST
    • getInboundPlan
      GET
    • listInboundPlanBoxes
      GET
    • cancelInboundPlan
      PUT
    • listInboundPlanItems
      GET
    • updateInboundPlanName
      PUT
    • listPackingGroupBoxes
      GET
    • listPackingGroupItems
      GET
    • setPackingInformation
      POST
    • listPackingOptions
      GET
    • generatePackingOptions
      POST
    • confirmPackingOption
      POST
    • listInboundPlanPallets
      GET
    • listPlacementOptions
      GET
    • generatePlacementOptions
      POST
    • confirmPlacementOption
      POST
    • getShipment
      GET
    • listShipmentBoxes
      GET
    • listShipmentContentUpdatePreviews
      GET
    • generateShipmentContentUpdatePreviews
      POST
    • getShipmentContentUpdatePreview
      GET
    • confirmShipmentContentUpdatePreview
      POST
    • getDeliveryChallanDocument
      GET
    • listDeliveryWindowOptions
      GET
    • generateDeliveryWindowOptions
      POST
    • confirmDeliveryWindowOptions
      POST
    • listShipmentItems
      GET
    • updateShipmentName
      PUT
    • listShipmentPallets
      GET
    • cancelSelfShipAppointment
      PUT
    • getSelfShipAppointmentSlots
      GET
    • generateSelfShipAppointmentSlots
      POST
    • scheduleSelfShipAppointment
      POST
    • updateShipmentSourceAddress
      PUT
    • updateShipmentTrackingDetails
      PUT
    • listTransportationOptions
      GET
    • generateTransportationOptions
      POST
    • confirmTransportationOptions
      POST
    • listItemComplianceDetails
      GET
    • updateItemComplianceDetails
      PUT
    • createMarketplaceItemLabels
      POST
    • getInboundOperationStatus
      GET
  • 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. FBA inbound operations. 2024-03-20

getShipment

北美(North America)
https://sellingpartnerapi-na.amazon.com
北美(North America)
https://sellingpartnerapi-na.amazon.com
GET
https://sellingpartnerapi-na.amazon.com
/inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}
FBA inbound operations. 2024-03-20
提供特定货物运输的完整详情,位于入境计划中。acceptedTransportationSelection 内的 transportationOptionId 可用于检索该货物运输的详细信息。
使用计划:
速率(每秒请求数)突发
26
响应头 x-amzn-RateLimit-Limit 返回请求操作所应用的使用计划速率限制(如适用)。上表指示该操作的默认速率和突发值。因业务需求而需要更高吞吐量的销售合作伙伴可能会看到比这里显示的更高的速率和突发值。有关更多信息,请参阅 销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Path 参数
inboundPlanId
string 
入境计划的标识符。
必需
>= 38 字符<= 38 字符
正则匹配:
^[a-zA-Z0-9-]*$
shipmentId
string 
必需
货物的识别码。货物包含正在入库的箱子和单位。
>= 38 字符<= 38 字符
正则匹配:
^[a-zA-Z0-9-]*$

示例代码

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/inbound/fba/2024-03-20/inboundPlans//shipments/'

返回响应

🟢200成功
application/json
获取货物 200 响应
Headers
x-amzn-RequestId
string 
可选
唯一请求参考标识符。
x-amzn-RateLimit-Limit
string 
可选
您对此操作的速率限制(每秒请求数量)。
Body
包含与入境计划中的货物运输相关的信息。
amazonReferenceId
string 
可选
由亚马逊创建的唯一标识符,用于识别此亚马逊合作的少于卡车负载/全车负载(LTL/FTL)货物。
>= 1 字符<= 1024 字符
contactInformation
object (ContactInformation) 
卖方的联系信息。
可选
示例值:
{"email":"email@email.com","name":"name","phoneNumber":"1234567890"}
email
string 
电子邮箱地址。
可选
>= 1 字符<= 1024 字符
name
string 
联系人的名字。
必需
>= 1 字符<= 50 字符
phoneNumber
string 
电话号码。
必需
>= 1 字符<= 20 字符
dates
object (Dates) 
可选
指定卖方预计发货的日期。
示例值:
{"readyToShipWindow":{"end":"2024-01-06T14:48:00.000Z","start":"2024-01-05T14:48:00.000Z"}}
readyToShipWindow
object (Window) 
可选
包含一个起始和结束的日期时间,表示一个时间范围。
示例值:
{"editableUntil":"2024-01-05T20:00:00.000Z","end":"2024-01-05T20:00:00.000Z","start":"2024-01-05T14:00:00.000Z"}
destination
object (ShipmentDestination) 
必需
亚马逊配送中心地址和仓库ID。
address
object (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"}
destinationType
string 
必需
此货物的目的地类型可以是:AMAZON_OPTIMIZED,AMAZON_WAREHOUSE。
>= 1 字符<= 1024 字符
warehouseId
string 
可选
应发送到的仓库。如果目的地类型是 AMAZON_OPTIMIZED,则为空。
>= 1 字符<= 1024 字符
freightInformation
object (FreightInformation) 
可选
货运信息描述了正在运输的SKU。只有在提供货运信息的情况下,运输承运选项和报价才会返回。
示例值:
{"declaredValue":{"amount":5.5,"code":"CAD"},"freightClass":"FC_50"}
declaredValue
object (Currency) 
货币定义。
可选
freightClass
string 
可选
货运等级。可以是:NONE、FC_50、FC_55、FC_60、FC_65、FC_70、FC_77_5、FC_85、FC_92_5、FC_100、FC_110、FC_125、FC_150、FC_175、FC_200、FC_250、FC_300、FC_400、FC_500。
>= 1 字符<= 1024 字符
name
string 
货物名称。
可选
placementOptionId
string 
必需
一个投放选项的标识符。投放选项表示SKU的发货拆分和目的地。
>= 38 字符<= 38 字符
正则匹配:
^[a-zA-Z0-9-]*$
selectedDeliveryWindow
object (SelectedDeliveryWindow) 
可选
选择的交付时间窗口属性。
示例值:
{"availabilityType":"AVAILABLE","deliveryWindowOptionId":"dw1234abcd-1234-abcd-5678-1234abcd5678","editableUntil":"2024-01-05T20:00:00.000Z","endDate":"2024-01-05T20:00:00.000Z","startDate":"2024-01-05T14:00:00.000Z"}
availabilityType
string 
必需
识别交付时间窗口的可用性类型。值:可用,拥堵
deliveryWindowOptionId
string 
必需
交付窗口选项的标识符。交付窗口选项代表预期交付货物的一个选项。
>= 36 字符<= 38 字符
正则匹配:
^[a-zA-Z0-9-]*$
editableUntil
string <date-time>
可选
此窗口无法再编辑的时间戳。
endDate
string <date-time>
窗口的结束时间戳。
必需
startDate
string <date-time>
窗口的开始时间戳。
必需
selectedTransportationOptionId
string 
可选
运输选项的标识符。运输选项代表了发送货物的一种选择。
>= 38 字符<= 38 字符
正则匹配:
^[a-zA-Z0-9-]*$
selfShipAppointmentDetails
array[object (SelfShipAppointmentDetails) {3}] 
可选
自助发货预约详情列表。
appointmentId
number 
预约标识符。
可选
appointmentSlotTime
object (AppointmentSlotTime) 
可选
预约时间段,包括开始和结束时间。
appointmentStatus
string 
预约状态。
可选
>= 1 字符<= 1024 字符
shipmentConfirmationId
string 
可选
确认的货物运输ID,显示在标签上(例如 FBA1234ABCD)。
>= 1 字符<= 1024 字符
shipmentId
string 
必需
货物的识别码。货物包含正在入库的箱子和单位。
>= 38 字符<= 38 字符
正则匹配:
^[a-zA-Z0-9-]*$
source
object (ShipmentSource) 
指定发货地址。
必需
address
object (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"}
sourceType
string 
必需
该货物的来源类型。可以是:SELLER_FACILITY。
>= 1 字符<= 1024 字符
status
string 
可选
货物的状态。货物的状态通常会从 WORKING 开始,并在所需操作完成后过渡到 READY_TO_SHIP,然后再被取走或发货。可以是 ABANDONED(已放弃)、CANCELLED(已取消)、CHECKED_IN(已登记)、CLOSED(已关闭)、DELETED(已删除)、DELIVERED(已交付)、IN_TRANSIT(运输中)、MIXED(混合状态)、READY_TO_SHIP(准备发货)、RECEIVING(接收中)、SHIPPED(已发货)或者 WORKING(正在处理)。
>= 1 字符<= 1024 字符
trackingDetails
object (TrackingDetails) 
可选
小于卡车装载量(LTL)和小件包裹配送(SPD)货物的追踪信息。
ltlTrackingDetail
object (LtlTrackingDetail) 
可选
包含与少于卡车装载(LTL)货物运输跟踪相关的信息。
spdTrackingDetail
object (SpdTrackingDetail) 
可选
包含与小包裹配送(SPD)货件追踪相关的信息。
示例
{
    "destination": {
        "destinationType": "AMAZON_OPTIMIZED"
    },
    "freightInformation": {
        "declaredValue": {
            "amount": 5.5,
            "code": "CAD"
        },
        "freightClass": "FC_50"
    },
    "inboundPlanId": "wf1234abcd-1234-abcd-5678-1234abcd5678",
    "placementOptionId": "pl1234abcd-1234-abcd-5678-1234abcd5678",
    "selectedDeliveryWindow": {
        "availabilityType": "AVAILABLE",
        "deliveryWindowOptionId": "dw1234abcd-1234-abcd-5678-1234abcd5678",
        "editableUntil": "2024-01-05T20:00:00.000Z",
        "endDate": "2024-01-05T20:00:00.000Z",
        "startDate": "2024-01-05T14:00:00.000Z"
    },
    "shipmentConfirmationId": "shipmentConfirmationId",
    "shipmentId": "sh1234abcd-1234-abcd-5678-1234abcd5678",
    "source": {
        "sourceType": "SELLER_FACILITY"
    }
}
🟠400请求有误
🟠403禁止访问
🟠404记录不存在
🟠413413
🟠415415
🟠429429
🔴500服务器错误
🔴503服务器故障

技术咨询扫码联系作者

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

扫码加入交流群
上一页
confirmPlacementOption
下一页
listShipmentBoxes
Built with