Developers

Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.

Última actualización 25/04/2024

Conciliaciones

Obtén el detalle para conciliar las facturas y los cargos de ventas para un período en particular, el grupo de facturación (Mercado Libre o Mercado Pago) y el tipo de documento (Factura o Nota de Crédito) según la unidad de negocio que elijas: Mercado Libre, Mercado Pago, Mercado Envíos Flex, Fulfillment e Insurtech.
Puedes filtrar con los parámetros: group (ML, MP) y document_type (BILL, CREDIT_NOTE).

Filtros opcionales

date_sort: permite ordenar la búsqueda.
asc: ordena los resultados de manera ascendente (valor por default)
desc: ordena los resultados de manera descendente
Ej: date_sort=asc

sort_by: permite seleccionar por qué campo ordenar. Valores posibles: DATE

detail_typepermite buscar por tipos de detalles.
charge: trae solamente cargos
bonus: trae solamente bonificaciones
Ej: det_type=charge

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

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

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

order_ids: permite buscar por uno o varios id de la order. Disponible para ML.
Ej: order_ids=2294412230

item_ids: permite buscar por uno o más id de la publicación.
Ej: item_ids=724159812

document_ids: permite buscar por uno o más id de la factura.
Ej: document_ids=987046992

detail_ids: permite buscar por uno o más id del detalle.
Ej: detail_ids=724159812

offset: permite buscar desde un número de resultado en adelante. El valor mínimo permitido es 0 y el valor máximo permitido es 10000. Por defecto el valor es 0. Te recomendamos utilizar más filtros y acotar los resultados.

limit: limita la cantidad de resultados. Por defecto el mínimo es 1 y el máximo valor permitido: 1000.

Mercado Libre

Verás los cargos facturados, información de la venta, descuentos, envíos y la publicación.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/periods/key/$KEY/group/ML/details

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/periods/key/2021-06-01/group/ML/details?document_type=BILL&limit=1

Respuesta:

{
  "offset": 0,
  "limit": 150,
  "total": 1,
  "results": [
      {
          "charge_info": {
              "legal_document_number": "0001A00123456",
              "legal_document_status": "PROCESSED",
              "legal_document_status_description": "Procesado",
              "creation_date_time": "2021-05-13T08:08:24",
              "detail_id": 123456789,
              "detail_amount": 342.49,
              "transaction_detail": "Cargo por Mercado Envíos",
              "debited_from_operation": "YES",
              "debited_from_operation_description": "Si",
              "status": null,
              "status_description": null,
              "charge_bonified_id": null,
              "detail_type": "CHARGE",
              "detail_sub_type": "CXD",
              "concept_type": "SHIPPING"
          },
          "discount_info": {
              "charge_amount_without_discount": 684.99,
              "discount_amount": 342.5,
              "discount_reason": "Descuento general"
          },
          "sales_info": [
              {
                  "order_id": 12345,
                  "operation_id": null,
                  "sale_date_time": "2021-05-13T08:05:10",
                  "sales_channel": "Mercado Libre",
                  "payer_nickname": "ABCD",
                  "state_name": "Neuquén",
                  "transaction_amount": 2499
              },
           ],
          "shipping_info": {
              "shipping_id": "123456789",
              "pack_id": "200000123456789",
              "receiver_shipping_cost": 0
          },
          "items_info": [
              {
                  "item_id": "MLA987654321",
                  "item_title": "Fabrica Magdalenas Cup Cake Maker Atma Cm8910e",
                  "item_type": "gold_special",
                  "item_type_description": "Clásica",
"item_category": "Electrodomésticos y Aires Ac. > Pequeños Electrodomésticos > Para Cocina > Máquinas para Postres > Máquinas de Cupcakes",
                  "inventory_id": null,
                  "item_amount": 1,
                  "item_price": 2499,
                  "order_id": 1234
              }
          ],
          "document_info": {
              "document_id": 1615633359
          },
          "marketplace_info": {
              "marketplace": "SHIPPING"
          },
          "currency_info": {
              "currency_id": "ARS"
          }
      }
  ],
  errors:[]
}

Campos de respuesta

charge_info: información del cargo.

