Reportes de facturación

Los siguientes recursos de API te permitirán conocer los resúmenes de facturación de tus ventas en Mercado Libre.

Contenidos

→Obtención de período
→Campos del recurso
→Resumen de facturación
→Campos del recurso
→Detalle de conciliación
→Campos del recurso


Obtención de período

Importante: el período de facturación puede variar según el usuario.
Para conocer el período con el cual realizar la consulta a los recursos de Resumen y Detalle de conciliación, deberás realizar un GET al siguiente recurso:
Llamada:

curl -X GET https://api.mercadolibre.com/users/$USER_ID/billing/period?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET  https://api.mercadolibre.com/users/443033562/billing/period?access_token=$ACCESS_TOKEN

Respuesta:

{
    "period": [
        {
            "paid": "N",
            "date_from": "2020-01-24T00:00:00.000-04:00",
            "date_to": "2020-01-28T00:00:00.000-04:00",
            "expiration_date": "2020-02-28T00:00:00.000-04:00",
            "period": "20200228",
            "url_invoice": "https://myaccount.mercadolibre.com.uy/billing/v2/api/billing/user/443033562/invoices/32976ad7-0bd0-asd123e-967c?type=pdf"
        },
        {
            "paid": "Y",
            "date_from": "2019-12-24T00:00:00.000-04:00",
            "date_to": "2020-01-23T00:00:00.000-04:00",
            "expiration_date": "2020-01-28T00:00:00.000-04:00",
            "period": "20200128",
            "url_invoice": "https://myaccount.mercadolibre.com.uy/billing/v2/api/billing/user/443033562/invoices/32976ad7-0bd0-asd123-hasd45?type=pdf"
        },
        {
            "paid": "Y",
            "date_from": "2019-12-02T00:00:00.000-04:00",
            "date_to": "2020-01-01T00:00:00.000-04:00",
            "expiration_date": "2020-01-07T00:00:00.000-04:00",
            "period": "20200107",
            "url_invoice": ""
        },
        {
            "paid": "Y",
            "date_from": "2019-11-24T00:00:00.000-04:00",
            "date_to": "2019-12-23T00:00:00.000-04:00",
            "expiration_date": "2019-12-30T00:00:00.000-04:00",
            "period": "20191230",
            "url_invoice": ""
        },
        {
            "paid": "Y",
            "date_from": "2018-07-02T00:00:00.000-04:00",
            "date_to": "2019-12-01T00:00:00.000-04:00",
            "expiration_date": "2019-12-09T00:00:00.000-04:00",
            "period": "20191209",
            "url_invoice": ""
        },
        {
            "paid": "Y",
            "date_from": "2019-11-02T00:00:00.000-04:00",
            "date_to": "2019-11-23T00:00:00.000-04:00",
            "expiration_date": "2019-11-28T00:00:00.000-04:00",
            "period": "20191128",
            "url_invoice": ""
        },
        {
            "paid": "Y",
            "date_from": "2019-10-02T00:00:00.000-04:00",
            "date_to": "2019-11-01T00:00:00.000-04:00",
            "expiration_date": "2019-11-07T00:00:00.000-04:00",
            "period": "20191107",
            "url_invoice": ""
        }
    ]
}


Campos del recurso

paid: campo que indica si se pagó la factura.
date_from: es la fecha de inicio de dicho documento.
date_to: es la fecha de último día.
expiration_date: es la fecha de vencimiento de dicho documento.
period: número de periodo a utilizar en los siguientes recursos.
url_invoice: URL de la factura legal generada.

Importante:
Este último campo está disponible para Uruguay y Perú. Próximamente, durante este año 2020, lo habilitaremos para los demás países.
Nota:
El campo paid puede no aparecer para todas las cuentas. Este recurso devuelve como máximo los últimos 12 períodos.


Resumen de facturación

Para conocer un resumen de los cargos y compensaciones que tuviste como vendedor dentro de un período de tiempo, deberás hacer un GET al recurso Summary.

Llamada:

