Campos de la respuesta

summary: cargos y bonificaciones que tuvo el vendedor. amount: total a pagar dentro del período de facturación consultado. Se forma con la suma de Cargos e Impuestos y resta de las Bonificaciones. credit_note: bonificaciones de cargos generados en otros períodos. Las notas de crédito se utilizan para pagar facturas adeudadas. tax: percepciones generadas por los distintos regímenes impositivos. bonuses: reintegro de comisiones por tus ventas y servicios que no se concretaron. Los verás discriminados según el tipo de bonificación.

• label: nombre de la bonificación
• amount: monto de dicha bonificación.

Las bonificaciones pueden ser por los siguientes conceptos: Cargos de venta y envíos: si una venta no se concreta debido a una devolución o por problemas con el correo (como pérdida o daño del producto), te reintegramos la comisión de venta y el cargo de envío. Cargos de publicidad: si por error contrataste el servicio o hubo algún problema con el cobro, te reintegramos la diferencia. Bonificaciones por Percepciones Impositivas: cuando se devuelve un cargo por venta también se incluye la devolución correspondiente de la percepción impositiva de IVA (ya sea por un articulo nuevo o uno usado) y de Ingresos Brutos. Lo mismo si hubo errores en la aplicación de una percepción. charges: diferentes cargos que puede tener el vendedor: comisiones por ventas, costo de publicaciones, percepciones impositivas, cobros de servicios. Por ejemplo: Mercado Envíos, Mercado Shops, etc. En caso de contratar campañas publicitarias, también aparecerán en los cargos.

Detalle de conciliación

El detalle de conciliación es un reporte donde podrás conciliar tus facturas de Mercado Libre y Mercado Envíos con los cargos de las ventas que realizaste.

Filtros opcionales disponibles

• date_sort
  asc: ordena los resultados de manera ascendente (valor por default)
  desc: ordena los resultados de manera descendente
  Ej: date_sort=asc

• date_from y date_to: Deben ser utilizados juntos y permite buscar dentro de un rango de fechas. También podés utilizar horas. Recuerda que el rango de fecha siempre debe estar dentro de las fechas de inicio y fin del período
  Formatos posibles: yyyy-MM-dd o yyyy-MM-ddThh:mm:ss.sss.
  Ej: Sólo fecha: date_from=2019-05-09&date_to=2019-05-15
  Fecha y hora: date_from=2019-05-09T00:00:00.000&date_to=2019-05-15T00:00:00.000.

• det_id: permite buscar un id de detalle específicoEj: det_id=8398490328

• det_type
  charge: trae solamente cargos
  bonus: trae solamente bonificaciones
  Ej: det_type=charge

• subtypes: permite filtrar por subtipos de detalles. Se pueden definir varios separados por coma.
  Ej: subtypes=CV,BV

• not_subtypes: permite excluir de la búsqueda los subtipos de detalles indicados. Se pueden definir varios separados por coma.
  Ej: not_subtypes=CXD,BXD

• type: permite buscar por el market del detalle.
  Ej: type=SHIPPING

• order_id: permite buscar por el id de la order.
  Ej: order_id=2294412230

• item_id: permite buscar por el id de la publicación.
  Ej: item_id=724159812

• document_id: permite buscar por el id de la factura.
  Ej: document_id=987046992

• offset: permite buscar desde un número de resultado en adelante
  Ej: offset=100 (devuelve a partir del resultado nro 100)

• limit: limita la cantidad de resultados. Por defecto el mínimo es 150 y el máximo valor permitido: 1000.
  Ej: limit=300 (devuelve hasta 300 resultados)

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/billing/period/$PERIODO/details&$FILTROS_OPCIONALES

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/443033562/billing/period/20190510/details

Respuesta:

