Mercado Livre
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: Criar Conexão 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 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 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
}