Level 1 — TronCloud: Requirements

ingest Products, Prices, Stocks to enable discovery in TronShop & TronManager. Feeds accepted: CSV/XML/JSON (one structure per feed).

L1 feeds (minimum viable set)

Note: business restrictions (e.g., geo blocking) require PREMIUM membership or higher for extra parameters & filtering.

L1 Product Data — required fields

Field	Type	Constraints / Notes
ModelCode	string	Required, stable ID for the product model (groups variants). Must be unique per model across the catalog.
ProductCode	string	Required, SKU-level ID (variant). Unique per variant; 1:N relation with ModelCode
Color	string	Required for variant generation. Free text or normalized (e.g., “Navy”, “PMS 281”). Recommend a separate ColorCode column if available.
Size	string	Required if applicable (apparel, bags, etc.). Use consistent tokens (e.g., XS,S,M,L,XL; or numeric sizes).
Capacity	string/number	Required if applicable (e.g., “500 ml”). Keep numeric value and unit in separate fields when possible (CapacityValue, CapacityUnit).
ProductName	string	Required, human-readable name for storefronts and sourcing.
ImageURL	URL	Required, minimum 1000px longest side, JPG/PNG. White/transparent background preferred. One main image per variant; additional images optional.
CategoryPath	string	Optional but recommended for mapping; “Top > Sub > Leaf”.
DescriptionHTML	string	Optional; if provided, valid HTML.
Brand	string	Optional but recommended
Material	string	Optional; comma-separated if multiple.
Keywords	string	Optional; comma-separated.
CountryRestrictions	string	Optional; requires PREMIUM+ to enforce.

ModelCode uniqueness across the file.
ProductCode uniqueness across the file.
If Color/Size/Capacity are empty for a variant-driven product line, reject the row or map to “Default”.
ImageURL must return HTTP 200; MIME in {image/jpeg, image/png}.
If CapacityValue exists, CapacityUnit must be present (e.g., ml, L, GB).
Prohibit control characters in text fields; max length 256 for codes, 4,096 for descriptions.

Please specify which type of product prices you are using in your data. Our platform supports two options:

CATALOG (INDUSTRY) PRICES: Recommended end-selling prices. Each distributor sets one global individual discount agreed with you, and our system calculates their specific net purchase prices accordingly.
NET PURCHASE PRICES: Direct purchase prices provided to distributors.
INDIVIDUAL PRICES: Direct purchase prices provided to direct distributor.

Field	Type	Notes
ProductCode	string	Must match Product Data.
Currency	ISO 4217	e.g., EUR, CZK.
QtyBreak	integer	Price break quantity (e.g., 1, 50, 100, 250…).
UnitPrice	decimal	Net per unit at the break
ListPrice	decimal	Optional MSRP.
ValidFrom/ValidTo	ISO 8601 date	Optional; if omitted, treated as open-ended.
CustomerPriceGroup	string	Optional; requires higher membership to support individual pricing.

Field	Type	Notes
ProductCode	string	Must match Product Data.
WarehouseCode	string	Optional; default “MAIN”
InStock	integer	Current physical stock.
OnOrder	integer	Optional
ETA	ISO 8601 date	Optional expected arrival date.