Mercado Livre

Adicionando o conector

Requisitos

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

Instruções

Adicionar o conector do Mercado Livre na Kondado é muito simples, já que todo o processo é feito de forma automatizada. Vamos lá?

1) Faça login na sua conta do mercado livre como ADMINISTRADOR

2) Faça login na plataforma da Kondado, vá para a página de adicionar conectores e localize o conector do 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) Depois, informe a sua senha do Mercado Livre

6) No próximo passo, você poderá autorizar que a Kondado conecte-se à sua conta clicando em “Permitir” logo abaixo

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

7) 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)

8) Agora, basta dar um nome ao seu conector e clicar em “SALVAR”

Agora está tudo pronto para você criar suas integrações do Mercado Livre com o seu Data Warehouse ou Data Lake!

Integrações

Índice

Gráfico de relacionamento

Clique para ampliar

Itens

Objeto principal

Campo Tipo

id

text

[pt] Id do item

accepts_mercadopago

boolean

automatic_relist

boolean

available_quantity

float

buying_mode

text

catalog_listing

boolean

catalog_product_id

text

category_id

text

channels

text

condition

text

currency_id

text

date_created

timestamp

differential_pricing

text

domain_id

text

end_time

timestamp

expiration_time

timestamp

geolocation_latitude

float

geolocation_longitude

float

health

float

initial_quantity

float

international_delivery_mode

text

inventory_id

text

last_updated

timestamp

listing_source

text

listing_type_id

text

official_store_id

text

parent_item_id

text

permalink

text

secure_thumbnail

text

seller_address_address_line

text

seller_address_city

text

seller_address_comment

text

seller_address_country

text

seller_address_id

float

seller_address_latitude

float

seller_address_longitude

float

seller_address_search_location

text

seller_address_state

text

seller_address_zip_code

float

seller_contact

text

seller_custom_field

text

seller_id

float

shipping_dimensions

text

shipping_free_methods

text

shipping_free_shipping

boolean

shipping_local_pick_up

boolean

shipping_logistic_type

text

shipping_mode

text

shipping_store_pick_up

boolean

shipping_tags

text

site_id

text

sold_quantity

float

start_time

timestamp

status

text

stop_time

timestamp

subtitle

text

tags

text

thumbnail

text

thumbnail_id

text

title

text

video_id

text

warranty

text

mercadolivre_itens_attributes

Campo Tipo

id

text

[pt] Id do item

attributes_attribute_group_id

text

attributes_attribute_group_name

text

attributes_id

text

attributes_name

text

attributes_value_id

float

attributes_value_name

text

attributes_value_struct_number

float

attributes_value_struct

text

attributes_value_type

text

mercadolivre_itens_sale_terms

Campo Tipo

id

text

[pt] Id do item

sale_terms_id

text

sale_terms_name

text

sale_terms_value_id

float

sale_terms_value_name

text

sale_terms_value_struct_number

float

sale_terms_value_struct_unit

text

sale_terms_value_type

text

Itens: preços

Campo Tipo

item_id

text

[pt] Id do produto

    Itens > > id

amount

float

conditions_context_restrictions

text

conditions_end_time

timestamp

conditions_start_time

timestamp

currency_id

text

item_price_id

float

last_updated

timestamp

regular_amount

text

type

text

Itens: preços de venda

Campo Tipo

item_id

text

[pt] Id do produto

    Itens > > id

amount

float

promotion_id

text

promotion_type

text

currency_id

text

price_id

float

reference_date

timestamp

regular_amount

text

Itens: variações

Objeto principal

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

available_quantity

float

inventory_id

text

seller_custom_field

text

sold_quantity

float

mercadolivre_itens_variations_attribute_combinations

Campo Tipo

item_id

text

[pt] Id do item

item_variation_id

float

[pt] Id da variação de produto

attribute_combinations_id

text

attribute_combinations_name

text

attribute_combinations_value_id

float

attribute_combinations_value_name

text

attribute_combinations_value_struct_number

float

attribute_combinations_value_struct_unit

text

attribute_combinations_value_type

text

Pedidos

Campo Tipo

id

text

[pt] identificador único da ordem

date_closed

timestamp

[pt] data de confirmação da ordem. Quando uma ordem muda pela primeira vez de status é definida como: confirmed / paid e descontada do estoque do item

last_updated

timestamp

[pt] data da última modificação da order

coupon__amount

float

coupon__id

text

currency_id

text

