- Introduction
- Authentication
- Throttling
- Error Handling
- Swagger Documentation
- Amazon SP-API Marketplace IDs
- Amazon Marketplace Categories
- Products
- UPC-EAN-ASIN converters
- Restrictions
- Sales Estimation
- Keepa
- FBA Inbound Shipments
- Listings Items
- SP-API FBA Shipments
- Get old shipments
- Get old shipment items
- Get old shipment items by old shipment id
- List inbound plans
- Get inbound plan
- List inbound plan boxes
- List placement options
- List transportation options
- Get shipment
- List shipment items
- List shipment boxes
- List packing options
- List packing group boxes
- List packing group items
- SP-API FBA Inventory
- SP-API Catalog Items
- SP-API Listings Items
- SP-API Product Type Definitions
- SP-API Product Pricing
- Documents (Beta)
- List the documents of the team
- Upload a document and hang it on a purchase order or on a supplier
- Delete several documents
- Get one document
- Delete a document
- Set the type of a document, or turn its import offer off
- Get a link that reads the file
- Read what the parser found in an invoice
- Write the confirmed invoice lines into the purchase order
- Account (Beta)
- Notes (Beta)
- Price List Analyzer
- SA Inventory Product History (Beta)
- SA Inventory Products (Beta)
- List the values the filters of the product list accept
- Autocomplete products from multiple sources for internal product creation
- Create internal product
- List the products of the team
- Delete several products
- Get internal product
- Create or update product supplier offer
- Delete one product
- Delete product supplier offer
- Update internal product
- List external product identifiers
- List product supplier offers
- Set the matches of one product
- Remove some matches of one product
- SA Inventory Listings (Beta)
- SA Inventory Purchase Orders (Beta)
- List the purchase orders of the teamGET
- Create a purchase orderPOST
- Delete several purchase ordersDELETE
- Get one purchase orderGET
- Delete one purchase orderDELETE
- Change a purchase orderPATCH
- List the items of one purchase orderGET
- Add items to a purchase orderPOST
- Search the items of every purchase order of the teamGET
- Delete several items of purchase ordersDELETE
- Delete one purchase order itemDELETE
- Change one item of a purchase orderPATCH
- List the purchase orders of the team
- SA Inventory SKUs (Beta)
- SA Inventory Suppliers (Beta)
- SA Inventory Warehouses (Beta)
- SA Repricer (Beta)
- Get repricer history for a product (all repricing runs)
- Get aggregate repricer history statistics for the team
- Reset the team's repricer settings to global defaults
- Get an overview context for repricing, including team settings, allowed marketplaces, and usage limits
- Update the global repricer settings for the current team
- Get the current team's global repricer settings
- List the values the filters of the repricer list accept
- Remove one product from the repricer or several
- Update one repricer product or several
- List all repricing strategies for the current team
- Get a paginated list of repricer products for the current team
- Create a new repricing strategy
- Create a new repricer product
- Delete several strategies
- Get a single repricing strategy by ID
- Delete a repricing strategy
- Get a single repricer product by ID
- Update a repricing strategy
- Delete one repricer product
- Assign a strategy to products
- Update one repricer product
- Run repricing for a single product
- Tags (Beta)
- Profitability
- Schemas
- Schemas
- BadRequestApiError
- ConvertToASINResponseItem
- AccessDeniedApiError
- PaymentRequiredApiError
- ConvertToASINResponse
- ResourceNotFoundApiError
- ConvertToASINInternalApiError
- TooManyRequestsApiError
- GetProductIdentifiersResponseItem
- GetProductIdentifiersResponse
- GetProductIdentifiersInternalApiError
- ListPlanShipmentsResponse
- Document
- ListPlanShipmentsInternalApiError
- ProductNotFoundApiError
- GetShipmentFeesResponse
- GetShipmentFeesInternalApiError
- KeepaProductStats
- KeepaProductCsv
- KeepaProductOffer
- KeepaProduct
- GetKeepaProductInternalApiError
- SearchKeepaProductsResponse
- SearchKeepaProductsInternalApiError
- QueryKeepaProductsResponse
- SearchInsightsObject
- QueryKeepaProductsInternalApiError
- PutListingsItemRequest
- PutListingsItemInternalApiError
- Currency
- Product
- Quota
- ProductBsr
- FeatureFlag
- ProductCategory
- Note
- ProductVariations
- NoteForm
- ProductVariation
- PriceListAnalyzerUploadResponse
- ProductMarketplace
- PriceListAnalyzerJsonItem
- ProductUrls
- PriceListAnalyzerStatusResponse
- ProductPrices
- ProductSize
- ProductRisks
- ProductOffers
- ProductFees
- GetProductInternalApiError
- CalculateProductProfitRequest
- BusinessLogicApiError
- ProductProfit
- CalculateProductProfitInternalApiError
- ProductStats
- GetProductStatsInternalApiError
- CheckAsinRestrictionsResponse
- CheckRestrictionsInternalApiError
- ExternalProduct
- ExternalProductUpsertItem
- SupplierProductOffer
- InternalProduct
- ProductMatch
- ProductSupplierOffer
- ProductMatchItem
- InternalProductForm
- ApiSaRepricerSettingsController
- ListingForm
- Listing
- PurchaseOrder
- PurchaseOrderCreateForm
- CurrentUserInfoResponse
- PurchaseOrderForm
- PurchaseOrderItemForm
- EstimateSalesInternalApiError
- PurchaseOrderItem
- EstimateSalesResponse
- Sku
- EstimateSalesByBsrRequest
- Supplier
- SearchCatalogItemsResponse
- SupplierOffer
- CatalogItemsPagination
- CreateSupplierForm
- Refinements
- UpdateSupplierForm
- BrandRefinement
- WarehouseForm
- ClassificationRefinement
- Warehouse
- CatalogItem
- WarehouseProvider
- CatalogItemBrowseClassificationsByMarketplace
- RepricerProductHistoryItem
- CatalogItemBrowseClassification
- HistorySearchResponse
- CatalogItemDimensionsByMarketplace
- HistoryStats
- Dimensions
- RepricerDefaultSettings
- Dimension
- RepricerInfo
- CatalogItemIdentifiersByMarketplace
- RepricerSettings
- CatalogItemIdentifier
- UpdateRepricerSettings
- CatalogItemImagesByMarketplace
- RepricerProduct
- CatalogItemImage
- RepricerProductListResponse
- CatalogItemProductTypeByMarketplace
- CreateRepricerProductForm
- CatalogItemRelationshipsByMarketplace
- UpdateRepricerProductForm
- CatalogItemRelationship
- RepricerStrategy
- CatalogItemVariationTheme
- RepricerStrategyForm
- CatalogItemSalesRanksByMarketplace
- Tag
- CatalogItemClassificationSalesRank
- TagForm
- CatalogItemDisplayGroupSalesRank
- GetCurrentUserInfoInternalApiError
- CatalogItemSummaryByMarketplace
- CatalogItemContributor
- ApiV1Pagination
- CatalogItemContributorRole
- ApiV1BatchMeta
- CatalogItemVendorDetailsByMarketplace
- ApiV1BatchError
- CatalogItemVendorDetailsCategory
- SearchCatalogItemsInternalApiError
- GetCatalogItemInternalApiError
- GetInventorySummariesResponse
- GetInventorySummariesResult
- InventoryPagination
- Granularity
- InventorySummary
- InventoryDetails
- ReservedQuantity
- ResearchingQuantity
- ResearchingQuantityEntry
- UnfulfillableQuantity
- GetInventorySummariesInternalApiError
- SpApiMoney
- ShipmentAddress
- OldShipment
- GetShipmentsResponse
- GetShipmentsInternalApiError
- OldShipmentItem
- GetShipmentItemsResponse
- GetShipmentItemsInternalApiError
- GetShipmentItemsByShipmentIdResponse
- GetShipmentItemsByShipmentIdInternalApiError
- ListInboundPlansResponse
- InboundPlanSummary
- Address
- ListInboundPlansInternalApiError
- GetInboundPlanResponse
- GetInboundPlanInternalApiError
- ListPlacementOptionsResponse
- PlacementOption
- Incentive
- CurrencyValue
- ListPlacementOptionsInternalApiError
- TransportationOption
- ListTransportationOptionsResponse
- ListTransportationOptionsInternalApiError
- ShipmentSummary
- GetShipmentInternalApiError
- ShipmentItem
- PrepInstruction
- ListShipmentItemsResponse
- ListShipmentItemsInternalApiError
- ListInboundPlanBoxesResponse
- Box
- Region
- BoxDimensions
- BoxWeight
- ListInboundPlanBoxesInternalApiError
- ListShipmentBoxesResponse
- ListShipmentBoxesInternalApiError
- ListPackingOptionsResponse
- PackingOption
- PackingConfiguration
- BoxRequirements
- WeightRange
- ShippingRequirements
- ShippingConfiguration
- ListPackingOptionsInternalApiError
- ListPackingGroupBoxesResponse
- ListPackingGroupBoxesInternalApiError
- ListPackingGroupItemsResponse
- ListPackingGroupItemsInternalApiError
- SearchListingsItemsResponse
- Pagination
- CurrencyAmount
- Points
- Image
- VariationTheme
- ListingsItemSummary
- ListingsItemIssue
- Enforcements
- EnforcementAction
- Exemption
- ListingsItemIdentifier
- ListingOfferPrice
- OfferAudience
- FulfillmentAvailability
- Procurement
- ProductRelationship
- MarketplaceRelationship
- ProductTypeDefinition
- ListingsItem
- SearchListingsItemsInternalApiError
- GetListingsItemInternalApiError
- ListingsItemPutRequest
- ListingsItemSubmissionResponse
- ListingsItemPatchRequest
- PatchListingsItemInternalApiError
- DeleteListingsItemInternalApiError
- ProductType
- ProductTypeListResponse
- SearchProductTypeDefinitionsInternalApiError
- ProductTypeDefinitionResponse
- ProductTypeVersion
- Link
- SchemaLink
- PropertyGroup
- ProductTypeDefinitionsInternalApiError
- CompetitivePricingError
- CompetitivePricingProduct
- CompetitivePricingItem
- CompetitivePricingResponse
- CompetitiveSummaryError
- CompetitiveSummaryResponse
Add items to a purchase order
POST
https://app.sellerassistant.app/api/v1/sa/inventory/purchase-orders/{id}/items
items. The answer is the order, because the totals and the item count change with every item added. An item with an ASIN goes to the profit calculation. An item that names internal_product_id reads the title, the picture and the ASIN from that product, and a field the body sends stays as the body sends it.Request
Authorization
API Key
Add parameter in query
api_key
Example:
api_key: ********************or
API Key
Add parameter in header
X-Api-Key
Example:
X-Api-Key: ********************or
Path Params
Body Params application/jsonRequired
Example
{
"internal_product_id": "P-5XK1S0NQNO",
"asin": "B0019MQM64",
"upc": "string",
"ean": "string",
"identifier": "string",
"sku": "string",
"supplier_sku": "string",
"title": "string",
"brand": "string",
"image_url": "string",
"unit_cost": 9.5,
"unit_count": 12
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://app.sellerassistant.app/api/v1/sa/inventory/purchase-orders//items?api_key=%3Capi-key%3E' \
--header 'Content-Type: application/json' \
--data '{
"internal_product_id": "P-5XK1S0NQNO",
"asin": "B0019MQM64",
"upc": "string",
"ean": "string",
"identifier": "string",
"sku": "string",
"supplier_sku": "string",
"title": "string",
"brand": "string",
"image_url": "string",
"unit_cost": 9.5,
"unit_count": 12
}'Responses
🟢201
application/json
Bodyapplication/json
Example
{
"data": {
"id": 42,
"po_id": "PO-2026-018",
"status": "draft",
"supplier_id": 5,
"marketplace_id": "ATVPDKIKX0DER",
"prep_center_id": 3,
"user_id": 0,
"order_date": "2026-09-14",
"currency": "USD",
"items_count": 12,
"subtotal": 1240,
"shipping_cost": 0,
"taxes": 0,
"misc_expenses": 0,
"total_price": 1380.5,
"estimated_revenue": 0,
"estimated_profit": 0,
"supplier": {
"id": 5,
"name": "Acme Wholesale",
"currency": "USD"
},
"items": [
{
"id": 4471,
"purchase_order_id": 42,
"internal_product_id": "P-5XK1S0NQNO",
"title": "string",
"image_url": "string",
"asin": "B0019MQM64",
"upc": "string",
"ean": "string",
"sku": "string",
"identifier": "string",
"unit_cost": 9.5,
"unit_count": 12,
"total_cost": 114,
"selling_price": 0,
"profit_fba": 0,
"profit_marketplace_id": "string",
"profit_calculated_at": "2019-08-24T14:15:22.123Z",
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z"
}
],
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z"
}
}🟠400BadRequest
🟠403AccessDenied
🟠404NotFound
🟠429TooManyRequests
Modified at 2026-09-29 10:19:11