Campos do relatório - Liberações - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos

Glossário

Veja a descrição de cada campo presente no relatório na tabela abaixo.

Importante
Algumas definições não estão mais disponíveis ou foram alteradas. Utilize este glossário para saber os termos dos relatórios gerados a partir de janeiro. Para relatórios que cobrem datas anteriores, consulte este Glossário.
Nome da coluna do relatórioO que significa
Data da liberação (DATE)Data de liberação da transação. É o momento em que essa transação afeta o saldo disponível na conta do usuário.
ID da operação no Mercado Pago (SOURCE_ID)Identificador da transação nos sistemas do Mercado Pago. Exemplo: ID de um Pagamento.
ID da operação no Mercado Pago (EXTERNAL_REFERENCE)
Este dado permite identificar uma transação com base na sua origem. O código pode ser:
- ID da venda, por meio do pedido ou do envio (caso seja uma compra do carrinho)
- ID próprio, fornecido pelo vendedor, caso seja uma integração externa. Estes dados permitem relacionar transações (registros) entre o Mercado Pago e sistemas externos

É possível que esse campo fique vazio para alguns casos, como por exemplo, o pagamento de faturas ou uma transferência de dinheiro, entre outros.

Tipo de registro (RECORD_TYPE)
initial_available_balance → Dinheiro disponível do período anterior.

release → Dinheiro de uma cobrança que foi liberado.

total → Valor líquido total.

available_balance → saldo antes e depois de fazer um saque ou transferência, que explica o balanço da conta.

Descrição (DESCRIPTION)Possíveis valores que o campo pode assumir:
, judgment_bacen, fraud

Para release: Pagamento (payment), Transferência (withdrawal), Devolução de dinheiro (refund), Pagamento do imposto IBEX (tax_payment_ibex), Pagamento do Imposto de renda (tax_payment_iibb), Cancelamento do pagamento do imposto de renda (tax_payment_iibb_cancel, shipping), Devolução de dinheiro - Frete (shipping_cancel), tax_withdholding, Retenção de imposto (tax_withdholding_cancel), Contestação (chargeback), Pagamento de tarifa - Antecipação de dinheiro (fee_release_in_advance), Rendimentos positivos (asset_management_gain), Rendimentos negativos (asset_management_loss), Trava de recebível (trava_de_recibibles)

Para Saldo disponível available_balance: o campo mostra o prefixo "pre" e "pos" para indicar o saldo antes ou depois de um saque ou transferência, conforme o caso, seguido do tipo de transação - neste caso, uma transferência de dinheiro Saques (payout) seguida pelo número de identificação da transação ou o ID Source.

Prefixo + nome da transação + número da transação.

Exemplo: pre_payout_ID source

pre_payout_1948976543
pos_payout_1948976543

Definições a considerar:

Contestação chargeback: aparece quando uma contestação associada ao pagamento a que se refere é iniciada ou resolvida.

Contestação dispute: aparece quando uma mediação ou reclamação sobre o pagamento referido é iniciada ou resolvida. Pode ocorrer antes ou depois que o pagamento tenha sido liberado como dinheiro disponível e até mesmo retirado da conta.

Tarifa por devolução do frete shipping_return: aparece quando um pagamento por devolução agilizada é bloqueado ou desbloqueado.

Pagamento payment: pagamento liberado em qualquer um dos canais em que o cliente opera.

Devolução de dinheiro refund: devolução associada ao pagamento referido.

shipping_refund: valor da devolução feita referente ao frete ou ao imposto vinculado ao frente.

Pagamento do imposto de renda jurisdição tax_payment_iibb_cre_[jurisdição]: imposto sobre Receita Bruta - Mercado Crédito, em que substitui-se [jurisdição] pelo nome do estado onde o imposto é gerado.
Para reconciliar por operação, consulte os detalhes nos Relatórios de faturas no MyML.

Retenção do imposto IIBB - jurisdição tax_iibb_[jurisdição]: imposto sobre Receita Bruta, em que substitui-se [jurisdição] pelo nome do estado onde o imposto é gerado.
Para reconciliar por operação, consulte os detalhes nos Relatórios de faturas no MyML.

