Mercado Livre

Adicionando a fonte de dados

Requisitos

  • Possuir uma conta de seller (vendedor)
  • Utilizar um login de ADMINISTRADOR da conta de seller

Instruções

  1. Faça login na conta do mercado livre que quer adcionar como ADMINISTRADOR
  2. Faça login na plataforma da Kondado clique em CRIAR + > Conector > Mercado Livre
  3. Na página do conector, selecione o país da sua conta e clique em "AUTORIZAR"
  4. Você será direcionado para fazer login no portal do Mercado Livre. Informe o email de um usuário ADMINISTRADOR
  5. No próximo passo, você poderá autorizar que a Kondado conecte-se à sua conta clicando em "Permitir" logo abaixo
      1. Sobre o aviso "Esta aplicação não é certificada..." trata-se apenas de uma formalidade do Mercado Livre para forçar desenvolvedores a criarem uma listagem na sua "App Store", entretando não se preocupe porque isso não irá alterar em nada o funcionamento das suas integrações com a Kondado
  6. Logo após clicar em "Permitir", você será direcionado de volta para a plataforma da Kondado, já com a sua conta autorizada (note que o campo "Usuário" do conector foi preenchido automaticamente)
  7. Agora, basta dar um nome ao seu conector e clicar em “SALVAR”

Pipelines

Resumo

Diagrama de relacionamento

Clique para expandir

Itens

Esta integracao e gratuita

Tipo de replicacao: Integral

Objeto principal

Anúncios publicados pelo vendedor no Mercado Livre, com títulos, preços, descrições e configurações.

Campo Tipo

id

text

[pt] Id do item

accepts_mercadopago

boolean

[pt] Indica se o anúncio aceita pagamento via Mercado Pago.

automatic_relist

boolean

[pt] Indica se o anúncio é republicado automaticamente ao expirar.

available_quantity

float

[pt] Quantidade de unidades disponíveis para venda no anúncio.

buying_mode

text

[pt] Modalidade de compra do anúncio.

catalog_listing

boolean

[pt] Indica se o anúncio é um anúncio de catálogo.

catalog_product_id

text

[pt] Identificador do produto de catálogo vinculado ao anúncio.

category_id

text

[pt] Identificador da categoria do anúncio.

category_name

text

[pt] Nome da categoria do anúncio.

channels

text

[pt] Canais de venda em que o anúncio está disponível.

total_visits_last_90_days

int

[pt] informa o numero de visitas no intervalo dos último 90 dias

date_to

timestamp

[pt] Data final, que define o intervalo de consulta para os últimos 90 dias.

date_from

timestamp

[pt] Data inicial, que define o intervalo de consulta para os últimos 90 dias.

condition

text

[pt] Condição do produto anunciado (novo ou usado).

currency_id

text

[pt] Identificador da moeda usada no preço do anúncio.

date_created

timestamp

[pt] Data e hora de criação do anúncio (ISO-8601).

differential_pricing

text

[pt] Configuração de precificação diferenciada aplicada ao anúncio.

domain_id

text

[pt] Identificador do domínio (categoria de produto) ao qual o anúncio pertence.

end_time

timestamp

[pt] Data e hora de encerramento do anúncio (ISO-8601).

expiration_time

timestamp

[pt] Data e hora de expiração do anúncio (ISO-8601).

geolocation_latitude

float

[pt] Latitude da geolocalização do anúncio.

geolocation_longitude

float

[pt] Longitude da geolocalização do anúncio.

health

float

[pt] Índice de qualidade do anúncio, variando de 0 a 1.

initial_quantity

float

[pt] Quantidade inicial de unidades disponibilizada no anúncio.

international_delivery_mode

text

[pt] Modo de entrega internacional configurado para o anúncio.

inventory_id

text

[pt] Identificador do inventário associado ao anúncio.

last_updated

timestamp

[pt] Data e hora da última atualização do anúncio (ISO-8601).

listing_source

text

[pt] Origem do anúncio.

listing_type_id

text

[pt] Identificador do tipo de anúncio.

official_store_id

text

[pt] Identificador da loja oficial associada ao anúncio.

parent_item_id

text

[pt] Identificador do anúncio pai ao qual este anúncio está vinculado.

permalink

text

[pt] URL permanente da página pública do anúncio.

secure_thumbnail

text

[pt] URL segura (HTTPS) da imagem em miniatura do anúncio.

seller_address_address_line

text

[pt] Logradouro completo do endereço do vendedor.

seller_address_city_name

text

[pt] Nome da cidade do endereço do vendedor.

seller_address_city_id

text

[pt] Identificador da cidade do endereço do vendedor.

seller_address_comment

text

[pt] Comentário ou complemento do endereço do vendedor.

seller_address_country_name

text

[pt] Nome do país do endereço do vendedor.

seller_address_country_id

text

[pt] Identificador do país do endereço do vendedor.

seller_address_id

float

[pt] Identificador do endereço do vendedor.

seller_address_latitude

float

[pt] Latitude do endereço do vendedor.

seller_address_longitude

float

[pt] Longitude do endereço do vendedor.

seller_address_search_location_city_id

text

[pt] Identificador da cidade da localização de busca do endereço do vendedor.

seller_address_search_location_city_name

text

[pt] Nome da cidade da localização de busca do endereço do vendedor.

seller_address_search_location_neighborhood_id

text

[pt] Identificador do bairro da localização de busca do endereço do vendedor.

seller_address_search_location

text

[pt] Nome do bairro da localização de busca do endereço do vendedor.

seller_address_search_location_state_id

text

[pt] Identificador do estado da localização de busca do endereço do vendedor.

seller_address_search_location_state_name

text

[pt] Nome do estado da localização de busca do endereço do vendedor.

seller_address_state_id

text

[pt] Identificador do estado do endereço do vendedor.

seller_address_state_name

text

[pt] Nome do estado do endereço do vendedor.

seller_address_zip_code

float

[pt] CEP do endereço do vendedor.

seller_contact

text

[pt] Informações de contato do vendedor associadas ao anúncio.

seller_custom_field

text

[pt] Campo personalizado definido pelo vendedor para o anúncio.

seller_id

float

[pt] Identificador do vendedor responsável pelo anúncio.

shipping_dimensions

text

[pt] Dimensões do pacote usadas no cálculo de frete do anúncio.

shipping_free_methods

text

[pt] Métodos de envio oferecidos gratuitamente no anúncio.

shipping_free_shipping

boolean

[pt] Indica se o anúncio oferece frete grátis.

shipping_local_pick_up

boolean

[pt] Indica se o anúncio permite retirada local pelo comprador.

shipping_logistic_type

text

[pt] Tipo de logística de envio aplicado ao anúncio.

shipping_mode

text

[pt] Modo de envio configurado para o anúncio.

shipping_store_pick_up

boolean

[pt] Indica se o anúncio permite retirada na loja física.

shipping_tags

text

[pt] Marcadores da configuração de frete do anúncio.

site_id

text

[pt] Identificador do site (marketplace por país) onde o anúncio está publicado.

sold_quantity

float

[pt] Quantidade de unidades já vendidas pelo anúncio.

start_time

timestamp

[pt] Data e hora em que o anúncio começou a ficar ativo (ISO-8601).

status

text

[pt] Situação atual do anúncio.

stop_time

timestamp

[pt] Data e hora em que o anúncio deixa de ficar ativo (ISO-8601).

subtitle

text

[pt] Subtítulo do anúncio.

tags

text

[pt] Marcadores associados ao anúncio.

thumbnail

text

[pt] URL da imagem em miniatura do anúncio.

thumbnail_id

text

[pt] Identificador da imagem em miniatura do anúncio.

title

text

[pt] Título do anúncio.

video_id

text

[pt] Identificador do vídeo associado ao anúncio.

warranty

text

[pt] Texto livre que descreve a garantia oferecida pelo vendedor para o anúncio.

mercadolivre_itens_attributes

Atributos dos anúncios (marca, modelo, tamanho, etc.) que descrevem as características do produto.

Campo Tipo

id

text

[pt] Id do item

attributes_attribute_group_id

text

[pt] Identificador do grupo ao qual o atributo do produto pertence.

attributes_attribute_group_name

text

[pt] Nome do grupo ao qual o atributo do produto pertence.

attributes_id

text

[pt] Identificador do atributo do produto.

attributes_name

text

[pt] Nome do atributo do produto.

attributes_value_id

float

[pt] Identificador do valor do atributo do produto.

attributes_value_name

text

[pt] Nome (texto) do valor do atributo do produto.

attributes_value_struct_number

float

[pt] Número do valor estruturado do atributo do produto.

attributes_value_struct

