GetProducts

get

https://sellercenter-api.linio.com.mx/?Action=GetProducts

Get all or a range of products.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

The fields of the result have the following type and meaning:

Name	Type	Description
SellerSku	String	Seller's unique identifier
ShopSku	String	Shop's unique identifier
Name	String	Product's name
Brand	String	Product's brand
Description	String	Product's description
TaxClass	String	Tax class applied to the product
Variation	String	Product's variation
Quantity	Integer	The sellable stock in the Seller warehouse
FulfillmentBySellable	Integer	The sellable stock in the Venture warehouse
FulfillmentByNonSellable	Integer	The non-sellable stock in the Venture warehouse
ReservedStock	Integer	The stock reserved for pending orders in Seller Center
RealTimeStock	Integer	The stock reserved for pending orders in the Shop not imported in Seller Center yet
Available	Integer	The sellable stock in the Shop (Quantity + FulfillmentBySellable - ReservedStock - RealTimeStock)
Price	Decimal	The product's regular price
SalePrice	Decimal	The product's special sale price
SaleStartDate	DateTime	Starting date for the special sale
SaleEndDate	DateTime	Ending date for the special sale
Status	Integer	Product's status: 'active', 'inactive' or 'deleted'
ProductId	String	EAN/UPC/ISBN of the product, if it exists
Url	String	Link to product on venture website
MainImage	String	Link to main image of product
FobPrice	Decimal	The product's FOB (Free On Board) regular price, before conversion. You need to be FOB seller to get this fields
FobSalePrice	Decimal	The product's FOB (Free On Board) sale price, before conversion. You need to be FOB seller to get this fields
Images	Multiple Image Elements	All images of the product (including the main image)
PrimaryCategory	String	The product's primary category
Categories	String	The product's additional categories (comma-separated)
ProductData	Multiple Attribute Elements	The product's attributes, each being a separate child element.

Errors

Error code	Message
17	E017: "%s" Invalid Date Format
19	E019: "%s" Invalid Limit
14	E014: "%s" Invalid Offset
36	E036: Invalid status filter
70	E070: You have corrupt data in your sku seller list.

🚧
Not Transactionalized
The list of products may change while paging through it using multiple calls with a changing Offset parameter.

Query Params

Action

string

Defaults to GetProducts

Name of the function that is to be called. Mandatory and must be 'GetProducts' in this case. If omitted, an 'E001: Parameter Action is mandatory' error is returned. If an unknown function string is supplied, an 'E008: Invalid Action' error message is returned.

Format

string

Defaults to XML

If supplied, must be either 'JSON' or 'XML'. If not supplied, 'XML' is assumed.

Timestamp

date

The current time in ISO8601 format relative to UTC (e.g., Timestamp=2015-04-01T10:00:00+02:00 for Berlin), so that calls cannot be replayed by an eaves-dropping third party (i.e., those calls too far into the past or future yield an error message). Mandatory. If not supplied, an 'E001: Parameter Timestamp is mandatory' error message results. If the timestamp is too old or in the future, an 'E003: Timestamp has expired' error message is returned.

UserID

string

The ID of the user making the call. The list of authorized users is maintained in Seller Center web interface under Settings/Manage Users.

Version

string

The API version against which this call is to be executed, in major-dot-minor format. Must currently be 1.0, even though the actual version of the API is 2.6.20. If omitted, an ‘E001: Parameter Version is mandatory’ error message is returned.

Signature

string

The cryptographic signature, authenticating the request. A caller must create this value by computing the SHA256 hash of the request, using the API key of the user specified in the UserID parameter. Mandatory. If omitted, an ‘E001: Parameter Signature is mandatory’ error message is returned. If the signature is incorrect, an ‘E007: Login failed. Signature mismatch’ error message is returned.

CreatedAfter

date

Limites the returned product list to those created after or on a specified date, given in ISO 8601 date format. Optional

CreatedBefore

date

Limites the returned product list to those created before or on a specified date, given in ISO 8601 date format. Optional

string

Returns those products where the search string is contained in the product's name and/or SKU.

Filter

string

Defaults to all

Return only those products whose state matches this parameter. Possible values are all, live, inactive, deleted, image-missing, pending, rejected, sold-out. Mandatory.

Limit

int32

Defaults to 1000

The maximum number of products that should be returned. If you omit this parameter, the default of 1000 is used. The largest number of products you can request with a single call is 5000 (this is the default hard limit, which can be changed per instance). If you need to retrieve more products than that, you have to page through the result set using the Offset parameter.

Offset

int32

Numer of products to skip (i.e., an offset into the result set; toghether with the Limit parameter, simple resultset paging is possible; if you do page through results, note that the list of products might change during paging).

SkuSellerList

array of strings

Only products whose SKU is contained in this list wil be returned. Can either be a JSON array (e.g., [“E213”,”KI21”,”HT0”]) or a serialized PHP array (e.g., a:3:{i:0;s:4:”E213”;i:1;s:4:”KI21”;i:2;s:3:”HT0”;}).

SkuSellerList

UpdatedAfter

date

Limits the returned product list to those updated after or on a specified date, given in ISO 8601 date format. Optional

UpdatedBefore

date

Limits the returned product list to those updated before or on a specified date, given in ISO 8601 date format. Optional

GlobalIdentifier

int32

Defaults to 0

If set to 1, Brand, PrimaryCategory, Categories and all Attributes in ProductData will be returned with Global Identifiers

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Errors

Not Transactionalized

200200

400400