Conectores
E-commerce
Mercado Livre
8 min
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 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 acesse o seu painel de aplicações no mercado livre certifique se de configurar a redirect uri com o valor https //console fluidapi io 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); 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 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 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 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 { "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 }