AM
Automeli
Jobs (status, retry, cancel)
v2v1 · anterior
Está viendo la documentación de la API v1 (versión anterior). v1 sigue funcionando sin cambios hasta el 31 de enero de 2027, fecha en la que se apagará. Las integraciones nuevas deben usar la API v2, que cubre todo lo de v1 con nombres limpios y paginación por cursor. Si ya integró con v1, la guía de migración lista las equivalencias campo por campo.

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 o query malformado (campo, fecha o estado inválido)

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