Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 08/04/2025

Datos de facturación

Importante:
  • Para obtener la respuesta con la nueva versión, envíe el header 'x-version: 2'.
  • La V2 del recurso ya está disponible para todos los sites, con excepción de Venezuela.

Para realizar la facturación de una venta es necesario tener los datos del comprador que se encuentran disponibles dentro del recurso de Orders, más específicamente /orders/order_id/billing_info.

Consultar los datos de facturación

Para obtener la información cargada en una orden respecto de los datos de facturación de un comprador deberás hacer la siguiente llamada. Llamada:

curl -X GET \
  -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'x-version:2' \
  https://api.mercadolibre.com/orders/$ORDER_ID/billing_info

Ejemplo:

curl -X GET \
  -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'x-version:2' \
  https://api.mercadolibre.com/orders/1691789796/billing_info

Respuesta con los ejemplos de persona física y jurídica MLA - Persona Física 

{
    "site_id":"MLA",
    "buyer":{
        "cust_id": "123123123"
       "billing_info":{
          "name":"Juan Soares",
          "last_name":"Sanchez",
          "identification":{
             "type":"DNI" / "CUIL",
             "number":"307722738"
          },
          "taxes": {
            "taxpayer_type": {
                "id": "01",
                "description": "Consumidor Final"
            }
          },
          "address":{
             "street_name":"Aysen",
             "street_number":"30",
             "city_name":"Buenos Aires",
             "state":{
                "code": "01",
                "name": "Buenos Aires"
            },
             "zip_code":"5000",
             "country_id":"AR"
          },
          "attributes": {
            "vat_discriminated_billing": "true",
            "doc_type_number": "123123123",
            "is_normalized": true,
            "cust_type": "CO"
          }
       }
    },
    "seller":{
        "cust_id": 0,
    }


MLA - Persona Jurídica 

{
    "site_id":"MLA",
    "buyer":{
        "cust_id": "123123123",
       "billing_info":{
          "name":"Apple Argentina"
          "identification":{
             "type":"CUIT",
             "number":"307722738"
          },
          "taxes": {
            "taxpayer_type": {
                "description": "IVA Responsable Inscripto"
            }
          },
          "address":{
             "street_name":"Aysen",
             "street_number":"30",
             "city_name":"Buenos Aires",
             "state":{
                "code": "01",
                "name": "Buenos Aires"
            },
             "zip_code":"5000",
             "country_id":"AR"
          },
          "attributes": {
            "vat_discriminated_billing": "true",
            "doc_type_number": "123123123",
            "is_normalized": true,
            "cust_type": "BU"
          }
       }
    },
    "seller":{
        "cust_id": 0,
    }


MLB - Persona Física 

{
  "site_id": "MLB",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "María Lupita",
      "last_name": "Gomez Blanco",
      "identification": {
        "type": "CPF",
        "number": "32659430" 
      },
      "address": {
        "street_name": "Nicolau de Marcos",
        "street_number": "05",
        "city_name": "Bom Jardim",
        "comment": "7b",
        "neighborhood": "Jardim Ornelas",
        "state": {
          "name": "Rio de Janeiro"
        },
        "zip_code": "28660000",
        "country_id": "BR"
      },
      "attributes": {
          "is_normalized": true,
          "cust_type": "CO"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }}


MLB - Persona Jurídica 

{
  "site_id": "MLB",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Apple Brasil",
   "identification": {
        "type": "CNPJ",
        "number": "326594309119203" 
      },
      "taxes": {
        "inscriptions": 
         {
            "state_registration": "30703088534",
         }
        , 
        "taxpayer_type": {
          "description": "Contribuinte" 
        }
      },
      "address": {
        "street_name": "Nicolau de Marcos",
        "street_number": "05",
        "city_name": "Bom Jardim",
        "comment": "7b",
        "neighborhood": "Jardim Ornelas",
        "state": {
          "name": "Rio de Janeiro"
        },
        "zip_code": "28660000",
        "country_id": "BR"
      },
      "attributes": {
          "is_normalized": true,
          "cust_type": "BU"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }}


MLM - Persona Física 

{
  "site_id": "MLM",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Juan Soraes",
   "last_name": "Sanchez"	
      "identification": {
        "type": "RFC",
        "number": "CUPU800825569"
      },
      "taxes": {
        "contributor": "PERSONA FÍSICA",
        "taxpayer_type": {
          "id": "606",
          "description": "Arrendamiento"
        },
        "cfdi": {
          "id": "G03",
          "description": "Gastos en general"
        }
      },
      "address": {
        "street_name": "Calle 134A #18A",
        "street_number": "05",
        "city_name": "Alvaro Obregón",
        "state": {
          "code": "DIF",
          "name": "Distrito Federal"
        },
        "zip_code": "01040",
        "country_id": "MX"
      },
      "attributes": {
        "vat_discriminated_billing": "true",
        "birth_date": "2000/02/03",
        "is_normalized": true,
        "customer_type": "CO"
      }
    }
  },
  "seller": {
    "cust_id": 34345454  }}