[pt] ID de moeda

cancel_detail__code

text

[pt] código da causa do cancelamento

cancel_detail__application_id

text

[pt] ID da aplicação que solicita o cancelamento

cancel_detail__description

text

[pt] descrição da causa do cancelamento

cancel_detail__requested_by

text

[pt] quem solicita o cancelamento (buyer, seller, Mercado Livre)

cancel_detail__date

timestamp

[pt] data do cancelamento

cancel_detail__group

text

[pt] agrupamento lógico de cancelamento (mediations, fiscal, buyer, fraud, item, shipment, delivery, seller, internal).

manufacturing_ending_date

text

seller__nickname

text

[pt] nickname do seller

seller__id

text

[pt] id do seller

order_request__return

text

order_request__change

text

status

text

[pt] status da ordem. Os status da ordem são: *confirmed*: Status inicial de uma ordem; ainda sem ter sido paga; *payment_required*: O pagamento da ordem deve ter sido confirmado para exibir as informações do usuário; *payment_in_process*: Há um pagamento relacionado à ordem, mais ainda não foi creditado; *partially_paid*: A ordem tem um pagamento associado creditado, porém, insuficiente; *paid*: A ordem tem um pagamento associado creditado; *partially_refunded*: A ordem tem devoluções paciais de seus pagamentos; *pending_cancel*: Quando a Ordem foi cancelada mas temos dificultdade para devolver o pagamento; *cancelled*: Por alguma razão, a ordem não foi completada (Uma ordem pode ser cancelada pelos seguintes motivos: (1) Requeria aprovação do pagamento para descontar do estoque, mas, no tempo de processo de aprovação, o item foi pausado/finalizado por falta de estoque, portanto, o pagamento é retornado ao comprador. (2) Requeria pagamento, mas, após certo tempo, não foi paga, por isso é automaticamente cancelada. (3) Após uma transação ter sido efetuada, o vendedor é proibido no site por alguma razão. (3) Se por alguma razão o vendedor qualificar a operação como não concretizada, a ordem assume o status = confirmed. Caso exista um pagamento aprovado, este será automaticamente devolvido. Lembre que uma ordem não concretizada pelo vendedor será visualizada como Cancelada por front e por api terá status = confirmed); *invalid*: A ordem foi invalidada por vir de um comprador malicioso.

date_last_updated

timestamp

[pt] data da última modificação da order

tags

text

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

pack_id

text

pickup_id

text

status_detail__code

text

[pt] detalhe do status – código do status

status_detail__description

text

[pt] detalhe do status – descrição do status

buyer__nickname

text

[pt] nickname do buyer

buyer__id

text

[pt] ID do buyer

total_amount

float

[pt] valor total da ordem

expiration_date

timestamp

[pt] prazo limite para o usuário qualificar; após essa data, o feedback se torna visível, os pagamentos são emitidos (caso houver) e os encargos são criados.

taxes__currency_id

text

[pt] id da moeda dos impostos. Nos casos em que taxes.currency_id é diferente de items.currency_id é necessário realizar a conversão

taxes__amount

float

[pt] valor com a soma dos impostos a serem pagos pelo pedido

fulfilled

boolean

paid_amount

float

date_created

text

[pt] data de criação da ordem

total_amount_with_shipping

float

[pt] total_amount_with_shipping = total_amount + taxes.amount + lead_time.cost

Pedidos: avaliações

Campo Tipo

order_id

float

[pt-br] identificador único da ordem

    Pedidos > > id

feedback_id

float

purchase_app_id

float

purchase_date_created

timestamp

purchase_extended_feedback

text

purchase_from_id

float

purchase_from_nickname

text

purchase_from_points

float

purchase_from_status

text

purchase_fulfilled

boolean

[pt-br] Indica se a operação foi ou não foi concretizada. Valores possíveis: True / False.

purchase_has_seller_refunded_money

text

purchase_item_currency_id

text

purchase_item_price

float

purchase_item_title

text

purchase_item_id

float

purchase_message

text

[pt-br] Cadeia com menos de 160 caracteres.

purchase_modified

boolean

purchase_rating

text

[pt-br] Qualificação da operação. Valores possíveis: ‘negative’, ‘neutral’ ou ‘positive’ (somente em caso de ‘fulfilled’: ‘true’)

purchase_reason

text

[pt-br] MotivoValores possíveis: ver tabela Valores aceitos…

purchase_reply

text

purchase_role

text

