post https://apis.supplierxm.salsify.com/public/v1/products
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"
}
]
}
}
]
}