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

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:

GET https://api.mercadolibre.com/orders/$order_id/billing_info?access_token={access_token}

Ejemplo:

GET https://api.mercadolibre.com/orders/1691789796/billing_info?access_token=ACCESS_TOKEN

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

- Posibles valores: entre "monotax" (monotributista) e "iva"

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

Forma parte de nuestra comunidad