purchase_site_id

text

purchase_status

text

purchase_to_id

float

purchase_to_nickname

text

purchase_to_points

float

purchase_to_status

text

purchase_visibility_date

text

sale

text

Pedidos: compradores

Campo Tipo

order_id

text

[pt] identificador único da ordem

    Pedidos > > id

buyer_first_name

text

[pt] nome do buyer

buyer_last_name

text

[pt] sobrenome do buyer

buyer_email

text

[pt] email (ML) do buyer

buyer__nickname

text

[pt] nickname do buyer

buyer__id

text

[pt] ID do buyer

Pedidos: contexto

Campo Tipo

order_id

text

[pt-br] identificador único da ordem

    Pedidos > > id

date_last_updated

timestamp

context_application

text

context_channel

text

context_flows

text

context_product_id

text

context_site

text

Pedidos: envios

Objeto principal

Campo Tipo

order_id

text

[pt-br] Indentificador unico da order

    Pedidos > > id

application_id

text

base_cost

float

carrier_info

text

comments

text

cost_components_compensation

float

cost_components_gap_discount

float

cost_components_loyal_discount

float

cost_components_ratio

float

cost_components_special_discount

float

created_by

text

date_created

timestamp

date_first_printed

timestamp

id

float

[pt-br] Indentificador unico do envio

last_updated

timestamp

logistic_type

text

market_place

text

mode

text

order_cost

float

receiver_address_address_line

text

receiver_address_agency

text

receiver_address_city_name

text

receiver_address_city_id

text

receiver_address_comment

text

receiver_address_country_name

text

receiver_address_country_id

text

receiver_address_delivery_preference

text

receiver_address_geolocation_last_updated

timestamp

receiver_address_geolocation_source

text

receiver_address_geolocation_type

text

receiver_address_id

float

receiver_address_intersection

text

receiver_address_latitude

float

receiver_address_location_id

text

receiver_address_longitude

float

receiver_address_municipality_name

text

receiver_address_municipality_id

text

receiver_address_neighborhood_name

text

receiver_address_neighborhood_id

text

receiver_address_receiver_name

text

receiver_address_receiver_phone

text

receiver_address_scoring

text

receiver_address_state_name

text

receiver_address_state_id

text

receiver_address_street_name

text

receiver_address_street_number

text

receiver_address_types

text

receiver_address_zip_code

text

receiver_id

float

return_details

text

return_tracking_number

text

sender_address_address_line

text

sender_address_agency

text

sender_address_city_name

text

sender_address_city_id

text

sender_address_comment

text

sender_address_country_name

text

sender_address_country_id

text

sender_address_geolocation_last_updated

timestamp

sender_address_geolocation_source

text

sender_address_geolocation_type

text

sender_address_id

float

sender_address_intersection

text

sender_address_latitude

float

sender_address_location_id

text

sender_address_longitude

float

sender_address_municipality_name

text

sender_address_municipality_id

text

sender_address_neighborhood_name

text

sender_address_scoring

text

sender_address_state_name

text

sender_address_state_id

text

sender_address_street_name

text

sender_address_street_number

text

sender_address_types

text

sender_address_zip_code

text

sender_id

float

service_id

float

shipping_option_buffering_date

text

shipping_option_cost

float

shipping_option_currency_id

text

shipping_option_delivery_promise

text

shipping_option_delivery_type

text

shipping_option_estimated_delivery_extended_date

timestamp

shipping_option_estimated_delivery_extended_offset

float

shipping_option_estimated_delivery_final_date

timestamp

shipping_option_estimated_delivery_final_offset

float

shipping_option_estimated_delivery_limit_date

timestamp

shipping_option_estimated_delivery_limit_offset

float

shipping_option_estimated_delivery_date

timestamp

shipping_option_estimated_delivery_handling

float

shipping_option_estimated_delivery_offset_date

timestamp

shipping_option_estimated_delivery_offset_shipping

float

shipping_option_estimated_delivery_pay_before

timestamp

shipping_option_estimated_delivery_schedule

text

shipping_option_estimated_delivery_shipping

float

shipping_option_estimated_delivery_time_frame_from

text

shipping_option_estimated_delivery_time_frame_to

text

shipping_option_estimated_delivery_time_type

text

shipping_option_estimated_delivery_time_unit

text

shipping_option_estimated_handling_limit_date

timestamp

shipping_option_estimated_schedule_limit_date

timestamp

shipping_option_id

