Documentación Mercado Libre

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

Documentación

Última actualización 15/10/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.

Importante:
  • El filtro "store_ids" se aplica solamente para México. Informamos que este dato será disponibilizado en waves.
  • Semana 14/10 - Primera wave
  • Semana 21/10 - Segunda wave
  • Semana 28/10 - Tercera wave
  • Semana 04/11 - Cuarta wave

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:

 "charge_info": {
               "legal_document_number": "0011A02842483",
               "legal_document_status": "PROCESSED",
               "legal_document_status_description": "Procesado",
               "creation_date_time": "2023-11-19T00:00:30",
               "detail_id": 22930981451,
               "transaction_detail": "Cargo por vender",
               "debited_from_operation": "YES",
               "debited_from_operation_description": "Si",
               "status": null,
               "status_description": null,
               "charge_bonified_id": null,
               "detail_amount": 615,95,
               "detail_type": "CHARGE",
               "detail_sub_type": "CV"
           },
           "discount_info": {
               "charge_amount_without_discount": 815,95,
               "discount_amount": 200,00,
               "discount_reason": "Descuento general",
               “applied_percentage”: 9,61,
                          },
           "sales_info": [
               {
                   "order_id": 2000005750612628,
                   "operation_id": 58682854541,
                   "sale_date_time": "2023-11-18T23:59:26",
                   "sales_channel": "Mercado Libre",
                   "payer_nickname": "RAFACLORAFACLO",
                   "state_name": "Formosa",
                   "transaction_amount": 8490,00
               }
           ],
           "shipping_info": {
               "shipping_id": "42313873858",
               "pack_id": null,
               "receiver_shipping_cost": 868,49
           },
           "items_info": [
               {
                   "item_id": "MLA781129295",
                   "item_title": "Anteojos Sol Polarizados Aviador Policarbonato Filtro Uv400",
                   "item_type": "gold_pro",
                   "item_category": "Ropa y Accesorios > Accesorios de Moda > Anteojos y Accesorios > Marcos de Anteojos",
                    "inventory_id": null,
                   "item_amount": 1,
                   "item_price": 8490,00,
                   "order_id": 2000005750612628,
                   “fees_added_in_publication”: Si,
               }
           ],
           "document_info": {
               "document_id": 2761583612
           },
           "marketplace_info": {
               "marketplace": "CORE"
           },
           "currency_info": {
               "currency_id": "ARS"
           },
        "store_info": {
            "store_id": "12345",
            "store_name": "TIENDA"
        },

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.

  • applied_percentage: porcentaje que se aplicó para calcular el monto del cargo. -solo MLA-
  • 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.
  • fees_added_in_publication: indica si la publicación ofrece cuotas. -solo MLA-

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.

  • store_info: información de la tienda.
    • store_id: identificador de la tienda.
    • store_name: nombre de la tienda.

    Reporte de facturación por orders y packs

    Este endpoint permite obtener los reportes de facturación por el filtro de orders y packs.

    Llamada:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
        https://api.mercadolibre.com/billing/integration/group/ML/order/details?order_id=$ORDER_ID

    Ejemplo:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/billing/integration/group/ML/order/details?order_ids=1234567890000

    Respuesta:

    {
        "offset": 0,
        "limit": 150,   
        "total": 1,
        "results": [
            {
                "order_id": 1234567890000,
                "payment_info": [
                    {
                        "payment_id": 99999999999,
                        "date_approved": "2024-04-23T03:11:47",
                        "date_created": "2024-04-23T03:11:43",
                        "money_release_date": "2024-05-02T19:40:45",
                        "money_release_days": 28,
                        "money_release_status": "released",
                        "payer_id": 12345678,
                        "payment_method_id": "visa",
                        "payment_type_id": "credit_card",
                        "status": "approved",
                        "status_details": null,
                        "tax_details": [
                            {
                                "from": "collector",
                                "to": "mp",
                                "original_amount": 2018.99,
                                "refunded_amount": 0,
                                "mov_detail": "tax_withholding",
                                "mov_financial_entity": "retencion_ganancias",
                                "tax_id": 9999999997,
                                "tax_status": "applied"
                            },
                            {
                                "from": "collector",
                                "to": "mp",
                                "original_amount": 6056.97,
                                "refunded_amount": 0,
                                "mov_detail": "tax_withholding",
                                "mov_financial_entity": "retencion_iva",
                                "tax_id": 9999999998,
                                "tax_status": "applied"
                            },
                            {
                                "from": "collector",
                                "to": "mp",
                                "original_amount": 1211.39,
                                "refunded_amount": 0,
                                "mov_detail": "tax_withholding_collector",
                                "mov_financial_entity": "debitos_creditos",
                                "tax_id": 9999999999,
                                "tax_status": "applied"
                            },
                            {
                                "from": "collector",
                                "to": "mp",
                                "original_amount": 201.9,
                                "refunded_amount": 0,
                                "mov_detail": "tax_withholding_sirtac",
                                "mov_financial_entity": "cordoba",
                                "tax_id": 9999999990,
                                "tax_status": "applied"
                            }
                        ]
                    }
                ],
                "details": [
                    {
                        "charge_info": {
                            "legal_document_number": "0011A03800000",
                            "legal_document_status": "PROCESSED",
                            "legal_document_status_description": "Procesado",
                            "creation_date_time": "2024-04-22T23:12:02",
                            "detail_id": 5555566666,
                            "transaction_detail": "Cargo por venta",
                            "debited_from_operation": "YES",
                            "debited_from_operation_description": "Si",
                            "status": null,
                            "status_description": null,
                            "charge_bonified_id": null,
                            "detail_amount": 28265.86,
                            "detail_type": "CHARGE",
                            "detail_sub_type": "CV"
                        },
                        "discount_info": {
                            "charge_amount_without_discount": 28265.86,
                            "discount_amount": 0,
                            "discount_reason": "Descuento general",
                            "applied_percentage": 14
                        },
                        "sales_info": [
                            {
                                "order_id": 1234567890000,
                                "operation_id": 99999999999,
                                "sale_date_time": "2024-04-22T23:11:42",
                                "sales_channel": "Mercado Libre",
                                "payer_nickname": "NICKNAME",
                                "state_name": "Córdoba",
                                "transaction_amount": 201899
                            }
                        ],
                        "shipping_info": {
                            "shipping_id": "5555566666",
                            "pack_id": null,
                            "receiver_shipping_cost": null
                        },
                        "items_info": [
                            {
                                "item_id": "MLA920316309",
                                "item_title": "Calefactor A Gas Eskabe Miniconvex 5000 S21p Marfil Clase A",
                                "item_type": "gold_special",
                                "item_category": "Electrodomésticos y Aires Ac. > Climatización > Estufas y Calefactores > A Gas",
                                "inventory_id": null,
                                "item_amount": 1,
                                "item_price": 201899,
                                "order_id": 1234567890000,
                                "fees_added_in_publication": "No"
                            }
                        ],
                        "document_info": {
                            "document_id": 5555566666
                        },
                        "marketplace_info": {
                            "marketplace": "CORE"
                        },
                        "currency_info": {
                            "currency_id": "ARS"
                        }
                    },
                    {
                        "charge_info": {
                            "legal_document_number": "0011A03800000",
                            "legal_document_status": "PROCESSED",
                            "legal_document_status_description": "Procesado",
                            "creation_date_time": "2024-04-22T23:12:02",
                            "detail_id": 5555566666,
                            "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_amount": 9380.99,
                            "detail_type": "CHARGE",
                            "detail_sub_type": "CXD"
                        },
                        "discount_info": {
                            "charge_amount_without_discount": 18761.99,
                            "discount_amount": 9381,
                            "discount_reason": "Descuento general"
                        },
                        "sales_info": [
                            {
                                "order_id": 1234567890000,
                                "operation_id": 99999999999,
                                "sale_date_time": "2024-04-22T23:11:42",
                                "sales_channel": "Mercado Libre",
                                "payer_nickname": "NICKNAME",
                                "state_name": "Córdoba",
                                "transaction_amount": 201899
                            }
                        ],
                        "shipping_info": {
                            "shipping_id": "5555566666",
                            "pack_id": null,
                            "receiver_shipping_cost": 0
                        },
                        "items_info": [
                            {
                                "item_id": "MLA920316309",
                                "item_title": "Calefactor A Gas Eskabe Miniconvex 5000 S21p Marfil Clase A",
                                "item_type": "gold_special",
                                "item_category": "Electrodomésticos y Aires Ac. > Climatización > Estufas y Calefactores > A Gas",
                                "inventory_id": null,
                                "item_amount": 1,
                                "item_price": 201899,
                                "order_id": 1234567890000,
                                "fees_added_in_publication": "No"
                            }
                        ],
                        "document_info": {
                            "document_id": 5555566666
                        },
                        "marketplace_info": {
                            "marketplace": "SHIPPING"
                        },
                        "currency_info": {
                            "currency_id": "ARS"
                        }
                    }
                ]
            }
        ]
     

    Parámetros de respuesta:

    • order_id: Identificador de la venta.
    • payment_info: Información del pago.
    • payment_id: Identificador del pago.
    • date_approved: Fecha de aprobación.
    • date_created: Fecha de creación.
    • money_release_date: Fecha de liberación del pago.
    • money_release_days: Días para la liberación del pago.
    • money_release_status: Estado de la liberación del pago.
    • payer_id: Identificador de cliente.
    • payment_method_id: Método de pago.
    • payment_type_id: Tipo de medio de pago.
    • status: Estado del pago.
    • status_details: Detalles del estado del pago.
    • tax_details: Detalles de impuestos.
    • details: Detalles de cargos.
    • sales_info: Información sobre la venta.
    • shipping_info: Información del envío.
    • items_info: Información sobre la publicación.
    • document_info: Información del documento.
    • marketplace_info: Información del marketplace.
    • currency_info: Información de la moneda de acuerdo al site_id.

    Parámetros de consulta:

    • order_ids: Permite buscar por uno o varios id de order.
    • pack_id: Permite buscar por un id de pack.
    • sort_by: Valores posibles: DATE, ID; Valor por defecto: DATE
    • order_by: Permite ordenar la búsqueda. Posibles valores: ASC, DESC; Valor por defecto: ASC
    Importante:
    Desde julio, la estructura de respuesta para MLA se actualizará para separar la información del cargo por venta y el cargo por costo de financiación.
    Esta separación permitirá una mayor claridad y comprensión de los costos asociados, facilitando un análisis más detallado de tus operaciones.

    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/2024-05-01/group/MP/details?document_type=BILL&limit=1

    Respuesta:

    {
       "offset": 0,
       "limit": 1,
       "total": 1,
       "results": [
           {
               "charge_info": {
                   "legal_document_number": "0029A01508173",
                   "legal_document_status": "PROCESSED",
                   "legal_document_status_description": "Procesado",
                   "detail_id": 24168819712,
                   "movement_id": "199835301597",
                   "transaction_detail": "Cargo de Mercado Pago",
                   "debited_from_operation": "INAPPLICABLE",
                   "debited_from_operation_description": "No aplica",
                   "status": "BONUS_ON_BILL",
                   "status_description": "Anulado en factura",
                   "charge_bonified_id": null,
                   "creation_date_time": "2023-07-19T07:29:02",
                   "detail_amount": 3122.76,
                   "detail_type": "CHARGE",
                   "detail_sub_type": "CCMP"
               },
               "operation_info": {
                   "operation_type": "BUY",
                   "operation_type_description": "Pago",
                   "reference_id": 60833750481,
                   "sales_channel": "Checkout",
                   "store_id": null,
                   "store_name": null,
                   "external_reference": "385080",
                   "payer_nickname": "SALADO1958",
                   "financing_fee": 9.2, // solo Brasil
                   "financing_transfer_total": 109.2, // solo Brasil
                   "transaction_amount": 73999
               },
               "perception_info": {
                   "aliquot": null,
                   "taxable_amount": null
               },
               "document_info": {
                   "document_id": 2589999426
               },
               "marketplace_info": {
                   "marketplace": "MP"
               },
               "currency_info": {
                   "currency_id": "ARS"
               }
           }
    

    Campos de respuesta

  • charge_info: información del cargo.
    • legal_document_number: número del documento (En caso de que aplique).
    • detail_id: identificador del cargo.
    • legal_document_status: estado de generación del documento. Valores posibles: PROCESSING, PROCESSED, NOT_APPLICABLE.
    • legal_document_status_description: descripción internacionalizada del estado del documento legal_document_status.
    • movement_id: número de movimiento.
    • transaction_detail: detalle.
    • 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.
    • 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.
    • financing_fee: Diferenciación en el precio según la cantidad de cuotas elegidas por el comprador (Exclusivo para Brasil).
    • financing_transfer_total: valor total pagado por el cliente por el producto (exclusivo Brasil).
    • 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=DEBIT_NOTE&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.