curl -X GET  https://api.mercadolibre.com/users/$USER_ID/billing/period/$PERIODO/summary?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET  https://api.mercadolibre.com/users/443033562/billing/period/20190510/summary?access_token=$ACCESS_TOKEN

Respuesta:

{
  "user": {
    "nickname": "TESTING123"
  },
  "period": {
    "date_from": "2019-04-05T00:00:00.000-04:00",
    "date_to": "2019-05-04T00:00:00.000-04:00",
    "date_of_expiration": "2019-05-10T00:00:00.000-04:00"
  },
  "summary": {
    "amount": 4141767.47,
    "credit_note": 43111.7,
    "tax": 492483.66,
    "bonuses": [
      {
        "label": "Bonificación del cargo por venta",
        "amount": 71007.49
      },
    ],
    "charges": [
      {
        "label": "Cargo por venta",
        "amount": 2784300.73
      },
      {
        "label": "Cargo por Mercado Envíos",
        "amount": 605717.77
      },
       {
        "label": "Percepción IIBB Com. Electrónico",
        "amount": 15529.9
      }
     ]
  }
}


Campos del recurso

Summary: vemos los Cargos y Bonificaciones que tuvo el vendedor.

amount: es el 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: son las bonificaciones de cargos generados en otros períodos. Las notas de crédito se utilizan para pagar facturas adeudadas.

tax: son las percepciones generadas por los distintos regímenes impositivos.

bonuses: es el 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 contratas, por error, 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 del IVA, ya sea por un articulo nuevo o usado, y de Ingresos Brutos. Lo mismo, si hubo errores en la aplicación de una percepción.

charges: representan los diferentes cargos que puede tener el vendedor, como comisiones por ventas, costo de publicaciones, cobros de servicios por ejemplo, Mercado Envíos, Mercado Shops, etc. En caso de contratar campañas publicitarias, también aparecen aquí.


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. Para eso deberás hacer un GET al recurso Details.
Llamada:

curl -X GET https://api.mercadolibre.com/users/$USER_ID/billing/period/$PERIODO/details?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/users/443033562/billing/period/20190510/details?access_token=$ACCESS_TOKEN

Respuesta:

{
  "paging": {
    "total": 6409,
    "offset": 0,
    "limit": 150
  },
  "results": [
    {
      "concept": "Cargo por Mercado Envíos",
      "id": 27920673513,
      "type": "shipment",
      "subtype": "CXD",
      "date": {
        "billable": "2019-04-05T01:35:41.000-04:00",
        "created": "2019-04-05T01:35:41.000-04:00"
      },
      "prepaid": true,
      "amount": 187.49,
      "currency_id": "ARS",
      "site_id": "MLA",
      "document": {
        "id": 806818557,
        "date_of_expiration": "2019-05-10T00:00:00.000-04:00",
        "society": "MCA"
      },
      "order": {
        "id": 1980848182,
        "item_id": null
      }
    },
    {
      "concept": "Cargo por venta",
      "id": 4652334681,
      "type": "mp_operation",
      "subtype": "CV",
      "date": {
        "billable": "2019-04-05T01:35:45.000-04:00",
        "created": "2019-04-05T01:35:45.000-04:00"
      },
      "prepaid": true,
      "amount": 259.9,
      "currency_id": "ARS",
      "site_id": "MLA",
      "document": {
        "id": 806818565,
        "date_of_expiration": "2019-05-10T00:00:00.000-04:00",
        "society": "ML"
      },
      "order": {
        "id": 1980848182,
        "item_id": 762856563
      }
    }
   }
  ]
}


Campos del recurso

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

type:

  • shipment: cuando el cargo es por Mercado Envíos.
  • mp_operation: cuando es el cargo por una venta.
  • tax: cuando es un cargo impositivo.

subtype: es el subtipo de concepto que te permitirá identificar mejor cada operación. Hay 730 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.

currency_id: identificador de la moneda de acuerdo al site_id.

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.

date_of_expiration: es la fecha de vencimiento de dicho documento.

society: hace referencia a la entidad que emite los documentos.

date:

  • billable: es la fecha de facturación.
  • created: es la fecha de creado el documento.