text

[pt] Unidade do valor estruturado do atributo do produto.

attributes_value_type

text

[pt] Tipo do valor do atributo do produto.

mercadolivre_itens_sale_terms

Termos de venda dos anúncios, como garantia, tipo de pagamento aceito e condições especiais.

Campo Tipo

id

text

[pt] Id do item

sale_terms_id

text

[pt] Identificador da condição de venda do anúncio.

sale_terms_name

text

[pt] Nome da condição de venda do anúncio.

sale_terms_value_id

float

[pt] Identificador do valor da condição de venda do anúncio.

sale_terms_value_name

text

[pt] Nome (texto) do valor da condição de venda do anúncio.

sale_terms_value_struct_number

float

[pt] Número do valor estruturado da condição de venda do anúncio.

sale_terms_value_struct_unit

text

[pt] Unidade do valor estruturado da condição de venda do anúncio.

sale_terms_value_type

text

[pt] Tipo do valor da condição de venda do anúncio.

Itens: estoque

Esta integracao e gratuita

Tipo de replicacao: Integral

Relacionamentos:

Estoque disponível dos anúncios do vendedor em cada centro de distribuição.

Campo Tipo

user_product_id

text

[pt] Identificador único do produto associado ao usuário.

type

text

[pt] meli_facility: O estoque está localizado nos depósitos de Fulfillment do Mercado Livre. Gerenciado pelo Mercado Livre (Full). selling_address: Endereço de origem do vendedor para itens com estoque Flex em publicações que também estão no Fulfillment do Mercado Livre. seller_warehouse: Múltiplos depósitos gerenciados pelo vendedor. Permite ao vendedor gerenciar o estoque em diferentes localidades.

item_id

text

[pt] Identificador único do item.

    Itens > > id

user_id

text

[pt] Identificador único do usuário.

user_nickname

text

[pt] Apelido do usuário.

quantity

int

[pt] Quantidade disponível em estoque.

availability_type

text

[pt] Indica a disponibilidade do item

network_node_id

text

[pt] Identificador do nó da rede.

store_id

text

[pt] Identificador da loja.

store_description

text

[pt] Descrição da loja/depósito onde o estoque do item está localizado.

store_location_address_line

text

[pt] Endereço (logradouro) da localização da loja/depósito onde o estoque do item está localizado.

store_location_country

text

[pt] País da localização da loja/depósito onde o estoque do item está localizado.

store_location_latitude

text

[pt] Latitude da localização da loja/depósito onde o estoque do item está localizado.

store_location_longitude

text

[pt] Longitude da localização da loja/depósito onde o estoque do item está localizado.

store_location_state

text

[pt] Estado (UF) da localização da loja/depósito onde o estoque do item está localizado.

store_status

text

[pt] Status da loja/depósito onde o estoque do item está localizado.

store_tags

text

[pt] Tags associadas à loja/depósito onde o estoque do item está localizado.

Itens: performance diária

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Relacionamentos:

Métricas de desempenho dos anúncios do vendedor por data (visitas, perguntas, vendas).

Campo Tipo

item_id

text

[pt] ID do item

    Itens > > id

metric_date

date

[pt] Data da métrica

item_title

text

[pt] Título do produto.

item_category_id

text

[pt] Identificador da categoria do item à qual a publicação está associada.

item_category_name

text

[pt] Nome da categoria do item à qual a publicação está associada.

item_tags

text

[pt] lista das tags selecionadas pelo vendedor, como entregue, pago. [KONDADO: Este campo é retornado concatenado]

total_visits

int

[pt] Total de visitas recebidas pelo item no dia.

total_phone_views

int

[pt] Total de visualizações de número de telefone recebidas pelo item no dia

total_whatsapp_clicks

int

[pt] Total de clicks no botão Whatsapp recebidas pelo item no dia.

Itens: preços

Esta integracao e gratuita

Tipo de replicacao: Integral

Relacionamentos:

Preços dos anúncios do vendedor, incluindo valores base, promocionais e condições especiais.

Campo Tipo

item_id

text

[pt] Id do produto

    Itens > > id

amount

float

[pt] Valor do preço do anúncio, em R$ (BRL).

conditions_context_restrictions

text

[pt] Restrições de contexto aplicáveis às condições do preço do anúncio.

conditions_end_time

timestamp

[pt] Data e hora de término de vigência das condições do preço do anúncio, no formato ISO-8601.

conditions_start_time

timestamp

[pt] Data e hora de início de vigência das condições do preço do anúncio, no formato ISO-8601.

currency_id

text

[pt] Identificador da moeda do preço do anúncio.

item_price_id

float

[pt] Identificador do preço do anúncio no Mercado Livre.

last_updated

timestamp

[pt] Data e hora da última atualização do preço do anúncio, no formato ISO-8601.

regular_amount

text

[pt] Valor regular do preço do anúncio, em R$ (BRL).

type

text

[pt] Tipo de preço do anúncio no Mercado Livre.

Itens: preços de venda

Esta integracao e gratuita

Tipo de replicacao: Integral

Relacionamentos:

Preços de venda promocional dos anúncios, com datas de início e fim.

Campo Tipo

item_id

text

[pt] Id do produto

    Itens > > id

amount

float

[pt] Valor do preço promocional do anúncio, em R$ (BRL).

promotion_id

text

[pt] Identificador da promoção associada ao preço promocional do anúncio.

promotion_type

text

[pt] Tipo de promoção associado ao preço promocional do anúncio.

currency_id

text

[pt] Identificador da moeda do preço promocional do anúncio.

price_id

float

[pt] Identificador do preço promocional do anúncio no Mercado Livre.

reference_date

timestamp

[pt] Data de referência do preço promocional do anúncio, no formato ISO-8601.

regular_amount

text

[pt] Valor regular do preço promocional do anúncio, em R$ (BRL).

Itens: variações

Esta integracao e gratuita

Tipo de replicacao: Integral

Relacionamentos:

Objeto principal

Variações dos anúncios do vendedor (cor, tamanho, etc.) com preço e estoque específicos.

Campo Tipo

item_id

text

[pt] Id do item

    Itens > > id

item_variation_id

float

[pt] Id da variação de produto

catalog_product_id

text

[pt] Identificador do produto de catálogo associado a esta variação do anúncio.

available_quantity

float

[pt] Quantidade disponível em estoque desta variação do anúncio.

inventory_id

text

[pt] Identificador de inventário associado a esta variação do anúncio.

seller_custom_field

text

[pt] Campo personalizado definido pelo vendedor para esta variação do anúncio.

sold_quantity

float

[pt] Quantidade vendida desta variação do anúncio no Mercado Livre.

mercadolivre_itens_variations_attribute_combinations

Combinações de atributos das variações dos anúncios (ex.: cor + tamanho).

Campo Tipo

item_id

text

[pt] Id do item

item_variation_id

float

[pt] Id da variação de produto

attribute_combinations_id

text

[pt] Identificador do atributo que compõe a combinação que define a variação do anúncio.

attribute_combinations_name

text

[pt] Nome do atributo que compõe a combinação que define a variação do anúncio.

attribute_combinations_value_id

float

[pt] Identificador do valor do atributo que compõe a combinação que define a variação do anúncio.

attribute_combinations_value_name

text

[pt] Nome do valor do atributo que compõe a combinação que define a variação do anúncio.

attribute_combinations_value_struct_number

float

[pt] Número do valor estruturado do atributo que compõe a combinação que define a variação do anúncio.

attribute_combinations_value_struct_unit

text

[pt] Unidade do valor estruturado do atributo que compõe a combinação que define a variação do anúncio.

attribute_combinations_value_type

text

[pt] Tipo do valor do atributo que compõe a combinação que define a variação do anúncio.

Loja: performance diária

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Métricas de desempenho do vendedor por data, incluindo visitas e engajamento geral.

Campo Tipo

user_id

text

[pt] Id do usuário

metric_date

date

[pt] Data da métrica

total_questions

int

[pt] Total de perguntas recebidas pelo usuário no intervalo especificado.

total_visits

int

[pt] Total de visitas recebidas aos itens do usuário no intervalo especificado.

total_phone_views

int

[pt] Total de visualizações do número de telefone recebidas pelos itens no intervalo especificado.

total_whatsapp_clicks

int

[pt] Total de clicks no botão Whatsapp recebidas pelo itens no intervalo especificado.

Pedidos

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

Pedidos do Mercado Livre com status, valores, tributos e metadados de cancelamento.

Campo Tipo

id

text

[pt] Identificador único da ordem.

date_closed

timestamp

[pt] Data de confirmação da ordem; definida quando o pedido muda para confirmed/paid e o item é baixado do estoque.

