IKAS icon

IKAS

Consume IKAS e-commerce platform API
Join our community

Actions11

Overview

This node integrates with the IKAS e-commerce platform API to update product information. It allows users to modify existing products by specifying their ID and updating various attributes such as name, type, pricing, stock, descriptions, images, and more.

Common scenarios where this node is beneficial include:

  • Synchronizing product data from an external system or database into IKAS.
  • Automating updates to product details like price changes, stock adjustments, or adding new images.
  • Managing product availability across multiple sales channels programmatically.

Practical example:

  • An online store wants to automatically update the stock count and price of a product every night based on inventory and pricing rules maintained in another system. This node can be used in an n8n workflow to perform those updates via the IKAS API.

Properties

Name Meaning
Product ID ID of the product to update (required).
Product Name Name of the product (required by IKAS API).
Product Type Type of the product (required by IKAS API). Options: Physical, Digital, Bundle, Membership.
Sales Channel Names List of sales channels where the product will be available. Select from loaded options or specify IDs via expressions (required).
Additional Fields Collection of optional fields to further define the product:
- Buy Price Cost/buy price for the simple product (number, min 0).
- Discount Price Discount price for the simple product (number, min 0).
- Price Selling price for the simple product (number, min 0). Leave empty to keep current price.
- SKU Stock Keeping Unit identifier (string).
- Barcode List Comma-separated list of barcodes for the product (e.g., "123456789,987654321").
- Variant ID Variant to update (for variable products). Required if product has multiple variants; leave empty for single variant products.
- Stock Count Initial stock count for the simple product (number, min 0).
- Stock Location Name or ID Stock location where stock will be stored. Select from loaded options or specify ID via expression.
- Description Full product description (string).
- Short Description Short description of the product (string).
- Weight Weight of the product (number, min 0).
- Max Quantity Per Cart Maximum quantity allowed per cart (number, min 0).
- Hidden Sales Channels Sales channels where the product will be hidden. Select from loaded options or specify IDs via expressions.
- Base Unit JSON object defining the base unit (fields: baseAmount, type).
- Dynamic Price List IDs Comma-separated list of dynamic price list IDs (string).
- Google Taxonomy ID Google taxonomy ID for the product (string).
- Group Variants By Variant Type ID Variant type ID to group variants by (string).
- Meta Data JSON object with meta data fields such as title, description, keywords.
- Product Attributes JSON array of product attributes.
- Product Option Set ID Option set ID for the product (string).
- Product Volume Discount ID Volume discount ID for the product (string).
- Translations JSON array of translations including locale, name, and description.
- Vendor ID Vendor ID for the product (string).
- Product Image Collection to upload an image for the product or specific variant:
-- Image Target Whether to add image to all variants ("Product") or a specific variant only ("Specific Variant").
-- Target Variant ID Variant ID to add the image to (required if targeting a specific variant).
-- Image Source Source of the image: URL or Base64 encoded data.
-- Image URL URL of the image to upload (if source is URL).
-- Image Base64 Base64 encoded image data (if source is Base64).
-- Image Order Order/position of the image (0 = first).
-- Is Main Image Boolean indicating if this image should be the main/primary image for the product.

Output

The node outputs JSON data representing the updated product(s) as returned by the IKAS API. The structure typically includes product identifiers, updated fields, and status information confirming the update.

If multiple items are processed, the output is an array of such JSON objects, each corresponding to one input item.

The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the IKAS e-commerce platform API.
  • Uses GraphQL queries internally to fetch related data such as sales channels, stock locations, and product variants for dropdown options.
  • The base URL for API requests is https://api.myikas.com/api/v1/admin.
  • No additional external dependencies beyond the IKAS API and n8n environment.

Troubleshooting

  • Missing or invalid Product ID: The update operation requires a valid product ID. Ensure the ID exists in IKAS and is correctly provided.
  • Required fields missing: Product Name, Product Type, and Sales Channels are mandatory. Omitting these will cause errors.
  • Variant ID issues: For products with multiple variants, a Variant ID must be specified when updating variant-specific fields. Leaving it empty in such cases may cause failures.
  • Invalid JSON inputs: Fields like Base Unit, Meta Data, Product Attributes, and Translations expect valid JSON. Malformed JSON will result in errors.
  • Image upload errors: When uploading images, ensure the image source matches the selected option (URL or Base64), and that URLs are accessible or Base64 data is properly encoded.
  • API authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
  • Network or API errors: Check connectivity and IKAS API status if requests fail unexpectedly.

Links and References

Discussion