MLM - Persona Jurídica 

{
  "site_id": "MLM",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "SALVADO HNOS S A",
      "identification": {
        "type": "RFC",
        "number": "CUPU800825569"
      },
      "taxes": {
        "contributor": "PERSONA MORAL",
        "taxpayer_type": {
          "id": "606",
          "description": "Arrendamiento"
        },
        "cfdi": {
          "id": "G03",
          "description": "Gastos en general"
        }
      },
      "address": {
        "street_name": "Calle 134A #18A",
        "street_number": "05",
        "city_name": "Alvaro Obregón",
        "state": {
          "code": "DIF",
          "name": "Distrito Federal"
        },
        "zip_code": "01040",
        "country_id": "MX"
      },
      "attributes": {
        "vat_discriminated_billing": "true",
        "birth_date": "2000/02/03",
        "is_normalized": true,
        "customer_type": "BU"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
 }
}
Nota:
  • Cuando los datos de facturación del comprador indiquen el RFC genérico XAXX010101000, eso significa que el comprador no solicitó una factura nominal. En ese caso, el vendedor tendrá la libertad de decidir si emitirá una factura genérica o una factura global.


MLC - Persona Física 

{
    "site_id": "MLC",
    "buyer": {
      "cust_id": 234343545,
      "billing_info": {
        "name": "Tamara nicolt",
        "last_name": "larenas reyes",
        "identification": {
          "type": "RUT",
          "number": "159321126"
        },
     "address": {
          "street_name": "Pasaje Beethoven",
          "street_number": "56",
          "city_name": "Maipú",
          "comment": "73",
          "neighborhood": "Maipú",
          "state": {
            "name": "RM (Metropolitana)"
          },
          "country_id": "CL"
        },
        "attributes": {
          "is_normalized": true,
           "cust_type": "CO"
       }
      }
    },
    "seller": {
      "cust_id": 34345454,
    }
  }


MLC - Persona Jurídica 

{
    "site_id": "MLC",
    "buyer": {
      "cust_id": 234343545,
      "billing_info": {
        "name": "Apple",
        "identification": {
          "type": "RUT",
          "number": "159321126"
        },
        "taxes": {
           "economic_activity": "Vta.y arrdo artcls Electrónico",
        },
        "address": {
          "street_name": "Pasaje Beethoven",
          "street_number": "56",
          "city_name": "Maipú",
          "comment": "73",
          "neighborhood": "Maipú",
          "state": {
            "name": "RM (Metropolitana)"
          },
          "country_id": "CL"
        },
        "attributes": {
          "is_normalized": true,
      "cust_type": "BU" 
       }
      }
    },
    "seller": {
      "cust_id": 34345454,
    }
  }


MCO - Persona Física 

{
  "site_id": "MCO",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Adrian",
      "last_name": "Garces",
      "identification": {
        "type": "CC",
        "number": "73160000"
      },
     "address": {
          "street_name": "Pasaje Beethoven",
          "street_number": "#10-11",
          "city_name": "La Candelaria",
          "comment": "73",
          "neighborhood": "Candelaria",
          "state": {
            "name": "RM (Metropolitana)",
	     "code": "CO-DC"
          },
          "country_id": "CO"
        },
  },
  "seller": {
    "cust_id": 34345454,
  }
}


MCO - Persona Jurídica 

