Billing Data

To bill a sale, you need to obtain the buyer's tax data through the API /orders/order_id/billing_info

Query billing data

Get the buyer's tax data for invoice issuance.

Request:

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

Example:

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

Response with examples for individuals and legal entities

MLA - Individual

  {
    "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": "Final Consumer"
          }
        },
        "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 - Legal Entity

  {
    "site_id":"MLA",
    "buyer":{
      "cust_id": 123123123,
      "billing_info":{
        "name":"Apple Argentina"
        "identification":{
            "type":"CUIT",
            "number":"307722738"
        },
        "taxes": {
          "taxpayer_type": {
              "description": "VAT Registered Taxpayer"
          }
        },
        "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 - Individual

  {
    "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 - Legal Entity

  {
    "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": "Taxpayer" 
          }
        },
        "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 - Individual

  {
    "site_id": "MLM",
    "buyer": {
      "cust_id": 234343545,
      "billing_info": {
        "name": "Juan Soraes",
        "last_name": "Sanchez",	
        "identification": {
          "type": "RFC",
          "number": "CUPU800825569"
        },
        "taxes": {
          "contributor": "INDIVIDUAL",
          "taxpayer_type": {
            "id": "606",
            "description": "Leasing"
          },
          "cfdi": {
            "id": "G03",
            "description": "General expenses"
          }
        },
        "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 - Legal Entity

  {
    "site_id": "MLM",
    "buyer": {
      "cust_id": 234343545,
      "billing_info": {
        "name": "SALVADO HNOS S A",
        "identification": {
          "type": "RFC",
          "number": "CUPU800825569"
        },
        "taxes": {
          "contributor": "LEGAL ENTITY",
          "taxpayer_type": {
            "id": "606",
            "description": "Leasing"
          },
          "cfdi": {
            "id": "G03",
            "description": "General expenses"
          }
        },
        "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,
    }
  }

MLC - Individual

  {
    "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 - Legal Entity

  {
    "site_id": "MLC",
    "buyer": {
      "cust_id": 234343545,
      "billing_info": {
        "name": "Apple",
        "identification": {
          "type": "RUT",
          "number": "159321126"
        },
        "taxes": {
           "economic_activity": "Sale and rental of electronic articles",
        },
        "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 - Individual

  {
    "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 - Legal Entity

  {
    "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,
    }
  }

API Field Descriptions

Individual

• site_id: Site ID
• buyer:
  • cust_id: Buyer ID
• billing_info:
  • name: Buyer's first name
  • last_name: Buyer's last name
  • identification:
    • type: Document type
    • number: Document number
• taxes:
  • inscriptions:
    • state_registration: State registration
  • economic_activity: Economic activity
  • contributor: Taxpayer type
  • taxpayer_type:
    • id: Entity identifier
    • description: Buyer's tax status
• address:
  • street_name: Buyer's street name
  • street_number: Buyer's address number
  • city_name: Buyer's city
  • neighborhood: Buyer's neighborhood
  • zip_code: Buyer's postal code
  • comment: Additional information about the buyer's address
• country_id: Country ID
• state:
  • code: State code
  • name: State name
• secondary_doc_type: Additional document type (MLA only)
• secondary_doc_number: Additional document number (MLA only)
• attributes:
  • birth_date: Buyer's birth date
  • doc_type_number: Buyer's document number
  • cust_type: Legal entity or individual
• seller:
  • cust_id: Seller ID

The values CO or BU, when present in the cust_type field, mean:

CO: Customer (Individual)
BU: Business (Legal Entity)

Legal Entity

• business_name: Name of the buying legal entity
• taxpayer_type_id: Legal entity's VAT status

For MLA:

• Monotributo (Simplified Tax Regime)
• VAT Registered Taxpayer
• VAT Exempt

For MLB:

• Taxpayer
• Non-taxpayer

• state_registration: State registration
• doc_type: Document type
• doc_number: Document number
• zip_code: Buyer's postal code

• street_name: Buyer's billing address street name
• street_number: Buyer's billing address street number

Possible values: text, or "SN" for addresses without a number

• comment: Additional information for the buyer's billing address
• state_name: State of the buyer's billing address
• city_name: City of the buyer's billing address

DOC_TYPE's:

• Brazil (MLB):
  • Individual: CPF, RG
  • Legal Entity: CNPJ
• Argentina (MLA):
  • Individual: DNI, CUIL
  • Legal Entity: CUIT
• Chile (MLC):
  • Individual: RUT
  • Legal Entity: RUT
• Colombia (MCO):
  • Individual: CC, CE
  • Legal Entity: NIT
• Mexico (MLM):
  • Individual: RFC, CURP
  • Legal Entity: RFC