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 09/09/2024

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
 }

Tipos y valores

site_id : Id del site

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: identificación fiscal
    • description: situación fiscal del comprador

address:

  • street_name: nombre de la calle del comprador
  • street_number: dirección del comprador
  • city_name: nombre de la ciudad del comprador
  • neighbhood: nombre del barrio del comprador
  • zip_code: código postal del comprador
  • comment: comentario adicional sobre la dirección del comprador
  • country_id: ID del país
  • state:
    • code: código del estado
    • name: nombre del estado

attirbutes:

  • birth_date: cumpleaños del comprador
  • doc_type_number: número del documento
  • cust_type: tipo de persona (persona jurídica o física)

seller:

  • cust_id: Id del vendedor

Los valores CO o BU del campo cust_type significan:
- CO : Customer
- BU : Business



Tipos y valores para additional_info

Estos son los tipos/valores (type/value en additional_info) posibles para distintos actores:

Persona física

  • first_name: el/los nombre del comprador
  • last_name: el apellido del comprador
  • doc_type: el tipo de documento
  • doc_number: el número de documento
  • zip_code: el código postal del comprador
  • street_name: el nombre de la calle del domicilio de facturación del comprador
  • street_number: la altura de la calle del domicilio de facturación del comprador

Posibles valores: cualquier string, "SN" para casos de calle sin número

  • comment: piso del domicilio de facturación del comprador
  • state_name: estado del domicilio de facturación del comprador
  • city_name: ciudad del domicilio de facturación del comprador
  • secondary_doc_type : el tipo de documento adicional (solo para MLA)
  • secondary_doc_number: el número de documento adicional (solo para MLA)

Persona jurídica

  • business_name: nombre de la entidad jurídica que compra
  • taxpayer_type_id: posición de la entidad jurídica ante el IVA

    • Para MLA:
    -Monotributo
    -IVA Responsable Inscripto
    -IVA Exento

    Para MLB:
    -Contribuinte
    -Não contribuinte

  • state_registration
  • doc_type: el tipo de documento
  • doc_number: el número de documento
  • zip_code: el código postal del comprador
  • street_name: el nombre de la calle del domicilio de facturación del comprador
  • street_number: la altura de la calle del domicilio de facturación del comprador

    • Posibles valores: cualquier string, "SN" para casos de calle sin número


  • comment: piso del domicilio de facturación del comprador
  • state_name: estado del domicilio de facturación del comprador
  • city_name: ciudad del domicilio de facturación del comprador

    • DOC_TYPE's

    Uruguay (MLU): CI, RUT.

    Perú (MPE): DNI, CE.

    Nota:
    Recomendamos que revise los detalles de todos los descuentos aplicados en una venta. Es posible obtener estos detalles con el recurso /discounts