IKAS icon

IKAS

Consume IKAS e-commerce platform API

Overview

This node integrates with the IKAS e-commerce platform API to retrieve multiple product records. Specifically, the "Get Many" operation under the "Product" resource fetches a list of products from the IKAS system. It supports automatic pagination to fetch all available products or manual control over pagination parameters such as page number and limit.

Typical use cases include:

  • Synchronizing product catalogs between IKAS and other systems.
  • Bulk exporting product data for reporting or analysis.
  • Automating inventory updates by retrieving current product details.

For example, a user might configure this node to fetch all products in batches of 50 items per request, ensuring complete synchronization without manual pagination handling.

Properties

Name Meaning
Fetch All Items Boolean option to automatically fetch all products using pagination. When enabled, the node fetches pages until all products are retrieved.
Limit Maximum number of products to return when not fetching all items. Options: 10, 20, 30, 40, 50.
Page Page number to fetch when not fetching all items (starts from 1).
Page Size Number of products to fetch per page when auto-fetching all items. Options: 10, 20, 30, 40, 50.

Output

The node outputs an array of product objects in the json field of each item. Each object represents a product retrieved from IKAS, containing its properties as returned by the API. The exact structure depends on the IKAS API response but typically includes product identifiers, names, variants, and other relevant product details.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the IKAS e-commerce platform API.
  • The node uses the IKAS GraphQL API endpoint at https://api.myikas.com/api/v1/admin.
  • Proper configuration of the API authentication credential within n8n is necessary.

Troubleshooting

  • Common Issues:

    • Authentication failures due to invalid or missing API credentials.
    • Pagination misconfiguration leading to incomplete data retrieval.
    • Network connectivity issues preventing access to the IKAS API.
  • Error Messages:

    • "Resource "product" is not yet implemented": Indicates the resource parameter is incorrect or unsupported.
    • "Operation "getMany" is not yet implemented for resource "product": Indicates the operation parameter is invalid for the selected resource.
    • API errors related to rate limits or invalid queries will be surfaced from the IKAS API responses.
  • Resolutions:

    • Verify that the API key credential is correctly set up and has sufficient permissions.
    • If fetching all items is disabled, ensure the Page and Limit parameters are set appropriately.
    • Check network connectivity and firewall settings to allow outbound requests to the IKAS API endpoint.

Links and References

Discussion