Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Facturación / Billing info
El endpoint legado fue deprecado; ahora se recomienda usar el nuevo flujo: obtener billing_info.id desde /orders y luego consultar /orders/billing-info/{site_id}/{billing_info_id}. En la migración se está dejando funcionamiento paralelo por tiempo limitado, por lo que se debe adaptar el consumo al nuevo endpoint.
En ciertos sitios o para ciertos buyers la API puede no retornar campos de dirección o identificación por reglas locales (por ejemplo, en Perú el billing_info retornado puede no incluir zip_code o campos completos). Además, cuando el documento fiscal está en proceso (PROCESSING) algunos campos pueden quedar nulos hasta la autorización final.
Para el detalle de impuestos y descuentos aplicados consulte los endpoints de facturación/billing (por periodos) y el endpoint de /orders/{order_id}/discounts (según región). En algunos flujos el breakdown debe calcularse combinando valores de listing_prices y shipments/costs; no siempre hay un único campo que retorne el total de bonos/descuentos.
Extraiga billing_info.id desde /orders (buyer.billing_info.id) y luego consulte /orders/billing-info/{site_id}/{billing_info_id}. El endpoint legacy fue deprecado y debe migrarse al nuevo recurso.
Cuando el documento fiscal aún está en proceso (PROCESSING) o dependiente de autorización fiscal, ciertos campos como tax_status o campos de identificación pueden quedar nulos hasta que la factura sea procesada/authorized. En algunos sitios (ej. Perú) por reglas locales no se retorna zip_code u otros campos.
Puede haber demora en el procesamiento e ingestión de la factura y en la autorización fiscal externa; además envíos con Content-Type incorrecto o XML con firma inválida son rechazados, lo que deja el estado en pending mientras se procesa o se corrige el archivo.
El recurso tradicional fue deprecado. La alternativa es obtener billing_info.id desde la orden (/orders => buyer.billing_info.id) y luego consultar /orders/billing-info/{site_id}/{billing_info_id}. La migración implica ajustar consultas para usar billing_info_id en lugar del endpoint directo anterior.