Amazon SP API
  1. Research Docs
Amazon SP API
  • Overview
  • Authorization Workflow
  • Permissions
  • Sandbox
  • API Models
  • Available API Models
  • Request Apidog Access
  • OPENAPI SPECIFICATION
  • Research Docs
    • Amazon Seller Order Fulfillment Workflow
  • Amazon Warehousing and Distribution
    • getInboundShipment
      GET
    • listInboundShipments
      GET
    • listInventory
      GET
  • Authorization
    • Authorization
      POST
  • Catalog Items
    • searchCatalogItems
      GET
    • getCatalogItem
      GET
  • Catalog [Deprecated]
    • listCatalogItems
      GET
    • getCatalogItem
      GET
    • listCatalogCategories
      GET
  • Definitions
    • searchDefinitionsProductTypes
      GET
    • getDefinitionsProductType
      GET
  • Easy Ship
    • listHandoverSlots
      POST
    • getScheduledPackage
      GET
    • createScheduledPackage
      POST
    • updateScheduledPackages
      PATCH
    • createScheduledPackageBulk
      POST
  • FBAInbound
    • 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
    • listPrepDetails
    • setPrepDetails
    • getInboundOperationStatus
    • getItemEligibilityPreview
  • FBAInventory
    • getInventorySummaries
    • createInventoryItem
    • deleteInventoryItem
    • addInventory
  • FBAOutbound
    • getFulfillmentPreview
    • deliveryOffers
    • listAllFulfillmentOrders
    • createFulfillmentOrder
    • getPackageTrackingDetails
    • listReturnReasonCodes
    • createFulfillmentReturn
    • getFulfillmentOrder
    • updateFulfillmentOrder
    • cancelFulfillmentOrder
    • submitFulfillmentOrderStatusUpdate
    • getFeatures
    • getFeatureInventory
    • getFeatureSKU
  • Feeds
    • getFeeds
    • createFeed
    • cancelFeed
    • getFeed
    • createFeedDocument
    • getFeedDocument
  • Fees
    • getMyFeesEstimateForSKU
    • getMyFeesEstimateForASIN
    • getMyFeesEstimates
  • Finance
    • listTransactions
    • listFinancialEventGroups
    • listFinancialEventsByGroupId
    • listFinancialEventsByOrderId
    • listFinancialEvents
  • Invoices [Brazil]
    • getInvoicesAttributes
    • getInvoicesDocument
    • createInvoicesExport
    • getInvoicesExports
    • getInvoicesExport
    • getInvoices
    • getInvoice
  • Listings Items
    • getListingsRestrictions
    • deleteListingsItem
    • getListingsItem
    • patchListingsItem
    • putListingsItem
  • Merchant Fulfillment
    • getEligibleShipmentServices
    • getShipment
    • cancelShipment
    • createShipment
    • getAdditionalSellerInputs
  • Orders
    • getOrders
    • getOrder
    • getOrderBuyerInfo
    • getOrderAddress
    • getOrderItems
    • getOrderItemsBuyerInfo
    • updateShipmentStatus
    • getOrderRegulatedInfo
    • updateVerificationStatus
    • confirmShipment
  • ProductPricing
    • deprecated
      • getPricing
      • getCompetitivePricing
      • getListingOffers
      • getItemOffers
      • getItemOffersBatch
      • getListingOffersBatch
    • getFeaturedOfferExpectedPriceBatch
    • getCompetitiveSummary
  • Reports
    • getReports
    • createReport
    • cancelReport
    • getReport
    • getReportSchedules
    • createReportSchedule
    • cancelReportSchedule
    • getReportSchedule
    • getReportDocument
  • Sales
    • getOrderMetrics
  • Sellers
    • getMarketplaceParticipations
    • getAccount
  • Service
    • getServiceJobByServiceJobId
    • cancelServiceJobByServiceJobId
    • completeServiceJobByServiceJobId
    • getServiceJobs
    • addAppointmentForServiceJobByServiceJobId
    • rescheduleAppointmentForServiceJobByServiceJobId
    • assignAppointmentResources
    • setAppointmentFulfillmentData
    • getRangeSlotCapacity
    • getFixedSlotCapacity
    • updateSchedule
    • createReservation
    • updateReservation
    • cancelReservation
    • getAppointmmentSlotsByJobId
    • getAppointmentSlots
    • createServiceDocumentUploadDestination
  • ShipmentInvoice[Brazil]
    • getShipmentDetails
    • submitInvoice
    • getInvoiceStatus
  • Shipping
    • getRates
    • createShipment
    • directPurchaseShipment
    • getShipment
    • purchaseShipment
    • cancelShipment
    • oneClickShipment
    • purchaseLabels
    • getTracking
    • retrieveShippingLabel
    • getShipmentDocuments
    • purchaseShipment
    • cancelShipment
    • getRates
    • getAdditionalInputs
    • getAccount
    • getCarrierAccountFormInputs
    • getTrackingInformation
    • getCarrierAccounts
    • linkCarrierAccount
    • unlinkCarrierAccount
    • generateCollectionForm
    • getCollectionFormHistory
    • getUnmanifestedShipments
    • getCollectionForm
    • getAccessPoints
  • Supply Sources
    • getSupplySources
    • createSupplySource
    • getSupplySource
    • updateSupplySource
    • archiveSupplySource
    • updateSupplySourceStatus
  • Tokens
    • createRestrictedDataToken
  • Uploads
    • createUploadDestinationForResource
  • Notifications
    • getSubscription
    • createSubscription
    • getSubscriptionById
    • deleteSubscriptionById
    • getDestinations
    • createDestination
    • getDestination
    • deleteDestination
  1. Research Docs