last_updated

timestamp

[pt] Data da última modificação da ordem.

coupon__amount

float

[pt] Valor aplicado via cupom na ordem.

coupon__id

text

[pt] Identificador do cupom aplicado.

currency_id

text

[pt] ID da moeda da ordem.

cancel_detail__code

text

[pt] Código da causa do cancelamento.

cancel_detail__application_id

text

[pt] ID da aplicação que solicitou o cancelamento.

cancel_detail__description

text

[pt] Descrição da causa do cancelamento.

cancel_detail__requested_by

text

[pt] Quem solicitou o cancelamento (buyer, seller ou Mercado Livre).

cancel_detail__date

timestamp

[pt] Data em que o cancelamento foi registrado.

cancel_detail__group

text

[pt] Agrupamento lógico da causa (mediations, fiscal, buyer, fraud, item, shipment, delivery, seller, internal).

manufacturing_ending_date

text

[pt] Data prevista para finalizar a produção do item.

seller__nickname

text

[pt] Apelido do vendedor no Mercado Livre.

seller__id

text

[pt] Identificador do vendedor no Mercado Livre.

order_request__return

text

[pt] Indicador de solicitação de devolução associada à ordem.

order_request__change

text

[pt] Indicador de solicitação de troca associada à ordem.

status

text

[pt] Status atual da ordem (confirmed, payment_required, payment_in_process, partially_paid, paid, partially_refunded, pending_cancel, cancelled ou invalid).

date_last_updated

timestamp

[pt] Data da última atualização da ordem.

tags

text

[pt] Lista de tags selecionadas pelo vendedor (ex.: entregue, pago). [Kondado: campo retornado concatenado]

pack_id

text

[pt] Identificador do pacote logístico associado.

pickup_id

text

[pt] Identificador da retirada vinculada.

status_detail__code

text

[pt] Código detalhado do status da ordem.

status_detail__description

text

[pt] Descrição detalhada do status da ordem.

buyer__nickname

text

[pt] Apelido do comprador no Mercado Livre.

buyer__id

text

[pt] Identificador do comprador no Mercado Livre.

total_amount

float

[pt] Valor total do pedido.

expiration_date

timestamp

[pt] Prazo limite para qualificação; depois disso feedbacks ficam visíveis, pagamentos são liberados e encargos criados.

taxes__currency_id

text

[pt] Moeda usada para calcular impostos; converter quando diferente de items.currency_id.

taxes__amount

float

[pt] Total de impostos cobrados para o pedido.

fulfilled

boolean

[pt] Indica se o pedido foi completamente atendido.

paid_amount

float

[pt] Valor efetivamente pago pelo comprador.

date_created

text

[pt] Data de criação da ordem.

Pedidos: avaliações

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): Selecione a data inicial de leitura dos dados

Relacionamentos:

Feedbacks e avaliações realizadas pelos compradores e vendedores sobre cada pedido.

Campo Tipo

order_id

text

[pt] Identificador único da ordem.

    Pedidos > > id

feedback_id

text

[pt] Identificador único da avaliação de compra.

purchase_app_id

float

[pt] Identificador da aplicação que originou a avaliação de compra.

purchase_date_created

timestamp

[pt] Data de criação da avaliação de compra, no formato ISO-8601.

purchase_extended_feedback

text

[pt] Comentário estendido associado à avaliação de compra.

purchase_from_id

float

[pt] Identificador do usuário que registrou a avaliação de compra.

purchase_from_nickname

text

[pt] Apelido do usuário que registrou a avaliação de compra.

purchase_from_points

float

[pt] Pontos do usuário que registrou a avaliação de compra.

purchase_from_status

text

[pt] Status do usuário que registrou a avaliação de compra.

purchase_fulfilled

boolean

[pt] Indica se a operação foi concretizada (True/False).

purchase_has_seller_refunded_money

text

[pt] Indica se o vendedor reembolsou o valor referente à avaliação de compra.

purchase_item_currency_id

text

[pt] Identificador da moeda do item avaliado na avaliação de compra.

purchase_item_price

float

[pt] Preço do item avaliado na avaliação de compra, valor monetário em R$ (BRL).

purchase_item_title

text

[pt] Título do item avaliado na avaliação de compra.

purchase_item_id

float

[pt] Identificador do item avaliado na avaliação de compra.

purchase_message

text

[pt] Mensagem de feedback com até 160 caracteres.

purchase_modified

boolean

[pt] Indica se a avaliação de compra foi modificada.

purchase_rating

text

[pt] Qualificação da operação: negative, neutral ou positive (somente quando fulfilled é true).

purchase_reason

text

[pt] Motivo do feedback (ver valores aceitos na documentação).

purchase_reply

text

[pt] Resposta associada à avaliação de compra.

purchase_role

text

[pt] Papel do usuário que registrou a avaliação de compra.

purchase_site_id

text

[pt] Identificador do site do Mercado Livre referente à avaliação de compra.

purchase_status

text

[pt] Status da avaliação de compra.

purchase_to_id

float

[pt] Identificador do usuário avaliado na avaliação de compra.

purchase_to_nickname

text

[pt] Apelido do usuário avaliado na avaliação de compra.

purchase_to_points

float

[pt] Pontos atribuídos ao usuário avaliado na avaliação de compra.

purchase_to_status

text

[pt] Status do usuário avaliado na avaliação de compra.

purchase_visibility_date

text

[pt] Data em que a avaliação de compra se tornou visível.

sale

text

[pt] Avaliação relacionada à venda da ordem no Mercado Livre.

Pedidos: compradores

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

Relacionamentos:

Dados do comprador associados a cada pedido.

Campo Tipo

order_id

text

[pt] Identificador único da ordem.

    Pedidos > > id

buyer_first_name

text

[pt] Nome do comprador.

buyer_last_name

text

[pt] Sobrenome do comprador.

buyer_email

text

[pt] E-mail do comprador no Mercado Livre.

buyer__nickname

text

[pt] Apelido do comprador.

buyer__id

text

[pt] Identificador do comprador no Mercado Livre.

Pedidos: contexto

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): Selecione a data inicial de leitura dos dados

Relacionamentos:

Contexto da venda do pedido, incluindo canal de origem (marketplace, loja) e fluxos especiais.

Campo Tipo

order_id

text

[pt] Identificador único da ordem.

    Pedidos > > id

date_last_updated

timestamp

[pt] Data e hora da última atualização do contexto da ordem, no formato ISO-8601.

context_application

text

[pt] Aplicação associada ao contexto da ordem no Mercado Livre.

context_channel

text

[pt] Canal pelo qual a ordem foi originada, dentro do contexto da ordem.

context_flows

text

[pt] Fluxos associados ao contexto da ordem no Mercado Livre.

context_product_id

text

[pt] Identificador do produto associado ao contexto da ordem.

context_site

text

[pt] Identificador do site Mercado Livre no qual a ordem foi gerada, dentro do contexto da ordem.

Pedidos: envios

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): Selecione a data inicial de leitura dos dados

Relacionamentos:

Objeto principal

Informações de envio dos pedidos do Mercado Livre, com endereços, rastreamento e status de entrega.

Campo Tipo

order_id

text

[pt] Identificador único da ordem.

    Pedidos > > id

application_id

text

[pt] Identificador da aplicação associada ao envio

base_cost

float

[pt] Custo base do frete do envio, valor monetário em R$ (BRL)

carrier_info

text

[pt] Informações da transportadora responsável pelo envio

comments

text

[pt] Comentários associados ao envio

cost_components_compensation

float

[pt] Componente de compensação aplicado ao custo do frete, valor monetário em R$ (BRL)

cost_components_gap_discount

float

[pt] Componente de desconto de gap aplicado ao custo do frete, valor monetário em R$ (BRL)

cost_components_loyal_discount

float

[pt] Componente de desconto de fidelidade aplicado ao custo do frete, valor monetário em R$ (BRL)

cost_components_ratio

float

[pt] Proporção (ratio) usada no rateio dos componentes de custo do frete

cost_components_special_discount

float

[pt] Componente de desconto especial aplicado ao custo do frete, valor monetário em R$ (BRL)

created_by

text

[pt] Identificação de quem ou do que criou o envio

date_created

timestamp

[pt] Data e hora de criação do envio (ISO-8601)

date_first_printed

timestamp

[pt] Data e hora em que a etiqueta do envio foi impressa pela primeira vez (ISO-8601)

id

float

[pt] Identificador único do envio.

last_updated

timestamp

[pt] Data e hora da última atualização do envio (ISO-8601)

logistic_type

text

[pt] Tipo de logística utilizado no envio

market_place

text

