Saltar al contenido
docs
EN
CatálogoCanales

Listar anuncios

Devuelve anuncios filtrados por canal, tipo y estado; take limita la cantidad.

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

Parámetros de consulta

channelId?string

Identificador del canal de venta.

listingType?string

Valor en

  • "salesChannel"
  • "source"
status?string

Solo elementos en estos estados.

Valor en

  • "draft"
  • "publishing"
  • "active"
  • "failed"
  • "unpublished"
  • "suspended"
  • "syncError"
  • "needsAttention"
take?integer
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/listings" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>"
[  {    "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"  }]