{
    "paging": {
        "total": 2679,
        "offset": 0,
        "limit": 150
    },
    "results": [
        {
            "concept": "Cargo por Mercado Envíos",
            "id": 5782869395,
            "type": "SHIPPING",
            "subtype": "CFF",
            "date": {
                "billable": "2020-01-21T00:00:00.000-04:00",
                "created": "2020-01-21T00:00:00.000-04:00"
            },
            "prepaid": true,
            "amount": 68.4,
            "currency_id": "MXN",
            "site_id": "MLM",
            "document": {
                "id": 987046992,
                "date_of_expiration": "2020-02-25T00:00:00.000-04:00",
                "society": "ML"
            },
            "order": {
                "id": 2290642081
            },
            "detail_type": "CHARGE",
            "mp_op_id": 28226734621
        },
        {
            "concept": "Cargo por venta",
            "id": 5782859370,
            "type": "CORE",
            "subtype": "CV",
            "date": {
                "billable": "2020-01-21T00:00:00.000-04:00",
                "created": "2020-01-21T00:00:00.000-04:00"
            },
            "prepaid": true,
            "amount": 272.87,
            "currency_id": "MXN",
            "site_id": "MLM",
            "document": {
                "id": 987046992,
                "date_of_expiration": "2020-02-25T00:00:00.000-04:00",
                "society": "ML"
            },
            "order": {
                "id": 2290642081,
                "item_id": 725366950
            },
            "detail_type": "CHARGE",
            "mp_op_id": 5801583834
        },
        {
            "concept": "Cargo por Mercado Envíos",
            "id": 5782887632,
            "type": "SHIPPING",
            "subtype": "CFF",
            "date": {
                "billable": "2020-01-21T00:00:00.000-04:00",
                "created": "2020-01-21T00:00:00.000-04:00"
            },
            "prepaid": true,
            "amount": 50.8,
            "currency_id": "MXN",
            "site_id": "MLM",
            "document": {
                "id": 987046992,
                "date_of_expiration": "2020-02-25T00:00:00.000-04:00",
                "society": "ML"
            },
            "order": {
                "id": 2290649986
            },
            "detail_type": "CHARGE",
            "mp_op_id": 28226824168
        },
        {
            "concept": "Cargo por venta",
            "id": 5782887634,
            "type": "CORE",
            "subtype": "CV",
            "date": {
                "billable": "2020-01-21T00:00:00.000-04:00",
                "created": "2020-01-21T00:00:00.000-04:00"
            },
            "prepaid": true,
            "amount": 285.87,
            "currency_id": "MXN",
            "site_id": "MLM",
            "document": {
                "id": 987046992,
                "date_of_expiration": "2020-02-25T00:00:00.000-04:00",
                "society": "ML"
            },
            "order": {
                "id": 2290649986,
                "item_id": 620189246
            },
            "detail_type": "CHARGE",
            "mp_op_id": 5801916351
        },
        {
            "concept": "Cargo por Mercado Envíos",
            "id": 5782897217,
            "type": "SHIPPING",
            "subtype": "CFF",
            "date": {
                "billable": "2020-01-21T00:00:00.000-04:00",
                "created": "2020-01-21T00:00:00.000-04:00"
            },
            "prepaid": true,
            "amount": 68.4,
            "currency_id": "MXN",
            "site_id": "MLM",
            "document": {
                "id": 987046992,
                "date_of_expiration": "2020-02-25T00:00:00.000-04:00",
                "society": "ML"
            },
            "order": {
                "id": 2290651588
            },
            "detail_type": "CHARGE",
            "mp_op_id": 28226713276
        },
]

Campos de la respuesta

concept: son todas las ventas y operaciones que realizaste durante tu período de facturación.

type: es la unidad de negocio al que pertenece el cargo.

• core: son principalmente comisiones por venta, pero también contempla la compra de productos y la comisión por garantía. En Ecuador y Costa Rica, también es por publicar en el marketplace.
• mp: cargos y percepciones generadas por Mercado Pago.
• shipping: cargos relacionados a envíos.
• taxes: impuestos nacionales y provinciales de Mercado Libre (Argentina).
• eshop: cargos de eShop.
• mshops: cargos de Mercado Shops.
• mclics: cargos relacionados a publicidad.
• becommerce: es por el uso de la plataforma de beCommerce (Brasil).
• credits: cargos por los productos de Mercado Crédito (Argentina, Brasil y México).
• classified: son los cargos por los paquetes de publicaciones y por la publicación en categorías de clasificados de un usuario normal. También son los cargos por showroom.
• mango: cargos por el uso de la plataforma Mango (Argentina).

subtype: es el subtipo de concepto que te permitirá identificar mejor cada operación. Hay 1100 subtypes para distinguir cargos, subscripciones, paquetes, percepciones, bonificaciones, anulaciones, servicios, etc.

date: es la fecha de la transacción.

prepaid:

• true: el cargo es debitado automáticamente a través de Mercado Pago.
• false: el cargo NO es debitado automáticamente.

amount: monto del detalle.

currency_id: identificador de la moneda de acuerdo al site_id.

site_id: sitio donde se generó el detalle.

document:

• id: número de identificación del documento.
• date_of_expiration: es la fecha de vencimiento de dicho documento.
• society: hace referencia a la entidad que emite los documentos.

order:

• id: número de identificación de la orden vinculada al concepto.
• item_id: número de identificación del producto comprometido en la orden.

detail_type: indica si es cargo (charge) o bonificación (bonus).

mp_op_id: es el número de operación de Mercado Pago.