Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 15/10/2024

Detalhe de conciliação

Obtenha o detalhe para conciliar as faturas, os custos de venda para um período específico, o grupo de faturamento (Mercado Livre ou Mercado Pago) e o tipo de documento (Fatura ou Nota de crédito) conforme a unidade de negócio que selecione: Mercado Livre, Mercado Pago, Mercado Envíos Flex, Fulfillment e Insurtech

.

Filtros opcionais

  • order_by: permite ordenar a busca.
    asc: ordena os resultados de forma ascendente (valor por default).
    desc: ordena os resultados de forma descendente.
    Ex: order_by=asc
  • sort_by: permite selecionar por que campo ordenar. Valores possíveis: DATE.
  • detail_typepermite buscar por tipos de detalhes.
    charge: traz somente cobranças.
    bonus: traz somente bonificações.
    Ex: detail_type=charge.
  • detail_sub_types: permite buscar por tipos de detalhes. Se pueden definir varios separados por comas. Se pueden definir varios separados por coma.
    Ex: detail_sub_types=CV, BV
  • detail_excluded_sub_types: permite excluir da busca os subtipos de detalhes indicados. Podem ser definidos vários separados por vírgula.
    Ex: not_subtypes=CXD, BXD
  • marketplace_type: permite buscar pelo market do detalhe.
    Ex: marketplace_type=SHIPPING
  • order_ids: permite buscar por um ou vários ID de order. Disponível para Mercado Libre.
    Ex: order_ids=2294412230
  • item_ids: permite buscar por um ou mais IDs de publicação.
    Ex: item_ids=724159812
  • document_ids: permite buscar por um ou mais IDs de fatura.
    Ex: document_ids=987046992
  • detail_ids: permite buscar por um ou mais IDs de detalhe.
    Ex: detail_ids=724159812
  • offset: permite buscar desde um número de resultado em diante. O valor mínimo permitido é 0 e o valor máximo permitido é 10000. Por padrão o valor é 0. Ex: offset=100 (devolve a partir do resultado nro 100).
  • limit: limita a quantidade de resultados. Por padrão o mínimo é 1 e o máximo valor permitido: 1000.
    Ex: limit=300 (devolve até 300 resultados).

Mercado Livre

Poderá ver os valores faturados, informação de venda, descontos, envios e a publicação.

Importante:
  • O filtro "store_ids" se aplica somente ao México. Informamos que este dado será disponibilizado em waves.
  • Semana 14/10 - Primeira wave
  • Semana 21/10 - Segunda wave
  • Semana 28/10 - Terceira wave
  • Semana 04/11 - Quarta wave

Chamada:

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

Exemplo:

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

Resposta:

"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 resposta Mercado Livre

  • charge_info: informação da cobrança.
    • legal_document_number: número do documento.
    • legal_document_status: estado de criação do documento. Valores possíveis: PROCESSING | PROCESSED.
    • legal_document_status_description: descrição internacionalizada do estado do documento legal_document_status.
    • creation_date_time: data de criação da cobrança.
    • detail_id: identificador da cobrança.
    • transaction_detail: detalhe da cobrança.
    • debited_from_operation: indica se está descontado da operação. Valores possíveis: YES | NO | INAPPLICABLE.
    • debited_from_operation_description: descrição internacionalizada do campo debited_from_operation.
    • status: estado da cobrança. Valores possíveis: BONUS_ON_CREDIT_NOTE | BONUS_PART_ON_CREDIT_NOTE | BONUS_ON_BILL | BONUS_PART_ON_BILL | BONUS_ON | BONUS_PART_ON.
    • status_description: descrição internacionalizada de status.
    • charge_bonified_id: identificador da cobrança que bonifica.
    • detail_amount: valor da cobrança.
    • detail_type: tipo de detalhe.
    • detail_sub_type: subtipos de detalhes.

  • discount_info: informação sobre descontos.
    • charge_amount_without_discount: valor da cobrança sem desconto.
    • discount_amount: valor do desconto.
    • discount_reason: motivo do desconto.
    • sales_info: informação de vendas.
    • applied_percentage: porcentagem que foi aplicado para calcular o valor da tarifa. -apenas MLA-

  • sale_info: informação sobre a venda.
    • order_id: identificador da venda.
    • operation_id: identificador do pagamento.
    • sale_date_time: data e hora da venda.
    • sales_channel: canal de venda.
    • payer_nickname: cliente.
    • state_name: estado.
    • transaction_amount: valor total da venda.

  • shipping_info: informação do envio.
    • shipping_id: identificador do envio.
    • pack_id: identificador do pacote.
    • receiver_shipping_cost: envio a cobrança do cliente.

  • items_info: informação sobre publicações.
    • item_id: identificador da publicação.
    • item_title: título da publicação.
    • item_type: tipo de publicação.
    • item_category: categoria da publicação.
    • inventory_id: código de Mercado Livre.
    • item_amount: quantidade de itens vendidos.
    • item_price: preço unitário de item.
    • order_id: ordem à qual o item pertence.
    • fees_added_in_publication: Indica se a publicação oferece parcelamento. -apenas MLA-

  • documentInfo: informação do documento.
    • document_id: número Id de documentos.

  • marketplaceInfo: informação do marketplace.
    • marketplace: nome do marketplace.

  • currency_info: informação da moeda de acordo ao site_id.
    • currency_id: identificador da moeda de acordo ao site_id.

  • store_info: informação da filial.
    • store_id: identificador da filial.
    • store_name: nome da filial.

