Datos de facturación

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 -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.