Shopware Admin icon

Shopware Admin

Consume Shopware Admin API

Actions10

Overview

This node integrates with the Shopware Admin API to manage e-commerce data related to orders, products, and customers. Specifically for the Order - Get Many operation, it retrieves multiple order records from a Shopware store. This is useful when you want to fetch a list of orders for reporting, analysis, or further processing in an automation workflow.

Typical use cases include:

  • Retrieving recent orders to update an external system.
  • Filtering orders by search terms to find specific transactions.
  • Limiting the number of orders fetched to control data volume.

Properties

Name Meaning
Additional Fields Collection of optional parameters to customize the query:
- Limit Maximum number of order results to return (default is 10).
- Search Term A string term to filter orders by matching relevant fields (e.g., customer name, order ID).

Output

The node outputs an array of JSON objects representing the orders retrieved from the Shopware API. Each object corresponds to one order and contains all the order details as returned by the API.

  • The output is structured as a JSON array under the json field.
  • No binary data is produced by this operation.

Example output snippet (simplified):

[
  {
    "id": "order-id-123",
    "orderNumber": "10001",
    "customer": { "firstName": "John", "lastName": "Doe" },
    "totalPrice": 150.00,
    "state": "completed",
    ...
  },
  {
    "id": "order-id-124",
    "orderNumber": "10002",
    "customer": { "firstName": "Jane", "lastName": "Smith" },
    "totalPrice": 200.00,
    "state": "open",
    ...
  }
]

Dependencies

  • Requires connection to a Shopware instance via its Admin API.
  • Needs an API authentication token credential configured in n8n to authorize requests.
  • The node uses the Shopware Admin API endpoint URL provided in the credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect API URL or network issues can lead to request timeouts or connection errors.
    • Exceeding API rate limits may result in throttling errors.
    • Providing invalid values for limit or search term might cause unexpected results or empty responses.

  • Error messages:

    • "Unauthorized" or "Authentication failed": Check that the API key/token is correct and has necessary permissions.
    • "Not Found": Verify the resource path; ensure the Shopware instance URL is correct.
    • "Bad Request": Validate input parameters like limit and search term for correctness.

  • To resolve errors, verify credentials, network connectivity, and parameter values. Enable "Continue On Fail" in the node settings to handle errors gracefully during batch processing.

Links and References

Discussion