[pt] Marketplace ao qual o envio está vinculado

mode

text

[pt] Modo do envio

order_cost

float

[pt] Custo do pedido associado ao envio, valor monetário em R$ (BRL)

receiver_address_address_line

text

[pt] Linha de endereço completa do endereço de destino (destinatário) do envio

receiver_address_agency

text

[pt] Agência/ponto associado ao endereço de destino (destinatário) do envio

receiver_address_city_name

text

[pt] Nome da cidade do endereço de destino (destinatário) do envio

receiver_address_city_id

text

[pt] Identificador da cidade do endereço de destino (destinatário) do envio

receiver_address_comment

text

[pt] Comentário/complemento do endereço de destino (destinatário) do envio

receiver_address_country_name

text

[pt] Nome do país do endereço de destino (destinatário) do envio

receiver_address_country_id

text

[pt] Identificador do país do endereço de destino (destinatário) do envio

receiver_address_delivery_preference

text

[pt] Preferência de entrega informada para o endereço de destino do envio

receiver_address_geolocation_last_updated

timestamp

[pt] Data e hora da última atualização da geolocalização do endereço de destino (destinatário) do envio (ISO-8601)

receiver_address_geolocation_source

text

[pt] Fonte da geolocalização do endereço de destino (destinatário) do envio

receiver_address_geolocation_type

text

[pt] Tipo de geolocalização do endereço de destino (destinatário) do envio

receiver_address_id

float

[pt] Identificador do endereço de destino (destinatário) do envio

receiver_address_intersection

text

[pt] Referência de cruzamento/esquina do endereço de destino (destinatário) do envio

receiver_address_latitude

float

[pt] Latitude geográfica do endereço de destino (destinatário) do envio

receiver_address_location_id

text

[pt] Identificador da localidade do endereço de destino (destinatário) do envio

receiver_address_longitude

float

[pt] Longitude geográfica do endereço de destino (destinatário) do envio

receiver_address_municipality_name

text

[pt] Nome do município do endereço de destino (destinatário) do envio

receiver_address_municipality_id

text

[pt] Identificador do município do endereço de destino (destinatário) do envio

receiver_address_neighborhood_name

text

[pt] Nome do bairro do endereço de destino (destinatário) do envio

receiver_address_neighborhood_id

text

[pt] Identificador do bairro do endereço de destino (destinatário) do envio

receiver_address_receiver_name

text

[pt] Nome do destinatário no endereço de destino do envio

receiver_address_receiver_phone

text

[pt] Telefone do destinatário no endereço de destino do envio

receiver_address_scoring

text

[pt] Pontuação (scoring) do endereço de destino (destinatário) do envio

receiver_address_state_name

text

[pt] Nome do estado/UF do endereço de destino (destinatário) do envio

receiver_address_state_id

text

[pt] Identificador do estado/UF do endereço de destino (destinatário) do envio

receiver_address_street_name

text

[pt] Nome do logradouro do endereço de destino (destinatário) do envio

receiver_address_street_number

text

[pt] Número do logradouro do endereço de destino (destinatário) do envio

receiver_address_types

text

[pt] Tipos do endereço de destino (destinatário) do envio [KONDADO: Este campo é retornado concatenado]

receiver_address_zip_code

text

[pt] CEP do endereço de destino (destinatário) do envio

receiver_id

float

[pt] Identificador do destinatário (comprador) do envio

return_details

text

[pt] Detalhes da devolução do envio

return_tracking_number

text

[pt] Código de rastreamento da devolução do envio

sender_address_address_line

text

[pt] Linha de endereço completa do endereço de origem (remetente) do envio

sender_address_agency

text

[pt] Agência/ponto associado ao endereço de origem (remetente) do envio

sender_address_city_name

text

[pt] Nome da cidade do endereço de origem (remetente) do envio

sender_address_city_id

text

[pt] Identificador da cidade do endereço de origem (remetente) do envio

sender_address_comment

text

[pt] Comentário/complemento do endereço de origem (remetente) do envio

sender_address_country_name

text

[pt] Nome do país do endereço de origem (remetente) do envio

sender_address_country_id

text

[pt] Identificador do país do endereço de origem (remetente) do envio

sender_address_geolocation_last_updated

timestamp

[pt] Data e hora da última atualização da geolocalização do endereço de origem (remetente) do envio (ISO-8601)

sender_address_geolocation_source

text

[pt] Fonte da geolocalização do endereço de origem (remetente) do envio

sender_address_geolocation_type

text

[pt] Tipo de geolocalização do endereço de origem (remetente) do envio

sender_address_id

float

[pt] Identificador do endereço de origem (remetente) do envio

sender_address_intersection

text

[pt] Referência de cruzamento/esquina do endereço de origem (remetente) do envio

sender_address_latitude

float

[pt] Latitude geográfica do endereço de origem (remetente) do envio

sender_address_location_id

text

[pt] Identificador da localidade do endereço de origem (remetente) do envio

sender_address_longitude

float

[pt] Longitude geográfica do endereço de origem (remetente) do envio

sender_address_municipality_name

text

[pt] Nome do município do endereço de origem (remetente) do envio

sender_address_municipality_id

text

[pt] Identificador do município do endereço de origem (remetente) do envio

sender_address_neighborhood_name

text

[pt] Nome do bairro do endereço de origem (remetente) do envio

sender_address_scoring

text

[pt] Pontuação (scoring) do endereço de origem (remetente) do envio

sender_address_state_name

text

[pt] Nome do estado/UF do endereço de origem (remetente) do envio

sender_address_state_id

text

[pt] Identificador do estado/UF do endereço de origem (remetente) do envio

sender_address_street_name

text

[pt] Nome do logradouro do endereço de origem (remetente) do envio

sender_address_street_number

text

[pt] Número do logradouro do endereço de origem (remetente) do envio

sender_address_types

text

[pt] Tipos do endereço de origem (remetente) do envio [KONDADO: Este campo é retornado concatenado]

sender_address_zip_code

text

[pt] CEP do endereço de origem (remetente) do envio

sender_id

float

[pt] Identificador do remetente (vendedor) do envio

service_id

float

[pt] Identificador do serviço de frete utilizado no envio

shipping_option_buffering_date

text

[pt] Data e hora de buffering (margem de processamento) da opção de frete escolhida

shipping_option_cost

float

[pt] Custo da opção de envio escolhida, que representa a taxa de frete paga pelo comprador.

shipping_option_currency_id

text

[pt] Identificador da moeda dos custos da opção de frete escolhida

shipping_option_delivery_promise

text

[pt] Promessa de entrega associada à opção de frete escolhida

shipping_option_delivery_type

text

[pt] Tipo de entrega da opção de frete escolhida

shipping_option_estimated_delivery_extended_date

timestamp

[pt] Data e hora estendida estimada de entrega da opção de frete escolhida (ISO-8601)

shipping_option_estimated_delivery_extended_offset

float

[pt] Deslocamento (offset) da data estendida estimada de entrega da opção de frete escolhida

shipping_option_estimated_delivery_final_date

timestamp

[pt] Data e hora final estimada de entrega da opção de frete escolhida (ISO-8601)

shipping_option_estimated_delivery_final_offset

float

[pt] Deslocamento (offset) da data final estimada de entrega da opção de frete escolhida

shipping_option_estimated_delivery_limit_date

timestamp

[pt] Data e hora limite estimada de entrega da opção de frete escolhida (ISO-8601)

shipping_option_estimated_delivery_limit_offset

float

[pt] Deslocamento (offset) da data limite estimada de entrega da opção de frete escolhida

shipping_option_estimated_delivery_date

timestamp

[pt] Data e hora estimada de entrega da opção de frete escolhida (ISO-8601)

shipping_option_estimated_delivery_handling

float

[pt] Componente de tempo de preparação (handling) na estimativa de entrega da opção de frete escolhida

shipping_option_estimated_delivery_offset_date

timestamp

[pt] Data e hora de referência do deslocamento (offset) da estimativa de entrega da opção de frete escolhida (ISO-8601)

shipping_option_estimated_delivery_offset_shipping

float

[pt] Deslocamento (offset) de transporte aplicado à estimativa de entrega da opção de frete escolhida

shipping_option_estimated_delivery_pay_before

timestamp

[pt] Data e hora limite de pagamento para garantir a estimativa de entrega da opção de frete escolhida (ISO-8601)

shipping_option_estimated_delivery_schedule

text

[pt] Agendamento da estimativa de entrega da opção de frete escolhida

shipping_option_estimated_delivery_shipping

float

[pt] Componente de tempo de transporte na estimativa de entrega da opção de frete escolhida

