Facturación

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.

Contenidos

→Consultar los datos de facturación
→Tipos y valores para additional_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 https://api.mercadolibre.com/orders/$ORDER_ID/billing_info?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/orders/1691789796/billing_info?access_token=$ACCESS_TOKEN

Las órdenes de Mercado Libre Argentina y Brasil devuelven datos de facturación bajo las siguientes condiciones:

  • Productos con Retiro en sucursal, Fullfillment o CrossDocking
  • Productos de Tiendas Oficiales, Mercado Lideres.
  • Productos con Global Selling.
  • Compras con Garex.

Respuesta (los ejemplos son de personas: Física/Jurídica de MLA) MLA - Persona Física
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 - Persona Jurídica

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


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

    Argentina (MLA): DNI, CUIT.

    Brasil (MLB): CPF, CNPJ.

    Chile (MLC): RUT.

    Colombia (MCO): CC, CE, NIT.

    Venezuela (MLV): CI, RIF, Pasaporte.

    Uruguay (MLU): CI, RUT.

    Perú (MPE): DNI, CE.