legal_document_number: número del documento.
legal_document_status: estado de generación del documento. Valores posibles: PROCESSING, PROCESSED.
legal_document_status_description: descripción internacionalizada del estado del documento legal_document_status.
creation_date_time: fecha de creación del cargo.
detail_id: identificador del cargo.
transaction_detail: detalle del cargo.
debited_from_operation: indica si está descontado de la operación. Valores posibles: YES, NO, INAPPLICABLE.
debited_from_operation_description: descripción internacionalizada del campo debited_from_operation.
status: estado del cargo. Valores posibles: BONUS_ON_CREDIT_NOTE, BONUS_PART_ON_CREDIT_NOTE, BONUS_ON_BILL, BONUS_PART_ON_BILL, BONUS_ON, BONUS_PART_ON.
status_description: descripción internacionalizada de status.
charge_bonified_id: identificador del cargo que bonifica.
detail_amount: monto del cargo.
detail_type: tipo de detalle.
detail_sub_type: subtipos de detalles.

discount_info: información sobre descuentos.

charge_amount_without_discount: valor del cargo sin descuento.
discount_amount: valor del descuento.
discount_reason: motivo del descuento.

sales_info: información de las ventas.

order_id: identificador de la venta.
operation_id: identificador del pago.
sale_date_time: fecha y hora de venta.
sales_channel: canal de venta.
payer_nickname: cliente.
state_name: provincia.
transaction_amount: monto total de la venta.

shipping_info: información del envío.

shipping_id: identificador del envío.
pack_id: identificador del paquete.
receiver_shipping_cost: envío a cargo del cliente.

items_info: información sobre las publicaciones.

item_id: identificador de la publicación.
item_title: título de la publicación.
item_type: tipo de publicación.
item_category: categoría de publicación.
inventory_id: código de Mercado Libre.
item_amount: cantidad de items vendidos.
item_price: precio unitario del ítem.
order_id: orden a la que pertenece el item.

document_info: información del documento.

document_id: número Id de documentos.

marketplace_info: información del marketplace.

marketplace: nombre del marketplace.

currency_info: información de la moneda de acuerdo al site_id.

currency_id: identificador de la moneda de acuerdo al site_id.

Mercado Pago

Verás el detalle de cargos facturados con información complementaria sobre la operación de Mercado Pago, como los movimientos, medios de pago, payer, sucursal, punto de venta, entre otros.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/periods/key/$KEY/group/MP/details

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/periods/key/2021-06-01/group/MP/details?document_type=BILL&limit=1

Respuesta:

{
  "offset": 0,
  "limit": 1,
  "total": 9,
  "results": [
      {
          "charge_info": {
              "legal_document_number": null,
              "legal_document_status": "PROCESSING",
              "legal_document_status_description": "En proceso",
              "concept_id": "12345678",
              "transaction_detail": "Cargo de MercadoPago",
              "creation_date_time": "2021-06-01T17:45:39",
              "detail_amount": 13.8,
      "detail_type": "CHARGE",
      "detail_sub_type": "CCMP"
              
          },
          "operation_info": {
              "operation_type": "BUY",
              "operation_type_description": "Pago",
              "reference_id": 12345678,
              "sales_channel": "Point",
              "store_id": 2222222,
              "store_name": "Store",
              "external_reference": "Venta presencial",
              "payer_nickname": "TEST",
              "transaction_amount": 340
          },
          "perception_info": {
              "aliquot": null,
              "taxable_amount": null
          },
         "document_info": {
      "document_id": 8888899999,
     },
    "market_type_info": {
      "marketplace": "MP"
          },

          "currency_info": {
              "currency_id": "MXN"
          }
      }
  ]
}

Campos de respuesta

charge_info: información del cargo.

legal_document_number: número del documento.
detail_id: identificador del cargo.
movement_id: número de movimiento.
transaction_detail: detalle.
creation_date_time: fecha del cargo.
detail_amount: monto del cargo.
detail_type: tipo de detalle.
detail_sub_type: subtipos de detalles.

operation_info: información de la operación sobre la que aplica.

operation_type: tipo de operación. Valores posibles BUY, TAX .
operation_type_description: descripción internacionalizada del campo operation.
reference_id: número de operación relacionada.
sales_channel: tipo de pago.
store_id: número de sucursal.
store_name: nombre de la sucursal.
external_reference: número de referencia externa.
payer_nickname: cliente.
transation_amount: monto de la operación.

perception_info: información de la percepción.

aliquot: valor de la alícuota.
taxable_amount: base imponible.

document_info: información del documento.

