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 lo indica: 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, revoca 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: su seller no tiene cuenta de prueba conectada y la key es test. La Lambda intenta publicar, no encuentra cuenta test y falla. Solución: conecte una cuenta test desde Configuración → Cuenta de Pruebas, o use una key live.

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

Recibe 429 E_PRODUCT_MAX_CONCURRENT_JOBS. Espere a que termine alguno y reintente. 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 haga: pegarla en archivos versionados en Git, en URLs/query strings, ni en logs. Si por error queda incluida en un commit, revóquela desde la pestaña anterior y genere una nueva.

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

Tres pasos:

Publique con una API Key automeli_test_* vía POST /v1/products. Cada SKU queda guardado en cuenta de prueba.
Liste 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, haga 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 Mercado Libre conectada?

Recibe 404 E_ACCOUNT_NOT_FOUND o el job pasa a failed con error_message claro. Antes de publicar, puede 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 Mercado Libre, no inventados por Automeli.

gold_pro (Premium) → mayor visibilidad y opción de cuotas sin interés para el comprador, pero con comisión más alta. Conviene para productos de precio medio/alto donde las cuotas ayudan a vender.
gold_special (Clásica) → comisión más baja, 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 envía el campo, se usa el default que su cuenta tiene configurado en Configuración → Cálculo de precio.