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 | |
---|---|---|
text |
[pt] Id do item |
|
boolean |
||
boolean |
||
float |
||
text |
||
boolean |
||
text |
||
text |
||
text |
||
text |
||
text |
||
timestamp |
||
text |
||
text |
||
timestamp |
||
timestamp |
||
float |
||
float |
||
float |
||
float |
||
text |
||
text |
||
timestamp |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
float |
||
float |
||
float |
||
text |
||
text |
||
float |
||
text |
||
text |
||
float |
||
text |
||
text |
||
boolean |
||
boolean |
||
text |
||
text |
||
boolean |
||
text |
||
text |
||
float |
||
timestamp |
||
text |
||
timestamp |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
mercadolivre_itens_attributes
Campo | Tipo | |
---|---|---|
text |
[pt] Id do item |
|
text |
||
text |
||
text |
||
text |
||
float |
||
text |
||
float |
||
text |
||
text |
mercadolivre_itens_sale_terms
Items: prices
Campo | Tipo | |
---|---|---|
text |
[pt] Id do produto |
|
float |
||
text |
||
timestamp |
||
timestamp |
||
text |
||
float |
||
timestamp |
||
text |
||
text |
Items: variations
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[pt] Id do item |
|
float |
[pt] Id da variação de produto |
|
text |
||
float |
||
text |
||
text |
||
float |
mercadolivre_itens_variations_attribute_combinations
Campo | Tipo | |
---|---|---|
text |
[pt] Id do item |
|
float |
[pt] Id da variação de produto |
|
text |
||
text |
||
float |
||
text |
||
float |
||
text |
||
text |
Orders
Campo | Tipo | |
---|---|---|
text |
[pt] identificador único da ordem |
|
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 |
|
timestamp |
[pt] data da última modificação da order |
|
float |
||
text |
||
text |
[pt] ID de moeda |
|
text |
[pt] código da causa do cancelamento |
|
text |
[pt] ID da aplicação que solicita o cancelamento |
|
text |
[pt] descrição da causa do cancelamento |
|
text |
[pt] quem solicita o cancelamento (buyer, seller, Mercado Livre) |
|
timestamp |
[pt] data do cancelamento |
|
text |
[pt] agrupamento lógico de cancelamento (mediations, fiscal, buyer, fraud, item, shipment, delivery, seller, internal). |
|
text |
||
text |
[pt] nickname do seller |
|
text |
[pt] id do seller |
|
text |
||
text |
||
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. |
|
timestamp |
[pt] data da última modificação da order |
|
text |
[pt] lista das tags selecionadas pelo vendedor, como entregue, pago. [KONDADO: Este campo é retornado concatenado] |
|
text |
||
text |
||
text |
[pt] detalhe do status - código do status |
|
text |
[pt] detalhe do status - descrição do status |
|
text |
[pt] nickname do buyer |
|
text |
[pt] ID do buyer |
|
float |
[pt] valor total da ordem |
|
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. |
|
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 |
|
float |
[pt] valor com a soma dos impostos a serem pagos pelo pedido |
|
boolean |
||
float |
||
text |
[pt] data de criação da ordem |
|
float |
[pt] total_amount_with_shipping = total_amount + taxes.amount + lead_time.cost |
Orders: buyers
Campo | Tipo | |
---|---|---|
text |
[pt] identificador único da ordem |
|
text |
[pt] nome do buyer |
|
text |
[pt] sobrenome do buyer |
|
text |
[pt] email (ML) do buyer |
|
text |
[pt] nickname do buyer |
|
text |
[pt] ID do buyer |
Orders: context
Campo | Tipo | |
---|---|---|
float |
[pt-br] identificador único da ordem |
|
timestamp |
||
text |
||
text |
||
text |
||
text |
||
text |
Orders: feedbacks
Campo | Tipo | |
---|---|---|
float |
[pt-br] identificador único da ordem |
|
float |
||
float |
||
timestamp |
||
text |
||
float |
||
text |
||
float |
||
text |
||
boolean |
[pt-br] Indica se a operação foi ou não foi concretizada. Valores possíveis: True / False. |
|
text |
||
text |
||
float |
||
text |
||
float |
||
text |
[pt-br] Cadeia com menos de 160 caracteres. |
|
boolean |
||
text |
[pt-br] Qualificação da operação. Valores possíveis: ‘negative’, ‘neutral’ ou ‘positive’ (somente em caso de ‘fulfilled’: ‘true’) |
|
text |
[pt-br] MotivoValores possíveis: ver tabela Valores aceitos... |
|
text |
||
text |
||
text |
||
text |
||
float |
||
text |
||
float |
||
text |
||
text |
||
text |
Orders: items
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único da ordem |
|
text |
||
text |
||
text |
||
text |
||
text |
||
float |
||
text |
||
text |
||
float |
||
text |
[pt] Identificar do item |
|
float |
||
text |
||
text |
||
text |
[pt] Título do produto |
|
float |
||
text |
||
text |
||
float |
||
float |
||
float |
||
text |
||
float |
||
float |
||
float |
mercadolivre_orders_items__item_variation_attributes
Campo | Tipo | |
---|---|---|
text |
||
text |
||
text |
||
text |
||
text |
||
text |
Orders: payments
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único da ordem |
|
float |
[pt] Identificador único de pagamento [ref: mercadopago] |
|
text |
||
text |
||
float |
||
text |
[pt] Código de autorização de transação [ref: mercadopago] |
|
text |
||
float |
||
float |
[pt] Identificador da conta coletora do Mercado Pago [ref: mercadopago] |
|
float |
[pt] coupon_amount [ref: mercadopago] |
|
text |
||
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] |
|
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] |
|
timestamp |
[pt] Data de criação do pagamento [ref: mercadopago] |
|
timestamp |
||
text |
[pt] Período de diferimento de pagamento [ref: mercadopago] |
|
float |
[pt] Valor da taxa de financiamento escolhida [ref: mercadopago] |
|
float |
[pt] Número de parcelas selecionado [ref: mercadopago] |
|
float |
[pt] Identificador do emissor do meio de pagamento [ref: mercadopago] |
|
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] |
|
float |
[pt] Valor pago a mais [ref: mercadopago] |
|
float |
||
text |
[pt] Id do meio de pagamento. Indica o ID do meio de pagamento selecionado para efetuar o pagamento [ref: mercadopago] |
|
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] |
|
text |
||
float |
||
text |
||
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] |
|
text |
||
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] |
|
float |
[pt] Corresponde aos valores dos impostos calculados para o pagamento [ref: mercadopago] |
|
float |
[pt] Valor total cobrado ao pagador [ref: mercadopago] |
|
float |
[pt] Valor da transação [ref: mercadopago] |
|
float |
[pt] Valor reembolsado da transação [ref: mercadopago] |
|
text |
Orders: sellers
Campo | Tipo | |
---|---|---|
text |
[pt] identificador único da ordem |
|
text |
[pt] nickname do seller |
|
text |
[pt] id do seller |
|
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
boolean |
Orders: shipments
Main object
Campo | Tipo | |
---|---|---|
float |
[pt-br] Indentificador unico da order |
|
text |
||
float |
||
text |
||
text |
||
float |
||
float |
||
float |
||
float |
||
float |
||
text |
||
timestamp |
||
timestamp |
||
float |
[pt-br] Indentificador unico do envio |
|
timestamp |
||
text |
||
text |
||
text |
||
float |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
timestamp |
||
text |
||
text |
||
float |
||
text |
||
float |
||
text |
||
float |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
float |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
timestamp |
||
text |
||
text |
||
float |
||
text |
||
float |
||
text |
||
float |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
float |
||
float |
||
text |
||
float |
||
text |
||
text |
||
text |
||
timestamp |
||
float |
||
timestamp |
||
float |
||
timestamp |
||
float |
||
timestamp |
||
float |
||
timestamp |
||
float |
||
timestamp |
||
text |
||
float |
||
text |
||
text |
||
text |
||
text |
||
timestamp |
||
timestamp |
||
float |
||
float |
||
text |
||
text |
||
float |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
timestamp |
||
timestamp |
||
timestamp |
||
timestamp |
||
timestamp |
||
timestamp |
||
timestamp |
||
timestamp |
||
text |
||
text |
||
text |
||
text |
||
text |
mercadolivre_orders_shipments__substatus_history
Campo | Tipo | |
---|---|---|
float |
[pt-br] Indentificador unico da order |
|
timestamp |
||
text |
||
text |