Syndigo Snap Pack

Overview

Syndigo is a content management and syndication platform that enables organizations to manage and distribute rich product content across multiple e-commerce platforms.

SnapLogic serves as an intelligent integration layer that connects, transforms, and syndicates product content between Syndigo, retailer platforms, and external systems making their integrations scalable, efficient, and reliable even for the resellers and the analytics platforms.

About RSJSON format

RSJSON (Rich Structured JSON) is a custom JSON-based format used by Syndigo to represent and exchange rich product content. It is designed to:
  • Support complex product hierarchies
  • Handle rich media assets such as images, videos, documents
  • Include localized data such as multilingual descriptions
  • Maintain attribute-driven product details such as ingredients, dimensions
  • Preserve data relationships between entities such as parent and child SKUs
Though RSJSON is ideal for capturing rich and flexible product content, integrations with external systems expect simpler and flattened JSON structures to read and parse the information. Learn more about RSJSON parser mappings.
To that end, the following Snaps in this Snap Pack enable easy integrations with the Syndigo’s Product Information Management (PIM) and Master Data Management (MDM) interfaces:
  • Syndigo Read: Reads (retrieves) content records from the Syndigo in their default RSJSON format or the simplified JSON format.
  • RSJSON Parser: Transforms the product information stored in RSJSON format to simplified JSON format for easier consumption by external systems.
  • Syndigo Search: Enables searching for content records from the Syndigo.
  • RSJSON Formatter: Formats the product information stored in normal JSON format to RSJSON format for ingesting rich data about products into Syndigo’s information stores.
  • Syndigo Create: Enables creating new product records in the product inventory.
  • Syndigo Update: Enables updating existing product records in the product inventory.
  • Syndigo Upsert: Performs only create, update, and delete actions based on matching attributes.
  • Syndigo Delete: Enables deleting product records from the product inventory.

Syndigo domain names

The permitted values for the Domain fields across this Snap Pack are:
  • thing
  • digitalAsset
  • location
  • referenceData
  • party
  • UOMData
  • taxonomyModel

Metadata Cache

To speed things up and avoid duplicate API calls, the system stores commonly used metadata in memory. This includes things like:
  • Entity definitions – what your data objects look like
  • Domain mappings – how data fields connect across systems
  • Context configurations – settings for how data is processed
  • Match configurations – rules for how records are matched

This cached data is stored at the JVM (Java Virtual Machine) level, so all pipelines running on the same Snaplex node can share and reuse it. There is no need to fetch the same information again.

Note: The default cache is refreshed every 24 hours. The cache loads data on demand and automatically refreshes entries when they expire, keeping itself up to date. By default, the metadata cache stores up to 100 entries and refreshes entries after 1440 minutes (24 hours), and can be updated using the JVM properties specified in the table below.

Configuration

You can configure the following Snap Pack behavior using JVM properties:

Property Description Default
snaplogic.syndigo.metadata.cache.size Maximum number of cache entries 100
snaplogic.syndigo.metadata.cache.duration.minutes Cache entry time-to-live (TTL) in minutes 1440 (24 hours)
snaplogic.syndigo.extended.logging.max.body.chars Maximum number of characters from the HTTP request or response body to include in extended request log entries. Reduce this value to limit log growth. 1000

Troubleshooting

Enable extended request logging

When a Syndigo Snap behaves unexpectedly, you can enable extended request logging to capture the full HTTP exchange — including request and response payloads — in the Snaplex runtime log. All Snaps in this Snap Pack (including RSJSON Formatter and RSJSON Parser, which fetch metadata from Syndigo) write these entries.

To enable extended request logging, set the log level to DEBUG for the com.snaplogic.snaps.syndigopim logger on your Snaplex and re-run the pipeline.

Note:
  • Sensitive header values (such as auth-client-secret) are automatically masked in the log output.
  • Request and response bodies are truncated at 1000 characters by default. To change this limit, set the snaplogic.syndigo.extended.logging.max.body.chars JVM property on the Snaplex. See the Configuration table.