Recursos

Jobs

Cada publicación crea un job asíncrono. Aquí consulta su estado, lista los últimos, reintenta items que fallaron o cancela uno antes de que termine.

Consultar un job

Haga poll cada 5-10 segundos hasta que el status sea final (completed, failed o cancelled).

GET/v1/products/jobs/{jobId}

Probar en sandbox

scopeproducts:read

RequestGET /products/jobs/{jobId}

curl "https://api.automeli.com/api/v1/products/jobs/<job_id>" \
     -H "X-API-Key: automeli_live_..."

200Response

Estado del job + sus items, paginados.

{
  "job": {
    "job_id": "8a3f2b10-4c9d-4e21-9f8a-1b2c3d4e5f60",
    "status": "completed",
    "total_items": 2,
    "successful": 2,
    "failed": 0,
    "completed_at": "2026-05-08T12:00:09Z"
  },
  "items": [
    {
      "sku": "B003H03SDQ",
      "status": "success",
      "listing_id": "MCO1234567890",
      "permalink": "https://articulo.mercadolibre.com.co/…",
      "price": 89000
    }
  ],
  "pagination": { "limit": 100, "offset": 0, "returned": 2 }
}

Filtros opcionales: ?status=failed&limit=50&offset=0

Errores posibles de este endpoint (2)

E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403

E_JOB_NOT_FOUND

jobId no existe o no es de su seller

404

Listar jobs

Para auditoría o reconciliación con su sistema interno.

GET/v1/products/jobs

Probar en sandbox

scopeproducts:read

RequestGET /products/jobs

curl "https://api.automeli.com/api/v1/products/jobs?status=completed&limit=20&from=2026-05-01" \
     -H "X-API-Key: automeli_live_..."

200Response

Lista paginada de jobs del seller que matchean el filtro.

Query: status, from, to, limit (max 200), offset.

Errores posibles de este endpoint (2)

E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403

E_PRODUCT_INVALID_BODY

Body malformado o campos faltantes

422

Reintentar items fallidos

POST/v1/products/jobs/{jobId}/retry

Probar en sandbox

scopeproducts:write

Reintenta items en failed con retryable: true. Solo aplica sobre jobs terminales. Consume créditos por cada item.

RequestPOST /products/jobs/{jobId}/retry

curl -X POST "https://api.automeli.com/api/v1/products/jobs/<job_id>/retry" \
     -H "X-API-Key: automeli_live_..."

202Response

Reintento aceptado para los items retryables del job.

Errores posibles de este endpoint (4)

E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403

E_JOB_NOT_FOUND

jobId no existe o no es de su seller

404

E_JOB_NOT_RETRYABLE

Job no terminal o sin items retryables

400

E_PRODUCT_CREDIT_EXHAUSTED

Sin créditos disponibles

400

Cancelar un job

POST/v1/products/jobs/{jobId}/cancel

Probar en sandbox

scopeproducts:write

Cancela jobs en queued, processing o scheduled. Los items pendientes pasan a skipped. Los ya publicados no se afectan.

RequestPOST /products/jobs/{jobId}/cancel

curl -X POST "https://api.automeli.com/api/v1/products/jobs/<job_id>/cancel" \
     -H "X-API-Key: automeli_live_..."

200Response

Job cancelado. Los items pendientes quedan en skipped.

Errores posibles de este endpoint (3)

E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403

E_JOB_NOT_FOUND

jobId no existe o no es de su seller

404

E_JOB_ALREADY_TERMINAL

Cancel sobre job ya cerrado

400