Prodotto (Product)

Modello catalogo completo: titolo, handle, descrizione, tipo, vendor, tag, markets, media e file, metaobjects, metafields, prezzi a livello padre, SEO, peso, origine, HS code, costo, imballo, flag digitali e tracciamento inventario. Include un array variants con opzioni, media, metafields, file, logistica e prezzi per variante. È la struttura principale per import/aggiornamento prodotti.

Esempio JSON completo

{
    "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
}

Note

• optionValues nelle varianti definiscono le opzioni (es. colore).
• markets elenca identificativi di mercato/regione del canale.
• Metafields e file usano chiavi namespace come convenzione del connettore.
• harmonizedSystemCode, countryCodeOfOrigin e provinceCodeOfOrigin supportano dogana e compliance.