shipping_option_estimated_delivery_time_frame_from

text

[pt] Limite inferior da janela estimada de tempo de entrega da opção de frete escolhida

shipping_option_estimated_delivery_time_frame_to

text

[pt] Limite superior da janela estimada de tempo de entrega da opção de frete escolhida

shipping_option_estimated_delivery_time_type

text

[pt] Tipo da estimativa de tempo de entrega da opção de frete escolhida

shipping_option_estimated_delivery_time_unit

text

[pt] Unidade de tempo da estimativa de entrega da opção de frete escolhida

shipping_option_estimated_handling_limit_date

timestamp

[pt] Data limite estimada de preparação (handling) da opção de frete escolhida (ISO-8601)

shipping_option_estimated_schedule_limit_date

timestamp

[pt] Data limite estimada para agendamento da opção de frete escolhida (ISO-8601)

shipping_option_id

float

[pt] Identificador da opção de frete escolhida para o envio

shipping_option_list_cost

float

[pt] Custo de tabela da opção de frete escolhida, valor monetário em R$ (BRL)

shipping_option_name

text

[pt] Nome da opção/método de frete escolhido

shipping_option_processing_time

text

[pt] Tempo de processamento da opção de frete escolhida

shipping_option_shipping_method_id

float

[pt] Identificador do método de frete da opção de envio escolhida

sibling_date_created

text

[pt] Data e hora de criação do envio relacionado (sibling)

sibling_description

text

[pt] Descrição do envio relacionado (sibling) ao envio atual

sibling_last_updated

text

[pt] Data e hora da última atualização do envio relacionado (sibling)

sibling_reason

text

[pt] Motivo da relação entre o envio atual e o envio relacionado (sibling)

sibling_sibling_id

text

[pt] Identificador do envio relacionado (sibling) ao envio atual

sibling_source

text

[pt] Origem do envio relacionado (sibling) ao envio atual

site_id

text

[pt] Identificador do site/marketplace do Mercado Livre ao qual o envio pertence

status

text

[pt] Status atual do envio

status_history_date_cancelled

timestamp

[pt] Data e hora em que o envio foi cancelado (ISO-8601)

status_history_date_delivered

timestamp

[pt] Data e hora em que o envio foi entregue (ISO-8601)

status_history_date_first_visit

timestamp

[pt] Data e hora da primeira tentativa de entrega do envio (ISO-8601)

status_history_date_handling

timestamp

[pt] Data e hora em que o envio entrou na etapa de preparação (handling) (ISO-8601)

status_history_date_not_delivered

timestamp

[pt] Data e hora em que o envio foi registrado como não entregue (ISO-8601)

status_history_date_ready_to_ship

timestamp

[pt] Data e hora em que o envio ficou pronto para ser despachado (ISO-8601)

status_history_date_returned

timestamp

[pt] Data e hora em que o envio foi devolvido (ISO-8601)

status_history_date_shipped

timestamp

[pt] Data e hora em que o envio foi despachado (ISO-8601)

substatus

text

[pt] Sub-status atual do envio, detalhando a situação dentro do status principal

tags

text

[pt] Marcadores associados ao envio [KONDADO: Este campo é retornado concatenado]

tracking_method

text

[pt] Método ou transportadora responsável pelo rastreamento do envio

tracking_number

text

[pt] Código de rastreamento atribuído ao envio pela transportadora

type

text

[pt] Tipo do envio

mercadolivre_orders_shipments__substatus_history

Histórico de alterações de substatus do envio ao longo do tempo.

Campo Tipo

order_id

text

[pt] Identificador único da ordem.

    Pedidos > > id

substatus_history_date

timestamp

[pt] Data e hora do registro de um item do histórico de sub-status do envio (ISO-8601)

substatus_history_status

text

[pt] Status principal associado a um item do histórico de sub-status do envio

substatus_history_substatus

text

[pt] Sub-status registrado em um item do histórico de sub-status do envio

Pedidos: itens

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

Relacionamentos:

Objeto principal

Itens vendidos em cada pedido do Mercado Livre, com informações de produto, preço, quantidade, taxas, datas da ordem e nome da categoria.

Campo Tipo

order_id

text

[pt] Identificador único da ordem

    Pedidos > > id

base_currency_id

text

[pt] Identificador da moeda base usada na conversão cambial do item na ordem.

base_exchange_rate

text

[pt] Taxa de câmbio base usada na conversão cambial do item na ordem.

bundle

text

[pt] Informações de agrupamento (bundle) do item na ordem.

currency_id

text

[pt] Identificador da moeda do item na ordem.

element_id

text

[pt] Identificador do elemento do item na ordem.

full_unit_price

float

[pt] Preço unitário cheio do item na ordem, valor monetário em R$ (BRL).

item_category_id

text

[pt] Identificador da categoria do item vendido na ordem.

item_condition

text

[pt] Condição do item vendido na ordem.

item_global_price

float

[pt] Preço global do item vendido na ordem, valor monetário em R$ (BRL).

item_id

text

[pt] Identificador do item vendido.

    Itens > > id

item_net_weight

float

[pt] Peso líquido do item vendido na ordem.

item_seller_custom_field

text

[pt] Campo personalizado do vendedor para o item vendido na ordem.

item_seller_sku

text

[pt] SKU do vendedor para o item vendido na ordem.

item_title

text

[pt] Título do produto vendido.

item_variation_id

float

[pt] Identificador da variação do item vendido na ordem.

item_warranty

text

[pt] Garantia do item vendido na ordem.

listing_type_id

text

[pt] Identificador do tipo de anúncio do item na ordem.

manufacturing_days

float

[pt] Quantidade de dias de fabricação do item na ordem.

picked_quantity

float

[pt] Quantidade do item efetivamente separada para a ordem.

quantity

float

[pt] Quantidade do item na ordem.

requested_quantity_measure

text

[pt] Unidade de medida da quantidade solicitada do item na ordem.

requested_quantity_value

float

[pt] Valor da quantidade solicitada do item na ordem.

sale_fee

float

[pt] Tarifa de venda cobrada sobre o item da ordem, valor monetário em R$ (BRL).

unit_price

float

[pt] Preço unitário do item na ordem, valor monetário em R$ (BRL).

date_closed

timestamp

[pt] Data de confirmação da ordem; definida quando o pedido muda para confirmed/paid.

last_updated

timestamp

[pt] Data da última modificação da ordem.

date_created

text

[pt] Data de criação da ordem.

date_last_updated

timestamp

[pt] Data da última atualização da ordem.

expiration_date

timestamp

[pt] Prazo limite para qualificação da transação.

order_status

text

[pt] Status atual da ordem (confirmed, payment_required, paid, cancelled, etc.).

item_category_name

text

[pt] Nome da categoria do item vendido.

mercadolivre_orders_items__item_variation_attributes

Atributos de variação dos itens vendidos (ex.: cor, tamanho).

Campo Tipo

order_id

text

[pt] Identificador único da ordem à qual o atributo da variação do item pertence.

item_id

text

[pt] Identificador do item ao qual o atributo da variação está associado.

    Pedidos: itens > > item_id

item_variation_attributes_id

text

[pt] Identificador do atributo da variação do item comprado na ordem.

item_variation_attributes_name

text

[pt] Nome do atributo da variação do item comprado na ordem.

item_variation_attributes_value_id

text

[pt] Identificador do valor do atributo da variação do item comprado na ordem.

item_variation_attributes_value_name

text

[pt] Nome do valor do atributo da variação do item comprado na ordem.

Pedidos: pagamento

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

Relacionamentos:

Pagamentos vinculados aos pedidos do Mercado Livre, com detalhes do método de pagamento, valores, parcelas e status.

Campo Tipo

order_id

text

[pt] Identificador único da ordem.

    Pedidos > > id

id

float

[pt] Identificador único do pagamento no Mercado Pago.

activation_uri

text

[pt] URI de ativação associada ao pagamento da ordem.

atm_transfer_reference_company_id

text

[pt] Identificador da empresa da referência de transferência bancária do pagamento da ordem.

atm_transfer_reference_transaction_id

float

[pt] Identificador da transação da referência de transferência bancária do pagamento da ordem.

authorization_code

text

[pt] Código de autorização da transação.

available_actions

text

[pt] Ações disponíveis para o pagamento da ordem.

card_id

float

[pt] Identificador do cartão usado no pagamento da ordem.

collector_id

float

[pt] Identificador da conta coletora do pagamento.

coupon_amount

float

[pt] Valor do cupom aplicado ao pagamento.

coupon_id

text

[pt] Identificador do cupom aplicado ao pagamento da ordem.

currency_id

text

