Glossário
Veja a descrição de cada campo presente no relatório na tabela abaixo.
| Nome da coluna do relatório | O que significa | Tipo de dado (longitude máxima) |
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. | DateTime (yyyy-MM-dd'T'HH:mm:ssZ) |
ID da operação no Mercado Pago (SOURCE_ID) | Identificador da transação nos sistemas do Mercado Pago. Exemplo: ID de um Pagamento. Este campo pode conter valores alfanuméricos. | String (100) |
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. | String (255) |
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. | String (30) |
Descrição (DESCRIPTION) | Possíveis valores que o campo pode assumir: 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 - 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. 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 investimentoRestriçã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. 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. | String (50) |
Valor líquido creditado (NET_CREDIT_AMOUNT) | Creditado no valor disponível. | Numeric (17,2) |
Valor líquido debitado (NET_DEBIT_AMOUNT) | Debitado do valor disponível. | Numeric (17,2) |
Valor recebido por compras com split de pagamento (SELLER_AMOUNT) | Valor recebido por compras com split. | Numeric (17,2) |
Valor bruto da operação (GROSS_AMOUNT) | Valor total bruto (antes das deduções) que o vendedor recebe pela transação. | Numeric, decimal (17,2) |
Dados adicionais (METADATA) | Dados extras, como por exemplo, o ID dos reembolsos parciais ou dados fornecidos pelo vendedor no caso de integrações externas. | String (JSON) |
Tarifa do Mercado Pago ou do Mercado Livre MP_FEE_AMOUNT | Pagamento da tarifa do Mercado Pago e/ou Mercado Livre. Inclui IVA. | Numeric (17,2) |
Tarifa por oferecer parcelamento sem acréscimos. (FINANCING_FEE_AMOUNT) | Custo por oferecer parcelamento quando o custo dessa taxa for assumido pelo seller. | Numeric (17,2) |
Frete (SHIPPING_FEE_AMOUNT) | Custo de envio. | Numeric (17,2) |
Impostos cobrados por retenções de receita bruta (TAXES_AMOUNT) | Impostos cobrados. | Numeric (17,2) |
Cupom de desconto (COUPON_AMOUNT) | Esta transação mostra o valor total do cupom de desconto que é oferecido aos seus compradores. | Numeric (17,2) |
Parcelas (INSTALLMENTS) | Número de parcelas em que a transação foi feita. | Numeric (2) |
Meio de pagamento (PAYMENT_METHOD) | Meios de pagamentos disponíveis de acordo com o país com o qual você opera no Mercado Pago. | String (200) |
Tipo de meio de pagamento (PAYMENT_METHOD_TYPE) | Tipo de meio de pagamento disponível de acordo com o país com o qual você opera no Mercado Pago. | String (200) |
Detalhes dos impostos (TAX_DETAIL) | Descrição do imposto retido por transação nos impostos cobrados pelas retenções de receita bruta TAXES_AMOUNT. Também é possible visualizar a restituição geral quando a operação for a restituição deste imposto. | String (50) |
Imposto descontado do valor bruto para telecomunicações (TAX_AMOUNT_TELCO) | É o valor do imposto às empresas de telecomunicação descontado do valor bruto. | Numeric (17,2) |
Data de aprovação (TRANSACTION_APPROVAL_DATE) | Data de aprovação da transação. | DateTime (yyyy-MM-dd'T'HH:mm:ssZ) |
ID do caixa (POS_ID) | ID do caixa, se o pagamento é feito em comércio físico. | String (50) |
Nome do caixa (POS_NAME) | Nome do caixa para o pagamento feito em um comércio físico. | String (200) |
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. | String (100) |
ID do pedido (STORE_ID) | ID da loja se o pagamento é feito em um comércio físico. | String (50) |
Nome da loja (STORE_NAME) | Nome do caixa para o pagamento feito em um comércio físico. | String (200) |
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. | String (100) |
ID do pedido (ORDER_ID) | Pedido de compra. | Numeric (19) |
ID do envio (SHIPPING_ID) | Identificador de envio. | Numeric (19) |
Forma de envio (SHIPMENT_MODE) | Modalidade de envio. | String (10) |
ID do pacote (PACK_ID) | Identificador do pacote no carrinho. | Numeric (19) |
Impostos desagregados (TAXES_DISAGGREGATED) | Impostos detalhados no formato JSON. | String (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. | Numeric (17,2) |
Número de série da maquininha (POI_ID) | ID da maquininha se o pagamento é feito em uma loja física. | String (100) |
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. | Numeric (8) |
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 QR: Esta etiqueta indica que o pagamento foi feito via código QR. MARKETPLACE: Esta etiqueta indica que o pagamento foi feito via no Mercado Livre. | String (JSON) |
Código do produto (ITEM_ID) | Identificador do produto vendido. | String (200) |
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. | Numeric (17,2) |
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. | String (200) |
Código do produto SKU (PRODUCT_SKU) | Código SKU, com o qual você poderá identificar seus produtos vendidos. | String (200) |
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. | String (500) |
Moeda (CURRENCY) | Moeda na qual a transação foi realizada. | String alfanumérico |
Bandeira (FRANCHISE) | Nome da bandeira do cartão utilizado. | String alfanumérico |
Últimos 4 dígitos (LAST_FOUR_DIGITS) | Últimos 4 dígitos do cartão utilizado. | Numeric, integer |
ID da solicitação (ORDER_MP) | Identificador da order no Mercado Pago. | String alfanumérico |
ID de tentativa de transação (TRANSACTION_INTENT_ID) | Identificador da intenção de transação. | String alfanumérico |
ID da compra (PURCHASE_ID) | Identificador único atribuído a uma compra ou transação específica. | String alfanumérico |
Liberado (IS_RELEASED) | Indicador booleano (true / false) que indica se um produto foi liberado para envio. true significa que o produto está pronto para ser enviado, false significa o contrário. | Boolean |
Imposto descontado do valor bruto (TAX_AMOUNT_TELCO) | Monto do imposto aplicado a uma transação relacionada com serviços de telecomunicações. | Numeric, decimal |
ID de associação de envios (SHIPPING_ORDER_ID) | Identificador único interno para rastrear cada ordem de envio dentro da empresa. Permite gerenciar os detalhes de cada solicitação. Não é o número de rastreamento da transportadora. | String alfanumérico |
Nome do emissor (ISSUER_NAME) | Nome da entidade financeira emissora do cartão ou meio de pagamento utilizado na transação. | String alfanumérico |
(*) 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.