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 05/05/2026
FAQs Faturamento / Billing info

Faturamento / Billing info


O endpoint /orders/{order_id}/billing_info ainda está disponível para obter dados fiscais do comprador?

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.

Recomendação
Migre as integrações para obter billing_info.id a partir do pedido e consultar o novo endpoint /orders/billing-info/{site_id}/{billing_info_id}.
Por que em algumas consultas ao billing_info faltam campos como doc_type ou doc_number?

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.

Recomendação
Projete lógica que tolere campos nulos e consulte o estado do documento fiscal antes de depender de dados como doc_type ou doc_number.
Onde posso obter de forma confiável os detalhes de impostos aplicados a um pedido?

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.

Recomendação
Use os endpoints de faturamento por período e combine listing_prices com shipments/costs para obter um detalhamento completo quando não existir um campo único.
Qual é o fluxo atual para obter dados fiscais de um comprador (billing info)?

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.

Recomendação
Atualize as integrações para obter billing_info pelo novo endpoint e evite depender do recurso legado.
Por que às vezes tax_status ou outros campos aparecem nulos na resposta de faturamento?

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.

Recomendação
Gerencie estados intermediários em sua lógica e consulte novamente quando o documento fiscal mudar de estado.
Após subir uma nota fiscal, por que aparece invoice_pending e a nota ainda não é encontrada via API?

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.

Recomendação
Envie o XML autorizado com Content-Type=application/xml e verifique a assinatura digital; aguarde o tempo de ingestão e revise logs de erros se o estado não mudar.
O antigo endpoint /orders/{order_id}/billing_info retorna 404; qual é a alternativa e como migrar?

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.

Recomendação
Altere a integração para ler billing_info.id a partir do pedido e usar o novo endpoint; verifique a migração em ambientes de teste.