[pt] Identificador da moeda utilizada no pagamento (ARS, BRL, CLP, MXN, COP, PEN, UYU).

date_approved

timestamp

[pt] Data de aprovação do pagamento. A data de criação pode não coincidir se o pagamento passou por estado intermediário.

date_created

timestamp

[pt] Data de criação do pagamento.

date_last_modified

timestamp

[pt] Data da última modificação do pagamento da ordem, no formato ISO-8601.

deferred_period

text

[pt] Período de diferimento do pagamento.

installment_amount

float

[pt] Valor da parcela do financiamento escolhido.

installments

float

[pt] Número de parcelas selecionado.

issuer_id

float

[pt] Identificador do emissor do meio de pagamento.

operation_type

text

[pt] Tipo de operação do pagamento (regular_payment, money_transfer, recurring_payment, account_fund, payment_addition, cellphone_recharge, pos_payment).

overpaid_amount

float

[pt] Valor pago a mais pelo pagador.

payer_id

float

[pt] Identificador do pagador do pagamento da ordem.

payment_method_id

text

[pt] Identificador do meio de pagamento selecionado para efetuar o pagamento.

payment_type

text

[pt] Tipo do meio de pagamento (account_money, ticket, bank_transfer, atm, credit_card, debit_card, prepaid_card).

reason

text

[pt] Motivo associado ao pagamento da ordem.

shipping_cost

float

[pt] Valor do frete pago pelo comprador. Se o frete não foi cobrado devido a alguma promoção, o valor retornado é zero. Esta informação também está disponível na integração de pedidos: envios (shipping_option_list_cost).

site_id

text

[pt] Identificador do site do Mercado Livre referente ao pagamento da ordem.

status

text

[pt] Status do pagamento (pending, approved, authorized, in_process, in_mediation, rejected, cancelled, refunded, charged_back).

status_code

text

[pt] Código de status do pagamento da ordem.

status_detail

text

[pt] Detalhe do status do pagamento com código específico do resultado da transação.

taxes_amount

float

[pt] Valor dos impostos calculados para o pagamento.

total_paid_amount

float

[pt] Valor total cobrado ao pagador.

transaction_amount

float

[pt] Valor da transação.

transaction_amount_refunded

float

[pt] Valor reembolsado da transação.

transaction_order_id

text

[pt] Identificador da ordem de transação associada ao pagamento da ordem.

Pedidos: vendedores

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

Relacionamentos:

Dados do vendedor vinculados às ordens, incluindo contatos principais e alternativos.

Campo Tipo

order_id

text

[pt] Identificador único da ordem.

    Pedidos > > id

seller__nickname

text

[pt] Apelido do vendedor.

seller__id

text

[pt] Identificador do vendedor no Mercado Livre.

seller_first_name

text

[pt] Nome do vendedor.

seller_last_name

text

[pt] Sobrenome do vendedor.

seller__alternative_phone__area_code

text

[pt] DDD do telefone alternativo do vendedor.

seller__alternative_phone__extension

text

[pt] Ramal do telefone alternativo do vendedor.

seller__alternative_phone__number

text

[pt] Número do telefone alternativo do vendedor.

seller__email

text

[pt] E-mail do vendedor.

seller__phone__area_code

text

[pt] DDD do telefone principal do vendedor.

seller__phone__extension

text

[pt] Ramal do telefone principal do vendedor.

seller__phone__number

text

[pt] Número do telefone principal do vendedor.

seller__phone__verified

boolean

[pt] Indica se o telefone principal foi verificado.

Reclamações

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): Selecione a data inicial de leitura dos dados

Relacionamentos:

Objeto principal

Reclamações abertas contra pedidos no Mercado Livre, com status, resolução e metadados do processo de mediação.

Campo Tipo

id

float

[pt] Identificador único da reclamação.

date_created

timestamp

[pt] Data de criação da reclamação.

fulfilled

boolean

[pt] Indica se a reclamação foi cumprida.

last_updated

timestamp

[pt] Data da última atualização da reclamação.

parent_id

text

[pt] ID de outra reclamação da qual depende.

reason_id

text

[pt] Identificador do motivo da reclamação ou disputa pós-venda no Mercado Livre.

resolution_applied_coverage

boolean

[pt] Indica se houve aplicação de cobertura na resolução da reclamação.

resolution_benefited

text

[pt] Indica quem foi beneficiado pela resolução da reclamação.

resolution_closed_by

text

[pt] Indica por quem a resolução da reclamação foi encerrada.

resolution_date_created

timestamp

[pt] Data e hora de criação da resolução da reclamação, no formato ISO-8601.

resolution_reason

text

[pt] Motivo da resolução da reclamação ou disputa pós-venda no Mercado Livre.

resource

text

[pt] Identificador do recurso sobre o qual a reclamação é criada.

resource_id

text

[pt] ID do recurso sobre o qual a reclamação é criada, dependendo do tipo de resource.

    Pedidos > > id

site_id

text

[pt] ID do site onde a reclamação se desenvolve.

stage

text

[pt] Etapa atual da reclamação.

status

text

[pt] Status atual da reclamação.

type

text

[pt] Tipo de reclamação (ex.: mediations).

mercadolivre_reclamacoes_players

Participantes envolvidos em cada reclamação, incluindo papéis como reclamante e reclamado.

Campo Tipo

reclamacao_id

float

[pt] Identificador único da reclamação.

players_role

text

[pt] Papel do usuário dentro da reclamação (reclamante ou reclamado).

players_type

text

[pt] Papel desempenhado pela pessoa na operação reclamada (comprador ou vendedor).

players_user_id

float

[pt] ID do usuário que desempenha o papel.

mercadolivre_reclamacoes_players_actions

Ações disponíveis para cada participante da reclamação, com prazos e obrigatoriedade.

Campo Tipo

reclamacao_id

float

[pt] Identificador único da reclamação.

players_user_id

float

[pt] ID do usuário que desempenha o papel.

    Reclamações > players > players_user_id

player_action

text

[pt] Ação possível a ser realizada pelo participante.

player_action_mandatory

boolean

[pt] Indica se a ação é obrigatória.

player_action_due_date

timestamp

[pt] Data limite para execução da ação.

Anúncios

Tipo de replicacao: Incremental com janela de atualização

Parametros:

  • Janela de atualização (dias): Quantos dias anteriores ao Savepoint dados continuarão sendo atualizados
  • Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
  • Nível: Nível de granularidade das métricas
  • Período: Nível de granularidade temporal das métricas

A carga histórica inicial máxima é de 90 dias, e as métricas são atualizadas diariamente às 10:00 (GMT-3)

Tipo de replicacao: Integral

Parametros:

  • Janela de atualização (dias): Quantos dias anteriores ao Savepoint dados continuarão sendo atualizados
  • Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
  • Nível: Nível de granularidade das métricas
  • Período: Nível de granularidade temporal das métricas

Relacionamentos:

Métricas de desempenho de anúncios patrocinados do Mercado Livre, com impressões, cliques e custos.

Campo Tipo

metric_date

date

[pt] Data da métrica

id

text

[pt] Identificador único da campanha

name

text

[pt] Nome da campanha

advertiser_id

text

[pt] ID do anunciante

status

text

[pt] Status da campanha

last_updated

timestamp

[pt] Data de última atualização da campanha

date_created

timestamp

[pt] Data de criação da campanha

campaign_id

text

[pt] ID da campanha

campaign_name

text

[pt] Nome da campanha

sll

text

[pt] SLL (Sistema de Lojas Livres)

ad_group_type

text

[pt] Tipo do grupo de anúncios

ad_group_external_id

text

[pt] ID externo do grupo de anúncios

title

text

[pt] Título/Nome do grupo de anúncios

original_advertiser_id

text

[pt] ID do anunciante original

channel

text

[pt] Canal do anúncio (marketplace, mshops)

brand_value_name

text

[pt] Nome da marca

thumbnail

text

[pt] URL da imagem miniatura

catalog_listing

boolean

[pt] Se é listagem de catálogo

domain_id

text

[pt] ID do domínio

official_store_id

text

[pt] ID da loja oficial

brand_value_id

text

[pt] ID da marca

current_advertiser_id

text

[pt] ID do anunciante atual

item_id

text

[pt] ID do item

    Itens > > id

ad_group_id

text

[pt] ID do grupo de anúncios

ad_group_name

text

[pt] Nome do grupo de anúncios

logistic_type

text

[pt] Tipo de logística

price

float

[pt] Preço do item

condition

text

[pt] Condição do item (new, used)

permalink

text

[pt] Link permanente do anúncio

buy_box_winner

boolean

[pt] Se é ganhador do buy box

recommended

boolean

