# Type specifications

## **Product**

| Property | Type                                           | Description              |
| -------- | ---------------------------------------------- | ------------------------ |
| Brand    | string                                         | Product brand            |
| SKU \*   | string                                         | Product SKU              |
| Stock    | [#productstock](#productstock "mention")       | Stock details            |
| Price    | [#productprice](#productprice "mention")       | Price details            |
| Features | [#productfeatures](#productfeatures "mention") | Product features details |

### ProductPrice

| Property                 | Type                                                         | Description                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------ | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Price                    | decimal?                                                     | Price before taxes                                                                                                                                                                                                                                                                                                                                                                                   |
| PriceWithTaxes           | decimal?                                                     | <p>Price after taxes</p><p>Already include taxes value.</p>                                                                                                                                                                                                                                                                                                                                          |
| SuggestedRetailPrice     | decimal?                                                     | Suggested retail price                                                                                                                                                                                                                                                                                                                                                                               |
| SalesMargin              | decimal?                                                     | Sales margin to apply to the product price or suggested retail price.                                                                                                                                                                                                                                                                                                                                |
| Cost                     | decimal?                                                     | Product cost (purchasing cost, manufacturing cost, etc).                                                                                                                                                                                                                                                                                                                                             |
| B2BDiscountRate          | decimal?                                                     | Extra discount rate for the product. (Only for Alephee B2B portals)                                                                                                                                                                                                                                                                                                                                  |
| MeasurablePriceWithTaxes | [#productmeasurableprice](#productmeasurableprice "mention") | <p>Product measurable price with taxes.</p><p> </p><p>This object is intended to replace the other price fields, using measurable price. It should only be used by those accounts that work with measurable products, such as supermarkets and other similar-type accounts.</p><p> </p><p>DO NOT USE this object unless you are absolutely certain that your products use measurable quantities.</p> |

### ProductStock

| Property               | Type                                                                                                                                                                                       | Description                                                                                                                                                                                                                                                                                                                                                                                       |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Quantity               | integer?                                                                                                                                                                                   | <p>Set the current product available stock.<br><br></p>                                                                                                                                                                                                                                                                                                                                           |
| Movement               | integer?                                                                                                                                                                                   | <p>Sets and executes a stock inventory movement on the current product’s stock.</p><p> </p><p>Positive integer values ADD the movement quantity to the product stock.</p><p> </p><p>Negative integer values SUBSTRACT the movement quantity to the product stock.</p><p> </p><p>(Please note that the GET product method does not return this value.)</p>                                         |
| MinPublicationQuantity | integer?                                                                                                                                                                                   | <p>Set the minimum stock to pause the marketplace’s publications (if any) that belongs to the product.</p><p> </p><p>By default, Alephee pauses the product’s product listings when the stock value reach zero units.</p><p> </p><p>Can only be used when accountID belongs to a seller or official store Alephee’s account type.</p>                                                             |
| MaxPublicationQuantity | integer?                                                                                                                                                                                   | <p>Set the maximum stock to set on the marketplace’s publication.</p><p> </p><p>Can only be used when accountID belongs to a seller or official store Alephee’s account type</p>                                                                                                                                                                                                                  |
| B2BQuantity            | integer?                                                                                                                                                                                   | <p>Set the current product available stock for the B2B portal.</p><p> </p><p>(Only for Alephee B2B portals)</p>                                                                                                                                                                                                                                                                                   |
| Alert                  | [#productstockalert](#productstockalert "mention")                                                                                                                                         | <p>Stock alert details.</p><p> </p><p>(Only for Alephee B2B portals)</p>                                                                                                                                                                                                                                                                                                                          |
| Measurable quantity    | ProductMeasurableQtyType?                                                                                                                                                                  | <p>Product measurable quantity.</p><p> </p><p>This object is intended to replace the other stock fields, using measurable quantities. It should only be used by those accounts that work with measurable products, such as supermarkets and other similar-type accounts.</p><p> </p><p>DO NOT USE this object unless you are absolutely certain that your products use measurable quantities.</p> |
| PublishQuantity        | <p>Obsolete and deprecated. Do not use this attribute because it has no effect.</p><p> </p><p>Regardless of whether this attribute appears in Swagger document, it should not be used.</p> |                                                                                                                                                                                                                                                                                                                                                                                                   |

### ProductStockAlert

| Property  | Type     | Description                                                      |
| --------- | -------- | ---------------------------------------------------------------- |
| RedQty    | integer? | <p>Red Quantity</p><p>(Only for Alephee B2B portals)</p><p> </p> |
| YellowQty | integer? | <p>Yellow Quantity</p><p>(Only for Alephee B2B portals)</p>      |

### ProductFeatures

| Property   | Type     | Description                                                                                                                                                                                                                                 |
| ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Visibility | integer? | <p>Sets the product visibility.</p><p>(Only for Alephee B2B portals)</p><p> </p><p>Allowed values are:</p><p> </p><p>0 = Product not visible.</p><p>1 = Product visible.</p><p>2 = Product visible, but not purchasing allowed.</p><p> </p> |

### ProductMeasurableQuantity

| Property | Type    | Description                                                                                                                                                                                                                                                                                                                   |
| -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Quantity | decimal | The decimal numeric quantity                                                                                                                                                                                                                                                                                                  |
| Unit     | string  | <p>The measurement unit of the quantity. Available values are:</p><p> </p><p>Mass units:</p><p>"kg", "g", "mg", "cg", "mcg", "t", "lb", "lbs", "oz"</p><p> </p><p>Length units:</p><p>"m", "mi", "yd", "km", "hm", "dm", "cm", "mm", "ft", "in", "nm"</p><p> </p><p>Pressure units:</p><p>"bar", "psi", "atm", "pa", "at"</p> |

### ProductMeasurablePrice

| Property | Type    | Description                                                                                                                                                                                                                                                                                                                   |
| -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Price    | decimal | The decimal numeric quantity                                                                                                                                                                                                                                                                                                  |
| Unit     | string  | <p>The measurement unit of the quantity. Available values are:</p><p> </p><p>Mass units:</p><p>"kg", "g", "mg", "cg", "mcg", "t", "lb", "lbs", "oz"</p><p> </p><p>Length units:</p><p>"m", "mi", "yd", "km", "hm", "dm", "cm", "mm", "ft", "in", "nm"</p><p> </p><p>Pressure units:</p><p>"bar", "psi", "atm", "pa", "at"</p> |

## ActionResult

| Property   | Type                                 | Description          |
| ---------- | ------------------------------------ | -------------------- |
| Quantities | ActionResultQuantitiesType           | Quantity Totals      |
| Items      | [#itemresult](#itemresult "mention") | Items result details |

### ActionResultQuantities

| Property | Type    | Description                        |
| -------- | ------- | ---------------------------------- |
| Total    | integer | Total Products Processed           |
| Ok       | integer | Ok Products quantity               |
| Error    | integer | Products with errors quantity      |
| Warning  | integer | Products with warnings quantity    |
| Info     | integer | Products with information quantity |

### ItemResult

| Property        | Type                                                    | Description                                                                                  |
| --------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| ItemNumber      | integer                                                 | Item number                                                                                  |
| ValidationLevel | <p>{</p><p>Id (integer),</p><p>Name(string)</p><p>}</p> | <p>Worst validation Level</p><p>99 = Ok,</p><p>2 = Info,<br>1 = Warning,</p><p>0 = Error</p> |
| KeyField        | string                                                  | Fixed: SKU                                                                                   |
| KeyValue        | string                                                  | Product SKU                                                                                  |
| Messages        | [#validationmessage](#validationmessage "mention")      | Validation Messages                                                                          |

### ValidationMessage

| Property       | Type                                                  | Description                                                                                   |
| -------------- | ----------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Level          | <p>{</p><p>Id (integer), <br>Name(string)</p><p>}</p> | <p>Severity Level:</p><p> </p><p>99 = Ok,</p><p>2 = Info,</p><p>1 = Warning,<br>0 = Error</p> |
| Code           | integer                                               | Unique error code                                                                             |
| Message        | string                                                | Error description                                                                             |
| ValidatedValue | string                                                | Validated Value (ex: Price, Sky, Qty)                                                         |
