Recursos

Publicar productos

El endpoint principal. Crea un job asíncrono que la API procesa en segundo plano. Cada job puede tener hasta 10.000 items.

Crear un job de publicación

POST/v1/products

Probar en sandbox

scopeproducts:writeidempotent

Por cada item indica el SKU y la categoría — o le pide a Automeli que la infiera con auto_categorize: true. Ambas opciones son excluyentes.

RequestPOST /products

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

202Response

Job aceptado y encolado. Devuelve el job_id para hacer seguimiento.

{
  "job_id": "8a3f2b10-4c9d-4e21-9f8a-1b2c3d4e5f60",
  "status": "queued",
  "accepted": 2,
  "rejected": 0,
  "total_items": 2
}

El modo de prueba lo decide el environment de su API Key, no el body. Si su key es automeli_test_* el job no consume créditos.

Campos del body

items

array (1-10.000)requerido

Cada item: sku + (category_id o auto_categorize).

items[].sku

stringrequerido

10 caracteres alfanuméricos (ASIN de Amazon).

items[].category_id

stringcondicional

ID de Mercado Libre, formato MCO420674. Excluyente con auto_categorize.

items[].auto_categorize

booleancondicional

Automeli infiere la categoría desde el ASIN. Excluyente con category_id.

listing_type_id

stringopcional

Tipo de publicación de Mercado Libre. Default: el configurado por el seller. Valores aceptados: gold_pro (premium con cuotas), gold_special (clásica), más legacy gold_premium / gold / silver / bronze aceptados por compatibilidad. ¿Cuál elijo? →

tax_category_id

intopcional

Índice (no nombre) de la categoría arancelaria del seller. Default 0 (primera). Para ver los índices → GET /v1/account/tax-categories.

scheduled_for

stringopcional

Programa la publicación a una hora futura. Formato YYYY-MM-DDTHH:MM en UTC, sin segundos ni offset. Entre 5 minutos y 30 días en el futuro. Ver guía de programación →

Errores posibles de este endpoint (13)

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_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403

E_RATE_LIMITED

Excediste el rate limit. Ver Retry-After

429

E_IDEMPOTENCY_CONFLICT

Misma Idempotency-Key con body distinto

409

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

429

E_CATEGORY_INVALID

category_id no cumple formato Meli

422

E_CATEGORY_AND_AUTO_CONFLICT

category_id y auto_categorize juntos

422

E_ACCOUNT_NOT_FOUND

Cuenta Meli no encontrada

404

E_INTERNAL

Error inesperado. Reintente con backoff

503

Guías relacionadas

Programar publicaciones (UTC) →

El campo scheduled_for: formato estricto, formatos rechazados y conversión de hora local a UTC.

Idempotencia →

Evite jobs duplicados al reintentar requests con el header Idempotency-Key.