Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.![circulos azuis em degrade](https://http2.mlstatic.com/storage/developers-site-cms-admin/DevImgs/230801158836-ImgMS--1-.png)
Documentação do
Detalhe de conciliação
.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.
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"
},
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.
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
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
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.
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-012/group/ML/flex/details?document_type=BILL&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
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
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.