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
- Itens
- Itens sale prices
- Itens: preços
- Itens: variações
- Pedidos
- Pedidos: avaliações
- Pedidos: compradores
- Pedidos: contexto
- Pedidos: envios
- Pedidos: itens
- Pedidos: pagamento
- Pedidos: vendedores
- Reclamações
Gráfico de relacionamento
Clique para ampliar
Itens
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
Campo | Tipo | |
---|---|---|
text |
[pt] Id do item |
|
text |
||
text |
||
float |
||
text |
||
float |
||
text |
||
text |
Itens: preços
Campo | Tipo | |
---|---|---|
text |
[pt] Id do produto |
|
float |
||
text |
||
timestamp |
||
timestamp |
||
text |
||
float |
||
timestamp |
||
text |
||
text |
Itens: preços de venda
Campo | Tipo | |
---|---|---|
text |
[pt] Id do produto |
|
float |
||
text |
||
text |
||
text |
||
float |
||
timestamp |
||
text |
Itens: variações
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 |
Pedidos
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 |
Pedidos: avaliações
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 |
Pedidos: compradores
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 |
Pedidos: contexto
Campo | Tipo | |
---|---|---|
text |
[pt-br] identificador único da ordem |
|
timestamp |
||
text |
||
text |
||
text |
||
text |
||
text |
Pedidos: envios
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[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 | |
---|---|---|
text |
[pt-br] Indentificador unico da order |
|
timestamp |
||
text |
||
text |
Pedidos: itens
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 |
Pedidos: pagamento
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 |
Pedidos: vendedores
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 |
Reclamações
Objeto principal
Campo | Tipo | |
---|---|---|
float |
[en] ID da reclamação. |
|
timestamp |
[en] data de criação da reclamação. |
|
boolean |
||
timestamp |
[en] data da última atualização da reclamação. |
|
text |
[en] ID de outra reclamação da qual depende. |
|
text |
||
boolean |
||
text |
||
text |
||
timestamp |
||
text |
||
text |
[en] Identificador do recurso sobre o qual a reclamação é criada. |
|
text |
[en] ID do recurso sobre o qual a reclamação é criada e depende do resource. |
|
text |
[en] ID do site onde a reclamação se desenvolve. |
|
text |
[en] Etapa da reclamação. |
|
text |
[en] Status da reclamação. |
|
text |
[en] Tipo de reclamação. |
mercadolivre_reclamacoes_players
Campo | Tipo | |
---|---|---|
float |
[en] ID da reclamação. |
|
text |
[en] papel dentro da reclamação. |
|
text |
[en] papel desempenhado pela pessoa na operação que está sendo reclamada. |
|
float |
[en] ID do usuario que desempenha o papel |
mercadolivre_reclamacoes_players_actions
Campo | Tipo | |
---|---|---|
float |
[en] ID da reclamação. |
|
float |
[en] ID do usuario que desempenha o papel |
|
text |
[en] possível ação a ser realizada pelo player |
|
boolean |
[pt-br] Indica se ação é obrigatória |
|
timestamp |
[pt-br] Data limite para execução da ação |