Datos de facturación

Importante:

Esta funcionalidad no está disponible en México.

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' https://api.mercadolibre.com/orders/$ORDER_ID/billing_info

Ejemplo:

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

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.

Siguiente: Notas en órdenes.