Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.e-cross.tech/llms.txt

Use this file to discover all available pages before exploring further.

Overview

e-CROSS reads Shopify products and sends the mapped SKU data to the e-CROSS catalog, under the merchant instance. The integration undestands there are new data when any of the following fields are updated:
  • Product update date.
  • Variant update date.
  • Inventory item update date.

What you control in Shopify

You need to keep the Shopify product data complete and tag products with the correct merchant ID. The connector uses product tags to decide which merchant owns a product. The tag format is:
merchantId:<MERCHANT_ID>
For example:
merchantId:ACME
Products without a matching merchantId:<MERCHANT_ID> tag are ignored by the product, price, and inventory polling flow.

Product fields read from Shopify

e-CROSS reads these product fields:
Shopify fieldMandatoryUsed as
Product IDYese-CROSS productId
Product titleYesProduct name
Product descriptionYesProduct description
Product typeNoCategory
VendorYesBrand
Product statusYesProduct status. Only ACTIVE means active, all other statuses mean inactive.
ImagesYesProduct images
Product metafieldsNoExtra product attributes

Variant fields read from Shopify

Each Shopify variant becomes one e-CROSS SKU.
Shopify fieldMandatoryUsed as
Variant IDYese-CROSS skuId
BarcodeYesEAN
Selected option named SizeNoSize
Selected option named Color or ColourNoColor
Inventory item HS codeYesHS code
Inventory item weightYesSKU weight
Variant metafield widthNoSKU width
Variant metafield heightNoSKU height
Variant metafield lengthNoSKU length

Product metafields

Product metafields are sent as extra attributes. The integration uses the metafield key as the attribute name and the metafield value as the attribute value. If a metafield value points to a Shopify metaobject, the integration tries to use:
  1. The metaobject display name.
  2. A metaobject field named value.
  3. The first metaobject field that has a value.