--- title: Mercado Livre slug: mercado-livre docTags: createdAt: 2026-02-23T14:43:32.967Z --- ## Objetivo O conector do Mercado Livre é uma solução robusta projetada para otimizar a operação de importação de informações no maior marketplace da América Latina. Com este conector, as empresas podem integrar seus fluxos de venda, permitindo que os dados de pedidos, envios e produtos sejam processados automaticamente pela Fluid. O objetivo principal é fornecer uma ponte direta entre o ecossistema do Mercado Livre e outros sistemas internos (como ERPs ou CRMs), garantindo que informações críticas como status de rastreio e detalhes de pedidos sejam compartilhadas sem erros manuais. :::hint{type="info"} Para mais informações, acesse o portal de desenvolvedores do Mercado Livre: https\://developers.mercadolivre.com.br/ https\://developers.mercadolivre.com.br/pt\_br/api-docs-pt-br ::: ### Criando um fluxo utilizando o conector Mercado Livre Para criar um fluxo utilizando o conector do Mercado Livre, é necessário estabelecer uma conexão válida e, em seguida, configurar os recursos desejados no canvas. ### Criando conexão Mercado Livre O Mercado Livre utiliza o protocolo de autenticação **OAuth2** para garantir a segurança dos dados. Para realizar a integração, você deve configurar uma aplicação no portal de desenvolvedores do Mercado Livre. ### Configuração no Mercado Livre 1. Acesse o seu painel de aplicações no Mercado Livre. 2. Certifique-se de configurar a **Redirect URI** com o valor: `https://console.fluidapi.io`. 3. Obtenha o seu **Client ID** e **Client Secret**. ### Configuração na Fluid Ao criar a conexão na Fluid, você deverá preencher os seguintes parâmetros: - **ID do Cliente (client\_id)**: O ID fornecido pela aplicação do Mercado Livre (campo obrigatório); - **Chave Secreta do Cliente (client\_secret)**: A chave secreta fornecida pela aplicação (campo obrigatório); :::hint{type="info" indent="2"} Outros parâmetros como URL Token, Grant Type e Redirect URI já vêm configurados por padrão para apontar para os endpoints oficiais do Mercado Livre e da Fluid. ::: Após preencher os campos, clique no botão **Login OAuth2** para autorizar o acesso da Fluid à sua conta. OBS: [Criar Conexão](https://docs.fluidapi.io/criar-conexao) e acesse nosso passo a passo para saber como criar uma conexão. ### Configurando fluxo Mercado Livre Crie um fluxo e arraste o conector Mercado Livre para o canvas. OBS: [Criar Fluxo](https://docs.fluidapi.io/criar-fluxo) e acesse nosso passo a passo para saber como criar um fluxo. Selecione o conector e na aba de `Parametrização` preencha os seguintes parâmetros de configuração: - **Recurso**: Entidade do Mercado Livre para a qual será realizada a ação. - **Operação**: Ação específica que será realizada para o recurso selecionado. ### Operações disponíveis por Recurso: **1. Pedidos (Orders)** - **Consultar Pedido por ID**: Requer o ID do pedido gerado pelo Mercado Livre. - **Listar Pedidos do Vendedor (Seller)**: Lista as vendas associadas a um vendedor. Requer o Seller ID. **2. Usuários (Users)** - **Consultar Usuário por ID**: Retorna os dados públicos de um usuário ou comprador. Requer o ID do Usuário. **3. Envios (Shipments)** - **Consultar Envio por ID**: Requer o Shipment ID para retornar detalhes gerais da entrega. - **Consultar Itens do Envio**: Retorna a lista de produtos contidos dentro de um envio específico. - **Consultar Custos do Envio**: Detalha os custos logísticos (frete, taxas). - **Consultar Rastreamento do Envio**: Fornece o histórico de eventos e status atual. **4. Produtos (Items)** - **Listar itens do vendedor**: Busca todos os anúncios de um vendedor. Requer o Seller ID. - **Consultar Item por ID**: Detalhes técnicos de um anúncio (preço, fotos, estoque). Ex: `MLB123456789`. ## Na prática Neste tópico, criaremos um exemplo de fluxo para consultar os detalhes de uma venda específica utilizando o ID da ordem. ![]() ### Passo 'getorder' Configuração da `Parametrização`: - **Recurso**: Pedidos (Orders) - **Operação**: Consultar Pedido por ID - **ID do Pedido (Mercado Livre)**: `2000015121537542` Para tratar os dados recebidos (como valor total e status, produto(item), comprador(buyer)), utilize o [De/para](https://docs.fluidapi.io/depara) nos passos seguintes. ### Conclusão Com o passo configurado, ao disparar o fluxo, o conector retornará um objeto detalhado do pedido: ```json { "buyer": { "billing_info": { "id": "809797681104201752" }, "first_name": "Test", "id": 3198900304, "last_name": "Test", "nickname": "TESTUSER5799984040372191990" }, "buying_mode": "buy_equals_pay", "cancel_detail": null, "context": { "channel": "marketplace", "flows": [], "site": "MLB" }, "currency_id": "BRL", "date_closed": "2026-02-12T10:48:06.000-04:00", "date_created": "2026-02-12T10:47:22.000-04:00", "feedback": { "buyer": null, "seller": null }, "fulfilled": null, "id": 2000015121537542, "last_updated": "2026-02-12T10:48:56.000-04:00", "manufacturing_ending_date": null, "mediations": [], "order_items": [ { "base_currency_id": null, "base_exchange_rate": null, "bundle": null, "compat_id": null, "currency_id": "BRL", "discounts": null, "element_id": null, "full_unit_price": 9800.49, "full_unit_price_currency_id": "BRL", "gross_price": 9800.49, "item": { "attributes": [], "category_id": "MLB3530", "condition": "used", "global_price": null, "id": "MLB6250784526", "net_weight": null, "release_date": null, "seller_custom_field": null, "seller_sku": null, "title": "Nintendo Switch - Teste (não Ofertar)", "user_product_id": "MLBU3794379192", "variation_attributes": [], "variation_id": null, "warranty": "Sem garantia" }, "kit_instance_id": null, "listing_type_id": "free", "manufacturing_days": null, "picked_quantity": null, "quantity": 1, "requested_quantity": { "measure": "unit", "value": 1 }, "sale_fee": 0, "stock": null, "unit_price": 9800.49 } ], "order_request": { "change": null, "return": null }, "pack_id": 2000011526182257, "paid_amount": 9800.49, "payments": [ { "activation_uri": null, "atm_transfer_reference": { "company_id": null, "transaction_id": null }, "authorization_code": "301299", "available_actions": [ "refund" ], "card_id": 9746487249, "collector": { "id": 3197670300 }, "coupon_amount": 0, "coupon_id": null, "currency_id": "BRL", "date_approved": "2026-02-12T10:47:24.000-04:00", "date_created": "2026-02-12T10:47:23.000-04:00", "date_last_modified": "2026-02-12T10:47:24.000-04:00", "deferred_period": null, "id": 145262678401, "installment_amount": 9800.49, "installments": 1, "issuer_id": "24", "marketplace_fee": 0, "operation_type": "regular_payment", "order_id": 2000015121537542, "overpaid_amount": 0, "payer_id": 3198900304, "payment_method_id": "master", "payment_type": "credit_card", "reason": "Nintendo Switch - Teste (não Ofertar)", "reference_id": null, "shipping_cost": 0, "site_id": "MLB", "status": "approved", "status_code": null, "status_detail": "accredited", "taxes_amount": 0, "total_paid_amount": 9800.49, "transaction_amount": 9800.49, "transaction_amount_refunded": 0, "transaction_order_id": null } ], "related_orders": null, "seller": { "id": 3197670300 }, "shipping": { "id": 46457020206 }, "shipping_cost": null, "static_tags": [], "status": "paid", "status_detail": null, "tags": [ "d2c", "pack_order", "paid", "one_shot", "not_delivered", "test_order" ], "taxes": { "amount": null, "currency_id": null, "id": null }, "total_amount": 9800.49 } ```