Campos del reporte - Dinero disponible - Mercado Pago Developers

Glosario

Importante
A partir del 1 de agosto no podrás crear nuevos reportes Dinero retirado. Para seguir llevando el control de todos los retiros y movimientos de tu dinero disponible usa el reporte Liberaciones.

Lo sabemos, algunos términos son técnicos y puede que no estés familiarizado con todos ellos. ¡Usa este glosario para no perderte!

Nombre de la columna del reporteQué significa
DATEFecha de liberación, bloqueo o desbloqueo, según corresponda.
SOURCE_IDID de operación en Mercado Pago (por ejemplo, el pago de una venta).
EXTERNAL_REFERENCE
ID que ayuda a identificar el origen de la operación. Por ejemplo, puede ser la venta a través del ID de la orden o el envío (si es una compra de carrito) o del ID propio provisto por el vendedor en caso de una integración externa. Tené en cuenta que es posible que este campo esté vacío para algunos casos como el pago de facturas o un envío de dinero, entre otros.

RECORD_TYPE
initial_available_balance: Dinero disponible del período anterior.

block: Dinero bloqueado por un reclamo o contracargo.

unblock: Dinero liberado porque se resolvió un reclamo o contracargo.

release: Dinero de un cobro que fue liberado.

fullblock: Dinero bloqueado por restricción

subtotal: Suma de los montos de cada record type.

total: Total. Es el dinero que tienes disponible en tu cuenta. Se calcula como la diferencia entre el monto acreditado total y el monto debitado total.

DESCRIPTION
Posibles valores que puede tomar el campo:
  • Para block o unblock: chargeback, dispute, shipping_return, credit_payment, reserve_for_payment, reserve_for_debt_payment, reserve_for_refund, reserve_for_bpp_shipping_return, reserve_for_cbk_cross_recovery, reserve_for_embargo_invested, restriction
  • Para release: payment, withdrawal, refund, tax_payment_ibcf, tax_payment_ibcf_cancel, tax_payment_ibex, tax_payment_iibb, tax_payment_iibb_cre, tax_iibb, tax_iva, tax_iva_cre, tax_payment_iibb_cancel, shipping, shipping_cancel, tax_withdholding, tax_withdholding_cancel, mediation,mediation_cancel, chargeback, fee_release_in_advance, asset_management_gain, asset_management_loss
  • Para fullblock: restriction.
  • Para subtotal: block, unblock o release.
Definiciones a tener en cuenta:

chargeback: aparece cuando se inicia o resuelve un contracargo asociado al pago al que hace referencia.

dispute: aparece cuando se inicia o resuelve una mediación o reclamo sobre el pago al que hace referencia. Puede ocurrir antes o después de que el pago se haya liberado como dinero disponible e incluso retirado de la cuenta.

shipping_return: aparece cuando se bloquea o desbloquea un pago realizado por devolución express.

credit_payment: aparece cuando se cobra la cuota de un préstamo otorgado.

payment: pago que se libera en alguno de los canales en los que opera el cliente.

withdrawal: retiro que se ejecuta sobre el dinero disponible.

refund: devolución asociada al pago al que hace referencia.

shipping: comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

shipping_cancel: cancelación de la comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

mediation: resolución de una mediación a favor del comprador que termina restando del dinero disponible del vendedor.

mediation_cancel: cancelación de la mediación resuelta a favor del comprador.

fee-release_in_advance: comisión por adelanto.

tax_withdholding: el cobro de retenciones que no se pudieron ejecutar transaccionales al pago asociado. En Argentina son únicamente retenciones de Ingresos Brutos (las percepciones se debitan como otra operación). En Uruguay son retenciones de IVA. En Colombia son retenciones de IVA, ICA y Fuente según aplique el caso.

tax_withdholding_cancel: la cancelación de la retención tax_withdholding.

payout: extracción en efectivo de dinero disponible en Mercado Pago.

reserve_for_embargo_invested: embargo de tu dinero invertido. Este valor aparece cuando hay una reserva de dinero en fondos de inversión.

reserve_for_bpp_shipping_return: reserva para devoluciones.

reserve_for_debt_payment: retenido para cobro de deuda.

reserve_for_refund: retenido para devoluciones.

reserve_for_cbk_cross_recovery: retenido por contracargo de cuenta vinculada.

reserve_for_payment: consumos pendientes de confirmación.
NET_CREDIT_AMOUNTAcreditado al monto disponible.
NET_DEBIT_AMOUNTDebitado al monto disponible.
SELLER_AMOUNTMonto recibido por compras por split.
GROSS_AMOUNTMonto de la operación bruto.
METADATADatos extras como por ejemplo el ID de las devoluciones parciales o datos provistos por el vendedor en caso de tener una integración externa.
MP_FEE_AMOUNTPago Comisión de Mercado Pago y/o Mercado Libre. Incluye IVA.
FINANCING_FEE_AMOUNTCosto por ofrecer cuotas sin interés.
SHIPPING_FEE_AMOUNTCosto de envío.
TAXES_AMOUNTImpuestos cobrados por retenciones de IVA, ICA y Fuente según aplique el caso.
COUPON_AMOUNTMonto del cupón de descuento. Solo se descuenta del monto bruto (GROSS_AMOUNT) si está provisto por el vendedor.
INSTALLMENTSCantidad de cuotas en las que se realizó la operación.
PAYMENT METHODConsulta los medios de pago disponibles según el país con el que operes en Mercado Pago.
TAX_DETAIL
Descripción del impuesto retenido por operación en el TAXES_AMOUNT. Puede tomar el valor de:
fuente
iva
ica


TAX_AMOUNT_TELCOEs el valor del impuesto a las empresas de telecomunicaciones que se descuenta del valor bruto.
TRANSACTION_APPROVAL_DATEFecha de aprobación de la operación.
POS_IDID de caja si el pago se realiza a través de un comercio físico.
POS_NAMENombre de caja para el pago realizado a través de un comercio físico.
EXTERNAL_POS_IDID de caja definido por el usuario para el pago realizado a través de un comercio físico.
STORE_IDID de sucursal si el pago se realiza a través de un comercio físico.
STORE_NAMENombre de sucursal para el pago realizado a través de un comercio físico.
EXTERNAL_STORE_IDID de sucursal definido por el usuario para el pago realizado a través de un comercio físico.
ORDER_IDOrden de compra.
SHIPPING_IDIdentificador de envío.
SHIPMENT_MODEModalidad de envío.
PACK_IDIdentificador del paquete en el carrito.
TAXES_DISAGGREGATEDImpuestos desagregados en formato JSON.
EFFECTIVE_COUPON_AMOUNTCosto por ofrecer descuento.
POI_IDID del lector si el pago se realiza a través de un comercio físico.

Próximos pasos