Product Update GDSN
  • 8 Minutes to read
  • Dark
    Light

Product Update GDSN

  • Dark
    Light

Article summary

To update the product GDSN, mention the following in the postman and then click Send.

POST


Query Parameters

Expand to see the parameters and description


Parameter  Parameter TypeData TypeAccepted ValuesDescription
companyIdRequiredStringGUIDGUID associated with your company account. Unique to each account
vocabularyIdRequiredStringGUIDEach account using the API has a vocabulary associated with their account that allows for customer defined aliases on attributes. This is the GUID to your company's customer vocabulay file
verboseOptionalBooleentrue/falseDefaults to false. provides more verbose output in the response. Does have a major performance cost so is best used only during testing/prototype/troubleshooting
whatIfOptionalBooleentrue/falseWhen set to "true" the importer will run through all of its logic and generate the response output but will not commit any data. Meant for testing
shouldIncludeMissingVocabularyAttributes

OptionalBooleantrue/falseWill determine if attributes not included in your company vocabulary will be returned in search results. Defaults to setting in customer vocabulary, else defaults to false. If set to true, attributes not in vocabulary will return with its GUID.







Specify the required values for params companyId and vocabularyId.

Headers

Authorization: Specify required Auth Token in the header.

Request Parameters

Expand to see the parameters and description


Parameter  
Parameter Type
Data Type
Accepted Values
Description
ProductsToImport
RequiredArray
Contains an a array of Products
ImportMode
RequiredenumCreateOrUpdate, Create, Update, ExportOnlyCreateOrUpdate: create product if does not exist or updates existing product.
Create: only creates, error if product already exists.
Update: only updates existing products, fails if product does not exist.
ExportOnly: applies only to export payloads that were pulled using the parameters useLens and flattenLensedProduct set to true. Views flattened attributes that include only one value for any attribute. Can't import products using this value.
ProductIdentifierPropertyOverride
OptionalenumSee Product Identifier Property TableUsed in an import with multiple products. For that single product, this changes the identifier property used as the API key. Sets what type of value you would like to use as the ProductIdentifierValue
ProductIdentifierValue
RequiredString
The unique identifier of the product that you are creating or updating.
TaxonomyNodes
OptionalArray of GUIDsGUIDsUsed to set the taxonomy/category for a product.
CatalogItems
OptionalArray
Party, TargetMarket value pairsUsed for GDSN publications only to request catalog registration for your product to a specific recipient
   Party
Optional, Required for CatalogItemsStringGUIDRecipient GUID (For Catalogue items this is the Supplier GDSN Party)
   TargetMarket
Optional, Required for CatalogItems
enumThree digit code that aligns with Target Markets as defined within your company settings. Can be retrieved aby API call.Determines which country/region you are requesting your catalog be registered.
PackageType
Optionalenum"Load" - Transporter Load    "MixedModule" - Mixed Module    "Pallet" - Pallet    "Display" - Display Shipper"Pack" - Pack or Inner Pack"Case" - Case    "BaseUnit" - Base UnitUsed mainly for GDSN when managing product hierarchy
ImmediateParentDetails
OptionalArrayContains ProductIdentifier, Quantity pairsUsed for managing product hierarchy to set the parent product and define the quantity contained. The parent product must exist before using this in product import
   ProductIdentifierOptional, required with ImmediateParentDetailsStringGTIN of parent productThe identifier of the parent product that contains the current product. For GDSN, must use GTIN. Parent must exist before using.
   QuantityOptional, required with ImmediateParentDetails
Integer>0Sets the number of current products contained in the parent product
RecipientsToLink
Optional
Array of strings
GUID or as mapped in customer vocabulary
Links the product to assoicated recipient default requirement set(s). May have one or more RecipientsToLink.
WorkflowId
Optional
String
GUID or as mapped in customer vocabulary
Imports or updates and adds it to the Workflow step
RecipientsRequirementSetsOptional
ArrayArray of recipient requirement setsRecipient with Array of requirement sets
Values
Optional
Array
Contains all attribute values to be imported or updated. 
MultiValues
Optional
Array