Imposto sobre valor agregado tax_iva: IVA - Regime Geral.

Imposto sobre valor agregado - Mercado Crédito tax_iva_cre: IVA - Regime Geral - Mercado Crédito.

Retenção de imposto cancelada tax_withdholding_cancel: o cancelamento da retenção tax_withdholding.

Imposto sobre créditos e débitos em pagamentos tax_withholding_payer: imposto sobre créditos e débitos em pagamentos.

Imposto sobre créditos e débitos em recebimentos tax_withholding_collector: imposto sobre créditos e débitos em cobranças.

Imposto sobre créditos e débitos em transferências/saques tax_withholding_payout: Imposto sobre créditos e débitos em saques.

Imposto sobre créditos e débitos nos envios tax_withholding_shipping: imposto sobre créditos e débitos em transferências.

Frete shipping: tarifa de envio para compras de carrinho que não está incluída em cada pagamento do carrinho.

Devolução de dinheiro - Frete shipping_cancel: cancelamento da tarifa de envio para compras de carrinho que não está incluída em cada pagamento do carrinho.

Contestação chargeback: contestação a favor ou contra uma operação.

Pagamento de tarifa - Antecipação de dinheiro fee-release_in_advance: tarifa de antecipação.

Rendimentos positivos asset_management_gain: rendimento positivo gerado pela variação do valor de quotas adquiridas no fundo comum de investimento.

Rendimentos negativos asset_management_loss: rendimento negativo gerado pela variação do valor de quotas adquiridas no fundo comum de investimento

Restrição restriction: ocorre quando uma restrição é aplicada por comportamento fraudulento.

Pagamento de crédito credit_payment: aparece quando a parcela de um crédito é debitada.

Saque de dinheiro payout: saque em dinheiro ou transferência por PIX de saldo disponível no Mercado Pago.

Reserva para bloqueio de dinheiro investido reserve_for_embargo_invested: bloqueio do seu dinheiro em rendimento. Este valor aparece quando há uma reserva de dinheiro em fundos de investimento.

Reserva para devolução do envio BPP reserve_for_bpp_shipping_return: reserva para devoluções.

Reserva para pagamento de dívida reserve_for_debt_payment: retido para pagamento de dívida.

Reserva para reembolso reserve_for_refund: retido para devoluções aprovadas.

Reserva devido a contestação em conta vinculada. reserve_for_cbk_cross_recovery: retido por contestação de conta vinculada.

Reserva para pagamento reserve_for_payment: gastos pendentes de confirmação.

judgment_bacen: ordem judicial do Banco Central. O dinheiro pode estar congelado na conta devido a algum litígio em andamento. Pode estar associado a bloqueios de valores.

revisão de segurança. fraud: revisão de segurança.

Trava de recebível trava_de_recibibles: trava de recebível.

digitalchange_transaction: Transação de Troco virtual. Entrada ou saída de dinheiro na conta. Se você for vendedor, corresponde ao troco que você deu virtualmente a um comprador referente a um pagamento feito em dinheiro. Se você for comprador, corresponde ao troco que recebeu por uma compra que pagou em dinheiro.
Valor líquido debitado (NET_DEBIT_AMOUNT)Creditado no valor disponível.
Valor líquido creditado (NET_CREDIT_AMOUNT)Debitado do valor disponível.
Valor recebido por compras com split de pagamento (SELLER_AMOUNT)Valor recebido por compras com split.
Valor bruto da operação (GROSS_AMOUNT)Valor bruto da transação.
Dados adicionais (METADATA)Dados extras, como por exemplo, o ID dos reembolsos parciais ou dados fornecidos pelo vendedor no caso de integrações externas. Quando "Fee discount" aparecer, entende-se como a redução na tarifa de venda pela participação em uma campanha comercial.
Tarifa do Mercado Pago ou do Mercado Livre (MP_FEE_AMOUNT)Pagamento da tarifa do Mercado Pago e/ou Mercado Livre.
Tarifa por oferecer parcelamento sem acréscimos. (FINANCING_FEE_AMOUNT)Custo por oferecer parcelamento quando o custo dessa taxa for assumido pelo seller.
Frete (SHIPPING_FEE_AMOUNT)Custo de envio.
Impostos cobrados por retenções de receita bruta (TAXES_AMOUNT)Impostos recebidos por retenção de receita bruta.
Cupom de desconto (COUPON_AMOUNT)Esta transação mostra o valor total do cupom de desconto que é oferecido aos seus compradores.
Parcelas (INSTALLMENTS)Número de parcelas em que a transação foi feita.
Meio de pagamento (PAYMENT METHOD)Meios de pagamentos disponíveis de acordo com o país com o qual você opera no Mercado Pago.
Detalhes dos impostos (TAX_DETAIL)
Descrição do imposto retido por transação nos impostos cobrados pelas retenções de receita bruta TAXES_AMOUNT.

