Referencia

Preguntas frecuentes

Lo que más nos preguntan los integradores arrancando.

¿Cómo sé qué environment estoy usando si solo veo el secreto?

El prefijo te lo dice: automeli_live_* es producción, automeli_test_* es sandbox. También lo ves en GET /v1/ping en el campo environment.

¿Puedo tener varias keys activas?

Sí, no hay límite. Lo recomendado es una key por integración (ERP, e-commerce, sistema interno). Si una se filtra, revocás solo esa.

¿Las keys expiran?

No por default. Solo expiran si las creaste con un expires_at específico. De todas formas, conviene rotarlas cada 6-12 meses por higiene.

¿Por qué mi job aparece como "failed" inmediatamente?

Lo más común: tu seller no tiene cuenta de prueba conectada y la key es test. La Lambda intenta publicar, no encuentra cuenta test y falla. Solución: conectá una cuenta test desde Configuración → Cuenta de Pruebas, o usá una key live.

¿Qué pasa si supero los 6 jobs activos simultáneos?

Recibís 429 E_PRODUCT_MAX_CONCURRENT_JOBS. Esperá a que termine alguno y reintentá. El límite existe para no saturar el publisher.

¿Es seguro pegar mi key en variables de entorno?

Sí — es lo recomendado. Lo que NO hagas: pegarla en archivos commiteados a Git, en URLs/query strings, ni en logs. Si por error la commiteás, revocala desde la pestaña anterior y generá una nueva.

¿Cómo replico el flujo de la web: publicar en prueba, revisar, y después en real?

Tres pasos:

Publicá con una API Key automeli_test_* vía POST /v1/products. Cada SKU queda guardado en cuenta de prueba.
Listá lo que falta promover con GET /v1/products/test?status_meli=active&already_published=false. Eso reproduce el mismo filtro de la web: solo los que están activos en la cuenta de prueba y todavía no se publicaron en real.
Cuando esté listo, hacé POST /v1/products con una key automeli_live_* para el mismo SKU. Al completarse, Automeli marca published_to_live: true en el registro de prueba dentro de la misma transacción, así no aparece más en el listado de pendientes.

¿Cómo manejo el caso de un seller sin cuenta de MercadoLibre conectada?

Recibís 404 E_ACCOUNT_NOT_FOUND o el job pasa a failed con error_message claro. Antes de publicar, podés chequear con GET /v1/account que ml_connected: true.

¿Qué listing_type_id elijo: gold_pro o gold_special?

Son los tipos de publicación de MercadoLibre, no inventados por Automeli.

gold_pro (Premium) → mayor visibilidad y cuotas sin interés financiadas por Meli, pero pagás comisión más alta (~16-18%). Conviene para productos de precio medio/alto donde las cuotas ayudan a vender.
gold_special (Clásica) → comisión más baja (~10-13%), sin cuotas sin interés. Conviene para productos baratos o de alta rotación donde el precio importa más que las cuotas.

Los tipos gold_premium, gold, silver y bronze son legacy: casi nadie los usa, los aceptamos solo por compatibilidad con cuentas viejas.

Si no mandás el campo, se usa el default que tu cuenta tiene configurado en Configuración → Cálculo de precio.