Holds all attributes of type MultiValue
AssetValues
Optional
ArrayArray of asset attributes.
"Name",
"ValuesByLocale",
"Url",
"SourceUrl",
"Format"
The array of asset attributes. Contains assets' attributes and URLs.
NameOptional, Required for AssetValues
String
Asset attribute name.
ValuesByLocale
Optional, Required for AssetValues
ObjectContains attribute's locales e.g. "en-US": {}Object for locale values.
Name
Part of ValuesByLocaleString
Asset name as it should appear in the UI.
URLPart of ValuesByLocaleString
URL of the asset in the supplier's asset library.
SourceUrl
Optional for ValuesByLocale
String
URL from which the asset was originally obtained (external to Syndigo). The attribute prevents from getting duplicated asset images (that are from the same source). If SourceUrl exists before the import, it will match and prevent duplicate.
FormatOptional for ValuesByLocale
Stringjpeg, png,  jpg, gif, mp4, mov, pdfHolds a file extenstion of an asset.
SourceParty
Optional for ValuesByLocale
Stringe.g. “Marketplace”
Party from which the value was sources if not the current party.
Recipient
Optional for ValuesByLocale
String
Alias or GUID of the recipient to which the value applies if it is recipient specific.
Delete
Required for AssetValuesBooleantrue/falseSet to true to delete an existing value.
IsExplicitNullValue
Required for AssetValues
Booleantrue/falseIndicates if value is intended to be published as empty.
ContainerValues
Optional
Array

Holds all attributes of type ContainerValue
ComplexValues
Optional
Array

Holds all attributes of type ComplexValue
NutritionalInformationModule
Optional
Module
Contains the nutrition panel(s) information
ProductIdentifierProperty
Required
enum

Determines the unique identifier attribute to be used as your product identifier, ProductIdentifierValue. Note that this must be unique or the API will not be able to determine which record to update.
LifeCycle
Optional
String
Contains multiple fields:CreatedDate{Value, Delete}DiscontinueDateDeleteDateUsed to manage the product life cycle. CreatedDate is system generated. DiscontinueDate and DeleteDate can be set by user. See example for details
ErrorMode
Optional
enum
Ignore/Fail
Ignore will ignore any error encountered and continue the operation. Fail will prevent any information from the payload from being committed. If you have one product out of 50 in an import with an error, no products will be imported or updated. All will fail.

Request