document_id: número Id de documentos.

marketplace_info: información del marketplace.

marketplace: nombre del marketplace.

currency_info: información de la moneda de acuerdo al site_id.

currency_id: identificador de la moneda de acuerdo al site_id.

Mercado Envíos Flex

Importante:

Está disponible en MLA, MLC y MCO.

Verás el detalle para conciliar las bonificaciones y anulaciones de Flex para un período en particular, el grupo de facturación Mercado Libre y el tipo de documento (nota de débito o nota de crédito). Además, información sobre el envío e información de la venta.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/periods/key/$KEY/group/ML/flex/details

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/periods/key/2023-03-01/group/ML/flex/details?document_type=BILL&limit=1

Respuesta:

{
  "offset": 0,
  "limit": 1,
  "total": 100,
  "results": [{
    "charge_info": {
      "legal_document_number": "00AA11AA00",
      "legal_document_status": "PROCESSED",
      "legal_document_status_description": "Procesado",
      "creation_date_time": "2023-02-21T12:35:58",
      "detail_id": 2020202020,
      "detail_associated_id": 4040404040,
      "detail_amount": 163,
      "transaction_detail": "Anulación de bonificación por Mercado Envíos Flex",
      "detail_type": "CHARGE",
      "detail_sub_type": "CFLX",
      "concept_type": "FLEX"
    },
    "shipping_info": {
      "shipping_id": 4444455555,
      "receiver_nickname": "NICKNAME",
      "pack_id": "12345678",
      "receiver_shipping_cost": 814.99,
      "order": {
        "order_id": 9000000008888888,
        "date_created": "2023-02-15T11:54:51",
        "total_amount": 29499,
        "payment_id": 998899889988,
        "buyer_nickname": "NICKNAME"
      }
    },
    "document_info": {
      "document_id": 776677667711
    }
  }],
  "errors": []
}

Campos de respuesta

charge_info información del cargo.

legal_document_number: número del documento.
legal_document_status: estado de generación del documento. Valores posibles: PROCESSING | PROCESSED
legal_document_status_description: descripción internacionalizada del estado del documento legal_document_status.
creation_date_time: fecha de creación del cargo.
detail_id: identificador del cargo.
detail_associated_id: Identificador del cargo asociado (en caso de anulación de bonificación).
detail_amount: monto del cargo.
transaction_detail: detalle del cargo.
detail_type: tipo de detalle.
detail_sub_type: subtipos de detalles.
concept_type: tipo de concepto.

shipping_info información sobre envío.

shipping_id: identificador del envío.
receiver_nickname: cliente.
pack_id: número de paquete.
receiver_shipping_cost: costo del envío.

order información sobre la venta.

order_id: identificador de la venta.
date_created: fecha de la orden.
total_amount: total de la orden.
payment_id: identificador del pago.
buyer_nickname: cliente.

document_info información del documento.

document_id: id de documento.

Fulfillment

Importante:

Está disponible en MLA, MLB, MLM, MCO y MLC.

Verás los cargos y las bonificaciones por colecta y/o almacenamiento para un período en particular, el grupo de facturación Mercado Libre y el tipo de documento (factura o nota de crédito). También información del producto almacenado o recolectado. Los tipos de cargos para el reporte de Fulfillment pueden ser por: retiro de stock, almacenamiento prolongado, servicio de colecta, incumplimiento, almacenamiento.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/periods/key/$KEY/group/ML/full/details

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/periods/key/2023-03-01/group/ML/full/details?document_type=BILL&limit=1

Respuesta:

{
  "offset": 0,
  "limit": 100,
  "total": 634,
  "results": [{
    "charge_info": {
      "legal_document_number": "000AAA00000000",
      "legal_document_status": "PROCESSED",
      "legal_document_status_description": "Procesado",
      "creation_date_time": "2021-07-23T16:37:58",
      "detail_id": 11111111111,
      "detail_amount": 2.54,
      "transaction_detail": "Cargo por servicio de colecta Full",
      "charge_bonified_id": null,
      "detail_type": "CHARGE",
      "detail_sub_type": "CFCB",
      "concept_type": "FULFILLMENT",
      "payment_id": 222222222
    },
    "fulfillment_info": {
      "type": "INBOUND_COLLECT",
      "amount_per_unit": 2.54,
      "amount": 2.54,
      "sku": "3125404000009",
      "ean": "3125404000009",
      "item_id": "MLM788740252",
      "item_title": "VESTIDO CORTO AZUL MARINO BORDADO EN PECHO DEVENDI",
      "variation": "AZUL MARINO | EG",
      "quantity": 1,
      "volume_type": null,
      "inventory_id": "LLLGGKK12",
      "inbound_id": 555555,
      "volume_unit": "m3",
      "amount_per_volume_unit": 500,
      "volume": 0.00507,
      "volume_total": 0.00507
    },
    "document_info": {
      "document_id": 333333333
    }
  }],
  "errors": []
}

