> For the complete documentation index, see [llms.txt](https://developers.alephee.com/v2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.alephee.com/v2/products/get-methods/page-1/response.md).

# Type specifications

## ProductCatalog

<table><thead><tr><th width="224.33333333333331">Property</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>Identification</td><td><a data-mention href="#productidentification">#productidentification</a></td><td>Basic product identification</td></tr><tr><td>Stock</td><td><a data-mention href="#productstockget">#productstockget</a></td><td>Stock of the product (field “Movement” will not be returned)</td></tr><tr><td>Price</td><td><a data-mention href="#productpriceget">#productpriceget</a></td><td>Price of the product</td></tr><tr><td>Kits</td><td><a data-mention href="#productidentification">#productidentification</a></td><td>If the product is normal, it will return all the kits where this product is included</td></tr><tr><td>KitComponents</td><td><a data-mention href="#kitcomponent">#kitcomponent</a></td><td>If the product is a kit, it will return all its components</td></tr><tr><td>Publications</td><td><a data-mention href="#groupedpublications">#groupedpublications</a></td><td>Grouped summary of all product listings belonging to the product.</td></tr><tr><td><mark style="color:orange;">— START PIM SECTION —</mark> </td><td><mark style="color:orange;"><strong>The following sections are available for licensed Alephee PIM customers only. Please reach your sales representatives for more information.</strong></mark></td><td><mark style="color:orange;">— START PIM SECTION —</mark> </td></tr><tr><td>Product additional data</td><td><a data-mention href="#productadditionaldata">#productadditionaldata</a></td><td>Complete product data, images, tags, and related information</td></tr><tr><td>Attributes</td><td><a data-mention href="#productattribute">#productattribute</a></td><td><p>List of product attributes and its values.</p><p> </p></td></tr><tr><td>Variations</td><td><a data-mention href="#variationproduct">#variationproduct</a></td><td>All the product variations products.</td></tr><tr><td>Relationships</td><td><a data-mention href="#relationship">#relationship</a></td><td><p>Relationships of the product with other products.</p><p>Complementarians and substitutes products.</p></td></tr><tr><td><mark style="color:orange;">— END PIM SECTION —</mark> </td><td><mark style="color:orange;">— END PIM SECTION —</mark> </td><td><mark style="color:orange;">— END PIM SECTION —</mark> </td></tr></tbody></table>

### ProductIdentification

| Property      | Type                                                               | Description                                                                                                                                                                                                                                                                                           |
| ------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Id            | integer                                                            | Alephee ID to identify the product                                                                                                                                                                                                                                                                    |
| SKU           | string                                                             | SKU code that identifies the product                                                                                                                                                                                                                                                                  |
| OwnCode       | string                                                             | The product’s internal CODE (if any) that matches the customer's code in the user's ERP.                                                                                                                                                                                                              |
| Brand         | <p>{</p><p>    "Id": integer,</p><p>    "Name": string</p><p>}</p> | Alephee ID of brand, name of the brand                                                                                                                                                                                                                                                                |
| Name          | string                                                             | Product name                                                                                                                                                                                                                                                                                          |
| CatalogStatus | <p>{</p><p>    "Id": integer,</p><p>    "Name": string</p><p>}</p> | <p>Alephee ID and name of the product status in catalog.</p><p> </p><p>Available values are:<br><br></p><p>0 = Assigned,</p><p>1 = Approved (assigned and approved),</p><p>2 = Observed (assigned but observed),</p><p>3 = Observed and fixed,</p><p>4 = Observed and rejected,</p><p>5 = Deleted</p> |
| ProductType   | <p>{</p><p>    "Id": integer,</p><p>    "Name": string</p><p>}</p> | <p>Alephee ID of the product type, name of the type</p><p> </p><p>1 = Normal,</p><p>2 = Kit</p>                                                                                                                                                                                                       |

### KitComponent

| Property       | Type                                                       | Description                                          |
| -------------- | ---------------------------------------------------------- | ---------------------------------------------------- |
| Identification | [#productidentification](#productidentification "mention") | Basic product identification                         |
| Price          | [#productpriceget](#productpriceget "mention")             | Price of the product                                 |
| Stock          | [#productstockget](#productstockget "mention")             | Stock of the product (Movement will not be returned) |
| Quantity       | integer                                                    | Quantity of the product in the kit                   |
| Principal      | boolean                                                    | Product is principal on the kit                      |

### GroupedPublications

| Property    | Type                                                                 | Description                                        |
| ----------- | -------------------------------------------------------------------- | -------------------------------------------------- |
| Marketplace | <p>{</p><p>    "Key": integer,</p><p>    "Value": string</p><p>}</p> | Alephee ID of marketplace, name of the marketplace |
| Details     | [#publication](#publication "mention")                               | List of product listings grouped by their status   |

### Publication

| Property    | Type                                                                   | Description                                                                                                                                   |
| ----------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Status      | <p>{</p><p>    "Id": integer,</p><p>    "Name": string</p><p>}</p>     | <p>Alephee ID of the status, name of the status of the product listing.</p><p> </p><p>Please refer to the product listing status section.</p> |
| Quantity    | integer                                                                | Quantity of product listings.                                                                                                                 |
| ExternalIds | <p> \[</p><p>  {</p><p>    "ExternalId": string</p><p>  }</p><p> ]</p> | Array of external IDs of product listings grouped by status                                                                                   |

### ProductStockGet

| Property               | Type                                                         | Description                                                                                                                                                                                                                                                                                                                           |
| ---------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Quantity               | integer?                                                     | <p>Get the current product available stock.<br><br></p>                                                                                                                                                                                                                                                                               |
| B2BQuantity            | integer?                                                     | <p>Get the current product available stock for the B2B portal.</p><p> </p><p>(Only for Alephee B2B portals)</p>                                                                                                                                                                                                                       |
| PublishQuantity        | integer?                                                     | <p>Get the current product published stock quantity on all product listings.</p><p> </p>                                                                                                                                                                                                                                              |
| MinPublicationQuantity | integer?                                                     | <p>Get 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>Get 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>                                                                                                                                                      |
| Relationships          | [#relatedproductstockget](#relatedproductstockget "mention") | <p>Collection of available product stock from other accounts related to the current account.</p><p> </p><p>Show availability of stock of products from the wholesaler/brand and other accounts related to the current account.</p><p> </p><p>It is only valid if the calling account is a seller-type account.</p>                    |
| Fulfillment            | [ProductFulfillmentStock](#productfulfillmentstock)          | <p>Collection of fulfillment stock details and quantities (if any) for the product listings belonging to the product.</p><p> </p><p>This information is related to all the fulfillment product’s listings in the marketplace.</p><p> </p><p>It is valid only if the seller has products in marketplace fulfillment stock.</p><p></p>  |
| Alert                  | /                                                            | <p>Stock alert details.</p><p> </p><p>(Only for Alephee B2B portals)</p>                                                                                                                                                                                                                                                              |

### RelatedProductStockGet

| Property | Type                                                       | Description                                         |
| -------- | ---------------------------------------------------------- | --------------------------------------------------- |
| Account  | <p>{</p><p>  "Id": int,</p><p>  "Name": string</p><p>}</p> | Alephee account ID and name of the related account. |
| Quantity | integer                                                    | Get the current product available stock.            |

### ProductPriceGet

| Property                                      | Type                                                                                 | Description                                                                                                                                                                                                                     |
| --------------------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Price                                         | decimal?                                                                             | Price before taxes                                                                                                                                                                                                              |
| PriceWithTaxes                                | decimal?                                                                             | Price after taxes                                                                                                                                                                                                               |
| SuggestedRetailPrice                          | decimal?                                                                             | Suggested retail price                                                                                                                                                                                                          |
| Cost                                          | decimal?                                                                             | <p>Cost of the product</p><p>(Only for sellers)<br><br></p>                                                                                                                                                                     |
| B2BDiscountRate                               | decimal?                                                                             | <p>Discount rate (in percentage) to be applied into the product price for the Alephee B2B portal.</p><p> </p><p>(Only for wholesalers)</p><p>(Only for Alephee B2B portals)</p>                                                 |
| SalesMargin                                   | decimal?                                                                             | <p>Sales margin to be applied into the price given by the wholesaler.</p><p> </p><p>(Only for sellers)</p>                                                                                                                      |
| FinalPriceWithShippingCost                    | decimal?                                                                             | <p>Price with taxes and shipping cost</p><p> </p><p>(Only for sellers)</p>                                                                                                                                                      |
| <p>SuggestedRetailPrice<br>AutoCalculated</p> | boolean?                                                                             | <p>Only for kits. Indicates whether the RetailPrice is auto calculated based on the components’ RetailPrice</p><p> </p><p>(Only for wholesalers)</p>                                                                            |
| PriceAutoCalculated                           | boolean?                                                                             | <p>Only for kits. Indicates whether the RetailPrice is auto calculated based on the components’ RetailPrice</p><p> </p><p>(Only for wholesalers)</p>                                                                            |
| PriceList                                     | <p>{</p><p>"Id": int,</p><p>"Name": string</p><p>"DiscountRate" decimal?</p><p>}</p> | <p>Alephee ID, name and the default discount rate of the price list assigned to the product.</p><p> </p><p>Note:</p><p>Visible only for wholesalers.</p><p>For sellers the name is obfuscated because of regulatory issues.</p> |

### Relationship

| Property         | Type                                                             | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| ---------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| RelationshipType | <p>{</p><p>    "Key": int,</p><p>    "Value": string</p><p>}</p> | <p>Alephee ID and name of the relationship type.</p><p> </p><p>One product can be related to another product because several following reasons. Key values:</p><p> </p><p>1 = Application/ Compatibility</p><p><br>(Vehicle)</p><p> </p><p>10 = Substitute</p><p> </p><p>20 = Kit</p><p> </p><p>30 = Variation</p><p> </p><p>40 = Proxy</p><p>(Alternate product)</p><p> </p><p>50 = Complementary</p> |
| Items            | [#productidentification](#productidentification "mention")       | The list of the related products identifications.                                                                                                                                                                                                                                                                                                                                                      |

### VariationProduct

| Property       | Type                                                       | Description                                                             |
| -------------- | ---------------------------------------------------------- | ----------------------------------------------------------------------- |
| Identification | [#productidentification](#productidentification "mention") | Basic product variation identification.                                 |
| Stock          | /                                                          | Stock of the product variation.                                         |
| Attributes     | [#productattribute](#productattribute "mention")           | <p>List of product variation attributes and its values.</p><p> </p>     |
| Principal      | bool                                                       | Indicates if the variation is the main variation of the parent product. |

Please note: Product variations do not contain individual prices. The price is contained only by the main/principal product. However, product variations do contain individual stock.

### **ProductAdditionalData**

| Property       | Type                                           | Description                                           |
| -------------- | ---------------------------------------------- | ----------------------------------------------------- |
| Description    | string                                         | Product description                                   |
| Title          | string                                         | Product title                                         |
| AlternateTitle | string                                         | Product alternate title                               |
| SearchText     | string                                         | Product search text                                   |
| LogisticTags   | [#producttag](#producttag "mention")           | List of logistics tags for the product                |
| SalesTags      | [#producttag](#producttag "mention")           | List of sales tags for the product                    |
| MELICategory   | string                                         | Mercado Libre defined category for the product        |
| OwnCategory    | [#producttag](#producttag "mention")           | User own defined categories for the product           |
| Images         | [#productimage](#productimage "mention")       | List of images for the product                        |
| UrlVideo       | string                                         | URL/URI of the video attached to the product (if any) |
| Features       | [#productfeatures](#productfeatures "mention") | **Product features details**                          |

### ProductAttribute

| Property             | Type                                                           | Description                                                                                                            |
| -------------------- | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Name                 | string                                                         | Name of the attribute                                                                                                  |
| Value                | string                                                         | Vale of the attribute                                                                                                  |
| ValueName            | string                                                         | Vale name of the attribute                                                                                             |
| MeasurementUnit      | <p>{</p><p>    "Id": int,</p><p>    "Name": string</p><p>}</p> | <p>The ID and name of the measurement unit.</p><p>Mercado Libre defines and changes the name without prior notice.</p> |
| MeasurementUnitShort | string                                                         | Short name of the measurement unit.                                                                                    |

### ProductTag

| Property  | Type      | Description                                              |
| --------- | --------- | -------------------------------------------------------- |
| Text      | string    | Tag text/name/description                                |
| Items     | \[string] | <p>Tag values</p><p>(Array of)</p>                       |
| Delimiter | string    | Items tag values delimiter (comma, semicolon, and so on) |

### ProductImage

| Property     | Type   | Description                                                                    |
| ------------ | ------ | ------------------------------------------------------------------------------ |
| UrlThumbnail | string | <p>The complete public URL containing the thumbnail for the image.</p><p> </p> |
| UrlImage     | string | The complete public URL containing the full-sized image                        |

### ProductFulfillmentStock

| Property             | Type                                                                                                             | Description                                                                                                                                                                |
| -------------------- | ---------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Marketplace          | <p><code>{</code></p><p>  <code>"Key": int,</code></p><p>  <code>"Value": string</code></p><p><code>}</code></p> | <p>The key and name for the marketplace’s fulfillment warehouse.</p><p> </p><p>See marketplaces ID section and the GET marketplaces endpoint for the coding reference.</p> |
| Total                | integer                                                                                                          | <p>The total of available and unavailable stock quantities for fulfillment product listings sales.</p><p> </p>                                                             |
| AvailableQuantity    | integer                                                                                                          | The available stock quantity for fulfillment product listings sales.                                                                                                       |
| NotAvailableQuantity | integer                                                                                                          | The unavailable stock quantity for fulfillment product listings sales.                                                                                                     |
| NotAvailableDetails  | <p><a data-mention href="#productfulfillmentunavailable">#productfulfillmentunavailable</a></p><p> </p>          | The collection of details/reasons for which there is no stock available.                                                                                                   |

### ProductFulfillmentUnavailable

| Property   | Type                                                                                                                                                                                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Quantity   | integer                                                                                                                                                                             | <p>The quantity of unavailable stock.</p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Status     | string                                                                                                                                                                              | <p>The status/reason of the unavailable stock, according to the origin marketplace.</p><p> </p><p>Possible values for the “Status” attribute are:</p><p> </p><ul><li>withdrawal</li></ul><p>The item is in a withdrawal process and awaiting to be delivered.</p><p>It is not available for sale.</p><p> </p><ul><li>damaged</li></ul><p>The item is damaged.</p><p>It is not available for sale.</p><p> </p><ul><li>lost</li></ul><p>The item is lost.</p><p>It is not available for sale.</p><p> </p><ul><li>noFiscalCoverage</li></ul><p>The item has no fiscal coverage.</p><p>It is not available for sale.</p><p> </p><ul><li>internal\_process</li></ul><p>The item temporary reserved for internal warehouse quality process.</p><p>It is not available for sale.</p><p> </p><ul><li>transfer</li></ul><p>The item is beign transferred to another warehouse.</p><p>It is not available for sale.</p><p> </p><ul><li>not\_supported</li></ul><p>The item is not identifiable or not processable for sale.</p><p> </p> |
| Conditions | <p><code>\[</code></p><p> <code>{</code></p><p>   <code>"Condition": string,</code></p><p>   <code>"Quantity": integer</code></p><p> <code>}</code></p><p><code>]</code></p><p></p> | <p>Array of conditions and quantities for the unavailable stock.</p><p> </p><p>Possible values for the “Condition” attribute are:</p><p> </p><ul><li>arrived\_damaged                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

</li><li>damaged</li><li>damaged_in_full</li><li>expiration_problem</li><li>package_problem</li><li>flammable</li><li>regulation_problem</li><li>multiple_identifier</li><li>empty_identifier</li><li>multiple_sku</li><li>invalid_identifier</li><li>return_problem</li><li>not_supported</li><li>dimensions_exceeds

</li><li>other</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |

### 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> |
