Billing data

Important:
This feature isn´t available in México.

To bill a sale you need to have the buyer's data which are available in Orders resource, more specifically, in /orders/order_id/billing_info.

Contents

→Query billing data
→Types and values for additional info


Query billing data

To get the information about a buyer's billing data contained in an order, make the following call. Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'  https://api.mercadolibre.com/orders/$order_id/billing_info

Example:

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

The orders from Mercado Libre Argentina and Brasil returns billing data by:

  • Products with Pick up in Store, Fullfillment or CrossDocking
  • Products from Tiendas Oficiales, Mercado Lideres.
  • Products with Global Selling.
  • Purchases con Garex.

Response (these are examples of persons: MLB and MLA Individual/Legal Entity) MLA - Individual
Order Id: 1691789796
User id: 316440831

{
  "billing_info": {
    "additional_info": [
      {
        "type": "STREET_NAME",
        "value": "Arias"
      },
      {
        "type": "ZIP_CODE",
        "value": "1430"
      },
      {
        "type": "STREET_NUMBER",
        "value": "3571"
      },
      {
        "type": "CITY_NAME",
        "value": "Saavedra"
      },
      {
        "type": "LAST_NAME",
        "value": "Gomez Blanco"
      },
      {
        "type": "SITE_ID",
        "value": "MLA"
      },
      {
        "type": "COMMENT",
        "value": "7b"
      },
      {
        "type": "DOC_NUMBER",
        "value": "32659430"
      },
      {
        "type": "DOC_TYPE",
        "value": "DNI"
      },
      {
        "type": "STATE_NAME",
        "value": "Capital Federal"
      },
      {
        "type": "FIRST_NAME",
        "value": "María Lupita"
      },
{
type: "NEIGHBORHOOD",
value: "Divino"
},
    ],
    "doc_number": "32659430",
    "doc_type": "DNI"
  }
}

MLA - Legal Entity
Order Id: 1691801481
User id: 316440831
{
  "billing_info": {
    "additional_info": [
      {
        "type": "DOC_NUMBER",
        "value": "30703088534"
      },
      {
        "type": "ZIP_CODE",
        "value": "1430"
      },
      {
        "type": "STATE_REGISTRATION",
        "value": "30703088534"
      },
      {
        "type": "TAXPAYER_TYPE_ID",
        "value": "IVA Responsable Inscripto"
      },
      {
        "type": "BUSINESS_NAME",
        "value": "Mercado Libre S.R.L"
      },
      {
        "type": "CITY_NAME",
        "value": "Saavedra"
      },
      {
        "type": "STREET_NAME",
        "value": "Arias"
      },
      {
        "type": "STREET_NUMBER",
        "value": "SN"
      },
      {
        "type": "COMMENT",
        "value": "7b"
      },
      {
        "type": "DOC_TYPE",
        "value": "CUIT"
      },
      {
        "type": "STATE_NAME",
        "value": "Capital Federal"
      },
      {
        "type": "SITE_ID",
        "value": "MLA"
      },
{
type: "NEIGHBORHOOD",
value: "Divino"
},
    ],

    "doc_number": "30703088534",
    "doc_type": "CUIT"
  }
}


Types and values ​​for additional_info

These are the possibles types and values ​​(type / value) for additional_info.

Individual Entity

  • first_name: nome do comprados
  • last_name: sobrenome do comprador
  • doc_type: tipo do documento
  • doc_number: numero do documento
  • zip_code: código postal do comprador
  • street_name: ndereço do comprador
  • street_number: numero endereço do comprador

Can be "SN" for street cases without number

  • comment: extra comment about buyer's address
  • state_name: buyer's status
  • city_name: buyer's city
  • secondary_doc_type : additional document type (only for MLA)
  • secondary_doc_number: additional document number (only for MLA)

Legal Entity

  • business_name: Buying legal entity name
  • taxpayer_type_id: legal entity VAT position
  • Possible values: between "monotax" (non-VAT taxpayer) and "VAT"

    To MLA:
    -Monotributo
    -IVA Responsable Inscripto
    -IVA Exento

    To MLB:
    -Contribuinte
    -Não contribuinte

  • state_registration
  • doc_type: type of document
  • doc_number: number of document
  • zip_code: buyer's zip code
  • street_name: buyer's billing address street name
  • street_number: buyer's billing address street number

  • Possible values: any string, "SN" for street without number


  • comment: buyer's billing address floor
  • state_name: buyer's billing address state
  • city_name: buyer's billing address city

  • DOC_TYPE's

    Argentina (MLA): DNI, CUIT.

    Brasil (MLB): CPF, CNPJ.

    Chile (MLC): RUT.

    Colombia (MCO): CC, CE, NIT.

    Venezuela (MLV): CI, RIF, Passport.

    Uruguay (MLU): CI, RUT.

    Perú (MPE): DNI, CE.

    or register to recieve the latest news about our API