Miva icon

Miva

Interact with Miva eCommerce API

Upload Images

AI-generated

Summary

Upload product images to a specified Miva store by providing image URLs and product identifiers from input data, saving images to Miva with customizable file path and image type.

Inputs

  • Store Code (required) — The Miva store code identifier where images will be uploaded.
  • Product Identifier Type (required) — The type of product identifier to use (Product ID, Product Code, or Product SKU).
  • Product Identifier Field (required) — Field in input data containing the product identifier matching the specified type.
  • Image URL Field (required) — Field in input data containing the image URL to upload.
  • File Path Template — Template for the Miva file path for the uploaded image, supporting variables {product_id}, {product_code}, {product_sku}, and {filename}. Defaults to 'graphics/products/{product_code}/{filename}'.
  • Image Type ID — Miva image type ID to assign to the uploaded image, where 0 means no specific type.

Output shape

a single record per input item

Returns the original input data augmented with upload status ('success' or 'failed'), a processing timestamp, and if successful, the Miva file path of the uploaded image. On failure, includes an error message and optionally the Miva API response.

Examples

Example 1: Uploading images by product code from input items

Set Store Code to target store, Product Identifier Type to 'Product Code', specify fields for Product Identifier and Image URL, optionally customize file path template and image type ID.

Links

Discussion