float

shipping_option_list_cost

float

shipping_option_name

text

shipping_option_processing_time

text

shipping_option_shipping_method_id

float

sibling_date_created

text

sibling_description

text

sibling_last_updated

text

sibling_reason

text

sibling_sibling_id

text

sibling_source

text

site_id

text

status

text

status_history_date_cancelled

timestamp

status_history_date_delivered

timestamp

status_history_date_first_visit

timestamp

status_history_date_handling

timestamp

status_history_date_not_delivered

timestamp

status_history_date_ready_to_ship

timestamp

status_history_date_returned

timestamp

status_history_date_shipped

timestamp

substatus

text

tags

text

tracking_method

text

tracking_number

text

type

text

mercadolivre_orders_shipments__substatus_history

Campo Tipo

order_id

text

[pt-br] Indentificador unico da order

    Pedidos > > id

substatus_history_date

timestamp

substatus_history_status

text

substatus_history_substatus

text

Pedidos: itens

Objeto principal

Campo Tipo

order_id

text

[pt] Identificador único da ordem

    Pedidos > > id

base_currency_id

text

base_exchange_rate

text

bundle

text

currency_id

text

element_id

text

full_unit_price

float

item_category_id

text

item_condition

text

item_global_price

float

item_id

text

[pt] Identificar do item

    Itens > > id

item_net_weight

float

item_seller_custom_field

text

item_seller_sku

text

item_title

text

[pt] Título do produto

item_variation_id

float

item_warranty

text

listing_type_id

text

manufacturing_days

float

picked_quantity

float

quantity

float

requested_quantity_measure

text

requested_quantity_value

float

sale_fee

float

unit_price

float

mercadolivre_orders_items__item_variation_attributes

Campo Tipo

order_id

text

item_id

text

    Pedidos: itens > > item_id

item_variation_attributes_id

text

item_variation_attributes_name

text

item_variation_attributes_value_id

text

item_variation_attributes_value_name

text

Pedidos: pagamento

Campo Tipo

order_id

text

[pt] Identificador único da ordem

    Pedidos > > id

id

float

[pt] Identificador único de pagamento [ref: mercadopago]

activation_uri

text

atm_transfer_reference_company_id

text

atm_transfer_reference_transaction_id

float

authorization_code

text

[pt] Código de autorização de transação [ref: mercadopago]

available_actions

text

card_id

float

collector_id

float

[pt] Identificador da conta coletora do Mercado Pago [ref: mercadopago]

coupon_amount

float

[pt] coupon_amount [ref: mercadopago]

coupon_id

text

currency_id

text

[pt] Identificador da moeda utilizada no pagamento: ARS: Peso argentino; BRL: Real brasileiro; CLP: Peso chileno; MXN: Peso mexicano; COP: Peso colombiano; PEN: Sol peruano; UYU: Peso uruguaio. [ref: mercadopago]

date_approved

timestamp

[pt] Data de aprovação do pagamento. Um pagamento pode ser gerado em um estado intermediário e depois aprovado, portanto, a data de criação nem sempre coincidirá com a Data de Aprovação [ref: mercadopago]

date_created

timestamp

[pt] Data de criação do pagamento [ref: mercadopago]

date_last_modified

timestamp

deferred_period

text

[pt] Período de diferimento de pagamento [ref: mercadopago]

installment_amount

float

[pt] Valor da taxa de financiamento escolhida [ref: mercadopago]

installments

float

[pt] Número de parcelas selecionado [ref: mercadopago]

issuer_id

float

[pt] Identificador do emissor do meio de pagamento [ref: mercadopago]

operation_type

text

[pt] Tipo de pagamento: regular_payment: Typification by default of a purchase being paid using Mercado Pago; money_transfer: Funds transfer between two users.; recurring_payment: Automatic recurring payment due to an active user subscription.; account_fund: Money income in the user's account.; payment_addition: Adição de dinheiro a um pagamento existente, feito por meio de uma conta do Mercado Pago; cellphone_recharge: Recharge of a user's cellphone account; pos_payment: Pagamento feito através de um Ponto de Venda. [ref: mercadopago]

overpaid_amount

float

[pt] Valor pago a mais [ref: mercadopago]

payer_id

float

payment_method_id

text

[pt] Id do meio de pagamento. Indica o ID do meio de pagamento selecionado para efetuar o pagamento [ref: mercadopago]

payment_type

text

