# Type specifications

## ProductListing

| Property                                                                       | Type                                                                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Id                                                                             | integer                                                                                           | ID of the product listing                                                                                                                                                                                                                                                                                                                                                                                      |
| Brand                                                                          | string                                                                                            | Brand of the product that is published in the product listing                                                                                                                                                                                                                                                                                                                                                  |
| SKU                                                                            | string                                                                                            | SKU of the product that is published in the product listing                                                                                                                                                                                                                                                                                                                                                    |
| ProductSKU                                                                     | string                                                                                            | The SKU of the original product in the catalog. May differ from the previous published SKU identificator.                                                                                                                                                                                                                                                                                                      |
| SellerSKU                                                                      | String                                                                                            | The product’s internal CODE (if any) that matches the customer's code in the user's ERP.                                                                                                                                                                                                                                                                                                                       |
| ExternalId                                                                     | string                                                                                            | The marketplace-assigned ID for the product listing                                                                                                                                                                                                                                                                                                                                                            |
| Marketplace                                                                    | <p>{</p><p>  Key (integer),</p><p>  Value (string)</p><p>}</p>                                    | <p>Marketplace origin of the product listing.</p><p><br>See marketplaces ID section and the GET marketplaces endpoint for the coding reference.</p>                                                                                                                                                                                                                                                            |
| Title                                                                          | string                                                                                            | Public title of the product listing                                                                                                                                                                                                                                                                                                                                                                            |
| Status                                                                         | <p>{</p><p>  Key (integer),</p><p>  Name (string),</p><p>  UpdatedDateTime (DateTime)</p><p>}</p> | <p>Status of the product listing.</p><p>Please refer to product listings statuses</p><p> </p>                                                                                                                                                                                                                                                                                                                  |
| PermanentLink                                                                  | string                                                                                            | The public URL of the product listing                                                                                                                                                                                                                                                                                                                                                                          |
| Category                                                                       | <p>{</p><p>  Id (string),</p><p>  Value (string)</p><p>}</p>                                      | <p>The identification code and name of the marketplace category where the product listing is published.</p><p> </p>                                                                                                                                                                                                                                                                                            |
| <p>ListingType</p><p> </p><p>(Valid only for the Mercado Libre marketplace</p> | <p>{</p><p>  Id (integer),</p><p>  Name (string),</p><p>  Description (string)</p><p>}</p>        | <p>The marketplace-assigned type for the product listing</p><p>Available values are:</p><p> </p><p>0 = no type found</p><p>1 = gold\_pro</p><p>2 = gold\_premium</p><p>3 = gold\_special</p><p>4 = gold</p><p>5 = silver</p><p>6 = bronze</p><p>7 = free</p><p> </p><p>The “Description” attribute includes the friendly name of the listing type.</p>                                                         |
| Price                                                                          | decimal                                                                                           | The published price for the product listing                                                                                                                                                                                                                                                                                                                                                                    |
| Deals                                                                          | [#productlistingdeals](#productlistingdeals "mention")                                            | <p>The list of marketplace’s IDS of any deals the product listing is currently attached to.</p><p> </p>                                                                                                                                                                                                                                                                                                        |
| AvailableQuantity                                                              | integer                                                                                           | The published available quantity for the product listing                                                                                                                                                                                                                                                                                                                                                       |
| SoldQuantity                                                                   | integer                                                                                           | The quantity of sales the listing product have                                                                                                                                                                                                                                                                                                                                                                 |
| Visits                                                                         | integer?                                                                                          | The quantity of visits the listing product have                                                                                                                                                                                                                                                                                                                                                                |
| <p>Health<br><br></p><p>(Only for the Mercado Libre marketplace)</p>           | decimal?                                                                                          | <p>The marketplace-assigned health (in percentage) of the product listing.</p><p> </p><p>(Only for the Mercado Libre marketplace)</p>                                                                                                                                                                                                                                                                          |
| PicturesQuantity                                                               | integer?                                                                                          | The quantity of pictures the listing product have                                                                                                                                                                                                                                                                                                                                                              |
| PicturesList                                                                   | \[string]                                                                                         | List of public URLs of the pictures on the product listing                                                                                                                                                                                                                                                                                                                                                     |
| UrlVideo                                                                       | string                                                                                            | URL/URI of the video attached to the product (if any)                                                                                                                                                                                                                                                                                                                                                          |
| AttributesQuantity                                                             | integer?                                                                                          | The quantity of attributes the listing product have                                                                                                                                                                                                                                                                                                                                                            |
| Shipping                                                                       | [#productlistingshipping](#productlistingshipping "mention")                                      | <p>Several flags of the product listing shipping options.</p><p> </p>                                                                                                                                                                                                                                                                                                                                          |
| Properties                                                                     | [#productlistingproperties](#productlistingproperties "mention")                                  | <p>Several flags of the product listing properties.</p><p> </p>                                                                                                                                                                                                                                                                                                                                                |
| Tags                                                                           | \[string]                                                                                         | <p>Collection of tags of the product listing. Each tag is defined by the marketplace and there is no guarantee that the name will remain the same over the time.</p><p> </p><p>Examples of tags:</p><p> </p><p>·       ahora-12</p><p>·       ahora-18</p><p>·       mandatory\_free\_shipping</p><p>·       good\_quality\_pictures</p><p>·       immediate\_payment</p><p>·       cart\_eligible</p><p> </p> |
| ChildProductsList                                                              | [#productlisting](#productlisting "mention")                                                      | List of related product listings to this one. This list includes only child-type product listings.                                                                                                                                                                                                                                                                                                             |
| DateCreated                                                                    | datetime? (UTC with local user time zone)                                                         | Date and time of the creation of the product listing.                                                                                                                                                                                                                                                                                                                                                          |
| DateUpdated                                                                    | datetime? (UTC with local user time zone)                                                         | Date and time of the last update of the product listing.                                                                                                                                                                                                                                                                                                                                                       |

### ProductListingDeals

| Property | Type | Description                                                                                         |
| -------- | ---- | --------------------------------------------------------------------------------------------------- |
| Active   | bool | <p>Indicate if the product listing has AT LEAST ONE deal active.</p><p> </p>                        |
| List     | bool | <p>The list of marketplace’s IDS of deals the product listing is currently attached to.</p><p> </p> |

### ProductListingShipping

| Property       | Type | Description                                                                                                                                            |
| -------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Fulfillment    | bool | <p>Indicate if the product listing belongs to the marketplace’s fulfillment selling subscription.</p><p> </p>                                          |
| MercadoEnvios  | bool | <p>Indicate if the product listing belongs to any of the available Mercado Envios shipping type option.</p><p> </p><p>Exclusive for Mercado Libre.</p> |
| MercadoEnvios1 | bool | <p>Indicate if the product listing uses the “ME1” shipping type option.</p><p> </p><p>Exclusive for Mercado Libre.</p>                                 |
| MercadoEnvios2 | bool | <p>Indicate if the product listing uses the “ME2” shipping type option.</p><p> </p><p>Exclusive for Mercado Libre.</p>                                 |
| Flex           | bool | <p>Indicate if the product listing uses the “Flex” shipping type option.</p><p> </p><p>Exclusive for Mercado Libre.</p>                                |

### ProductListingProperties

| Property             | Type | Description                                                                                                                                                                                            |
| -------------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Buybox               | bool | <p>Indicate if the product listing belongs to any marketplace “catalog” or “buybox” listing.</p><p> </p><p>Exclusive for Mercado Libre.</p>                                                            |
| HasFiscalInformation | bool | <p>Indicate if the product listing has set the fiscal information. This is done using the “PUT fiscalInformation” endpoint.</p><p> </p><p>Exclusive for Mercado Libre.</p><p>Exclusive for Brazil.</p> |
