Price/Sales Catalog

Price/Sales Catalog (832)

A Price/Sales Catalog (832) is sent by a supplier to communicate prices, product details, and catalog information to a trading partner.

Schema Overview Sample Downloads

Field	Type	Required	Description
catalogType	string	✓	Type of catalog being transmitted Values: `vendor`
catalogNumber	string	✓	Identifies the vendor or owner of the catalog. This is a static identifier for which catalog to access, not a unique transaction identifier.
selectionCode	string		Three-digit code identifying a product category grouping within the catalog. Vendors use selection codes to organize products and control trading partner access.
selectionCodeDescription	string		Free-form description of the selection code
purpose	string	✓	Action applied to all line items in this catalog transaction. When set to original, each line item specifies its own action. Values: `original` `add` `delete` `change` `replace`
sellersCurrencyshow child fieldshide child fields	object		Currency used for all prices in this transaction. Defaults to USD if not specified.
currencyCode	string	✓	ISO currency code (e.g., USD, EUR)
exchangeRate	string		Exchange rate for currency conversion
partiesshow child fieldshide child fields	object		Buying party receiving the catalog
buyershow child fieldshide child fields	object		Buying party receiving the catalog
name	string		Party name or company name
additionalName1	string		Additional name line 1
additionalName2	string		Additional name line 2
identificationCode	string		Party identification code value
identificationCodeType	string		N103: Codes 91 and 92 are specific to the direction of the transaction. Retail Example: For the 850 92 maps to sender and 91 maps to receiver. For the 856, 810 - sender maps to 91 and receiver maps to 92 Values: `sendersId` `receiversId` `duns` `plantCode` `dunsPlus4` `drugEnforcementAdmin` `telephone` `federalReserveRouting` `standardAddressSAN` `healthIndustryHIN` `warehouse` `schoolId` `memberId` `stateLicenseId` `globalLocationId`
addressLine1	string		Street address line 1
addressLine2	string		Street address line 2
addressLine3	string		Street address line 3
addressLine4	string		Street address line 4
city	string		City name
stateOrProvinceCode	string		State or province code
postalCode	string		Postal or ZIP code
countryCode	string		Country code (ISO)
zoneType	string		Address zone type Values: `residential` `commercial`
contactsshow child fieldshide child fields	array		Contact persons for this party
type	string	✓	Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number. Default source is the comm-number paired with a TE qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type (e.g.
faxNumber	string		Contact fax number. Default source is the comm-number paired with an FX qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on a comm-number element labels its value as fax even when the qualifier is TE/EM, follow the note and route the value here.
email	string		Contact email address. Default source is the comm-number paired with an EM qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type, follow the note and route accordingly.
suppliershow child fieldshide child fields	object		Supplier or vendor providing the catalog
name	string		Party name or company name
additionalName1	string		Additional name line 1
additionalName2	string		Additional name line 2
identificationCode	string		Party identification code value
identificationCodeType	string		N103: Codes 91 and 92 are specific to the direction of the transaction. Retail Example: For the 850 92 maps to sender and 91 maps to receiver. For the 856, 810 - sender maps to 91 and receiver maps to 92 Values: `sendersId` `receiversId` `duns` `plantCode` `dunsPlus4` `drugEnforcementAdmin` `telephone` `federalReserveRouting` `standardAddressSAN` `healthIndustryHIN` `warehouse` `schoolId` `memberId` `stateLicenseId` `globalLocationId`
addressLine1	string		Street address line 1
addressLine2	string		Street address line 2
addressLine3	string		Street address line 3
addressLine4	string		Street address line 4
city	string		City name
stateOrProvinceCode	string		State or province code
postalCode	string		Postal or ZIP code
countryCode	string		Country code (ISO)
zoneType	string		Address zone type Values: `residential` `commercial`
contactsshow child fieldshide child fields	array		Contact persons for this party
type	string	✓	Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number. Default source is the comm-number paired with a TE qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type (e.g.
faxNumber	string		Contact fax number. Default source is the comm-number paired with an FX qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on a comm-number element labels its value as fax even when the qualifier is TE/EM, follow the note and route the value here.
email	string		Contact email address. Default source is the comm-number paired with an EM qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type, follow the note and route accordingly.
vendorNumbershow child fieldshide child fields	object		Vendor or supplier identifier
value	string		The reference identifier value
description	string		Additional description or context for the reference
datesshow child fieldshide child fields	object
effectiveDate	unknown		Date when the changes in this transaction take effect
availableDate	unknown		First date the item is available to ship
discontinueDate	unknown		Date the item is discontinued and no longer available
lastChangeDate	unknown		Date the trade item data was last changed
bookingDate	unknown		First date the item is available for ordering
cancellationDate	unknown		Date the item is canceled. Applies only to items that were never introduced into the supply chain.
priceEffectiveDate	unknown		Date from which all prices in this transaction are effective. Applies to all CTP loop prices unless overridden at the line level.
priceExpirationDate	unknown		Date after which all prices in this transaction expire. Applies to all CTP loop prices unless overridden at the line level.
lineItemsshow child fieldshide child fields	array		Line items in the catalog transaction
action	string		Values: `add` `change` `delete`
productIdsshow child fieldshide child fields	object	✓	Product identification codes such as UPC, SKU, or vendor item number
buyerItemNumber	string		Buyer-assigned item number
vendorItemNumber	string		Vendor-assigned item number (EDIFACT LIN/PIA supplier
gtin12	string		GTIN-12 (UPC-A) barcode
gtin13	string		GTIN-13 (EAN) barcode
gtin14	string		GTIN-14 (ITF-14) case code barcode
caseCode	string		Case code identifier
drugCode	string		National Drug Code (NDC)
standardBookNumber	string		ISBN or standard book number
buyerItemIdsshow child fieldshide child fields	array		Additional buyer product identifiers
type	string	✓	Values: `catalog` `manufacturerPart` `sku` `style`
value	string	✓	Product identifier value
vendorItemIdsshow child fieldshide child fields	array		Additional vendor product identifiers
type	string	✓	Values: `catalog` `manufacturerPart` `sku` `style`
value	string	✓	Product identifier value
brandingshow child fieldshide child fields	object
brandName	string		Trade item brand name recognized by trade and consumer
tradeName	string		Brand or label name (trade name)
brandType	string		Brand classification (e.g., National Brand, Private Label, Exclusive to Retailer)
subBrand	string		Second-level trade name or brand
collectionName	string		Vendor collection name grouping related items
season	string		Season associated with the item (e.g., Fall, Spring, Summer, Winter, Holiday)
productStyle	string		Vendor
manufacturershow child fieldshide child fields	object		Name of the manufacturer of goods
name	string		Name of the manufacturer of goods
gln	string		Manufacturer
url	string		Manufacturer
brandOwnershow child fieldshide child fields	object		Brand owner
name	string		Brand owner
gln	string		Brand owner
descriptionshow child fieldshide child fields	object
summary	string		Primary product description
extended	string		Extended product description for longer text
department	string		Department or product category description
warrantyDescription	string		Warranty coverage or terms
horsepowerRating	string		Engine horsepower rating — a product specification for powered equipment
setPieces	string		Number of individual items in a grouped set (e.g., flatware set, cosmetics kit)
colorshow child fieldshide child fields	object
description	string		Vendor
vendorCode	string		Vendor-assigned color code
nrfCode	string		National Retail Federation (NRF) standardized color code (3-digit numeric)
pantoneCode	string		Primary Pantone color code (6-digit numeric)
accentPantoneCodes	array of string		Additional Pantone accent color codes (up to 4)
colorization	string		Appliance-specific color name (e.g. Almond, Bisque, Stainless)
sizeshow child fieldshide child fields	object
description	string		Vendor
vendorCode	string		Vendor-assigned size code
nrfCode	string		National Retail Federation (NRF) standardized size code (5-digit numeric)
capacityDescription	string		Volume or capacity description (e.g. 10 Gallons, 16 oz)
materialshow child fieldshide child fields	object
fabric	string		Fabric or material composition (free text)
fiber	string		Fiber type (thread or filament from which the textile is formed)
fabricOrMaterial	string		Structured code describing the fabric, material, or primary ingredient
fill	string		Fill or insulation material
lining	string		Lining material
sole	string		Sole material (footwear)
metal	string		Metal composition of the product
metalComposition	string		Metal composition of stainless steel flatware
leather	string		Animal species whose leather was used
finishshow child fieldshide child fields	object		Surface finish description (free text)
description	string		Surface finish description (free text)
code	string		Structured surface finish code
formulationshow child fieldshide child fields	object
ingredients	string		Full ingredient list (free text)
scentsOrFlavors	string		Scent, flavor, or variant name
keyActiveIngredient	string		Key or active ingredients
doesNotContain	string		Potential undesirable ingredients explicitly absent from this product
alcoholPercent	string		Percentage of alcohol content
careshow child fieldshide child fields	object
itemCareInstructionsCode	string		Coded care instructions for the product (e.g. apparel wash/dry codes)
itemUsageDescription	string		Instructions on how to prepare or store the item
recycleDescription	string		Recyclability or recycle instructions
returnGoodsPolicy	string		Destroy or return policy for damaged or non-salable items
targetingshow child fieldshide child fields	object
genderByAge	string		Primary gender and age group for which this GTIN is designed (e.g., Women
gender	string		The gender(s) for which this product is intended
consumerLifestage	string		Age or life stage group for which this product is intended
licensedshow child fieldshide child fields	object
playerName	string		Full name of professional player on product
sport	string		Type of sport associated with the item
league	string		Sports league associated with the product (e.g. NFL, NBA)
conference	string		Sports conference associated with the product
holidayEvent	string		Holiday or seasonal event associated with the product
attributesshow child fieldshide child fields	object		Attribute type — identifies which product characteristic this value represents
type	string	✓	Attribute type — identifies which product characteristic this value represents Values: `featuresBenefits` `gtinDescription` `itemLengthDescription` `pocketDetails` `productShape` `skuDescription` `oddSizeIndicator` `headwearBillType` `headwearCrown` `headwearFit` `collarType` `inseamLength` `dressSkirtLength` `sleeveLength` `closureType` `stoneDetails` `tireSpeedRating` `tireSegment` `adjustableStrap` `bagType` `bandType` `beautyAreaOfUse` `beautyTreatmentSpecialty` `beautyType` `beddingSize` `beddingType` `beltType` `billLogoApplication` `bootShaftType` `braBandType` `braBustType` `braCupCoverage` `braCupType` `braImpactLevel` `braPadding` `braSpecialtyType` `braType` `braceletType` `coatJacketType` `controlType` `cookwareType` `cuffType` `dinnerwareCategory` `dressType` `earringType` `eyewearType` `flatwareType` `formulation` `gauge` `gloveType` `hatType` `heelHeightRange` `heelMaterial` `heelType` `hosieryOrSockType` `jewelrySets` `jewelryType` `knitType` `legType` `lengthDescription` `linedCode` `necklaceType` `neckwearType` `numberOfSettings` `occasionList` `openClosedToe` `outsoleType` `pantsOrShortsType` `pantyBackCoverage` `pantyType` `primaryDetailApplication` `primaryDetailPlacement` `primaryDetailSize` `primaryDetailType` `primaryMotifTheme` `ringType` `rugType` `scarfType` `scentType` `seams` `secondaryDetailApplication` `secondaryDetailPlacement` `secondaryDetailSize` `secondaryDetailType` `secondaryMotifTheme` `shape` `shapewearType` `shoeStyle` `shoeType` `skinType` `skirtType` `sleepwearType` `slipType` `specialEmbellishment` `strapPlacement` `supportLevel` `sweaterPulloverType` `swimBottomType` `swimCoverUpType` `swimOnePieceType` `swimTopType` `tablewareType` `thirdDetailApplication` `thirdDetailPlacement` `thirdDetailSize` `thirdDetailType` `thirdMotifTheme` `toeShape` `toeStyle` `towelType` `waistRise` `waistbandType` `watchCaseShape` `waterRepellent`
value	string	✓	Attribute value
complianceshow child fieldshide child fields	object
msdsNumber	string		Material Safety Data Sheet (MSDS) number for hazardous materials compliance
hmisCode	string		Hazardous Materials Information System (HMIS) code — North American workplace hazmat classification
spfRating	string		Sun Protection Factor (SPF) rating — regulated UV protection claim required on sunscreen product labeling
harmonizedTariffScheduleshow child fieldshide child fields	object		International Harmonized Tariff Schedule (HTS) code
code	string	✓	International Harmonized Tariff Schedule (HTS) code
countryCode	string		ISO 3166-1 alpha-3 country code for this HTS classification
isCpsiaCompliant	boolean		Whether the item is compliant with the Consumer Product Safety Improvement Act (CPSIA)
isGeneticallyModified	boolean		Whether the item contains or was produced using genetically modified organisms (GMO)
hasProp65Warning	boolean		Whether the item requires a California Proposition 65 warning for chemical exposure
isRecalled	boolean		Whether the item has been recalled by the manufacturer
isIrradiated	boolean		Whether radiation has been applied to the trade item itself
isIrradiatedMaterial	boolean		Whether radiation has been applied to the item
isIrradiatedIngredient	boolean		Whether radiation has been applied to the item
isMarkedWithExpirationDate	boolean		Whether the item is stamped or imprinted with a freshness, sell-by, or use-by date
isMarkedWithBatchNumber	boolean		Whether the item is marked with a batch or lot number by the manufacturer
isFplaCompliant	boolean		Whether the item complies with the Fair Packaging and Labeling Act (FPLA)
isAerosol	boolean		Whether the item is pressurized and dispensed as a spray — drives regulatory requirements for storage, shipping, and labeling
sustainabilityshow child fieldshide child fields	object
certifications	array		Sustainability certifications held by this product. Covers chemical safety, circularity, raw materials sourcing, social standards, packaging, and traceability. Repeat once per certification. Values: `bluesign` `oekotexStandard100` `oekotexMadeInGreen` `zddhcMrsl` `cradleToCradle` `onePercentForPlanet` `bCorpCertified` `blueAngel` `euEcolabel` `naturetextilBest` `nordicSwan` `basfE3` `certifiedVegan` `cottonMadeInAfrica` `downpassStandard` `fibershed` `forestStewardshipCouncil` `gots` `globalRecycledStandard` `globalCashmereStandard` `leatherWorkingGroup` `newMerino` `organicCertified` `organicCottonStandard` `petaCertifiedVegan` `recot` `reDown` `reelCotton` `regenagri` `regenerativeOrganic` `responsibleAlpacaStandard` `responsibleDownStandard` `responsibleMohairStandard` `responsibleWoolStandard` `roundtableOnSustainableBiomaterials` `soilAssociationOrganic` `sustainableFibreAlliance` `traumpassLabel` `usCottonTrustProtocol` `usdaCertifiedBiobased` `usdaCertifiedOrganic` `veganTrademark` `zqMerino` `fairTradeCertified` `fairTradeTextileStandard` `rise` `fairForLife` `nmsdc` `nglcc` `uspaacc` `reusableOrRecyclable` `takeBackProgram` `archiveOrVintage` `rentableProduct` `charitableContributionPerPurchase` `oneForOne` `positiveLuxuryButterflyMark` `accreditation` `reusablePackaging` `recyclablePackaging` `packagingFree` `recycledPackagingMaterials` `fscCertifiedPackaging` `reducedPackaging` `upcycledMaterials` `recycledMaterials` `nonCertVegan` `biodegradableProductsInstitute` `betterCotton` `pefc` `canopyGreenShirt` `digitalPassport` `materialTraceability` `openHubSupply` `traceabilityProgram`
organicStatus	string		Organic status of the item per applicable standards (US, EU, or UK) Values: `organic100Percent` `organic` `madeWithOrganicIngredients` `someOrganicIngredients` `notOrganic`
originshow child fieldshide child fields	object
manufacturing	array of string		ISO 3166-1 alpha-3 country codes where this item is manufactured. Up to three countries.
advertised	string		Advertised or claimed country of origin (free text, e.g.
material	string		Country of origin for the primary materials used in production (ISO 3166-1 alpha-3)
classificationshow child fieldshide child fields	object
productType	string		Product grouping or function (e.g., Belts, Sweaters, Salad Dressing)
materialGroup	string		Vendor-specific product classification or material grouping
vendorPurchaseMethod	string		Values: `direct` `indirect` `domestic` `diverted`
salesOrganization	string		Selling unit responsible for product liability, customer deliveries, and business partner contacts
sellingChannel	string		Distribution channel — whether the product is sold in stores, online, or both
unSpscCode	string		UN/SPSC (United Nations Standard Products and Services Code) procurement classification
merchandiseClassification	string		Internal merchandise classification code
seasonalAvailability	string		Product lifecycle availability type (e.g. Evergreen, Seasonal, Made To Order)
reorderableProduct	string		Whether the item can be reordered — RY (yes) or RN (no)
prepackItemCode	string		Prepack assortment configuration type
specialItemCode	string		Promotional item classification — collateral (CL), gift with purchase (GW), or promotional item (PW)
allowedTradingPartners	array of string		Global Location Numbers (GLN) of trading partners permitted access to this private item. Repeat once per partner, up to 10.
targetMarketsshow child fieldshide child fields	object		ISO 3166-1 3-digit country code for the target market
countryCode	string	✓	ISO 3166-1 3-digit country code for the target market
subdivisionCode	string		Target market subdivision code (state/province) within the country
isBaseUnit	boolean		Whether this GTIN is the lowest level item in the packaging hierarchy
isConsumerUnit	boolean		Whether this GTIN is intended for ultimate consumption — the item typically scanned at point of sale
isDespatchUnit	boolean		Whether the seller considers this GTIN a shippable/despatch unit
isOrderableUnit	boolean		Whether the seller will accept purchase orders for this GTIN
isInvoiceUnit	boolean		Whether the seller will include this GTIN on invoices
physicalDetailsshow child fieldshide child fields	object		Physical dimensions and packaging of this item as a consumer unit — dimensions, weight, volume, and packaging type
numberOfUnits	string		Number of units at this packaging level
size	string		Size or net content quantity at this packaging level
sizeUOM	string		Unit of measure for size or net content Values: `bag` `can` `capsule` `carton` `case` `centiliter` `dozen` `each` `fluidOunce` `gallon` `gram` `kilogram` `liter` `milliliter` `ounce` `package` `pair` `piece` `pint` `pound` `quart` `roll` `tablet` `thousand` `yard`
height	string		Height of this packaging level when upright
width	string		Width (shorter horizontal dimension) of this packaging level when upright
length	string		Length (longer horizontal dimension) of this packaging level when upright
dimensionUOM	string		Unit of measure for linear dimensions. Applies to height, width, and length — all three must use the same unit. Values: `centimeter` `decimeter` `foot` `inch` `millimeter` `meter` `yard`
grossWeight	string		Gross weight including all packaging materials
netWeight	string		Net weight excluding packaging materials
weightUOM	string		Unit of measure for weight. Values: `gram` `kilogram` `pound` `ounce`
volume	string		Volume (cube) of this packaging level
volumeUOM	string		Unit of measure for volume Values: `centiliter` `cubicCentimeter` `cubicFeet` `cubicInches` `cubicMeter` `cubicYard` `deciliter` `fluidOunce` `gallon` `liter` `milliliter` `pint` `quart`
packageForm	string		Form or type of the packaging container Values: `bag` `bale` `barrel` `bundle` `bulk` `bottle` `box` `boxWithInnerContainer` `can` `case` `coil` `crate` `drum` `jar` `keg` `liners` `loose` `pail` `package` `pallet` `reel` `roll` `spool` `tube` `tank` `tray` `wheeledCarrier` `wrapped`
packageMaterial	string		Material used for the packaging container Values: `corrugated` `fiber` `glass` `metal` `plastic` `wood`
innerPackshow child fieldshide child fields	object		Physical characteristics of the inner pack. For QRS/OpenText partners, dimensions come from PKL (used when the inner pack has no GTIN). For other partners, numberOfUnits (from PO414) is the primary field.
numberOfUnits	string		Number of units at this packaging level
size	string		Size or net content quantity at this packaging level
sizeUOM	string		Unit of measure for size or net content Values: `bag` `can` `capsule` `carton` `case` `centiliter` `dozen` `each` `fluidOunce` `gallon` `gram` `kilogram` `liter` `milliliter` `ounce` `package` `pair` `piece` `pint` `pound` `quart` `roll` `tablet` `thousand` `yard`
height	string		Height of this packaging level when upright
width	string		Width (shorter horizontal dimension) of this packaging level when upright
length	string		Length (longer horizontal dimension) of this packaging level when upright
dimensionUOM	string		Unit of measure for linear dimensions. Applies to height, width, and length — all three must use the same unit. Values: `centimeter` `decimeter` `foot` `inch` `millimeter` `meter` `yard`
grossWeight	string		Gross weight including all packaging materials
netWeight	string		Net weight excluding packaging materials
weightUOM	string		Unit of measure for weight. Values: `gram` `kilogram` `pound` `ounce`
volume	string		Volume (cube) of this packaging level
volumeUOM	string		Unit of measure for volume Values: `centiliter` `cubicCentimeter` `cubicFeet` `cubicInches` `cubicMeter` `cubicYard` `deciliter` `fluidOunce` `gallon` `liter` `milliliter` `pint` `quart`
packageForm	string		Form or type of the packaging container Values: `bag` `bale` `barrel` `bundle` `bulk` `bottle` `box` `boxWithInnerContainer` `can` `case` `coil` `crate` `drum` `jar` `keg` `liners` `loose` `pail` `package` `pallet` `reel` `roll` `spool` `tube` `tank` `tray` `wheeledCarrier` `wrapped`
packageMaterial	string		Material used for the packaging container Values: `corrugated` `fiber` `glass` `metal` `plastic` `wood`
outerPackshow child fieldshide child fields	object		Physical characteristics of the vendor selling unit (master pack or case)
numberOfUnits	string		Number of units at this packaging level
size	string		Size or net content quantity at this packaging level
sizeUOM	string		Unit of measure for size or net content Values: `bag` `can` `capsule` `carton` `case` `centiliter` `dozen` `each` `fluidOunce` `gallon` `gram` `kilogram` `liter` `milliliter` `ounce` `package` `pair` `piece` `pint` `pound` `quart` `roll` `tablet` `thousand` `yard`
height	string		Height of this packaging level when upright
width	string		Width (shorter horizontal dimension) of this packaging level when upright
length	string		Length (longer horizontal dimension) of this packaging level when upright
dimensionUOM	string		Unit of measure for linear dimensions. Applies to height, width, and length — all three must use the same unit. Values: `centimeter` `decimeter` `foot` `inch` `millimeter` `meter` `yard`
grossWeight	string		Gross weight including all packaging materials
netWeight	string		Net weight excluding packaging materials
weightUOM	string		Unit of measure for weight. Values: `gram` `kilogram` `pound` `ounce`
volume	string		Volume (cube) of this packaging level
volumeUOM	string		Unit of measure for volume Values: `centiliter` `cubicCentimeter` `cubicFeet` `cubicInches` `cubicMeter` `cubicYard` `deciliter` `fluidOunce` `gallon` `liter` `milliliter` `pint` `quart`
packageForm	string		Form or type of the packaging container Values: `bag` `bale` `barrel` `bundle` `bulk` `bottle` `box` `boxWithInnerContainer` `can` `case` `coil` `crate` `drum` `jar` `keg` `liners` `loose` `pail` `package` `pallet` `reel` `roll` `spool` `tube` `tank` `tray` `wheeledCarrier` `wrapped`
packageMaterial	string		Material used for the packaging container Values: `corrugated` `fiber` `glass` `metal` `plastic` `wood`
measurementsshow child fieldshide child fields	object		Unpackaged item dimensions and specialty measurements. Complements physicalDetails (G55), which carries packaged dimensions.
heightshow child fieldshide child fields	object		Unpackaged consumer item height
value	string	✓
uom	string	✓	Values: `centimeter` `decimeter` `foot` `inch` `millimeter` `meter` `yard`
widthshow child fieldshide child fields	object		Unpackaged consumer item width
value	string	✓
uom	string	✓	Values: `centimeter` `decimeter` `foot` `inch` `millimeter` `meter` `yard`
lengthshow child fieldshide child fields	object		Unpackaged consumer item length
value	string	✓
uom	string	✓	Values: `centimeter` `decimeter` `foot` `inch` `millimeter` `meter` `yard`
depthshow child fieldshide child fields	object		Unpackaged consumer item depth
value	string	✓
uom	string	✓	Values: `centimeter` `decimeter` `foot` `inch` `millimeter` `meter` `yard`
diametershow child fieldshide child fields	object		Unpackaged consumer item diameter
value	string	✓
uom	string	✓	Values: `centimeter` `decimeter` `foot` `inch` `millimeter` `meter` `yard`
netWeightshow child fieldshide child fields	object		Unpackaged consumer item net weight
value	string	✓
uom	string	✓	Values: `gram` `kilogram` `pound` `ounce`
drainedWeightshow child fieldshide child fields	object		Drained weight of the consumer item — for canned or liquid goods, the weight excluding liquid
value	string	✓
uom	string	✓	Values: `gram` `kilogram` `pound` `ounce`
volumeshow child fieldshide child fields	object		Unpackaged consumer item volume (cube)
value	string	✓
uom	string	✓	Values: `centiliter` `cubicCentimeter` `cubicFeet` `cubicInches` `cubicMeter` `cubicYard` `deciliter` `fluidOunce` `gallon` `liter` `milliliter` `pint` `quart`
heelHeightshow child fieldshide child fields	object		Heel height — footwear
value	string	✓
uom	string	✓	Values: `centimeter` `decimeter` `foot` `inch` `millimeter` `meter` `yard`
platformHeightshow child fieldshide child fields	object		Platform height — footwear
value	string	✓
uom	string	✓	Values: `centimeter` `decimeter` `foot` `inch` `millimeter` `meter` `yard`
bootLegCircumferenceshow child fieldshide child fields	object		Boot leg circumference — footwear
value	string	✓
uom	string	✓	Values: `centimeter` `decimeter` `foot` `inch` `millimeter` `meter` `yard`
sleeveMeasurementshow child fieldshide child fields	object		Sleeve measurement — apparel
value	string	✓
uom	string	✓	Values: `centimeter` `decimeter` `foot` `inch` `millimeter` `meter` `yard`
shaftHeightshow child fieldshide child fields	object		Shaft height — footwear or apparel
value	string	✓
uom	string	✓	Values: `centimeter` `decimeter` `foot` `inch` `millimeter` `meter` `yard`
sublineItemsshow child fieldshide child fields	array		Component GTINs in a prepack or packaging container, or a substitute GTIN signal
sublineId	string		Subline item identifier
relationshipCode	string		Relationship of this subline component to the parent container Values: `included` `delete` `substitute`
quantityshow child fieldshide child fields	object		Quantity for the subline item
value	string	✓	Numeric quantity value
unitOfMeasure	string		Unit of measure for the quantity Values: `assembly` `assortment` `bag` `bale` `ball` `bar` `barrel` `belt` `bin` `block` `boardFeet` `bolt` `book` `bottle` `box` `bulk` `bundle` `bushel` `cake` `can` `card` `carton` `cartridge` `case` `cassette` `celsius` `cell` `centigram` `centiliter` `centimeter` `coil` `combo` `cone` `container` `count` `cover` `display` `dozen` `drum` `each` `flakeTon` `foot` `gallon` `gram` `gramsPerLiter` `inch` `kilogram` `kit` `knots` `linearFoot` `liter` `meter` `milliliter` `monetaryValue` `ocularInsertSystem` `order` `ounce` `packPAK` `package` `pad` `pail` `pair` `pairInches` `palletLift` `palletUnitLoad` `person` `piece` `pint` `pound` `poundEquivalent` `poundGross` `quart` `reel` `roll` `section` `set` `sheet` `sixPack` `squareFoot` `syringe` `thousand` `threePack` `tote` `tube` `unit` `vial`
productIdsshow child fieldshide child fields	object		GTIN-12 (UPC-A) barcode
gtin12	string		GTIN-12 (UPC-A) barcode
gtin13	string		GTIN-13 (EAN) barcode
gtin14	string		GTIN-14 (ITF-14) case code barcode
caseCode	string		Case code identifier
replacedProductIdsshow child fieldshide child fields	object		GTIN-12 (UPC-A) barcode of the item being replaced
gtin12	string		GTIN-12 (UPC-A) barcode of the item being replaced
gtin13	string		GTIN-13 (EAN) barcode of the item being replaced
gtin14	string		GTIN-14 (ITF-14) case code barcode of the item being replaced
caseCode	string		Case code identifier of the item being replaced
datesshow child fieldshide child fields	object
availableDate	unknown		First date this item is available to ship
discontinueDate	unknown		Date this item is discontinued and no longer available
lastChangeDate	unknown		System-generated date when this GTIN was last changed
bookingDate	unknown		First date this item is available for ordering
effectiveDate	unknown		Date the changes to this item take effect
cancellationDate	unknown		Date this GTIN is canceled. Applies only to items that were never introduced into the supply chain.
publicationDate	unknown		Date this trade item data becomes available for viewing and synchronization
shelfLifeExpirationDate	unknown		Shelf life expiration date for perishable goods
endAvailabilityDate	unknown		Date this trade item ceases to be available. Used for seasonal and temporary items.
consumerAvailabilityDate	unknown		First date buyers are allowed to sell this item to consumers
pricesshow child fieldshide child fields	array		Prices for this line item. Repeats per price type, currency, or trading partner.
type	string	✓	Type of price Values: `unitCost` `suggestedRetailPrice` `minimumAdvertisedPrice` `introductoryPrice` `retailPriceOnItem`
price	string	✓	Price per unit
quantityshow child fieldshide child fields	object		Basis quantity and unit for this price (e.g. 12 DZ when price is per dozen)
value	string	✓	Numeric quantity value
unitOfMeasure	string		Unit of measure for the quantity Values: `assembly` `assortment` `bag` `bale` `ball` `bar` `barrel` `belt` `bin` `block` `boardFeet` `bolt` `book` `bottle` `box` `bulk` `bundle` `bushel` `cake` `can` `card` `carton` `cartridge` `case` `cassette` `celsius` `cell` `centigram` `centiliter` `centimeter` `coil` `combo` `cone` `container` `count` `cover` `display` `dozen` `drum` `each` `flakeTon` `foot` `gallon` `gram` `gramsPerLiter` `inch` `kilogram` `kit` `knots` `linearFoot` `liter` `meter` `milliliter` `monetaryValue` `ocularInsertSystem` `order` `ounce` `packPAK` `package` `pad` `pail` `pair` `pairInches` `palletLift` `palletUnitLoad` `person` `piece` `pint` `pound` `poundEquivalent` `poundGross` `quart` `reel` `roll` `section` `set` `sheet` `sixPack` `squareFoot` `syringe` `thousand` `threePack` `tote` `tube` `unit` `vial`
effectiveDate	unknown		Date from which this price is effective
expirationDate	unknown		Date after which this price expires
leadTime	string		Number of time units from purchase order receipt to shipment Values: `calendarDays` `workDays` `hours` `months` `weeks`
taxesshow child fieldshide child fields	object		Type of tax applicable to this line item
taxType	string	✓	Type of tax applicable to this line item Values: `stadiumTax` `surtax` `departureTax` `accommodationsTax` `adValoremTax` `coinOperatedDeviceTax` `corporateIncomeTax` `employmentTax` `estateTax` `feeInLieu` `gamingTax` `giftTax` `highwayFuelUseTax` `iftaTax` `individualIncomeTax` `inheritanceTax` `motorFuelTax` `personalPropertyTax` `assessment` `realPropertyTax` `severanceTax` `solidWasteTax` `tobaccoTax` `tourismTax` `transitTax` `unemploymentTax` `useTax` `withholdingTax` `workersCompensationTax` `harmonizedSalesTax` `businessPrivilegeTax` `cityTax` `thresholdTax` `federalGstOnGoods` `cityRentalTax` `countyParishSalesTax` `countyRentalTax` `citySalesTax` `countyTax` `federalGstOnServices` `defaultLaborTax` `equipmentTax` `energyTax` `environmentalTax` `ficaTax` `ficaMedicareTax` `ficaSocialSecurityTax` `federalTax` `fuelSuperfundTax` `federalIncomeTaxWithholding` `fuelLustTax` `franchiseTax` `fuelSpillTax` `federalExciseTax` `grossReceiptsTax` `goodsAndServicesTax` `publicHealthEducationTax` `handicapTax` `hazardousWasteTax` `laborByTradeTax` `localTax` `stateLocalSalesTax` `localSalesTax` `lustTaxFederal` `lustTaxState` `materialTax` `minimumTax` `municipalTax` `miscellaneousStateTax` `metropolitanTransitTax` `otherTaxes` `occupationalTax` `provincialTaxOnGoods` `provincialTaxOnServices` `provincialFuelTax` `secondaryPercentageTax` `schoolTax` `stateExciseTax` `superfundTax` `stateLocalTax` `stateTax` `stateRentalTax` `stateSpecificLaborTax` `stateSalesTax` `salesAndUseTax` `enhanced911StateExciseTax` `preThresholdTax` `postThresholdTax` `tddServiceExciseTax` `telecommunicationsTax` `allTaxes` `licenseTax` `utilityUsersTax` `valueAddedTax` `wellServiceTax` `cityEmergencyTax` `countyEmergencyTax` `exciseEmergencyTax` `stateEmergencyTax` `emergencyTax`
amount	string		Tax amount in the transaction currency. Mutually exclusive with rate.
rate	string		Tax rate as a decimal percentage (e.g.,
agency	string		Tax jurisdiction code identifying the taxing authority (e.g., state abbreviation or agency identifier)

{
  "catalogType": "vendor",
  "catalogNumber": "ACME-APPAREL-2025",
  "selectionCode": "010",
  "selectionCodeDescription": "Men's Activewear",
  "purpose": "original",
  "sellersCurrency": {
    "currencyCode": "USD"
  },
  "parties": {
    "buyer": {
      "name": "Nordstrom, Inc.",
      "identificationCode": "0083322955226",
      "identificationCodeType": "globalLocationId"
    },
    "supplier": {
      "name": "Acme Apparel Co.",
      "identificationCode": "0012345678906",
      "identificationCodeType": "globalLocationId"
    }
  },
  "vendorNumber": {
    "value": "V-98765",
    "description": "Nordstrom vendor account number"
  },
  "dates": {
    "effectiveDate": "2025-01-01",
    "priceEffectiveDate": "2025-01-01",
    "priceExpirationDate": "2025-12-31"
  },
  "lineItems": [
    {
      "action": "add",
      "productIds": {
        "vendorItemNumber": "ACT-TEE-BLU-M",
        "gtin12": "012345678901"
      },
      "branding": {
        "brandName": "AcmeSport",
        "tradeName": "AcmeSport Active",
        "subBrand": "Endurance Series",
        "collectionName": "Spring 2025 Active Collection",
        "season": "Spring",
        "productStyle": "ENDURANCE-TEE-001",
        "manufacturer": {
          "name": "Acme Apparel Manufacturing Ltd.",
          "gln": "0012345678999",
          "url": "https://www.acmeapparel.com/manufacturing"
        },
        "brandOwner": {
          "name": "Acme Apparel Co.",
          "gln": "0012345678906"
        }
      },
      "description": {
        "summary": "Men's Short Sleeve Performance T-Shirt, Pacific Blue, Medium",
        "extended": "Moisture-wicking performance tee designed for high-intensity training. Flatlock seams reduce chafing. Four-way stretch fabric provides unrestricted movement.",
        "department": "Men's Activewear"
      },
      "color": {
        "description": "Pacific Blue",
        "nrfCode": "409",
        "vendorCode": "PACBLU"
      },
      "size": {
        "description": "Medium",
        "nrfCode": "00300",
        "vendorCode": "M"
      },
      "material": {
        "fabric": "90% Polyester, 10% Elastane",
        "fiber": "Polyester"
      },
      "care": {
        "itemCareInstructionsCode": "MA",
        "itemUsageDescription": "Machine wash cold, tumble dry low. Do not bleach. Do not iron."
      },
      "targeting": {
        "genderByAge": "Men's",
        "gender": "Male"
      },
      "attributes": [
        {
          "type": "featuresBenefits",
          "value": "Moisture-wicking technology keeps you dry and comfortable during intense activity"
        },
        {
          "type": "featuresBenefits",
          "value": "UPF 30+ sun protection rated fabric"
        }
      ],
      "compliance": {
        "harmonizedTariffSchedule": [
          {
            "code": "6109.10.0012",
            "countryCode": "USA"
          }
        ],
        "isCpsiaCompliant": false,
        "hasProp65Warning": false,
        "isGeneticallyModified": false,
        "isMarkedWithExpirationDate": false
      },
      "sustainability": {
        "certifications": ["bluesign"],
        "organicStatus": "notOrganic"
      },
      "origin": {
        "manufacturing": ["VNM", "BGD"],
        "advertised": "Made in Vietnam"
      },
      "classification": {
        "productType": "T-Shirts",
        "vendorPurchaseMethod": "direct",
        "seasonalAvailability": "Seasonal",
        "reorderableProduct": "RY",
        "sellingChannel": "Both",
        "isBaseUnit": true,
        "isConsumerUnit": true,
        "isOrderableUnit": true,
        "isInvoiceUnit": true,
        "targetMarkets": [
          {
            "countryCode": "840"
          },
          {
            "countryCode": "124"
          }
        ]
      },
      "physicalDetails": {
        "numberOfUnits": "1",
        "height": "11.5",
        "width": "8.75",
        "length": "3.0",
        "dimensionUOM": "inch",
        "grossWeight": "0.52",
        "netWeight": "0.44",
        "weightUOM": "pound",
        "packageForm": "package",
        "packageMaterial": "plastic"
      },
      "innerPack": {
        "numberOfUnits": "6",
        "height": "14.0",
        "width": "10.5",
        "length": "9.5",
        "dimensionUOM": "inch",
        "grossWeight": "3.5",
        "weightUOM": "pound"
      },
      "outerPack": {
        "numberOfUnits": "24",
        "height": "16.0",
        "width": "12.0",
        "length": "18.0",
        "dimensionUOM": "inch",
        "grossWeight": "14.5",
        "netWeight": "12.2",
        "weightUOM": "pound",
        "packageForm": "case",
        "packageMaterial": "corrugated"
      },
      "measurements": {
        "height": {
          "value": "28.0",
          "uom": "inch"
        },
        "width": {
          "value": "20.0",
          "uom": "inch"
        },
        "netWeight": {
          "value": "0.44",
          "uom": "pound"
        }
      },
      "dates": {
        "availableDate": "2025-02-01",
        "effectiveDate": "2025-01-01",
        "lastChangeDate": "2024-11-15",
        "bookingDate": "2025-01-01"
      },
      "prices": [
        {
          "type": "unitCost",
          "price": "12.50",
          "quantity": {
            "value": "1",
            "unitOfMeasure": "each"
          },
          "effectiveDate": "2025-01-01",
          "expirationDate": "2025-12-31"
        },
        {
          "type": "suggestedRetailPrice",
          "price": "34.99",
          "quantity": {
            "value": "1",
            "unitOfMeasure": "each"
          }
        },
        {
          "type": "minimumAdvertisedPrice",
          "price": "27.99",
          "quantity": {
            "value": "1",
            "unitOfMeasure": "each"
          }
        }
      ],
      "leadTime": {
        "quantity": "45",
        "unit": "calendarDays"
      },
      "taxes": [
        {
          "taxType": "stateSalesTax",
          "rate": "0.0825",
          "agency": "TX"
        }
      ]
    },
    {
      "action": "change",
      "productIds": {
        "vendorItemNumber": "ACT-POLO-NAV-L",
        "gtin12": "012345678918"
      },
      "branding": {
        "brandName": "AcmeSport",
        "collectionName": "Spring 2025 Active Collection",
        "season": "Spring"
      },
      "description": {
        "summary": "Men's Licensed Golf Performance Polo, Classic Navy, Large",
        "department": "Men's Activewear"
      },
      "color": {
        "description": "Classic Navy",
        "nrfCode": "319",
        "vendorCode": "NAVY"
      },
      "size": {
        "description": "Large",
        "nrfCode": "00400",
        "vendorCode": "L"
      },
      "material": {
        "fabric": "100% Polyester pique"
      },
      "targeting": {
        "genderByAge": "Men's"
      },
      "licensed": {
        "playerName": "Alex Johnson",
        "sport": "Golf",
        "league": "PGA Tour"
      },
      "attributes": [
        {
          "type": "featuresBenefits",
          "value": "Odor-resistant antimicrobial finish"
        }
      ],
      "compliance": {
        "harmonizedTariffSchedule": [
          {
            "code": "6105.10.0010",
            "countryCode": "USA"
          }
        ]
      },
      "origin": {
        "manufacturing": ["BGD"]
      },
      "classification": {
        "productType": "Polo Shirts",
        "isBaseUnit": true,
        "isConsumerUnit": true,
        "isOrderableUnit": true
      },
      "physicalDetails": {
        "numberOfUnits": "1",
        "grossWeight": "0.65",
        "weightUOM": "pound"
      },
      "outerPack": {
        "numberOfUnits": "12",
        "grossWeight": "8.5",
        "weightUOM": "pound",
        "packageForm": "case",
        "packageMaterial": "corrugated"
      },
      "replacedProductIds": {
        "gtin12": "012345671234"
      },
      "dates": {
        "availableDate": "2025-02-01",
        "effectiveDate": "2025-01-01"
      },
      "prices": [
        {
          "type": "unitCost",
          "price": "15.75",
          "quantity": {
            "value": "1",
            "unitOfMeasure": "each"
          }
        },
        {
          "type": "suggestedRetailPrice",
          "price": "42.50"
        }
      ],
      "leadTime": {
        "quantity": "45",
        "unit": "calendarDays"
      }
    },
    {
      "action": "add",
      "productIds": {
        "vendorItemNumber": "ACT-SET-BLU-M",
        "gtin14": "00012345678908"
      },
      "branding": {
        "brandName": "AcmeSport",
        "collectionName": "Spring 2025 Active Collection"
      },
      "description": {
        "summary": "Men's Activewear 2-Piece Set (Tee + Shorts), Pacific Blue, Medium"
      },
      "classification": {
        "productType": "Activewear Sets",
        "isBaseUnit": false,
        "isConsumerUnit": false,
        "isDespatchUnit": true,
        "isOrderableUnit": true
      },
      "physicalDetails": {
        "numberOfUnits": "2",
        "packageForm": "box",
        "packageMaterial": "corrugated"
      },
      "sublineItems": [
        {
          "sublineId": "1",
          "relationshipCode": "included",
          "quantity": {
            "value": "1",
            "unitOfMeasure": "each"
          },
          "productIds": {
            "gtin12": "012345678901"
          }
        },
        {
          "sublineId": "2",
          "relationshipCode": "included",
          "quantity": {
            "value": "1",
            "unitOfMeasure": "each"
          },
          "productIds": {
            "gtin12": "012345678925"
          }
        }
      ],
      "dates": {
        "availableDate": "2025-02-01",
        "effectiveDate": "2025-01-01"
      },
      "prices": [
        {
          "type": "unitCost",
          "price": "23.00",
          "quantity": {
            "value": "1",
            "unitOfMeasure": "each"
          }
        },
        {
          "type": "suggestedRetailPrice",
          "price": "64.99"
        }
      ],
      "leadTime": {
        "quantity": "45",
        "unit": "calendarDays"
      }
    }
  ]
}

File	Description	Download
sample.json	Sample JSON payload	Download
schema.json	JSON Schema for validation	Download
schema.csv	Schema fields in CSV format	Download