Recursos

Productos en cuenta de prueba

Listá los productos que ya publicaste con una key test y que todavía no promoviste a la cuenta real. Sirve para reproducir el flujo de la web: publicar primero en prueba, revisar, y después publicar en real.

Listar productos en cuenta de prueba

GET/v1/products/test

Probar en sandbox

scopeproducts:read

curl "https://api.automeli.com/api/v1/products/test?status_meli=active&already_published=false&limit=50" \
     -H "X-API-Key: automeli_live_..."

Devuelve los productos almacenados en saved_products — los que se crearon al publicar con una API Key automeli_test_*. El campo published_to_live indica si ese SKU ya se promovió a la cuenta real.

json

{
  "products": [
    {
      "sku": "B003H03SDQ",
      "listing_id_test": "MCO1943839161",
      "title": "Producto de prueba",
      "image": "https://http2.mlstatic.com/...jpg",
      "permalink_test": "https://articulo.mercadolibre.com.co/...",
      "listing_type_id": "gold_pro",
      "price": 89000,
      "currency": "COP",
      "category_id": "MCO420674",
      "category_name": "Soluciones Limpiadoras",
      "tax_category_id": 0,
      "status_meli": "active",
      "app_status": 1,
      "published_to_live": false,
      "test_published_at": "2026-05-08T12:00:00.000Z"
    }
  ],
  "pagination": { "limit": 50, "offset": 0, "returned": 1, "total": 1 }
}

Filtros disponibles

already_published

booleanopcional

Filtra por la columna en BD (en el response sale como published_to_live). false → solo los pendientes de promover a real. true → los que ya pasaron a real.

status_meli

stringopcional

Estado del listing en MercadoLibre. Útil para mostrar solo los que están sirviendo en test: active, paused, closed, under_review, inactive, not_yet_active, payment_required.

app_status

numberopcional

Estado interno de Automeli (0=pausado/eliminado, 1=activo).

sku

stringopcional

Filtra por SKU exacto.

limit

number (1-200)opcional

Default 50.

offset

numberopcional

Default 0. Para paginar.

Errores posibles de este endpoint (3)

E_AUTH_FORBIDDEN_SCOPE

Tu key no tiene el permiso requerido (ver scopes)

403

E_PRODUCT_INVALID_BODY

Body malformado o campos faltantes

422

E_PRODUCT_INVALID_SKU

SKU no cumple regex (10 alfanum)

422

Flujo recomendado para replicar la web: (1) publicá con una key test usando POST /v1/products; (2) listá los pendientes con GET /v1/products/test?already_published=false; (3) cuando un SKU esté listo, hacé POST /v1/products con una key live para el mismo SKU. Automeli marca published_to_live: true en la misma transacción del publicador.

Atajo: promover en una sola llamada

Si querés ahorrarte el GET + POST, hay un endpoint que hace todo en uno: lista internamente los SKUs activos pendientes y los publica en cuenta real.

POST/v1/products/test/promote

Probar en sandbox

scopeproducts:writekeyliveidempotent

Requiere una key automeli_live_*.

curl -X POST "https://api.automeli.com/api/v1/products/test/promote" \
     -H "X-API-Key: automeli_live_..." \
     -H "Content-Type: application/json" \
     -d '{
  "skus": ["B003H03SDQ", "B07JHNJLYH"],
  "listing_type_id": "gold_pro",
  "tax_category_id": 0
}'

Body con todos los campos opcionales. Sin skus promueve todos los candidatos (hasta 1000 por llamada). Devuelve 202 con el job_id y la lista de SKUs aceptados:

json

{
  "job_id": "8a3f2b10-4c9d-4e21-9f8a-1b2c3d4e5f60",
  "status": "queued",
  "promoted": 12,
  "rejected": 0,
  "total_candidates": 12,
  "skus": ["B003H03SDQ", "B07JHNJLYH", "..."]
}

Si usás una key test recibís 403 E_PROMOTE_REQUIRES_LIVE_KEY. Si ningún SKU cumple el filtro, 400 E_PROMOTE_NO_CANDIDATES.

Errores posibles de este endpoint (8)

E_AUTH_FORBIDDEN_SCOPE

Tu key no tiene el permiso requerido (ver scopes)

403

E_PROMOTE_REQUIRES_LIVE_KEY

Endpoint /products/test/promote sólo acepta key live

403

E_PROMOTE_NO_CANDIDATES

No hay SKUs en test pendientes que matcheen el filtro

400

E_PRODUCT_INVALID_BODY

Body malformado o campos faltantes

422

E_PRODUCT_INVALID_SKU

SKU no cumple regex (10 alfanum)

422

E_PRODUCT_CREDIT_EXHAUSTED

Sin créditos disponibles

400

E_PRODUCT_MAX_CONCURRENT_JOBS

Ya tenés 6 jobs activos

429

E_ACCOUNT_NOT_FOUND

Cuenta Meli no encontrada

404