Amazon Selling Partner API (SP-API)-中文
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
  1. Retail Procurement Shipments
  • Auth Token
    • 获取Token
    • 刷新Token
    • 获取无授权Token
  • Api Reference
    • A+ Content Management
      • searchContentDocuments
      • createContentDocument
      • getContentDocument
      • updateContentDocument
      • listContentDocumentAsinRelations
      • postContentDocumentAsinRelations
      • validateContentDocumentAsinRelations
      • searchContentPublishRecords
      • postContentDocumentApprovalSubmission
      • postContentDocumentSuspendSubmission
    • Application Management
      • rotateApplicationClientSecret
    • AWD
      • getInboundShipment
      • listInboundShipments
      • listInventory
    • 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
    • Easy Ship
      • listHandoverSlots
      • getScheduledPackage
      • createScheduledPackage
      • updateScheduledPackages
      • createScheduledPackageBulk
    • FBA Inbound Eligibilty
      • getItemEligibilityPreview
    • FBA Inventory
      • getInventorySummaries
      • createInventoryItem
      • deleteInventoryItem
      • addInventory
    • Feeds 2020-09-04
      • getFeeds
      • createFeed
      • getFeed
      • cancelFeed
      • createFeedDocument
      • getFeedDocument
    • Feeds 2021-06-30
      • getFeeds
      • createFeed
      • cancelFeed
      • getFeed
      • createFeedDocument
      • getFeedDocument
    • 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
    • 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
    • Listings Items 2020-09-01
      • deleteListingsItem
      • patchListingsItem
      • putListingsItem
    • Listings Items 2021-08-01
      • searchListingsItems
      • deleteListingsItem
      • getListingsItem
      • patchListingsItem
      • putListingsItem
    • Listings Restrictions
      • getListingsRestrictions
    • Merchant Fulfillment
      • getEligibleShipmentServices
      • getShipment
      • cancelShipment
      • createShipment
      • getAdditionalSellerInputs
    • Messaging
      • getMessagingActionsForOrder
      • confirmCustomizationDetails
      • createConfirmDeliveryDetails
      • createLegalDisclosure
      • createNegativeFeedbackRemoval
      • createConfirmOrderDetails
      • createConfirmServiceDetails
      • CreateAmazonMotors
      • CreateWarranty
      • GetAttributes
      • createDigitalAccessKey
      • createUnexpectedProblem
      • sendInvoice
    • Notifications
      • getSubscription
      • createSubscription
      • getSubscriptionById
      • deleteSubscriptionById
      • getDestinations
      • createDestination
      • getDestination
      • deleteDestination
    • Orders
      • getOrders
      • getOrder
      • getOrderBuyerInfo
      • getOrderAddress
      • getOrderItems
      • getOrderItemsBuyerInfo
      • updateShipmentStatus
      • getOrderRegulatedInfo
      • updateVerificationStatus
      • confirmShipment
    • Product Fees
      • getMyFeesEstimateForSKU
      • getMyFeesEstimateForASIN
      • getMyFeesEstimates
    • Pricing V0
      • getPricing
      • getCompetitivePricing
      • getListingOffers
      • getItemOffers
      • getItemOffersBatch
      • getListingOffersBatch
    • Pricing 2022-05-01
      • getFeaturedOfferExpectedPriceBatch
      • getCompetitiveSummary
    • Replenishment
      • getSellingPartnerMetrics
      • listOfferMetrics
      • listOffers
    • Reports 2020-09-04
      • getReports
      • createReport
      • getReport
      • cancelReport
      • getReportSchedules
      • createReportSchedule
      • getReportSchedule
      • cancelReportSchedule
      • getReportDocument
    • Reports 2021-06-30
      • getReports
      • createReport
      • cancelReport
      • getReport
      • getReportSchedules
      • createReportSchedule
      • cancelReportSchedule
      • getReportSchedule
      • getReportDocument
    • Sales
      • getOrderMetrics
    • Sellers
      • getAccount
      • getMarketplaceParticipations
    • 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
    • Invoices.
      • getInvoicesAttributes
      • getInvoicesDocument
      • createInvoicesExport
      • getInvoicesExports
      • getInvoicesExport
      • getInvoices
      • getInvoice
    • Tokens
      • createRestrictedDataToken
    • Automotive.
      • getVehicles
    • Uploads
      • createUploadDestinationForResource
    • third party 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
        POST
      • SubmitShipments
        POST
      • GetShipmentDetails
        GET
    • Retail Procurement Transaction Status
      • getTransaction
    • Transfers. transfers_2024-06-01
      • initiatePayout
      • getPaymentMethods
  1. Retail Procurement Shipments

