Mercado Livre (Mercado Libre)

 

 

Adding the data source

Requirements

Have a seller account

Use an ADMINISTRATOR login of the seller account

Instructions

Adding the Mercado Livre data source to Kondado is very simple, as the entire process is done automatically. Let's go?

1) Login to your Mercado Livre account as ADMINISTRATOR

2) Login to Kondado, go to the add data sources page and locate the Mercado Livre data source;

3) On the data source page, select the country of your account and click on “AUTHORIZE"

4) You will be directed to log in to the Mercado Livre portal. Enter the email of an ADMINISTRATOR user

5) Then, enter your Mercado Livre password

6) In the next step, you will be able to authorize Kondado to connect to your account by clicking on “Allow” just below

Regarding the warning “This application is not certified…” it is just a formality by Mercado Livre to force developers to create a listing in their “App Store”, however don't worry because this will not change the functioning of their pipeline with Kondado

7) Right after clicking on “Allow”, you will be directed back to the Kondado platform, with your account already authorized (note that the “User” field of the data source was filled in automatically)

8) Now, just name your data source and click “SAVE”

Now everything is ready for you to create your Mercado Livre pipelines with your Data Warehouse or Data Lake!

 

Pipelines

Summary

Relationship Chart

Items

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

Items: prices

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

Items: sales prices

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

Items: variations

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

Orders

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

Orders: buyers

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

Orders: context

Campo Tipo

order_id

float

[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

Orders: feedbacks

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

Orders: items

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

Orders: payments

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

Orders: sellers

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

Orders: shipments

Main object

Campo Tipo

order_id

float

[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

float

[pt-br] Indentificador unico da order

    Pedidos > > id

substatus_history_date

timestamp

substatus_history_status

text

substatus_history_substatus

text