{
    "ProductImportData": {
        "ProductIdentifierProperty": "UPC #",
        "ErrorMode": "Fail",
        "ProductsToImport": [
            {
                "ImportMode": "CreateOrUpdate",
                "ProductIdentifierValue": "63245735247",
                "WorkflowId": "1304f110-d961-4f09-85c2-1f1f1dcaba36",
                "RecipientsToLink": [
                    "GDSN Recipient"
                ],
                "CatalogItems": [
                    {
                        "Party": "b3769954-f64a-ae8f-7eb4-84117f266fa0",
                        "TargetMarket": "840"
                    }
                ],
                "PackageType": "BaseUnit",
                "ImmediateParentDetails": {
                    "61706937631058": {
                        "Quantity": 3
                    }
                },
                "Values": [
                    {
                        "Name": "Product Identification Number",
                        "ValuesByLocale": {
                            "": "01822222785669"
                        }
                    },
                    {
                        "Name": "Quantity of Devices",
                        "ValuesByLocale": {
                            "": "1"
                        }
                    },
                    {
                        "Name": "DUNS Number",
                        "ValuesByLocale": {
                            "": "054324257"
                        }
                    },
                    {
                        "Name": "DUNS Number Code",
                        "ValuesByLocale": {
                            "": "DUNS"
                        }
                    },
                    {
                        "Name": "Brand Name",
                        "ValuesByLocale": {
                            "": "GEHC"
                        }
                    },
                    {
                        "Name": "Item Description",
                        "ValuesByLocale": {
                            "": "Test 04062021"
                        }
                    },
                    {
                        "Name": "DI Record Publish Date",
                        "ValuesByLocale": {
                            "": "08/24/2020"
                        }
                    },
                    {
                        "Name": "UDI Direct Marking Exempt",
                        "ValuesByLocale": {
                            "": "FALSE"
                        }
                    },
                    {
                        "Name": "Contains Human Tissue",
                        "ValuesByLocale": {
                            "": "FALSE"
                        }
                    },
                    {
                        "Name": "Kit Combination Product",
                        "ValuesByLocale": {
                            "": "KIT"
                        }
                    },
                    {
                        "Name": "Exempt from Premarket Submission",
                        "ValuesByLocale": {
                            "": "N"
                        }
                    },
                    {
                        "Name": "For single-use",
                        "ValuesByLocale": {
                            "": "REUSABLE"
                        }
                    },
                    {
                        "Name": "Lot Control",
                        "ValuesByLocale": {
                            "": "Y"
                        }
                    },
                    {
                        "Name": "Serial Control",
                        "ValuesByLocale": {
                            "": "MARKED_ON_PACKAGING"
                        }
                    },
                    {
                        "Name": "Donation ID Number",
                        "ValuesByLocale": {
                            "": "No"
                        }
                    },
                    {
                        "Name": "Device required to be labeled as contains latex",
                        "ValuesByLocale": {
                            "": "FALSE"
                        }
                    },
                    {
                        "Name": "What MRI Safety information does the labeling contain",
                        "ValuesByLocale": {
                            "": "UNSPECIFIED"
                        }
                    },
                    {
                        "Name": "Prescription or OTC Device",
                        "ValuesByLocale": {
                            "": "PRESCRIPTION_REQUIRED"
                        }
                    },
                    {
                        "Name": "Manufacture or Lot Expiration Control",
                        "ValuesByLocale": {
                            "": "PRODUCTION_DATE"
                        }
                    }
                ],
                "ContainerValues": [
                    {
                        "ParentAttribute": "_Additional Trade Item Classification",
                        "RowList": [
                            {
                                "Values": [
                                    {
                                        "Name": "additionalTradeItemClassificationSystemCode",
                                        "ValuesByLocale": {
                                            "": "58"
                                        }
                                    },
                                    {
                                        "Name": "additionalTradeItemClassificationCodeValue",
                                        "ValuesByLocale": {
                                            "": "K961587:000"
                                        }
                                    }
                                ]
                            },
                            {
                                "Values": [
                                    {
                                        "Name": "additionalTradeItemClassificationSystemCode",
                                        "ValuesByLocale": {
                                            "": "35"
                                        }
                                    },
                                    {
                                        "Name": "additionalTradeItemClassificationCodeValue",
                                        "ValuesByLocale": {
                                            "": "40761"
                                        }
                                    }
                                ]
                            }
                        ]
                    }
                ],
                "ComplexValues": [
                    {
                        "ParentAttribute": "_Temperatures",
                        "ValueListByLocale": [
                            {
                                "Locale": "en-US",
                                "RowList": [
                                    [
                                        {
                                            "Name": "temperatureQualifierCode",
                                            "Value": "STORAGE_HANDLING"
                                        },
                                        {
                                            "Name": "TemperatureMinimum",
                                            "Value": "18"
                                        },
                                        {
                                            "Name": "TemperatureMinimumUOM",
                                            "Value": "CEL"
                                        },
                                        {
                                            "Name": "TemperatureMaximum",
                                            "Value": "30"
                                        },
                                        {
                                            "Name": "TemperatureMaximumUOM",
                                            "Value": "CEL"
                                        }
                                    ],
                                    [
                                        {
                                            "Name": "temperatureQualifierCode",
                                            "Value": "STORAGE_HANDLING"
                                        },
                                        {
                                            "Name": "TemperatureMinimum",
                                            "Value": "64"
                                        },
                                        {
                                            "Name": "TemperatureMinimumUOM",
                                            "Value": "FAH"
                                        },
                                        {
                                            "Name": "TemperatureMaximum",
                                            "Value": "86"
                                        },
                                        {
                                            "Name": "TemperatureMaximumUOM",
                                            "Value": "FAH"
                                        }
                                    ],
                                    [
                                        {
                                            "Name": "temperatureQualifierCode",
                                            "Value": "WORKING_TEMPERATURE"
                                        },
                                        {
                                            "Name": "TemperatureMinimum",
                                            "Value": "-10"
                                        },
                                        {
                                            "Name": "TemperatureMinimumUOM",
                                            "Value": "CEL"
                                        },
                                        {
                                            "Name": "TemperatureMaximum",
                                            "Value": "50"
                                        },
                                        {
                                            "Name": "TemperatureMaximumUOM",
                                            "Value": "CEL"
                                        }
                                    ],
                                    [
                                        {
                                            "Name": "temperatureQualifierCode",
                                            "Value": "WORKING_TEMPERATURE"
                                        },
                                        {
                                            "Name": "TemperatureMinimum",
                                            "Value": "14"
                                        },
                                        {
                                            "Name": "TemperatureMinimumUOM",
                                            "Value": "FAH"
                                        },
                                        {
                                            "Name": "TemperatureMaximum",
                                            "Value": "122"
                                        },
                                        {
                                            "Name": "TemperatureMaximumUOM",
                                            "Value": "FAH"
                                        }
                                    ]
                                ]
                            }
                        ]
                    },
                    {
                        "ParentAttribute": "_additionalTradeItemIdentification",
                        "ValueListByLocale": [
                            {
                                "Locale": "en-US",
                                "RowList": [
                                    [
                                        {
                                            "Name": "additionalTradeItemIdentificationTypeCode",
                                            "Value": "MODEL_NUMBER"
                                        },
                                        {
                                            "Name": "additionalTradeItemIdentificationTypeValue",
                                            "Value": "P8 BT16"
                                        }
                                    ],
                                    [
                                        {
                                            "Name": "additionalTradeItemIdentificationTypeCode",
                                            "Value": "FDA_MEDICAL_DEVICE_LISTING"
                                        },
                                        {
                                            "Name": "additionalTradeItemIdentificationTypeValue",
                                            "Value": "D265025"
                                        }
                                    ]
                                ]
                            }
                        ]
                    },
                    {
                        "ParentAttribute": "FDA Contact Information",
                        "ValueListByLocale": [
                            {
                                "Locale": "en-US",
                                "RowList": [
                                    [
                                        {
                                            "Name": "targetMarketCommunicationChannelCode",
                                            "Value": "EMAIL"
                                        },
                                        {
                                            "Name": "targetMarketCommunicationChannelCommunicationNumber",
                                            "Value": "test@test.com"
                                        }
                                    ],
                                    [
                                        {
                                            "Name": "targetMarketCommunicationChannelCode",
                                            "Value": "TELEPHONE"
                                        },
                                        {
                                            "Name": "targetMarketCommunicationChannelCommunicationNumber",
                                            "Value": "tel:+1(999)999-9009"
                                        }
                                    ]
                                ]
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

Response 200 OK


{
    "VerboseResponse": false,
    "OverallResult": "Import request processed, but not writing data because whatIf = true",
    "Errors": [],
    "ResultsByActionType": {
        "ProductImportData": [
            {
                "Result": "Failure",
                "IdentifierValue": "63245735247",
                "MatchedId": "7f510343-3962-46f4-a191-a94e5e92eafe",
                "Errors": [
                    "Could not resolve attribute named [Product Identification Number] as an attribute for a [Product]",
                    "Could not resolve attribute named [Quantity of Devices] as an attribute for a [Product]",
                    "Could not resolve attribute named [DUNS Number] as an attribute for a [Product]",
                    "Could not resolve attribute named [DUNS Number Code] as an attribute for a [Product]",
                    "Could not resolve attribute named [Brand Name] as an attribute for a [Product]",
                    "Could not resolve attribute named [DI Record Publish Date] as an attribute for a [Product]",
                    "Could not resolve attribute named [UDI Direct Marking Exempt] as an attribute for a [Product]",
                    "Could not resolve attribute named [Contains Human Tissue] as an attribute for a [Product]",
                    "Could not resolve attribute named [Kit Combination Product] as an attribute for a [Product]",
                    "Could not resolve attribute named [Exempt from Premarket Submission] as an attribute for a [Product]",
                    "Could not resolve attribute named [For single-use] as an attribute for a [Product]",
                    "Could not resolve attribute named [Lot Control] as an attribute for a [Product]",
                    "Could not resolve attribute named [Serial Control] as an attribute for a [Product]",
                    "Could not resolve attribute named [Donation ID Number] as an attribute for a [Product]",
                    "Could not resolve attribute named [Device required to be labeled as contains latex] as an attribute for a [Product]",
                    "Could not resolve attribute named [What MRI Safety information does the labeling contain] as an attribute for a [Product]",
                    "Could not resolve attribute named [Prescription or OTC Device] as an attribute for a [Product]",
                    "Could not resolve attribute named [Manufacture or Lot Expiration Control] as an attribute for a [Product]",
                    "Could not resolve complex parent attribute named [_Temperatures]",
                    "Could not resolve container parent attribute named [_Additional Trade Item Classification]",
                    "Hierarchy parent identified by [61706937631058] did not match any products",
                    "Couldn't determine the recipient that corresponds to GDSN Recipient",
                    "Failure"
                ]
            }
        ]
    }
}


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Eddy AI, facilitating knowledge discovery through conversational intelligence