Allow you to write product data

The data attribute of the POST body corresponds to the list of products in JSON format payload.
This API is available both in JSON and XML format (Content-Type: application/json or application/xml)

The datamodel that describes precisely the list of attributes supported for update is available in the online documentation.
cf. Attributes documentation

You will find some sample payload below:

{
    "data": [
        {
            "GPC": {
                "categoryCode": {
                    "code": "10000320"
                }
            },
            "aDRTunnelRestrictionCodeList": [
                {
                    "code": "NONE"
                }
            ],
            "advertisedInformations": [
                {
                    "data": "An amazing perfume smelling really nice",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "allergenTypeList": [],
            "allergens": [],
            "areaOfUseList": [
                {
                    "areaOfUseCode": {
                        "code": "WRIST"
                    }
                }
            ],
            "assets": {
                "pictures": [
                    {
                        "angleHorizontal": "2",
                        "angleOther": null,
                        "angleVertical": "0",
                        "contentType": "1",
                        "exportables": [],
                        "fileEffectiveEndDateTime": "2031-05-26T22:00:00",
                        "fileEffectiveStartDateTime": "2021-05-26T22:00:00",
                        "fileType": null,
                        "format": "JPEG",
                        "isPackshot": false,
                        "productFace": "0",
                        "tag": [
                            {
                                "tag": null
                            }
                        ],
                        "url": "https://classicurl.com/api/wedia/dam/variation/u5wa3z31qn5sepwezndd5f37uqzph3ibr8dswge/pf_eretail"
                    },
                    {
                        "angleHorizontal": "2",
                        "angleOther": null,
                        "angleVertical": "0",
                        "contentType": "1",
                        "exportables": [],
                        "fileEffectiveEndDateTime": "2031-01-10T23:00:00",
                        "fileEffectiveStartDateTime": "2021-01-10T23:00:00",
                        "fileType": null,
                        "format": "JPEG",
                        "isPackshot": true,
                        "productFace": "0",
                        "tag": [
                            {
                                "tag": null
                            }
                        ],
                        "url": "https://classicurl.com/api/wedia/dam/variation/u5wa3z31qn5sezmxnr45qg8xekzph2ibr8dswge/pf_eretail"
                    }
                ]
            },
            "brandHighlight": [
                {
                    "data": "We're an amazing perfume brand name AmazingPerfumeBrand and we do perfumes in Grace.",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "brandText": "Rose perfume",
            "colorDescription": [
                {
                    "data": null,
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "colorGroup": null,
            "composition": [
                {
                    "data": "Grey Amber. WATER (AQUA). Civette Musk. Roses oil.",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "compulsoryStatements": [
                {
                    "text": [
                        {
                            "data": "Ingredients list may vary",
                            "expressedIn": {
                                "code": "en-US"
                            }
                        }
                    ]
                }
            ],
            "conservations": [
                {
                    "text": [
                        {
                            "data": "No specific",
                            "expressedIn": {
                                "code": "en-US"
                            }
                        }
                    ]
                }
            ],
            "consumerBenefits": [
                {
                    "sequenceNumberText": "1",
                    "text": [
                        {
                            "data": "Will make you smell great",
                            "expressedIn": {
                                "code": "en-US"
                            }
                        }
                    ]
                }
            ],
            "consumptionAdvice": [
                {
                    "data": "Spray once inside each wrists then rub it over your neck.",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "contactInformationList": [
                {
                    "availableTimeTextList": [],
                    "contactCommunicationChannelList": [
                        {
                            "contactCommunicationChannelCode": {
                                "code": "EMAIL"
                            },
                            "contactCommunicationChannelNameText": "Email",
                            "contactCommunicationChannelValueText": "[email protected]"
                        },
                        {
                            "contactCommunicationChannelCode": {
                                "code": "TELEPHONE"
                            },
                            "contactCommunicationChannelNameText": "Téléphone",
                            "contactCommunicationChannelValueText": "0 880 80 80 80"
                        }
                    ],
                    "contactDescriptionTextList": [],
                    "contactGLN": "3012827700101",
                    "contactNameText": "Service Consommateur AmazingPerfumeBrand",
                    "contactTypeCode": {
                        "code": "CONSUMER_SUPPORT"
                    },
                    "structuredAddressList": [
                        {
                            "cityText": "Les Ponts De Ce Cedex",
                            "countryCode": {
                                "code": "250"
                            },
                            "postalCodeText": "49130",
                            "provinceStateCodeText": null,
                            "streetAddressText": "Square Raoul Follereau"
                        }
                    ]
                },
                {
                    "availableTimeTextList": [],
                    "contactCommunicationChannelList": [],
                    "contactDescriptionTextList": [],
                    "contactGLN": "3012827700101",
                    "contactNameText": "AmazingPerfumeBrand marketing",
                    "contactTypeCode": {
                        "code": "TARGET_MARKET_INFORMATION_PROVIDER"
                    },
                    "structuredAddressList": [
                        {
                            "cityText": "BOULOGNE BILLANCOURT",
                            "countryCode": {
                                "code": "250"
                            },
                            "postalCodeText": "92100",
                            "provinceStateCodeText": null,
                            "streetAddressText": "45 RUE DES CHENES"
                        }
                    ]
                },
                {
                    "availableTimeTextList": [],
                    "contactCommunicationChannelList": [],
                    "contactDescriptionTextList": [],
                    "contactGLN": "3012827700101",
                    "contactNameText": "AmazingPerfumeBrand marketing",
                    "contactTypeCode": {
                        "code": "MANUFACTURER"
                    },
                    "structuredAddressList": [
                        {
                            "cityText": "BOULOGNE BILLANCOURT",
                            "countryCode": {
                                "code": "250"
                            },
                            "postalCodeText": "92100",
                            "provinceStateCodeText": null,
                            "streetAddressText": "45 RUE DES CHENES"
                        }
                    ]
                }
            ],
            "countryOfAssembly": {
                "code": "250"
            },
            "countryOfLastProcessing": {
                "code": "250"
            },
            "countryOfOriginList": [
                {
                    "countryOfOriginCode": {
                        "code": "250"
                    },
                    "countryOfOriginSubdivisionList": []
                }
            ],
            "createdShareValueStatement": [
                {
                    "data": "Packaging recyclable, check your local recycling processes",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "dangerousGoodsPackagingGroup": {
                "code": "NOT_APPLICABLE"
            },
            "dataCarrierTypeCode": {
                "code": "EAN_UCC_13_SYMBOL"
            },
            "dateOfLastApiModification": "2022-09-27+02:00",
            "description": [
                {
                    "data": "Especially great smell formula, now stay with you 20% longer",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "environmentstatement": [
                {
                    "data": "No whale was hurt or killed to manufacture this product. All our Civettes are vegan fed and gives their musks in a non invasive manner",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "firstOrderDateTime": null,
            "functionalName": [
                {
                    "data": "perfume",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "geneticallyModifiedDeclarationCode": {
                "code": "UNDECLARED"
            },
            "grossWeight": [
                {
                    "data": "70",
                    "expressedIn": {
                        "code": "g"
                    }
                }
            ],
            "gtin": "0012770208597",
            "hairTypes": [],
            "hasBatchNumber": true,
            "iCPEStorageCompatibilityCode": null,
            "importEuropeanClassification": "3307202002",
            "invoiceName": [
                {
                    "data": "Perfume 50 ml extra musk",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "isComplementaryWith": [
                {
                    "targetProduct": {
                        "gtin": "0012779003131"
                    }
                },
                {
                    "targetProduct": {
                        "gtin": "0012770110944"
                    }
                },
                {
                    "targetProduct": {
                        "gtin": "0012770111552"
                    }
                },
                {
                    "targetProduct": {
                        "gtin": "0012770111583"
                    }
                }
            ],
            "isConsumerUnit": true,
            "isDangerousSubstance": false,
            "isDerivedFrom": [],
            "isInvoiceUnit": true,
            "isIrradiated": false,
            "isOrderableUnit": true,
            "isPackagingMarkedReturnable": false,
            "isPromotionalItem": false,
            "isRechargeable": false,
            "isSeasonal": false,
            "isSizedBy": [
                {
                    "depth": [
                        {
                            "data": 40.0,
                            "expressedIn": {
                                "code": "mm"
                            }
                        }
                    ],
                    "dimensionType": {
                        "code": "IN_PACKAGE"
                    },
                    "height": [
                        {
                            "data": 100.0,
                            "expressedIn": {
                                "code": "mm"
                            }
                        }
                    ],
                    "width": [
                        {
                            "data": 40.0,
                            "expressedIn": {
                                "code": "mm"
                            }
                        }
                    ]
                }
            ],
            "isTestedOnAnimals": false,
            "isVariableUnit": false,
            "kind": {
                "code": "100993"
            },
            "labelDescription": [
                {
                    "data": "Musk perfume extra Civette",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "minimumAge": [
                {
                    "data": 12.0,
                    "expressedIn": {
                        "code": "y"
                    }
                }
            ],
            "minimumTradeItemLifespanFromTimeOfProduction": 1080,
            "nameLegal": [
                {
                    "data": "Perfume extra musk civette - 50 ML",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "namePublicLong": [
                {
                    "data": "Perfume extra musk civette - 50 ML",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "netContent": [
                {
                    "data": 50.0,
                    "expressedIn": {
                        "code": "mL"
                    }
                }
            ],
            "netWeight": [
                {
                    "data": "49",
                    "expressedIn": {
                        "code": "g"
                    }
                }
            ],
            "originCountry": {
                "code": "250"
            },
            "originText": [
                {
                    "data": "France",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "packaging": [
                {
                    "data": "50 ml",
                    "expressedIn": {
                        "code": "fr",
                        "label": "français"
                    }
                }
            ],
            "packagingInformationList": [
                {
                    "isPackagingExemptFromRefuseObligation": false,
                    "isPackagingReturnable": false,
                    "packageDepositList": [],
                    "packagingFeatureList": [],
                    "packagingFunctionList": [],
                    "packagingLevelNumber": "1",
                    "packagingMaterialList": [
                        {
                            "isPackagingMaterialRecoverable": false,
                            "packagingMaterialCompositionQuantityNumber": [],
                            "packagingMaterialTypeCode": null
                        }
                    ],
                    "packagingRefundObligationNameTextList": [],
                    "packagingRefuseObligationNameTextList": [],
                    "packagingTypeCode": {
                        "code": "TU"
                    },
                    "packagingTypeDescriptionTextList": [],
                    "platformTermsAndConditionsCode": null,
                    "platformTypeCode": null,
                    "returnableAssetList": []
                }
            ],
            "partyInformationList": [
                {
                    "partyAddressText": null,
                    "partyGLN": "3012827700101",
                    "partyNameText": "AmazingPerfumeBrand Head Office",
                    "partyRoleCode": {
                        "code": "HEAD_OFFICE"
                    },
                    "structuredAddressList": [
                        {
                            "cityText": "BOULOGNE BILLANCOURT",
                            "countryCode": {
                                "code": "250"
                            },
                            "postalCodeText": "92100",
                            "provinceStateCodeText": null,
                            "streetAddressText": "45 RUE DES CHENES"
                        }
                    ]
                },
                {
                    "partyAddressText": null,
                    "partyGLN": "3012827700101",
                    "partyNameText": "AmazingPerfumeBrand Head Office",
                    "partyRoleCode": {
                        "code": "INFORMATION_PROVIDER"
                    },
                    "structuredAddressList": [
                        {
                            "cityText": "BOULOGNE BILLANCOURT",
                            "countryCode": {
                                "code": "250"
                            },
                            "postalCodeText": "92100",
                            "provinceStateCodeText": null,
                            "streetAddressText": "45 RUE DES CHENES"
                        }
                    ]
                }
            ],
            "priceComparisonMeasurementNumber": [
                {
                    "data": 50.0,
                    "expressedIn": {
                        "code": "mL"
                    }
                }
            ],
            "priceComparisonType": {
                "code": "PER_L"
            },
            "productPropertiesCode": [],
            "productRangeText": "Body",
            "productTestedAnimalSpeciesList": [
                {
                    "productTestedAnimalSpeciesCode": {
                        "code": "NOT_TESTED_ON_ANIMALS"
                    }
                }
            ],
            "productTextureList": [],
            "productTreatmentList": [
                {
                    "productTreatmentCode": {
                        "code": "SMELL_GOOD"
                    }
                },
                {
                    "productTreatmentCode": {
                        "code": "SMELL_GOOD"
                    }
                }
            ],
            "recommendedUsageLocationText": [
                {
                    "data": "Apply on your wrist then your neck ",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "serves": [
                {
                    "data": "1",
                    "expressedIn": {
                        "code": "en-US"
                    }
                }
            ],
            "skinTypeList": [],
            "solarProtectionEfficiency": null,
            "sunburnProtectionFactor": null,
            "supplierCode": "236653",
            "synonyms": [
                {
                    "text": [
                        {
                            "data": "Hydratation",
                            "expressedIn": {
                                "code": "en-US"
                            }
                        }
                    ]
                },
                {
                    "text": [
                        {
                            "data": "Fragance",
                            "expressedIn": {
                                "code": "en-US"
                            }
                        }
                    ]
                },
                {
                    "text": [
                        {
                            "data": "high tolerance",
                            "expressedIn": {
                                "code": "en-us"
                            }
                        }
                    ]
                },
                {
                    "text": [
                        {
                            "data": "Something something",
                            "expressedIn": {
                                "code": "en-US"
                            }
                        }
                    ]
                },
                {
                    "text": [
                        {
                            "data": "Smells amazing",
                            "expressedIn": {
                                "code": "en-US"
                            }
                        }
                    ]
                },
                {
                    "text": [
                        {
                            "data": "No alcohol",
                            "expressedIn": {
                                "code": "en-US"
                            }
                        }
                    ]
                }
            ],
            "targetConsumerAgeList": [
                {
                    "targetConsumerAgeCode": {
                        "code": "ADOLESCENT"
                    }
                },
                {
                    "targetConsumerAgeCode": {
                        "code": "MIDDLE_ADULT"
                    }
                }
            ],
            "targetConsumerGender": {
                "code": "unisex"
            },
            "tradeItemConditionType": false,
            "tradeItemDateOnPackagingTypeCode": {
                "code": "best_before_date"
            },
            "typePackaging": {
                "code": "EACH"
            },
            "unitedNationsDangerousGoodsNumberCode": null,
            "validationRules": [
                {
                    "rule_id": 2193,
                    "type": "DeactivateValidationRule"
                },
                {
                    "rule_id": 21547,
                    "type": "DeactivateValidationRule"
                }
            ]
        }
    ]
{
    "data": [
        {
            "gtin": "03201773272008",
            "namePublicLong": [
                {
                    "data": "Hello world from write API Product 1",
                    "expressedIn": {
                        "code": "fra-FR"
                    }
                }
            ]
        },
        {
            "gtin": "03571996445009",
            "namePublicLong": [
                {
                    "data": "Hello world from write API Product 2",
                    "expressedIn": {
                        "code": "fra-FR"
                    }
                }
            ]
        }
    ]
}
{
    "data": [
        {
            "gtin": "03571996445009",
            "assets": {
                "pictures": [
                    {
                        "isPackshot": true,
                        "url": "https://stream.supplierxm.salsify.com/images/logo-inverse.781f93875f9c12548f1a45118dde00b1.png"
                    },
                    {
                        "isPackshot": false,
                        "url": "https://stream.supplierxm.salsify.com/images/logo-inverse.781f93875f9c12548f1a45118dde00b1.png"
                    }
                ]
            }
        }
    ]
}
Language
Authorization
Header
Click Try It! to start a request and see the response here!