Step 1: Create MercadoLibre Application

1. Go to MercadoLibre Developers Center for your country, for example for Mexico

2. Log in with your MercadoLibre account

3. Click on "Create Application" or select an existing one

4. Fill in the required information: - Application Name: Choose a descriptive name for your integration - Short name: Choose a short name for your integration - Description: Choose a description for your integration

5. After creating the application, you'll get: - App ID: MercadoLibre will generate a unique App ID for your application, you will need to copy this value and paste it in the MercadoLibre integration settings, located in your Odoo Settings configuration page - App Secret: MercadoLibre will generate a unique App Secret for your application, you will need to copy this value and paste it in the MercadoLibre integration settings, located in your Odoo Settings configuration page

6. In the next step, you will need to set up: - Redirect URI: You will need to introduce the public URL of your Odoo instance appending /auth/mercadolibre, for example: https://your-odoo-domain.com/auth/mercadolibre and you will need to paste it in the MercadoLibre integration settings, located in your Odoo Settings configuration page. - Select MercadoLibre as the business unit - In the permissions section, you will need to select at least the following permissions:

   • Read orders: This permission is required to create Sale Orders in Odoo
   • Read and write publications: This permission is required to keep your products data (price and stock) in sync with MercadoLibre

   • Tópicos: You will need to select Orders_v2 within Orders
   • Callback URL: You will need to introduce the public URL of your Odoo instance appending /webhooks/mercadolibre, for example: https://your-odoo-domain.com/webhooks/mercadolibre. This is to notify Odoo when a new order is created in MercadoLibre.

7. Click on "Save" to save the application settings.

Step 2: Configure your Odoo instance

1. In your Odoo instance, go to Settings > MercadoLibre Integration
2. Fill in the configuration form: - Name: Choose a descriptive name for your integration - User: Select the Odoo user who will be assigned to created Sale Orders - Default Buyer: Select the customer/partner that will be used as the buyer for MercadoLibre orders. Note this is needed because MercadoLibre stopped providing buyer information via API. - Active: Check the box to activate the integration - Client ID: Paste the Client ID from your MercadoLibre application - Client Secret: Paste the Client Secret from your MercadoLibre application - Redirect URI: Paste the Redirect URI from your MercadoLibre application (the one ending in /auth/mercadolibre) - Country: Select the country of your MercadoLibre application
3. Click "Save" to save the configuration.

Step 3: Login to MercadoLibre

1. In your integration settings, click on "Login to MercadoLibre" button
2. You'll be redirected to MercadoLibre to authorize the application
3. After authorization, you'll be redirected back to Odoo with the integration active
4. You will see the Tokens filled in the corresponding fields (if no just refresh the page)
5. Integration is now active and ready to use.

Step 4: Configure your products

1. In your Odoo instance, go to Inventory > Products > Products
2. Open the product you want to synchronize with MercadoLibre
3. In the product form, find the Meli Id field and enter the MercadoLibre Product ID of the product
4. Click Save to save the product

Automatic Price and Stock Synchronization

Once configured, the connector automatically synchronizes your products:

1. Price Updates: When you change a product's price in Odoo, it automatically updates on MercadoLibre
2. Stock Updates: When stock quantities change in Odoo, the changes are reflected on MercadoLibre
3. Real-time Sync: Changes are synchronized immediately when you save the product, if there is an error, it will be shown in the product form in the Chatter section.

To update a product: 1. Go to Inventory > Products > Products 2. Open the product you want to update 3. Modify the price or stock quantity, ensure the product has a valid MercadoLibre Product ID 4. Click Save 5. The changes will be automatically synchronized to MercadoLibre

Order Processing

When customers purchase your products on MercadoLibre:

1. The connector automatically detects the new order
2. A confirmed Sale Order is created in Odoo for the buyer selected in the integration settings
3. The order includes: - Product details and quantities - Integration buyer information - MercadoLibre user ID in the Customer Reference field (in the Other info tab) - MercadLibre Order ID in the Source Document field (in the Other info tab)
4. The order is ready for fulfillment and shipping from Odoo

To process orders: 1. Go to Sales > Orders > Quotations 2. Find the orders created from MercadoLibre (they'll be in "Confirmed" state) 3. Process them as you would any other Odoo sale order 4. Update the order status as needed

Troubleshooting

Common Issues and Solutions:

"Authentication Failed" Error: - Verify your Client ID and Client Secret are correct - Ensure the Redirect URI matches exactly in both Odoo and MercadoLibre - Check that your MercadoLibre application is active

"Product Not Syncing" Error: - Verify the MercadoLibre Product ID is correct - Ensure the product exists in your MercadoLibre store - Check that the integration is properly configured - Check the Chatter section of the product for any error messages

"Order Not Created" Error: - Verify the webhook is properly configured in MercadoLibre - Check the Odoo logs for any error messages - Ensure the Default Buyer is properly configured

Technical Details

• Odoo Version: Compatible with Odoo 18
• MercadoLibre API: Uses MercadoLibre's official API
• Authentication: OAuth 2.0 flow
• Sync Method: Real-time webhook-based synchronization
• Data Flow: Odoo → MercadoLibre (prices/stock) via API, MercadoLibre → Odoo (orders) via webhooks, for security reasons only webhooks coming from MercadoLibre's IP addresses are handled.