Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação do
Faturamento / Billing info
O endpoint legado foi depreciado; agora recomenda-se usar o novo fluxo: obter billing_info.id de /orders e em seguida consultar /orders/billing-info/{site_id}/{billing_info_id}. Na migração está sendo mantido funcionamento paralelo por tempo limitado, portanto o consumo deve ser adaptado para o novo endpoint.
Em certos sites ou para certos compradores a API pode não retornar campos de endereço ou identificação por regras locais (por exemplo, no Peru o billing_info retornado pode não incluir zip_code ou campos completos). Além disso, quando o documento fiscal está em processamento (PROCESSING) alguns campos podem ficar nulos até a autorização final.
Para o detalhamento de impostos e descontos aplicados consulte os endpoints de faturamento/billing (por períodos) e o endpoint /orders/{order_id}/discounts (conforme a região). Em alguns fluxos o breakdown deve ser calculado combinando valores de listing_prices e shipments/costs; nem sempre há um único campo que retorna o total de bônus/descontos.
Extraia billing_info.id de /orders (buyer.billing_info.id) e em seguida consulte /orders/billing-info/{site_id}/{billing_info_id}. O endpoint legado foi depreciado e deve ser migrado para o novo recurso.
Quando o documento fiscal ainda está em processamento (PROCESSING) ou dependente de autorização fiscal, certos campos como tax_status ou campos de identificação podem ficar nulos até que a nota seja processada/autorizada. Em alguns sites (ex. Peru) por regras locais não é retornado zip_code ou outros campos.
Pode haver demora no processamento e ingestão da nota fiscal e na autorização fiscal externa; além disso, envios com Content-Type incorreto ou XML com assinatura inválida são rejeitados, deixando o estado em pending enquanto o arquivo é processado ou corrigido.
O recurso tradicional foi depreciado. A alternativa é obter billing_info.id a partir do pedido (/orders => buyer.billing_info.id) e em seguida consultar /orders/billing-info/{site_id}/{billing_info_id}. A migração implica ajustar as consultas para usar billing_info_id em vez do endpoint direto anterior.