Campos de respuesta

charge_info información del cargo.

legal_document_number: número del documento.
legal_document_status: estado de generación del documento. Valores posibles: PROCESSING | PROCESSED
legal_document_status_description: descripción internacionalizada del estado del documento legal_document_status.
creation_date_time: fecha de creación del cargo.
detail_id: identificador del cargo.
detail_associated_id: Identificador del cargo asociado (en caso de anulación de bonificación).
detail_amount: monto del cargo.
transaction_detail: detalle del cargo.
detail_type: tipo de detalle.
detail_sub_type: subtipos de detalles.
concept_type: tipo de concepto.

charge_info información del cargo.

legal_document_number: número del documento.
legal_document_status: estado de generación del documento. Valores posibles: PROCESSING, PROCESSED
creation_date_time: fecha de creación del cargo.
detail_id: identificador del cargo.
detail_amount: monto del cargo.
transaction_detail: detalle del cargo.
charge_bonified_id: identificador del cargo que bonifica.
detail_type: tipo de detalle.
detail_sub_type: subtipos de detalle.
concept_type: tipo de concepto.
payment_id: identificador de pago.

fulfillment_info: informacion de fulfillment.

type: tipo de fulfillment. Valores posibles: WITHDRAWAL, AGING, INBOUND_COLLECT, INBOUND_PENALTY, WAREHOUSING.
amount_per_unit: monto por unidad.
amount: monto total.
sku: stock keeping unit.
item_id: número de publicación.
item_title: título de la publicación.
variation: variante del producto.
quantity: unidades almacenadas o recolectadas.
volume_type: tamaño de la unidad.
inventory_id: código del inventario de ML.
withdrawal_id: número de retiro. TYPE WITHDRAWAL: Cargo por retiro de stock.
shipment_type: forma de retiro. TYPE WITHDRAWAL: Cargo por retiro de stock.
volume_unit: unidad de medida (m3). TYPE WITHDRAWAL: Cargo por retiro de stock.
amount_per_volume_unit: monto por m3. TYPE WITHDRAWAL: Cargo por retiro de stock.
volume: volumen unitario (cm3). TYPE WITHDRAWAL: Cargo por retiro de stock.
volume_total: volumen total. TYPE WITHDRAWAL: Cargo por retiro de stock.
months_range: antigüedad en meses. TYPE AGING: Cargo por almacenamiento prolongado.
stock_details: detalles del stock. TYPE AGING: Cargo por almacenamiento prolongado.
quantity: cantidad en stock. TYPE AGING: Cargo por almacenamiento prolongado.
inventory_status: estado del inventario. TYPE AGING: Cargo por almacenamiento prolongado.
inbound_id: número de envío. TYPE INBOUND_COLLECT: Cargo por servicio de colecta.
volume_unit: unidad de medida (m3). TYPE INBOUND_COLLECT: Cargo por servicio de colecta.
amount_per_volume_unit: monto por m3. TYPE INBOUND_COLLECT: Cargo por servicio de colecta.
volume: volumen unitario (cm3). TYPE INBOUND_COLLECT: Cargo por servicio de colecta.
volume_total: volumen total. TYPE INBOUND_COLLECT: Cargo por servicio de colecta.
inbound_id: número de envío. TYPE INBOUND_PENALTY: Cargo por incumplimiento.
penalty_type: tipo de incumplimiento. TYPE INBOUND_PENALTY: Cargo por incumplimiento.
warehouse_id: identificador de warehouse. TYPE WAREHOUSING: Cargo por almacenamiento.
size: tamaño de la unidad. TYPE WAREHOUSING: Cargo por almacenamiento.
item_quantity: unidades almacenadas. TYPE WAREHOUSING: Cargo por almacenamiento.

document_info: informacion del documento

document_id: ID del documento.