Reporte de faturamento por orders e packs

Esse endpoint permite a busca dos reportes de faturamento pelo filtro de orders e packs:

Chamada:

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

Exemplo:

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

Resposta:

{
    "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 resposta:

  • order_id: Identificador da venda.
  • payment_info: Informação do pagamento.
  • payment_id: Identificador do pagamento.
  • date_approved: Data de aprovação.
  • date_created: Data de criação.
  • money_release_date: Data de liberação do pagamento.
  • money_release_days: Dias para a liberação do pagamento.
  • money_release_status: Estado da liberação do pagamento.
  • payer_id: Identificador do cliente.
  • payment_method_id: Método de pagamento.
  • payment_type_id: Tipo de meio de pagamento.
  • status: Estado do pagamento.
  • status_details: Detalhes do estado do pagamento.
  • tax_details: Detalhes de impostos.
  • details: Detalhes de encargos.
  • sales_info: Informação sobre a venda.
  • shipping_info: Informação da entrega.
  • items_info: Informação sobre a publicação.
  • document_info: Informação do documento.
  • marketplace_info: Informação sobre o marketplace.
  • currency_info: Informação da moeda de acordo com o site_id.

Parâmetros de consulta:

  • order_ids: Permite buscar por um ou vários id de order.
  • pack_id: Permite buscar por um id de pack.
  • sort_by: Valores possíveis: DATE, ID; Valor padrão: DATE
  • order_by: Permite ordenar a pesquisa. Valores possíveis: ASC, DESC; Valor padrão: ASC
Importante:
A partir de julho, a estrutura de resposta para MLA será atualizada para separar a informação do custo de venda e o custo de financiamento.
Essa separação permitirá uma maior clareza e compreensão dos custos associados, facilitando uma análise mais detalhada das suas operações.

Mercado Pago

Poderá ver o detalhe de custos faturados, com informação complementar sobre a operação do Mercado Pago, como os movimentos, meios de pagamento, payer, filial, ponto de venda, entre outros.

Chamada:

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

Exemplo:

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

Resposta:


  {
   "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, // apenas para Brasil
               "financing_transfer_total": 109.2, // apenas para 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 resposta Mercado Pago

  • charge_info: informação da cobrança.
    • legal_document_number: número do documento (Quando aplicável).
    • legal_document_status: estado de geração do documento. Valores possíveis: PROCESSING, PROCESSED, NOT_APPLICABLE.
    • legal_document_status_description: descrição internacionalizada do estado do documento legal_document_status.
    • creation_date_time: data da cobrança.
    • detail_id: identificador da cobrança.
    • movement_id: número de movimento.
    • transaction_detail: detalhe.
    • debited_from_operation: indica se está deduzido da operação. Valores possíveis: YES, NO, INAPPLICABLE.
    • debited_from_operation_description: descrição internacionalizada do campo debited_from_operation.
    • status: estado da cobrança. Valores possíveis: BONUS_ON_CREDIT_NOTE, BONUS_PART_ON_CREDIT_NOTE, BONUS_ON_BILL, BONUS_PART_ON_BILL, BONUS_ON, BONUS_PART_ON.
    • status_description: descrição internacionalizada do status.
    • charge_bonified_id: identificador da cobrança bonificada.
    • detail_amount: valor da cobrança.
    • detail_type: tipo de detalhe.
    • detail_sub_type: subtipos de detalhes.

  • operation_info: informação de operação sobre a que se aplica.
    • operation_type: tipo de operação. Valores possíveis BUY | TAX.
    • operation_type_description: descrição internacionalizada do campo operation.
    • reference_id: número de operação relacionada.
    • sales_channel: tipo de pagamento.
    • store_id: número de filial/loja.
    • store_name: nome da filial/loja.
    • external_reference: número de referência externa.
    • payer_nickname: cliente.
    • financing_fee: Diferenciação no preço de acordo com a quantidade de parcelas escolhidas pelo comprador (Exclusivo para Brasil).
    • financing_transfer_total: valor total pago pelo cliente pelo produto (exclusivo para Brasil).
    • transation_amount: valor da operação.

  • perception_info: informação da percepção.
    • aliquot: valor da alíquota.
    • taxable_amount: base tributável.

  • documentInfo: informação do documento.
    • document_id: número Id de documentos.

  • marketplaceInfo: informação do marketplace.
    • nome do marketplace.

  • currency_info: informação da moeda de acordo ao site_id.
    • currency_id: identificador da moeda de acordo ao site_id.

Mercado Envios Flex

Importante:
Está disponível apenas nos sites MLA, MLC e MCO.

Poderá ver o detalhe para conciliar as bonificações e anulamentos de Flex, para um período em particular, o grupo de faturamento Mercado Livre e o tipo de documento (nota de débito ou nota de crédito). Além disso, terá informações sobre o envio e sobre a venda.


Nota:
O endpoint de Flex está disponível apenas nos sites MLA, MLC e MCO.

Chamada:

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

Exemplo:

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

Resposta:

{
    "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 resposta Mercado Envios Flex

  • charge_info: informações de cobrança.
    • legal_document_number: número do documento.
    • legal_document_status: estado de geração do documento. Possíveis valores: PROCESSING | PROCESSED
    • legal_document_status_description: descrição internacionalizada do estado do documento legal_document_status.
    • creation_date_time: data de criação da cobrança.
    • detail_id: identificador da cobrança.
    • detail_associated_id: Identificador da cobrança associada (em caso de cancelamento de bonificação).
    • detail_amount: valor da cobrança.
    • transaction_detail: detalhe da cobrança.
    • detail_type: tipo de detalhe.
    • detail_sub_type: subtipos de detalhes.
    • concept_type: tipo de conceito.

  • shipping_info: informação sobre envio.
    • shipping_id: identificador do envio.
    • receiver_nickname: cliente.
    • pack_id: número do pacote.
    • receiver_shipping_cost: custo do envio.

  • order: informação da venda.
    • order_id: identificador da venda.
    • date_created: data da order.
    • totalAmount: valor total da order.
    • paymentId: identificador de pagamento.
    • buyerNickname: cliente.

  • document_info: informação do documento.
    • document_id: ID do documento.

Fulfillment

Importante:
Está disponível apenas nos sites MLA, MLB, MLM, MCO e MLC.

Poderá ver os custos e as bonificações por coleta e/ou armazenamento para um período particular, o grupo de faturamento Mercado Livre e o tipo de documento (fatura ou nota de crédito). Também terá informações do producto armazenado e recoletado. Os tipos de custo para o reporte de Fullfilment poder ser por: retirada de estoque, armazenamento prolongado, serviço de coleta, descumprimento, armazenamento.


Chamada:

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

Exemplo:

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

Resposta:

{
    "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 resposta Mercado Envios Fulfillment

  • charge_info: informação da cobrança.
    • legal_document_number: número do documento.
    • legal_document_status: estado de geração do documento. Possíveis valores: PROCESSING, PROCESSED
    • creation_date_time: data de criação da cobrança.
    • detail_id: identificador da cobrança.
    • detail_amount: valor da cobrança.
    • transaction_detail: detalhe da cobrança.
    • charge_bonified_id: identificador da cobrança que bonifica.
    • detail_type: tipo de detalhe.
    • detail_sub_type: subtipos de detalhe.
    • concept_type: tipo de conceito.
    • payment_id: identificador do pagamento.

  • fulfillment_info: Informação de fulfillment.
    • type: tipo de fulfillment. Possíveis valores: WITHDRAWAL | AGING | INBOUND_COLLECT | INBOUND_PENALTY | WAREHOUSING
    • amount_per_unit: valor por unidade.
    • amount: total.
    • sku: stock-keeping-unit.
    • item_id: número da publicação.
    • item_title: titulo da publicação.
    • variation: variável do produto.
    • quantity: unidades armazenadas ou recoletadas.
    • volume_type: tamanho da unidade.
    • inventory_id: código do inventário do Mercado Livre.
    • withdrawal_id: número de retirada –TYPE WITHDRAWAL custo por retirada de estoque –
    • shipment_type: forma de retirada. –TYPE WITHDRAWAL custo por retirada de estoque –
    • volume_unit: unidade de medida (m3). –TYPE WITHDRAWAL custo por retirada de estoque –
    • amount_per_volume_unit: valor por m3. –TYPE WITHDRAWAL custo por retirada de estoque –
    • volume: volume unitário (cm3) –TYPE WITHDRAWAL custo por retirada de estoque–
    • volume_total: volume total. –TYPE WITHDRAWAL custo por retirada de estoque –
    • months_range: antiguidade em meses. –TYPE AGING custo por armazenamento prolongado –
    • stock_details: detalhes de estoque. –TYPE AGING custo por armazenamento prolongado –
    • quantity: quantidade em estoque. –TYPE AGING custo por armazenamento prolongado–
    • inventory_status: estado do inventário. –TYPE AGING custo por armazenamento prolongado –
    • inbound_id: número de envio. –TYPE INBOUND_COLLECT custo por serviço de coleta –
    • volume_unit: unidade de medida (m3) –TYPE INBOUND_COLLECT custo por serviço de coleta –
    • amount_per_volume_unit: valor por m3. –TYPE INBOUND_COLLECT custo por serviço de coleta –
    • volume: volume unitário (cm3) –TYPE INBOUND_COLLECT custo por serviço de coleta –
    • volume_total: volume total. –TYPE INBOUND_COLLECT custo por serviço de coleta–
    • inbound_id: número de envio. –TYPE INBOUND_PENALTY custo por não cumprimento -
    • penalty_type: tipo de não cumprimento. –TYPE INBOUND_PENALTY custo por não cumprimento –
    • warehouse_id: identificador de warehouse.–TYPE WAREHOUSING custo por não cumprimento –
    • size: tamanho da unidade.–TYPE WAREHOUSING custo por armazenamento–
    • item_quantity: unidades armazenadas.–TYPE WAREHOUSING custo por armazenamento–

  • idocument_info: informação do documento.
    • document_id: ID do documento.

Insurtech

Importante:
Está disponível apenas nos sites MLA, MLB e MLC.

Poderá ver o detalhe para conciliar os custos e bonificações das garantias aplicadas sobre o produto para um período particular, o grupo de faturamento Mercado Livre e o tipo de documento (Fatura ou nota de crédito).

Chamada:

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

Exemplo:

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

Resposta:


  {
     "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 resposta Insurtech

  • charge_info: informação da cobrança.
  • <
    • legal_document_number: número do documento.
    • legal_document_status: estado de geração do documento. Valores possiveís: PROCESSING | PROCESSED.
    • legal_document_status_description: descrição internacionalizada do estado do documento legal_document_status.
    • creation_date_time: data de criação da cobrança.
    • detail_id: identificador da cobrança.
    • detail_amount: valor da cobrança.
    • transaction_detail: detalhe da cobrança.
    • status: estado da cobrança. Valores possíveis: BONUS_ON_CREDIT_NOTE | BONUS_PART_ON_CREDIT_NOTE | BONUS_ON_BILL | BONUS_PART_ON_BILL | BONUS_ON | BONUS_PART_ON.
    • status_description: descrição internacionalizada de status.
    • charge_bonified_id: identificador da cobrança bonificada.
    • detail_type: tipo de detalhe.
    • detail_sub_type: subtipos de detalhes.
    • concept_type: ipo de conceito.

  • wanrranty_info: informação da garantia.
    • wanrranty_id: identificador da garantia.
    • certificate_id: identificador do certificado.
    • waranty_product: tipo de garantia. Valores possíveís: CARDS, GAREX, RODA.
    • buyer_nickname: numero do comprador.
    • buyer_state_name: província do comprador.
    • order: informação da venda.
    • order_items: lista de items da venda.
    • unit_price: preço por unidade.
    • listing_type_id: tipo de publicação.
    • item: informação do item.
    • item_id: identificador do produto.
    • tittle: titulo do produto.
    • category_id: identificador da categoria.
    • category_name: nome da categoria.
    • quote_model: modelo do produto. Aplica a RODA.
    • quote_brand: marca do produto. Aplica a RODA.
    • quote_description: descrição adicional. Aplica a RODA.

  • prepaid_info: informação do pagamento.
    • operation_id: identificador da operação.
    • movement_id: identificador do pagamento.
    • doc_id: identificador do documento.

  • payment: informação do pagamento.
    • payment_id: identificador do pagamento.
    • date_created: data de papamento.
    • transaction_amount: valor do pago.
    • money_release_date: data de liberação do dinheiro.

  • document_info: informação do documento
    • document_id: ID do documento.

Seguinte: Pagamentos.