[pt] Se o anúncio é recomendado

current_level

text

[pt] Nível atual de reputação

deferred_stock

boolean

[pt] Se tem estoque diferido

has_discount

boolean

[pt] Se tem desconto

tags

text

[pt] Tags do anúncio

listing_type_id

text

[pt] Tipo de listagem

picture_id

text

[pt] ID da imagem principal

family_id

text

[pt] ID da família do produto

family_name

text

[pt] Nome da família do produto

user_product_id

text

[pt] ID do produto do usuário

user_product_name

text

[pt] Nome do produto do usuário

status_raw

text

[pt] Status bruto do anúncio

clicks

float

[pt] Número de cliques

prints

float

[pt] Número de impressões

cost

float

[pt] Custo total

cpc

float

[pt] Custo por clique

acos

float

[pt] Percentual de investimento sobre receitas

organic_units_quantity

int

[pt] Quantidade de unidades vendidas sem publicidade

organic_units_amount

float

[pt] Valor das unidades vendidas sem publicidade

organic_items_quantity

int

[pt] Quantidade de vendas sem publicidade

direct_items_quantity

int

[pt] Quantidade de vendas diretas por publicidade

indirect_items_quantity

int

[pt] Quantidade de vendas indiretas por publicidade

advertising_items_quantity

int

[pt] Quantidade de vendas por publicidade

direct_units_quantity

int

[pt] Quantidade de unidades vendidas em vendas diretas

indirect_units_quantity

int

[pt] Quantidade de unidades vendidas em vendas assistidas

units_quantity

int

[pt] Quantidade total de vendas

direct_amount

float

[pt] Valor das vendas diretas

ctr

float

[pt] Taxa de cliques (clicks/impressões)

cvr

float

[pt] Taxa de conversão (vendas/cliques)

roas

float

[pt] Retorno sobre investimento em publicidade

sov

float

[pt] Participação de voz (share of voice)

indirect_amount

float

[pt] Valor das vendas assistidas

total_amount

float

[pt] Valor total das vendas

Pagamentos Mercado Pago

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data os pagamentos serao lidos. A API retorna apenas os ultimos 12 meses.

Relacionamentos:

Pagamentos do Mercado Pago com status, valores, método de pagamento, detalhes da transação e informações do pagador.

Campo Tipo

id

text

[pt] Identificador único do pagamento, gerado automaticamente pelo Mercado Pago.

date_created

timestamp

[pt] Data de criação do pagamento.

date_approved

timestamp

[pt] Data de aprovação do pagamento. Um pagamento pode ser gerado em um estado intermediário e depois aprovado.

date_last_updated

timestamp

[pt] Data em que o último evento de pagamento foi registrado.

money_release_date

timestamp

[pt] Data em que o dinheiro foi liberado para o vendedor.

payment_method_id

text

[pt] Identificador do método de pagamento (ex: master, visa, pix, bolbradesco).

payment_type_id

text

[pt] Tipo de pagamento (credit_card, debit_card, ticket, bank_transfer, etc.).

status

text

[pt] Status atual do pagamento (pending, approved, authorized, in_process, in_mediation, rejected, cancelled, refunded, charged_back).

status_detail

text

[pt] Detalhe do status do pagamento (ex: accredited, pending_contingency, cc_rejected_high_risk).

currency_id

text

[pt] Identificador da moeda do pagamento (BRL, USD, etc.).

description

text

[pt] Descrição do pagamento.

collector_id

text

[pt] Identificador do coletor/vendedor que recebe o pagamento.

payer_id

text

[pt] Identificador do pagador.

payer_email

text

[pt] E-mail do pagador.

payer_identification_type

text

[pt] Tipo de documento de identificação do pagador (CPF, CNPJ, etc.).

payer_identification_number

text

[pt] Número do documento de identificação do pagador.

payer_type

text

[pt] Tipo do pagador (customer, registered, guest).

external_reference

text

[pt] Referência externa do pagamento. Pode ser, por exemplo, um ID de pedido do sistema do vendedor.

transaction_amount

float

[pt] Valor total da transação.

transaction_amount_refunded

float

[pt] Valor total reembolsado da transação.

coupon_amount

float

[pt] Valor do cupom aplicado ao pagamento.

transaction_details_net_received_amount

float

[pt] Valor líquido recebido após descontos de taxas.

transaction_details_total_paid_amount

float

[pt] Valor total pago pelo comprador.

transaction_details_overpaid_amount

float

[pt] Valor pago a mais.

transaction_details_installment_amount

float

[pt] Valor de cada parcela.

installments

int

[pt] Número de parcelas do pagamento.

order_id

text

[pt] ID do pedido do Mercado Livre associado ao pagamento.

    Pedidos > > id

Pedidos: Notas Fiscais

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): Selecione a data inicial de leitura dos dados

Relacionamentos:

Objeto principal

Dados do XML da NF-e associada aos pedidos do Mercado Livre.

Campo Tipo

order_id

text

[pt] ID do pedido no Mercado Livre

    Pedidos > > id

invoice_id

text

[pt] ID da nota fiscal

invoice_number

float

[pt] Numero da nota fiscal

invoice_series

text

[pt] Serie da nota fiscal

invoice_key

text

[pt] Chave de acesso da NF-e

invoice_status

text

[pt] Status da nota fiscal

invoice_amount

float

[pt] Valor total da nota fiscal

issued_date

text

[pt] Data de emissao da nota fiscal

ide_nnf

text

[pt] Numero da NF-e (campo XML)

ide_serie

text

[pt] Serie do documento fiscal

ide_natop

text

[pt] Natureza da operacao

ide_dhemi

text

[pt] Data e hora de emissao

ide_dhsaient

text

[pt] Data e hora de saida/entrada

ide_tpnf

text

[pt] Tipo da nota fiscal (0=Entrada, 1=Saida)

ide_cuf

text

[pt] Codigo da UF do emitente

ide_cmunfg

text

[pt] Codigo do municipio de ocorrencia do fato gerador

ide_finnfe

text

[pt] Finalidade de emissao da NF-e

ide_iddest

text

[pt] Identificador de destino da operacao

ide_indfinal

text

[pt] Indica operacao com consumidor final

ide_indpres

text

[pt] Indicador de presenca do comprador

ide_mod

text

[pt] Modelo do documento fiscal

emit_cnpj

text

[pt] CNPJ do emitente

emit_xnome

text

[pt] Razao social do emitente

emit_xfant

text

[pt] Nome fantasia do emitente

emit_ie

text

[pt] Inscricao estadual do emitente

emit_crt

text

[pt] Codigo de regime tributario do emitente

emit_enderemit_xlgr

text

[pt] Logradouro do emitente

emit_enderemit_nro

text

[pt] Numero do endereco do emitente

emit_enderemit_xbairro

text

[pt] Bairro do emitente

emit_enderemit_xmun

text

[pt] Municipio do emitente

emit_enderemit_uf

text

[pt] UF do emitente

emit_enderemit_cep

text

[pt] CEP do emitente

dest_cpf

text

[pt] CPF do destinatario

dest_cnpj

text

[pt] CNPJ do destinatario

dest_xnome

text

[pt] Nome/Razao social do destinatario

dest_indiedest

text

[pt] Indicador de IE do destinatario

dest_enderdest_xlgr

text

[pt] Logradouro do destinatario

dest_enderdest_nro

text

[pt] Numero do endereco do destinatario

dest_enderdest_xbairro

text

[pt] Bairro do destinatario

dest_enderdest_xmun

text

[pt] Municipio do destinatario

dest_enderdest_uf

text

[pt] UF do destinatario

dest_enderdest_cep

text

[pt] CEP do destinatario

total_icmstot_vbc

float

[pt] Total - Base de calculo do ICMS

total_icmstot_vicms

float

[pt] Total - Valor do ICMS

total_icmstot_vprod

float

[pt] Total - Valor dos produtos

total_icmstot_vfrete

float

[pt] Total - Valor do frete

total_icmstot_vdesc

float

[pt] Total - Valor do desconto

total_icmstot_vnf

float

[pt] Total - Valor da NF-e

total_icmstot_vpis

float

[pt] Total - Valor do PIS

total_icmstot_vcofins

float

[pt] Total - Valor do COFINS

total_icmstot_voutro

float

[pt] Total - Outras despesas acessorias

total_icmstot_vst

float

[pt] Total - Valor do ICMS Substituicao Tributaria

total_icmstot_vicmsdeson

float

[pt] Total - Valor do ICMS desonerado

total_icmstot_vfcp

float

[pt] Total - Valor do Fundo de Combate a Pobreza (FCP)

total_icmstot_vbcst

float