Amazon Seller Order Fulfillment Workflow

Overview#

This guide provides a comprehensive workflow for processing and fulfilling orders on the Amazon Selling Partner platform, covering everything from order retrieval to customer notification.

1. Retrieve Order Details#

API: Orders API#

Purpose: Fetch comprehensive information about a customer's order
Key Endpoints:
getOrder
getOrderItems
Workflow Steps:
1.
Retrieve Order-Level Details
Capture Order ID
Collect buyer information
Verify order status (e.g., Unshipped, Pending)
2.
Get Order Item Information
Retrieve Product ASIN/SellerSKU
Confirm ordered quantity
Review pricing details
Example API Endpoint:

2. Inventory Availability Check#

API: FBA Inventory API or Custom Inventory Management System#

Purpose: Validate stock levels and order fulfillability
Key Considerations:
Verify inventory for each order item
Confirm sufficient stock levels
Inventory Validation Process:
1.
Check stock levels per SellerSKU or ASIN using getInventorySummaries
2.
Manage Low-Stock Scenarios:
Generate buyer notifications
Implement backorder procedures
Potentially cancel unavailable items

3. Fulfillment Method Determination#

Fulfillment Options#

1.
Merchant Fulfilled (MF)
Seller manages entire shipping process
Uses own logistics or Amazon Buy Shipping
2.
Fulfilled by Amazon (FBA)
Amazon handles complete shipping logistics
Inventory stored in Amazon's fulfillment centers
//TODO: Ignore this section(MF)

A. Merchant Fulfilled (MF) Workflow#

API: Merchant Fulfillment API#

Key Steps:
1.
Retrieve Shipping Services
Use getEligibleShipmentServices
Compare shipping options
Select optimal carrier/service
2.
Shipment Creation
Generate shipping label
Select carrier and shipping speed
Use createShipment endpoint
3.
Order Shipping
Apply generated shipping label
Obtain carrier tracking number

B. Fulfilled by Amazon (FBA) Workflow#

API: Fulfillment Outbound API#

Key Steps:
1.
Create Fulfillment Order
Use createFulfillmentOrder
Submit order details to Amazon
Request Amazon-managed shipping
2.
Fulfillment Tracking
Use getFulfillmentOrder
Monitor shipment status
Track order progress

4. Shipment Confirmation#

API: Orders API#

Endpoint: updateShipmentStatus
Required Information:
Order ID
Tracking number
Carrier name (for Merchant Fulfilled)

5. Order Status Update#

Workflow Stages#

1.
Partially Shipped
Some items shipped
Remaining items pending
2.
Fully Shipped
All order items dispatched
Ready for final closure

6. Customer Notification#

API: Messaging API#

Purpose: Proactive Customer Communication
Notification Contents:
Shipment confirmation
Tracking numbers
Estimated delivery dates

Comprehensive API Workflow Summary#

1.
Order Retrieval
Use Orders API to gather complete order details
2.
Inventory Validation
Confirm stock availability
Manage potential stock issues
3.
Fulfillment Execution
Merchant Fulfilled: Self-manage shipping
Amazon FBA: Leverage Amazon's logistics
4.
Shipment Confirmation
Update Amazon with shipping details
Provide tracking information
5.
Customer Communication
Send detailed shipping notifications
Maintain transparency
6.
Order Finalization
Update internal systems
Close order in Amazon's platform
Previous
OPENAPI SPECIFICATION
Next
getInboundShipment
Built with