Salsify Import API

Integrator.io
1

We have followed the steps outlined in the documentation:
https://developers.salsify.com/reference/executing-a-salsify-import-from-api-process-flow

We are successfully able to import delta changes for:
Attributes
Attribute Values
These are working as expected.

However, we are facing issues while updating the Inheritance Model.
Details of the issue:

Modified inheritance structure:

  • STYLE > SKU (added attribute ab_name at salsify:levels = STYLE)
  • Base > Flavor > Size > Variant (added attribute Color_Alok at salsify:levels = Size)
  • Attempted to import these changes using the same Python-based JSON import approach
  • However, the updates are not getting reflected in the system

Additionally, the Schema Rules are not being fully created.
For example, I created a Taxonomy (Vivaan-Taxnomy) with the following properties:
Active
Active Date
I also added a relation: Parent-Product > Child-Product.

However, after importing the file, only the Taxonomy is created, while the properties and relations are not being linked with the Taxonomy.

We have attached the JSON payload (SIT_Delta_Override_20260423_1342.json) used for this update for your reference.

Payload 1:

{
    "header": {
        "version": "2",
        "scope": [
            "all"
        ]
    },
    "attribute_values": [
        {
            "salsify:id": "Vivaan-Taxnomy",
            "salsify:attribute_id": "Category",
            "salsify:name": "Vivaan-Taxnomy",
            "salsify:localized_names": {}
        }
    ],
    "schema_rules": [
        {
            "salsify:attribute_id": "Active",
            "salsify:taxonomy_attribute_id": "Category",
            "salsify:taxonomy_attribute_value_id": "Vivaan-Taxnomy",
            "salsify:data_inheritance_hierarchy_level_id": null,
            "salsify:data_validation_rules": {},
            "salsify:rule_scopes":
        },
        {
            "salsify:attribute_id": "Active Date",
            "salsify:taxonomy_attribute_id": "Category",
            "salsify:taxonomy_attribute_value_id": "Vivaan-Taxnomy",
            "salsify:data_inheritance_hierarchy_level_id": null,
            "salsify:data_validation_rules": {},
            "salsify:rule_scopes":
        }
    ],
    "data_inheritance_hierarchies": [
        {
            "salsify:name": "Parent-Product > Child-Product",
            "salsify:taxonomy_attribute_value_ids": [
                {
                    "salsify:taxonomy_attribute_id": "Category",
                    "salsify:taxonomy_attribute_value_id": "Apparel_Alok"
                },
                {
                    "salsify:taxonomy_attribute_id": "Category",
                    "salsify:taxonomy_attribute_value_id": "CTC1"
                },
                {
                    "salsify:taxonomy_attribute_id": "Category",
                    "salsify:taxonomy_attribute_value_id": "kitchen & home_pp"
                },
                {
                    "salsify:taxonomy_attribute_id": "Category",
                    "salsify:taxonomy_attribute_value_id": "Vivaan-Taxnomy"
                }
            ],
            "salsify:levels": [
                {
                    "salsify:id": "Parent-Product",
                    "salsify:name": "Parent-Product",
                    "salsify:order": 0,
                    "salsify:variant_axis_identifiers": ,
                    "salsify:data_inheritance_hierarchy_level_tag_names":
                },
                {
                    "salsify:id": "Child-Product",
                    "salsify:name": "Child-Product",
                    "salsify:order": 1,
                    "salsify:variant_axis_identifiers": [
                        "aig_product_id"
                    ],
                    "salsify:data_inheritance_hierarchy_level_tag_names":
                }
            ]
        }
    ]
}

Payload 2 :

{
    "header": {
        "version": "2",
        "scope": [
            "all"
        ]
    },
    "data_inheritance_hierarchies": [
        {
            "salsify:name": "STYLE > SKU",
            "salsify:taxonomy_attribute_value_ids": [
                {
                    "salsify:taxonomy_attribute_id": "Category",
                    "salsify:taxonomy_attribute_value_id": "Gold Bond"
                }
            ],
            "salsify:levels": [
                {
                    "salsify:id": "STYLE",
                    "salsify:name": "STYLE",
                    "salsify:order": 0,
                    "salsify:variant_axis_identifiers": [
                        "ab_name"
                    ],
                    "salsify:data_inheritance_hierarchy_level_tag_names":
                },
                {
                    "salsify:id": "SKU",
                    "salsify:name": "SKU",
                    "salsify:order": 1,
                    "salsify:variant_axis_identifiers": [
                        "Product ID"
                    ],
                    "salsify:data_inheritance_hierarchy_level_tag_names":
                }
            ]
        },
        {
            "salsify:name": "Base > Flavor > Size > variant",
            "salsify:taxonomy_attribute_value_ids": [
                {
                    "salsify:taxonomy_attribute_id": "Category",
                    "salsify:taxonomy_attribute_value_id": "jackandjones"
                }
            ],
            "salsify:levels": [
                {
                    "salsify:id": "Base",
                    "salsify:name": "Base",
                    "salsify:order": 0,
                    "salsify:variant_axis_identifiers": [
                        "Formula Code"
                    ],
                    "salsify:data_inheritance_hierarchy_level_tag_names":
                },
                {
                    "salsify:id": "Flavor",
                    "salsify:name": "Flavor",
                    "salsify:order": 1,
                    "salsify:variant_axis_identifiers": [
                        "Flavor"
                    ],
                    "salsify:data_inheritance_hierarchy_level_tag_names":
                },
                {
                    "salsify:id": "Size",
                    "salsify:name": "Size",
                    "salsify:order": 2,
                    "salsify:variant_axis_identifiers": [
                        "Color_Alok"
                    ],
                    "salsify:data_inheritance_hierarchy_level_tag_names": [
                        "MCU"
                    ]
                },
                {
                    "salsify:id": "variant",
                    "salsify:name": "variant",
                    "salsify:order": 3,
                    "salsify:variant_axis_identifiers": ,
                    "salsify:data_inheritance_hierarchy_level_tag_names":
                }
            ]
        }
    ]
}
2

