Product

Full catalog model: title, handle, description, type, vendor, tags, markets, media and files, metaobjects, metafields, parent-level prices, SEO, weight, origin, HS code, cost, package, digital and inventory flags. Includes variants with options, media, metafields, files, logistics, and per-variant prices. Primary structure for product import and updates.

Full JSON example

{
    "sku": "BGSM001C210",
    "title": "Product Test 1 Con Varianti",
    "barcode": "14785985742",
    "handle": "product-product-1",
    "not-found-handle": "/collections/all",
    "description": "Description of product",
    "type": "product-type",
    "price": 15.99,
    "compareAtPrice": 19.99,
    "vendor": "SBS",
    "tags": [
        "tagprimo",
        "tag2"
    ],
    "markets": [
        "81543987507",
        "81544020275",
        "81544053043",
        "81544085811",
        "82294604083"
    ],
    "media": [
        {
            "alternativeText": "image test",
            "url": "https://demo.sintra-soh.com/csv-import-images/BGSM001C005/BGSM001C005.jpg",
            "filename": "BGSM001C005.jpg"
        },
        {
            "alternativeText": "image test 1",
            "url": "https://demo.sintra-soh.com/csv-import-images/BGSM001C005/BGSM001C005_1.jpg",
            "filename": "BGSM001C005_1"
        }
    ],
    "metaobjects": {
        "namespace.app": [
            "type.app-test-senza-link",
            "type.app-test-con-link"
        ],
        "tech": "test-da-cancellare"
    },
    "files": {
        "namespace.certification_file": "http://demo.sintra-soh.com/LdV/samplepdf.pdf",
        "documents_file": "http://demo.sintra-soh.com/LdV/samplepdf_1.pdf",
        "gallery_images_file": "http://demo.sintra-soh.com/ShippingLabels/1002-816-0.pdf",
        "manual": "http://demo.sintra-soh.com/ShippingLabels/1006-867-0.pdf"
    },
    "metafields": {
        "namespace.accessories_included": "value",
        "addition_features": "value",
        "attachment": "value",
        "attachment_system": "value",
        "audio_output": "value",
        "audio_power": "value",
        "audio_power_unit": "value",
        "logistic_depth": 1,
        "type_product": "[\"tipo1\",\"tipo2\"]",
        "video": "https://www.youtube.com/watch?v=WqDiH5bnZ4s",
        "volume_control_position": "value",
        "warrentyupgrade": false
    },
    "variants": [
        {
            "sortingNumber": 1,
            "sku": "BGSM001C210-1",
            "barcode": "1478598574258",
            "price": 12.99,
            "compareAtPrice": 15.99,
            "optionValues": {
                "color": "Blue"
            },
            "media": [
                {
                    "alternativeText": "image test 1 facoltativo",
                    "url": "http://demo.sintra-soh.com/csv-import-images/BGSM003C014/BGSM003C014.jpg",
                    "filename": "test.jpg"
                },
                {
                    "alternativeText": "image test 2 facoltativo",
                    "url": "http://demo.sintra-soh.com/csv-import-images/BGSM003C014/BGSM003C014_1.jpg"
                }
            ],
            "metafields": {
                "subtitle": "value"
            },
            "files": {
                "gallery_images_file": "http://demo.sintra-soh.com/ShippingLabels/1006-867-0.pdf"
            },
            "harmonizedSystemCode": "147856923",
            "countryCodeOfOrigin": "IT",
            "provinceCodeOfOrigin": "IT-52",
            "costPerItem": 14.95,
            "package": "123456789",
            "isDigitalItem": true,
            "inventoryTracked": false
        },
        {
            "sortingNumber": 2,
            "sku": "BGSM001C210-2",
            "barcode": "1478598574259",
            "optionValues": {
                "color": "Lilac"
            },
            "media": [
                {
                    "alternativeText": "lilla davanti",
                    "url": "http://demo.sintra-soh.com/csv-import-images/BGSM003C015/BGSM003C015.jpg"
                },
                {
                    "alternativeText": "lilla sopra",
                    "url": "http://demo.sintra-soh.com/csv-import-images/BGSM003C015/BGSM003C015_1.jpg"
                }
            ],
            "metafields": {
                "subtitle": "value"
            },
            "files": {
                "gallery_images_file": "http://demo.sintra-soh.com/ShippingLabels/1006-867-0.pdf"
            },
            "weight": "1.09",
            "weightUnit": "kg",
            "harmonizedSystemCode": "123456789",
            "countryCodeOfOrigin": "IT",
            "provinceCodeOfOrigin": "IT-52",
            "costPerItem": 14.95,
            "isDigitalItem": true,
            "inventoryTracked": true
        }
    ],
    "weight": "1090",
    "weightUnit": "g",
    "metaTitle": "SEO Product metaTile",
    "metaDescription": "SEO Product metaDescription",
    "harmonizedSystemCode": "987456321",
    "countryCodeOfOrigin": "IT",
    "provinceCodeOfOrigin": "IT-52",
    "costPerItem": 14.95,
    "package": "gid://shopify/ShippingPackageV2/987654321",
    "isDigitalItem": true,
    "inventoryTracked": false
}

Notes

• Variant optionValues define options (e.g. color).
• markets lists market/region ids for the channel.
• Metafields and files use namespaced keys per connector conventions.
• harmonizedSystemCode, countryCodeOfOrigin, and provinceCodeOfOrigin support customs/compliance.