[pt] Total - Base de calculo do ICMS-ST

total_icmstot_vfcpst

float

[pt] Total - Valor do FCP retido por ST

total_icmstot_vfcpstret

float

[pt] Total - Valor do FCP retido anteriormente por ST

total_icmstot_vicmsufdest

float

[pt] Total - Valor do ICMS relativo ao DIFAL para UF destino

total_icmstot_vseg

float

[pt] Total - Valor do seguro

total_icmstot_vii

float

[pt] Total - Valor do Imposto de Importacao

total_icmstot_vipi

float

[pt] Total - Valor do IPI

total_icmstot_vipidevol

float

[pt] Total - Valor do IPI devolvido

total_icmstot_qbcmonoret

float

[pt] Total - Quantidade tributada retida anteriormente (monofasico)

total_icmstot_vicmsmonoret

float

[pt] Total - Valor do ICMS retido anteriormente (monofasico)

total_ibscbstot_vbcibscbs

float

[pt] Total - Base de calculo do IBS/CBS (Reforma Tributaria)

total_ibscbstot_gibs_gibsuf_vdif

float

[pt] Total - Valor do diferimento IBS estadual

total_ibscbstot_gibs_gibsuf_vdevtrib

float

[pt] Total - Valor da devolucao tributaria IBS estadual

total_ibscbstot_gibs_gibsuf_vibsuf

float

[pt] Total - Valor do IBS estadual

total_ibscbstot_gibs_gibsmun_vdif

float

[pt] Total - Valor do diferimento IBS municipal

total_ibscbstot_gibs_gibsmun_vdevtrib

float

[pt] Total - Valor da devolucao tributaria IBS municipal

total_ibscbstot_gibs_gibsmun_vibsmun

float

[pt] Total - Valor do IBS municipal

total_ibscbstot_gibs_vibs

float

[pt] Total - Valor do IBS

total_ibscbstot_gibs_vcredpres

float

[pt] Total - Valor do credito presumido IBS

total_ibscbstot_gibs_vcredprescond

float

[pt] Total - Valor do credito presumido com condicao suspensiva IBS

total_ibscbstot_gcbs_vdif

float

[pt] Total - Valor do diferimento CBS

total_ibscbstot_gcbs_vdevtrib

float

[pt] Total - Valor da devolucao tributaria CBS

total_ibscbstot_gcbs_vcbs

float

[pt] Total - Valor da CBS

total_ibscbstot_gcbs_vcredpres

float

[pt] Total - Valor do credito presumido CBS

total_ibscbstot_gcbs_vcredprescond

float

[pt] Total - Valor do credito presumido com condicao suspensiva CBS

total_ibscbstot_gmono_vibsmono

float

[pt] Total - Valor do IBS monofasico

total_ibscbstot_gmono_vcbsmono

float

[pt] Total - Valor da CBS monofasica

total_ibscbstot_gmono_vibsmonoreten

float

[pt] Total - Valor do IBS monofasico retencao

total_ibscbstot_gmono_vcbsmonoreten

float

[pt] Total - Valor da CBS monofasica retencao

total_ibscbstot_gmono_vibsmonoret

float

[pt] Total - Valor do IBS monofasico retido anteriormente

total_ibscbstot_gmono_vcbsmonoret

float

[pt] Total - Valor da CBS monofasica retido anteriormente

transp_modfrete

text

[pt] Modalidade do frete

infadic_infcpl

text

[pt] Informacoes complementares de interesse do contribuinte

pag_detpag_tpag

text

[pt] Forma de pagamento

pag_detpag_vpag

float

[pt] Valor do pagamento

mercadolivre_orders_invoices_itens

Itens do XML da NF-e com detalhes de produto e impostos.

Campo Tipo

order_id

text

[pt] ID do pedido no Mercado Livre

nitem

text

[pt] Numero sequencial do item na NF-e

cprod

text

[pt] Codigo do produto

xprod

text

[pt] Descricao do produto

ncm

text

[pt] Codigo NCM do produto

cest

text

[pt] Codigo CEST do produto

cfop

text

[pt] Codigo CFOP da operacao

ucom

text

[pt] Unidade comercial

qcom

float

[pt] Quantidade comercial

vuncom

float

[pt] Valor unitario de comercializacao

vprod

float

[pt] Valor total bruto do produto

vdesc

float

[pt] Valor do desconto do item

vfrete

float

[pt] Valor do frete do item

indtot

text

[pt] Indicador de composicao do valor total da NF-e

nitemped

text

[pt] Numero do item do pedido de compra

icms_orig

text

[pt] Origem da mercadoria (ICMS)

icms_cst

text

[pt] Codigo de Situacao Tributaria do ICMS

icms_csosn

text

[pt] Codigo de Situacao da Operacao do Simples Nacional

icms_vbc

float

[pt] Base de calculo do ICMS do item

icms_picms

float

[pt] Aliquota do ICMS do item

icms_vicms

float

[pt] Valor do ICMS do item

pis_cst

text

[pt] Codigo de Situacao Tributaria do PIS

pis_vbc

float

[pt] Base de calculo do PIS do item

pis_ppis

float

[pt] Aliquota do PIS do item

pis_vpis

float

[pt] Valor do PIS do item

cofins_cst

text

[pt] Codigo de Situacao Tributaria do COFINS

cofins_vbc

float

[pt] Base de calculo do COFINS do item

cofins_pcofins

float

[pt] Aliquota do COFINS do item

cofins_vcofins

float

[pt] Valor do COFINS do item

icmsufdest_vbcufdest

float

[pt] Base de calculo do ICMS da UF destino (DIFAL)

icmsufdest_vbcfcpufdest

float

[pt] Base de calculo do FCP na UF destino

icmsufdest_pfcpufdest

float

[pt] Aliquota do FCP na UF destino

icmsufdest_picmsufdest

float

[pt] Aliquota interna da UF destino

icmsufdest_picmsinter

float

[pt] Aliquota interestadual das UFs envolvidas

icmsufdest_picmsinterpart

float

[pt] Percentual provisorio de partilha para UF destino

icmsufdest_vfcpufdest

float

[pt] Valor do FCP na UF destino

icmsufdest_vicmsufdest

float

[pt] Valor do ICMS para UF destino (DIFAL)

icmsufdest_vicmsufremet

float

[pt] Valor do ICMS para UF do remetente

ibscbs_cst

text

[pt] CST do IBS/CBS do item (Reforma Tributaria)

ibscbs_cclasstrib

text

[pt] Codigo de classificacao tributaria IBS/CBS do item

ibscbs_gibscbs_vbc

float

[pt] Base de calculo do IBS/CBS do item

ibscbs_gibscbs_gibsuf_pibsuf

float

[pt] Aliquota do IBS estadual do item

ibscbs_gibscbs_gibsuf_vibsuf

float

[pt] Valor do IBS estadual do item

ibscbs_gibscbs_gibsmun_pibsmun

float

[pt] Aliquota do IBS municipal do item

ibscbs_gibscbs_gibsmun_vibsmun

float

[pt] Valor do IBS municipal do item

ibscbs_gibscbs_vibs

float

[pt] Valor total do IBS do item

ibscbs_gibscbs_gcbs_pcbs

float

[pt] Aliquota da CBS do item

ibscbs_gibscbs_gcbs_vcbs

float

[pt] Valor da CBS do item

Notas

  • Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas

Perguntas frequentes

O que é necessário para integrar o Mercado Livre na Kondado?
Você precisa ter uma conta de vendedor ativa no Mercado Livre e acesso à plataforma Kondado. A integração é feita de forma simples através da página de conectores, com autenticação direta na sua conta do marketplace.
Quais dados do Mercado Livre posso extrair pela Kondado?
A pipeline do Mercado Livre permite extrair informações sobre vendas, pedidos, produtos, estoque e performance da sua loja, possibilitando centralizar todos os dados operacionais do seu e-commerce em um único lugar.
Para quais destinos posso enviar os dados do Mercado Livre?
Os dados podem ser enviados para diversos destinos suportados pela Kondado, incluindo data warehouses, planilhas e ferramentas de BI, conforme sua estratégia de análise.
A integração com o Mercado Livre é atualizada automaticamente?
Sim, após configurar a pipeline na Kondado, você define a frequência de sincronização e os dados são atualizados automaticamente, eliminando a necessidade de extrações manuais.
Posso usar dashboards prontos para analisar meus dados do Mercado Livre?
Sim, a Kondado oferece dashboards prontos que podem ser utilizados para visualizar métricas e KPIs do seu negócio no Mercado Livre de forma rápida e intuitiva.

Escrito por·Publicado em 2020-07-30·Atualizado em 2026-04-26