File PrefixSALE
Current VersionV2
AttributeFormatLengthRequiredDescriptionExample
sale_refAlphanumeric1-255YesUnique sale reference descriptor103495
product_refAlphanumeric1-255YesSale of given productB01N53LF
quantityNumeric1-7YesQuantity3
priceNumeric1-10YesUnit Price of the sale599.90
currency_codeISO 4217 Must belong to our supported currencies3YesCurrency for the saleUSD
created_atDate and time ISO 8601 (UTC)19YesDate and time the sale occurred (in UTC)2022-01-17T10:15:18
skuAlphanumeric1-255NoSKU of product variant of the saleB01N53LF
shopper_refAlphanumeric1-255YesShopper who made the purchasedSHOPPER-1
store_refAlphanumeric1-255NoStore where the sale happenedSTORE-1
sales_associate_refAlphanumeric1-255NoSales associate who did the saleSALES_ASSOCIATE-1

Price

It is essential to communicate the sale price based on the unit price of each individual item, rather than the total price for all units. For example, if a sale comprises 2 identical belts, each priced at $20, the reporting should reflect the following:

Quantity: 2
Price: 20.0