Saltar al contenido
docs
EN
CatálogoCanales

Listar publicaciones del canal

Devuelve publicaciones paginadas por cursor, filtrables por estado, preparación, categoría, precio y stock.

GET/v1/channels/{channelId}/listings
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"
status?array<>

Solo elementos en estos estados.

Valor en

  • "draft"
  • "publishing"
  • "active"
  • "failed"
  • "unpublished"
  • "suspended"
  • "syncError"
  • "needsAttention"
readiness?array<>

Valor en

  • "unknown"
  • "ready"
  • "notReady"
state?array<>

Solo elementos en estos estados.

Valor en

  • "published"
  • "sending"
  • "notPublished"
  • "needsData"
  • "withWarnings"
  • "error"
  • "pausedByChannel"
  • "pausedByStock"
  • "paused"
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
issues?boolean
listingType?string

Valor en

  • "salesChannel"
  • "source"
categorySource?array<>

Valor en

  • "override"
  • "mapping"
  • "provisional"
includeTotalCount?boolean

Incluye el total de coincidencias. Es más lento en catálogos grandes.

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" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>"
{  "data": [    {      "id": "7204558912004329619",      "channelId": "7204558912004329619",      "productId": "7204558912004322039",      "listingType": "salesChannel",      "externalId": "7204558912004323067",      "externalUrl": "https://mi-tienda.ecomiq.app/products/polo-de-algodon",      "status": "draft",      "price": 89,      "compareAtPrice": 99,      "lastSyncAt": "2026-09-28T15:30:00Z",      "lastSyncError": "Tienda online",      "lastSyncErrorCode": "POL-001",      "readinessStatus": "ready",      "readinessIssues": [        {          "code": "POL-001",          "message": "Entregar después de las 18:00.",          "blocking": false,          "source": "Tienda online",          "references": [            "Mi tienda"          ],          "causeCode": 1,          "sku": "POL-001-AZ-M",          "attributeId": "7204558912004325220"        }      ],      "publishable": false,      "readinessUpdatedAt": "2026-09-28T15:30:00Z",      "createdOn": "2026-09-28T15:30:00Z",      "updatedOn": "2026-09-28T15:30:00Z"    }  ],  "hasNextPage": true,  "nextCursor": "eyJpZCI6IjcyMDQ1NTg5MTIwMDQzMjUzMDEifQ",  "totalCount": 24}