Configurar credenciales api de mercadolibre en nubixstore

Ruta: Mercadolibre > Configuracion > General
Palabras de búsqueda: "mercadolibre", "conexiones", "replicas"

En esta nota aprenderás a generar y configurar las credenciales de MercadoLibre necesarias para vincular tu tienda en nubixstore. A través de la creación de una aplicación en el portal de MercadoLibre Developers, obtendrás las claves de conexión para que nubixstore pueda sincronizar productos, ventas y envíos con tu cuenta de MercadoLibre.

Guía paso a paso

Para la activación de la tienda en MercadoLibre es necesario configurar las credenciales de la API.
Estas credenciales se obtienen ingresando al portal de Developers de MercadoLibre y creando una nueva aplicación. Esta aplicación será la que otorgue la conexión entre nubixstore y la tienda de Mercado Libre.

1. Ingresar a Developers de MercadoLibre
Accedé al sitio de developers de MercadoLibre e iniciá sesión con el usuario de MercadoLibre asignado a la unidad de negocios donde se activará la tienda.

2. Crear nueva aplicación
Dentro del panel de developers, seleccioná "Crear nueva aplicación" 

3. Completar los datos obligatorios

• Nombre de la aplicación: este nombre es solo interno para MercadoLibre, no es el nombre de la tienda.
• Nombre corto: MercadoLibre lo utilizará para asignar la URL de la aplicación.
• Descripción breve: explicación del uso de la aplicación (ejemplo: integración con nubixstore).
• Logo: imagen que se mostrará en el listado de aplicaciones.

4. Configuración inicial y Redirect URLs
En este paso se deben completar las Redirect URLs, que son las direcciones a donde será redirigido el usuario una vez autenticado.

Estos datos los proporciona nubixstore en el backend, en la ruta: Mercadolibre > Configuración > General.

Copiá y pegá la URL de redireccionamiento provista por nubixstore en el campo Redirect URL de la aplicación en MercadoLibre.
IMPORTANTE: en Redirect URL y en Notifications URL, reemplazá el apartado %USER-ID% por el usuario de MercadoLibre que se usará para la tienda. (quitar los simbolos de %)

Una vez pegado el link del redireccionamiento url de nobixstore a MercadoLibre, debemos elegir las siguientes opciones disponibles de la configuración para la futura tienda en MercadoLibre:

5. Flujos Oauth

• Authorization Code: SI
• Client Credentials: SI
• Refresh Token: SI

6. Requiere PCKE

• Requiere PCKE: NO
• MercadoLibre: SI
• VIS: NO

7. Permisos de la aplicación:
Configurá los accesos de la siguiente forma:

• Usuarios: Default en Lectura y escritura
• Integration handling units read: Sin acceso 
• Integration manifests write: Sin acceso
• Comunicaciones pre y post ventas: Sin acceso
• Publicación y sincronización: Lectura y escritura
• Publicidad de un producto: Sin acceso
• Facturación de una venta: Lectura y escritura
• Métricas del negocio: Sin acceso
• Promociones, cupones y descuentos de una venta: Lectura y escritura
• Venta y envíos de un producto: Lectura y escritura

8. Configuración de Tópicos
La mayoría viene preconfigurada en base a los permisos otorgados. Solo es necesario activar los siguientes tópicos adicionales:

• Shipments:  Solo activar Shipments
  (NO activar fbm stock operations ni flex-handshakes)

• Promotions: Activar ambas opciones, Public Offers y Public Candidates

• Others: Solo activar Payments e Invoices
  (NO actiar Leads-Credits)

9. URL de notificaciones
Ingresá la Notifications URL, que también está disponible en el backend de nubixstore en: Mercadolibre > Configuración > General.

10. Crear la aplicación
Aceptá las condiciones de MercadoLibre y creá la aplicación.

Una vez creada, obtendrás las credenciales en la edicion de la aplicación de MercadoLibre:

• APP-ID (código numérico, aparece como App ID).
• SECRET-KEY (código alfanumérico, aparece como Client Secret).

11. Configuración final en nubixstore
Ingresá en: Mercadolibre > Configuración > General y completá los campos con los siguientes datos:

• USERNAME: Usuario de la cuenta de MercadoLibre vinculada a la tienda.
• APP-ID: El valor numérico provisto en la aplicación creada.
• SECRET-KEY: El valor alfanumérico que figura como Client Secret.

Consideraciones importantes:

• Siempre usar el usuario de MercadoLibre que corresponde a la unidad de negocios.
• Revisar que las URLs configuradas coincidan exactamente con las provistas por nubixstore.
• No activar permisos ni tópicos adicionales, ya que podrían generar errores en la integración.