Imposto descontado do valor bruto para telecomunicações (TAX_AMOUNT_TELCO)É o valor do imposto às empresas de telecomunicação descontado do valor bruto.
Data de aprovação (TRANSACTION_APPROVAL_DATE)Data de aprovação da transação.
ID do caixa (POS_ID)ID do caixa, se o pagamento é feito em comércio físico.
Nome do caixa (POS_NAME)Nome do caixa para o pagamento feito em um comércio físico.
ID do caixa, definido pelo usuário (EXTERNAL_POS_ID)ID da loja definido pelo usuário para o pagamento feito em um comércio físico.
ID do pedido (STORE_ID)ID da loja se o pagamento é feito em um comércio físico.
Nome da loja (STORE_NAME)Nome do caixa para o pagamento feito em um comércio físico.
ID do caixa, definido pelo usuário (EXTERNAL_STORE_ID)ID da loja definido pelo usuário para o pagamento feito em um comércio físico.
ID do pedido (ORDER_ID)Pedido de compra.
ID do envio (SHIPPING_ID)Identificador de envio.
Forma de envio (SHIPMENT_MODE)Modalidade de envio.
ID do pacote (PACK_ID)Identificador do pacote no carrinho.
Impostos desagregados (TAXES_DISAGGREGATED)Impostos detalhados no formato JSON.
Custo de oferecer desconto (EFFECTIVE_COUPON_AMOUNT)Esta transação mostra o valor que você arca do cupom de desconto oferecido aos seus compradores. Para que seja mais fácil diferenciá-la do (COUPON_AMOUNT) adicionamos os signos: "-" quando a transação for de uma venda e "+" quando for de uma devolução.
Número de série da maquininha (S/N) (POI_ID)ID da maquininha se o pagamento é feito em uma loja física.
Cartão do seu comprador (CARD_INITIAL_NUMBER)Corresponde aos primeiros dígitos do cartão de crédito ou débito utilizado para fazer a compra.
Etiquetas da transação (OPERATION_TAGS)São etiquetas para categorizar e/ou segmentar diferentes aspectos da transação, como por exemplo, os canais usados para fazer um pagamento. Eles são identificados como:

- WHATSAPP_PAY: Esta etiqueta indica que o pagamento foi feito via WhatsApp
- CASHOUT: Esta etiqueta indica que a transação corresponde a um Pix Saque
- EXTRACASHOUT: Esta etiqueta indica que a transação corresponde a um Pix Troco
- PIX: Esta etiqueta indica que a transação corresponde a um pagamento via Pix.
Código do produto (ITEM_ID)Identificador do produto vendido.
Total (BALANCE_AMOUNT)Esta coluna mostra o saldo restante de uma conta logo depois que uma transação que afeta o valor total for feita.
Conta de destino da retirada (PAYOUT_BANK_ACCOUNT_NUMBER)Aqui será exibido o número da conta para onde o dinheiro do Mercado Pago foi transferido.
Código do produto SKU (PRODUCT_SKU)Código SKU, com o qual você poderá identificar seus produtos vendidos.
Detalhe da venda (SALE_DETAIL)Esta coluna oferece informações detalhadas sobre os itens vendidos em cada entrega, facilitando a conciliação e o controle de suas vendas.
(*) Estas informações só podem ser usadas para fins de reconciliação e serão tratadas de acordo com as leis de proteção de dados pessoais aplicáveis. Elas estarão disponíveis quando pagamentos via código QR e transferências forem recebidos ou quando uma doação for recebida por uma ONG.