- Auth Token
- Api Reference
- A+ Content Management
- Application Management
- AWD
- Catalog Items 2020-12-01
- Catalog Items 2022-04-01
- Data Kiosk
- Product Type Definitions
- Easy Ship
- FBA Inbound Eligibilty
- FBA Inventory
- Feeds 2020-09-04
- Feeds 2021-06-30
- Finances
- Finances 2024-06-19
- Fulfillment Inbound V0
- 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
- Listings Items 2020-09-01
- Listings Items 2021-08-01
- Listings Restrictions
- Merchant Fulfillment
- Messaging
- Notifications
- Orders
- Product Fees
- Pricing V0
- Pricing 2022-05-01
- Replenishment
- Reports 2020-09-04
- Reports 2021-06-30
- Sales
- Sellers
- Services
- getServiceJobByServiceJobId
- cancelServiceJobByServiceJobId
- completeServiceJobByServiceJobId
- getServiceJobs
- addAppointmentForServiceJobByServiceJobId
- rescheduleAppointmentForServiceJobByServiceJobId
- assignAppointmentResources
- setAppointmentFulfillmentData
- getRangeSlotCapacity
- getFixedSlotCapacity
- updateSchedule
- createReservation
- updateReservation
- cancelReservation
- getAppointmmentSlotsByJobId
- getAppointmentSlots
- createServiceDocumentUploadDestination
- Shipment Invoicing
- Shipping
- Amazon Shipping API V2
- getRates
- directPurchaseShipment
- purchaseShipment
- oneClickShipment
- getTracking
- getShipmentDocuments
- cancelShipment
- getAdditionalInputs
- getCarrierAccountFormInputs
- getCarrierAccounts
- linkCarrierAccount
- unlinkCarrierAccount
- generateCollectionForm
- getCollectionFormHistory
- getUnmanifestedShipments
- getCollectionForm
- getAccessPoints
- Solicitations
- Supply Sources
- Invoices.
- Tokens
- Automotive.
- Uploads
- third party application integrations.
- Direct Fulfillment Inventory Updates
- Direct Fulfillment Orders V1
- Direct Fulfillment Orders 2021-12-28
- Direct Fulfillment Payments
- Vendor Direct Fulfillment Sandbox Test Data
- Direct Fulfillment Shipping V1
- Direct Fulfillment Shipping 2021-12-28
- Direct Fulfillment Transaction Status V1
- Direct Fulfillment Transaction Status 2021-12-28
- Retail Procurement Payments
- Retail Procurement Orders
- Retail Procurement Shipments
- Retail Procurement Transaction Status
- Transfers. transfers_2024-06-01
createShipment
北美(North America）
https://sellingpartnerapi-na.amazon.com
北美(North America）
https://sellingpartnerapi-na.amazon.com
POST
https://sellingpartnerapi-na.amazon.com
| 速率（每秒请求） | 突发 |
|---|---|
| 1 | 1 |
x-amzn-RateLimit-Limit 响应头返回已应用于请求操作的使用计划速率限制（如果可用）。上表指出了此操作的默认速率和突发值。业务需求需要更高吞吐量的销售合作伙伴可能会看到比这里显示的更高的速率和突发值。有关更多信息，请参见 销售伙伴 API 中的使用计划和速率限制。请求参数
Body 参数application/json
示例
{
"ShipmentRequestDetails": {
"AmazonOrderId": "string",
"SellerOrderId": "string",
"ItemList": [
{
"OrderItemId": "string",
"Quantity": 0,
"ItemWeight": {
"Value": 0,
"Unit": "oz"
},
"ItemDescription": "string",
"TransparencyCodeList": [
"string"
],
"ItemLevelSellerInputsList": [
{
"AdditionalInputFieldName": "string",
"AdditionalSellerInput": {
"DataType": "string",
"ValueAsString": "string",
"ValueAsBoolean": true,
"ValueAsInteger": 0,
"ValueAsTimestamp": "2019-08-24T14:15:22Z",
"ValueAsAddress": {
"Name": "string",
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"DistrictOrCounty": "string",
"Email": "string",
"City": "string",
"StateOrProvinceCode": "string",
"PostalCode": "string",
"CountryCode": "string",
"Phone": "string"
},
"ValueAsWeight": {
"Value": 0,
"Unit": "oz"
},
"ValueAsDimension": {
"value": 0,
"unit": "inches"
},
"ValueAsCurrency": {
"CurrencyCode": "str",
"Amount": 0
}
}
}
],
"LiquidVolume": {
"Unit": "ML",
"Value": 0
},
"IsHazmat": true,
"DangerousGoodsDetails": {
"UnitedNationsRegulatoryId": "string",
"TransportationRegulatoryClass": "string",
"PackingGroup": "I",
"PackingInstruction": "PI965_SECTION_IA"
}
}
],
"ShipFromAddress": {
"Name": "string",
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"DistrictOrCounty": "string",
"Email": "string",
"City": "string",
"StateOrProvinceCode": "string",
"PostalCode": "string",
"CountryCode": "string",
"Phone": "string"
},
"PackageDimensions": {
"Length": 0,
"Width": 0,
"Height": 0,
"Unit": "inches",
"PredefinedPackageDimensions": "FedEx_Box_10kg"
},
"Weight": {
"Value": 0,
"Unit": "oz"
},
"MustArriveByDate": "2019-08-24T14:15:22Z",
"ShipDate": "2019-08-24T14:15:22Z",
"ShippingServiceOptions": {
"DeliveryExperience": "DeliveryConfirmationWithAdultSignature",
"DeclaredValue": {
"CurrencyCode": "str",
"Amount": 0
},
"CarrierWillPickUp": true,
"CarrierWillPickUpOption": "CarrierWillPickUp",
"LabelFormat": "PDF"
},
"LabelCustomization": {
"CustomTextForLabel": "string",
"StandardIdForLabel": "AmazonOrderId"
}
},
"ShippingServiceId": "string",
"ShippingServiceOfferId": "string",
"HazmatType": "None",
"LabelFormatOption": {
"IncludePackingSlipWithLabel": true
},
"ShipmentLevelSellerInputsList": [
{
"AdditionalInputFieldName": "string",
"AdditionalSellerInput": {
"DataType": "string",
"ValueAsString": "string",
"ValueAsBoolean": true,
"ValueAsInteger": 0,
"ValueAsTimestamp": "2019-08-24T14:15:22Z",
"ValueAsAddress": {
"Name": "string",
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"DistrictOrCounty": "string",
"Email": "string",
"City": "string",
"StateOrProvinceCode": "string",
"PostalCode": "string",
"CountryCode": "string",
"Phone": "string"
},
"ValueAsWeight": {
"Value": 0,
"Unit": "oz"
},
"ValueAsDimension": {
"value": 0,
"unit": "inches"
},
"ValueAsCurrency": {
"CurrencyCode": "str",
"Amount": 0
}
}
}
]
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/mfn/v0/shipments' \
--header 'Content-Type: application/json' \
--data-raw '{
"ShipmentRequestDetails": {
"AmazonOrderId": "string",
"SellerOrderId": "string",
"ItemList": [
{
"OrderItemId": "string",
"Quantity": 0,
"ItemWeight": {
"Value": 0,
"Unit": "oz"
},
"ItemDescription": "string",
"TransparencyCodeList": [
"string"
],
"ItemLevelSellerInputsList": [
{
"AdditionalInputFieldName": "string",
"AdditionalSellerInput": {
"DataType": "string",
"ValueAsString": "string",
"ValueAsBoolean": true,
"ValueAsInteger": 0,
"ValueAsTimestamp": "2019-08-24T14:15:22Z",
"ValueAsAddress": {
"Name": "string",
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"DistrictOrCounty": "string",
"Email": "string",
"City": "string",
"StateOrProvinceCode": "string",
"PostalCode": "string",
"CountryCode": "string",
"Phone": "string"
},
"ValueAsWeight": {
"Value": 0,
"Unit": "oz"
},
"ValueAsDimension": {
"value": 0,
"unit": "inches"
},
"ValueAsCurrency": {
"CurrencyCode": "str",
"Amount": 0
}
}
}
],
"LiquidVolume": {
"Unit": "ML",
"Value": 0
},
"IsHazmat": true,
"DangerousGoodsDetails": {
"UnitedNationsRegulatoryId": "string",
"TransportationRegulatoryClass": "string",
"PackingGroup": "I",
"PackingInstruction": "PI965_SECTION_IA"
}
}
],
"ShipFromAddress": {
"Name": "string",
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"DistrictOrCounty": "string",
"Email": "string",
"City": "string",
"StateOrProvinceCode": "string",
"PostalCode": "string",
"CountryCode": "string",
"Phone": "string"
},
"PackageDimensions": {
"Length": 0,
"Width": 0,
"Height": 0,
"Unit": "inches",
"PredefinedPackageDimensions": "FedEx_Box_10kg"
},
"Weight": {
"Value": 0,
"Unit": "oz"
},
"MustArriveByDate": "2019-08-24T14:15:22Z",
"ShipDate": "2019-08-24T14:15:22Z",
"ShippingServiceOptions": {
"DeliveryExperience": "DeliveryConfirmationWithAdultSignature",
"DeclaredValue": {
"CurrencyCode": "str",
"Amount": 0
},
"CarrierWillPickUp": true,
"CarrierWillPickUpOption": "CarrierWillPickUp",
"LabelFormat": "PDF"
},
"LabelCustomization": {
"CustomTextForLabel": "string",
"StandardIdForLabel": "AmazonOrderId"
}
},
"ShippingServiceId": "string",
"ShippingServiceOfferId": "string",
"HazmatType": "None",
"LabelFormatOption": {
"IncludePackingSlipWithLabel": true
},
"ShipmentLevelSellerInputsList": [
{
"AdditionalInputFieldName": "string",
"AdditionalSellerInput": {
"DataType": "string",
"ValueAsString": "string",
"ValueAsBoolean": true,
"ValueAsInteger": 0,
"ValueAsTimestamp": "2019-08-24T14:15:22Z",
"ValueAsAddress": {
"Name": "string",
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"DistrictOrCounty": "string",
"Email": "string",
"City": "string",
"StateOrProvinceCode": "string",
"PostalCode": "string",
"CountryCode": "string",
"Phone": "string"
},
"ValueAsWeight": {
"Value": 0,
"Unit": "oz"
},
"ValueAsDimension": {
"value": 0,
"unit": "inches"
},
"ValueAsCurrency": {
"CurrencyCode": "str",
"Amount": 0
}
}
}
]
}'返回响应
🟢200成功
application/json
Headers
Body
示例
{
"payload": {
"ShipmentId": "string",
"AmazonOrderId": "string",
"SellerOrderId": "string",
"ItemList": [
{
"OrderItemId": "string",
"Quantity": 0,
"ItemWeight": {
"Value": 0,
"Unit": "oz"
},
"ItemDescription": "string",
"TransparencyCodeList": [
"string"
],
"ItemLevelSellerInputsList": [
{
"AdditionalInputFieldName": "string",
"AdditionalSellerInput": {
"DataType": "string",
"ValueAsString": "string",
"ValueAsBoolean": true,
"ValueAsInteger": 0,
"ValueAsTimestamp": "2019-08-24T14:15:22Z",
"ValueAsAddress": {
"Name": "string",
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"DistrictOrCounty": "string",
"Email": "string",
"City": "string",
"StateOrProvinceCode": "string",
"PostalCode": "string",
"CountryCode": "string",
"Phone": "string"
},
"ValueAsWeight": {
"Value": 0,
"Unit": "oz"
},
"ValueAsDimension": {
"value": 0,
"unit": "inches"
},
"ValueAsCurrency": {
"CurrencyCode": "str",
"Amount": 0
}
}
}
],
"LiquidVolume": {
"Unit": "ML",
"Value": 0
},
"IsHazmat": true,
"DangerousGoodsDetails": {
"UnitedNationsRegulatoryId": "string",
"TransportationRegulatoryClass": "string",
"PackingGroup": "I",
"PackingInstruction": "PI965_SECTION_IA"
}
}
],
"ShipFromAddress": {
"Name": "string",
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"DistrictOrCounty": "string",
"Email": "string",
"City": "string",
"StateOrProvinceCode": "string",
"PostalCode": "string",
"CountryCode": "string",
"Phone": "string"
},
"ShipToAddress": {
"Name": "string",
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"DistrictOrCounty": "string",
"Email": "string",
"City": "string",
"StateOrProvinceCode": "string",
"PostalCode": "string",
"CountryCode": "string",
"Phone": "string"
},
"PackageDimensions": {
"Length": 0,
"Width": 0,
"Height": 0,
"Unit": "inches",
"PredefinedPackageDimensions": "FedEx_Box_10kg"
},
"Weight": {
"Value": 0,
"Unit": "oz"
},
"Insurance": {
"CurrencyCode": "str",
"Amount": 0
},
"ShippingService": {
"ShippingServiceName": "string",
"CarrierName": "string",
"ShippingServiceId": "string",
"ShippingServiceOfferId": "string",
"ShipDate": "2019-08-24T14:15:22Z",
"EarliestEstimatedDeliveryDate": "2019-08-24T14:15:22Z",
"LatestEstimatedDeliveryDate": "2019-08-24T14:15:22Z",
"Rate": {
"CurrencyCode": "str",
"Amount": 0
},
"ShippingServiceOptions": {
"DeliveryExperience": "DeliveryConfirmationWithAdultSignature",
"DeclaredValue": {
"CurrencyCode": "str",
"Amount": 0
},
"CarrierWillPickUp": true,
"CarrierWillPickUpOption": "CarrierWillPickUp",
"LabelFormat": "PDF"
},
"AvailableShippingServiceOptions": {
"AvailableCarrierWillPickUpOptions": [
{
"CarrierWillPickUpOption": "CarrierWillPickUp",
"Charge": {
"CurrencyCode": "str",
"Amount": 0
}
}
],
"AvailableDeliveryExperienceOptions": [
{
"DeliveryExperienceOption": "DeliveryConfirmationWithAdultSignature",
"Charge": {
"CurrencyCode": "str",
"Amount": 0
}
}
]
},
"AvailableLabelFormats": [
"PDF"
],
"AvailableFormatOptionsForLabel": [
{
"IncludePackingSlipWithLabel": true,
"LabelFormat": "PDF"
}
],
"RequiresAdditionalSellerInputs": true,
"Benefits": {
"IncludedBenefits": [
"string"
],
"ExcludedBenefits": [
{
"Benefit": "string",
"ReasonCodes": [
"string"
]
}
]
}
},
"Label": {
"CustomTextForLabel": "string",
"Dimensions": {
"Length": 0,
"Width": 0,
"Unit": "inches"
},
"FileContents": {
"Contents": "string",
"FileType": "application/pdf",
"Checksum": "string"
},
"LabelFormat": "PDF",
"StandardIdForLabel": "AmazonOrderId"
},
"Status": "Purchased",
"TrackingId": "string",
"CreatedDate": "2019-08-24T14:15:22Z",
"LastUpdatedDate": "2019-08-24T14:15:22Z"
},
"errors": [
{
"code": "string",
"message": "string",
"details": "string"
}
]
}🟠400请求有误
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
🟠429429
🔴500服务器错误
🔴503服务器故障
技术咨询扫码联系作者
SP-API技术咨询，开发者申请，Amazon ERP源码
扫码加入交流群修改于 2025-06-15 14:54:41