{
  "site_id": "MCO",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Apple",
      "identification": {
        "type": "CC",
        "number": "73160000"
      },
      "address": {
          "street_name": "Pasaje Beethoven",
          "street_number": "#10-11",
          "city_name": "La Candelaria",
          "comment": "73",
          "neighborhood": "Candelaria",
          "state": {
            "name": "RM (Metropolitana)",
	     "code": "CO-DC"
          },
          "country_id": "CO"
        },
      "attributes": {
        "is_normalized": true
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }


MEC - Persona Física 

{
  "site_id": "MEC",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Adrian",
      "last_name": "Garces",
      "identification": {
        "type": "RUC" / "CI",
        "number": "1711168979001"
      },
      "address": {
        "country_id": "EC"
      },
      "attributes": {
        "is_normalized": true
    "email":"test_user_937841642@testuser.com"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }
}


MEC - Persona Jurídica 

{
  "site_id": "MEC",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Apple",
      "identification": {
        "type": "RUC",
        "number": "1711168979001"
      },
      "address": {
        "country_id": "EC"
      },
      "attributes": {
        "is_normalized": true
    	 "email":"test_user_937841642@testuser.com"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }
}


MPE - Persona Física y Persona Jurídica 

{
    "buyer": {
        "cust_id": "325999999",
        "billing_info": {
            "identification": {
                "type": "DNI",
                "number": "70999999"
            },
            "attributes": {
                "normalized": "false",
                "is_vat_discriminated_billing": false,
                "is_new_billing_info": false
            }
        }
    },
    "seller": {
        "cust_id": "1469999999"
    },
    "buyer_id": 325999999,
    "seller_id": 1469999999,
    "is_order_origin": false
 }


MLU - Persona Física 

{
    "buyer": {
        "cust_id": "1921961891",
        "billing_info": {
            "identification": {
                "type": "CI",
                "number": "64856596"
            },
            "attributes": {
                "normalized": "false",
                "is_vat_discriminated_billing": false,
                "is_new_billing_info": false
            }
        }
    },
    "seller": {
        "cust_id": "293733309"
    },
    "buyer_id": 1921961891,
    "seller_id": 293733309,
    "is_order_origin": false
 }


MLU - Persona Jurídica 

{
    "buyer": {
        "cust_id": "1934756972",
        "billing_info": {
            "identification": {
                "type": "RUT",
                "number": "215191230015"
            },
            "attributes": {
                "normalized": "false",
                "is_vat_discriminated_billing": false,
                "is_new_billing_info": false
            }
        }
    },
    "seller": {
        "cust_id": "293733309"
    },
    "buyer_id": 1934756972,
    "seller_id": 293733309,
    "is_order_origin": false
 }

Descripción de los campos de la API

Persona física

  • site_id: ID del sitio
  • buyer:
    • cust_id: ID del comprador
  • billing_info:
    • name: nombre del comprador
    • last_name: apellido del comprador
    • identification:
      • type: tipo de documento
      • number: número del documento
  • taxes:
    • inscriptions:
      • state_registration: registro estatal
    • economic_activity: actividad económica
    • contributor: tipo de contribuyente
    • taxpayer_type:
      • id: identificador de la entidad
      • description: situación fiscal del comprador
  • address:
    • street_name: nombre de la calle del comprador
    • street_number: número de la dirección del comprador
    • city_name: nombre de la ciudad del comprador
    • neighborhood: nombre del barrio del comprador
    • zip_code: código postal del comprador
    • comment: información adicional sobre la dirección del comprador
  • country_id: ID del país
  • state:
    • code: código del estado
    • name: nombre del estado
  • secondary_doc_type: tipo de documento adicional (solo para MLA)
  • secondary_doc_number: número del documento adicional (solo para MLA)
  • attributes:
    • birth_date: fecha de nacimiento del comprador
    • doc_type_number: número del documento del comprador
    • cust_type: persona jurídica o persona física
  • seller:
    • cust_id: ID del vendedor

Los valores CO o BU, cuando están presentes en el campo cust_type, significan:

CO: Cliente
BU: Empresa

Persona jurídica

  • business_name: nombre de la entidad jurídica compradora
  • taxpayer_type_id: posición de la entidad jurídica en relación al IVA

Para MLA:

  • Monotributo
  • IVA Responsable Inscripto
  • IVA Exento

Para MLB:

  • Contribuyente
  • No contribuyente
  • state_registration: registro estatal
  • doc_type: tipo de documento
  • doc_number: número del documento
  • zip_code: código postal del comprador
  • street_name: nombre de la calle de la dirección de facturación del comprador
  • street_number: número de la calle de la dirección de facturación del comprador

Valores posibles: cadena, "SN" para casos de dirección sin número

  • comment: información adicional de la dirección de facturación del comprador
  • state_name: estado de la dirección de facturación del comprador
  • city_name: ciudad de la dirección de facturación del comprador

DOC_TYPE's:

  • Brasil (MLB):
    • Persona física: CPF, RG
    • Persona jurídica: CNPJ
  • Argentina (MLA):
    • Persona física: DNI, CUIL
    • Persona jurídica: CUIT
  • Chile (MLC):
    • Persona física: RUT
    • Persona jurídica: RUT
  • Colombia (MCO):
    • Persona física: CC, CE
    • Persona jurídica: NIT
  • México (MLM):
    • Persona física: RFC, CURP
    • Persona jurídica: RFC
  • Ecuador (MEC):
    • Persona física: CI
    • Persona jurídica: RUC
  • Uruguay (MLU):
    • Persona física: CI
    • Persona jurídica: RUT
  • Perú (MPE):
    • Persona física: DNI
    • Persona jurídica: CE