inRiver JSONL Export Technical Specification

Last Updated: Thu, 05 Feb 2026 15:20:26 -0600
Owner: Aperture Labs (Brandon Spor)
Stakeholder: Watsco (Randy Gonthier)

Delivery Schedule

AttributeFile

• Frequency: Daily
• Scope: System-wide attribute metadata for all entity types
• Purpose: Provides schema reference for all exports

Entity Exports (Product, Item, ChannelNode)

• Frequency: Near Real-Time (NRT)
• Delivery Method: S3
• Scope: Per business unit (separate exports for each BU)
• Type: Delta updates only

CVL Field Types

Multi-Select CVL

Fields that allow multiple values from a controlled vocabulary.

Structure:

"FieldName": {
  "keys": ["key1", "key2"],
  "values": ["value1", "value2"]
}

Known Fields:

• ItemCountryofOrigin

Single-Select CVL

Fields that allow one value from a controlled vocabulary.

Structure:

"FieldName": {
  "key": "key1",
  "value": "value1"
}

Known Fields:

• ItemItemQuantityType

Implementation Notes

• Keys and values in multi-select arrays must maintain ordinal position alignment
• Single-select CVLs use object notation even when only one value is present
• Structure explicitly distinguishes between single and multi-select types in the payload