[pt] Tipo do meio de pagamento escolhido: account_money: Dinheiro na conta do Mercado Pago; ticket: Printed ticket; bank_transfer: Transferência bancária; atm: Payment by ATM; credit_card: Payment by credit card; debit_card: Payment by debit card; prepaid_card: Payment by prepaid card. [ref: mercadopago]

reason

text

shipping_cost

float

site_id

text

status

text

[pt] Estado do pagamento: pending: O usuário ainda não concluiu o processo de pagamento; approved: O pagamento foi aprovado e creditado; authorized: O pagamento foi autorizado, mas ainda não foi capturado; in_process: O pagamento está sendo analisado; in_mediation: Os usuários iniciaram uma disputa; rejected: O pagamento foi recusado. O usuário pode tentar novamente o pagamento; cancelled: O pagamento foi cancelado por uma das partes ou porque o prazo de pagamento expirou; refunded: O pagamento foi devolvido ao usuário; charged_back: Foi feito um estorno no cartão de crédito do comprador. [ref: mercadopago]

status_code

text

status_detail

text

[pt] Detalhe em que resultou a Coleção. Alguns valores possíveis são: accredited: pagamento creditado; pending_contingency: o pagamento está sendo processado; pending_review_manual: o pagamento está sob revisão para determinar sua aprovação ou rejeição; cc_rejected_bad_filled_date: data de validade incorreta; cc_rejected_bad_filled_other: dados incorretos do cartão; cc_rejected_bad_filled_security_code: CVV errado; cc_rejected_blacklist: o cartão está em uma black list para roubo/reclamações/fraude; cc_rejected_call_for_authorize: o meio de pagamento requer autorização prévia do valor da operação; cc_rejected_card_disabled: o cartão está inativo; cc_rejected_duplicated_payment: transacción duplicada; cc_rejected_high_risk: rechazo por Prevención de Fraude; cc_rejected_insufficient_amount: quantidade insuficiente; cc_rejected_invalid_installments: número de parcelas inválidas; cc_rejected_max_attempts: excedeu o número máximo de tentativas; cc_rejected_other_reason: erro genérico [ref: mercadopago]

taxes_amount

float

[pt] Corresponde aos valores dos impostos calculados para o pagamento [ref: mercadopago]

total_paid_amount

float

[pt] Valor total cobrado ao pagador [ref: mercadopago]

transaction_amount

float

[pt] Valor da transação [ref: mercadopago]

transaction_amount_refunded

float

[pt] Valor reembolsado da transação [ref: mercadopago]

transaction_order_id

text

Pedidos: vendedores

Campo Tipo

order_id

text

[pt] identificador único da ordem

    Pedidos > > id

seller__nickname

text

[pt] nickname do seller

seller__id

text

[pt] id do seller

seller_first_name

text

seller_last_name

text

seller__alternative_phone__area_code

text

seller__alternative_phone__extension

text

seller__alternative_phone__number

text

seller__email

text

seller__phone__area_code

text

seller__phone__extension

text

seller__phone__number

text

seller__phone__verified

boolean

Reclamações

Objeto principal

Campo Tipo

id

float

[en] ID da reclamação.

date_created

timestamp

[en] data de criação da reclamação.

fulfilled

boolean

last_updated

timestamp

[en] data da última atualização da reclamação.

parent_id

text

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

reason_id

text

resolution_applied_coverage

boolean

resolution_benefited

text

resolution_closed_by

text

resolution_date_created

timestamp

resolution_reason

text

resource

text

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

resource_id

text

[en] ID do recurso sobre o qual a reclamação é criada e depende do resource.

    Pedidos > > id

site_id

text

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

stage

text

[en] Etapa da reclamação.

status

text

[en] Status da reclamação.

type

text

[en] Tipo de reclamação.

mercadolivre_reclamacoes_players

Campo Tipo

reclamacao_id

float

[en] ID da reclamação.

players_role

text

[en] papel dentro da reclamação.

players_type

text

[en] papel desempenhado pela pessoa na operação que está sendo reclamada.

players_user_id

float

[en] ID do usuario que desempenha o papel

mercadolivre_reclamacoes_players_actions

Campo Tipo

reclamacao_id

float

[en] ID da reclamação.

players_user_id

float

[en] ID do usuario que desempenha o papel

    Reclamações > players > players_user_id

player_action

text

[en] possível ação a ser realizada pelo player

player_action_mandatory

boolean

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

player_action_due_date

timestamp

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