GetShipmentDetails

北美(North America)
https://sellingpartnerapi-na.amazon.com
北美(North America)
https://sellingpartnerapi-na.amazon.com
GET
https://sellingpartnerapi-na.amazon.com
/vendor/shipping/v1/shipments
返回与运输相关的详细信息,包括运输的详细信息、承运人的详细信息、运输状态、集装箱详细信息以及根据您指定的过滤参数值的其他相关详细信息。
使用计划:
速率(每秒请求)突发
1010
x-amzn-RateLimit-Limit 响应头返回应用于请求操作的使用计划速率限制(如果可用)。上述表格指示此操作的默认速率和突发值。业务需求需要更高吞吐量的销售合作伙伴可能会看到比此处显示的更高的速率和突发值。有关更多信息,请参见 销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Query 参数

示例代码

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/vendor/shipping/v1/shipments'

返回响应

🟢200成功
application/json
成功。
Headers

Body

示例
{
    "payload": {
        "pagination": {
            "nextToken": "MDAwMDAwMDAwMQ=="
        },
        "shipments": [
            {
                "vendorShipmentIdentifier": "00050003",
                "buyerReferenceNumber": "1234567",
                "currentShipmentStatus": "CarrierAssigned",
                "currentshipmentStatusDate": "2019-08-09T19:56:45.632",
                "shipmentStatusDetails": [
                    {
                        "shipmentStatus": "CarrierAssigned",
                        "shipmentStatusDate": "2019-08-09T19:56:45.632"
                    },
                    {
                        "shipmentStatus": "TransportationRequested",
                        "shipmentStatusDate": "2019-07-07T19:56:45.632"
                    },
                    {
                        "shipmentStatus": "Created",
                        "shipmentStatusDate": "2019-07-06T19:56:45.632"
                    }
                ],
                "shipmentCreateDate": "2019-07-07T19:56:45.632",
                "shipmentConfirmDate": "2019-08-07T19:56:45.632",
                "packageLabelCreateDate": "2019-08-07T19:56:45.632",
                "shipmentFreightTerm": "Collect",
                "sellingParty": {
                    "partyId": "998US"
                },
                "shipFromParty": {
                    "address": {
                        "name": "ABC electronics warehouse",
                        "addressLine1": "DEF 1st street",
                        "city": "Lisses",
                        "stateOrRegion": "abcland",
                        "postalCode": "91090",
                        "countryCode": "DE"
                    },
                    "partyId": "ABCD12"
                },
                "shipToParty": {
                    "partyId": "999US"
                },
                "shipmentMeasurements": {
                    "totalCartonCount": 30,
                    "totalPalletStackable": 30,
                    "totalPalletNonStackable": 30,
                    "shipmentWeight": {
                        "unitOfMeasure": "Kg",
                        "value": "120.45"
                    },
                    "shipmentVolume": {
                        "unitOfMeasure": "CuFt",
                        "value": "2.4"
                    }
                },
                "collectFreightPickupDetails": {
                    "requestedPickUp": "2019-08-07T19:56:45.632",
                    "scheduledPickUp": "2019-08-07T19:56:45.632",
                    "carrierAssignmentDate": "2019-08-07T19:56:45.632"
                },
                "purchaseOrders": [
                    {
                        "purchaseOrderNumber": "1BBBAAAA",
                        "purchaseOrderDate": "2019-08-06T19:56:45.632",
                        "shipWindow": "08/25/2021 - 08/31/2021",
                        "items": [
                            {
                                "itemSequenceNumber": "001",
                                "vendorProductIdentifier": "9782700001659",
                                "buyerProductIdentifier": "9782700001690",
                                "shippedQuantity": {
                                    "amount": 100,
                                    "unitOfMeasure": "Eaches",
                                    "unitSize": 1
                                },
                                "maximumRetailPrice": {
                                    "currencyCode": "USD",
                                    "amount": "12345"
                                }
                            }
                        ]
                    }
                ],
                "importDetails": {
                    "methodOfPayment": "PaidByBuyer",
                    "sealNumber": "1232142132",
                    "route": {
                        "stops": [
                            {
                                "functionCode": "PortOfDischarge",
                                "locationIdentification": {
                                    "type": "string",
                                    "locationCode": "string",
                                    "countryCode": "US"
                                },
                                "arrivalTime": "2021-07-12T22:22:25.038Z",
                                "departureTime": "2021-07-12T22:22:25.038Z"
                            }
                        ]
                    },
                    "importContainers": "string",
                    "billableWeight": {
                        "unitOfMeasure": "G",
                        "value": "10"
                    },
                    "estimatedShipByDate": "2021-07-12T22:22:25.038Z",
                    "handlingInstructions": "Oversized"
                },
                "containers": [
                    {
                        "containerType": "carton",
                        "containerSequenceNumber": "001",
                        "containerIdentifiers": [
                            {
                                "containerIdentificationType": "SSCC",
                                "containerIdentificationNumber": "213124134213"
                            }
                        ],
                        "trackingNumber": "XXXX",
                        "dimensions": {
                            "length": "12",
                            "width": "12",
                            "height": "12",
                            "unitOfMeasure": "IN"
                        },
                        "weight": {
                            "unitOfMeasure": "KG",
                            "value": "10"
                        },
                        "packedItems": [
                            {
                                "itemSequenceNumber": "001",
                                "buyerProductIdentifier": "B07DFVDRAA",
                                "vendorProductIdentifier": "12312412421",
                                "packedQuantity": {
                                    "amount": 1,
                                    "unitOfMeasure": "Each"
                                },
                                "itemDetails": {
                                    "purchaseOrderNumber": "string",
                                    "lotNumber": "string",
                                    "expiry": {
                                        "manufacturerDate": "2021-07-12T22:22:25.038Z",
                                        "expiryDate": "2021-07-12T22:22:25.038Z",
                                        "expiryAfterDuration": {
                                            "durationUnit": "Days",
                                            "durationValue": 0
                                        }
                                    }
                                }
                            },
                            {
                                "containerType": "pallet",
                                "containerSequenceNumber": "002",
                                "containerIdentifiers": [
                                    {
                                        "containerIdentificationType": "SSCC",
                                        "containerIdentificationNumber": "ARK123214214213"
                                    }
                                ],
                                "trackingNumber": "TRACK001",
                                "dimensions": {
                                    "length": "12",
                                    "width": "12",
                                    "height": "12",
                                    "unitOfMeasure": "IN"
                                },
                                "weight": {
                                    "unitOfMeasure": "KG",
                                    "value": "10"
                                },
                                "tier": 2,
                                "block": 2,
                                "innerContainersDetails": {
                                    "containerCount": 10,
                                    "containerSequenceNumbers": [
                                        {
                                            "containerSequenceNumber": "002"
                                        },
                                        {
                                            "containerSequenceNumber": "003"
                                        }
                                    ]
                                },
                                "packedItems": [
                                    {
                                        "itemSequenceNumber": "001",
                                        "buyerProductIdentifier": "B07DFVDRAA",
                                        "vendorProductIdentifier": "12312412421",
                                        "packedQuantity": {
                                            "amount": 1,
                                            "unitOfMeasure": "Each"
                                        },
                                        "itemDetails": {
                                            "purchaseOrderNumber": "string",
                                            "lotNumber": "string",
                                            "expiry": {
                                                "manufacturerDate": "2021-07-12T22:22:25.038Z",
                                                "expiryDate": "2021-07-12T22:22:25.038Z",
                                                "expiryAfterDuration": {
                                                    "durationUnit": "Days",
                                                    "durationValue": 0
                                                }
                                            }
                                        }
                                    }
                                ]
                            }
                        ]
                    }
                ],
                "transportationDetails": {
                    "shipMode": "LessThanTruckLoad",
                    "transportationMode": "Road",
                    "shippedDate": "2019-08-07T19:56:45.632",
                    "estimatedDeliveryDate": "2019-08-07T19:56:45.632",
                    "shipmentDeliveryDate": "2019-08-07T19:56:45.632",
                    "carrierDetails": {
                        "name": "UPS",
                        "phone": "1234567890",
                        "email": "abc@xyz.com",
                        "code": "string",
                        "shipmentReferenceNumber": "TRACK001"
                    },
                    "billOfLadingNumber": "string"
                }
            }
        ]
    }
}
🟠400请求有误
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
🟠415415
🟠429429
🔴500服务器错误
🔴503服务器故障

技术咨询扫码联系作者

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

扫码加入交流群
修改于 2025-06-15 14:55:41
上一页
SubmitShipments
下一页
getTransaction
Built with