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.

Referencia

Errores

Todos los errores siguen RFC 7807 Problem Details. El campo code es machine-readable — los clientes deberían hacer switch sobre eso, no sobre el title.

json

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/problem+json

{
  "type": "https://api.automeli.com/errors/E_PRODUCT_INVALID_SKU",
  "title": "SKU inválido",
  "status": 422,
  "code": "E_PRODUCT_INVALID_SKU",
  "instance": "/api/v1/products",
  "detail": "items[3].sku no cumple el formato (10 chars alfanum)."
}

Haga switch sobre code en su cliente. El title es human-readable y puede cambiar; el code es contrato público y estable.

Catálogo completo (21)

Código y descripciónStatus

E_AUTH_MISSING_KEY

Falta el header X-API-Key

401

E_AUTH_INVALID_KEY

Key con formato inválido o no reconocida

401

E_AUTH_KEY_REVOKED

Key revocada por el dueño

401

E_AUTH_KEY_EXPIRED

Key con expires_at vencido

401

E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403

E_RATE_LIMITED

Excedió el rate limit. Ver Retry-After

429

E_IDEMPOTENCY_CONFLICT

Misma Idempotency-Key con body distinto

409

E_PRODUCT_INVALID_BODY

Body o query malformado (campo, fecha o estado inválido)

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 tiene 6 jobs activos

429

E_PROMOTE_NO_CANDIDATES

Ningún producto de prueba publicable coincide con lo pedido

400

E_PROMOTE_REQUIRES_LIVE_KEY

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

403

E_CATEGORY_INVALID

La categoría de Mercado Libre no cumple el formato (MCO…)

422

E_CATEGORY_AND_AUTO_CONFLICT

Un item manda la categoría y auto_categorize a la vez

422

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_JOB_ALREADY_TERMINAL

Cancel sobre job ya cerrado

400

E_ACCOUNT_NOT_FOUND

Cuenta Meli no encontrada

404

E_NOT_FOUND

Ruta no encontrada dentro de la API

404

E_INTERNAL

Error inesperado. Reintente con backoff

503