Insurtech

Importante:

Está disponible en MLA, MLB y MLC.

Verás el detalle para conciliar los cargos y bonificaciones de las garantías aplicadas sobre los productos para un período en particular, el grupo de facturación Mercado Libre y el tipo de documento (Factura o Nota de Crédito).

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/periods/key/$KEY/group/ML/insurtech/details

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/periods/key/2022-10-01/group/ML/insurtech/details?document_type=BILL&limit=1

Respuesta:

{
  "offset": 0,
  "limit": 150,
  "total": 1,
  "results": [
      {
          "charge_info": {
              "legal_document_number": "001112131415",
              "legal_document_status": "PROCESSED",
              "legal_document_status_description": "Procesado",
              "creation_date_time": "2022-10-04T22:24:18",
              "detail_id": 123456,
              "detail_amount": 520.01,
              "transaction_detail": "Cargo por seguro de garantía extendida",
              "status": null,
              "status_description": null,
              "charge_bonified_id": null,
              "detail_type": "CHARGE",
              "detail_sub_type": "CEW",
              "concept_type": "WARRANTY"
          },
          "warranty_info": {
              "warranty_id": "11111111-43c2-44ea-8436-00000000",
              "certificate_id": "MLA999999",
              "warranty_product": "GAREX",
              "buyer_nickname": "TEST",
              "buyer_state_name": "Salta",
              "order": {
                  "order_id": 102030405060,
                  "order_items": [
                      {
                          "unit_price": 10791,
                          "listing_type_id": "gold_special",
                          "item": {
                              "item_id": "MLA88888888",
                              "title": "Auriculares Inalámbricos Jbl Tune 510bt Negro",
                              "category_id": "MLA1234",
                              "category_name": "Auriculares"
                          }
                      }
                  ]
              },
              "quote_model": null,
              "quote_brand": null,
              "quote_description": ""
          },
          "prepaid_info": {
              "operation_id": 55558888,
              "movement_id": 123456789,
              "doc_id": 11111111111,
              "payment": {
                  "payment_id": 5555555555,
                  "date_created": "2022-10-04T22:23:40",
                  "transaction_amount": 736.98,
                  "money_release_date": "2023-03-03T22:23:41"
              }
          },
          "document_info": {
              "document_id": 3333333333
          }
      }
]

Campos de respuesta

charge_info: información del cargo.

legal_document_number: número del documento.
legal_document_status: estado de generación del documento. Valores posibles: PROCESSING | PROCESSED.
legal_document_status_description: descripción internacionalizada del estado del documento legal_document_status.
creation_date_time: fecha de creación del cargo.
detail_id: identificador del cargo.
detail_amount: mosnto de cargo.
transaction_detail: detalle del cargo.
status: estado del cargo. Valores posibles: BONUS_ON_CREDIT_NOTE | BONUS_PART_ON_CREDIT_NOTE | BONUS_ON_BILL | BONUS_PART_ON_BILL | BONUS_ON | BONUS_PART_ON.
status_description: descripción internacionalizada de status.
charge_bonified_id: identificador del cargo que bonifica.
detail_type: tipo de detalle.
detail_sub_type: subtipos de detalles.
concept_type: tipo de concepto.

wanrranty_info: información de la garantía.

wanrranty_id: identificador de la garantía.
certificate_id: identificador del certificado.
waranty_product: tipo de garantía. Valores posibles: CARDS, GAREX, RODA.
buyer_nickname: numero del comprador.
buyer_state_name: provincia del comprador.
order: información de la orden.
order_id: identificador de la orden.
order_items: lista de items de la orden.
unit_price: precio de la unidad.
listing_type_id: tipo de publicación.
item: información del item.
item_id: identificador del producto.
tittle: titulo del producto.
category_id: identificador de la categoría.
category_name: nombre de la categoría.
quote_model: modelo del producto. Aplica a RODA.
quote_brand: marca del producto. Aplica a RODA.
quote_description: descripción adicional. Aplica a RODA.

prepaid_info: información del pago.

operation_id: identificador de la operación.
movement_id: identificador del pago.
doc_id: identificador del documento.

payment: información del pago.

payment_id: identificador del pago.
date_created: fecha de pago.
transaction_amount: monto del pago.
money_release_date: fecha de liberación del dinero.

document_info: informacion del documento.

document_id: ID del documento.

Siguiente: Pagos.