@Alok_Bnasal -

Attached payload has missing values for the below fields

"salsify:rule_scopes":
"salsify:variant_axis_identifiers":
"salsify:data_inheritance_hierarchy_level_tag_names":

As per Salsify documentation JSON Import Format
high level structure of the JSON document is

[
  { "header": { } },
  { "attributes": [ ] },
  { "attribute_values": [ ] },
  { "digital_assets": [ ] },
  { "products": [ ] }
]

But as per the attached payload , JSON object { } is being used at the top level.

Please try with the updated payloads below and let us know if you are still facing the issue.

Updated payload 1

[
  {
    "header": {
      "version": "2",
      "scope": ["all"]
    }
  },
  {
    "attribute_values": [
      {
        "salsify:id": "Vivaan-Taxnomy",
        "salsify:attribute_id": "Category",
        "salsify:name": "Vivaan-Taxnomy",
        "salsify:localized_names": {}
      }
    ]
  },
  {
    "schema_rules": [
      {
        "salsify:attribute_id": "Active",
        "salsify:taxonomy_attribute_id": "Category",
        "salsify:taxonomy_attribute_value_id": "Vivaan-Taxnomy",
        "salsify:data_inheritance_hierarchy_level_id": null,
        "salsify:data_validation_rules": {},
        "salsify:rule_scopes": []
      },
      {
        "salsify:attribute_id": "Active Date",
        "salsify:taxonomy_attribute_id": "Category",
        "salsify:taxonomy_attribute_value_id": "Vivaan-Taxnomy",
        "salsify:data_inheritance_hierarchy_level_id": null,
        "salsify:data_validation_rules": {},
        "salsify:rule_scopes": []
      }
    ]
  },
  {
    "data_inheritance_hierarchies": [
      {
        "salsify:name": "Parent-Product > Child-Product",
        "salsify:taxonomy_attribute_value_ids": [
          {
            "salsify:taxonomy_attribute_id": "Category",
            "salsify:taxonomy_attribute_value_id": "Apparel_Alok"
          },
          {
            "salsify:taxonomy_attribute_id": "Category",
            "salsify:taxonomy_attribute_value_id": "CTC1"
          },
          {
            "salsify:taxonomy_attribute_id": "Category",
            "salsify:taxonomy_attribute_value_id": "kitchen & home_pp"
          },
          {
            "salsify:taxonomy_attribute_id": "Category",
            "salsify:taxonomy_attribute_value_id": "Vivaan-Taxnomy"
          }
        ],
        "salsify:levels": [
          {
            "salsify:id": "Parent-Product",
            "salsify:name": "Parent-Product",
            "salsify:order": 0,
            "salsify:variant_axis_identifiers": [],
            "salsify:data_inheritance_hierarchy_level_tag_names": []
          },
          {
            "salsify:id": "Child-Product",
            "salsify:name": "Child-Product",
            "salsify:order": 1,
            "salsify:variant_axis_identifiers": ["aig_product_id"],
            "salsify:data_inheritance_hierarchy_level_tag_names": []
          }
        ]
      }
    ]
  }
]

Updated payload 2

[
  {
    "header": {
      "version": "2",
      "scope": ["all"]
    }
  },
  {
    "data_inheritance_hierarchies": [
      {
        "salsify:name": "STYLE > SKU",
        "salsify:taxonomy_attribute_value_ids": [
          {
            "salsify:taxonomy_attribute_id": "Category",
            "salsify:taxonomy_attribute_value_id": "Gold Bond"
          }
        ],
        "salsify:levels": [
          {
            "salsify:id": "STYLE",
            "salsify:name": "STYLE",
            "salsify:order": 0,
            "salsify:variant_axis_identifiers": ["ab_name"],
            "salsify:data_inheritance_hierarchy_level_tag_names": []
          },
          {
            "salsify:id": "SKU",
            "salsify:name": "SKU",
            "salsify:order": 1,
            "salsify:variant_axis_identifiers": ["Product ID"],
            "salsify:data_inheritance_hierarchy_level_tag_names": []
          }
        ]
      },
      {
        "salsify:name": "Base > Flavor > Size > variant",
        "salsify:taxonomy_attribute_value_ids": [
          {
            "salsify:taxonomy_attribute_id": "Category",
            "salsify:taxonomy_attribute_value_id": "jackandjones"
          }
        ],
        "salsify:levels": [
          {
            "salsify:id": "Base",
            "salsify:name": "Base",
            "salsify:order": 0,
            "salsify:variant_axis_identifiers": ["Formula Code"],
            "salsify:data_inheritance_hierarchy_level_tag_names": []
          },
          {
            "salsify:id": "Flavor",
            "salsify:name": "Flavor",
            "salsify:order": 1,
            "salsify:variant_axis_identifiers": ["Flavor"],
            "salsify:data_inheritance_hierarchy_level_tag_names": []
          },
          {
            "salsify:id": "Size",
            "salsify:name": "Size",
            "salsify:order": 2,
            "salsify:variant_axis_identifiers": ["Color_Alok"],
            "salsify:data_inheritance_hierarchy_level_tag_names": ["MCU"]
          },
          {
            "salsify:id": "variant",
            "salsify:name": "variant",
            "salsify:order": 3,
            "salsify:variant_axis_identifiers": [],
            "salsify:data_inheritance_hierarchy_level_tag_names": []
          }
        ]
      }
    ]
  }
]