Saltar al contenido
docs
EN
CatálogoCanales

Listar requisitos

Devuelve una tabla de requisitos por publicación, paginada por cursor.

GET/v1/channels/{channelId}/listings/requirements
Requiere un token de acceso con el permiso channel:read.

Parámetros de ruta

channelId*string

Identificador del canal de venta.

Parámetros de consulta

limit?integer

Cantidad máxima de resultados por devolver.

Formatoint32
cursor?string

Cursor de la respuesta anterior. Omítelo en la primera página.

search?string

Búsqueda de texto libre.

sortBy?string

Campo por el que se ordena.

sortDirection?string

Dirección del ordenamiento: asc o desc.

Valor en

  • "asc"
  • "desc"
listingIds?array<ResourceId>
productIds?array<ResourceId>

Solo estos productos.

onlyMissing?boolean
categoryIds?array<ResourceId>

Solo elementos en estas categorías.

gender?array<string>

Género al que se dirige el elemento.

minPrice?number

Precio mínimo a incluir, en la moneda de la tienda.

Formatodouble
maxPrice?number

Precio máximo a incluir, en la moneda de la tienda.

Formatodouble
minStock?integer

Nivel mínimo de existencias.

Formatoint32
maxStock?integer

Nivel máximo de existencias.

Formatoint32

Parámetros de cabecera

x-Store-Id?string

Tienda sobre la que actúa la solicitud. No hace falta cuando el token ya está vinculado a una tienda.

Authorization*string

Token bearer OAuth 2.0.

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://api.ecomiq.pe/api/v1/channels/7204558912004329619/listings/requirements" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>"
{  "columns": [    {      "externalId": "7204558912004323067",      "name": "Tienda online",      "required": true,      "optionValues": [        {          "id": "7204558912004325220",          "name": "Material"        }      ],      "allowCustomValue": false,      "target": "attribute",      "variant": false,      "valueType": "Tienda online"    }  ],  "rows": [    {      "listingId": "7204558912004321492",      "productId": "7204558912004322039",      "productName": "Tienda online",      "sku": "POL-001-AZ-M",      "readinessStatus": "ready",      "categoryPath": "Tienda online",      "categoryMapped": false,      "missing": 1,      "values": {        "key": {          "value": "Tienda online",          "source": "Tienda online",          "state": "ok",          "variantValues": [            {              "variantId": "7204558912004323197",              "sku": "POL-001-AZ-M",              "value": "Polo de algodón Azul / M",              "source": "Tienda online",              "valueId": "7204558912004324721",              "state": "ok"            }          ]        }      }    }  ],  "total": 178,  "nextCursor": "eyJpZCI6IjcyMDQ1NTg5MTIwMDQzMjUzMDEifQ",  "choices": {    "key": {      "key": {        "optionValues": [          {            "id": "7204558912004325220",            "name": "Material"          }        ],        "allowCustomValue": false,        "valueType": "Tienda online",        "allowedUnits": [          {            "id": "7204558912004325220",            "name": "Material"          }        ],        "defaultUnit": "Tienda online"      }    }  }}