Amazon SP-API

Description

This module allows interacting with the Amazon Selling Partner API (SP-API) to manage a seller’s operations on Amazon. It includes functionalities for orders (query, get items, confirm shipment), catalog (search products by ASIN/UPC/EAN/keyword), listings (query and update), FBA inventory (query and update stock), competitive pricing and Buy Box, feeds for bulk updates (products, prices, inventory), and reports (sales, inventory, financial).

Authentication is handled through AWS Signature v4 via the credentials module. The module uses helper functions buildAuthHeaders and getEndpoint to build authentication headers and select the correct regional endpoint.

Configuration

Parameters

Parameter	Type	Required	Description
credentials_id	credentials	Yes	Amazon SP-API credential
operation	text	Yes	Operation: getOrders, getOrder, getOrderItems, confirmShipment, getCatalogItem, getListings, updateListing, getInventory, updateInventory, getPricing, createFeed, getFeedResult, createReport, getReport
order_id	text	Conditional	Order ID (e.g.: 403-1234567-8901234)
created_after	datetime	No	Creation date filter (ISO 8601)
created_before	datetime	No	Date until filter
order_statuses	select	No	Status: Pending, Unshipped, PartiallyShipped, Shipped, Canceled
max_results	number	No	Maximum results (default: 100)
fulfillment_channels	select	No	Channel: MFN (seller), AFN (FBA)
identifiers	text	Conditional	ASIN/UPC/EAN for catalog search
identifiers_type	select	No	Type: ASIN, EAN, UPC, ISBN
sku	text	Conditional	Product SKU
asins	text	Conditional	ASINs separated by comma (max 20 for pricing)
feed_type	select	Conditional	Feed type for bulk update
report_type	select	Conditional	Report type to request
tracking_number	text	Conditional	Tracking number (for confirmShipment)
carrier_code	select	Conditional	Carrier (UPS, FedEx, DHL, SEUR, etc.)

Credentials

Service type: amazon_sp. Stored in the servicecredentials table.

Configuration fields:

• region: Amazon region (NA, EU, FE)
• marketplace_id: Marketplace ID (e.g.: A1RKKUPIHCS9HS for Spain)
• selling_partner_id: Seller ID
• AWS credentials for request signing

Output

{
  "nextModule": null,
  "data": [
    {
      "AmazonOrderId": "403-1234567-8901234",
      "OrderStatus": "Shipped",
      "PurchaseDate": "2025-01-15T10:30:00Z",
      "OrderTotal": { "Amount": "29.99", "CurrencyCode": "EUR" }
    }
  ],
  "_meta_": {
    "operation": "getOrders",
    "marketplace": "A1RKKUPIHCS9HS",
    "recordCount": 1,
    "executionTime": "450ms"
  }
}

Usage Example

Basic case - Get orders

{
  "credentials_id": 1,
  "operation": "getOrders",
  "created_after": "2025-01-01T00:00:00Z",
  "order_statuses": "Unshipped",
  "max_results": 50
}

API Used

• Amazon Selling Partner API (SP-API)
• Orders API v0, Catalog Items API v2022-04-01, Listings Items API v2021-08-01
• FBA Inventory API v1, Product Pricing API v0, Feeds API v2021-06-30, Reports API v2021-06-30
• Documentation: https://developer-docs.amazon.com/sp-api/

Notes

• Amazon SP-API rate limits vary by operation; if reached (HTTP 429), the module indicates retry with delay
• Pricing queries accept a maximum of 20 ASINs per request
• Feeds require a 3-step process: create document, upload content, and create feed
• Reports are asynchronous: they are requested, processing is awaited, and then they are downloaded
• Inventory updates are performed internally via patches in the Listings API
• The default request timeout is 30 seconds (60 seconds for feeds)

Related Nodes

• Get Orders, Get Order, Order Items, Confirm Shipment
• Search Product, My Listings, Update Listing
• Query Inventory, Update Inventory, Query Pricing
• Submit Feed, Feed Result, Request Report, Download Report