Skip to main content

Amazon Seller Central

Manage Amazon Selling Partner orders, catalog items, FBA inventory, FBA inbound shipments, listings, sales metrics and reports via the SP-API.

Categories: E-Commerce

📝 Beta: This connector is in beta. It follows the service's documented API but has not yet been fully tested against the live service, so some tools may behave differently than described.

What you can ask​

  • List orders placed in the last 24 hours and flag the ones not yet shipped
  • Check inventory summaries for every SKU below two weeks of cover
  • Create a sales report for last month and fetch it once it finishes

Set up​

Amazon Seller Central needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Amazon Seller Central. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Amazon Seller Central developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Amazon Seller Central login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (8)

Grant the scopes for the tools you plan to allow.

  • Amazon Fulfillment (FBA Inbound)
  • Amazon Fulfillment (FBA Inventory)
  • Amazon Fulfillment (Orders)
  • Brand Analytics (Reports)
  • Inventory and Order Tracking (Sales)
  • Product Listing (Catalog Items)
  • Product Listing (Listings Items)
  • Product Listing (Listings Restrictions)

Tools​

Amazon Seller Central offers 42 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (25)​

View and search information without changing it.

ToolWhat it does
get_catalog_itemFetch one Amazon catalog item by ASIN for the given marketplace_ids.
get_inbound_operation_statusPoll the status of an asynchronous FBA inbound operation by operation_id (returned by every inbound create/cancel/set/generate/confirm/update tool). operation_status is IN_PROGRESS, SUCCESS or FAILED; keep polling while IN_PROGRESS, and read operation_problems when FAILED.
get_inbound_planFetch one FBA inbound plan by inbound_plan_id (from create_inbound_plan or list_inbound_plans): its status, packing/placement option summaries and shipment summaries as the workflow progresses.
get_listings_restrictionsCheck whether the seller is approved to list an ASIN before trying (asin from search_catalog_items; seller_id = your Merchant Token; marketplace_ids).
get_orderFetch one Amazon order by its AmazonOrderId: status, totals, fulfillment channel, ship dates, buyer/prime flags.
get_order_metricsSee aggregated order metrics (units, order count, sales) over a date range for marketplace_ids. interval is 'start--end' with ISO 8601 offsets; granularity buckets the results (Hour/Day/Week/Month/Year/Total).
get_reportFetch one report by ID: processingStatus, data window, created time, and report_document_id once DONE.
get_report_documentFetch a report document by its report_document_id to get the presigned download url and its compressionAlgorithm (e.g. GZIP). Obtain the document ID from a DONE report's report_document_id (via get_report). Set enable_content_encoding_url_header=true so a GZIP document's URL decompresses automatically. The URL expires a few minutes after this call.
get_report_scheduleFetch one report schedule by ID: report_type, period, marketplace_ids and next creation time.
get_shipmentFetch one inbound shipment (inbound_plan_id from create_inbound_plan; shipment_id from get_inbound_plan): its status, destination, selected transportation option and delivery window, and tracking details.
list_delivery_window_optionsList the generated delivery window options for a shipment (inbound_plan_id from create_inbound_plan; shipment_id from get_inbound_plan; run generate_delivery_window_options first).
list_inbound_plansList your FBA inbound plans.
list_inventory_summariesList FBA (Fulfilled by Amazon) inventory summaries per SKU. granularity_type ('Marketplace'), granularity_id (a marketplace ID) and marketplace_ids are required.
list_order_itemsList the line items of one Amazon order (ASIN, SellerSKU, title, quantity ordered/shipped, item price) by AmazonOrderId.
list_ordersList Amazon orders in marketplace_ids (required, e.g. ['ATVPDKIKX0DER'] for US). created_after or last_updated_after is always required (one kind of window, not both).
list_packing_group_itemsList the items in a packing group (inbound_plan_id from create_inbound_plan; packing_group_id from a packing option's packing_groups via list_packing_options).
list_packing_optionsList the generated packing options for an inbound plan (inbound_plan_id from create_inbound_plan; run generate_packing_options first).
list_placement_optionsList the generated placement options for an inbound plan (inbound_plan_id from create_inbound_plan; run generate_placement_options first).
list_report_schedulesList the report schedules configured for the given report_types (required), e.g. ['GET_MERCHANT_LISTINGS_ALL_DATA'].
list_reportsList reports you have requested. report_types is required (e.g. ['GET_MERCHANT_LISTINGS_ALL_DATA']); optionally filter by processing_statuses (IN_QUEUE, IN_PROGRESS, DONE, CANCELLED, FATAL), marketplace_ids and created_since/created_until (default: last 90 days).
list_shipment_itemsList the items (MSKU, ASIN, FNSKU, quantity, prep) in an inbound shipment (inbound_plan_id from create_inbound_plan; shipment_id from get_inbound_plan) — used to build a pick list once placement is confirmed.
list_transportation_optionsList the generated transportation options for an inbound plan (inbound_plan_id from create_inbound_plan; run generate_transportation_options first).
search_catalog_itemsSearch the Amazon catalog in one marketplace (marketplace_ids required).
search_listings_itemsFind a seller's own listings (status, offer, attributes, issues) for seller_id (your Merchant Token) and marketplace_ids.
validate_credentialCheck that the stored Amazon SP-API access token is valid by making one lightweight read against the Selling Partner API.

Write (7)​

Create or send data.

ToolWhat it does
create_inbound_planStart an FBA inbound plan: the entry point to the whole inbound workflow. destination_marketplaces, items (MSKU+quantity+label/prep owner, from list_inventory_summaries) and source_address are required.
create_reportRequest a new report. report_type and marketplace_ids are required; optionally set a data_start_time/data_end_time window and report_options.
generate_delivery_window_optionsGenerate delivery window options for a shipment (inbound_plan_id from create_inbound_plan; shipment_id from get_inbound_plan).
generate_packing_optionsGenerate packing options for an inbound plan (inbound_plan_id from create_inbound_plan).
generate_placement_optionsGenerate placement options (which fulfilment centres the inventory will be placed at) for an inbound plan (inbound_plan_id from create_inbound_plan, after a packing option is confirmed). custom_placement is optional.
generate_transportation_optionsGenerate transportation (carrier/mode/quote) options for a confirmed placement (inbound_plan_id from create_inbound_plan; placement_option_id from confirm_placement_option).
set_packing_informationSet box-level packing information (dimensions, weight, contents) for an inbound plan (inbound_plan_id from create_inbound_plan).

Delete or overwrite (10)​

Remove or replace existing data.

ToolWhat it does
cancel_inbound_planCancel an FBA inbound plan by inbound_plan_id (from create_inbound_plan or list_inbound_plans).
cancel_reportCancel a report that is still IN_QUEUE or IN_PROGRESS by its report_id.
cancel_report_scheduleCancel (delete) a report schedule by its report_schedule_id so it stops generating reports.
confirm_delivery_window_optionsConfirm the delivery window for a shipment (inbound_plan_id from create_inbound_plan; shipment_id from get_inbound_plan; delivery_window_option_id from list_delivery_window_options).
confirm_packing_optionConfirm the packing option to use for an inbound plan (inbound_plan_id from create_inbound_plan; packing_option_id from list_packing_options).
confirm_placement_optionConfirm where the inventory will be placed for an inbound plan (inbound_plan_id from create_inbound_plan; placement_option_id from list_placement_options).
confirm_transportation_optionsConfirm the chosen carrier/quote per shipment for an inbound plan (inbound_plan_id from create_inbound_plan; transportation_option_id per shipment from list_transportation_options).
create_report_scheduleCreate a recurring report schedule. report_type, marketplace_ids and period are required; period is an ISO 8601 duration (e.g. 'P1D' daily, 'PT8H', 'P7D' weekly).
patch_listings_itemPatch a listing's offer or content for a SKU (seller_id = Merchant Token; sku and product_type from search_listings_items). patches are JSON Patch ops on the listing's attributes.
update_shipment_tracking_detailsUpdate carrier tracking on an inbound shipment (inbound_plan_id from create_inbound_plan; shipment_id from get_inbound_plan).
⌘J